diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 9a09075..6343241 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -56,7 +56,7 @@ jobs: integration: name: Integration (unit + e2e + build) runs-on: ubuntu-latest - timeout-minutes: 90 + timeout-minutes: 180 needs: [meta] outputs: version: ${{ needs.meta.outputs.version }} @@ -120,11 +120,11 @@ jobs: set -euo pipefail echo "Starting E2E..." - ( go test -v -count=1 -timeout 40m ./e2e/... ) & + ( go test -v -count=1 -timeout 120m ./e2e/... ) & pid=$! echo "E2E pid=$pid" - for i in $(seq 1 2700); do + for i in $(seq 1 7200); do if ! kill -0 "$pid" 2>/dev/null; then echo "E2E finished, waiting..." wait "$pid" @@ -149,14 +149,14 @@ jobs: sleep 1 done - echo "ERROR: E2E exceeded watchdog (45m) - killing..." + echo "ERROR: E2E exceeded watchdog (120m) - killing..." kill "$pid" || true sleep 2 kill -9 "$pid" || true exit 1 - echo "ERROR: E2E exceeded watchdog (45m) - killing..." + echo "ERROR: E2E exceeded watchdog (120m) - killing..." kill "$pid" || true sleep 2 kill -9 "$pid" || true diff --git a/back_Makefile b/back_Makefile deleted file mode 100644 index ec9cf63..0000000 --- a/back_Makefile +++ /dev/null @@ -1,224 +0,0 @@ -# Makefile (XGRChain) -# - lean: only build / test / lint / proto / contracts / deploy -# - engine mode: -# make xgr-build # default: stub -# make xgr-build embedded # embedded + build tag -# make xgr-deploy-all # default: stub -# make xgr-deploy-all embedded # embedded + build tag - -SHELL := /bin/bash - -# ----------------------------- -# TOOLING CHECKS -# ----------------------------- -.PHONY: check-git check-go check-protoc check-lint check-npm - -check-git: - @command -v git >/dev/null || (echo "git is not installed. Please install and try again."; exit 1) - -check-go: - @command -v go >/dev/null || (echo "go is not installed. Please install and try again."; exit 1) - -check-protoc: - @command -v protoc >/dev/null || (echo "protoc is not installed. Please install and try again."; exit 1) - -check-lint: - @command -v golangci-lint >/dev/null || (echo "golangci-lint is not installed. Please install and try again."; exit 1) - -check-npm: - @command -v npm >/dev/null || (echo "npm is not installed. Please install and try again."; exit 1) - -# ----------------------------- -# SUBMODULES -# ----------------------------- -.PHONY: download-submodules -download-submodules: check-git - git submodule init - git submodule update - -# ----------------------------- -# PROTO / CODEGEN -# ----------------------------- -.PHONY: protoc -protoc: check-protoc - protoc --go_out=. --go-grpc_out=. -I . -I=./validate --validate_out="lang=go:." \ - ./server/proto/*.proto \ - ./network/proto/*.proto \ - ./txpool/proto/*.proto \ - ./consensus/ibft/**/*.proto \ - ./consensus/polybft/**/*.proto - -# ----------------------------- -# LINT / TEST -# ----------------------------- -.PHONY: lint test fuzz-test test-e2e test-e2e-polybft test-property-polybft - -lint: check-lint - golangci-lint run --config .golangci.yml - -test: check-go - go test -race -shuffle=on -coverprofile coverage.out -timeout 20m `go list ./... | grep -v e2e` - -fuzz-test: check-go - ./scripts/fuzzAll - -test-e2e: check-go - go build -race -o artifacts/polygon-edge . - env EDGE_BINARY=${PWD}/artifacts/polygon-edge go test -v -timeout=30m ./e2e/... - -test-e2e-polybft: check-go - go build -o artifacts/polygon-edge . - env EDGE_BINARY=${PWD}/artifacts/polygon-edge E2E_TESTS=true E2E_LOGS=true \ - go test -v -timeout=1h30m ./e2e-polybft/e2e/... - -test-property-polybft: check-go - go build -o artifacts/polygon-edge . - env EDGE_BINARY=${PWD}/artifacts/polygon-edge E2E_TESTS=true E2E_LOGS=true \ - go test -v -timeout=30m ./e2e-polybft/property/... -rapid.checks=10 - -# ----------------------------- -# CONTRACTS / BINDINGS -# ----------------------------- -.PHONY: compile-core-contracts generate-smart-contract-bindings - -compile-core-contracts: check-npm - cd core-contracts && npm install && npm run compile - $(MAKE) generate-smart-contract-bindings - -generate-smart-contract-bindings: check-go - go run ./consensus/polybft/contractsapi/artifacts-gen/main.go - go run ./consensus/polybft/contractsapi/bindings-gen/main.go - -# ----------------------------- -# LICENSES -# ----------------------------- -.PHONY: generate-bsd-licenses -generate-bsd-licenses: check-git - ./generate_dependency_licenses.sh BSD-3-Clause,BSD-2-Clause > ./licenses/bsd_licenses.json - -# ----------------------------- -# XGRCHAIN CUSTOM BUILD & DEPLOY -# ----------------------------- -BINARY_NAME := xgrchain -BUILD_DIR := bin -BUILD_PATH := $(BUILD_DIR)/$(BINARY_NAME) -PKG_PATH := github.com/xgr-network/xgr-node/versioning - -GENESIS_SRC := $(shell pwd)/genesis.json -GENESIS_DEST := ~/xgrchain/genesis.json - -MAIN_NODE := 87.106.3.182 -REMOTE_NODES := \ - xgradmin@87.106.3.183 \ - xgradmin@87.106.3.180 \ - xgradmin@87.106.3.177 - -# Engine selection via extra goal token: -# make xgr-build -> ENGINE=stub -# make xgr-build embedded -> ENGINE=embedded -# make xgr-build stub -> ENGINE=stub -ENGINE ?= stub -ENGINE_GOAL := $(filter embedded stub,$(MAKECMDGOALS)) -ifneq ($(ENGINE_GOAL),) -ENGINE := $(ENGINE_GOAL) -endif - -.PHONY: embedded stub -embedded stub: - @: - -XGR_ENGINE_MODE := $(ENGINE) -ENGINE_TAGS := $(if $(filter embedded,$(ENGINE)),-tags engine_embedded,) - -.PHONY: xgr-build -xgr-build: check-go check-git - @echo "πŸ”¨ Building $(BINARY_NAME) [engine=$(ENGINE)]..." - @mkdir -p $(BUILD_DIR) - @COMMIT=$$(git rev-parse --short HEAD) && \ - BRANCH=$$(git rev-parse --abbrev-ref HEAD) && \ - TIME=$$(date -u +"%Y-%m-%dT%H:%M:%SZ") && \ - VERSION="v1.0-$$(date +%Y%m%d)-$$COMMIT" && \ - echo "πŸ“¦ Version: $$VERSION" && \ - GOOS=linux GOARCH=amd64 \ - XGR_ENGINE_MODE=$(XGR_ENGINE_MODE) \ - go build $(ENGINE_TAGS) -o $(BUILD_PATH) \ - -ldflags "-X $(PKG_PATH).Version=$$VERSION -X $(PKG_PATH).Commit=$$COMMIT -X $(PKG_PATH).Branch=$$BRANCH -X $(PKG_PATH).BuildTime=$$TIME" \ - main.go && \ - echo "βœ… Build complete: $(BUILD_PATH)" - -BUILD_PATH_DEBUG := $(BUILD_DIR)/$(BINARY_NAME).debug - -.PHONY: xgr-build-debug -xgr-build-debug: check-go check-git - @echo "πŸͺ² Building $(BINARY_NAME) (DEBUG -N -l) [engine=$(ENGINE)]..." - @mkdir -p $(BUILD_DIR) - @COMMIT=$$(git rev-parse --short HEAD) && \ - BRANCH=$$(git rev-parse --abbrev-ref HEAD) && \ - TIME=$$(date -u +"%Y-%m-%dT%H:%M:%SZ") && \ - VERSION="v1.0-$$(date +%Y%m%d)-$$COMMIT" && \ - echo "πŸ“¦ Version: $$VERSION" && \ - GOOS=linux GOARCH=amd64 \ - XGR_ENGINE_MODE=$(XGR_ENGINE_MODE) \ - go build $(ENGINE_TAGS) \ - -gcflags="all=-N -l" \ - -o "$(BUILD_PATH_DEBUG)" \ - -ldflags "-X $(PKG_PATH).Version=$$VERSION -X $(PKG_PATH).Commit=$$COMMIT -X $(PKG_PATH).Branch=$$BRANCH -X $(PKG_PATH).BuildTime=$$TIME" \ - main.go && \ - echo "βœ… Debug build complete: $(BUILD_PATH_DEBUG)" - -.PHONY: xgr-install-local -xgr-install-local: - @echo "πŸ“¦ Installing locally on MAIN_NODE ($(MAIN_NODE))..." - sudo mkdir -p /usr/local/bin - sudo cp $(BUILD_PATH) /usr/local/bin/$(BINARY_NAME) - sudo chmod +x /usr/local/bin/$(BINARY_NAME) - mkdir -p ~/xgrchain - cp $(GENESIS_SRC) $(GENESIS_DEST) - @echo "βœ… Genesis-Datei wurde in $(GENESIS_DEST) kopiert" - @echo "βœ… Installed locally" - -.PHONY: xgr-deploy-remote -xgr-deploy-remote: - @echo "πŸš€ Deploying to remote validator nodes..." - @for host in $(REMOTE_NODES); do \ - echo "β†’ Copying binary to $$host..."; \ - scp $(BUILD_PATH) $$host:/tmp/$(BINARY_NAME); \ - ssh -tt $$host "sudo mv /tmp/$(BINARY_NAME) /usr/local/bin/$(BINARY_NAME) && sudo chmod +x /usr/local/bin/$(BINARY_NAME)"; \ - echo "β†’ Copying genesis file to $$host..."; \ - scp $(GENESIS_SRC) $$host:/tmp/genesis-mainnet.json; \ - ssh -tt $$host "mkdir -p ~/xgrchain && mv /tmp/genesis-mainnet.json $(GENESIS_DEST)"; \ - echo " βœ… Deployed to $$host"; \ - done - -.PHONY: xgr-deploy-all -xgr-deploy-all: xgr-build xgr-install-local xgr-deploy-remote - -# ----------------------------- -# HELP -# ----------------------------- -.PHONY: help -help: - @echo "Available targets:" - @printf " %-28s - %s\n" "download-submodules" "Initialize and update Git submodules" - @printf " %-28s - %s\n" "protoc" "Compile Protocol Buffers files" - @printf " %-28s - %s\n" "lint" "Run linters on the codebase" - @printf " %-28s - %s\n" "test" "Run unit tests" - @printf " %-28s - %s\n" "fuzz-test" "Run fuzz tests" - @printf " %-28s - %s\n" "test-e2e" "Run end-to-end tests" - @printf " %-28s - %s\n" "test-e2e-polybft" "Run end-to-end tests for PolyBFT" - @printf " %-28s - %s\n" "test-property-polybft" "Run property tests for PolyBFT" - @printf " %-28s - %s\n" "compile-core-contracts" "Compile core contracts" - @printf " %-28s - %s\n" "generate-smart-contract-bindings" "Generate smart contract bindings" - @printf " %-28s - %s\n" "generate-bsd-licenses" "Generate BSD licenses JSON" - @printf " %-28s - %s\n" "xgr-build" "Build xgrchain (default engine=stub)" - @printf " %-28s - %s\n" "xgr-build-debug" "Build xgrchain debug (-N -l)" - @printf " %-28s - %s\n" "xgr-install-local" "Install binary + genesis locally" - @printf " %-28s - %s\n" "xgr-deploy-remote" "Deploy binary + genesis to validator nodes" - @printf " %-28s - %s\n" "xgr-deploy-all" "Build + install local + deploy remote" - @echo "" - @echo "Engine mode usage:" - @echo " make xgr-build # stub (default)" - @echo " make xgr-build embedded # embedded + -tags engine_embedded" - @echo " make xgr-deploy-all # stub (default)" - @echo " make xgr-deploy-all embedded" - diff --git a/blockchain/blockchain.go b/blockchain/blockchain.go index 22dbd8a..1ed754e 100644 --- a/blockchain/blockchain.go +++ b/blockchain/blockchain.go @@ -115,13 +115,13 @@ func (b *Blockchain) updateGasPriceAvg(newValues []*big.Int) { sum = sum.Add(sum, val) } if len(newValues) == 0 { - // Kein neuer Wert, setze Default falls kein alter Wert existiert + // No new value; set a default only when no previous value exists if b.gpAverage.count.Uint64() == 0 { b.gpAverage.price = big.NewInt(int64(chain.MinBaseFee)) b.gpAverage.count = big.NewInt(1) return } - // Ansonsten nichts Γ€ndern + // Otherwise keep the current value unchanged return } @@ -1417,12 +1417,12 @@ func mulDivClampU64(a, b, c, d uint64) uint64 { // CalculateBaseFee calculates the basefee of the header. func (b *Blockchain) CalculateBaseFee(parent *types.Header) uint64 { - // Minimum BaseFee (statisch oder dynamisch) + // Minimum base fee (static or dynamic) minBaseFee := b.resolveMinBaseFee(parent) var baseFee uint64 - // Genesis oder erster London-Block? + // Genesis or first London block? if parent.BaseFee == 0 { if b.config.Genesis.BaseFee > 0 { baseFee = b.config.Genesis.BaseFee @@ -1466,7 +1466,7 @@ func (b *Blockchain) CalculateBaseFee(parent *types.Header) uint64 { } } - // Sicherheitsanker: niemals unter minBaseFee + // Safety guard: never go below minBaseFee. if baseFee < minBaseFee { return minBaseFee } diff --git a/blockchain/blockchain_test.go b/blockchain/blockchain_test.go index edfc5c3..67e6ab3 100644 --- a/blockchain/blockchain_test.go +++ b/blockchain/blockchain_test.go @@ -1494,7 +1494,7 @@ func TestBlockchain_WriteFullBlock(t *testing.T) { Transactions: []*types.Transaction{tx}, }, Receipts: receipts, - }, "polybft") + }, "ibft") require.NoError(t, err) require.Equal(t, 0, len(db)) @@ -1507,7 +1507,7 @@ func TestBlockchain_WriteFullBlock(t *testing.T) { Transactions: []*types.Transaction{tx}, }, Receipts: receipts, - }, "polybft") + }, "ibft") require.NoError(t, err) require.Equal(t, 8, len(db)) diff --git a/bls/private.go b/bls/private.go index b33e8a7..0ef8d26 100644 --- a/bls/private.go +++ b/bls/private.go @@ -33,7 +33,7 @@ func UnmarshalPrivateKey(data []byte) (*PrivateKey, error) { } // Otherwise, trying to assume the given data is a hex encoded big int represented as a bytes array. - // This is needed in order to be compatible with the currently stored polybft BLS keys. + // This is needed in order to be compatible with the currently stored legacy BLS keys. var err error if pk.s, err = hex.DecodeHexToBig(string(data)); err != nil { return nil, err diff --git a/chain/params.go b/chain/params.go index 6acd3dd..cc2189b 100644 --- a/chain/params.go +++ b/chain/params.go @@ -111,6 +111,7 @@ const ( EIP2929 = "EIP2929" EIP2930 = "EIP2930" EIP3651 = "EIP3651" + FeePoolSplit = "feePoolSplit" ) // Forks is map which contains all forks and their starting blocks from genesis @@ -153,6 +154,7 @@ func (f *Forks) At(block uint64) ForksInTime { EIP2929: f.IsActive(EIP2929, block), EIP2930: f.IsActive(EIP2930, block), EIP3651: f.IsActive(EIP3651, block), + FeePoolSplit: f.IsActive(FeePoolSplit, block), } } @@ -205,7 +207,7 @@ type ForksInTime struct { EIP155, QuorumCalcAlignment, TxHashWithType, - LondonFix, EIP3860, EIP2929, EIP2930, EIP3651 bool + LondonFix, EIP3860, EIP2929, EIP2930, EIP3651, FeePoolSplit bool } // AllForksEnabled should contain all supported forks by current edge version diff --git a/command/bridge/README.md b/command/bridge/README.md deleted file mode 100644 index c5d1fe5..0000000 --- a/command/bridge/README.md +++ /dev/null @@ -1,49 +0,0 @@ -# Bridge helper command - -This is a helper command, which allows sending deposits from root to child chain and make withdrawals from child chain to root chain. - -## Deposit ERC20 - -This is a helper command which deposits ERC20 tokens from the root chain to the child chain - -```bash -$ xgrchain bridge deposit-erc20 \ - --sender-key \ - --receivers \ - --amounts \ - --root-token \ - --root-predicate \ - --json-rpc - [--minter-key ] -``` - -**Note:** in case `minter-key` is provided, tokens are going to be minted to sender account. Note that provided minter private key must belong to the account which has minter role. - -## Withdraw ERC20 - -This is a helper command which withdraws ERC20 tokens from the child chain to the root chain - -```bash -$ xgrchain bridge withdraw-erc20 \ - --sender-key \ - --receivers \ - --amounts \ - --child-predicate \ - [--child-token ] \ - --json-rpc -``` - -## Exit - -This is a helper command which qeuries child chain for exit event proof and sends an exit transaction to ExitHelper smart contract. - -```bash -$ xgrchain bridge exit \ - --sender-key \ - --exit-helper \ - --exit-id \ - --root-json-rpc \ - --child-json-rpc -``` - -**Note:** for using test account provided by Geth dev instance, use `--test` flag. In that case `--sender-key` flag can be omitted and test account is used as an exit transaction sender. diff --git a/command/bridge/bridge.go b/command/bridge/bridge.go deleted file mode 100644 index 414e26e..0000000 --- a/command/bridge/bridge.go +++ /dev/null @@ -1,47 +0,0 @@ -package bridge - -import ( - "github.com/spf13/cobra" - - depositERC1155 "github.com/xgr-network/xgr-node/command/bridge/deposit/erc1155" - depositERC20 "github.com/xgr-network/xgr-node/command/bridge/deposit/erc20" - depositERC721 "github.com/xgr-network/xgr-node/command/bridge/deposit/erc721" - "github.com/xgr-network/xgr-node/command/bridge/exit" - "github.com/xgr-network/xgr-node/command/bridge/mint" - withdrawERC1155 "github.com/xgr-network/xgr-node/command/bridge/withdraw/erc1155" - withdrawERC20 "github.com/xgr-network/xgr-node/command/bridge/withdraw/erc20" - withdrawERC721 "github.com/xgr-network/xgr-node/command/bridge/withdraw/erc721" -) - -// GetCommand creates "bridge" helper command -func GetCommand() *cobra.Command { - bridgeCmd := &cobra.Command{ - Use: "bridge", - Short: "Top level bridge command.", - } - - registerSubcommands(bridgeCmd) - - return bridgeCmd -} - -func registerSubcommands(baseCmd *cobra.Command) { - baseCmd.AddCommand( - // bridge deposit-erc20 - depositERC20.GetCommand(), - // bridge deposit-erc721 - depositERC721.GetCommand(), - // bridge deposit-erc1155 - depositERC1155.GetCommand(), - // bridge withdraw-erc20 - withdrawERC20.GetCommand(), - // bridge withdraw-erc721 - withdrawERC721.GetCommand(), - // bridge withdraw-erc1155 - withdrawERC1155.GetCommand(), - // bridge exit - exit.GetCommand(), - // bridge mint erc-20 - mint.GetCommand(), - ) -} diff --git a/command/bridge/common/params.go b/command/bridge/common/params.go deleted file mode 100644 index 712b204..0000000 --- a/command/bridge/common/params.go +++ /dev/null @@ -1,296 +0,0 @@ -package common - -import ( - "bytes" - "errors" - "fmt" - "math/big" - "strings" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - - cmdHelper "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -type TokenType int - -const ( - ERC20 TokenType = iota - ERC721 - ERC1155 -) - -const ( - SenderKeyFlag = "sender-key" - ReceiversFlag = "receivers" - AmountsFlag = "amounts" - TokenIDsFlag = "token-ids" - RootTokenFlag = "root-token" - RootPredicateFlag = "root-predicate" - ChildPredicateFlag = "child-predicate" - ChildTokenFlag = "child-token" - JSONRPCFlag = "json-rpc" - ChildChainMintableFlag = "child-chain-mintable" - - MinterKeyFlag = "minter-key" - MinterKeyFlagDesc = "minter key is the account which is able to mint tokens to sender account " + - "(if provided tokens are minted prior to depositing)" -) - -var ( - errInconsistentAmounts = errors.New("receivers and amounts must be equal length") - errInconsistentTokenIds = errors.New("receivers and token ids must be equal length") -) - -type BridgeParams struct { - SenderKey string - Receivers []string - TokenAddr string - PredicateAddr string - JSONRPCAddr string - ChildChainMintable bool -} - -// RegisterCommonFlags registers common bridge flags to a given command -func (p *BridgeParams) RegisterCommonFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - &p.SenderKey, - SenderKeyFlag, - "", - "hex encoded private key of the account which sends bridge transactions", - ) - - cmd.Flags().StringSliceVar( - &p.Receivers, - ReceiversFlag, - nil, - "receiving accounts addresses", - ) - - cmd.Flags().StringVar( - &p.JSONRPCAddr, - JSONRPCFlag, - txrelayer.DefaultRPCAddress, - "the JSON RPC endpoint", - ) - - cmd.Flags().BoolVar( - &p.ChildChainMintable, - ChildChainMintableFlag, - false, - "flag indicating whether tokens originate from child chain", - ) -} - -func (p *BridgeParams) Validate() error { - if p == nil { - return nil - } - - _, err := cmdHelper.ParseJSONRPCAddress(p.JSONRPCAddr) - if err != nil { - return fmt.Errorf("failed to parse json rpc address. Error: %w", err) - } - - return nil -} - -type ERC20BridgeParams struct { - *BridgeParams - Amounts []string -} - -func NewERC20BridgeParams() *ERC20BridgeParams { - return &ERC20BridgeParams{BridgeParams: &BridgeParams{}} -} - -func (bp *ERC20BridgeParams) Validate() error { - if err := bp.BridgeParams.Validate(); err != nil { - return err - } - - if len(bp.Receivers) != len(bp.Amounts) { - return errInconsistentAmounts - } - - return nil -} - -type ERC721BridgeParams struct { - *BridgeParams - TokenIDs []string -} - -func NewERC721BridgeParams() *ERC721BridgeParams { - return &ERC721BridgeParams{BridgeParams: &BridgeParams{}} -} - -func (bp *ERC721BridgeParams) Validate() error { - if err := bp.BridgeParams.Validate(); err != nil { - return err - } - - if len(bp.Receivers) != len(bp.TokenIDs) { - return errInconsistentTokenIds - } - - return nil -} - -type ERC1155BridgeParams struct { - *BridgeParams - Amounts []string - TokenIDs []string -} - -func NewERC1155BridgeParams() *ERC1155BridgeParams { - return &ERC1155BridgeParams{BridgeParams: &BridgeParams{}} -} - -func (bp *ERC1155BridgeParams) Validate() error { - if err := bp.BridgeParams.Validate(); err != nil { - return err - } - - if len(bp.Receivers) != len(bp.Amounts) { - return errInconsistentAmounts - } - - if len(bp.Receivers) != len(bp.TokenIDs) { - return errInconsistentTokenIds - } - - return nil -} - -// ExtractExitEventIDs tries to extract all exit event ids from provided receipt -func ExtractExitEventIDs(receipt *ethgo.Receipt) ([]*big.Int, error) { - exitEventIDs := make([]*big.Int, 0, len(receipt.Logs)) - - for _, log := range receipt.Logs { - var exitEvent contractsapi.L2StateSyncedEvent - - doesMatch, err := exitEvent.ParseLog(log) - if err != nil { - return nil, err - } - - if !doesMatch { - continue - } - - exitEventIDs = append(exitEventIDs, exitEvent.ID) - } - - if len(exitEventIDs) != 0 { - return exitEventIDs, nil - } - - return nil, errors.New("failed to find exit event log") -} - -// ExtractChildTokenAddr extracts predicted deterministic child token address -func ExtractChildTokenAddr(receipt *ethgo.Receipt, childChainMintable bool) (*types.Address, error) { - var ( - l1TokenMapped contractsapi.TokenMappedEvent - l2TokenMapped contractsapi.L2MintableTokenMappedEvent - ) - - for _, log := range receipt.Logs { - if childChainMintable { - doesMatch, err := l2TokenMapped.ParseLog(log) - if err != nil { - return nil, err - } - - if !doesMatch { - continue - } - - return &l2TokenMapped.ChildToken, nil - } else { - doesMatch, err := l1TokenMapped.ParseLog(log) - if err != nil { - return nil, err - } - - if !doesMatch { - continue - } - - return &l1TokenMapped.ChildToken, nil - } - } - - return nil, nil -} - -type BridgeTxResult struct { - Sender string `json:"sender"` - Receivers []string `json:"receivers"` - ExitEventIDs []*big.Int `json:"exitEventIDs"` - Amounts []string `json:"amounts"` - TokenIDs []string `json:"tokenIds"` - BlockNumbers []uint64 `json:"blockNumbers"` - ChildTokenAddr *types.Address `json:"childTokenAddr"` - - Title string `json:"title"` -} - -func (r *BridgeTxResult) GetOutput() string { - var buffer bytes.Buffer - - vals := make([]string, 0, 7) - vals = append(vals, fmt.Sprintf("Sender|%s", r.Sender)) - vals = append(vals, fmt.Sprintf("Receivers|%s", strings.Join(r.Receivers, ", "))) - - if len(r.Amounts) > 0 { - vals = append(vals, fmt.Sprintf("Amounts|%s", strings.Join(r.Amounts, ", "))) - } - - if len(r.TokenIDs) > 0 { - vals = append(vals, fmt.Sprintf("Token Ids|%s", strings.Join(r.TokenIDs, ", "))) - } - - if len(r.ExitEventIDs) > 0 { - var buf bytes.Buffer - - for i, id := range r.ExitEventIDs { - buf.WriteString(id.String()) - - if i != len(r.ExitEventIDs)-1 { - buf.WriteString(", ") - } - } - - vals = append(vals, fmt.Sprintf("Exit Event IDs|%s", buf.String())) - } - - if len(r.BlockNumbers) > 0 { - var buf bytes.Buffer - - for i, blockNum := range r.BlockNumbers { - buf.WriteString(fmt.Sprintf("%d", blockNum)) - - if i != len(r.BlockNumbers)-1 { - buf.WriteString(", ") - } - } - - vals = append(vals, fmt.Sprintf("Inclusion Block Numbers|%s", buf.String())) - } - - if r.ChildTokenAddr != nil { - vals = append(vals, fmt.Sprintf("Child Token Address|%s", (*r.ChildTokenAddr).String())) - } - - _, _ = buffer.WriteString(fmt.Sprintf("\n[%s]\n", r.Title)) - _, _ = buffer.WriteString(cmdHelper.FormatKV(vals)) - _, _ = buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/bridge/deposit/erc1155/deposit_erc1155.go b/command/bridge/deposit/erc1155/deposit_erc1155.go deleted file mode 100644 index c4b141f..0000000 --- a/command/bridge/deposit/erc1155/deposit_erc1155.go +++ /dev/null @@ -1,305 +0,0 @@ -package erc1155 - -import ( - "fmt" - "math/big" - "strings" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/bridge/common" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - helperCommon "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -type depositERC1155Params struct { - *common.ERC1155BridgeParams - minterKey string -} - -var ( - // depositParams is abstraction for provided bridge parameter values - dp *depositERC1155Params = &depositERC1155Params{ERC1155BridgeParams: common.NewERC1155BridgeParams()} -) - -// GetCommand returns the bridge deposit command -func GetCommand() *cobra.Command { - depositCmd := &cobra.Command{ - Use: "deposit-erc1155", - Short: "Deposits ERC 1155 tokens from the origin to the destination chain", - PreRunE: preRunCommand, - Run: runCommand, - } - - dp.RegisterCommonFlags(depositCmd) - - depositCmd.Flags().StringSliceVar( - &dp.Amounts, - common.AmountsFlag, - nil, - "amounts that are sent to the receivers accounts", - ) - - depositCmd.Flags().StringSliceVar( - &dp.TokenIDs, - common.TokenIDsFlag, - nil, - "token ids that are sent to the receivers accounts", - ) - - depositCmd.Flags().StringVar( - &dp.TokenAddr, - common.RootTokenFlag, - "", - "root ERC 1155 token address", - ) - - depositCmd.Flags().StringVar( - &dp.PredicateAddr, - common.RootPredicateFlag, - "", - "root ERC 1155 token predicate address", - ) - - depositCmd.Flags().StringVar( - &dp.minterKey, - common.MinterKeyFlag, - "", - common.MinterKeyFlagDesc, - ) - - _ = depositCmd.MarkFlagRequired(common.ReceiversFlag) - _ = depositCmd.MarkFlagRequired(common.AmountsFlag) - _ = depositCmd.MarkFlagRequired(common.TokenIDsFlag) - _ = depositCmd.MarkFlagRequired(common.RootTokenFlag) - _ = depositCmd.MarkFlagRequired(common.RootPredicateFlag) - - return depositCmd -} - -func preRunCommand(_ *cobra.Command, _ []string) error { - return dp.Validate() -} - -func runCommand(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - depositorKey, err := helper.DecodePrivateKey(dp.SenderKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize depositor private key: %w", err)) - } - - depositorAddr := depositorKey.Address() - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(dp.JSONRPCAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize tx relayer: %w", err)) - - return - } - - amounts := make([]*big.Int, len(dp.Amounts)) - tokenIDs := make([]*big.Int, len(dp.TokenIDs)) - - for i := range dp.Receivers { - amountRaw := dp.Amounts[i] - tokenIDRaw := dp.TokenIDs[i] - - amount, err := helperCommon.ParseUint256orHex(&amountRaw) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode provided amount %s: %w", amountRaw, err)) - - return - } - - amounts[i] = amount - - tokenID, err := helperCommon.ParseUint256orHex(&tokenIDRaw) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode provided token id %s: %w", tokenIDRaw, err)) - - return - } - - tokenIDs[i] = tokenID - } - - if dp.minterKey != "" { - minterKey, err := helper.DecodePrivateKey(dp.minterKey) - if err != nil { - outputter.SetError(fmt.Errorf("invalid minter key provided: %w", err)) - - return - } - - // mint tokens to depositor, so he is able to send them - mintTxn, err := createMintTxn(types.Address(depositorAddr), types.Address(depositorAddr), amounts, tokenIDs) - if err != nil { - outputter.SetError(fmt.Errorf("mint transaction creation failed: %w", err)) - - return - } - - receipt, err := txRelayer.SendTransaction(mintTxn, minterKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send mint transaction to depositor %s: %w", depositorAddr, err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to mint tokens to depositor %s", depositorAddr)) - - return - } - } - - // approve root erc1155 predicate - approveTxn, err := createApproveERC1155PredicateTxn( - types.StringToAddress(dp.PredicateAddr), - types.StringToAddress(dp.TokenAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("failed to create root erc 1155 approve transaction: %w", err)) - - return - } - - receipt, err := txRelayer.SendTransaction(approveTxn, depositorKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send root erc 1155 approve transaction: %w", err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to approve root erc 1155 predicate")) - - return - } - - receivers := make([]ethgo.Address, len(dp.Receivers)) - for i, receiverRaw := range dp.Receivers { - receivers[i] = ethgo.Address(types.StringToAddress(receiverRaw)) - } - - // deposit tokens - depositTxn, err := createDepositTxn(depositorAddr, receivers, amounts, tokenIDs) - if err != nil { - outputter.SetError(fmt.Errorf("failed to create tx input: %w", err)) - - return - } - - receipt, err = txRelayer.SendTransaction(depositTxn, depositorKey) - if err != nil { - outputter.SetError(fmt.Errorf("sending deposit transactions failed (receivers: %s, amount: %s): %w", - strings.Join(dp.Receivers, ", "), strings.Join(dp.Amounts, ", "), err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("sending deposit transactions failed (receivers: %s, amounts: %s)", - strings.Join(dp.Receivers, ", "), strings.Join(dp.Amounts, ", "))) - - return - } - - res := &common.BridgeTxResult{ - Sender: depositorAddr.String(), - Receivers: dp.Receivers, - Amounts: dp.Amounts, - TokenIDs: dp.TokenIDs, - BlockNumbers: []uint64{receipt.BlockNumber}, - Title: "DEPOSIT ERC 1155", - } - - if dp.ChildChainMintable { - exitEventIDs, err := common.ExtractExitEventIDs(receipt) - if err != nil { - outputter.SetError(fmt.Errorf("failed to extract exit event: %w", err)) - - return - } - - res.ExitEventIDs = exitEventIDs - } - - // populate child token address if a token is mapped alongside with deposit - childToken, err := common.ExtractChildTokenAddr(receipt, dp.ChildChainMintable) - if err != nil { - outputter.SetError(fmt.Errorf("failed to extract child token address: %w", err)) - - return - } - - res.ChildTokenAddr = childToken - - outputter.SetCommandResult(res) -} - -// createDepositTxn encodes parameters for deposit function on rootchain predicate contract -func createDepositTxn(sender ethgo.Address, receivers []ethgo.Address, - amounts, tokenIDs []*big.Int) (*ethgo.Transaction, error) { - depositBatchFn := &contractsapi.DepositBatchRootERC1155PredicateFn{ - RootToken: types.StringToAddress(dp.TokenAddr), - Receivers: receivers, - TokenIDs: tokenIDs, - Amounts: amounts, - } - - input, err := depositBatchFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - addr := ethgo.Address(types.StringToAddress(dp.PredicateAddr)) - - return helper.CreateTransaction(sender, &addr, input, - nil, !dp.ChildChainMintable), nil -} - -// createMintTxn encodes parameters for mint function on rootchain token contract -func createMintTxn(sender, receiver types.Address, amounts, tokenIDs []*big.Int) (*ethgo.Transaction, error) { - mintFn := &contractsapi.MintBatchRootERC1155Fn{ - To: receiver, - Amounts: amounts, - IDs: tokenIDs, - } - - input, err := mintFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - addr := ethgo.Address(types.StringToAddress(dp.TokenAddr)) - - return helper.CreateTransaction(ethgo.Address(sender), &addr, - input, nil, !dp.ChildChainMintable), nil -} - -// createApproveERC1155PredicateTxn sends approve transaction -// to ERC1155 token for ERC1155 predicate so that it is able to spend given tokens -func createApproveERC1155PredicateTxn(rootERC1155Predicate, - rootERC1155Token types.Address) (*ethgo.Transaction, error) { - approveFnParams := &contractsapi.SetApprovalForAllRootERC1155Fn{ - Operator: rootERC1155Predicate, - Approved: true, - } - - input, err := approveFnParams.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode parameters for RootERC1155.setApprovalForAll. error: %w", err) - } - - addr := ethgo.Address(rootERC1155Token) - - return helper.CreateTransaction(ethgo.ZeroAddress, &addr, - input, nil, !dp.ChildChainMintable), nil -} diff --git a/command/bridge/deposit/erc20/deposit_erc20.go b/command/bridge/deposit/erc20/deposit_erc20.go deleted file mode 100644 index 75839f5..0000000 --- a/command/bridge/deposit/erc20/deposit_erc20.go +++ /dev/null @@ -1,286 +0,0 @@ -package erc20 - -import ( - "fmt" - "math/big" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "golang.org/x/sync/errgroup" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/bridge/common" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - helperCommon "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -type depositERC20Params struct { - *common.ERC20BridgeParams - minterKey string -} - -var ( - // depositParams is abstraction for provided bridge parameter values - dp *depositERC20Params = &depositERC20Params{ERC20BridgeParams: common.NewERC20BridgeParams()} -) - -// GetCommand returns the bridge deposit command -func GetCommand() *cobra.Command { - depositCmd := &cobra.Command{ - Use: "deposit-erc20", - Short: "Deposits ERC 20 tokens from the origin to the destination chain", - PreRunE: preRunCommand, - Run: runCommand, - } - - dp.RegisterCommonFlags(depositCmd) - - depositCmd.Flags().StringSliceVar( - &dp.Amounts, - common.AmountsFlag, - nil, - "amounts to send to receiving accounts", - ) - - depositCmd.Flags().StringVar( - &dp.TokenAddr, - common.RootTokenFlag, - "", - "root ERC 20 token address", - ) - - depositCmd.Flags().StringVar( - &dp.PredicateAddr, - common.RootPredicateFlag, - "", - "root ERC 20 token predicate address", - ) - - depositCmd.Flags().StringVar( - &dp.minterKey, - common.MinterKeyFlag, - "", - common.MinterKeyFlagDesc, - ) - - _ = depositCmd.MarkFlagRequired(common.ReceiversFlag) - _ = depositCmd.MarkFlagRequired(common.AmountsFlag) - _ = depositCmd.MarkFlagRequired(common.RootTokenFlag) - _ = depositCmd.MarkFlagRequired(common.RootPredicateFlag) - - return depositCmd -} - -func preRunCommand(cmd *cobra.Command, _ []string) error { - return dp.Validate() -} - -func runCommand(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - depositorKey, err := helper.DecodePrivateKey(dp.SenderKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize depositor private key: %w", err)) - } - - depositorAddr := depositorKey.Address() - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(dp.JSONRPCAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize tx relayer: %w", err)) - - return - } - - amounts := make([]*big.Int, len(dp.Amounts)) - aggregateAmount := new(big.Int) - - for i, amountRaw := range dp.Amounts { - amountRaw := amountRaw - - amount, err := helperCommon.ParseUint256orHex(&amountRaw) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode provided amount %s: %w", amountRaw, err)) - - return - } - - amounts[i] = amount - aggregateAmount.Add(aggregateAmount, amount) - } - - if dp.minterKey != "" { - minterKey, err := helper.DecodePrivateKey(dp.minterKey) - if err != nil { - outputter.SetError(fmt.Errorf("invalid minter key provided: %w", err)) - - return - } - - // mint tokens to depositor, so he is able to send them - mintTxn, err := helper.CreateMintTxn(types.Address(depositorAddr), - types.StringToAddress(dp.TokenAddr), aggregateAmount, !dp.ChildChainMintable) - if err != nil { - outputter.SetError(fmt.Errorf("mint transaction creation failed: %w", err)) - - return - } - - receipt, err := txRelayer.SendTransaction(mintTxn, minterKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send mint transaction to depositor %s: %w", depositorAddr, err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to mint tokens to depositor %s", depositorAddr)) - - return - } - } - - // approve erc20 predicate - approveTxn, err := helper.CreateApproveERC20Txn(aggregateAmount, - types.StringToAddress(dp.PredicateAddr), - types.StringToAddress(dp.TokenAddr), - !dp.ChildChainMintable, - ) - if err != nil { - outputter.SetError(fmt.Errorf("failed to create root erc 20 approve transaction: %w", err)) - - return - } - - receipt, err := txRelayer.SendTransaction(approveTxn, depositorKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send root erc 20 approve transaction: %w", err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to approve root erc 20 predicate")) - - return - } - - type bridgeTxData struct { - exitEventIDs []*big.Int - blockNumber uint64 - childTokenAddr *types.Address - } - - g, ctx := errgroup.WithContext(cmd.Context()) - bridgeTxCh := make(chan bridgeTxData, len(dp.Receivers)) - exitEventIDs := make([]*big.Int, 0, len(dp.Receivers)) - blockNumbers := make([]uint64, 0, len(dp.Receivers)) - - for i := range dp.Receivers { - receiver := dp.Receivers[i] - amount := amounts[i] - - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - default: - // deposit tokens - depositTxn, err := createDepositTxn(types.Address(depositorAddr), types.StringToAddress(receiver), amount) - if err != nil { - return fmt.Errorf("failed to create tx input: %w", err) - } - - var receipt *ethgo.Receipt - - receipt, err = txRelayer.SendTransaction(depositTxn, depositorKey) - if err != nil { - return fmt.Errorf("receiver: %s, amount: %s, error: %w", receiver, amount, err) - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("receiver: %s, amount: %s", receiver, amount) - } - - var exitEventIDs []*big.Int - - if dp.ChildChainMintable { - if exitEventIDs, err = common.ExtractExitEventIDs(receipt); err != nil { - return fmt.Errorf("failed to extract exit event: %w", err) - } - } - - // populate child token address if a token is mapped alongside with deposit - childToken, err := common.ExtractChildTokenAddr(receipt, dp.ChildChainMintable) - if err != nil { - return fmt.Errorf("failed to extract child token address: %w", err) - } - - // send aggregated data to channel if everything went ok - bridgeTxCh <- bridgeTxData{ - blockNumber: receipt.BlockNumber, - exitEventIDs: exitEventIDs, - childTokenAddr: childToken, - } - - return nil - } - }) - } - - if err = g.Wait(); err != nil { - outputter.SetError(fmt.Errorf("sending deposit transactions failed: %w", err)) - - return - } - - close(bridgeTxCh) - - var childToken *types.Address - - for x := range bridgeTxCh { - if x.exitEventIDs != nil { - exitEventIDs = append(exitEventIDs, x.exitEventIDs...) - } - - blockNumbers = append(blockNumbers, x.blockNumber) - - if x.childTokenAddr != nil { - childToken = x.childTokenAddr - } - } - - outputter.SetCommandResult( - &common.BridgeTxResult{ - Sender: depositorAddr.String(), - Receivers: dp.Receivers, - Amounts: dp.Amounts, - ExitEventIDs: exitEventIDs, - ChildTokenAddr: childToken, - BlockNumbers: blockNumbers, - Title: "DEPOSIT ERC 20", - }) -} - -// createDepositTxn encodes parameters for deposit function on rootchain predicate contract -func createDepositTxn(sender, receiver types.Address, amount *big.Int) (*ethgo.Transaction, error) { - depositToFn := &contractsapi.DepositToRootERC20PredicateFn{ - RootToken: types.StringToAddress(dp.TokenAddr), - Receiver: receiver, - Amount: amount, - } - - input, err := depositToFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - addr := ethgo.Address(types.StringToAddress(dp.PredicateAddr)) - - return helper.CreateTransaction(ethgo.Address(sender), &addr, - input, nil, !dp.ChildChainMintable), nil -} diff --git a/command/bridge/deposit/erc721/deposit_erc721.go b/command/bridge/deposit/erc721/deposit_erc721.go deleted file mode 100644 index 46cb8f4..0000000 --- a/command/bridge/deposit/erc721/deposit_erc721.go +++ /dev/null @@ -1,273 +0,0 @@ -package deposit - -import ( - "fmt" - "math/big" - "strings" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/bridge/common" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - helperCommon "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -type depositERC721Params struct { - *common.ERC721BridgeParams - minterKey string -} - -var ( - dp *depositERC721Params = &depositERC721Params{ERC721BridgeParams: common.NewERC721BridgeParams()} -) - -func GetCommand() *cobra.Command { - depositCmd := &cobra.Command{ - Use: "deposit-erc721", - Short: "Deposits ERC721 tokens from the origin to the destination chain", - PreRunE: preRunCommand, - Run: runCommand, - } - - dp.RegisterCommonFlags(depositCmd) - - depositCmd.Flags().StringSliceVar( - &dp.TokenIDs, - common.TokenIDsFlag, - nil, - "token ids that are sent to the receivers accounts", - ) - - depositCmd.Flags().StringVar( - &dp.TokenAddr, - common.RootTokenFlag, - "", - "root ERC 721 token address", - ) - - depositCmd.Flags().StringVar( - &dp.PredicateAddr, - common.RootPredicateFlag, - "", - "root ERC 721 token predicate address", - ) - - depositCmd.Flags().StringVar( - &dp.minterKey, - common.MinterKeyFlag, - "", - common.MinterKeyFlagDesc, - ) - - _ = depositCmd.MarkFlagRequired(common.ReceiversFlag) - _ = depositCmd.MarkFlagRequired(common.TokenIDsFlag) - _ = depositCmd.MarkFlagRequired(common.RootTokenFlag) - _ = depositCmd.MarkFlagRequired(common.RootPredicateFlag) - - return depositCmd -} - -func preRunCommand(_ *cobra.Command, _ []string) error { - return dp.Validate() -} - -func runCommand(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - depositorKey, err := helper.DecodePrivateKey(dp.SenderKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize depositor private key: %w", err)) - } - - depositorAddr := depositorKey.Address() - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(dp.JSONRPCAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize tx relayer: %w", err)) - - return - } - - receivers := make([]ethgo.Address, len(dp.Receivers)) - tokenIDs := make([]*big.Int, len(dp.Receivers)) - - for i, tokenIDRaw := range dp.TokenIDs { - tokenIDRaw := tokenIDRaw - - tokenID, err := helperCommon.ParseUint256orHex(&tokenIDRaw) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode provided token id %s: %w", tokenIDRaw, err)) - - return - } - - receivers[i] = ethgo.Address(types.StringToAddress(dp.Receivers[i])) - tokenIDs[i] = tokenID - } - - if dp.minterKey != "" { - minterKey, err := helper.DecodePrivateKey(dp.minterKey) - if err != nil { - outputter.SetError(fmt.Errorf("invalid minter key provided: %w", err)) - - return - } - - for i := 0; i < len(tokenIDs); i++ { - mintTxn, err := createMintTxn(types.Address(depositorAddr), types.Address(depositorAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("mint transaction creation failed: %w", err)) - - return - } - - receipt, err := txRelayer.SendTransaction(mintTxn, minterKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send mint transaction to depositor %s: %w", - depositorAddr, err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to mint tokens to depositor %s", depositorAddr)) - - return - } - } - } - - approveTxn, err := createApproveERC721PredicateTxn(types.StringToAddress(dp.PredicateAddr), - types.StringToAddress(dp.TokenAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("failed to approve predicate: %w", err)) - - return - } - - receipt, err := txRelayer.SendTransaction(approveTxn, depositorKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send root erc 721 approve transaction: %w", err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to approve root erc 721 predicate")) - - return - } - - // deposit tokens - depositTxn, err := createDepositTxn(depositorAddr, receivers, tokenIDs) - if err != nil { - outputter.SetError(fmt.Errorf("failed to create tx input: %w", err)) - - return - } - - receipt, err = txRelayer.SendTransaction(depositTxn, depositorKey) - if err != nil { - outputter.SetError(fmt.Errorf("sending deposit transactions failed (receivers: %s, tokenIDs: %s): %w", - strings.Join(dp.Receivers, ", "), strings.Join(dp.TokenIDs, ", "), err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("sending deposit transactions failed (receivers: %s, tokenIDs: %s)", - strings.Join(dp.Receivers, ", "), strings.Join(dp.TokenIDs, ", "))) - - return - } - - res := &common.BridgeTxResult{ - Sender: depositorAddr.String(), - Receivers: dp.Receivers, - TokenIDs: dp.TokenIDs, - BlockNumbers: []uint64{receipt.BlockNumber}, - Title: "DEPOSIT ERC 721", - } - - if dp.ChildChainMintable { - exitEventIDs, err := common.ExtractExitEventIDs(receipt) - if err != nil { - outputter.SetError(fmt.Errorf("failed to extract exit event: %w", err)) - - return - } - - res.ExitEventIDs = exitEventIDs - } - - // populate child token address if a token is mapped alongside with deposit - childToken, err := common.ExtractChildTokenAddr(receipt, dp.ChildChainMintable) - if err != nil { - outputter.SetError(fmt.Errorf("failed to extract child token address: %w", err)) - - return - } - - res.ChildTokenAddr = childToken - - outputter.SetCommandResult(res) -} - -// createDepositTxn encodes parameters for deposit function on rootchain predicate contract -func createDepositTxn(sender ethgo.Address, - receivers []ethgo.Address, tokenIDs []*big.Int) (*ethgo.Transaction, error) { - depositToRoot := &contractsapi.DepositBatchRootERC721PredicateFn{ - RootToken: types.StringToAddress(dp.TokenAddr), - Receivers: receivers, - TokenIDs: tokenIDs, - } - - input, err := depositToRoot.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - addr := ethgo.Address(types.StringToAddress(dp.PredicateAddr)) - - return helper.CreateTransaction(sender, &addr, input, nil, !dp.ChildChainMintable), nil -} - -// createMintTxn encodes parameters for mint function on rootchain token contract -func createMintTxn(sender, receiver types.Address) (*ethgo.Transaction, error) { - mintFn := &contractsapi.MintRootERC721Fn{ - To: receiver, - } - - input, err := mintFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - addr := ethgo.Address(types.StringToAddress(dp.TokenAddr)) - - return helper.CreateTransaction(ethgo.Address(sender), &addr, - input, nil, !dp.ChildChainMintable), nil -} - -// createApproveERC721PredicateTxn sends approve transaction -func createApproveERC721PredicateTxn(rootERC721Predicate, rootERC721Token types.Address) (*ethgo.Transaction, error) { - approveFnParams := &contractsapi.SetApprovalForAllRootERC721Fn{ - Operator: rootERC721Predicate, - Approved: true, - } - - input, err := approveFnParams.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode parameters for RootERC721.approve. error: %w", err) - } - - addr := ethgo.Address(rootERC721Token) - - return helper.CreateTransaction(ethgo.ZeroAddress, &addr, input, - nil, !dp.ChildChainMintable), nil -} diff --git a/command/bridge/exit/exit.go b/command/bridge/exit/exit.go deleted file mode 100644 index 087fee8..0000000 --- a/command/bridge/exit/exit.go +++ /dev/null @@ -1,235 +0,0 @@ -package exit - -import ( - "bytes" - "encoding/hex" - "errors" - "fmt" - "math/big" - "strconv" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/jsonrpc" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/bridge/common" - cmdHelper "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -const ( - // flag names - exitHelperFlag = "exit-helper" - exitEventIDFlag = "exit-id" - rootJSONRPCFlag = "root-json-rpc" - childJSONRPCFlag = "child-json-rpc" - - // generateExitProofFn is JSON RPC endpoint which creates exit proof - generateExitProofFn = "bridge_generateExitProof" -) - -type exitParams struct { - senderKey string - exitHelperAddrRaw string - exitID uint64 - rootJSONRPCAddr string - childJSONRPCAddr string - isTestMode bool -} - -var ( - // ep represents exit command parameters - ep *exitParams = &exitParams{} -) - -// GetCommand returns the bridge exit command -func GetCommand() *cobra.Command { - exitCmd := &cobra.Command{ - Use: "exit", - Short: "Sends exit transaction to the Exit helper contract on the root chain", - Run: run, - } - - exitCmd.Flags().StringVar( - &ep.senderKey, - common.SenderKeyFlag, - "", - "hex encoded private key of the account which sends exit transaction to the root chain", - ) - - exitCmd.Flags().StringVar( - &ep.exitHelperAddrRaw, - exitHelperFlag, - "", - "address of ExitHelper smart contract on root chain", - ) - - exitCmd.Flags().Uint64Var( - &ep.exitID, - exitEventIDFlag, - 0, - "child chain exit event ID", - ) - - exitCmd.Flags().StringVar( - &ep.rootJSONRPCAddr, - rootJSONRPCFlag, - txrelayer.DefaultRPCAddress, - "the JSON RPC root chain endpoint", - ) - - exitCmd.Flags().StringVar( - &ep.childJSONRPCAddr, - childJSONRPCFlag, - "http://127.0.0.1:9545", - "the JSON RPC child chain endpoint", - ) - - exitCmd.Flags().BoolVar( - &ep.isTestMode, - helper.TestModeFlag, - false, - "test indicates whether exit transaction sender is hardcoded test account", - ) - - _ = exitCmd.MarkFlagRequired(exitHelperFlag) - exitCmd.MarkFlagsMutuallyExclusive(helper.TestModeFlag, common.SenderKeyFlag) - - return exitCmd -} - -func run(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - senderKey, err := helper.DecodePrivateKey(ep.senderKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to create wallet from private key: %w", err)) - - return - } - - rootTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(ep.rootJSONRPCAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("could not create root chain tx relayer: %w", err)) - - return - } - - childClient, err := jsonrpc.NewClient(ep.childJSONRPCAddr) - if err != nil { - outputter.SetError(fmt.Errorf("could not create child chain JSON RPC client: %w", err)) - - return - } - - // acquire proof for given exit event - var proof types.Proof - - err = childClient.Call(generateExitProofFn, &proof, fmt.Sprintf("0x%x", ep.exitID)) - if err != nil { - outputter.SetError(fmt.Errorf("failed to get exit proof (exit id=%d): %w", ep.exitID, err)) - - return - } - - // create exit transaction - txn, exitEvent, err := createExitTxn(senderKey.Address(), proof) - if err != nil { - outputter.SetError(fmt.Errorf("failed to create tx input: %w", err)) - - return - } - - // send exit transaction - receipt, err := rootTxRelayer.SendTransaction(txn, senderKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send exit transaction (exit id=%d): %w", ep.exitID, err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to execute exit transaction (exit id=%d)", ep.exitID)) - - return - } - - outputter.SetCommandResult(&exitResult{ - ID: strconv.FormatUint(exitEvent.ID.Uint64(), 10), - Sender: exitEvent.Sender.String(), - Receiver: exitEvent.Receiver.String(), - }) -} - -// createExitTxn encodes parameters for exit function on root chain ExitHelper contract -func createExitTxn(sender ethgo.Address, proof types.Proof) (*ethgo.Transaction, - *contractsapi.L2StateSyncedEvent, error) { - leafIndex, ok := proof.Metadata["LeafIndex"].(float64) - if !ok { - return nil, nil, errors.New("failed to convert proof leaf index") - } - - checkpointBlock, ok := proof.Metadata["CheckpointBlock"].(float64) - if !ok { - return nil, nil, errors.New("failed to convert proof checkpoint block") - } - - exitEventHex, ok := proof.Metadata["ExitEvent"].(string) - if !ok { - return nil, nil, errors.New("failed to convert exit event") - } - - exitEventEncoded, err := hex.DecodeString(exitEventHex) - if err != nil { - return nil, nil, fmt.Errorf("failed to decode hex-encoded exit event '%s': %w", exitEventHex, err) - } - - exitEvent := new(contractsapi.L2StateSyncedEvent) - if err := exitEvent.Decode(exitEventEncoded); err != nil { - return nil, nil, fmt.Errorf("failed to decode exit event: %w", err) - } - - exitFn := &contractsapi.ExitExitHelperFn{ - BlockNumber: new(big.Int).SetUint64(uint64(checkpointBlock)), - LeafIndex: new(big.Int).SetUint64(uint64(leafIndex)), - UnhashedLeaf: exitEventEncoded, - Proof: proof.Data, - } - - input, err := exitFn.EncodeAbi() - if err != nil { - return nil, nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - exitHelperAddr := ethgo.Address(types.StringToAddress(ep.exitHelperAddrRaw)) - txn := helper.CreateTransaction(sender, &exitHelperAddr, input, nil, true) - txn.Gas = txrelayer.DefaultGasLimit - - return txn, exitEvent, err -} - -type exitResult struct { - ID string `json:"id"` - Sender string `json:"sender"` - Receiver string `json:"receiver"` -} - -func (r *exitResult) GetOutput() string { - var buffer bytes.Buffer - - vals := make([]string, 0, 3) - vals = append(vals, fmt.Sprintf("Exit Event ID|%s", r.ID)) - vals = append(vals, fmt.Sprintf("Sender|%s", r.Sender)) - vals = append(vals, fmt.Sprintf("Receiver|%s", r.Receiver)) - - buffer.WriteString("\n[EXIT TRANSACTION RELAYER]\n") - buffer.WriteString(cmdHelper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/bridge/mint/mint_erc20.go b/command/bridge/mint/mint_erc20.go deleted file mode 100644 index e59aa20..0000000 --- a/command/bridge/mint/mint_erc20.go +++ /dev/null @@ -1,150 +0,0 @@ -package mint - -import ( - "fmt" - - "github.com/spf13/cobra" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" - "golang.org/x/sync/errgroup" -) - -var ( - params mintParams -) - -// GetCommand returns the rootchain fund command -func GetCommand() *cobra.Command { - mintCmd := &cobra.Command{ - Use: "mint-erc20", - Short: "Mints ERC20 tokens to specified addresses", - PreRunE: preRunCommand, - Run: runCommand, - } - - helper.RegisterJSONRPCFlag(mintCmd) - - setFlags(mintCmd) - - return mintCmd -} - -func preRunCommand(cmd *cobra.Command, _ []string) error { - params.jsonRPCAddress = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringSliceVar( - ¶ms.addresses, - rootHelper.AddressesFlag, - nil, - "addresses to which tokens should be minted", - ) - - cmd.Flags().StringSliceVar( - ¶ms.amounts, - rootHelper.AmountsFlag, - nil, - "token amounts which should be minted to given addresses", - ) - - cmd.Flags().StringVar( - ¶ms.tokenAddr, - rootHelper.Erc20TokenFlag, - "", - "address of the erc20 token to be minted", - ) - - cmd.Flags().StringVar( - ¶ms.deployerPrivateKey, - polybftsecrets.PrivateKeyFlag, - "", - "private key of the token deployer (minter)", - ) -} - -func runCommand(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPCAddress)) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize tx relayer: %w", err)) - - return - } - - deployerKey, err := rootHelper.DecodePrivateKey(params.deployerPrivateKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize deployer private key: %w", err)) - - return - } - - g, ctx := errgroup.WithContext(cmd.Context()) - - results := make([]command.CommandResult, len(params.addresses)) - tokenAddr := types.StringToAddress(params.tokenAddr) - - for i := 0; i < len(params.addresses); i++ { - i := i - - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - - default: - // mint tokens to address - addr := types.StringToAddress(params.addresses[i]) - amount := params.amountValues[i] - - mintTxn, err := rootHelper.CreateMintTxn(addr, tokenAddr, amount, true) - if err != nil { - return fmt.Errorf("failed to create mint native tokens transaction for validator '%s'. err: %w", - addr, err) - } - - receipt, err := txRelayer.SendTransaction(mintTxn, deployerKey) - if err != nil { - return fmt.Errorf("failed to send mint native tokens transaction to validator '%s'. err: %w", addr, err) - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("failed to mint native tokens to validator '%s'", addr) - } - - results[i] = &mintResult{ - Address: addr, - Amount: amount, - TxHash: types.Hash(receipt.TransactionHash), - } - - return nil - } - }) - } - - if err := g.Wait(); err != nil { - outputter.SetError(err) - _, _ = outputter.Write([]byte("[MINT-ERC20] Successfully minted tokens to following accounts\n")) - - for _, result := range results { - if result != nil { - // In case an error happened, some of the indices may not be populated. - // Filter those out. - outputter.SetCommandResult(result) - } - } - - return - } - - outputter.SetCommandResult(command.Results(results)) -} diff --git a/command/bridge/mint/params.go b/command/bridge/mint/params.go deleted file mode 100644 index 407b8f3..0000000 --- a/command/bridge/mint/params.go +++ /dev/null @@ -1,78 +0,0 @@ -package mint - -import ( - "bytes" - "fmt" - "math/big" - - "github.com/xgr-network/xgr-node/command/helper" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/types" -) - -type mintParams struct { - addresses []string - amounts []string - tokenAddr string - deployerPrivateKey string - jsonRPCAddress string - - amountValues []*big.Int -} - -func (m *mintParams) validateFlags() error { - if len(m.addresses) == 0 { - return rootHelper.ErrNoAddressesProvided - } - - if len(m.amounts) != len(m.addresses) { - return rootHelper.ErrInconsistentLength - } - - for _, addr := range m.addresses { - if err := types.IsValidAddress(addr); err != nil { - return err - } - } - - m.amountValues = make([]*big.Int, len(m.amounts)) - for i, amountRaw := range m.amounts { - amountValue, err := helper.ParseAmount(amountRaw) - if err != nil { - return err - } - - m.amountValues[i] = amountValue - } - - if m.tokenAddr == "" { - return rootHelper.ErrMandatoryERC20Token - } - - if err := types.IsValidAddress(m.tokenAddr); err != nil { - return fmt.Errorf("invalid erc20 token address is provided: %w", err) - } - - return nil -} - -type mintResult struct { - Address types.Address `json:"address"` - Amount *big.Int `json:"amount"` - TxHash types.Hash `json:"tx_hash"` -} - -func (m *mintResult) GetOutput() string { - var buffer bytes.Buffer - - vals := make([]string, 0, 3) - vals = append(vals, fmt.Sprintf("Address|%s", m.Address)) - vals = append(vals, fmt.Sprintf("Amount|%s", m.Amount)) - vals = append(vals, fmt.Sprintf("Transaction (hash)|%s", m.TxHash)) - - buffer.WriteString("\n[MINT-ERC20]\n") - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/bridge/withdraw/erc1155/withdraw_erc1155.go b/command/bridge/withdraw/erc1155/withdraw_erc1155.go deleted file mode 100644 index 97045f5..0000000 --- a/command/bridge/withdraw/erc1155/withdraw_erc1155.go +++ /dev/null @@ -1,193 +0,0 @@ -package erc1155 - -import ( - "encoding/hex" - "fmt" - "math/big" - "strings" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/wallet" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/bridge/common" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - helperCommon "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var ( - wp *common.ERC1155BridgeParams = common.NewERC1155BridgeParams() -) - -// GetCommand returns the bridge withdraw command -func GetCommand() *cobra.Command { - withdrawCmd := &cobra.Command{ - Use: "withdraw-erc1155", - Short: "Withdraws ERC 1155 tokens from the destination to the origin chain", - PreRunE: preRunCommand, - Run: runCommand, - } - - wp.RegisterCommonFlags(withdrawCmd) - - withdrawCmd.Flags().StringSliceVar( - &wp.Amounts, - common.AmountsFlag, - nil, - "amounts that are sent to the receivers accounts", - ) - - withdrawCmd.Flags().StringSliceVar( - &wp.TokenIDs, - common.TokenIDsFlag, - nil, - "token ids that are sent to the receivers accounts", - ) - - withdrawCmd.Flags().StringVar( - &wp.PredicateAddr, - common.ChildPredicateFlag, - contracts.ChildERC1155PredicateContract.String(), - "ERC 1155 child chain predicate address", - ) - - withdrawCmd.Flags().StringVar( - &wp.TokenAddr, - common.ChildTokenFlag, - contracts.ChildERC1155Contract.String(), - "ERC 1155 child chain token address", - ) - - _ = withdrawCmd.MarkFlagRequired(common.ReceiversFlag) - _ = withdrawCmd.MarkFlagRequired(common.AmountsFlag) - _ = withdrawCmd.MarkFlagRequired(common.TokenIDsFlag) - - return withdrawCmd -} - -func preRunCommand(_ *cobra.Command, _ []string) error { - return wp.Validate() -} - -func runCommand(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - senderKeyRaw, err := hex.DecodeString(wp.SenderKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode sender private key: %w", err)) - - return - } - - senderAccount, err := wallet.NewWalletFromPrivKey(senderKeyRaw) - if err != nil { - outputter.SetError(err) - - return - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(wp.JSONRPCAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("could not create child chain tx relayer: %w", err)) - - return - } - - receivers := make([]ethgo.Address, len(wp.Receivers)) - amounts := make([]*big.Int, len(wp.Receivers)) - TokenIDs := make([]*big.Int, len(wp.Receivers)) - - for i, receiverRaw := range wp.Receivers { - receivers[i] = ethgo.Address(types.StringToAddress(receiverRaw)) - amountRaw := wp.Amounts[i] - tokenIDRaw := wp.TokenIDs[i] - - amount, err := helperCommon.ParseUint256orHex(&amountRaw) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode provided amount %s: %w", amountRaw, err)) - - return - } - - tokenID, err := helperCommon.ParseUint256orHex(&tokenIDRaw) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode provided token id %s: %w", amountRaw, err)) - - return - } - - amounts[i] = amount - TokenIDs[i] = tokenID - } - - // withdraw tokens transaction - txn, err := createWithdrawTxn(receivers, amounts, TokenIDs) - if err != nil { - outputter.SetError(fmt.Errorf("failed to create tx input: %w", err)) - - return - } - - receipt, err := txRelayer.SendTransaction(txn, senderAccount) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send withdrawal transaction (receivers: %s, amounts: %s, token ids: %s): %w", - strings.Join(wp.Receivers, ", "), strings.Join(wp.Amounts, ", "), strings.Join(wp.TokenIDs, ", "), err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to execute withdrawal transaction (receivers: %s, amounts: %s, token ids: %s)", - strings.Join(wp.Receivers, ", "), strings.Join(wp.Amounts, ", "), strings.Join(wp.TokenIDs, ", "))) - - return - } - - res := &common.BridgeTxResult{ - Sender: senderAccount.Address().String(), - Receivers: wp.Receivers, - Amounts: wp.Amounts, - TokenIDs: wp.TokenIDs, - BlockNumbers: []uint64{receipt.BlockNumber}, - Title: "WITHDRAW ERC 1155", - } - - if !wp.ChildChainMintable { - exitEventIDs, err := common.ExtractExitEventIDs(receipt) - if err != nil { - outputter.SetError(fmt.Errorf("failed to extract exit event: %w", err)) - - return - } - - res.ExitEventIDs = exitEventIDs - } - - outputter.SetCommandResult(res) -} - -// createWithdrawTxn encodes parameters for withdraw function on child chain predicate contract -func createWithdrawTxn(receivers []ethgo.Address, amounts, TokenIDs []*big.Int) (*ethgo.Transaction, error) { - withdrawFn := &contractsapi.WithdrawBatchChildERC1155PredicateFn{ - ChildToken: types.StringToAddress(wp.TokenAddr), - Receivers: receivers, - Amounts: amounts, - TokenIDs: TokenIDs, - } - - input, err := withdrawFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - addr := ethgo.Address(types.StringToAddress(wp.PredicateAddr)) - - return helper.CreateTransaction(ethgo.ZeroAddress, &addr, input, - nil, wp.ChildChainMintable), nil -} diff --git a/command/bridge/withdraw/erc20/withdraw_erc20.go b/command/bridge/withdraw/erc20/withdraw_erc20.go deleted file mode 100644 index f795108..0000000 --- a/command/bridge/withdraw/erc20/withdraw_erc20.go +++ /dev/null @@ -1,171 +0,0 @@ -package erc20 - -import ( - "encoding/hex" - "fmt" - "math/big" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/wallet" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/bridge/common" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - helperCommon "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var ( - wp *common.ERC20BridgeParams = common.NewERC20BridgeParams() -) - -// GetCommand returns the bridge withdraw command -func GetCommand() *cobra.Command { - withdrawCmd := &cobra.Command{ - Use: "withdraw-erc20", - Short: "Withdraws ERC 20 tokens from the destination to the origin chain", - PreRunE: preRunCommand, - Run: runCommand, - } - - wp.RegisterCommonFlags(withdrawCmd) - - withdrawCmd.Flags().StringSliceVar( - &wp.Amounts, - common.AmountsFlag, - nil, - "amounts to send to receiving accounts", - ) - - withdrawCmd.Flags().StringVar( - &wp.PredicateAddr, - common.ChildPredicateFlag, - contracts.ChildERC20PredicateContract.String(), - "child ERC 20 predicate address", - ) - - withdrawCmd.Flags().StringVar( - &wp.TokenAddr, - common.ChildTokenFlag, - contracts.NativeERC20TokenContract.String(), - "child ERC 20 token address", - ) - - _ = withdrawCmd.MarkFlagRequired(common.ReceiversFlag) - _ = withdrawCmd.MarkFlagRequired(common.AmountsFlag) - - return withdrawCmd -} - -func preRunCommand(_ *cobra.Command, _ []string) error { - return wp.Validate() -} - -func runCommand(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - senderKeyRaw, err := hex.DecodeString(wp.SenderKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode sender private key: %w", err)) - - return - } - - senderAccount, err := wallet.NewWalletFromPrivKey(senderKeyRaw) - if err != nil { - outputter.SetError(err) - - return - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(wp.JSONRPCAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("could not create destination chain tx relayer: %w", err)) - - return - } - - exitEventIDs := make([]*big.Int, 0, len(wp.Receivers)) - blockNumbers := make([]uint64, len(wp.Receivers)) - - for i := range wp.Receivers { - receiver := wp.Receivers[i] - amount := wp.Amounts[i] - - amountBig, err := helperCommon.ParseUint256orHex(&amount) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode provided amount %s: %w", amount, err)) - - return - } - - // withdraw tokens transaction - txn, err := createWithdrawTxn(types.StringToAddress(receiver), amountBig) - if err != nil { - outputter.SetError(fmt.Errorf("failed to create tx input: %w", err)) - - return - } - - receipt, err := txRelayer.SendTransaction(txn, senderAccount) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send withdraw transaction (receiver: %s, amount: %s). error: %w)", - receiver, amount, err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to execute withdrawal (receiver: %s, amount: %s)", receiver, amount)) - - return - } - - if !wp.ChildChainMintable { - extractedExitEventIDs, err := common.ExtractExitEventIDs(receipt) - if err != nil { - outputter.SetError(fmt.Errorf("failed to extract exit event: %w", err)) - - return - } - - exitEventIDs = append(exitEventIDs, extractedExitEventIDs...) - } - - blockNumbers[i] = receipt.BlockNumber - } - - outputter.SetCommandResult( - &common.BridgeTxResult{ - Sender: senderAccount.Address().String(), - Receivers: wp.Receivers, - Amounts: wp.Amounts, - ExitEventIDs: exitEventIDs, - BlockNumbers: blockNumbers, - Title: "WITHDRAW ERC 20", - }) -} - -// createWithdrawTxn encodes parameters for withdraw function on destination predicate contract -func createWithdrawTxn(receiver types.Address, amount *big.Int) (*ethgo.Transaction, error) { - withdrawToFn := &contractsapi.WithdrawToChildERC20PredicateFn{ - ChildToken: types.StringToAddress(wp.TokenAddr), - Receiver: receiver, - Amount: amount, - } - - input, err := withdrawToFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - addr := ethgo.Address(types.StringToAddress(wp.PredicateAddr)) - - return helper.CreateTransaction(ethgo.ZeroAddress, &addr, input, - nil, wp.ChildChainMintable), nil -} diff --git a/command/bridge/withdraw/erc721/withdraw_erc721.go b/command/bridge/withdraw/erc721/withdraw_erc721.go deleted file mode 100644 index 850f44f..0000000 --- a/command/bridge/withdraw/erc721/withdraw_erc721.go +++ /dev/null @@ -1,171 +0,0 @@ -package withdraw - -import ( - "encoding/hex" - "fmt" - "math/big" - "strings" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/wallet" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/bridge/common" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - helperCommon "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var ( - wp *common.ERC721BridgeParams = common.NewERC721BridgeParams() -) - -func GetCommand() *cobra.Command { - withdrawCmd := &cobra.Command{ - Use: "withdraw-erc721", - Short: "Withdraws ERC 721 tokens from the destination to the origin chain", - PreRunE: preRun, - Run: run, - } - - wp.RegisterCommonFlags(withdrawCmd) - - withdrawCmd.Flags().StringSliceVar( - &wp.TokenIDs, - common.TokenIDsFlag, - nil, - "tokens ids to send to receiving accounts", - ) - - withdrawCmd.Flags().StringVar( - &wp.PredicateAddr, - common.ChildPredicateFlag, - contracts.ChildERC721PredicateContract.String(), - "ERC 721 child chain predicate address", - ) - - withdrawCmd.Flags().StringVar( - &wp.TokenAddr, - common.ChildTokenFlag, - contracts.ChildERC721Contract.String(), - "ERC 721 child chain token address", - ) - - _ = withdrawCmd.MarkFlagRequired(common.SenderKeyFlag) - _ = withdrawCmd.MarkFlagRequired(common.ReceiversFlag) - _ = withdrawCmd.MarkFlagRequired(common.TokenIDsFlag) - - return withdrawCmd -} - -func preRun(_ *cobra.Command, _ []string) error { - return wp.Validate() -} - -func run(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - senderKeyRaw, err := hex.DecodeString(wp.SenderKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode sender private key: %w", err)) - - return - } - - senderAccount, err := wallet.NewWalletFromPrivKey(senderKeyRaw) - if err != nil { - outputter.SetError(err) - - return - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(wp.JSONRPCAddr)) - if err != nil { - outputter.SetError(fmt.Errorf("could not create child chain tx relayer: %w", err)) - - return - } - - receivers := make([]ethgo.Address, len(wp.Receivers)) - tokenIDs := make([]*big.Int, len(wp.Receivers)) - - for i, tokenIDRaw := range wp.TokenIDs { - tokenIDRaw := tokenIDRaw - - tokenID, err := helperCommon.ParseUint256orHex(&tokenIDRaw) - if err != nil { - outputter.SetError(fmt.Errorf("failed to decode provided token id %s: %w", tokenIDRaw, err)) - - return - } - - receivers[i] = ethgo.Address(types.StringToAddress(wp.Receivers[i])) - tokenIDs[i] = tokenID - } - - txn, err := createWithdrawTxn(receivers, tokenIDs) - if err != nil { - outputter.SetError(fmt.Errorf("failed to create tx input: %w", err)) - - return - } - - receipt, err := txRelayer.SendTransaction(txn, senderAccount) - if err != nil { - outputter.SetError(fmt.Errorf("failed to send withdrawal transaction (receivers: %s, token ids: %s): %w", - strings.Join(wp.Receivers, ", "), strings.Join(wp.TokenIDs, ", "), err)) - - return - } - - if receipt.Status == uint64(types.ReceiptFailed) { - outputter.SetError(fmt.Errorf("failed to execute withdrawal transaction (receivers: %s, token ids: %s)", - strings.Join(wp.Receivers, ", "), strings.Join(wp.TokenIDs, ", "))) - - return - } - - res := &common.BridgeTxResult{ - Sender: senderAccount.Address().String(), - Receivers: wp.Receivers, - TokenIDs: wp.TokenIDs, - BlockNumbers: []uint64{receipt.BlockNumber}, - Title: "WITHDRAW ERC 721", - } - - if !wp.ChildChainMintable { - exitEventIDs, err := common.ExtractExitEventIDs(receipt) - if err != nil { - outputter.SetError(fmt.Errorf("failed to extract exit event: %w", err)) - - return - } - - res.ExitEventIDs = exitEventIDs - } - - outputter.SetCommandResult(res) -} - -// createWithdrawTxn encodes parameters for withdraw function on child chain predicate contract -func createWithdrawTxn(receivers []ethgo.Address, tokenIDs []*big.Int) (*ethgo.Transaction, error) { - withdrawToFn := &contractsapi.WithdrawBatchChildERC721PredicateFn{ - ChildToken: types.StringToAddress(wp.TokenAddr), - Receivers: receivers, - TokenIDs: tokenIDs, - } - - input, err := withdrawToFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - addr := ethgo.Address(types.StringToAddress(wp.PredicateAddr)) - - return helper.CreateTransaction(ethgo.ZeroAddress, &addr, input, - nil, wp.ChildChainMintable), nil -} diff --git a/command/default.go b/command/default.go index da12d7a..71b2d8e 100644 --- a/command/default.go +++ b/command/default.go @@ -13,7 +13,7 @@ const ( DefaultGenesisFileName = "genesis.json" DefaultChainName = "xgrchain" DefaultChainID = 100 - DefaultConsensus = server.PolyBFTConsensus + DefaultConsensus = server.IBFTConsensus DefaultGenesisGasUsed = 458752 // 0x70000 DefaultGenesisGasLimit = 5242880 // 0x500000 DefaultGenesisBaseFeeEM = chain.GenesisBaseFeeEM diff --git a/command/genesis/genesis.go b/command/genesis/genesis.go index 7204660..a74f960 100644 --- a/command/genesis/genesis.go +++ b/command/genesis/genesis.go @@ -110,13 +110,6 @@ func setFlags(cmd *cobra.Command) { "the epoch size for the chain", ) - cmd.Flags().StringVar( - ¶ms.proxyContractsAdmin, - proxyContractsAdminFlag, - "", - "admin for proxy contracts", - ) - // PoS { cmd.Flags().BoolVar( @@ -159,7 +152,7 @@ func setFlags(cmd *cobra.Command) { ¶ms.validators, command.ValidatorFlag, []string{}, - "validators defined by user (polybft format: ::)", + "validators defined by user", ) cmd.MarkFlagsMutuallyExclusive(command.ValidatorFlag, command.ValidatorRootFlag) @@ -176,160 +169,12 @@ func setFlags(cmd *cobra.Command) { ) } - // PolyBFT - { - cmd.Flags().Uint64Var( - ¶ms.sprintSize, - sprintSizeFlag, - defaultSprintSize, - "the number of block included into a sprint", - ) - - cmd.Flags().DurationVar( - ¶ms.blockTime, - blockTimeFlag, - defaultBlockTime, - "the predefined period which determines block creation frequency", - ) - - cmd.Flags().Uint64Var( - ¶ms.epochReward, - epochRewardFlag, - defaultEpochReward, - "reward size for block sealing", - ) - - // regenesis flag that allows to start from non-empty database - cmd.Flags().StringVar( - ¶ms.initialStateRoot, - trieRootFlag, - "", - "trie root from the corresponding triedb", - ) - - cmd.Flags().StringVar( - ¶ms.nativeTokenConfigRaw, - nativeTokenConfigFlag, - "", - "native token configuration, provided in the following format: "+ - "", - ) - - cmd.Flags().StringVar( - ¶ms.rewardTokenCode, - rewardTokenCodeFlag, - "", - "hex encoded reward token byte code", - ) - - cmd.Flags().StringVar( - ¶ms.rewardWallet, - rewardWalletFlag, - "", - "configuration of reward wallet in format ", - ) - - cmd.Flags().Uint64Var( - ¶ms.blockTimeDrift, - blockTimeDriftFlag, - defaultBlockTimeDrift, - "configuration for block time drift value (in seconds)", - ) - - cmd.Flags().DurationVar( - ¶ms.blockTrackerPollInterval, - blockTrackerPollIntervalFlag, - defaultBlockTrackerPollInterval, - "interval (number of seconds) at which block tracker polls for latest block at rootchain", - ) - } - - // Access Control Lists - { - cmd.Flags().StringArrayVar( - ¶ms.contractDeployerAllowListAdmin, - contractDeployerAllowListAdminFlag, - []string{}, - "list of addresses to use as admin accounts in the contract deployer allow list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.contractDeployerAllowListEnabled, - contractDeployerAllowListEnabledFlag, - []string{}, - "list of addresses to enable by default in the contract deployer allow list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.contractDeployerBlockListAdmin, - contractDeployerBlockListAdminFlag, - []string{}, - "list of addresses to use as admin accounts in the contract deployer block list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.contractDeployerBlockListEnabled, - contractDeployerBlockListEnabledFlag, - []string{}, - "list of addresses to enable by default in the contract deployer block list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.transactionsAllowListAdmin, - transactionsAllowListAdminFlag, - []string{}, - "list of addresses to use as admin accounts in the transactions allow list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.transactionsAllowListEnabled, - transactionsAllowListEnabledFlag, - []string{}, - "list of addresses to enable by default in the transactions allow list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.transactionsBlockListAdmin, - transactionsBlockListAdminFlag, - []string{}, - "list of addresses to use as admin accounts in the transactions block list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.transactionsBlockListEnabled, - transactionsBlockListEnabledFlag, - []string{}, - "list of addresses to enable by default in the transactions block list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.bridgeAllowListAdmin, - bridgeAllowListAdminFlag, - []string{}, - "list of addresses to use as admin accounts in the bridge allow list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.bridgeAllowListEnabled, - bridgeAllowListEnabledFlag, - []string{}, - "list of addresses to enable by default in the bridge allow list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.bridgeBlockListAdmin, - bridgeBlockListAdminFlag, - []string{}, - "list of addresses to use as admin accounts in the bridge block list", - ) - - cmd.Flags().StringArrayVar( - ¶ms.bridgeBlockListEnabled, - bridgeBlockListEnabledFlag, - []string{}, - "list of addresses to enable by default in the bridge block list", - ) - } + cmd.Flags().DurationVar( + ¶ms.blockTime, + blockTimeFlag, + defaultBlockTime, + "the predefined period which determines block creation frequency", + ) } // setLegacyFlags sets the legacy flags to preserve backwards compatibility @@ -362,12 +207,8 @@ func runCommand(cmd *cobra.Command, _ []string) { var err error - if params.isPolyBFTConsensus() { - err = params.generatePolyBftChainConfig(outputter) - } else { - _, _ = outputter.Write([]byte(fmt.Sprintf("%s\n", common.IBFTImportantNotice))) - err = params.generateGenesis() - } + _, _ = outputter.Write([]byte(fmt.Sprintf("%s\n", common.IBFTImportantNotice))) + err = params.generateGenesis() if err != nil { outputter.SetError(err) diff --git a/command/genesis/params.go b/command/genesis/params.go index 6e26f88..a446271 100644 --- a/command/genesis/params.go +++ b/command/genesis/params.go @@ -3,9 +3,7 @@ package genesis import ( "errors" "fmt" - "math/big" "os" - "strings" "time" "github.com/xgr-network/xgr-node/chain" @@ -14,8 +12,6 @@ import ( "github.com/xgr-network/xgr-node/consensus/ibft" "github.com/xgr-network/xgr-node/consensus/ibft/fork" "github.com/xgr-network/xgr-node/consensus/ibft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/contracts" "github.com/xgr-network/xgr-node/contracts/staking" stakingHelper "github.com/xgr-network/xgr-node/helper/staking" "github.com/xgr-network/xgr-node/server" @@ -24,21 +20,15 @@ import ( ) const ( - dirFlag = "dir" - nameFlag = "name" - premineFlag = "premine" - chainIDFlag = "chain-id" - epochSizeFlag = "epoch-size" - epochRewardFlag = "epoch-reward" - blockGasLimitFlag = "block-gas-limit" - burnContractFlag = "burn-contract" - genesisBaseFeeConfigFlag = "base-fee-config" - posFlag = "pos" - nativeTokenConfigFlag = "native-token-config" - rewardTokenCodeFlag = "reward-token-code" - rewardWalletFlag = "reward-wallet" - blockTrackerPollIntervalFlag = "block-tracker-poll-interval" - proxyContractsAdminFlag = "proxy-contracts-admin" + dirFlag = "dir" + nameFlag = "name" + premineFlag = "premine" + chainIDFlag = "chain-id" + epochSizeFlag = "epoch-size" + blockGasLimitFlag = "block-gas-limit" + burnContractFlag = "burn-contract" + genesisBaseFeeConfigFlag = "base-fee-config" + posFlag = "pos" ) // Legacy flags that need to be preserved for running clients @@ -46,24 +36,22 @@ const ( chainIDFlagLEGACY = "chainid" ) +const ( + blockTimeFlag = "block-time" + defaultBlockTime = 2 * time.Second +) + var ( params = &genesisParams{} ) var ( - errValidatorsNotSpecified = errors.New("validator information not specified") - errUnsupportedConsensus = errors.New("specified consensusRaw not supported") - errInvalidEpochSize = errors.New("epoch size must be greater than 1") - errRewardWalletAmountZero = errors.New("reward wallet amount can not be zero or negative") - errReserveAccMustBePremined = errors.New("it is mandatory to premine reserve account (0x0 address)") - errBlockTrackerPollInterval = errors.New("block tracker poll interval must be greater than 0") - errBaseFeeChangeDenomZero = errors.New("base fee change denominator must be greater than 0") - errBaseFeeEMZero = errors.New("base fee elasticity multiplier must be greater than 0") - errBaseFeeZero = errors.New("base fee must be greater than 0") - errRewardWalletNotDefined = errors.New("reward wallet address must be defined") - errRewardTokenOnNonMintable = errors.New("a custom reward token must be defined when " + - "native ERC20 token is non-mintable") - errRewardWalletZero = errors.New("reward wallet address must not be zero address") + errValidatorsNotSpecified = errors.New("validator information not specified") + errUnsupportedConsensus = errors.New("specified consensusRaw not supported") + errInvalidEpochSize = errors.New("epoch size must be greater than 1") + errBaseFeeChangeDenomZero = errors.New("base fee change denominator must be greater than 0") + errBaseFeeEMZero = errors.New("base fee elasticity multiplier must be greater than 0") + errBaseFeeZero = errors.New("base fee must be greater than 0") ) type genesisParams struct { @@ -102,40 +90,9 @@ type genesisParams struct { genesisConfig *chain.Chain - // PolyBFT - sprintSize uint64 - blockTime time.Duration - epochReward uint64 - blockTimeDrift uint64 - - initialStateRoot string - - // access lists - contractDeployerAllowListAdmin []string - contractDeployerAllowListEnabled []string - contractDeployerBlockListAdmin []string - contractDeployerBlockListEnabled []string - transactionsAllowListAdmin []string - transactionsAllowListEnabled []string - transactionsBlockListAdmin []string - transactionsBlockListEnabled []string - bridgeAllowListAdmin []string - bridgeAllowListEnabled []string - bridgeBlockListAdmin []string - bridgeBlockListEnabled []string - - nativeTokenConfigRaw string - nativeTokenConfig *polybft.TokenConfig - premineInfos []*helper.PremineInfo - // rewards - rewardTokenCode string - rewardWallet string - - blockTrackerPollInterval time.Duration - - proxyContractsAdmin string + blockTime time.Duration } func (p *genesisParams) validateFlags() error { @@ -159,35 +116,13 @@ func (p *genesisParams) validateFlags() error { return err } - if p.isPolyBFTConsensus() { - if err := p.extractNativeTokenMetadata(); err != nil { - return err - } - - if err := p.validateBurnContract(); err != nil { - return err - } - - if err := p.validateRewardWalletAndToken(); err != nil { - return err - } - - if err := p.validatePremineInfo(); err != nil { - return err - } - - if err := p.validateProxyContractsAdmin(); err != nil { - return err - } - } - // Check if the genesis file already exists if generateError := verifyGenesisExistence(p.genesisPath); generateError != nil { return errors.New(generateError.GetMessage()) } // Check that the epoch size is correct - if p.epochSize < 2 && (p.isIBFTConsensus() || p.isPolyBFTConsensus()) { + if p.epochSize < 2 && p.isIBFTConsensus() { // Epoch size must be greater than 1, so new transactions have a chance to be added to a block. // Otherwise, every block would be an endblock (meaning it will not have any transactions). // Check is placed here to avoid additional parsing if epochSize < 2 @@ -209,10 +144,6 @@ func (p *genesisParams) isIBFTConsensus() bool { return server.ConsensusType(p.consensusRaw) == server.IBFTConsensus } -func (p *genesisParams) isPolyBFTConsensus() bool { - return server.ConsensusType(p.consensusRaw) == server.PolyBFTConsensus -} - func (p *genesisParams) areValidatorsSetManually() bool { return len(p.validators) != 0 } @@ -234,10 +165,6 @@ func (p *genesisParams) getRequiredFlags() []string { func (p *genesisParams) initRawParams() error { p.consensus = server.ConsensusType(p.consensusRaw) - if p.consensus == server.PolyBFTConsensus { - return nil - } - if err := p.initIBFTValidatorType(); err != nil { return err } @@ -464,6 +391,7 @@ func (p *genesisParams) predeployStakingSC() (*chain.GenesisAccount, error) { stakingHelper.PredeployParams{ MinValidatorCount: p.minNumValidators, MaxValidatorCount: p.maxNumValidators, + EpochSize: p.epochSize, }) if predeployErr != nil { return nil, predeployErr @@ -472,33 +400,6 @@ func (p *genesisParams) predeployStakingSC() (*chain.GenesisAccount, error) { return stakingAccount, nil } -// validateRewardWalletAndToken validates reward wallet flag -func (p *genesisParams) validateRewardWalletAndToken() error { - if p.rewardWallet == "" { - return errRewardWalletNotDefined - } - - if !p.nativeTokenConfig.IsMintable && p.rewardTokenCode == "" { - return errRewardTokenOnNonMintable - } - - premineInfo, err := helper.ParsePremineInfo(p.rewardWallet) - if err != nil { - return err - } - - if premineInfo.Address == types.ZeroAddress { - return errRewardWalletZero - } - - // If epoch rewards are enabled, reward wallet must have some amount of premine - if p.epochReward > 0 && premineInfo.Amount.Cmp(big.NewInt(0)) < 1 { - return errRewardWalletAmountZero - } - - return nil -} - // parsePremineInfo parses premine flag func (p *genesisParams) parsePremineInfo() error { p.premineInfos = make([]*helper.PremineInfo, 0, len(p.premine)) @@ -515,28 +416,6 @@ func (p *genesisParams) parsePremineInfo() error { return nil } -// validatePremineInfo validates whether reserve account (0x0 address) is premined -func (p *genesisParams) validatePremineInfo() error { - for _, premineInfo := range p.premineInfos { - if premineInfo.Address == types.ZeroAddress { - // we have premine of zero address, just return - return nil - } - } - - return errReserveAccMustBePremined -} - -// validateBlockTrackerPollInterval validates block tracker block interval -// which can not be 0 -func (p *genesisParams) validateBlockTrackerPollInterval() error { - if p.blockTrackerPollInterval == 0 { - return helper.ErrBlockTrackerPollInterval - } - - return nil -} - // validateBurnContract validates burn contract. If native token is mintable, // burn contract flag must not be set. If native token is non mintable only one burn contract // can be set and the specified address will be used to predeploy default EIP1559 burn contract. @@ -547,14 +426,8 @@ func (p *genesisParams) validateBurnContract() error { return fmt.Errorf("invalid burn contract info provided: %w", err) } - if p.nativeTokenConfig.IsMintable { - if burnContractInfo.Address != types.ZeroAddress { - return errors.New("only zero address is allowed as burn destination for mintable native token") - } - } else { - if burnContractInfo.Address == types.ZeroAddress { - return errors.New("it is not allowed to deploy burn contract to 0x0 address") - } + if burnContractInfo.Address == types.ZeroAddress { + return errors.New("it is not allowed to deploy burn contract to 0x0 address") } } @@ -588,40 +461,11 @@ func (p *genesisParams) validateGenesisBaseFeeConfig() error { return nil } -func (p *genesisParams) validateProxyContractsAdmin() error { - if strings.TrimSpace(p.proxyContractsAdmin) == "" { - return errors.New("proxy contracts admin address must be set") - } - - proxyContractsAdminAddr := types.StringToAddress(p.proxyContractsAdmin) - if proxyContractsAdminAddr == types.ZeroAddress { - return errors.New("proxy contracts admin address must not be zero address") - } - - if proxyContractsAdminAddr == contracts.SystemCaller { - return errors.New("proxy contracts admin address must not be system caller address") - } - - return nil -} - // isBurnContractEnabled returns true in case burn contract info is provided func (p *genesisParams) isBurnContractEnabled() bool { return p.burnContract != "" } -// extractNativeTokenMetadata parses provided native token metadata (such as name, symbol and decimals count) -func (p *genesisParams) extractNativeTokenMetadata() error { - tokenConfig, err := polybft.ParseRawTokenConfig(p.nativeTokenConfigRaw) - if err != nil { - return err - } - - p.nativeTokenConfig = tokenConfig - - return nil -} - func (p *genesisParams) getResult() command.CommandResult { return &GenesisResult{ Message: fmt.Sprintf("\nGenesis written to %s\n", p.genesisPath), diff --git a/command/genesis/params_test.go b/command/genesis/params_test.go index 632ba5f..7b5a784 100644 --- a/command/genesis/params_test.go +++ b/command/genesis/params_test.go @@ -1,244 +1,27 @@ package genesis import ( - "fmt" + "math/big" "testing" "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/command" "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/consensus/polybft" "github.com/xgr-network/xgr-node/types" ) -func Test_extractNativeTokenMetadata(t *testing.T) { +func Test_parsePremineInfo(t *testing.T) { t.Parallel() - cases := []struct { - name string - rawConfig string - expectedCfg *polybft.TokenConfig - expectErr bool - }{ - { - name: "default token config", - rawConfig: "", - expectedCfg: polybft.DefaultTokenConfig, - expectErr: false, - }, - { - name: "not enough params provided", - rawConfig: "Test:TST:18", - expectErr: true, - }, - { - name: "empty name provided", - rawConfig: ":TST:18:false", - expectErr: true, - }, - { - name: "empty symbol provided", - rawConfig: "Test::18:false", - expectErr: true, - }, - { - name: "invalid decimals number provided", - rawConfig: "Test:TST:9999999999999999999999999999999999999999999999999999999999:false", - expectErr: true, - }, - { - name: "invalid mintable flag provided", - rawConfig: "Test:TST:18:bar", - expectErr: true, - }, - { - name: "mintable token not enough params provided", - rawConfig: "Test:TST:18:true", - expectErr: true, - }, - { - name: "non-mintable valid config", - rawConfig: "MyToken:MTK:9:false", - expectedCfg: &polybft.TokenConfig{ - Name: "MyToken", - Symbol: "MTK", - Decimals: 9, - IsMintable: false, - Owner: types.ZeroAddress, - }, - expectErr: false, - }, - { - name: "non-mintable token config, owner provided but ignored", - rawConfig: "MyToken:MTK:9:false:0x123456789", - expectedCfg: &polybft.TokenConfig{ - Name: "MyToken", - Symbol: "MTK", - Decimals: 9, - IsMintable: false, - Owner: types.ZeroAddress, - }, - expectErr: false, - }, - { - name: "mintable token valid config", - rawConfig: "MyMintToken:MMTK:9:true:0x123456789", - expectedCfg: &polybft.TokenConfig{ - Name: "MyMintToken", - Symbol: "MMTK", - Decimals: 9, - IsMintable: true, - Owner: types.StringToAddress("0x123456789"), - }, - expectErr: false, - }, + p := &genesisParams{ + premine: []string{types.StringToAddress("1").String() + ":1000"}, } - for _, c := range cases { - c := c - t.Run(c.name, func(t *testing.T) { - t.Parallel() - - p := &genesisParams{nativeTokenConfigRaw: c.rawConfig} - err := p.extractNativeTokenMetadata() - - if c.expectErr { - require.Error(t, err) - require.Nil(t, p.nativeTokenConfig) - } else { - require.NoError(t, err) - require.Equal(t, c.expectedCfg, p.nativeTokenConfig) - } - }) - } -} - -func Test_validatePremineInfo(t *testing.T) { - t.Parallel() - - cases := []struct { - name string - premineRaw []string - expectedPremines []*helper.PremineInfo - expectValidateErrMsg string - expectedParseErrMsg string - }{ - { - name: "invalid premine balance", - premineRaw: []string{"0x12345:loremIpsum"}, - expectedPremines: []*helper.PremineInfo{}, - expectedParseErrMsg: "invalid premine balance amount provided", - }, - { - name: "missing zero address premine", - premineRaw: []string{types.StringToAddress("12").String()}, - expectedPremines: []*helper.PremineInfo{ - {Address: types.StringToAddress("12"), Amount: command.DefaultPremineBalance}, - }, - expectValidateErrMsg: errReserveAccMustBePremined.Error(), - }, - { - name: "valid premine information", - premineRaw: []string{ - fmt.Sprintf("%s:%d", types.StringToAddress("1"), ethgo.Ether(10)), - fmt.Sprintf("%s:%d", types.ZeroAddress, ethgo.Ether(10000)), - }, - expectedPremines: []*helper.PremineInfo{ - {Address: types.StringToAddress("1"), Amount: ethgo.Ether(10)}, - {Address: types.ZeroAddress, Amount: ethgo.Ether(10000)}, - }, - expectValidateErrMsg: "", - }, - } - - for _, c := range cases { - c := c - t.Run(c.name, func(t *testing.T) { - t.Parallel() - - p := &genesisParams{premine: c.premineRaw} - err := p.parsePremineInfo() - if c.expectedParseErrMsg != "" { - require.ErrorContains(t, err, c.expectedParseErrMsg) - - return - } else { - require.NoError(t, err) - } - - err = p.validatePremineInfo() - - if c.expectValidateErrMsg != "" { - require.ErrorContains(t, err, c.expectValidateErrMsg) - } else { - require.NoError(t, err) - } - - require.Equal(t, c.expectedPremines, p.premineInfos) - }) - } -} - -func Test_validateRewardWallet(t *testing.T) { - t.Parallel() - - cases := []struct { - name string - rewardWallet string - epochReward uint64 - isNativeERC20Mintable bool - expectValidateErr error - }{ - { - name: "invalid reward wallet: no premine + reward", - rewardWallet: types.StringToAddress("1").String() + ":0", - epochReward: 10, - isNativeERC20Mintable: true, - expectValidateErr: errRewardWalletAmountZero, - }, - { - name: "invalid reward wallet: reward wallet not defined", - rewardWallet: "", - epochReward: 10, - isNativeERC20Mintable: true, - expectValidateErr: errRewardWalletNotDefined, - }, - { - name: "invalid reward wallet: reward wallet is zero", - rewardWallet: types.ZeroAddress.String() + ":0", - epochReward: 10, - isNativeERC20Mintable: true, - expectValidateErr: errRewardWalletZero, - }, - { - name: "valid reward wallet: no premine + no reward", - rewardWallet: types.StringToAddress("1").String() + ":0", - epochReward: 0, - isNativeERC20Mintable: true, - expectValidateErr: nil, - }, - { - name: "valid reward wallet: native ERC20 mintable", - rewardWallet: types.StringToAddress("1").String() + ":0", - epochReward: 0, - isNativeERC20Mintable: false, - expectValidateErr: errRewardTokenOnNonMintable, - }, - } - for _, c := range cases { - c := c - t.Run(c.name, func(t *testing.T) { - t.Parallel() - - p := &genesisParams{ - rewardWallet: c.rewardWallet, - epochReward: c.epochReward, - nativeTokenConfig: &polybft.TokenConfig{IsMintable: c.isNativeERC20Mintable}, - } - err := p.validateRewardWalletAndToken() - require.ErrorIs(t, err, c.expectValidateErr) - }) - } + err := p.parsePremineInfo() + require.NoError(t, err) + require.Len(t, p.premineInfos, 1) + require.Equal(t, &helper.PremineInfo{ + Address: types.StringToAddress("1"), + Amount: big.NewInt(1000), + }, p.premineInfos[0]) } diff --git a/command/genesis/polybft_params.go b/command/genesis/polybft_params.go deleted file mode 100644 index 0a92f51..0000000 --- a/command/genesis/polybft_params.go +++ /dev/null @@ -1,567 +0,0 @@ -package genesis - -import ( - "encoding/hex" - "errors" - "fmt" - "math/big" - "path" - "strings" - "time" - - "github.com/multiformats/go-multiaddr" - - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi/artifact" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/server" - "github.com/xgr-network/xgr-node/types" -) - -const ( - sprintSizeFlag = "sprint-size" - blockTimeFlag = "block-time" - trieRootFlag = "trieroot" - - blockTimeDriftFlag = "block-time-drift" - - defaultEpochSize = uint64(10) - defaultSprintSize = uint64(5) - defaultValidatorSetSize = 100 - defaultBlockTime = 2 * time.Second - defaultEpochReward = 1 - defaultBlockTimeDrift = uint64(10) - defaultBlockTrackerPollInterval = time.Second - - contractDeployerAllowListAdminFlag = "contract-deployer-allow-list-admin" - contractDeployerAllowListEnabledFlag = "contract-deployer-allow-list-enabled" - contractDeployerBlockListAdminFlag = "contract-deployer-block-list-admin" - contractDeployerBlockListEnabledFlag = "contract-deployer-block-list-enabled" - transactionsAllowListAdminFlag = "transactions-allow-list-admin" - transactionsAllowListEnabledFlag = "transactions-allow-list-enabled" - transactionsBlockListAdminFlag = "transactions-block-list-admin" - transactionsBlockListEnabledFlag = "transactions-block-list-enabled" - bridgeAllowListAdminFlag = "bridge-allow-list-admin" - bridgeAllowListEnabledFlag = "bridge-allow-list-enabled" - bridgeBlockListAdminFlag = "bridge-block-list-admin" - bridgeBlockListEnabledFlag = "bridge-block-list-enabled" - - bootnodePortStart = 30301 - - ecdsaAddressLength = 40 - blsKeyLength = 256 -) - -var ( - errNoGenesisValidators = errors.New("genesis validators aren't provided") - errNoPremineAllowed = errors.New("native token is not mintable, so no premine is allowed " + - "except for zero address and reward wallet if native token is used as reward token") -) - -type contractInfo struct { - artifact *artifact.Artifact - address types.Address -} - -// generatePolyBftChainConfig creates and persists polybft chain configuration to the provided file path -func (p *genesisParams) generatePolyBftChainConfig(o command.OutputFormatter) error { - // populate premine balance map - premineBalances := make(map[types.Address]*helper.PremineInfo, len(p.premine)) - - for _, premine := range p.premineInfos { - premineBalances[premine.Address] = premine - } - - walletPremineInfo, err := helper.ParsePremineInfo(p.rewardWallet) - if err != nil { - return fmt.Errorf("invalid reward wallet configuration provided '%s' : %w", p.rewardWallet, err) - } - - if !p.nativeTokenConfig.IsMintable { - // validate premine map, no premine is allowed if token is not mintable, - // except for the reward wallet (if native token is used as reward token) and zero address - for a := range premineBalances { - if a != types.ZeroAddress && (p.rewardTokenCode != "" || a != walletPremineInfo.Address) { - return errNoPremineAllowed - } - } - } - - var ( - rewardTokenByteCode []byte - rewardTokenAddr = contracts.NativeERC20TokenContract - ) - - if p.rewardTokenCode == "" { - // native token is used as a reward token, and reward wallet is not a zero address - if p.epochReward > 0 { - // epoch reward is non zero so premine reward wallet - premineBalances[walletPremineInfo.Address] = walletPremineInfo - } - } else { - bytes, err := hex.DecodeString(p.rewardTokenCode) - if err != nil { - return fmt.Errorf("could not decode reward token byte code '%s' : %w", p.rewardTokenCode, err) - } - - rewardTokenByteCode = bytes - rewardTokenAddr = contracts.RewardTokenContract - } - - initialValidators, err := p.getValidatorAccounts() - if err != nil { - return fmt.Errorf("failed to retrieve genesis validators: %w", err) - } - - if len(initialValidators) == 0 { - return errNoGenesisValidators - } - - if _, err := o.Write([]byte("[GENESIS VALIDATORS]\n")); err != nil { - return err - } - - for _, v := range initialValidators { - if _, err := o.Write([]byte(fmt.Sprintf("%v\n", v))); err != nil { - return err - } - } - - polyBftConfig := &polybft.PolyBFTConfig{ - InitialValidatorSet: initialValidators, - BlockTime: common.Duration{Duration: p.blockTime}, - EpochSize: p.epochSize, - SprintSize: p.sprintSize, - EpochReward: p.epochReward, - // use 1st account as governance address - Governance: types.ZeroAddress, - InitialTrieRoot: types.StringToHash(p.initialStateRoot), - NativeTokenConfig: p.nativeTokenConfig, - MinValidatorSetSize: p.minNumValidators, - MaxValidatorSetSize: p.maxNumValidators, - RewardConfig: &polybft.RewardsConfig{ - TokenAddress: rewardTokenAddr, - WalletAddress: walletPremineInfo.Address, - WalletAmount: walletPremineInfo.Amount, - }, - BlockTimeDrift: p.blockTimeDrift, - BlockTrackerPollInterval: common.Duration{Duration: p.blockTrackerPollInterval}, - ProxyContractsAdmin: types.StringToAddress(p.proxyContractsAdmin), - } - - enabledForks := chain.AllForksEnabled.Copy() - - chainConfig := &chain.Chain{ - Name: p.name, - Params: &chain.Params{ - ChainID: int64(p.chainID), - Forks: enabledForks, - Engine: map[string]interface{}{ - string(server.PolyBFTConsensus): polyBftConfig, - }, - }, - Bootnodes: p.bootnodes, - } - - burnContractAddr := types.ZeroAddress - - if p.isBurnContractEnabled() { - chainConfig.Params.BurnContract = make(map[uint64]types.Address, 1) - - burnContractInfo, err := parseBurnContractInfo(p.burnContract) - if err != nil { - return err - } - - if !p.nativeTokenConfig.IsMintable { - // burn contract can be specified on arbitrary address for non-mintable native tokens - burnContractAddr = burnContractInfo.Address - chainConfig.Params.BurnContract[burnContractInfo.BlockNumber] = burnContractAddr - chainConfig.Params.BurnContractDestinationAddress = burnContractInfo.DestinationAddress - } else { - // burnt funds are sent to zero address when dealing with mintable native tokens - chainConfig.Params.BurnContract[burnContractInfo.BlockNumber] = types.ZeroAddress - } - } - - // deploy genesis contracts - allocs, err := p.deployContracts(rewardTokenByteCode, polyBftConfig, chainConfig, burnContractAddr) - if err != nil { - return err - } - - // premine other accounts - for _, premine := range premineBalances { - // validators have already been premined, so no need to premine them again - if _, ok := allocs[premine.Address]; ok { - continue - } - - allocs[premine.Address] = &chain.GenesisAccount{ - Balance: premine.Amount, - } - } - - validatorMetadata := make([]*validator.ValidatorMetadata, len(initialValidators)) - - for i, validator := range initialValidators { - // create validator metadata instance - metadata, err := validator.ToValidatorMetadata() - if err != nil { - return err - } - - validatorMetadata[i] = metadata - - // set genesis validators as boot nodes if boot nodes not provided via CLI - if len(p.bootnodes) == 0 { - chainConfig.Bootnodes = append(chainConfig.Bootnodes, validator.MultiAddr) - } - } - - genesisExtraData, err := GenerateExtraDataPolyBft(validatorMetadata) - if err != nil { - return err - } - - // populate genesis parameters - chainConfig.Genesis = &chain.Genesis{ - GasLimit: p.blockGasLimit, - Difficulty: 0, - Alloc: allocs, - ExtraData: genesisExtraData, - GasUsed: command.DefaultGenesisGasUsed, - Mixhash: polybft.PolyBFTMixDigest, - } - - if len(p.contractDeployerAllowListAdmin) != 0 { - // only enable allow list if there is at least one address as **admin**, otherwise - // the allow list could never be updated - chainConfig.Params.ContractDeployerAllowList = &chain.AddressListConfig{ - AdminAddresses: stringSliceToAddressSlice(p.contractDeployerAllowListAdmin), - EnabledAddresses: stringSliceToAddressSlice(p.contractDeployerAllowListEnabled), - } - } - - if len(p.contractDeployerBlockListAdmin) != 0 { - // only enable block list if there is at least one address as **admin**, otherwise - // the block list could never be updated - chainConfig.Params.ContractDeployerBlockList = &chain.AddressListConfig{ - AdminAddresses: stringSliceToAddressSlice(p.contractDeployerBlockListAdmin), - EnabledAddresses: stringSliceToAddressSlice(p.contractDeployerBlockListEnabled), - } - } - - if len(p.transactionsAllowListAdmin) != 0 { - // only enable allow list if there is at least one address as **admin**, otherwise - // the allow list could never be updated - chainConfig.Params.TransactionsAllowList = &chain.AddressListConfig{ - AdminAddresses: stringSliceToAddressSlice(p.transactionsAllowListAdmin), - EnabledAddresses: stringSliceToAddressSlice(p.transactionsAllowListEnabled), - } - } - - if len(p.transactionsBlockListAdmin) != 0 { - // only enable block list if there is at least one address as **admin**, otherwise - // the block list could never be updated - chainConfig.Params.TransactionsBlockList = &chain.AddressListConfig{ - AdminAddresses: stringSliceToAddressSlice(p.transactionsBlockListAdmin), - EnabledAddresses: stringSliceToAddressSlice(p.transactionsBlockListEnabled), - } - } - - if len(p.bridgeAllowListAdmin) != 0 { - // only enable allow list if there is at least one address as **admin**, otherwise - // the allow list could never be updated - chainConfig.Params.BridgeAllowList = &chain.AddressListConfig{ - AdminAddresses: stringSliceToAddressSlice(p.bridgeAllowListAdmin), - EnabledAddresses: stringSliceToAddressSlice(p.bridgeAllowListEnabled), - } - } - - if len(p.bridgeBlockListAdmin) != 0 { - // only enable block list if there is at least one address as **admin**, otherwise - // the block list could never be updated - chainConfig.Params.BridgeBlockList = &chain.AddressListConfig{ - AdminAddresses: stringSliceToAddressSlice(p.bridgeBlockListAdmin), - EnabledAddresses: stringSliceToAddressSlice(p.bridgeBlockListEnabled), - } - } - - if p.isBurnContractEnabled() { - // only populate base fee and base fee multiplier values if burn contract(s) - // is provided - chainConfig.Genesis.BaseFee = p.parsedBaseFeeConfig.baseFee - chainConfig.Genesis.BaseFeeEM = p.parsedBaseFeeConfig.baseFeeEM - chainConfig.Genesis.BaseFeeChangeDenom = p.parsedBaseFeeConfig.baseFeeChangeDenom - } - - return helper.WriteGenesisConfigToDisk(chainConfig, params.genesisPath) -} - -func (p *genesisParams) deployContracts( - rewardTokenByteCode []byte, - polybftConfig *polybft.PolyBFTConfig, - chainConfig *chain.Chain, - burnContractAddr types.Address) (map[types.Address]*chain.GenesisAccount, error) { - proxyToImplAddrMap := contracts.GetProxyImplementationMapping() - proxyAddresses := make([]types.Address, 0, len(proxyToImplAddrMap)) - - for proxyAddr := range proxyToImplAddrMap { - proxyAddresses = append(proxyAddresses, proxyAddr) - } - - genesisContracts := []*contractInfo{ - { - // State receiver contract - artifact: contractsapi.StateReceiver, - address: contracts.StateReceiverContractV1, - }, - { - // ChildERC20 token contract - artifact: contractsapi.ChildERC20, - address: contracts.ChildERC20Contract, - }, - { - // ChildERC721 token contract - artifact: contractsapi.ChildERC721, - address: contracts.ChildERC721Contract, - }, - { - // ChildERC1155 contract - artifact: contractsapi.ChildERC1155, - address: contracts.ChildERC1155Contract, - }, - { - // BLS contract - artifact: contractsapi.BLS, - address: contracts.BLSContractV1, - }, - { - // Merkle contract - artifact: contractsapi.Merkle, - address: contracts.MerkleContractV1, - }, - { - // L2StateSender contract - artifact: contractsapi.L2StateSender, - address: contracts.L2StateSenderContractV1, - }, - { - artifact: contractsapi.ValidatorSet, - address: contracts.ValidatorSetContractV1, - }, - { - artifact: contractsapi.RewardPool, - address: contracts.RewardPoolContractV1, - }, - } - - if !params.nativeTokenConfig.IsMintable { - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.NativeERC20, - address: contracts.NativeERC20TokenContractV1, - }) - - // burn contract can be set only for non-mintable native token. If burn contract is set, - // default EIP1559 contract will be deployed. - if p.isBurnContractEnabled() { - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.EIP1559Burn, - address: burnContractAddr, - }) - - proxyAddresses = append(proxyAddresses, contracts.DefaultBurnContract) - } - } else { - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.NativeERC20Mintable, - address: contracts.NativeERC20TokenContractV1, - }) - } - - if len(params.bridgeAllowListAdmin) != 0 || len(params.bridgeBlockListAdmin) != 0 { - // rootchain originated tokens predicates (with access lists) - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.ChildERC20PredicateACL, - address: contracts.ChildERC20PredicateContractV1, - }) - - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.ChildERC721PredicateACL, - address: contracts.ChildERC721PredicateContractV1, - }) - - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.ChildERC1155PredicateACL, - address: contracts.ChildERC1155PredicateContractV1, - }) - - // childchain originated tokens predicates (with access lists) - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.RootMintableERC20PredicateACL, - address: contracts.RootMintableERC20PredicateContractV1, - }) - - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.RootMintableERC721PredicateACL, - address: contracts.RootMintableERC721PredicateContractV1, - }) - - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.RootMintableERC1155PredicateACL, - address: contracts.RootMintableERC1155PredicateContractV1, - }) - } else { - // rootchain originated tokens predicates - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.ChildERC20Predicate, - address: contracts.ChildERC20PredicateContractV1, - }) - - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.ChildERC721Predicate, - address: contracts.ChildERC721PredicateContractV1, - }) - - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.ChildERC1155Predicate, - address: contracts.ChildERC1155PredicateContractV1, - }) - - // childchain originated tokens predicates - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.RootMintableERC20Predicate, - address: contracts.RootMintableERC20PredicateContractV1, - }) - - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.RootMintableERC721Predicate, - address: contracts.RootMintableERC721PredicateContractV1, - }) - - genesisContracts = append(genesisContracts, - &contractInfo{ - artifact: contractsapi.RootMintableERC1155Predicate, - address: contracts.RootMintableERC1155PredicateContractV1, - }) - } - - allocations := make(map[types.Address]*chain.GenesisAccount, len(genesisContracts)+1) - - if rewardTokenByteCode != nil { - // if reward token is provided in genesis then, add it to allocations - // to RewardTokenContract address and update Polybft config - allocations[contracts.RewardTokenContractV1] = &chain.GenesisAccount{ - Balance: big.NewInt(0), - Code: rewardTokenByteCode, - } - - proxyAddresses = append(proxyAddresses, contracts.RewardTokenContract) - } - - genesisContracts = append(genesisContracts, getProxyContractsInfo(proxyAddresses)...) - - for _, contract := range genesisContracts { - allocations[contract.address] = &chain.GenesisAccount{ - Balance: big.NewInt(0), - Code: contract.artifact.DeployedBytecode, - } - } - - return allocations, nil -} - -// getValidatorAccounts gathers validator accounts info either from CLI or from provided local storage -func (p *genesisParams) getValidatorAccounts() ([]*validator.GenesisValidator, error) { - // populate validators premine info - if len(p.validators) > 0 { - validators := make([]*validator.GenesisValidator, len(p.validators)) - for i, val := range p.validators { - parts := strings.Split(val, ":") - if len(parts) != 3 { - return nil, fmt.Errorf("expected 3 parts provided in the following format "+ - ", but got %d part(s)", - len(parts)) - } - - if _, err := multiaddr.NewMultiaddr(parts[0]); err != nil { - return nil, fmt.Errorf("invalid P2P multi address '%s' provided: %w ", parts[0], err) - } - - trimmedAddress := strings.TrimPrefix(parts[1], "0x") - if len(trimmedAddress) != ecdsaAddressLength { - return nil, fmt.Errorf("invalid ECDSA address: %s", parts[1]) - } - - trimmedBLSKey := strings.TrimPrefix(parts[2], "0x") - if len(trimmedBLSKey) != blsKeyLength { - return nil, fmt.Errorf("invalid BLS key: %s", parts[2]) - } - - addr := types.StringToAddress(trimmedAddress) - validators[i] = &validator.GenesisValidator{ - MultiAddr: parts[0], - Address: addr, - BlsKey: trimmedBLSKey, - Stake: big.NewInt(0), - } - } - - return validators, nil - } - - validatorsPath := p.validatorsPath - if validatorsPath == "" { - validatorsPath = path.Dir(p.genesisPath) - } - - validators, err := ReadValidatorsByPrefix(validatorsPath, p.validatorsPrefixPath) - if err != nil { - return nil, err - } - - return validators, nil -} - -func stringSliceToAddressSlice(addrs []string) []types.Address { - res := make([]types.Address, len(addrs)) - for indx, addr := range addrs { - res[indx] = types.StringToAddress(addr) - } - - return res -} - -func getProxyContractsInfo(addresses []types.Address) []*contractInfo { - result := make([]*contractInfo, len(addresses)) - - for i, proxyAddress := range addresses { - result[i] = &contractInfo{ - artifact: contractsapi.GenesisProxy, - address: proxyAddress, - } - } - - return result -} diff --git a/command/genesis/utils.go b/command/genesis/utils.go index b06637f..349b82b 100644 --- a/command/genesis/utils.go +++ b/command/genesis/utils.go @@ -1,26 +1,15 @@ package genesis import ( - "encoding/hex" "errors" "fmt" - "math/big" "os" - "path/filepath" "sort" "strconv" "strings" - "github.com/hashicorp/go-hclog" "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/secrets" - "github.com/xgr-network/xgr-node/secrets/helper" - "github.com/xgr-network/xgr-node/secrets/local" "github.com/xgr-network/xgr-node/types" ) @@ -65,35 +54,8 @@ func verifyGenesisExistence(genesisPath string) *GenesisGenError { return nil } -// parseTrackerStartBlocks parses provided event tracker start blocks configuration. -// It is set in a following format: :. -// In case smart contract address isn't provided in the string, it is assumed its starting block is 0 implicitly. -func parseTrackerStartBlocks(trackerStartBlocksRaw []string) (map[types.Address]uint64, error) { - trackerStartBlocksConfig := make(map[types.Address]uint64, len(trackerStartBlocksRaw)) - - for _, startBlockRaw := range trackerStartBlocksRaw { - delimiterIdx := strings.Index(startBlockRaw, ":") - if delimiterIdx == -1 { - return nil, fmt.Errorf("invalid event tracker start block configuration provided: %s", trackerStartBlocksRaw) - } - - // : - address := types.StringToAddress(startBlockRaw[:delimiterIdx]) - startBlockRaw := startBlockRaw[delimiterIdx+1:] - - startBlock, err := strconv.ParseUint(startBlockRaw, 10, 64) - if err != nil { - return nil, fmt.Errorf("failed to parse provided start block %s: %w", startBlockRaw, err) - } - - trackerStartBlocksConfig[address] = startBlock - } - - return trackerStartBlocksConfig, nil -} - // parseBurnContractInfo parses provided burn contract information and returns burn contract block and address -func parseBurnContractInfo(burnContractInfoRaw string) (*polybft.BurnContractInfo, error) { +func parseBurnContractInfo(burnContractInfoRaw string) (*burnContractInfo, error) { // :
[:] burnContractParts := strings.Split(burnContractInfoRaw, ":") if len(burnContractParts) < 2 || len(burnContractParts) > 3 { @@ -113,7 +75,7 @@ func parseBurnContractInfo(burnContractInfoRaw string) (*polybft.BurnContractInf } if len(burnContractParts) == 2 { - return &polybft.BurnContractInfo{ + return &burnContractInfo{ BlockNumber: blockNum, Address: types.StringToAddress(contractAddress), DestinationAddress: types.ZeroAddress, @@ -125,7 +87,7 @@ func parseBurnContractInfo(burnContractInfoRaw string) (*polybft.BurnContractInf return nil, fmt.Errorf("failed to parse burn destination address %s: %w", destinationAddress, err) } - return &polybft.BurnContractInfo{ + return &burnContractInfo{ BlockNumber: blockNum, Address: types.StringToAddress(contractAddress), DestinationAddress: types.StringToAddress(destinationAddress), @@ -218,68 +180,8 @@ func GetValidatorKeyFiles(rootDir, filePrefix string) ([]string, error) { return fileNames, nil } -// ReadValidatorsByPrefix reads validators secrets on a given root directory and with given folder prefix -func ReadValidatorsByPrefix(dir, prefix string) ([]*validator.GenesisValidator, error) { - validatorKeyFiles, err := GetValidatorKeyFiles(dir, prefix) - if err != nil { - return nil, err - } - - validators := make([]*validator.GenesisValidator, len(validatorKeyFiles)) - - for i, file := range validatorKeyFiles { - path := filepath.Join(dir, file) - - account, nodeID, err := getSecrets(path) - if err != nil { - return nil, err - } - - validators[i] = &validator.GenesisValidator{ - Address: types.Address(account.Ecdsa.Address()), - BlsKey: hex.EncodeToString(account.Bls.PublicKey().Marshal()), - MultiAddr: fmt.Sprintf("/ip4/%s/tcp/%d/p2p/%s", "127.0.0.1", bootnodePortStart+int64(i), nodeID), - Stake: big.NewInt(0), - } - } - - return validators, nil -} - -func getSecrets(directory string) (*wallet.Account, string, error) { - baseConfig := &secrets.SecretsManagerParams{ - Logger: hclog.NewNullLogger(), - Extra: map[string]interface{}{ - secrets.Path: directory, - }, - } - - localManager, err := local.SecretsManagerFactory(nil, baseConfig) - if err != nil { - return nil, "", fmt.Errorf("unable to instantiate local secrets manager, %w", err) - } - - nodeID, err := helper.LoadNodeID(localManager) - if err != nil { - return nil, "", err - } - - account, err := wallet.NewAccountFromSecret(localManager) - if err != nil { - return nil, "", err - } - - return account, nodeID, err -} - -// GenerateExtraDataPolyBft populates Extra with specific fields required for polybft consensus protocol -func GenerateExtraDataPolyBft(validators []*validator.ValidatorMetadata) ([]byte, error) { - delta := &validator.ValidatorSetDelta{ - Added: validators, - Removed: bitmap.Bitmap{}, - } - - extra := polybft.Extra{Validators: delta, Checkpoint: &polybft.CheckpointData{}} - - return extra.MarshalRLPTo(nil), nil +type burnContractInfo struct { + BlockNumber uint64 + Address types.Address + DestinationAddress types.Address } diff --git a/command/ibft/helper/account.go b/command/ibft/helper/account.go new file mode 100644 index 0000000..116ff00 --- /dev/null +++ b/command/ibft/helper/account.go @@ -0,0 +1,28 @@ +package helper + +import ( + "encoding/hex" + "fmt" + + ethgowallet "github.com/umbracle/ethgo/wallet" + "github.com/xgr-network/xgr-node/secrets" +) + +func GetECDSAKeyFromSecret(secretsManager secrets.SecretsManager) (*ethgowallet.Key, error) { + encodedKey, err := secretsManager.GetSecret(secrets.ValidatorKey) + if err != nil { + return nil, fmt.Errorf("failed to retrieve ecdsa key: %w", err) + } + + ecdsaRaw, err := hex.DecodeString(string(encodedKey)) + if err != nil { + return nil, fmt.Errorf("failed to retrieve ecdsa key: %w", err) + } + + key, err := ethgowallet.NewWalletFromPrivKey(ecdsaRaw) + if err != nil { + return nil, fmt.Errorf("failed to retrieve ecdsa key: %w", err) + } + + return key, nil +} diff --git a/command/ibft/ibft.go b/command/ibft/ibft.go index 0605c89..7db0934 100644 --- a/command/ibft/ibft.go +++ b/command/ibft/ibft.go @@ -4,11 +4,18 @@ import ( "github.com/spf13/cobra" "github.com/xgr-network/xgr-node/command/helper" "github.com/xgr-network/xgr-node/command/ibft/candidates" + "github.com/xgr-network/xgr-node/command/ibft/join" + "github.com/xgr-network/xgr-node/command/ibft/poolconfig" "github.com/xgr-network/xgr-node/command/ibft/propose" "github.com/xgr-network/xgr-node/command/ibft/quorum" + "github.com/xgr-network/xgr-node/command/ibft/setactive" "github.com/xgr-network/xgr-node/command/ibft/snapshot" + "github.com/xgr-network/xgr-node/command/ibft/stake" "github.com/xgr-network/xgr-node/command/ibft/status" _switch "github.com/xgr-network/xgr-node/command/ibft/switch" + "github.com/xgr-network/xgr-node/command/ibft/unstake" + "github.com/xgr-network/xgr-node/command/ibft/validators" + "github.com/xgr-network/xgr-node/command/ibft/withdraw" ) func GetCommand() *cobra.Command { @@ -38,5 +45,15 @@ func registerSubcommands(baseCmd *cobra.Command) { _switch.GetCommand(), // ibft quorum quorum.GetCommand(), + // ibft join (PoS validator onboarding) + join.GetCommand(), + poolconfig.GetCommand(), + // ibft stake / unstake / withdraw / set-active + stake.GetCommand(), + unstake.GetCommand(), + withdraw.GetCommand(), + setactive.GetCommand(), + // ibft validators + validators.GetCommand(), ) } diff --git a/command/ibft/join/README.md b/command/ibft/join/README.md new file mode 100644 index 0000000..430eb1e --- /dev/null +++ b/command/ibft/join/README.md @@ -0,0 +1,26 @@ +# ibft join + +One-command validator onboarding for PoS networks using the predeployed staking contract at `0x1001`. + +What it does: +- loads (or generates) ECDSA/BLS keys from the secrets manager (DataDir or cloud config) +- registers the BLS public key onchain if not already registered +- stakes the required amount (by sending `stake()` with native value) + +Example (local dev): + +``` +xgrchain ibft join \ + --jsonrpc http://127.0.0.1:8545 \ + --data-dir ./validator1 \ + --stake 200000 +``` + +Example (remote chain node): + +``` +xgrchain ibft join \ + --jsonrpc http://:8545 \ + --data-dir ./data \ + --stake 1000000 +``` diff --git a/command/ibft/join/join.go b/command/ibft/join/join.go new file mode 100644 index 0000000..345d782 --- /dev/null +++ b/command/ibft/join/join.go @@ -0,0 +1,579 @@ +package join + +import ( + "bytes" + "encoding/hex" + "fmt" + "math/big" + "net/url" + "reflect" + "strings" + "time" + + "github.com/hashicorp/go-hclog" + "github.com/spf13/cobra" + "github.com/umbracle/ethgo" + ethgowallet "github.com/umbracle/ethgo/wallet" + + "github.com/xgr-network/xgr-node/command" + "github.com/xgr-network/xgr-node/command/helper" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/secrets" + secretsHelper "github.com/xgr-network/xgr-node/secrets/helper" + "github.com/xgr-network/xgr-node/secrets/local" + "github.com/xgr-network/xgr-node/txrelayer" + "github.com/xgr-network/xgr-node/types" +) + +const ( + flagDataDir = "data-dir" + flagConfig = "config" + flagInitKeys = "init-keys" + flagInitOnly = "init-only" + flagStakeXGR = "stake" + flagDecimals = "decimals" + + defaultStakeXGR = "200000" + defaultDecimals = 18 +) + +type params struct { + jsonRPC string + dataDir string + config string + initKeys bool + initOnly bool + stakeStr string + decimals int +} + +var p params + +func GetCommand() *cobra.Command { + cmd := &cobra.Command{ + Use: "join", + Short: "One-shot PoS validator join: ensure keys, register BLS pubkey, stake required amount", + Example: ` # Local validator + xgrchain ibft join --jsonrpc http://127.0.0.1:8545 --data-dir ./data --stake 1000000 + + # Remote chain node + xgrchain ibft join --jsonrpc http://:8545 --data-dir ./data --stake 1000000`, + PreRunE: func(cmd *cobra.Command, _ []string) error { + p.jsonRPC = helper.GetJSONRPCAddress(cmd) + if p.jsonRPC == "" { + return fmt.Errorf("missing --jsonrpc") + } + + p.jsonRPC = normalizeJSONRPCAddress(p.jsonRPC) + if p.dataDir == "" && p.config == "" { + return fmt.Errorf("either --%s or --%s must be provided", flagDataDir, flagConfig) + } + if p.decimals < 0 || p.decimals > 30 { + return fmt.Errorf("invalid --%s", flagDecimals) + } + if _, ok := new(big.Int).SetString(p.stakeStr, 10); !ok { + return fmt.Errorf("invalid --%s (must be integer, in XGR units): %s", flagStakeXGR, p.stakeStr) + } + return nil + }, + RunE: run, + } + + cmd.Flags().StringVar(&p.jsonRPC, "jsonrpc", "http://127.0.0.1:8545", "JSON-RPC endpoint") + + cmd.Flags().StringVar(&p.dataDir, flagDataDir, "", "data dir for local secrets manager (validator keys)") + cmd.Flags().StringVar(&p.config, flagConfig, "", "secrets manager config (cloud)") + cmd.Flags().BoolVar(&p.initKeys, flagInitKeys, true, "auto-generate missing ECDSA/BLS keys into secrets manager") + cmd.Flags().BoolVar(&p.initOnly, flagInitOnly, false, "only generate keys and print the validator address (no onchain tx)") + cmd.Flags().StringVar(&p.stakeStr, flagStakeXGR, defaultStakeXGR, "stake amount in XGR (integer units, default 200,000)") + cmd.Flags().IntVar(&p.decimals, flagDecimals, defaultDecimals, "native decimals for XGR (default 18)") + + cmd.MarkFlagsMutuallyExclusive(flagDataDir, flagConfig) + return cmd +} + +func run(cmd *cobra.Command, _ []string) error { + outputter := command.InitializeOutputter(cmd) + defer outputter.WriteOutput() + + // 1) secrets manager + sm, err := initSecretsManager() + if err != nil { + outputter.SetError(err) + return nil + } + + // 2) ensure keys exist (optional) + if p.initKeys { + if err := ensureKeys(sm); err != nil { + outputter.SetError(err) + return nil + } + } + + // 3) load ECDSA + BLS pubkey from secrets + ecdsaKey, blsPub, err := loadKeysFromSecrets(sm) + if err != nil { + outputter.SetError(err) + return nil + } + valAddr := types.Address(ecdsaKey.Address()) + + // INIT-ONLY: print address + pubkey and exit. + if p.initOnly { + outputter.SetCommandResult(&JoinResult{ + Validator: valAddr.String(), + JoinedAtBlock: 0, + BLSRegistered: false, + StakeWei: stakeToWei(p.stakeStr, p.decimals).String(), + AccountStakeWei: "0", + Eligible: false, + Note: "Keys generated. Fund this address (gas + stake) and rerun without --init-only.", + }) + return nil + } + + // 4) relayer + relayer, err := txrelayer.NewTxRelayer( + txrelayer.WithIPAddress(p.jsonRPC), + txrelayer.WithReceiptTimeout(250*time.Millisecond), + ) + if err != nil { + outputter.SetError(err) + return nil + } + + // 5) validate requested stake against validator self-stake minimum + requiredStakeWei := stakeToWei(p.stakeStr, p.decimals) + thresholdWei, err := queryValidatorMinSelfStake(relayer) + if err != nil { + outputter.SetError(fmt.Errorf("failed to query VALIDATOR_MIN_SELF_STAKE: %w", err)) + return nil + } + if requiredStakeWei.Cmp(thresholdWei) < 0 { + outputter.SetError(fmt.Errorf("requested --%s=%s is below validator self-stake minimum (%s XGR)", flagStakeXGR, p.stakeStr, weiToXGRString(thresholdWei, p.decimals))) + return nil + } + + // 6) check current onchain state + onchainStake, err := queryAccountStake(relayer, valAddr) + if err != nil { + outputter.SetError(fmt.Errorf("failed to query accountStake: %w", err)) + return nil + } + + alreadyRegistered, err := isBLSRegistered(relayer, valAddr, blsPub) + if err != nil { + outputter.SetError(fmt.Errorf("failed to query validator list/pubkeys: %w", err)) + return nil + } + + // 7) stake if needed (must happen before registerBLSPublicKey for new validators) + if onchainStake.Cmp(requiredStakeWei) < 0 { + stakeDeltaWei := new(big.Int).Sub(requiredStakeWei, onchainStake) + + balanceWei, balErr := relayer.Client().Eth().GetBalance(ecdsaKey.Address(), ethgo.Latest) + if balErr != nil { + outputter.SetError(fmt.Errorf("failed to query account balance: %w", balErr)) + return nil + } + if balanceWei.Cmp(stakeDeltaWei) < 0 { + outputter.SetError(fmt.Errorf( + "insufficient balance for staking value: need %s wei (%s XGR), have %s wei (%s XGR); fund validator address %s", + stakeDeltaWei.String(), weiToXGRString(stakeDeltaWei, p.decimals), + balanceWei.String(), weiToXGRString(balanceWei, p.decimals), + valAddr.String(), + )) + return nil + } + + if err := sendStake(relayer, ecdsaKey, stakeDeltaWei); err != nil { + outputter.SetError(err) + return nil + } + onchainStake = new(big.Int).Add(onchainStake, stakeDeltaWei) + } + + // 8) register BLS pubkey if needed + if !alreadyRegistered { + if err := sendRegisterBLS(relayer, ecdsaKey, blsPub); err != nil { + outputter.SetError(err) + return nil + } + } + + // 9) done + joinedAt, _ := queryJoinedAtBlock(relayer, valAddr) + outputter.SetCommandResult(&JoinResult{ + Validator: valAddr.String(), + JoinedAtBlock: joinedAt, + BLSRegistered: true, + StakeWei: requiredStakeWei.String(), + AccountStakeWei: onchainStake.String(), + Eligible: true, + Note: "Join requires >=200k self stake and becomes effective in next epoch. Eligibility in fetcher still additionally requires >=2M effective total support stake.", + }) + + return nil +} + +func normalizeJSONRPCAddress(raw string) string { + parsed, err := url.Parse(raw) + if err != nil { + return raw + } + + if parsed.Hostname() != "0.0.0.0" { + return raw + } + + port := parsed.Port() + if port == "" { + return raw + } + + parsed.Host = "127.0.0.1:" + port + + return parsed.String() +} + +func initSecretsManager() (secrets.SecretsManager, error) { + if p.config != "" { + cfg, err := secrets.ReadConfig(p.config) + if err != nil { + return nil, err + } + return secretsHelper.InitCloudSecretsManager(cfg) + } + + // local FS secrets manager + baseConfig := &secrets.SecretsManagerParams{ + Logger: hclog.NewNullLogger(), + Extra: map[string]interface{}{ + secrets.Path: p.dataDir, + }, + } + + return local.SecretsManagerFactory(nil, baseConfig) +} + +func ensureKeys(sm secrets.SecretsManager) error { + // ECDSA validator key + if !sm.HasSecret(secrets.ValidatorKey) { + if _, err := secretsHelper.InitECDSAValidatorKey(sm); err != nil { + return err + } + } + // BLS validator key + if !sm.HasSecret(secrets.ValidatorBLSKey) { + if _, err := secretsHelper.InitBLSValidatorKey(sm); err != nil { + return err + } + } + return nil +} + +func loadKeysFromSecrets(sm secrets.SecretsManager) (*ethgowallet.Key, []byte, error) { + ecdsaRaw, err := sm.GetSecret(secrets.ValidatorKey) + if err != nil { + return nil, nil, fmt.Errorf("failed to load validator ecdsa key: %w", err) + } + ecdsaPriv, err := crypto.BytesToECDSAPrivateKey(ecdsaRaw) + if err != nil { + return nil, nil, fmt.Errorf("failed to parse validator ecdsa key: %w", err) + } + ecdsaKey := ethgowallet.NewKey(ecdsaPriv) + + blsRaw, err := sm.GetSecret(secrets.ValidatorBLSKey) + if err != nil { + return nil, nil, fmt.Errorf("failed to load validator bls key: %w", err) + } + blsKey, err := crypto.BytesToBLSSecretKey(blsRaw) + if err != nil { + return nil, nil, fmt.Errorf("failed to parse validator bls key: %w", err) + } + blsPub, err := crypto.BLSSecretKeyToPubkeyBytes(blsKey) + if err != nil { + return nil, nil, fmt.Errorf("failed to derive validator bls pubkey: %w", err) + } + + return ecdsaKey, blsPub, nil +} + +func weiToXGRString(wei *big.Int, decimals int) string { + if wei == nil { + return "0" + } + base := new(big.Int).Exp(big.NewInt(10), big.NewInt(int64(decimals)), nil) + q := new(big.Int) + r := new(big.Int) + q.QuoRem(wei, base, r) + if r.Sign() == 0 { + return q.String() + } + + frac := r.Text(10) + if len(frac) < decimals { + frac = strings.Repeat("0", decimals-len(frac)) + frac + } + frac = strings.TrimRight(frac, "0") + + return q.String() + "." + frac +} + +func stakeToWei(amountStr string, decimals int) *big.Int { + a, _ := new(big.Int).SetString(amountStr, 10) + m := new(big.Int).Exp(big.NewInt(10), big.NewInt(int64(decimals)), nil) + return new(big.Int).Mul(a, m) +} + +func queryAccountStake(relayer txrelayer.TxRelayer, addr types.Address) (*big.Int, error) { + method := abis.StakingABI.Methods["accountStake"] + if method == nil { + return nil, fmt.Errorf("staking ABI missing accountStake") + } + inp, err := method.Inputs.Encode(map[string]interface{}{ + "account": ethgo.Address(addr), + }) + if err != nil { + return nil, err + } + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), append(method.ID(), inp...)) + if err != nil { + return nil, err + } + b, err := hexToBytes(resp) + if err != nil { + return nil, err + } + decoded, err := method.Outputs.Decode(b) + if err != nil { + return nil, err + } + m, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode accountStake: unexpected type") + } + v, ok := m["0"].(*big.Int) + if !ok { + return nil, fmt.Errorf("decode accountStake: missing value") + } + return v, nil +} + +func queryJoinedAtBlock(relayer txrelayer.TxRelayer, addr types.Address) (uint64, error) { + selector := crypto.Keccak256([]byte("joinedAtBlock(address)"))[:4] + input := make([]byte, 4+32) + copy(input[:4], selector) + copy(input[4+12:], addr.Bytes()) + + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), input) + if err != nil { + return 0, err + } + b, err := hexToBytes(resp) + if err != nil { + return 0, err + } + if len(b) == 0 { + return 0, nil + } + + return new(big.Int).SetBytes(b).Uint64(), nil +} + +func queryValidatorMinSelfStake(relayer txrelayer.TxRelayer) (*big.Int, error) { + method := abis.StakingABI.Methods["VALIDATOR_MIN_SELF_STAKE"] + if method == nil { + return nil, fmt.Errorf("staking ABI missing VALIDATOR_MIN_SELF_STAKE") + } + + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), method.ID()) + if err != nil { + return nil, err + } + + b, err := hexToBytes(resp) + if err != nil { + return nil, err + } + + decoded, err := method.Outputs.Decode(b) + if err != nil { + return nil, err + } + mp, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode VALIDATOR_MIN_SELF_STAKE: unexpected type") + } + v, ok := mp["0"].(*big.Int) + if !ok { + return nil, fmt.Errorf("decode VALIDATOR_MIN_SELF_STAKE: missing value") + } + + return v, nil +} + +func isBLSRegistered(relayer txrelayer.TxRelayer, addr types.Address, pub []byte) (bool, error) { + mInfo := abis.StakingABI.Methods["validatorInfo"] + if mInfo == nil { + return false, fmt.Errorf("staking ABI missing validatorInfo") + } + + inp, err := mInfo.Inputs.Encode(map[string]interface{}{"account": ethgo.Address(addr)}) + if err != nil { + return false, err + } + + rawInfo, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), append(mInfo.ID(), inp...)) + if err != nil { + return false, err + } + + infoBytes, err := hexToBytes(rawInfo) + if err != nil { + return false, err + } + + decoded, err := mInfo.Outputs.Decode(infoBytes) + if err != nil { + return false, err + } + + mp, ok := decoded.(map[string]interface{}) + if !ok { + return false, fmt.Errorf("decode validatorInfo: unexpected type") + } + + blsRaw, ok := mp["blsPubKey"] + if !ok { + blsRaw = mp["4"] + } + + chainPub, err := toBytes(blsRaw) + if err != nil { + return false, fmt.Errorf("decode validatorInfo blsPubKey: %w", err) + } + + return bytes.Equal(chainPub, pub), nil +} + +func toBytes(raw interface{}) ([]byte, error) { + switch v := raw.(type) { + case []byte: + return v, nil + case string: + b, err := hexToBytes(v) + if err != nil { + return nil, fmt.Errorf("invalid hex value") + } + + return b, nil + } + + rv := reflect.ValueOf(raw) + if !rv.IsValid() { + return nil, fmt.Errorf("unexpected item type") + } + + kind := rv.Kind() + if kind == reflect.Array || kind == reflect.Slice { + if rv.Type().Elem().Kind() == reflect.Uint8 { + b := make([]byte, rv.Len()) + for i := 0; i < rv.Len(); i++ { + b[i] = byte(rv.Index(i).Uint()) + } + + return b, nil + } + } + + return nil, fmt.Errorf("unexpected item type") +} + +func methodSelector(signature string) []byte { + return crypto.Keccak256([]byte(signature))[:4] +} + +func ensureMethodSelector(methodName, signature string, id []byte) error { + expected := methodSelector(signature) + if !bytes.Equal(id, expected) { + return fmt.Errorf("staking ABI selector mismatch for %s: got 0x%s expected 0x%s", methodName, hex.EncodeToString(id), hex.EncodeToString(expected)) + } + + return nil +} + +func sendRegisterBLS(relayer txrelayer.TxRelayer, key ethgo.Key, pub []byte) error { + m := abis.StakingABI.Methods["registerBLSPublicKey"] + if m == nil { + return fmt.Errorf("staking ABI missing registerBLSPublicKey") + } + if err := ensureMethodSelector("registerBLSPublicKey", "registerBLSPublicKey(bytes)", m.ID()); err != nil { + return err + } + inp, err := m.Inputs.Encode(map[string]interface{}{ + "blsPubKey": pub, + }) + if err != nil { + return err + } + to := ethgo.Address(staking.AddrStakingContract) + tx := ðgo.Transaction{ + To: &to, + Input: append(m.ID(), inp...), + Type: ethgo.TransactionDynamicFee, + } + receipt, err := relayer.SendTransaction(tx, key) + if err != nil { + return fmt.Errorf("registerBLSPublicKey tx failed: %w", err) + } + if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { + return fmt.Errorf("registerBLSPublicKey reverted") + } + return nil +} + +func sendStake(relayer txrelayer.TxRelayer, key ethgo.Key, stakeWei *big.Int) error { + m := abis.StakingABI.Methods["stake"] + if m == nil { + return fmt.Errorf("staking ABI missing stake") + } + if err := ensureMethodSelector("stake", "stake()", m.ID()); err != nil { + return err + } + to := ethgo.Address(staking.AddrStakingContract) + tx := ðgo.Transaction{ + To: &to, + Input: m.ID(), + Value: stakeWei, + Type: ethgo.TransactionDynamicFee, + } + receipt, err := relayer.SendTransaction(tx, key) + if err != nil { + return fmt.Errorf("stake tx failed: %w", err) + } + if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { + return fmt.Errorf("stake reverted") + } + return nil +} + +// compile-time sanity: ensure we pull in crypto package (kept for future signature checks) +var _ = crypto.Keccak256 + +func hexToBytes(s string) ([]byte, error) { + s = strings.TrimSpace(s) + if s == "" || s == "0x" { + return []byte{}, nil + } + if strings.HasPrefix(s, "0x") || strings.HasPrefix(s, "0X") { + s = s[2:] + } + if len(s)%2 == 1 { + s = "0" + s + } + return hex.DecodeString(s) +} diff --git a/command/ibft/join/join_command_test.go b/command/ibft/join/join_command_test.go new file mode 100644 index 0000000..bec417e --- /dev/null +++ b/command/ibft/join/join_command_test.go @@ -0,0 +1,43 @@ +package join + +import ( + "testing" + + "github.com/stretchr/testify/require" +) + +func TestGetCommand_DefaultStakeMatchesValidatorMinSelfStakeSemantics(t *testing.T) { + cmd := GetCommand() + + flag := cmd.Flags().Lookup(flagStakeXGR) + require.NotNil(t, flag) + require.Equal(t, "200000", flag.DefValue) + require.Contains(t, flag.Usage, "default 200,000") +} + +func TestGetCommand_StakeValidationRejectsNonInteger(t *testing.T) { + cmd := GetCommand() + require.NoError(t, cmd.Flags().Set("jsonrpc", "http://127.0.0.1:8545")) + require.NoError(t, cmd.Flags().Set(flagDataDir, "/tmp/data")) + require.NoError(t, cmd.Flags().Set(flagStakeXGR, "200000.5")) + + err := cmd.PreRunE(cmd, nil) + require.Error(t, err) + require.ErrorContains(t, err, "invalid --stake") +} + +func TestJoinResult_OutputExplicitlyMentionsTwoStageEligibility(t *testing.T) { + res := (&JoinResult{ + Validator: "0x1", + JoinedAtBlock: 123, + BLSRegistered: true, + StakeWei: "200000000000000000000000", + AccountStakeWei: "200000000000000000000000", + Eligible: true, // current CLI behavior: true after successful join flow + Note: "Join requires >=200k self stake and becomes effective in next epoch. Eligibility in fetcher still additionally requires >=2M effective total support stake.", + }).GetOutput() + + require.Contains(t, res, "Eligible = true") + require.Contains(t, res, ">=200k self stake") + require.Contains(t, res, ">=2M effective total support stake") +} diff --git a/command/ibft/join/join_decode_test.go b/command/ibft/join/join_decode_test.go new file mode 100644 index 0000000..0f06bcd --- /dev/null +++ b/command/ibft/join/join_decode_test.go @@ -0,0 +1,97 @@ +package join + +import ( + "math/big" + "reflect" + "testing" +) + +func TestToBytes(t *testing.T) { + t.Parallel() + + tests := []struct { + name string + raw interface{} + want []byte + wantErr bool + }{ + {name: "native bytes", raw: []byte{0x01, 0x02}, want: []byte{0x01, 0x02}}, + {name: "hex string", raw: "0x0102", want: []byte{0x01, 0x02}}, + {name: "fixed byte array", raw: [2]byte{0x01, 0x02}, want: []byte{0x01, 0x02}}, + {name: "unexpected type", raw: 123, wantErr: true}, + } + + for _, tt := range tests { + tt := tt + t.Run(tt.name, func(t *testing.T) { + t.Parallel() + got, err := toBytes(tt.raw) + if tt.wantErr { + if err == nil { + t.Fatalf("expected error") + } + return + } + if err != nil { + t.Fatalf("toBytes() error = %v", err) + } + if !reflect.DeepEqual(got, tt.want) { + t.Fatalf("toBytes() = %v, want %v", got, tt.want) + } + }) + } +} + +func TestNormalizeJSONRPCAddress(t *testing.T) { + t.Parallel() + + tests := []struct { + name string + in string + out string + }{ + {name: "rewrites all interfaces host", in: "http://0.0.0.0:8545", out: "http://127.0.0.1:8545"}, + {name: "keeps localhost", in: "http://127.0.0.1:8545", out: "http://127.0.0.1:8545"}, + {name: "keeps domain", in: "https://rpc.example.org:443", out: "https://rpc.example.org:443"}, + {name: "keeps invalid url", in: ":://broken", out: ":://broken"}, + } + + for _, tt := range tests { + tt := tt + t.Run(tt.name, func(t *testing.T) { + t.Parallel() + if got := normalizeJSONRPCAddress(tt.in); got != tt.out { + t.Fatalf("normalizeJSONRPCAddress() = %q, want %q", got, tt.out) + } + }) + } +} + +func TestWeiToXGRString(t *testing.T) { + t.Parallel() + + tests := []struct { + name string + wei string + dec int + want string + }{ + {name: "whole", wei: "2000000000000000000000000", dec: 18, want: "2000000"}, + {name: "fraction", wei: "1500000000000000000", dec: 18, want: "1.5"}, + {name: "small", wei: "1", dec: 18, want: "0.000000000000000001"}, + } + + for _, tt := range tests { + tt := tt + t.Run(tt.name, func(t *testing.T) { + t.Parallel() + v, ok := new(big.Int).SetString(tt.wei, 10) + if !ok { + t.Fatalf("invalid test wei") + } + if got := weiToXGRString(v, tt.dec); got != tt.want { + t.Fatalf("weiToXGRString() = %q, want %q", got, tt.want) + } + }) + } +} diff --git a/command/ibft/join/join_selector_test.go b/command/ibft/join/join_selector_test.go new file mode 100644 index 0000000..db4efb3 --- /dev/null +++ b/command/ibft/join/join_selector_test.go @@ -0,0 +1,18 @@ +package join + +import ( + "testing" + + "github.com/stretchr/testify/require" +) + +func TestEnsureMethodSelector_Ok(t *testing.T) { + err := ensureMethodSelector("stake", "stake()", methodSelector("stake()")) + require.NoError(t, err) +} + +func TestEnsureMethodSelector_Mismatch(t *testing.T) { + err := ensureMethodSelector("stake", "stake()", methodSelector("stake(uint256)")) + require.Error(t, err) + require.ErrorContains(t, err, "selector mismatch") +} diff --git a/command/ibft/join/result.go b/command/ibft/join/result.go new file mode 100644 index 0000000..bc061d6 --- /dev/null +++ b/command/ibft/join/result.go @@ -0,0 +1,33 @@ +package join + +import ( + "bytes" + "fmt" + + "github.com/xgr-network/xgr-node/command/helper" +) + +type JoinResult struct { + Validator string `json:"validator"` + JoinedAtBlock uint64 `json:"joinedAtBlock,omitempty"` + BLSRegistered bool `json:"blsRegistered"` + StakeWei string `json:"stakeWei"` + AccountStakeWei string `json:"accountStakeWei"` + Eligible bool `json:"eligible"` + Note string `json:"note"` +} + +func (r *JoinResult) GetOutput() string { + var b bytes.Buffer + b.WriteString("\n[IBFT JOIN]\n") + b.WriteString(helper.FormatKV([]string{ + fmt.Sprintf("Validator|%s", r.Validator), + fmt.Sprintf("Joined at block|%d", r.JoinedAtBlock), + fmt.Sprintf("BLS registered|%t", r.BLSRegistered), + fmt.Sprintf("Required stake (wei)|%s", r.StakeWei), + fmt.Sprintf("Account stake (wei)|%s", r.AccountStakeWei), + fmt.Sprintf("Eligible|%t", r.Eligible), + fmt.Sprintf("Note|%s", r.Note), + })) + return b.String() +} diff --git a/command/ibft/poolconfig/pool_config.go b/command/ibft/poolconfig/pool_config.go new file mode 100644 index 0000000..d18f7bc --- /dev/null +++ b/command/ibft/poolconfig/pool_config.go @@ -0,0 +1,241 @@ +package poolconfig + +import ( + "encoding/hex" + "fmt" + "math/big" + "strings" + "time" + + "github.com/hashicorp/go-hclog" + "github.com/spf13/cobra" + "github.com/umbracle/ethgo" + + "github.com/xgr-network/xgr-node/command" + ibftHelper "github.com/xgr-network/xgr-node/command/ibft/helper" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + secretsHelper "github.com/xgr-network/xgr-node/helper/secrets" + "github.com/xgr-network/xgr-node/secrets" + "github.com/xgr-network/xgr-node/secrets/local" + "github.com/xgr-network/xgr-node/txrelayer" + "github.com/xgr-network/xgr-node/types" +) + +type params struct { + jsonRPC string + config string + dataDir string + initKeys bool + enabled bool + maxTotalDelegatedXGR string + minDelegatorXGR string + commissionBps uint64 +} + +func GetCommand() *cobra.Command { + p := ¶ms{} + + cmd := &cobra.Command{ + Use: "pool-config", + Short: "Configure validator delegation pool parameters via JSON-RPC", + Long: "Updates validator pool configuration by submitting a transaction over the configured JSON-RPC endpoint.", + RunE: func(cmd *cobra.Command, _ []string) error { + outputter := command.InitializeOutputter(cmd) + defer outputter.WriteOutput() + + if err := validateCLIParams(p); err != nil { + _ = cmd.Help() + outputter.SetError(err) + return nil + } + + sm, err := initSecretsManager(p) + if err != nil { + outputter.SetError(err) + return nil + } + if p.initKeys { + if err := ensureECDSAKey(sm); err != nil { + outputter.SetError(err) + return nil + } + } + + key, err := ibftHelper.GetECDSAKeyFromSecret(sm) + if err != nil { + outputter.SetError(err) + return nil + } + + maxTotalDelegatedWei, ok := new(big.Int).SetString(p.maxTotalDelegatedXGR, 10) + if !ok { + outputter.SetError(fmt.Errorf("invalid --max-total-delegated")) + return nil + } + maxTotalDelegatedWei.Mul(maxTotalDelegatedWei, new(big.Int).Exp(big.NewInt(10), big.NewInt(18), nil)) + if p.enabled && maxTotalDelegatedWei.Sign() <= 0 { + outputter.SetError(fmt.Errorf("--max-total-delegated must be > 0 when --enabled=true")) + return nil + } + + relayer, err := txrelayer.NewTxRelayer( + txrelayer.WithIPAddress(p.jsonRPC), + txrelayer.WithReceiptTimeout(250*time.Millisecond), + ) + if err != nil { + outputter.SetError(err) + return nil + } + + validatorAddr := types.Address(key.Address()) + if err := ensureJoinedSelfValidator(relayer, validatorAddr); err != nil { + outputter.SetError(fmt.Errorf("%w (wallet=%s, jsonrpc=%s)", err, validatorAddr.String(), p.jsonRPC)) + return nil + } + + minDelegatorWei, ok := new(big.Int).SetString(p.minDelegatorXGR, 10) + if !ok { + outputter.SetError(fmt.Errorf("invalid --min-delegator-stake")) + return nil + } + minDelegatorWei.Mul(minDelegatorWei, new(big.Int).Exp(big.NewInt(10), big.NewInt(18), nil)) + + if err := sendPoolConfigTx(relayer, key, p.enabled, maxTotalDelegatedWei, minDelegatorWei, p.commissionBps, p.jsonRPC); err != nil { + outputter.SetError(err) + return nil + } + + outputter.SetCommandResult(&Result{Validator: validatorAddr.String(), Enabled: p.enabled, MaxTotalDelegatedWei: maxTotalDelegatedWei.String(), MinDelegatorWei: minDelegatorWei.String(), CommissionBps: p.commissionBps}) + return nil + }, + } + + cmd.Flags().StringVar(&p.jsonRPC, "jsonrpc", "http://127.0.0.1:8545", "JSON-RPC endpoint") + cmd.Flags().StringVar(&p.dataDir, "data-dir", "", "Data directory for local secrets") + cmd.Flags().StringVar(&p.config, "config", "", "SecretsManager config file (optional)") + cmd.Flags().BoolVar(&p.initKeys, "init-keys", false, "Generate missing ECDSA key in data-dir/config") + cmd.Flags().BoolVar(&p.enabled, "enabled", true, "Enable or disable delegation pool") + cmd.Flags().StringVar(&p.maxTotalDelegatedXGR, "max-total-delegated", "0", "maximum total delegated stake accepted by this validator pool") + cmd.Flags().StringVar(&p.minDelegatorXGR, "min-delegator-stake", "0", "minimum stake required per delegator; 0 uses global DELEGATOR_MIN_STAKE") + cmd.Flags().Uint64Var(&p.commissionBps, "commission-bps", 0, "Validator commission in basis points") + + return cmd +} + +func validateCLIParams(p *params) error { + if p.dataDir == "" && p.config == "" { + return fmt.Errorf("either --data-dir or --config must be provided") + } + + return nil +} + +func sendPoolConfigTx(relayer txrelayer.TxRelayer, key ethgo.Key, enabled bool, maxTotalDelegatedWei *big.Int, minDelegatorWei *big.Int, commissionBps uint64, jsonRPC string) error { + if commissionBps > 10000 { + return fmt.Errorf("commission-bps must be <= 10000") + } + if enabled && maxTotalDelegatedWei.Sign() <= 0 { + return fmt.Errorf("--max-total-delegated must be > 0 when --enabled=true") + } + + method := abis.StakingABI.Methods["setValidatorPoolConfig"] + if method == nil { + return fmt.Errorf("staking ABI missing setValidatorPoolConfig") + } + + inputArgs, err := method.Inputs.Encode(map[string]interface{}{ + "delegationEnabled": enabled, + "maxTotalDelegatedStake": maxTotalDelegatedWei, + "minDelegatorStake": minDelegatorWei, + "commissionBps": uint16(commissionBps), + }) + if err != nil { + return err + } + + input := append(method.ID(), inputArgs...) + + to := ethgo.Address(staking.AddrStakingContract) + tx := ðgo.Transaction{To: &to, From: key.Address(), Input: input, Type: ethgo.TransactionDynamicFee} + receipt, err := relayer.SendTransaction(tx, key) + if err != nil { + return fmt.Errorf("pool-config transaction failed for wallet %s via jsonrpc %s: %w", key.Address(), jsonRPC, err) + } + if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { + return fmt.Errorf("pool-config transaction reverted for wallet %s via jsonrpc %s", key.Address(), jsonRPC) + } + return nil +} + +func ensureJoinedSelfValidator(relayer txrelayer.TxRelayer, addr types.Address) error { + method := abis.StakingABI.Methods["validatorSelfStake"] + if method == nil { + return fmt.Errorf("staking ABI missing validatorSelfStake") + } + + inp, err := method.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(addr)}) + if err != nil { + return err + } + + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), append(method.ID(), inp...)) + if err != nil { + return err + } + + b, err := hexToBytes(resp) + if err != nil { + return err + } + + decoded, err := method.Outputs.Decode(b) + if err != nil { + return err + } + + outMap, ok := decoded.(map[string]interface{}) + if !ok { + return fmt.Errorf("decode validatorSelfStake: unexpected type") + } + + selfStake, ok := outMap["0"].(*big.Int) + if !ok { + return fmt.Errorf("decode validatorSelfStake: missing value") + } + + if selfStake.Sign() <= 0 { + return fmt.Errorf("wallet %s is not a joined validator self-position; run ibft join first or use the correct --data-dir", addr.String()) + } + + return nil +} + +func hexToBytes(s string) ([]byte, error) { + s = strings.TrimPrefix(s, "0x") + if s == "" { + return []byte{}, nil + } + + return hex.DecodeString(s) +} + +func initSecretsManager(p *params) (secrets.SecretsManager, error) { + if p.config != "" { + cfg, err := secrets.ReadConfig(p.config) + if err != nil { + return nil, err + } + return secretsHelper.InitCloudSecretsManager(cfg) + } + baseConfig := &secrets.SecretsManagerParams{Logger: hclog.NewNullLogger(), Extra: map[string]interface{}{secrets.Path: p.dataDir}} + return local.SecretsManagerFactory(nil, baseConfig) +} + +func ensureECDSAKey(sm secrets.SecretsManager) error { + if sm.HasSecret(secrets.ValidatorKey) { + return nil + } + _, err := secretsHelper.InitECDSAValidatorKey(sm) + return err +} diff --git a/command/ibft/poolconfig/pool_config_test.go b/command/ibft/poolconfig/pool_config_test.go new file mode 100644 index 0000000..41a6adf --- /dev/null +++ b/command/ibft/poolconfig/pool_config_test.go @@ -0,0 +1,93 @@ +package poolconfig + +import ( + "math/big" + "testing" + + "github.com/stretchr/testify/require" + "github.com/umbracle/ethgo" + "github.com/umbracle/ethgo/jsonrpc" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/types" +) + +type mockRelayer struct { + tx *ethgo.Transaction + callFn func(from ethgo.Address, to ethgo.Address, input []byte) (string, error) +} + +type mockKey struct { + addr ethgo.Address +} + +func (m mockKey) Address() ethgo.Address { + return m.addr +} + +func (m mockKey) Sign(_ []byte) ([]byte, error) { + return nil, nil +} + +func (m *mockRelayer) Call(from ethgo.Address, to ethgo.Address, input []byte) (string, error) { + if m.callFn != nil { + return m.callFn(from, to, input) + } + return "0x", nil +} + +func (m *mockRelayer) SendTransaction(txn *ethgo.Transaction, key ethgo.Key) (*ethgo.Receipt, error) { + m.tx = txn + return ðgo.Receipt{Status: uint64(types.ReceiptSuccess)}, nil +} + +func (m *mockRelayer) SendTransactionLocal(txn *ethgo.Transaction) (*ethgo.Receipt, error) { + m.tx = txn + return ðgo.Receipt{Status: uint64(types.ReceiptSuccess)}, nil +} + +func (m *mockRelayer) Client() *jsonrpc.Client { return nil } + +func TestSendPoolConfigTx_UsesStakingABI(t *testing.T) { + relayer := &mockRelayer{} + max := new(big.Int).Mul(big.NewInt(123), new(big.Int).Exp(big.NewInt(10), big.NewInt(18), nil)) + key := mockKey{addr: ethgo.Address(types.StringToAddress("0x9999999999999999999999999999999999999999"))} + + require.NoError(t, sendPoolConfigTx(relayer, key, true, max, big.NewInt(77), 250, "http://127.0.0.1:8545")) + require.NotNil(t, relayer.tx) + + method := abis.StakingABI.Methods["setValidatorPoolConfig"] + require.NotNil(t, method) + require.GreaterOrEqual(t, len(relayer.tx.Input), 4) + require.Equal(t, method.ID(), relayer.tx.Input[:4]) + + decoded, err := method.Inputs.Decode(relayer.tx.Input[4:]) + require.NoError(t, err) + args, ok := decoded.(map[string]interface{}) + require.True(t, ok) + require.Equal(t, true, args["delegationEnabled"].(bool)) + require.Equal(t, 0, args["maxTotalDelegatedStake"].(*big.Int).Cmp(max)) + require.Equal(t, 0, args["minDelegatorStake"].(*big.Int).Cmp(big.NewInt(77))) + require.Equal(t, uint16(250), args["commissionBps"].(uint16)) + require.Equal(t, key.Address(), relayer.tx.From) +} + +func TestSendPoolConfigTx_RejectsTooHighCommission(t *testing.T) { + err := sendPoolConfigTx(&mockRelayer{}, mockKey{}, true, big.NewInt(1), big.NewInt(0), 10001, "http://127.0.0.1:8545") + require.Error(t, err) +} + +func TestGetCommand_DefaultsForPoolConfig(t *testing.T) { + cmd := GetCommand() + require.Equal(t, "0", cmd.Flags().Lookup("max-total-delegated").DefValue) + require.Equal(t, "0", cmd.Flags().Lookup("commission-bps").DefValue) + require.Equal(t, "0", cmd.Flags().Lookup("min-delegator-stake").DefValue) + require.Equal(t, "true", cmd.Flags().Lookup("enabled").DefValue) +} + +func TestResult_IncludesMinDelegatorWei(t *testing.T) { + r := &Result{Validator: "0x1", Enabled: true, MaxTotalDelegatedWei: "2", MinDelegatorWei: "3", CommissionBps: 4} + out := r.GetOutput() + require.Contains(t, out, "Max total delegated (wei)") + require.Contains(t, out, "Min delegator stake (wei)") + require.Contains(t, out, "3") +} diff --git a/command/ibft/poolconfig/result.go b/command/ibft/poolconfig/result.go new file mode 100644 index 0000000..0f69065 --- /dev/null +++ b/command/ibft/poolconfig/result.go @@ -0,0 +1,29 @@ +package poolconfig + +import ( + "bytes" + "fmt" + + "github.com/xgr-network/xgr-node/command/helper" +) + +type Result struct { + Validator string `json:"validator"` + Enabled bool `json:"enabled"` + MaxTotalDelegatedWei string `json:"maxTotalDelegatedWei"` + MinDelegatorWei string `json:"minDelegatorWei"` + CommissionBps uint64 `json:"commissionBps"` +} + +func (r *Result) GetOutput() string { + var b bytes.Buffer + b.WriteString("\n[IBFT POOL-CONFIG]\n") + b.WriteString(helper.FormatKV([]string{ + fmt.Sprintf("Validator|%s", r.Validator), + fmt.Sprintf("Enabled|%t", r.Enabled), + fmt.Sprintf("Max total delegated (wei)|%s", r.MaxTotalDelegatedWei), + fmt.Sprintf("Min delegator stake (wei)|%s", r.MinDelegatorWei), + fmt.Sprintf("Commission (bps)|%d", r.CommissionBps), + })) + return b.String() +} diff --git a/command/ibft/setactive/result.go b/command/ibft/setactive/result.go new file mode 100644 index 0000000..43699ee --- /dev/null +++ b/command/ibft/setactive/result.go @@ -0,0 +1,46 @@ +package setactive + +import ( + "bytes" + "fmt" + + "github.com/xgr-network/xgr-node/command/helper" +) + +type SetActiveResult struct { + Validator string `json:"validator"` + JoinedAtBlock uint64 `json:"joinedAtBlock,omitempty"` + Active bool `json:"active"` + AccountStakeWei string `json:"accountStakeWei"` + DeactivatedAtBlock uint64 `json:"deactivatedAtBlock,omitempty"` + UnstakeAvailableAtBlock uint64 `json:"unstakeAvailableAtBlock,omitempty"` +} + +func (r *SetActiveResult) GetOutput() string { + var b bytes.Buffer + b.WriteString("\n[IBFT SET-ACTIVE]\n") + rows := []string{ + fmt.Sprintf("Validator|%s", r.Validator), + fmt.Sprintf("Joined at block|%d", r.JoinedAtBlock), + fmt.Sprintf("Active|%t", r.Active), + fmt.Sprintf("Account stake (wei)|%s", r.AccountStakeWei), + } + + if r.DeactivatedAtBlock > 0 { + rows = append(rows, fmt.Sprintf("Deactivated at block|%d", r.DeactivatedAtBlock)) + } + if r.UnstakeAvailableAtBlock > 0 { + rows = append(rows, fmt.Sprintf("Unstake available at block|%d", r.UnstakeAvailableAtBlock)) + } + + b.WriteString(helper.FormatKV(rows)) + + if !r.Active && r.UnstakeAvailableAtBlock > 0 { + b.WriteString("\nNote: Unstake is available from the displayed block onward (next epoch).\n") + } + if r.Active && r.DeactivatedAtBlock == 0 { + b.WriteString("\nNote: deactivatedAtBlock=0 means 'never deactivated'. For withdraw/unstake, run set-active false first and wait for the next epoch.\n") + } + + return b.String() +} diff --git a/command/ibft/setactive/setactive.go b/command/ibft/setactive/setactive.go new file mode 100644 index 0000000..9943491 --- /dev/null +++ b/command/ibft/setactive/setactive.go @@ -0,0 +1,384 @@ +package setactive + +import ( + "encoding/hex" + "fmt" + "math/big" + "strings" + "time" + + "github.com/hashicorp/go-hclog" + "github.com/spf13/cobra" + "github.com/umbracle/ethgo" + + "github.com/xgr-network/xgr-node/command" + ibftHelper "github.com/xgr-network/xgr-node/command/ibft/helper" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + secretsHelper "github.com/xgr-network/xgr-node/helper/secrets" + "github.com/xgr-network/xgr-node/secrets" + "github.com/xgr-network/xgr-node/secrets/local" + "github.com/xgr-network/xgr-node/txrelayer" + "github.com/xgr-network/xgr-node/types" +) + +type setActiveParams struct { + jsonRPC string + config string + dataDir string + insecure bool + initKeys bool + value bool +} + +func GetCommand() *cobra.Command { + p := &setActiveParams{} + + cmd := &cobra.Command{ + Use: "set-active", + Short: "Set validator active flag in staking contract (setActive(bool))", + Args: cobra.NoArgs, + RunE: func(cmd *cobra.Command, _ []string) error { + outputter := command.InitializeOutputter(cmd) + defer outputter.WriteOutput() + + sm, err := initSecretsManager(p) + if err != nil { + outputter.SetError(err) + return nil + } + + if p.initKeys { + if err := ensureECDSAKey(sm); err != nil { + outputter.SetError(err) + return nil + } + } + + key, err := ibftHelper.GetECDSAKeyFromSecret(sm) + if err != nil { + outputter.SetError(err) + return nil + } + + relayer, err := txrelayer.NewTxRelayer( + txrelayer.WithIPAddress(p.jsonRPC), + txrelayer.WithReceiptTimeout(250*time.Millisecond), + ) + if err != nil { + outputter.SetError(err) + return nil + } + + if err := sendSetActive(relayer, key, p.value); err != nil { + outputter.SetError(err) + return nil + } + + validatorAddr := types.Address(key.Address()) + + validatorStatus, err := queryValidatorStatus(relayer, validatorAddr) + if err != nil { + outputter.SetError(err) + return nil + } + + epochSize, _ := queryEpochSize(relayer) + + onchainStake, err := queryAccountStake(relayer, validatorAddr) + if err != nil { + outputter.SetError(err) + return nil + } + + res := &SetActiveResult{ + Validator: validatorAddr.String(), + JoinedAtBlock: validatorStatus.JoinedAtBlock, + Active: validatorStatus.Active, + AccountStakeWei: onchainStake.String(), + } + + if validatorStatus.DeactivatedAtBlock > 0 { + res.DeactivatedAtBlock = validatorStatus.DeactivatedAtBlock + if epochSize > 0 { + deactEpoch := validatorStatus.DeactivatedAtBlock / epochSize + res.UnstakeAvailableAtBlock = (deactEpoch + 1) * epochSize + } + } + + outputter.SetCommandResult(res) + + return nil + }, + } + + setFlags(cmd, p) + return cmd +} + +func setFlags(cmd *cobra.Command, p *setActiveParams) { + cmd.Flags().StringVar(&p.jsonRPC, "jsonrpc", "http://127.0.0.1:8545", "JSON-RPC endpoint") + cmd.Flags().StringVar(&p.dataDir, "data-dir", "./data", "Data directory for local secrets") + cmd.Flags().StringVar(&p.config, "config", "", "SecretsManager config file (optional)") + cmd.Flags().BoolVar(&p.insecure, "insecure", false, "Allow insecure key storage") + cmd.Flags().BoolVar(&p.initKeys, "init-keys", false, "Generate missing ECDSA key in data-dir/config") + cmd.Flags().BoolVar(&p.value, "value", true, "Set active flag to true/false") +} + +func initSecretsManager(p *setActiveParams) (secrets.SecretsManager, error) { + if p.config != "" { + cfg, err := secrets.ReadConfig(p.config) + if err != nil { + return nil, err + } + return secretsHelper.InitCloudSecretsManager(cfg) + } + + baseConfig := &secrets.SecretsManagerParams{ + Logger: hclog.NewNullLogger(), + Extra: map[string]interface{}{ + secrets.Path: p.dataDir, + }, + } + + return local.SecretsManagerFactory(nil, baseConfig) +} + +func ensureECDSAKey(sm secrets.SecretsManager) error { + if sm.HasSecret(secrets.ValidatorKey) { + return nil + } + _, err := secretsHelper.InitECDSAValidatorKey(sm) + return err +} + +type validatorStatus struct { + Active bool + DeactivatedAtBlock uint64 + JoinedAtBlock uint64 +} + +func queryValidatorStatus(relayer txrelayer.TxRelayer, addr types.Address) (*validatorStatus, error) { + method := abis.StakingABI.Methods["validatorInfo"] + if method == nil { + return nil, fmt.Errorf("staking ABI missing validatorInfo") + } + + inp, err := method.Inputs.Encode(map[string]interface{}{ + "account": ethgo.Address(addr), + }) + if err != nil { + return nil, err + } + + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), append(method.ID(), inp...)) + if err != nil { + return nil, err + } + + b, err := hexToBytes(resp) + if err != nil { + return nil, err + } + + decoded, err := method.Outputs.Decode(b) + if err != nil { + return nil, err + } + + m, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode validatorInfo: unexpected type") + } + + active, ok := m["1"].(bool) + if !ok { + active, ok = m["active"].(bool) + if !ok { + return nil, fmt.Errorf("decode validatorInfo: missing active") + } + } + + deactivatedAt := uint64(0) + if deact, ok := m["3"].(*big.Int); ok && deact != nil { + deactivatedAt = deact.Uint64() + } else if deact, ok := m["deactivatedAtBlock"].(*big.Int); ok && deact != nil { + deactivatedAt = deact.Uint64() + } + + joinedAt, _ := queryJoinedAtBlock(relayer, addr) + + return &validatorStatus{ + Active: active, + DeactivatedAtBlock: deactivatedAt, + JoinedAtBlock: joinedAt, + }, nil +} + +func queryJoinedAtBlock(relayer txrelayer.TxRelayer, addr types.Address) (uint64, error) { + selector := crypto.Keccak256([]byte("joinedAtBlock(address)"))[:4] + input := make([]byte, 4+32) + copy(input[:4], selector) + copy(input[4+12:], addr.Bytes()) + + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), input) + if err != nil { + return 0, err + } + b, err := hexToBytes(resp) + if err != nil { + return 0, err + } + if len(b) == 0 { + return 0, nil + } + + return new(big.Int).SetBytes(b).Uint64(), nil +} + +func queryEpochSize(relayer txrelayer.TxRelayer) (uint64, error) { + method := abis.StakingABI.Methods["epochSize"] + if method == nil { + return 0, fmt.Errorf("staking ABI missing epochSize") + } + + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), method.ID()) + if err != nil { + return 0, err + } + + b, err := hexToBytes(resp) + if err != nil { + return 0, err + } + + decoded, err := method.Outputs.Decode(b) + if err != nil { + return 0, err + } + + m, ok := decoded.(map[string]interface{}) + if !ok { + return 0, fmt.Errorf("decode epochSize: unexpected type") + } + + if epoch, ok := uint64FromDecodedValue(m["0"]); ok { + return epoch, nil + } + if epoch, ok := uint64FromDecodedValue(m["epochSize"]); ok { + return epoch, nil + } + for _, value := range m { + if epoch, ok := uint64FromDecodedValue(value); ok { + return epoch, nil + } + } + + return 0, fmt.Errorf("decode epochSize: missing value") +} + +func epochOf(number, epochSize uint64) uint64 { + if number == 0 || epochSize == 0 { + return 0 + } + if number%epochSize == 0 { + return number / epochSize + } + return number/epochSize + 1 +} + +func uint64FromDecodedValue(v interface{}) (uint64, bool) { + switch x := v.(type) { + case *big.Int: + if x == nil { + return 0, false + } + return x.Uint64(), true + case uint64: + return x, true + case uint32: + return uint64(x), true + case int: + if x < 0 { + return 0, false + } + return uint64(x), true + } + + return 0, false +} + +func queryAccountStake(relayer txrelayer.TxRelayer, addr types.Address) (*big.Int, error) { + method := abis.StakingABI.Methods["accountStake"] + if method == nil { + return nil, fmt.Errorf("staking ABI missing accountStake") + } + inp, err := method.Inputs.Encode(map[string]interface{}{ + "account": ethgo.Address(addr), + }) + if err != nil { + return nil, err + } + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), append(method.ID(), inp...)) + if err != nil { + return nil, err + } + b, err := hexToBytes(resp) + if err != nil { + return nil, err + } + decoded, err := method.Outputs.Decode(b) + if err != nil { + return nil, err + } + m, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode accountStake: unexpected type") + } + v, ok := m["0"].(*big.Int) + if !ok { + return nil, fmt.Errorf("decode accountStake: missing value") + } + return v, nil +} + +func sendSetActive(relayer txrelayer.TxRelayer, key ethgo.Key, value bool) error { + m := abis.StakingABI.Methods["setActive"] + if m == nil { + return fmt.Errorf("staking ABI missing setActive") + } + inp, err := m.Inputs.Encode(map[string]interface{}{"active_": value}) + if err != nil { + return fmt.Errorf("encode setActive input failed: %w", err) + } + to := ethgo.Address(staking.AddrStakingContract) + tx := ðgo.Transaction{ + To: &to, + Input: append(m.ID(), inp...), + Type: ethgo.TransactionDynamicFee, + } + receipt, err := relayer.SendTransaction(tx, key) + if err != nil { + msg := err.Error() + if strings.Contains(msg, "0xa291f7f5") { + return nil + } + if strings.Contains(msg, "0x580e542f") { + return fmt.Errorf("set-active rejected: validator %s not found in staking set on this chain (check --data-dir/--config key and --jsonrpc endpoint)", key.Address()) + } + return fmt.Errorf("setActive tx failed: %w", err) + } + if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { + return fmt.Errorf("setActive reverted") + } + return nil +} + +func hexToBytes(s string) ([]byte, error) { + s = strings.TrimPrefix(s, "0x") + if s == "" { + return []byte{}, nil + } + return hex.DecodeString(s) +} diff --git a/command/ibft/setactive/setactive_test.go b/command/ibft/setactive/setactive_test.go new file mode 100644 index 0000000..b42a71d --- /dev/null +++ b/command/ibft/setactive/setactive_test.go @@ -0,0 +1,123 @@ +package setactive + +import ( + "encoding/hex" + "errors" + "math/big" + "strings" + "testing" + + "github.com/xgr-network/xgr-node/contracts/abis" + + "github.com/umbracle/ethgo" + "github.com/umbracle/ethgo/jsonrpc" + "github.com/xgr-network/xgr-node/types" +) + +type mockRelayer struct { + callResp string + callErr error + sendReceipt *ethgo.Receipt + sendErr error +} + +func (m *mockRelayer) Call(ethgo.Address, ethgo.Address, []byte) (string, error) { + return m.callResp, m.callErr +} +func (m *mockRelayer) SendTransaction(*ethgo.Transaction, ethgo.Key) (*ethgo.Receipt, error) { + return m.sendReceipt, m.sendErr +} +func (m *mockRelayer) SendTransactionLocal(*ethgo.Transaction) (*ethgo.Receipt, error) { + return nil, nil +} +func (m *mockRelayer) Client() *jsonrpc.Client { return nil } + +type mockKey struct { + addr ethgo.Address +} + +func (m mockKey) Address() ethgo.Address { return m.addr } +func (m mockKey) Sign([]byte) ([]byte, error) { + return nil, nil +} + +func TestSendSetActive_AlreadyInRequestedState_IsNoop(t *testing.T) { + err := sendSetActive(&mockRelayer{sendErr: errors.New("execution reverted data:0xa291f7f5")}, mockKey{}, false) + if err != nil { + t.Fatalf("expected noop nil error, got %v", err) + } +} + +func TestSendSetActive_ValidatorNotFound(t *testing.T) { + key := mockKey{addr: ethgo.HexToAddress("0x1111111111111111111111111111111111111111")} + err := sendSetActive(&mockRelayer{sendErr: errors.New("execution reverted data:0x580e542f")}, key, false) + if err == nil { + t.Fatal("expected error") + } + + if !strings.Contains(err.Error(), "not found in staking set on this chain") { + t.Fatalf("unexpected error: %v", err) + } + if !strings.Contains(err.Error(), key.addr.String()) { + t.Fatalf("expected error to contain validator address, got %v", err) + } +} + +func TestSendSetActive_RevertedReceipt(t *testing.T) { + err := sendSetActive(&mockRelayer{sendReceipt: ðgo.Receipt{Status: uint64(types.ReceiptFailed)}}, mockKey{}, true) + if err == nil || err.Error() != "setActive reverted" { + t.Fatalf("expected setActive reverted, got %v", err) + } +} + +func TestQueryValidatorStatus_DecodeByIndex(t *testing.T) { + method := abis.StakingABI.Methods["validatorInfo"] + enc, err := method.Outputs.Encode(map[string]interface{}{ + "exists": false, + "active": true, + "stakedAmount": big.NewInt(0), + "deactivatedAtBlock": big.NewInt(7), + "blsPubKey": []byte{}, + }) + if err != nil { + t.Fatalf("encode failed: %v", err) + } + + status, err := queryValidatorStatus(&mockRelayer{callResp: "0x" + hex.EncodeToString(enc)}, types.ZeroAddress) + if err != nil { + t.Fatalf("unexpected error: %v", err) + } + + if !status.Active { + t.Fatal("expected active=true") + } + if status.DeactivatedAtBlock != 7 { + t.Fatalf("expected deactivatedAtBlock=7, got %d", status.DeactivatedAtBlock) + } +} + +func TestQueryValidatorStatus_CallError(t *testing.T) { + _, err := queryValidatorStatus(&mockRelayer{callErr: errors.New("rpc down")}, types.ZeroAddress) + if err == nil || !strings.Contains(err.Error(), "rpc down") { + t.Fatalf("expected rpc error, got %v", err) + } +} + +func TestQueryEpochSize(t *testing.T) { + method := abis.StakingABI.Methods["epochSize"] + enc, err := method.Outputs.Encode(map[string]interface{}{ + "0": big.NewInt(100), + }) + if err != nil { + t.Fatalf("encode failed: %v", err) + } + + epochSize, err := queryEpochSize(&mockRelayer{callResp: "0x" + hex.EncodeToString(enc)}) + if err != nil { + t.Fatalf("unexpected error: %v", err) + } + + if epochSize != 100 { + t.Fatalf("expected epoch size 100, got %d", epochSize) + } +} diff --git a/command/ibft/snapshot/result.go b/command/ibft/snapshot/result.go index 7487517..8738da4 100644 --- a/command/ibft/snapshot/result.go +++ b/command/ibft/snapshot/result.go @@ -16,19 +16,34 @@ type IBFTSnapshotVote struct { Vote ibftHelper.Vote `json:"vote"` } +type IBFTSnapshotValidator struct { + Validator validators.Validator `json:"validator"` + UptimeNominalWeight uint64 `json:"uptime_nominal_weight"` + UptimeEffectiveWeight uint64 `json:"uptime_effective_weight"` + UptimeInactivity uint64 `json:"uptime_inactivity"` +} + type IBFTSnapshotResult struct { - Number uint64 `json:"number"` - Hash string `json:"hash"` - Votes []IBFTSnapshotVote `json:"votes"` - Validators []validators.Validator `json:"validators"` + Number uint64 `json:"number"` + Hash string `json:"hash"` + MicroEpoch uint64 `json:"micro_epoch"` + UptimeEpoch uint64 `json:"uptime_epoch"` + UptimeTotalEffectiveWeight uint64 `json:"uptime_total_effective_weight"` + UptimeActiveEffective uint64 `json:"uptime_active_effective_weight"` + Votes []IBFTSnapshotVote `json:"votes"` + Validators []IBFTSnapshotValidator `json:"validators"` } func newIBFTSnapshotResult(resp *ibftOp.Snapshot) (*IBFTSnapshotResult, error) { res := &IBFTSnapshotResult{ - Number: resp.Number, - Hash: resp.Hash, - Votes: make([]IBFTSnapshotVote, len(resp.Votes)), - Validators: make([]validators.Validator, len(resp.Validators)), + Number: resp.Number, + Hash: resp.Hash, + MicroEpoch: resp.MicroEpoch, + UptimeEpoch: resp.UptimeEpoch, + UptimeTotalEffectiveWeight: resp.UptimeTotalEffectiveWeight, + UptimeActiveEffective: resp.UptimeActiveEffectiveWeight, + Votes: make([]IBFTSnapshotVote, len(resp.Votes)), + Validators: make([]IBFTSnapshotValidator, len(resp.Validators)), } for i, v := range resp.Votes { @@ -56,7 +71,12 @@ func newIBFTSnapshotResult(resp *ibftOp.Snapshot) (*IBFTSnapshotResult, error) { return nil, err } - res.Validators[i] = validator + res.Validators[i] = IBFTSnapshotValidator{ + Validator: validator, + UptimeNominalWeight: v.UptimeNominalWeight, + UptimeEffectiveWeight: v.UptimeEffectiveWeight, + UptimeInactivity: v.UptimeInactivity, + } } return res, nil @@ -74,10 +94,19 @@ func (r *IBFTSnapshotResult) GetOutput() string { } func (r *IBFTSnapshotResult) writeBlockData(buffer *bytes.Buffer) { - buffer.WriteString(helper.FormatKV([]string{ + lines := []string{ fmt.Sprintf("Block|%d", r.Number), fmt.Sprintf("Hash|%s", r.Hash), - })) + } + if r.uptimeFieldsVisible() { + lines = append(lines, + fmt.Sprintf("Micro-epoch|%d", r.MicroEpoch), + fmt.Sprintf("Uptime epoch|%d", r.UptimeEpoch), + fmt.Sprintf("Uptime total effective weight|%d", r.UptimeTotalEffectiveWeight), + fmt.Sprintf("Uptime active effective weight|%d", r.UptimeActiveEffective), + ) + } + buffer.WriteString(helper.FormatKV(lines)) buffer.WriteString("\n") } @@ -111,9 +140,17 @@ func (r *IBFTSnapshotResult) writeValidatorData(buffer *bytes.Buffer) { validators[0] = "No validators found" if numValidators > 0 { - validators[0] = "ADDRESS" + if r.uptimeFieldsVisible() { + validators[0] = "ADDRESS|UPTIME NOMINAL|UPTIME EFFECTIVE|UPTIME INACTIVITY" + } else { + validators[0] = "ADDRESS" + } for i, d := range r.Validators { - validators[i+1] = d.String() + if r.uptimeFieldsVisible() { + validators[i+1] = fmt.Sprintf("%s|%d|%d|%d", d.Validator.String(), d.UptimeNominalWeight, d.UptimeEffectiveWeight, d.UptimeInactivity) + } else { + validators[i+1] = d.Validator.String() + } } } @@ -121,3 +158,22 @@ func (r *IBFTSnapshotResult) writeValidatorData(buffer *bytes.Buffer) { buffer.WriteString(helper.FormatList(validators)) buffer.WriteString("\n") } + +func (r *IBFTSnapshotResult) uptimeFieldsVisible() bool { + if r.MicroEpoch != 0 || + r.UptimeEpoch != 0 || + r.UptimeTotalEffectiveWeight != 0 || + r.UptimeActiveEffective != 0 { + return true + } + + for _, v := range r.Validators { + if v.UptimeNominalWeight != 0 || + v.UptimeEffectiveWeight != 0 || + v.UptimeInactivity != 0 { + return true + } + } + + return false +} diff --git a/command/ibft/snapshot/result_test.go b/command/ibft/snapshot/result_test.go new file mode 100644 index 0000000..9d6d72a --- /dev/null +++ b/command/ibft/snapshot/result_test.go @@ -0,0 +1,76 @@ +package snapshot + +import ( + "testing" + + "github.com/stretchr/testify/require" + ibftOp "github.com/xgr-network/xgr-node/consensus/ibft/proto" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestIBFTSnapshotResult_GetOutput_HidesUptimeFieldsWhenInactive(t *testing.T) { + v := validators.NewECDSAValidator(types.StringToAddress("0x123")) + res, err := newIBFTSnapshotResult(&ibftOp.Snapshot{ + Number: 1, + Hash: "0x1", + Validators: []*ibftOp.Snapshot_Validator{{ + Type: "ecdsa", + Address: v.Addr().String(), + Data: v.Bytes(), + }}, + }) + require.NoError(t, err) + + out := res.GetOutput() + require.NotContains(t, out, "Micro-epoch") + require.Contains(t, out, "[VALIDATORS]") + require.Contains(t, out, "ADDRESS") + require.NotContains(t, out, "UPTIME NOMINAL") +} + +func TestIBFTSnapshotResult_GetOutput_ShowsUptimeFieldsWhenActive(t *testing.T) { + v := validators.NewECDSAValidator(types.StringToAddress("0x123")) + res, err := newIBFTSnapshotResult(&ibftOp.Snapshot{ + Number: 2, + Hash: "0x2", + MicroEpoch: 10, + UptimeEpoch: 3, + UptimeTotalEffectiveWeight: 100, + UptimeActiveEffectiveWeight: 90, + Validators: []*ibftOp.Snapshot_Validator{{ + Type: "ecdsa", + Address: v.Addr().String(), + Data: v.Bytes(), + UptimeNominalWeight: 100, + UptimeEffectiveWeight: 90, + UptimeInactivity: 1, + }}, + }) + require.NoError(t, err) + + out := res.GetOutput() + require.Contains(t, out, "Micro-epoch") + require.Contains(t, out, "UPTIME NOMINAL") +} + +func TestIBFTSnapshotResult_GetOutput_ShowsUptimeColumnsWhenWeightsAreZero(t *testing.T) { + v := validators.NewECDSAValidator(types.StringToAddress("0x123")) + res, err := newIBFTSnapshotResult(&ibftOp.Snapshot{ + Number: 329, + Hash: "0x329", + MicroEpoch: 329, + UptimeEpoch: 32, + Validators: []*ibftOp.Snapshot_Validator{{ + Type: "ecdsa", + Address: v.Addr().String(), + Data: v.Bytes(), + }}, + }) + require.NoError(t, err) + + out := res.GetOutput() + require.Contains(t, out, "Micro-epoch") + require.Contains(t, out, "UPTIME NOMINAL") + require.Contains(t, out, " 0 0 0") +} diff --git a/command/ibft/stake/result.go b/command/ibft/stake/result.go new file mode 100644 index 0000000..2bfdbc8 --- /dev/null +++ b/command/ibft/stake/result.go @@ -0,0 +1,26 @@ +package stake + +import ( + "bytes" + "fmt" + + "github.com/xgr-network/xgr-node/command/helper" +) + +type StakeResult struct { + Validator string `json:"validator"` + AmountWei string `json:"amountWei"` + AccountStakeWei string `json:"accountStakeWei"` +} + +func (r *StakeResult) GetOutput() string { + var b bytes.Buffer + b.WriteString("\n[IBFT STAKE]\n") + b.WriteString(helper.FormatKV([]string{ + fmt.Sprintf("Validator|%s", r.Validator), + fmt.Sprintf("Amount (wei)|%s", r.AmountWei), + fmt.Sprintf("Account stake (wei)|%s", r.AccountStakeWei), + })) + + return b.String() +} diff --git a/command/ibft/stake/stake.go b/command/ibft/stake/stake.go new file mode 100644 index 0000000..b133870 --- /dev/null +++ b/command/ibft/stake/stake.go @@ -0,0 +1,214 @@ +package stake + +import ( + "encoding/hex" + "fmt" + "math/big" + "strings" + "time" + + "github.com/hashicorp/go-hclog" + "github.com/spf13/cobra" + "github.com/umbracle/ethgo" + + "github.com/xgr-network/xgr-node/command" + ibftHelper "github.com/xgr-network/xgr-node/command/ibft/helper" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + secretsHelper "github.com/xgr-network/xgr-node/helper/secrets" + "github.com/xgr-network/xgr-node/secrets" + "github.com/xgr-network/xgr-node/secrets/local" + "github.com/xgr-network/xgr-node/txrelayer" + "github.com/xgr-network/xgr-node/types" +) + +type stakeParams struct { + jsonRPC string + config string + dataDir string + insecure bool + initKeys bool + + amountStr string + decimals int +} + +func GetCommand() *cobra.Command { + p := &stakeParams{} + + cmd := &cobra.Command{ + Use: "stake", + Short: "Increase stake in the staking contract (payable stake())", + RunE: func(cmd *cobra.Command, _ []string) error { + outputter := command.InitializeOutputter(cmd) + defer outputter.WriteOutput() + + sm, err := initSecretsManager(p) + if err != nil { + outputter.SetError(err) + return nil + } + + if p.initKeys { + if err := ensureECDSAKey(sm); err != nil { + outputter.SetError(err) + return nil + } + } + + key, err := ibftHelper.GetECDSAKeyFromSecret(sm) + if err != nil { + outputter.SetError(err) + return nil + } + + relayer, err := txrelayer.NewTxRelayer( + txrelayer.WithIPAddress(p.jsonRPC), + txrelayer.WithReceiptTimeout(250*time.Millisecond), + ) + if err != nil { + outputter.SetError(err) + return nil + } + + amountWei := toWei(p.amountStr, p.decimals) + if amountWei.Sign() <= 0 { + outputter.SetError(fmt.Errorf("amount must be > 0")) + return nil + } + + // send stake() + if err := sendStake(relayer, key, amountWei); err != nil { + outputter.SetError(err) + return nil + } + + onchainStake, err := queryAccountStake(relayer, types.Address(key.Address())) + if err != nil { + outputter.SetError(err) + return nil + } + + outputter.SetCommandResult(&StakeResult{ + Validator: types.Address(key.Address()).String(), + AmountWei: amountWei.String(), + AccountStakeWei: onchainStake.String(), + }) + + return nil + }, + } + + setFlags(cmd, p) + return cmd +} + +func setFlags(cmd *cobra.Command, p *stakeParams) { + cmd.Flags().StringVar(&p.jsonRPC, "jsonrpc", "http://127.0.0.1:8545", "JSON-RPC endpoint") + cmd.Flags().StringVar(&p.dataDir, "data-dir", "./data", "Data directory for local secrets") + cmd.Flags().StringVar(&p.config, "config", "", "SecretsManager config file (optional)") + cmd.Flags().BoolVar(&p.insecure, "insecure", false, "Allow insecure key storage") + cmd.Flags().BoolVar(&p.initKeys, "init-keys", false, "Generate missing ECDSA key in data-dir/config") + + cmd.Flags().StringVar(&p.amountStr, "amount", "0", "Stake amount (integer, in token units)") + cmd.Flags().IntVar(&p.decimals, "decimals", 18, "Token decimals") + + _ = cmd.MarkFlagRequired("amount") +} + +func initSecretsManager(p *stakeParams) (secrets.SecretsManager, error) { + if p.config != "" { + cfg, err := secrets.ReadConfig(p.config) + if err != nil { + return nil, err + } + return secretsHelper.InitCloudSecretsManager(cfg) + } + + baseConfig := &secrets.SecretsManagerParams{ + Logger: hclog.NewNullLogger(), + Extra: map[string]interface{}{ + secrets.Path: p.dataDir, + }, + } + + return local.SecretsManagerFactory(nil, baseConfig) +} + +func ensureECDSAKey(sm secrets.SecretsManager) error { + if sm.HasSecret(secrets.ValidatorKey) { + return nil + } + _, err := secretsHelper.InitECDSAValidatorKey(sm) + return err +} + +func toWei(amountStr string, decimals int) *big.Int { + a, _ := new(big.Int).SetString(amountStr, 10) + m := new(big.Int).Exp(big.NewInt(10), big.NewInt(int64(decimals)), nil) + return new(big.Int).Mul(a, m) +} + +func queryAccountStake(relayer txrelayer.TxRelayer, addr types.Address) (*big.Int, error) { + method := abis.StakingABI.Methods["accountStake"] + if method == nil { + return nil, fmt.Errorf("staking ABI missing accountStake") + } + inp, err := method.Inputs.Encode(map[string]interface{}{ + "account": ethgo.Address(addr), + }) + if err != nil { + return nil, err + } + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), append(method.ID(), inp...)) + if err != nil { + return nil, err + } + b, err := hexToBytes(resp) + if err != nil { + return nil, err + } + decoded, err := method.Outputs.Decode(b) + if err != nil { + return nil, err + } + m, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode accountStake: unexpected type") + } + v, ok := m["0"].(*big.Int) + if !ok { + return nil, fmt.Errorf("decode accountStake: missing value") + } + return v, nil +} + +func sendStake(relayer txrelayer.TxRelayer, key ethgo.Key, stakeWei *big.Int) error { + m := abis.StakingABI.Methods["stake"] + if m == nil { + return fmt.Errorf("staking ABI missing stake") + } + to := ethgo.Address(staking.AddrStakingContract) + tx := ðgo.Transaction{ + To: &to, + Input: m.ID(), + Value: stakeWei, + Type: ethgo.TransactionDynamicFee, + } + receipt, err := relayer.SendTransaction(tx, key) + if err != nil { + return fmt.Errorf("stake tx failed: %w", err) + } + if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { + return fmt.Errorf("stake reverted") + } + return nil +} + +func hexToBytes(s string) ([]byte, error) { + s = strings.TrimPrefix(s, "0x") + if s == "" { + return []byte{}, nil + } + return hex.DecodeString(s) +} diff --git a/command/ibft/switch/params.go b/command/ibft/switch/params.go index cc6b529..a27df46 100644 --- a/command/ibft/switch/params.go +++ b/command/ibft/switch/params.go @@ -9,6 +9,7 @@ import ( "github.com/xgr-network/xgr-node/command" "github.com/xgr-network/xgr-node/command/helper" "github.com/xgr-network/xgr-node/consensus/ibft/fork" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" "github.com/xgr-network/xgr-node/helper/common" "github.com/xgr-network/xgr-node/validators" ) @@ -222,6 +223,16 @@ func (p *switchParams) initPoSConfig() error { return nil } + p.ibftValidators = validators.NewValidatorSetFromType(p.ibftValidatorType) + + if err := p.setValidatorSetFromPrefixPath(); err != nil { + return err + } + + if err := p.setValidatorSetFromCli(); err != nil { + return err + } + if p.minValidatorCountRaw != "" { value, err := common.ParseUint64orHex(&p.minValidatorCountRaw) if err != nil { @@ -420,6 +431,12 @@ func appendIBFTForks( case fork.PoA: newFork.Validators = validators case fork.PoS: + bootstrapValidators, err := resolvePoSBootstrapValidators(cc, lastFork, validators, validatorType) + if err != nil { + return err + } + newFork.Validators = bootstrapValidators + if deployment != nil { newFork.Deployment = &common.JSONNumber{Value: *deployment} } @@ -443,3 +460,112 @@ func appendIBFTForks( return nil } + +func resolvePoSBootstrapValidators( + cc *chain.Chain, + lastFork *fork.IBFTFork, + cliValidators validators.Validators, + validatorType validators.ValidatorType, +) (validators.Validators, error) { + if cliValidators != nil && cliValidators.Len() > 0 { + if err := validateBootstrapValidatorType(validatorType, cliValidators, "cli"); err != nil { + return nil, err + } + + return cliValidators, nil + } + + if lastFork != nil && lastFork.Validators != nil && lastFork.Validators.Len() > 0 { + if err := validateBootstrapValidatorType(validatorType, lastFork.Validators, "last-fork"); err != nil { + return nil, err + } + + return lastFork.Validators, nil + } + + bootstrapValidators, err := parseBootstrapValidatorsFromGenesisExtra(cc, validatorType) + if err != nil { + return nil, fmt.Errorf("unable to determine PoS bootstrap validators: %w", err) + } + + return bootstrapValidators, nil +} + +func validateBootstrapValidatorType( + expectedType validators.ValidatorType, + bootstrapValidators validators.Validators, + source string, +) error { + if bootstrapValidators == nil { + return nil + } + + actualType := bootstrapValidators.Type() + if actualType != expectedType { + return fmt.Errorf( + "bootstrap validators type mismatch: expected validator type %s, source %s, reason: type mismatch (got %s)", + expectedType, + source, + actualType, + ) + } + + return nil +} + +func parseBootstrapValidatorsFromGenesisExtra( + cc *chain.Chain, + validatorType validators.ValidatorType, +) (validators.Validators, error) { + if cc == nil || cc.Genesis == nil { + return nil, fmt.Errorf("missing chain genesis") + } + if len(cc.Genesis.ExtraData) < signer.IstanbulExtraVanity { + return nil, fmt.Errorf("genesis extra data is too short for IBFT validator extraction") + } + + bootstrapValidators, err := decodeValidatorsFromGenesisExtra(cc.Genesis.ExtraData, validatorType) + if err != nil { + otherType := validators.BLSValidatorType + if validatorType == validators.BLSValidatorType { + otherType = validators.ECDSAValidatorType + } + + if _, otherErr := decodeValidatorsFromGenesisExtra(cc.Genesis.ExtraData, otherType); otherErr == nil { + return nil, fmt.Errorf( + "bootstrap validators type mismatch: expected validator type %s, source genesis-extra, reason: type mismatch (got %s)", + validatorType, + otherType, + ) + } + + return nil, fmt.Errorf("failed to decode IBFT extra from genesis: %w", err) + } + + if bootstrapValidators == nil || bootstrapValidators.Len() == 0 { + return nil, fmt.Errorf("genesis IBFT extra does not contain validators") + } + + return bootstrapValidators, nil +} + +func decodeValidatorsFromGenesisExtra( + extraData []byte, + validatorType validators.ValidatorType, +) (validators.Validators, error) { + committedSeals := signer.Seals(&signer.SerializedSeal{}) + if validatorType == validators.BLSValidatorType { + committedSeals = &signer.AggregatedSeal{} + } + + extra := &signer.IstanbulExtra{ + Validators: validators.NewValidatorSetFromType(validatorType), + CommittedSeals: committedSeals, + } + + if err := extra.UnmarshalRLP(extraData[signer.IstanbulExtraVanity:]); err != nil { + return nil, err + } + + return extra.Validators, nil +} diff --git a/command/ibft/switch/params_test.go b/command/ibft/switch/params_test.go new file mode 100644 index 0000000..742c5e9 --- /dev/null +++ b/command/ibft/switch/params_test.go @@ -0,0 +1,300 @@ +package ibftswitch + +import ( + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/chain" + "github.com/xgr-network/xgr-node/consensus/ibft/fork" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestAppendIBFTForks_PoSCarriesLastPoAValidatorsAsBootstrap(t *testing.T) { + t.Parallel() + + poaValidators := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000002")), + ) + + cc := &chain.Chain{ + Genesis: &chain.Genesis{ + ExtraData: mustGenesisExtraWithValidators(t, poaValidators), + }, + Params: &chain.Params{ + Engine: map[string]interface{}{ + "ibft": map[string]interface{}{ + fork.KeyTypes: []interface{}{ + map[string]interface{}{ + "type": "PoA", + "validator_type": "ecdsa", + "from": 0, + "validators": []interface{}{ + map[string]interface{}{"Address": "0x1000000000000000000000000000000000000001"}, + map[string]interface{}{"Address": "0x1000000000000000000000000000000000000002"}, + }, + }, + }, + }, + }, + }, + } + + require.NoError(t, appendIBFTForks( + cc, + fork.PoS, + validators.ECDSAValidatorType, + 11, + u64ptr(10), + nil, + u64ptr(20), + u64ptr(2), + )) + + ibftConfig := cc.Params.Engine["ibft"].(map[string]interface{}) + ibftForks := ibftConfig[fork.KeyTypes].(fork.IBFTForks) + require.Len(t, ibftForks, 2) + require.Equal(t, poaValidators.Len(), ibftForks[1].Validators.Len()) + require.Equal(t, poaValidators.At(0).Addr(), ibftForks[1].Validators.At(0).Addr()) +} + +func TestAppendIBFTForks_PoSFailsWhenLastForkValidatorTypeMismatches(t *testing.T) { + t.Parallel() + + poaValidators := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1100000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1100000000000000000000000000000000000002")), + ) + + cc := &chain.Chain{ + Genesis: &chain.Genesis{ + ExtraData: mustGenesisExtraWithValidators(t, poaValidators), + }, + Params: &chain.Params{ + Engine: map[string]interface{}{ + "ibft": map[string]interface{}{ + fork.KeyTypes: []interface{}{ + map[string]interface{}{ + "type": "PoA", + "validator_type": "ecdsa", + "from": 0, + "validators": []interface{}{ + map[string]interface{}{"Address": "0x1100000000000000000000000000000000000001"}, + map[string]interface{}{"Address": "0x1100000000000000000000000000000000000002"}, + }, + }, + }, + }, + }, + }, + } + + err := appendIBFTForks( + cc, + fork.PoS, + validators.BLSValidatorType, + 11, + u64ptr(10), + nil, + u64ptr(20), + u64ptr(2), + ) + require.Error(t, err) + require.Contains(t, err.Error(), "expected validator type bls") + require.Contains(t, err.Error(), "source last-fork") + require.Contains(t, err.Error(), "type mismatch") +} + +func TestAppendIBFTForks_PoSFallsBackToGenesisExtraValidators(t *testing.T) { + t.Parallel() + + genesisValidators := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x2000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x2000000000000000000000000000000000000002")), + ) + + cc := &chain.Chain{ + Genesis: &chain.Genesis{ + ExtraData: mustGenesisExtraWithValidators(t, genesisValidators), + }, + Params: &chain.Params{ + Engine: map[string]interface{}{ + "ibft": map[string]interface{}{ + fork.KeyTypes: []interface{}{ + map[string]interface{}{ + "type": "PoA", + "validator_type": "ecdsa", + "from": 0, + }, + }, + }, + }, + }, + } + + require.NoError(t, appendIBFTForks( + cc, + fork.PoS, + validators.ECDSAValidatorType, + 5, + u64ptr(4), + nil, + u64ptr(10), + u64ptr(1), + )) + + ibftConfig := cc.Params.Engine["ibft"].(map[string]interface{}) + ibftForks := ibftConfig[fork.KeyTypes].(fork.IBFTForks) + require.Len(t, ibftForks, 2) + require.Equal(t, genesisValidators.Len(), ibftForks[1].Validators.Len()) + require.Equal(t, genesisValidators.At(1).Addr(), ibftForks[1].Validators.At(1).Addr()) +} + +func TestAppendIBFTForks_PoSWithCLIBLSValidators(t *testing.T) { + t.Parallel() + + cliValidators := validators.NewBLSValidatorSet( + validators.NewBLSValidator( + types.StringToAddress("0x3000000000000000000000000000000000000001"), + []byte{1, 2, 3}, + ), + validators.NewBLSValidator( + types.StringToAddress("0x3000000000000000000000000000000000000002"), + []byte{4, 5, 6}, + ), + ) + + cc := &chain.Chain{ + Genesis: &chain.Genesis{ + ExtraData: mustGenesisExtraWithValidators(t, validators.NewECDSAValidatorSet()), + }, + Params: &chain.Params{ + Engine: map[string]interface{}{ + "ibft": map[string]interface{}{ + fork.KeyTypes: []interface{}{ + map[string]interface{}{ + "type": "PoA", + "validator_type": "ecdsa", + "from": 0, + }, + }, + }, + }, + }, + } + + require.NoError(t, appendIBFTForks( + cc, + fork.PoS, + validators.BLSValidatorType, + 15, + u64ptr(14), + cliValidators, + u64ptr(50), + u64ptr(1), + )) + + ibftConfig := cc.Params.Engine["ibft"].(map[string]interface{}) + ibftForks := ibftConfig[fork.KeyTypes].(fork.IBFTForks) + require.Len(t, ibftForks, 2) + require.Equal(t, validators.BLSValidatorType, ibftForks[1].Validators.Type()) + require.Equal(t, cliValidators.Len(), ibftForks[1].Validators.Len()) +} + +func TestAppendIBFTForks_PoSFailsWhenGenesisExtraValidatorTypeMismatches(t *testing.T) { + t.Parallel() + + genesisECDSAValidators := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x4000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x4000000000000000000000000000000000000002")), + ) + + cc := &chain.Chain{ + Genesis: &chain.Genesis{ + ExtraData: mustGenesisExtraWithValidators(t, genesisECDSAValidators), + }, + Params: &chain.Params{ + Engine: map[string]interface{}{ + "ibft": map[string]interface{}{ + fork.KeyTypes: []interface{}{ + map[string]interface{}{ + "type": "PoA", + "validator_type": "ecdsa", + "from": 0, + }, + }, + }, + }, + }, + } + + err := appendIBFTForks( + cc, + fork.PoS, + validators.BLSValidatorType, + 7, + u64ptr(6), + nil, + u64ptr(20), + u64ptr(1), + ) + require.Error(t, err) + require.Contains(t, err.Error(), "expected validator type bls") + require.Contains(t, err.Error(), "source genesis-extra") + require.Contains(t, err.Error(), "type mismatch") +} + +func TestAppendIBFTForks_PoSRequiresBootstrapValidators(t *testing.T) { + t.Parallel() + + cc := &chain.Chain{ + Genesis: &chain.Genesis{ + ExtraData: make([]byte, signer.IstanbulExtraVanity), + }, + Params: &chain.Params{ + Engine: map[string]interface{}{ + "ibft": map[string]interface{}{ + fork.KeyTypes: []interface{}{ + map[string]interface{}{ + "type": "PoA", + "validator_type": "ecdsa", + "from": 0, + }, + }, + }, + }, + }, + } + + err := appendIBFTForks( + cc, + fork.PoS, + validators.ECDSAValidatorType, + 5, + u64ptr(4), + nil, + u64ptr(10), + u64ptr(1), + ) + require.Error(t, err) + require.Contains(t, err.Error(), "unable to determine PoS bootstrap validators") +} + +func mustGenesisExtraWithValidators(t *testing.T, vals validators.Validators) []byte { + t.Helper() + + extra := &signer.IstanbulExtra{ + Validators: vals, + ProposerSeal: []byte{}, + CommittedSeals: &signer.SerializedSeal{}, + } + + out := make([]byte, signer.IstanbulExtraVanity) + return extra.MarshalRLPTo(out) +} + +func u64ptr(v uint64) *uint64 { + return &v +} diff --git a/command/ibft/unstake/result.go b/command/ibft/unstake/result.go new file mode 100644 index 0000000..1a7ecd3 --- /dev/null +++ b/command/ibft/unstake/result.go @@ -0,0 +1,24 @@ +package unstake + +import ( + "bytes" + "fmt" + + "github.com/xgr-network/xgr-node/command/helper" +) + +type UnstakeResult struct { + Validator string `json:"validator"` + AccountStakeWei string `json:"accountStakeWei"` +} + +func (r *UnstakeResult) GetOutput() string { + var b bytes.Buffer + b.WriteString("\n[IBFT UNSTAKE]\n") + b.WriteString(helper.FormatKV([]string{ + fmt.Sprintf("Validator|%s", r.Validator), + fmt.Sprintf("Account stake (wei)|%s", r.AccountStakeWei), + })) + + return b.String() +} diff --git a/command/ibft/unstake/unstake.go b/command/ibft/unstake/unstake.go new file mode 100644 index 0000000..24f08c1 --- /dev/null +++ b/command/ibft/unstake/unstake.go @@ -0,0 +1,295 @@ +package unstake + +import ( + "encoding/hex" + "fmt" + "math/big" + "strings" + "time" + + "github.com/hashicorp/go-hclog" + "github.com/spf13/cobra" + "github.com/umbracle/ethgo" + + "github.com/xgr-network/xgr-node/command" + ibftHelper "github.com/xgr-network/xgr-node/command/ibft/helper" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + secretsHelper "github.com/xgr-network/xgr-node/helper/secrets" + "github.com/xgr-network/xgr-node/secrets" + "github.com/xgr-network/xgr-node/secrets/local" + "github.com/xgr-network/xgr-node/txrelayer" + "github.com/xgr-network/xgr-node/types" +) + +type unstakeParams struct { + jsonRPC string + config string + dataDir string + insecure bool + initKeys bool +} + +func GetCommand() *cobra.Command { + p := &unstakeParams{} + + cmd := &cobra.Command{ + Use: "unstake", + Short: "Request unstake from staking contract (unstake())", + RunE: func(cmd *cobra.Command, _ []string) error { + outputter := command.InitializeOutputter(cmd) + defer outputter.WriteOutput() + + sm, err := initSecretsManager(p) + if err != nil { + outputter.SetError(err) + return nil + } + + if p.initKeys { + if err := ensureECDSAKey(sm); err != nil { + outputter.SetError(err) + return nil + } + } + + key, err := ibftHelper.GetECDSAKeyFromSecret(sm) + if err != nil { + outputter.SetError(err) + return nil + } + + relayer, err := txrelayer.NewTxRelayer( + txrelayer.WithIPAddress(p.jsonRPC), + txrelayer.WithReceiptTimeout(250*time.Millisecond), + ) + if err != nil { + outputter.SetError(err) + return nil + } + + epochSize, err := queryEpochSize(relayer) + if err != nil { + outputter.SetError(err) + return nil + } + if epochSize == 0 { + outputter.SetError(fmt.Errorf("staking contract returned epochSize=0; staking predeploy is invalid on this chain")) + return nil + } + + if err := sendUnstake(relayer, key); err != nil { + outputter.SetError(err) + return nil + } + + onchainStake, err := queryAccountStake(relayer, types.Address(key.Address())) + if err != nil { + outputter.SetError(err) + return nil + } + + outputter.SetCommandResult(&UnstakeResult{ + Validator: types.Address(key.Address()).String(), + AccountStakeWei: onchainStake.String(), + }) + + return nil + }, + } + + setFlags(cmd, p) + cmd.Example = `# You must deactivate before unstake +xgrchain ibft set-active --value false --jsonrpc http://127.0.0.1:8545 --data-dir ./data --insecure + +# Request unstake (withdraw is a separate step) +xgrchain ibft unstake --jsonrpc http://127.0.0.1:8545 --data-dir ./data --insecure` + return cmd +} + +func setFlags(cmd *cobra.Command, p *unstakeParams) { + cmd.Flags().StringVar(&p.jsonRPC, "jsonrpc", "http://127.0.0.1:8545", "JSON-RPC endpoint") + cmd.Flags().StringVar(&p.dataDir, "data-dir", "./data", "Data directory for local secrets") + cmd.Flags().StringVar(&p.config, "config", "", "SecretsManager config file (optional)") + cmd.Flags().BoolVar(&p.insecure, "insecure", false, "Allow insecure key storage") + cmd.Flags().BoolVar(&p.initKeys, "init-keys", false, "Generate missing ECDSA key in data-dir/config") +} + +func initSecretsManager(p *unstakeParams) (secrets.SecretsManager, error) { + if p.config != "" { + cfg, err := secrets.ReadConfig(p.config) + if err != nil { + return nil, err + } + return secretsHelper.InitCloudSecretsManager(cfg) + } + + baseConfig := &secrets.SecretsManagerParams{ + Logger: hclog.NewNullLogger(), + Extra: map[string]interface{}{ + secrets.Path: p.dataDir, + }, + } + + return local.SecretsManagerFactory(nil, baseConfig) +} + +func ensureECDSAKey(sm secrets.SecretsManager) error { + if sm.HasSecret(secrets.ValidatorKey) { + return nil + } + _, err := secretsHelper.InitECDSAValidatorKey(sm) + return err +} + +func queryAccountStake(relayer txrelayer.TxRelayer, addr types.Address) (*big.Int, error) { + method := abis.StakingABI.Methods["accountStake"] + if method == nil { + return nil, fmt.Errorf("staking ABI missing accountStake") + } + inp, err := method.Inputs.Encode(map[string]interface{}{ + "account": ethgo.Address(addr), + }) + if err != nil { + return nil, err + } + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), append(method.ID(), inp...)) + if err != nil { + return nil, err + } + b, err := hexToBytes(resp) + if err != nil { + return nil, err + } + decoded, err := method.Outputs.Decode(b) + if err != nil { + return nil, err + } + m, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode accountStake: unexpected type") + } + v, ok := m["0"].(*big.Int) + if !ok { + return nil, fmt.Errorf("decode accountStake: missing value") + } + return v, nil +} + +func queryEpochSize(relayer txrelayer.TxRelayer) (uint64, error) { + method := abis.StakingABI.Methods["epochSize"] + if method == nil { + return 0, fmt.Errorf("staking ABI missing epochSize") + } + + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), method.ID()) + if err != nil { + return 0, err + } + + b, err := hexToBytes(resp) + if err != nil { + return 0, err + } + + decoded, err := method.Outputs.Decode(b) + if err != nil { + return 0, err + } + + m, ok := decoded.(map[string]interface{}) + if !ok { + return 0, fmt.Errorf("decode epochSize: unexpected type") + } + + if epoch, ok := uint64FromDecodedValue(m["0"]); ok { + return epoch, nil + } + if epoch, ok := uint64FromDecodedValue(m["epochSize"]); ok { + return epoch, nil + } + for _, value := range m { + if epoch, ok := uint64FromDecodedValue(value); ok { + return epoch, nil + } + } + + return 0, fmt.Errorf("decode epochSize: missing value") +} + +func uint64FromDecodedValue(v interface{}) (uint64, bool) { + switch x := v.(type) { + case *big.Int: + if x == nil { + return 0, false + } + return x.Uint64(), true + case uint64: + return x, true + case uint32: + return uint64(x), true + case int: + if x < 0 { + return 0, false + } + return uint64(x), true + } + + return 0, false +} + +func sendUnstake(relayer txrelayer.TxRelayer, key ethgo.Key) error { + m := abis.StakingABI.Methods["unstake"] + if m == nil { + return fmt.Errorf("staking ABI missing unstake") + } + to := ethgo.Address(staking.AddrStakingContract) + + // Preflight call from validator address to surface deterministic revert reasons + // before gas estimation/sending wraps the node error. + if key != nil { + if _, err := relayer.Call(key.Address(), to, m.ID()); err != nil { + return mapUnstakeError(err) + } + } + + tx := ðgo.Transaction{ + To: &to, + Input: m.ID(), + Type: ethgo.TransactionDynamicFee, + } + receipt, err := relayer.SendTransaction(tx, key) + if err != nil { + return mapUnstakeError(err) + } + if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { + return fmt.Errorf("unstake reverted") + } + return nil +} + +func mapUnstakeError(err error) error { + if err == nil { + return nil + } + msg := err.Error() + if strings.Contains(msg, "0x34637cc9") { + return fmt.Errorf("unstake rejected: validator must be deactivated first (run: xgrchain ibft set-active --value false)") + } + if strings.Contains(msg, "0x4e487b71") && strings.Contains(msg, "00000012") { + return fmt.Errorf("unstake rejected: staking contract panic 0x12 (division/modulo by zero). likely epochSize=0 in staking contract state") + } + if strings.Contains(msg, "0x4e487b71") { + return fmt.Errorf("unstake rejected: staking contract panic during unstake (panic selector 0x4e487b71): %w", err) + } + + return fmt.Errorf("unstake tx failed: %w", err) +} + +func hexToBytes(s string) ([]byte, error) { + s = strings.TrimPrefix(s, "0x") + if s == "" { + return []byte{}, nil + } + return hex.DecodeString(s) +} diff --git a/command/ibft/unstake/unstake_test.go b/command/ibft/unstake/unstake_test.go new file mode 100644 index 0000000..1129e4f --- /dev/null +++ b/command/ibft/unstake/unstake_test.go @@ -0,0 +1,72 @@ +package unstake + +import ( + "encoding/hex" + "errors" + "math/big" + "strings" + "testing" + + "github.com/umbracle/ethgo" + "github.com/umbracle/ethgo/jsonrpc" + "github.com/xgr-network/xgr-node/contracts/abis" +) + +type mockRelayer struct { + callResp string + callErr error + sendReceipt *ethgo.Receipt + sendErr error +} + +func (m *mockRelayer) Call(ethgo.Address, ethgo.Address, []byte) (string, error) { + return m.callResp, m.callErr +} + +func (m *mockRelayer) SendTransaction(*ethgo.Transaction, ethgo.Key) (*ethgo.Receipt, error) { + return m.sendReceipt, m.sendErr +} + +func (m *mockRelayer) SendTransactionLocal(*ethgo.Transaction) (*ethgo.Receipt, error) { + return nil, nil +} + +func (m *mockRelayer) Client() *jsonrpc.Client { return nil } + +func TestQueryEpochSize(t *testing.T) { + method := abis.StakingABI.Methods["epochSize"] + enc, err := method.Outputs.Encode(map[string]interface{}{"0": big.NewInt(500)}) + if err != nil { + t.Fatalf("encode failed: %v", err) + } + + epochSize, err := queryEpochSize(&mockRelayer{callResp: "0x" + hex.EncodeToString(enc)}) + if err != nil { + t.Fatalf("unexpected error: %v", err) + } + + if epochSize != 500 { + t.Fatalf("expected epoch size 500, got %d", epochSize) + } +} + +func TestSendUnstake_Panic12Message(t *testing.T) { + err := sendUnstake(&mockRelayer{sendErr: errors.New("execution reverted data:0x4e487b710000000000000000000000000000000000000000000000000000000000000012")}, nil) + if err == nil { + t.Fatal("expected error") + } + + if !strings.Contains(err.Error(), "panic 0x12") { + t.Fatalf("unexpected error: %v", err) + } +} + +func TestMapUnstakeError_PanicSelectorGeneric(t *testing.T) { + err := mapUnstakeError(errors.New("execution reverted: 0x4e487b71")) + if err == nil { + t.Fatal("expected error") + } + if !strings.Contains(err.Error(), "panic selector 0x4e487b71") { + t.Fatalf("unexpected error: %v", err) + } +} diff --git a/command/ibft/validators/result.go b/command/ibft/validators/result.go new file mode 100644 index 0000000..3b87d2d --- /dev/null +++ b/command/ibft/validators/result.go @@ -0,0 +1,46 @@ +package validators + +import ( + "bytes" + "fmt" + + "github.com/xgr-network/xgr-node/command/helper" +) + +type ValidatorRow struct { + Address string `json:"address"` + StakeWei string `json:"stakeWei"` + BLSPubKeyHex string `json:"blsPubKeyHex,omitempty"` +} + +type ValidatorsResult struct { + MinValidatorCount string `json:"minValidatorCount"` + MaxValidatorCount string `json:"maxValidatorCount"` + ValidatorThresholdWei string `json:"validatorThresholdWei"` + Validators []ValidatorRow `json:"validators"` +} + +func (r *ValidatorsResult) GetOutput() string { + var b bytes.Buffer + + b.WriteString("\n[IBFT VALIDATORS]\n") + b.WriteString(helper.FormatKV([]string{ + fmt.Sprintf("Min validator count|%s", r.MinValidatorCount), + fmt.Sprintf("Max validator count|%s", r.MaxValidatorCount), + fmt.Sprintf("Validator threshold (wei)|%s", r.ValidatorThresholdWei), + })) + + for i, v := range r.Validators { + rows := []string{ + fmt.Sprintf("Validator %d address|%s", i, v.Address), + fmt.Sprintf("Validator %d stake (wei)|%s", i, v.StakeWei), + } + if v.BLSPubKeyHex != "" { + rows = append(rows, fmt.Sprintf("Validator %d BLS pubkey|%s", i, v.BLSPubKeyHex)) + } + b.WriteString("\n") + b.WriteString(helper.FormatKV(rows)) + } + + return b.String() +} diff --git a/command/ibft/validators/validators.go b/command/ibft/validators/validators.go new file mode 100644 index 0000000..eec94e6 --- /dev/null +++ b/command/ibft/validators/validators.go @@ -0,0 +1,330 @@ +package validators + +import ( + "encoding/hex" + "fmt" + "math/big" + "reflect" + "strings" + + "github.com/spf13/cobra" + "github.com/umbracle/ethgo" + "github.com/umbracle/ethgo/abi" + + "github.com/xgr-network/xgr-node/command" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/txrelayer" + "github.com/xgr-network/xgr-node/types" +) + +type params struct { + jsonRPC string +} + +func GetCommand() *cobra.Command { + p := ¶ms{} + + cmd := &cobra.Command{ + Use: "validators", + Short: "Show staking contract validator set and stake balances", + RunE: func(cmd *cobra.Command, _ []string) error { + outputter := command.InitializeOutputter(cmd) + defer outputter.WriteOutput() + + relayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(p.jsonRPC)) + if err != nil { + outputter.SetError(err) + return nil + } + + minV, err := callUint(relayer, "minNumValidators") + if err != nil { + outputter.SetError(fmt.Errorf("failed to query minNumValidators: %w", err)) + return nil + } + + maxV, err := callUint(relayer, "maxNumValidators") + if err != nil { + outputter.SetError(fmt.Errorf("failed to query maxNumValidators: %w", err)) + return nil + } + + thr, err := callUint(relayer, "VALIDATOR_THRESHOLD") + if err != nil { + outputter.SetError(fmt.Errorf("failed to query VALIDATOR_THRESHOLD: %w", err)) + return nil + } + + addrs, err := callAddresses(relayer, "validators") + if err != nil { + outputter.SetError(err) + return nil + } + + bls, _ := callBytesArray(relayer, "validatorBLSPublicKeys") + + rows := make([]ValidatorRow, 0, len(addrs)) + for i, a := range addrs { + stakeAmt, err := callAccountStake(relayer, a) + if err != nil { + outputter.SetError(err) + return nil + } + + row := ValidatorRow{ + Address: a.String(), + StakeWei: stakeAmt.String(), + } + if i < len(bls) { + row.BLSPubKeyHex = "0x" + hex.EncodeToString(bls[i]) + } + rows = append(rows, row) + } + + outputter.SetCommandResult(&ValidatorsResult{ + MinValidatorCount: minV.String(), + MaxValidatorCount: maxV.String(), + ValidatorThresholdWei: thr.String(), + Validators: rows, + }) + return nil + }, + } + + cmd.Flags().StringVar(&p.jsonRPC, "jsonrpc", "http://127.0.0.1:8545", "JSON-RPC endpoint") + return cmd +} + +func callBytes(relayer txrelayer.TxRelayer, method string, input []byte) ([]byte, error) { + m := abis.StakingABI.Methods[method] + if m == nil { + return nil, fmt.Errorf("staking ABI missing %s", method) + } + + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), input) + if err != nil { + return nil, err + } + + b, err := hexToBytes(resp) + if err != nil { + return nil, err + } + return b, nil +} + +func callUint(relayer txrelayer.TxRelayer, method string) (*big.Int, error) { + m := abis.StakingABI.Methods[method] + if m == nil { + return nil, fmt.Errorf("staking ABI missing %s", method) + } + b, err := callBytes(relayer, method, m.ID()) + if err != nil { + return nil, err + } + decoded, err := m.Outputs.Decode(b) + if err != nil { + return nil, err + } + mp, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode %s: unexpected type", method) + } + v, ok := asBigInt(mp["0"]) + if !ok { + return nil, fmt.Errorf("decode %s: missing value", method) + } + + return v, nil +} + +func asBigInt(val interface{}) (*big.Int, bool) { + switch v := val.(type) { + case *big.Int: + if v == nil { + return nil, false + } + + return v, true + case uint64: + return new(big.Int).SetUint64(v), true + case uint32: + return new(big.Int).SetUint64(uint64(v)), true + case uint16: + return new(big.Int).SetUint64(uint64(v)), true + case uint8: + return new(big.Int).SetUint64(uint64(v)), true + default: + return nil, false + } +} + +func callAddresses(relayer txrelayer.TxRelayer, method string) ([]types.Address, error) { + m := abis.StakingABI.Methods[method] + if m == nil { + return nil, fmt.Errorf("staking ABI missing %s", method) + } + b, err := callBytes(relayer, method, m.ID()) + if err != nil { + return nil, err + } + decoded, err := m.Outputs.Decode(b) + if err != nil { + return nil, err + } + mp, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode %s: unexpected type", method) + } + wa, ok := mp["0"].([]ethgo.Address) + if !ok { + return nil, fmt.Errorf("decode %s: unexpected array type", method) + } + out := make([]types.Address, len(wa)) + for i := range wa { + out[i] = types.Address(wa[i]) + } + return out, nil +} + +func callBytesArray(relayer txrelayer.TxRelayer, method string) ([][]byte, error) { + m := abis.StakingABI.Methods[method] + if m == nil { + return nil, fmt.Errorf("staking ABI missing %s", method) + } + b, err := callBytes(relayer, method, m.ID()) + if err != nil { + return nil, err + } + decoded, err := m.Outputs.Decode(b) + if err != nil { + return nil, err + } + arrRaw, err := firstOutputValue(m, decoded) + if err != nil { + return nil, fmt.Errorf("decode %s: %w", method, err) + } + arr, err := decodeBytesArray(arrRaw) + if err != nil { + return nil, fmt.Errorf("decode %s: %w", method, err) + } + return arr, nil +} + +func firstOutputValue(method *abi.Method, decoded interface{}) (interface{}, error) { + mp, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("unexpected type") + } + + if val, ok := mp["0"]; ok { + return val, nil + } + + outputs := method.Outputs.TupleElems() + if len(outputs) > 0 { + if name := outputs[0].Name; name != "" { + if val, ok := mp[name]; ok { + return val, nil + } + } + } + + if len(mp) == 1 { + for _, val := range mp { + return val, nil + } + } + + return nil, fmt.Errorf("missing output value") +} + +func decodeBytesArray(raw interface{}) ([][]byte, error) { + v := reflect.ValueOf(raw) + if !v.IsValid() { + return nil, fmt.Errorf("unexpected bytes[] type") + } + if v.Kind() != reflect.Slice && v.Kind() != reflect.Array { + return nil, fmt.Errorf("unexpected bytes[] type") + } + + out := make([][]byte, 0, v.Len()) + for i := 0; i < v.Len(); i++ { + b, err := toBytes(v.Index(i).Interface()) + if err != nil { + return nil, err + } + out = append(out, b) + } + + return out, nil +} + +func toBytes(raw interface{}) ([]byte, error) { + switch v := raw.(type) { + case []byte: + return v, nil + case string: + b, err := hexToBytes(v) + if err != nil { + return nil, fmt.Errorf("invalid hex value") + } + + return b, nil + } + + rv := reflect.ValueOf(raw) + if !rv.IsValid() { + return nil, fmt.Errorf("unexpected item type") + } + + kind := rv.Kind() + if kind == reflect.Array || kind == reflect.Slice { + if rv.Type().Elem().Kind() == reflect.Uint8 { + b := make([]byte, rv.Len()) + for i := 0; i < rv.Len(); i++ { + b[i] = byte(rv.Index(i).Uint()) + } + + return b, nil + } + } + + return nil, fmt.Errorf("unexpected item type") +} +func callAccountStake(relayer txrelayer.TxRelayer, addr types.Address) (*big.Int, error) { + m := abis.StakingABI.Methods["accountStake"] + if m == nil { + return nil, fmt.Errorf("staking ABI missing accountStake") + } + inp, err := m.Inputs.Encode(map[string]interface{}{"account": ethgo.Address(addr)}) + if err != nil { + return nil, err + } + b, err := callBytes(relayer, "accountStake", append(m.ID(), inp...)) + if err != nil { + return nil, err + } + decoded, err := m.Outputs.Decode(b) + if err != nil { + return nil, err + } + mp, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode accountStake: unexpected type") + } + v, ok := mp["0"].(*big.Int) + if !ok { + return nil, fmt.Errorf("decode accountStake: missing value") + } + return v, nil +} + +func hexToBytes(s string) ([]byte, error) { + s = strings.TrimPrefix(s, "0x") + if s == "" { + return []byte{}, nil + } + return hex.DecodeString(s) +} diff --git a/command/ibft/validators/validators_decode_test.go b/command/ibft/validators/validators_decode_test.go new file mode 100644 index 0000000..7682809 --- /dev/null +++ b/command/ibft/validators/validators_decode_test.go @@ -0,0 +1,63 @@ +package validators + +import ( + "reflect" + "testing" + + "github.com/xgr-network/xgr-node/contracts/abis" +) + +func TestDecodeBytesArray(t *testing.T) { + t.Parallel() + + tests := []struct { + name string + raw interface{} + want [][]byte + wantErr bool + }{ + {name: "native bytes", raw: [][]byte{{0x01}, {0x02, 0x03}}, want: [][]byte{{0x01}, {0x02, 0x03}}}, + {name: "hex string array", raw: []string{"0x01", "0203"}, want: [][]byte{{0x01}, {0x02, 0x03}}}, + {name: "fixed byte arrays", raw: [][2]byte{{0x01, 0x02}, {0x03, 0x04}}, want: [][]byte{{0x01, 0x02}, {0x03, 0x04}}}, + {name: "interface fixed array", raw: []interface{}{[2]byte{0x01, 0x02}}, want: [][]byte{{0x01, 0x02}}}, + {name: "unexpected item", raw: []interface{}{123}, wantErr: true}, + } + + for _, tt := range tests { + tt := tt + t.Run(tt.name, func(t *testing.T) { + t.Parallel() + got, err := decodeBytesArray(tt.raw) + if tt.wantErr { + if err == nil { + t.Fatalf("expected error") + } + return + } + if err != nil { + t.Fatalf("decodeBytesArray() error = %v", err) + } + if !reflect.DeepEqual(got, tt.want) { + t.Fatalf("decodeBytesArray() = %v, want %v", got, tt.want) + } + }) + } +} + +func TestFirstOutputValue(t *testing.T) { + t.Parallel() + + m := abis.StakingABI.Methods["validatorBLSPublicKeys"] + if m == nil { + t.Fatal("missing method") + } + + val, err := firstOutputValue(m, map[string]interface{}{"keys": []string{"0x01"}}) + if err != nil { + t.Fatalf("firstOutputValue() error = %v", err) + } + + if _, ok := val.([]string); !ok { + t.Fatalf("firstOutputValue() returned unexpected type %T", val) + } +} diff --git a/command/ibft/withdraw/result.go b/command/ibft/withdraw/result.go new file mode 100644 index 0000000..099c1b3 --- /dev/null +++ b/command/ibft/withdraw/result.go @@ -0,0 +1,26 @@ +package withdraw + +import ( + "bytes" + "fmt" + + "github.com/xgr-network/xgr-node/command/helper" +) + +type WithdrawResult struct { + Validator string `json:"validator"` + AmountWei string `json:"amountWei"` + AccountStakeWei string `json:"accountStakeWei"` +} + +func (r *WithdrawResult) GetOutput() string { + var b bytes.Buffer + b.WriteString("\n[IBFT WITHDRAW]\n") + b.WriteString(helper.FormatKV([]string{ + fmt.Sprintf("Validator|%s", r.Validator), + fmt.Sprintf("Amount (wei)|%s", r.AmountWei), + fmt.Sprintf("Account stake (wei)|%s", r.AccountStakeWei), + })) + + return b.String() +} diff --git a/command/ibft/withdraw/withdraw.go b/command/ibft/withdraw/withdraw.go new file mode 100644 index 0000000..3e9d31c --- /dev/null +++ b/command/ibft/withdraw/withdraw.go @@ -0,0 +1,268 @@ +package withdraw + +import ( + "encoding/hex" + "fmt" + "math/big" + "strings" + "time" + + "github.com/hashicorp/go-hclog" + "github.com/spf13/cobra" + "github.com/umbracle/ethgo" + + "github.com/xgr-network/xgr-node/command" + ibftHelper "github.com/xgr-network/xgr-node/command/ibft/helper" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + secretsHelper "github.com/xgr-network/xgr-node/helper/secrets" + "github.com/xgr-network/xgr-node/secrets" + "github.com/xgr-network/xgr-node/secrets/local" + "github.com/xgr-network/xgr-node/txrelayer" + "github.com/xgr-network/xgr-node/types" +) + +type withdrawParams struct { + jsonRPC string + config string + dataDir string + insecure bool + initKeys bool + + amountStr string + decimals int +} + +func GetCommand() *cobra.Command { + p := &withdrawParams{} + + cmd := &cobra.Command{ + Use: "withdraw", + Short: "Withdraw unstaked funds from staking contract (withdraw(uint256))", + RunE: func(cmd *cobra.Command, _ []string) error { + outputter := command.InitializeOutputter(cmd) + defer outputter.WriteOutput() + + sm, err := initSecretsManager(p) + if err != nil { + outputter.SetError(err) + return nil + } + + if p.initKeys { + if err := ensureECDSAKey(sm); err != nil { + outputter.SetError(err) + return nil + } + } + + key, err := ibftHelper.GetECDSAKeyFromSecret(sm) + if err != nil { + outputter.SetError(err) + return nil + } + + relayer, err := txrelayer.NewTxRelayer( + txrelayer.WithIPAddress(p.jsonRPC), + txrelayer.WithReceiptTimeout(250*time.Millisecond), + ) + if err != nil { + outputter.SetError(err) + return nil + } + + amountWei, err := toWei(p.amountStr, p.decimals) + if err != nil { + outputter.SetError(err) + return nil + } + if amountWei.Sign() <= 0 { + outputter.SetError(fmt.Errorf("amount must be > 0")) + return nil + } + + if err := sendWithdraw(relayer, key, amountWei); err != nil { + outputter.SetError(err) + return nil + } + + onchainStake, err := queryAccountStake(relayer, types.Address(key.Address())) + if err != nil { + outputter.SetError(err) + return nil + } + + outputter.SetCommandResult(&WithdrawResult{ + Validator: types.Address(key.Address()).String(), + AmountWei: amountWei.String(), + AccountStakeWei: onchainStake.String(), + }) + + return nil + }, + } + + setFlags(cmd, p) + + cmd.Example = `# Partial withdraw from stake (keeps validator in staking contract) +# Preconditions: validator is deactivated and remaining stake after withdraw stays >= MIN_STAKE +xgrchain ibft set-active --value false --jsonrpc http://127.0.0.1:8545 --data-dir ./data --insecure +xgrchain ibft withdraw --amount 1000000 --jsonrpc http://127.0.0.1:8545 --data-dir ./data --insecure + +# Full exit uses unstake (transfers full stake and removes validator metadata) +xgrchain ibft unstake --jsonrpc http://127.0.0.1:8545 --data-dir ./data --insecure` + + return cmd +} + +func setFlags(cmd *cobra.Command, p *withdrawParams) { + cmd.Flags().StringVar(&p.jsonRPC, "jsonrpc", "http://127.0.0.1:8545", "JSON-RPC endpoint") + cmd.Flags().StringVar(&p.dataDir, "data-dir", "./data", "Data directory for local secrets") + cmd.Flags().StringVar(&p.config, "config", "", "SecretsManager config file (optional)") + cmd.Flags().BoolVar(&p.insecure, "insecure", false, "Allow insecure key storage") + cmd.Flags().BoolVar(&p.initKeys, "init-keys", false, "Generate missing ECDSA key in data-dir/config") + + cmd.Flags().StringVar(&p.amountStr, "amount", "0", "Withdraw amount (integer, in token units)") + cmd.Flags().IntVar(&p.decimals, "decimals", 18, "Token decimals") + _ = cmd.MarkFlagRequired("amount") +} + +func initSecretsManager(p *withdrawParams) (secrets.SecretsManager, error) { + if p.config != "" { + cfg, err := secrets.ReadConfig(p.config) + if err != nil { + return nil, err + } + return secretsHelper.InitCloudSecretsManager(cfg) + } + + baseConfig := &secrets.SecretsManagerParams{ + Logger: hclog.NewNullLogger(), + Extra: map[string]interface{}{ + secrets.Path: p.dataDir, + }, + } + + return local.SecretsManagerFactory(nil, baseConfig) +} + +func ensureECDSAKey(sm secrets.SecretsManager) error { + if sm.HasSecret(secrets.ValidatorKey) { + return nil + } + _, err := secretsHelper.InitECDSAValidatorKey(sm) + return err +} + +func toWei(amountStr string, decimals int) (*big.Int, error) { + if decimals < 0 { + return nil, fmt.Errorf("decimals must be >= 0") + } + + a, ok := new(big.Int).SetString(amountStr, 10) + if !ok { + return nil, fmt.Errorf("invalid amount %q", amountStr) + } + + m := new(big.Int).Exp(big.NewInt(10), big.NewInt(int64(decimals)), nil) + return new(big.Int).Mul(a, m), nil +} + +func queryAccountStake(relayer txrelayer.TxRelayer, addr types.Address) (*big.Int, error) { + method := abis.StakingABI.Methods["accountStake"] + if method == nil { + return nil, fmt.Errorf("staking ABI missing accountStake") + } + inp, err := method.Inputs.Encode(map[string]interface{}{ + "account": ethgo.Address(addr), + }) + if err != nil { + return nil, err + } + resp, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(staking.AddrStakingContract), append(method.ID(), inp...)) + if err != nil { + return nil, err + } + b, err := hexToBytes(resp) + if err != nil { + return nil, err + } + decoded, err := method.Outputs.Decode(b) + if err != nil { + return nil, err + } + m, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode accountStake: unexpected type") + } + v, ok := m["0"].(*big.Int) + if !ok { + return nil, fmt.Errorf("decode accountStake: missing value") + } + return v, nil +} + +func sendWithdraw(relayer txrelayer.TxRelayer, key ethgo.Key, amountWei *big.Int) error { + m := abis.StakingABI.Methods["withdraw"] + if m == nil { + return fmt.Errorf("staking ABI missing withdraw") + } + inp, err := m.Inputs.Encode(map[string]interface{}{"amount": amountWei}) + if err != nil { + return fmt.Errorf("encode withdraw input failed: %w", err) + } + + to := ethgo.Address(staking.AddrStakingContract) + + // Preflight call from validator address to surface deterministic revert reasons + // before gas estimation/sending wraps node-side execution errors. + if key != nil { + if _, err := relayer.Call(key.Address(), to, append(m.ID(), inp...)); err != nil { + return mapWithdrawError(err) + } + } + + tx := ðgo.Transaction{ + To: &to, + Input: append(m.ID(), inp...), + Type: ethgo.TransactionDynamicFee, + } + receipt, err := relayer.SendTransaction(tx, key) + if err != nil { + return mapWithdrawError(err) + } + if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { + return fmt.Errorf("withdraw reverted") + } + return nil +} + +func mapWithdrawError(err error) error { + if err == nil { + return nil + } + + msg := err.Error() + switch { + case strings.Contains(msg, "0x34637cc9"): + return fmt.Errorf("withdraw rejected: validator must be deactivated first and epoch transition must pass (run: xgrchain ibft set-active --value false, then wait next epoch)") + case strings.Contains(msg, "0x5c940c69"): + return fmt.Errorf("withdraw rejected: too early after deactivation (wait until next epoch)") + case strings.Contains(msg, "0x6eda21dd"): + return fmt.Errorf("withdraw rejected: remaining stake would fall below MIN_STAKE (2,000,000 XGR)") + case strings.Contains(msg, "0xdb73cdf0"): + return fmt.Errorf("withdraw rejected: invalid amount (must be > 0 and less than current stake)") + case strings.Contains(msg, "0x580e542f"): + return fmt.Errorf("withdraw rejected: validator not found in staking contract") + default: + return fmt.Errorf("withdraw tx failed: %w", err) + } +} + +func hexToBytes(s string) ([]byte, error) { + s = strings.TrimPrefix(s, "0x") + if s == "" { + return []byte{}, nil + } + return hex.DecodeString(s) +} diff --git a/command/ibft/withdraw/withdraw_test.go b/command/ibft/withdraw/withdraw_test.go new file mode 100644 index 0000000..2ee8581 --- /dev/null +++ b/command/ibft/withdraw/withdraw_test.go @@ -0,0 +1,80 @@ +package withdraw + +import ( + "errors" + "strings" + "testing" +) + +func TestToWei(t *testing.T) { + v, err := toWei("123", 2) + if err != nil { + t.Fatalf("unexpected error: %v", err) + } + if got := v.String(); got != "12300" { + t.Fatalf("expected 12300, got %s", got) + } +} + +func TestToWei_InvalidAmount(t *testing.T) { + if _, err := toWei("abc", 18); err == nil { + t.Fatal("expected error for invalid amount") + } +} + +func TestToWei_InvalidDecimals(t *testing.T) { + if _, err := toWei("1", -1); err == nil { + t.Fatal("expected error for invalid decimals") + } +} + +func TestMapWithdrawError_KnownSelectors(t *testing.T) { + tests := []struct { + name string + err error + want string + }{ + { + name: "must deactivate", + err: errors.New(`execution reverted","data":"0x34637cc9"`), + want: "must be deactivated first", + }, + { + name: "too early", + err: errors.New(`execution reverted","data":"0x5c940c69"`), + want: "too early after deactivation", + }, + { + name: "below min stake", + err: errors.New(`execution reverted","data":"0x6eda21dd"`), + want: "below MIN_STAKE", + }, + { + name: "invalid amount", + err: errors.New(`execution reverted","data":"0xdb73cdf0"`), + want: "invalid amount", + }, + { + name: "validator missing", + err: errors.New(`execution reverted","data":"0x580e542f"`), + want: "validator not found", + }, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + got := mapWithdrawError(tt.err) + if got == nil || !strings.Contains(got.Error(), tt.want) { + t.Fatalf("expected %q in error, got %v", tt.want, got) + } + }) + } +} + +func TestMapWithdrawError_Fallback(t *testing.T) { + err := errors.New("some other rpc failure") + got := mapWithdrawError(err) + if got == nil || !strings.Contains(got.Error(), "withdraw tx failed") { + t.Fatalf("expected wrapped withdraw tx failed error, got %v", got) + } +} diff --git a/command/polybft/polybft_command.go b/command/polybft/polybft_command.go deleted file mode 100644 index fc6d6b5..0000000 --- a/command/polybft/polybft_command.go +++ /dev/null @@ -1,48 +0,0 @@ -package polybft - -import ( - "github.com/spf13/cobra" - "github.com/xgr-network/xgr-node/command/rootchain/registration" - "github.com/xgr-network/xgr-node/command/rootchain/staking" - "github.com/xgr-network/xgr-node/command/rootchain/supernet" - "github.com/xgr-network/xgr-node/command/rootchain/supernet/stakemanager" - "github.com/xgr-network/xgr-node/command/rootchain/validators" - "github.com/xgr-network/xgr-node/command/rootchain/whitelist" - "github.com/xgr-network/xgr-node/command/rootchain/withdraw" - "github.com/xgr-network/xgr-node/command/sidechain/rewards" - "github.com/xgr-network/xgr-node/command/sidechain/unstaking" - sidechainWithdraw "github.com/xgr-network/xgr-node/command/sidechain/withdraw" -) - -func GetCommand() *cobra.Command { - polybftCmd := &cobra.Command{ - Use: "polybft", - Short: "Polybft command", - } - - polybftCmd.AddCommand( - // sidechain (validator set) command to unstake on child chain - unstaking.GetCommand(), - // sidechain (validator set) command to withdraw stake on child chain - sidechainWithdraw.GetCommand(), - // sidechain (reward pool) command to withdraw pending rewards - rewards.GetCommand(), - // rootchain (stake manager) command to withdraw stake - withdraw.GetCommand(), - // rootchain (supernet manager) command that queries validator info - validators.GetCommand(), - // rootchain (supernet manager) whitelist validator - whitelist.GetCommand(), - // rootchain (supernet manager) register validator - registration.GetCommand(), - // rootchain (stake manager) stake command - staking.GetCommand(), - // rootchain (supernet manager) command for finalizing genesis - // validator set and enabling staking - supernet.GetCommand(), - // rootchain command for deploying stake manager - stakemanager.GetCommand(), - ) - - return polybftCmd -} diff --git a/command/polybftsecrets/params.go b/command/polybftsecrets/params.go deleted file mode 100644 index b540f0b..0000000 --- a/command/polybftsecrets/params.go +++ /dev/null @@ -1,242 +0,0 @@ -package polybftsecrets - -import ( - "encoding/hex" - "fmt" - "strings" - - "github.com/spf13/cobra" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/secrets" - "github.com/xgr-network/xgr-node/secrets/helper" - "github.com/xgr-network/xgr-node/types" -) - -const ( - accountFlag = "account" - privateKeyFlag = "private" - insecureLocalStoreFlag = "insecure" - networkFlag = "network" - numFlag = "num" - outputFlag = "output" - - // maxInitNum is the maximum value for "num" flag - maxInitNum = 30 -) - -type initParams struct { - accountDir string - accountConfig string - - generatesAccount bool - generatesNetwork bool - - printPrivateKey bool - - numberOfSecrets int - - insecureLocalStore bool - - output bool -} - -func (ip *initParams) validateFlags() error { - if ip.numberOfSecrets < 1 || ip.numberOfSecrets > maxInitNum { - return ErrInvalidNum - } - - if ip.accountDir == "" && ip.accountConfig == "" { - return ErrInvalidParams - } - - return nil -} - -func (ip *initParams) setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - &ip.accountDir, - AccountDirFlag, - "", - AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - &ip.accountConfig, - AccountConfigFlag, - "", - AccountConfigFlagDesc, - ) - - cmd.Flags().IntVar( - &ip.numberOfSecrets, - numFlag, - 1, - "the flag indicating how many secrets should be created, only for the local FS", - ) - - // Don't accept data-dir and config flags because they are related to different secrets managers. - // data-dir is about the local FS as secrets storage, config is about remote secrets manager. - cmd.MarkFlagsMutuallyExclusive(AccountDirFlag, AccountConfigFlag) - - // num flag should be used with data-dir flag only so it should not be used with config flag. - cmd.MarkFlagsMutuallyExclusive(numFlag, AccountConfigFlag) - - cmd.Flags().BoolVar( - &ip.generatesAccount, - accountFlag, - true, - "the flag indicating whether new account is created", - ) - - cmd.Flags().BoolVar( - &ip.generatesNetwork, - networkFlag, - true, - "the flag indicating whether new Network key is created", - ) - - cmd.Flags().BoolVar( - &ip.printPrivateKey, - privateKeyFlag, - false, - "the flag indicating whether Private key is printed", - ) - - cmd.Flags().BoolVar( - &ip.insecureLocalStore, - insecureLocalStoreFlag, - false, - "the flag indicating should the secrets stored on the local storage be encrypted", - ) - - cmd.Flags().BoolVar( - &ip.output, - outputFlag, - false, - "the flag indicating to output existing secrets", - ) -} - -func (ip *initParams) Execute() (Results, error) { - results := make(Results, ip.numberOfSecrets) - - for i := 0; i < ip.numberOfSecrets; i++ { - configDir, dataDir := ip.accountConfig, ip.accountDir - - if ip.numberOfSecrets > 1 { - dataDir = fmt.Sprintf("%s%d", ip.accountDir, i+1) - } - - if configDir != "" && ip.numberOfSecrets > 1 { - configDir = fmt.Sprintf("%s%d", ip.accountConfig, i+1) - } - - secretManager, err := GetSecretsManager(dataDir, configDir, ip.insecureLocalStore) - if err != nil { - return results, err - } - - var gen []string - if !ip.output { - gen, err = ip.initKeys(secretManager) - if err != nil { - return results, err - } - } - - res, err := ip.getResult(secretManager, gen) - if err != nil { - return results, err - } - - results[i] = res - } - - return results, nil -} - -func (ip *initParams) initKeys(secretsManager secrets.SecretsManager) ([]string, error) { - var generated []string - - if ip.generatesNetwork { - if !secretsManager.HasSecret(secrets.NetworkKey) { - if _, err := helper.InitNetworkingPrivateKey(secretsManager); err != nil { - return generated, fmt.Errorf("error initializing network-key: %w", err) - } - - generated = append(generated, secrets.NetworkKey) - } - } - - if ip.generatesAccount { - var ( - a *wallet.Account - err error - ) - - if !secretsManager.HasSecret(secrets.ValidatorKey) && !secretsManager.HasSecret(secrets.ValidatorBLSKey) { - a, err = wallet.GenerateAccount() - if err != nil { - return generated, fmt.Errorf("error generating account: %w", err) - } - - if err = a.Save(secretsManager); err != nil { - return generated, fmt.Errorf("error saving account: %w", err) - } - - generated = append(generated, secrets.ValidatorKey, secrets.ValidatorBLSKey) - } - } - - return generated, nil -} - -// getResult gets keys from secret manager and return result to display -func (ip *initParams) getResult( - secretsManager secrets.SecretsManager, - generated []string, -) (command.CommandResult, error) { - var ( - res = &SecretsInitResult{} - err error - ) - - if ip.generatesAccount { - account, err := wallet.NewAccountFromSecret(secretsManager) - if err != nil { - return nil, err - } - - res.Address = types.Address(account.Ecdsa.Address()) - res.BLSPubkey = hex.EncodeToString(account.Bls.PublicKey().Marshal()) - - res.Generated = strings.Join(generated, ", ") - - if ip.printPrivateKey { - pk, err := account.Ecdsa.MarshallPrivateKey() - if err != nil { - return nil, err - } - - res.PrivateKey = hex.EncodeToString(pk) - - blspk, err := account.Bls.Marshal() - if err != nil { - return nil, err - } - - res.BLSPrivateKey = string(blspk) - } - } - - if ip.generatesNetwork { - if res.NodeID, err = helper.LoadNodeID(secretsManager); err != nil { - return nil, err - } - } - - res.Insecure = ip.insecureLocalStore - - return res, nil -} diff --git a/command/polybftsecrets/params_test.go b/command/polybftsecrets/params_test.go deleted file mode 100644 index 4abb389..0000000 --- a/command/polybftsecrets/params_test.go +++ /dev/null @@ -1,109 +0,0 @@ -package polybftsecrets - -import ( - "encoding/hex" - "os" - "path" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo/wallet" - - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/secrets/helper" -) - -// Test initKeys -func Test_initKeys(t *testing.T) { - t.Parallel() - - // Creates test directory - dir, err := os.MkdirTemp("", "test") - require.NoError(t, err) - - defer os.RemoveAll(dir) - - sm, err := helper.SetupLocalSecretsManager(dir) - require.NoError(t, err) - - ip := &initParams{ - generatesAccount: false, - generatesNetwork: false, - } - - _, err = ip.initKeys(sm) - require.NoError(t, err) - - assert.False(t, fileExists(path.Join(dir, "consensus/validator.key"))) - assert.False(t, fileExists(path.Join(dir, "consensus/validator-bls.key"))) - assert.False(t, fileExists(path.Join(dir, "libp2p/libp2p.key"))) - - ip.generatesAccount = true - res, err := ip.initKeys(sm) - require.NoError(t, err) - assert.Len(t, res, 2) - - assert.True(t, fileExists(path.Join(dir, "consensus/validator.key"))) - assert.True(t, fileExists(path.Join(dir, "consensus/validator-bls.key"))) - assert.False(t, fileExists(path.Join(dir, "libp2p/libp2p.key"))) - - ip.generatesNetwork = true - res, err = ip.initKeys(sm) - require.NoError(t, err) - assert.Len(t, res, 1) - - assert.True(t, fileExists(path.Join(dir, "libp2p/libp2p.key"))) -} - -func fileExists(filename string) bool { - info, err := os.Stat(filename) - if os.IsNotExist(err) { - return false - } - - return !info.IsDir() -} - -func Test_getResult(t *testing.T) { - t.Parallel() - - // Creates test directory - dir, err := os.MkdirTemp("", "test") - require.NoError(t, err) - - defer os.RemoveAll(dir) - - sm, err := helper.SetupLocalSecretsManager(dir) - require.NoError(t, err) - - ip := &initParams{ - generatesAccount: true, - generatesNetwork: true, - printPrivateKey: true, - } - - _, err = ip.initKeys(sm) - require.NoError(t, err) - - res, err := ip.getResult(sm, []string{}) - require.NoError(t, err) - - sir := res.(*SecretsInitResult) //nolint:forcetypeassert - - // Test public key serialization - privKey, err := hex.DecodeString(sir.PrivateKey) - require.NoError(t, err) - k, err := wallet.NewWalletFromPrivKey(privKey) - require.NoError(t, err) - - pubKey := k.Address().String() - assert.Equal(t, sir.Address.String(), pubKey) - - // Test BLS public key serialization - blsPrivKey, err := bls.UnmarshalPrivateKey([]byte(sir.BLSPrivateKey)) - require.NoError(t, err) - - blsPubKey := hex.EncodeToString(blsPrivKey.PublicKey().Marshal()) - assert.Equal(t, sir.BLSPubkey, blsPubKey) -} diff --git a/command/polybftsecrets/result.go b/command/polybftsecrets/result.go deleted file mode 100644 index a30af05..0000000 --- a/command/polybftsecrets/result.go +++ /dev/null @@ -1,83 +0,0 @@ -package polybftsecrets - -import ( - "bytes" - "fmt" - - "github.com/xgr-network/xgr-node/command" - - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/types" -) - -type Results []command.CommandResult - -func (r Results) GetOutput() string { - var buffer bytes.Buffer - - for _, result := range r { - buffer.WriteString(result.GetOutput()) - } - - return buffer.String() -} - -type SecretsInitResult struct { - Address types.Address `json:"address"` - BLSPubkey string `json:"bls_pubkey"` - NodeID string `json:"node_id"` - PrivateKey string `json:"private_key"` - BLSPrivateKey string `json:"bls_private_key"` - Insecure bool `json:"insecure"` - Generated string `json:"generated"` -} - -func (r *SecretsInitResult) GetOutput() string { - var buffer bytes.Buffer - - vals := make([]string, 0, 3) - - vals = append( - vals, - fmt.Sprintf("Public key (address)|%s", r.Address.String()), - ) - - if r.PrivateKey != "" { - vals = append( - vals, - fmt.Sprintf("Private key|%s", r.PrivateKey), - ) - } - - if r.BLSPrivateKey != "" { - vals = append( - vals, - fmt.Sprintf("BLS Private key|%s", r.BLSPrivateKey), - ) - } - - if r.BLSPubkey != "" { - vals = append( - vals, - fmt.Sprintf("BLS Public key|%s", r.BLSPubkey), - ) - } - - vals = append(vals, fmt.Sprintf("Node ID|%s", r.NodeID)) - - if r.Insecure { - buffer.WriteString("\n[WARNING: INSECURE LOCAL SECRETS - SHOULD NOT BE RUN IN PRODUCTION]\n") - } - - if r.Generated != "" { - buffer.WriteString("\n[SECRETS GENERATED]\n") - buffer.WriteString(r.Generated) - buffer.WriteString("\n") - } - - buffer.WriteString("\n[SECRETS INIT]\n") - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/polybftsecrets/secrets_init.go b/command/polybftsecrets/secrets_init.go deleted file mode 100644 index acdfe83..0000000 --- a/command/polybftsecrets/secrets_init.go +++ /dev/null @@ -1,41 +0,0 @@ -package polybftsecrets - -import ( - "github.com/spf13/cobra" - - "github.com/xgr-network/xgr-node/command" -) - -var basicParams = &initParams{} - -func GetCommand() *cobra.Command { - secretsInitCmd := &cobra.Command{ - Use: "polybft-secrets", - Short: "Initializes private keys for the XGRChain (Validator + Networking) " + - "to the specified Secrets Manager", - PreRunE: runPreRun, - Run: runCommand, - } - - basicParams.setFlags(secretsInitCmd) - - return secretsInitCmd -} - -func runPreRun(_ *cobra.Command, _ []string) error { - return basicParams.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - results, err := basicParams.Execute() - if err != nil { - outputter.SetError(err) - - return - } - - outputter.SetCommandResult(results) -} diff --git a/command/polybftsecrets/utils.go b/command/polybftsecrets/utils.go deleted file mode 100644 index 7fddd6b..0000000 --- a/command/polybftsecrets/utils.go +++ /dev/null @@ -1,59 +0,0 @@ -package polybftsecrets - -import ( - "errors" - "fmt" - - "github.com/xgr-network/xgr-node/secrets" - "github.com/xgr-network/xgr-node/secrets/helper" -) - -// common flags for all polybft commands -const ( - AccountDirFlag = "data-dir" - AccountConfigFlag = "config" - PrivateKeyFlag = "private-key" - ChainIDFlag = "chain-id" - - AccountDirFlagDesc = "the directory for the XGRChain data if the local FS is used" - AccountConfigFlagDesc = "the path to the SecretsManager config file, if omitted, the local FS secrets manager is used" - PrivateKeyFlagDesc = "hex-encoded private key of the account which executes command" - ChainIDFlagDesc = "ID of child chain" -) - -// common errors for all polybft commands -var ( - ErrInvalidNum = fmt.Errorf("num flag value should be between 1 and %d", maxInitNum) - ErrInvalidParams = errors.New("no config file or data directory passed in") - ErrUnsupportedType = errors.New("unsupported secrets manager") - ErrSecureLocalStoreNotImplemented = errors.New( - "use a secrets backend, or supply an --insecure flag " + - "to store the private keys locally on the filesystem, " + - "avoid doing so in production") -) - -// GetSecretsManager function resolves secrets manager instance based on provided data or config paths. -// insecureLocalStore defines if utilization of local secrets manager is allowed. -func GetSecretsManager(dataPath, configPath string, insecureLocalStore bool) (secrets.SecretsManager, error) { - if configPath != "" { - secretsConfig, readErr := secrets.ReadConfig(configPath) - if readErr != nil { - return nil, fmt.Errorf("invalid secrets configuration: %w", readErr) - } - - if !secrets.SupportedServiceManager(secretsConfig.Type) { - return nil, ErrUnsupportedType - } - - return helper.InitCloudSecretsManager(secretsConfig) - } - - // Storing secrets on a local file system should only be allowed with --insecure flag, - // to raise awareness that it should be only used in development/testing environments. - // Production setups should use one of the supported secrets managers - if !insecureLocalStore { - return nil, ErrSecureLocalStoreNotImplemented - } - - return helper.SetupLocalSecretsManager(dataPath) -} diff --git a/command/regenesis/howtotest.md b/command/regenesis/howtotest.md deleted file mode 100644 index 87d6bdf..0000000 --- a/command/regenesis/howtotest.md +++ /dev/null @@ -1,179 +0,0 @@ -# Regenesis procedure - -This document outlines step necessary to perform a regenesis data migration. - -## Steps - -1. Create cluster - - ```bash - scripts/cluster ibft - ``` - -2. Check balance - - ```bash - curl -s -X POST --data '{"jsonrpc":"2.0", "method":"eth_getBalance", "params":["0x85da99c8a7c2c95964c8efd687e95e632fc533d6", "latest"], "id":1}' http://localhost:10002 - - {"jsonrpc":"2.0","id":1,"result":"0x3635c9adc5dea00000"} - ``` - -3. Get trie root - - ```bash - ./xgrchain regenesis getroot --rpc "http://localhost:10002" - - [Trie copy SUCCESS] - state root 0xf5ef1a28c82226effb90f4465180ec3469226747818579673f4be929f1cd8663 for block 38 - ``` - -4. Make trie snapshot - - ```bash - ./xgrchain regenesis --target-path ./trie_new --stateRoot 0xf5ef1a28c82226effb90f4465180ec3469226747818579673f4be929f1cd8663 --source-path ./test-chain-1/trie - - [Trie copy SUCCESS] - - ``` - -5. Remove old chain data - - ```bash - rm -rf test-chain-* - ``` - -6. Create new validators - - ```bash - ./xgrchain polybft-secrets --insecure --data-dir test-chain- --num 4 - - [WARNING: INSECURE LOCAL SECRETS - SHOULD NOT BE RUN IN PRODUCTION] - - [SECRETS INIT] - Public key (address. = 0x467CaA6185461E4c518597dCE7DE497Fb98a5680 - BLS Public key = 197059fdc3a78bd4001d802481c5ff1d84870c0b37aef851c83522323bd80f6429751ddae63cf38d180a8d45a5b4bf5519f380d60d6eedf9ccd22c3f95fc5e3a1193155af6ff3ab9e2aea5beab3f52e5e364d2cb410d6108c92f9a8375aac73110b8526407691c7e92e5cfab984e9011202b0606dc2be942808554b848cce67b - Node ID = 16Uiu2HAmTN2YAviWyyG4A56Zz8gsVJhmksdojymS4pk54SZqVbGV - - [WARNING: INSECURE LOCAL SECRETS - SHOULD NOT BE RUN IN PRODUCTION] - - [SECRETS INIT] - Public key (address. = 0x33177bBAebcB20F8545864a83b9b6EE334e4f94D - BLS Public key = 12d82d172646703d298453cef6f4415ceab2052267d9ec300fd4742fa46fd8db0168b5e98372ae3efd52d647f9b356043163fc4f76182f1ef685faf5e53b1dba15b7d0d9cb9b7868592e02179255775618dbacafd384cffba95b647a5d84de9a27995bb8cc0766194f370ad5b274d1a53b9b8ab21a3dee2f4ee4f177f63fb1f0 - Node ID = 16Uiu2HAkvtXkr1Hsct3UGn19ULNb7jgzPvEPu6Fpdakco8P45648 - - [WARNING: INSECURE LOCAL SECRETS - SHOULD NOT BE RUN IN PRODUCTION] - - [SECRETS INIT] - Public key (address. = 0xf308dF858dA25c2e40485FfA2c037D98105FD254 - BLS Public key = 220efa87e71744f44e286230cf4ac95a419abdd6d33d1a578fee21387b841fa32184dd132c077adb8f46db0eb66333672e36b5f363778030475672defce0b5622bb0974424dd7babfdf722fe9eab75ab6e5e34e2ecfcea89420f757bf8adfeb7020f0f961ca946cdb2dde40413c5c0d48aa9f13182ec35b58c4052de466c0e25 - Node ID = 16Uiu2HAmJqYRtWGbepPjQMgWfXnFEkXuX4GKH8AdD1voTwHpKuFa - - [WARNING: INSECURE LOCAL SECRETS - SHOULD NOT BE RUN IN PRODUCTION] - - [SECRETS INIT] - Public key (address. = 0x7eC6b7fc98D988472AD1AC0cFcaC6DA993d865B0 - BLS Public key = 2b8188f4bc99a19d5476fc97d14e17231cfb80b205a9fc45261725edefb0195209d972e9c1ad7d3c52b8fa129637738a88203c92fe8aa70fd0998d00f6251cb403ee077ddb4192fac270fe321468fe209308ea7597288e2505ed819f551ed00510c61f3da60f6a83d6017cbaeb7590c44bd354415178bbb160701b12a72a35a6 - Node ID = 16Uiu2HAmEuYYyzQKpyVr2HVCG8Gqx5e5DLCi8LWY4TkFYvHYcWAq - - ``` - -7. Generate genesis file - - ```bash - ./xgrchain genesis --consensus polybft \ - --block-gas-limit 10000000 \ - --proxy-contracts-admin 0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed \ - --epoch-size 10 --trieroot 0xf5ef1a28c82226effb90f4465180ec3469226747818579673f4be929f1cd8663 - - [GENESIS SUCCESS] - **** POLYBFT CONSENSUS PROTOCOL IS IN EXPERIMENTAL PHASE AND IS NOT FULLY PRODUCTION READY. YOU ARE USING IT AT YOUR OWN RISK. **** - Genesis written to ./genesis.json - - ``` - -8. Try to start a new v0.7 chain - - ```bash - ./xgrchain server --data-dir ./test-chain-1 --chain genesis.json --grpc-address :10000 --libp2p :30301 --jsonrpc :10002 --seal --log-level DEBUG & - ./xgrchain server --data-dir ./test-chain-2 --chain genesis.json --grpc-address :20000 --libp2p :30302 --jsonrpc :20002 --seal --log-level DEBUG & - ./xgrchain server --data-dir ./test-chain-3 --chain genesis.json --grpc-address :30000 --libp2p :30303 --jsonrpc :30002 --seal --log-level DEBUG & - ./xgrchain server --data-dir ./test-chain-4 --chain genesis.json --grpc-address :40000 --libp2p :30304 --jsonrpc :40002 --seal --log-level DEBUG & - wait - - [1] 2615 - [2] 2616 - [3] 2617 - [4] 2618 - 2023-03-15T11:02:25.149+0400 [INFO] polygon.server: Data dir: path=./test-chain-1 - 2023-03-15T11:02:25.149+0400 [DEBUG] polygon.server: DataDog profiler disabled, set DD_PROFILING_ENABLED env var to enable it. - 2023-03-15T11:02:25.233+0400 [INFO] polygon.server: Data dir: path=./test-chain-3 - 2023-03-15T11:02:25.251+0400 [DEBUG] polygon.server: DataDog profiler disabled, set DD_PROFILING_ENABLED env var to enable it. - invalid initial state root - [1] exit 1 ./xgrchain server --data-dir ./test-chain-1 --chain genesis.json :10000 - 2023-03-15T11:02:25.299+0400 [INFO] polygon.server: Data dir: path=./test-chain-2 - 2023-03-15T11:02:25.302+0400 [DEBUG] polygon.server: DataDog profiler disabled, set DD_PROFILING_ENABLED env var to enable it. - 2023-03-15T11:02:25.396+0400 [INFO] polygon.server: Data dir: path=./test-chain-4 - 2023-03-15T11:02:25.413+0400 [DEBUG] polygon.server: DataDog profiler disabled, set DD_PROFILING_ENABLED env var to enable it. - invalid initial state root - [3] - exit 1 ./xgrchain server --data-dir ./test-chain-3 --chain genesis.json :30000 - invalid initial state root - [2] - exit 1 ./xgrchain server --data-dir ./test-chain-2 --chain genesis.json :20000 - invalid initial state root - [4] + exit 1 ./xgrchain server --data-dir ./test-chain-4 --chain genesis.json :40000 - ``` - - It fails, because we haven't provided trie database with correct state trie. - -9. Copy snapshot trie to our data directory - - ```bash - rm -rf ./test-chain-1/trie - rm -rf ./test-chain-2/trie - rm -rf ./test-chain-3/trie - rm -rf ./test-chain-4/trie - cp -fR ./trie_new/ ./test-chain-1/trie/ - cp -fR ./trie_new/ ./test-chain-2/trie/ - cp -fR ./trie_new/ ./test-chain-3/trie/ - cp -fR ./trie_new/ ./test-chain-4/trie/ - ``` - -10. Run chain again - - ```bash - ./xgrchain server --data-dir ./test-chain-1 --chain genesis.json --grpc-address :10000 --libp2p :30301 --jsonrpc :10002 --seal --log-level DEBUG & - ./xgrchain server --data-dir ./test-chain-2 --chain genesis.json --grpc-address :20000 --libp2p :30302 --jsonrpc :20002 --seal --log-level DEBUG & - ./xgrchain server --data-dir ./test-chain-3 --chain genesis.json --grpc-address :30000 --libp2p :30303 --jsonrpc :30002 --seal --log-level DEBUG & - ./xgrchain server --data-dir ./test-chain-4 --chain genesis.json --grpc-address :40000 --libp2p :30304 --jsonrpc :40002 --seal --log-level DEBUG & - wait - - [1] 2721 - [2] 2722 - [3] 2723 - [4] 2724 - 2023-03-15T11:09:41.481+0400 [INFO] polygon.server: Data dir: path=./test-chain-2 - 2023-03-15T11:09:41.481+0400 [DEBUG] polygon.server: DataDog profiler disabled, set DD_PROFILING_ENABLED env var to enable it. - 2023-03-15T11:09:41.597+0400 [INFO] polygon.server: Data dir: path=./test-chain-1 - 2023-03-15T11:09:41.597+0400 [DEBUG] polygon.server: DataDog profiler disabled, set DD_PROFILING_ENABLED env var to enable it. - 2023-03-15T11:09:41.609+0400 [WARN] polygon: Initial state root checked and correct - 2023-03-15T11:09:41.661+0400 [INFO] polygon.server: Data dir: path=./test-chain-4 - 2023-03-15T11:09:41.661+0400 [DEBUG] polygon.server: DataDog profiler disabled, set DD_PROFILING_ENABLED env var to enable it. - 2023-03-15T11:09:41.725+0400 [INFO] polygon.server: Data dir: path=./test-chain-3 - 2023-03-15T11:09:41.725+0400 [DEBUG] polygon.server: DataDog profiler disabled, set DD_PROFILING_ENABLED env var to enable it. - 2023-03-15T11:09:41.844+0400 [INFO] polygon.blockchain: genesis: hash=0x627b70a8abc294324808d9820015faa5e0616afca5fdc75528b03b703a461acd - 2023-03-15T11:09:41.844+0400 [INFO] polygon.server.polybft: initializing polybft... - 2023-03-15T11:09:41.951+0400 [WARN] polygon: Initial state root checked and correct - 2023-03-15T11:09:42.101+0400 [WARN] polygon: Initial state root checked and correct - 2023-03-15T11:09:42.254+0400 [WARN] polygon: Initial state root checked and correct - 2023-03-15T11:09:42.445+0400 [INFO] polygon.blockchain: genesis: hash=0x627b70a8abc294324808d9820015faa5e0616afca5fdc75528b03b703a461acd - 2023-03-15T11:09:42.445+0400 [INFO] polygon.server.polybft: initializing polybft... - 2023-03-15T11:09:42.462+0400 [INFO] polygon.server.polybft.consensus_runtime: restartEpoch: block number=0 epoch=1 validators=4 firstBlockInEpoch=1 - ... - ``` - -11. Check that balance of account on v0.6 is not 0 - - ```bash - curl -s -X POST --data '{"jsonrpc":"2.0", "method":"eth_getBalance", "params":["0x85da99c8a7c2c95964c8efd687e95e632fc533d6", "latest"], "id":1}' http://localhost:10002 - - {"jsonrpc":"2.0","id":1,"result":"0x3635c9adc5dea00000"}% - ``` diff --git a/command/root/root.go b/command/root/root.go index 2f7c355..d641e5b 100644 --- a/command/root/root.go +++ b/command/root/root.go @@ -7,17 +7,13 @@ import ( "github.com/spf13/cobra" "github.com/xgr-network/xgr-node/command/backup" - "github.com/xgr-network/xgr-node/command/bridge" "github.com/xgr-network/xgr-node/command/genesis" "github.com/xgr-network/xgr-node/command/helper" "github.com/xgr-network/xgr-node/command/ibft" "github.com/xgr-network/xgr-node/command/license" "github.com/xgr-network/xgr-node/command/monitor" "github.com/xgr-network/xgr-node/command/peers" - "github.com/xgr-network/xgr-node/command/polybft" - "github.com/xgr-network/xgr-node/command/polybftsecrets" "github.com/xgr-network/xgr-node/command/regenesis" - "github.com/xgr-network/xgr-node/command/rootchain" "github.com/xgr-network/xgr-node/command/secrets" "github.com/xgr-network/xgr-node/command/server" "github.com/xgr-network/xgr-node/command/status" @@ -50,16 +46,12 @@ func (rc *RootCommand) registerSubCommands() { status.GetCommand(), secrets.GetCommand(), peers.GetCommand(), - rootchain.GetCommand(), monitor.GetCommand(), ibft.GetCommand(), backup.GetCommand(), genesis.GetCommand(), server.GetCommand(), license.GetCommand(), - polybftsecrets.GetCommand(), - polybft.GetCommand(), - bridge.GetCommand(), regenesis.GetCommand(), ) } diff --git a/command/rootchain/README.md b/command/rootchain/README.md deleted file mode 100644 index 2de8571..0000000 --- a/command/rootchain/README.md +++ /dev/null @@ -1,41 +0,0 @@ -# Rootchain helper command - -Top level command for manipulating rootchain server. - -## Start rootchain server - -This command starts `ethereum/client-go` container which is Geth node started in dev mode. - -```bash -$ xgrchain rootchain server -``` - -## Fund initialized accounts - -This command funds the initialized accounts via `xgrchain polybft-secrets` command. - -```bash -$ xgrchain rootchain fund --data-dir data-dir- --num 2 -``` - -or - -```bash -$ xgrchain rootchain fund --data-dir data-dir-1 -``` - -## Deploy and initialize contracts - -This command deploys and initializes rootchain contracts. Transactions are being sent to given `--json-rpc` endpoint and are signed by private key provided by `--adminKey` flag. - -```bash -$ xgrchain rootchain deploy \ - --genesis \ - --deployer-key \ - --stake-manager \ - --stake-token \ - --json-rpc \ - --proxy-contracts-admin
-``` - -**Note:** In case `test` flag is provided, it engages test mode, which uses predefined test account private key to send transactions to the rootchain. diff --git a/command/rootchain/deploy/deploy.go b/command/rootchain/deploy/deploy.go deleted file mode 100644 index 52ca402..0000000 --- a/command/rootchain/deploy/deploy.go +++ /dev/null @@ -1,788 +0,0 @@ -package deploy - -import ( - "context" - "errors" - "fmt" - "sync" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/jsonrpc" - "golang.org/x/sync/errgroup" - - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/command" - cmdHelper "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi/artifact" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -const ( - contractsDeploymentTitle = "[ROOTCHAIN - CONTRACTS DEPLOYMENT]" - ProxySufix = "Proxy" - - stateSenderName = "StateSender" - checkpointManagerName = "CheckpointManager" - blsName = "BLS" - bn256G2Name = "BN256G2" - exitHelperName = "ExitHelper" - rootERC20PredicateName = "RootERC20Predicate" - childERC20MintablePredicateName = "ChildERC20MintablePredicate" - rootERC20Name = "RootERC20" - erc20TemplateName = "ERC20Template" - rootERC721PredicateName = "RootERC721Predicate" - childERC721MintablePredicateName = "ChildERC721MintablePredicate" - erc721TemplateName = "ERC721Template" - rootERC1155PredicateName = "RootERC1155Predicate" - childERC1155MintablePredicateName = "ChildERC1155MintablePredicate" - erc1155TemplateName = "ERC1155Template" - customSupernetManagerName = "CustomSupernetManager" - stakeManagerName = "StakeManager" -) - -var ( - // params are the parameters of CLI command - params deployParams - - // consensusCfg contains consensus protocol configuration parameters - consensusCfg polybft.PolyBFTConfig - - // metadataPopulatorMap maps rootchain contract names to callback - // which populates appropriate field in the RootchainMetadata - metadataPopulatorMap = map[string]func(*polybft.RootchainConfig, types.Address){ - stateSenderName: func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.StateSenderAddress = addr - }, - getProxyNameForImpl(checkpointManagerName): func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.CheckpointManagerAddress = addr - }, - getProxyNameForImpl(blsName): func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.BLSAddress = addr - }, - getProxyNameForImpl(bn256G2Name): func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.BN256G2Address = addr - }, - getProxyNameForImpl(exitHelperName): func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.ExitHelperAddress = addr - }, - getProxyNameForImpl(rootERC20PredicateName): func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.RootERC20PredicateAddress = addr - }, - getProxyNameForImpl(childERC20MintablePredicateName): func( - rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.ChildMintableERC20PredicateAddress = addr - }, - rootERC20Name: func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.RootNativeERC20Address = addr - }, - erc20TemplateName: func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.ChildERC20Address = addr - }, - getProxyNameForImpl(rootERC721PredicateName): func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.RootERC721PredicateAddress = addr - }, - getProxyNameForImpl(childERC721MintablePredicateName): func( - rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.ChildMintableERC721PredicateAddress = addr - }, - erc721TemplateName: func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.ChildERC721Address = addr - }, - getProxyNameForImpl(rootERC1155PredicateName): func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.RootERC1155PredicateAddress = addr - }, - getProxyNameForImpl(childERC1155MintablePredicateName): func( - rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.ChildMintableERC1155PredicateAddress = addr - }, - erc1155TemplateName: func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.ChildERC1155Address = addr - }, - getProxyNameForImpl(customSupernetManagerName): func(rootchainConfig *polybft.RootchainConfig, addr types.Address) { - rootchainConfig.CustomSupernetManagerAddress = addr - }, - } - - // initializersMap maps rootchain contract names to initializer function callbacks - initializersMap = map[string]func(command.OutputFormatter, txrelayer.TxRelayer, - *polybft.RootchainConfig, ethgo.Key) error{ - getProxyNameForImpl(customSupernetManagerName): func(fmt command.OutputFormatter, - relayer txrelayer.TxRelayer, - config *polybft.RootchainConfig, - key ethgo.Key) error { - initParams := &contractsapi.InitializeCustomSupernetManagerFn{ - NewStakeManager: config.StakeManagerAddress, - NewBls: config.BLSAddress, - NewStateSender: config.StateSenderAddress, - NewMatic: types.StringToAddress(params.stakeTokenAddr), - NewChildValidatorSet: contracts.ValidatorSetContract, - NewExitHelper: config.ExitHelperAddress, - NewDomain: signer.DomainValidatorSetString, - NewRootERC20Predicate: config.RootERC20PredicateAddress, - } - - return initContract(fmt, relayer, initParams, - config.CustomSupernetManagerAddress, customSupernetManagerName, key) - }, - getProxyNameForImpl(exitHelperName): func(fmt command.OutputFormatter, - relayer txrelayer.TxRelayer, - config *polybft.RootchainConfig, - key ethgo.Key) error { - inputParams := &contractsapi.InitializeExitHelperFn{ - NewCheckpointManager: config.CheckpointManagerAddress, - } - - return initContract(fmt, relayer, inputParams, config.ExitHelperAddress, exitHelperName, key) - }, - getProxyNameForImpl(rootERC20PredicateName): func(fmt command.OutputFormatter, - relayer txrelayer.TxRelayer, - config *polybft.RootchainConfig, - key ethgo.Key) error { - - inputParams := &contractsapi.InitializeRootERC20PredicateFn{ - NewStateSender: config.StateSenderAddress, - NewExitHelper: config.ExitHelperAddress, - NewChildERC20Predicate: contracts.ChildERC20PredicateContract, - NewChildTokenTemplate: contracts.ChildERC20Contract, - // map root native token address should be non-zero only if native token is non-mintable on a childchain - NewNativeTokenRoot: config.RootNativeERC20Address, - } - - return initContract(fmt, relayer, inputParams, - config.RootERC20PredicateAddress, rootERC20PredicateName, key) - }, - getProxyNameForImpl(childERC20MintablePredicateName): func(fmt command.OutputFormatter, - relayer txrelayer.TxRelayer, - config *polybft.RootchainConfig, - key ethgo.Key) error { - initParams := &contractsapi.InitializeChildMintableERC20PredicateFn{ - NewStateSender: config.StateSenderAddress, - NewExitHelper: config.ExitHelperAddress, - NewRootERC20Predicate: contracts.RootMintableERC20PredicateContract, - NewChildTokenTemplate: config.ChildERC20Address, - } - - return initContract(fmt, relayer, initParams, - config.ChildMintableERC20PredicateAddress, childERC20MintablePredicateName, key) - }, - getProxyNameForImpl(rootERC721PredicateName): func(fmt command.OutputFormatter, - relayer txrelayer.TxRelayer, - config *polybft.RootchainConfig, - key ethgo.Key) error { - initParams := &contractsapi.InitializeRootERC721PredicateFn{ - NewStateSender: config.StateSenderAddress, - NewExitHelper: config.ExitHelperAddress, - NewChildERC721Predicate: contracts.ChildERC721PredicateContract, - NewChildTokenTemplate: contracts.ChildERC721Contract, - } - - return initContract(fmt, relayer, initParams, - config.RootERC721PredicateAddress, rootERC721PredicateName, key) - }, - getProxyNameForImpl(childERC721MintablePredicateName): func(fmt command.OutputFormatter, - relayer txrelayer.TxRelayer, - config *polybft.RootchainConfig, - key ethgo.Key) error { - initParams := &contractsapi.InitializeChildMintableERC721PredicateFn{ - NewStateSender: config.StateSenderAddress, - NewExitHelper: config.ExitHelperAddress, - NewRootERC721Predicate: contracts.RootMintableERC721PredicateContract, - NewChildTokenTemplate: config.ChildERC721Address, - } - - return initContract(fmt, relayer, initParams, - config.ChildMintableERC721PredicateAddress, childERC721MintablePredicateName, key) - }, - getProxyNameForImpl(rootERC1155PredicateName): func(fmt command.OutputFormatter, - relayer txrelayer.TxRelayer, - config *polybft.RootchainConfig, - key ethgo.Key) error { - initParams := &contractsapi.InitializeRootERC1155PredicateFn{ - NewStateSender: config.StateSenderAddress, - NewExitHelper: config.ExitHelperAddress, - NewChildERC1155Predicate: contracts.ChildERC1155PredicateContract, - NewChildTokenTemplate: contracts.ChildERC1155Contract, - } - - return initContract(fmt, relayer, initParams, - config.RootERC1155PredicateAddress, rootERC1155PredicateName, key) - }, - getProxyNameForImpl(childERC1155MintablePredicateName): func(fmt command.OutputFormatter, - relayer txrelayer.TxRelayer, - config *polybft.RootchainConfig, - key ethgo.Key) error { - initParams := &contractsapi.InitializeChildMintableERC1155PredicateFn{ - NewStateSender: config.StateSenderAddress, - NewExitHelper: config.ExitHelperAddress, - NewRootERC1155Predicate: contracts.RootMintableERC1155PredicateContract, - NewChildTokenTemplate: config.ChildERC1155Address, - } - - return initContract(fmt, relayer, initParams, - config.ChildMintableERC1155PredicateAddress, childERC1155MintablePredicateName, key) - }, - } -) - -type deploymentResultInfo struct { - RootchainCfg *polybft.RootchainConfig - SupernetID int64 - CommandResults []command.CommandResult -} - -// GetCommand returns the rootchain deploy command -func GetCommand() *cobra.Command { - cmd := &cobra.Command{ - Use: "deploy", - Short: "Deploys and initializes required smart contracts on the rootchain", - PreRunE: preRunCommand, - Run: runCommand, - } - - cmd.Flags().StringVar( - ¶ms.genesisPath, - helper.GenesisPathFlag, - helper.DefaultGenesisPath, - helper.GenesisPathFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.deployerKey, - deployerKeyFlag, - "", - "hex-encoded private key of the account which deploys rootchain contracts", - ) - - cmd.Flags().StringVar( - ¶ms.jsonRPCAddress, - jsonRPCFlag, - txrelayer.DefaultRPCAddress, - "the JSON RPC rootchain IP address", - ) - - cmd.Flags().StringVar( - ¶ms.rootERC20TokenAddr, - erc20AddrFlag, - "", - "existing root chain root native token address", - ) - - cmd.Flags().BoolVar( - ¶ms.isTestMode, - helper.TestModeFlag, - false, - "test indicates whether rootchain contracts deployer is hardcoded test account"+ - " (otherwise provided secrets are used to resolve deployer account)", - ) - - cmd.Flags().StringVar( - ¶ms.stakeTokenAddr, - helper.StakeTokenFlag, - "", - helper.StakeTokenFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.stakeManagerAddr, - helper.StakeManagerFlag, - "", - helper.StakeManagerFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.proxyContractsAdmin, - helper.ProxyContractsAdminFlag, - "", - helper.ProxyContractsAdminDesc, - ) - - cmd.MarkFlagsMutuallyExclusive(helper.TestModeFlag, deployerKeyFlag) - _ = cmd.MarkFlagRequired(helper.StakeManagerFlag) - _ = cmd.MarkFlagRequired(helper.StakeTokenFlag) - - return cmd -} - -func preRunCommand(_ *cobra.Command, _ []string) error { - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - outputter.WriteCommandResult(&helper.MessageResult{ - Message: fmt.Sprintf("%s started... Rootchain JSON RPC address %s.", contractsDeploymentTitle, params.jsonRPCAddress), - }) - - chainConfig, err := chain.ImportFromFile(params.genesisPath) - if err != nil { - outputter.SetError(fmt.Errorf("failed to read chain configuration: %w", err)) - - return - } - - client, err := jsonrpc.NewClient(params.jsonRPCAddress) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize JSON RPC client for provided IP address: %s: %w", - params.jsonRPCAddress, err)) - - return - } - - if consensusCfg.Bridge != nil { - code, err := client.Eth().GetCode(ethgo.Address(consensusCfg.Bridge.StateSenderAddr), ethgo.Latest) - if err != nil { - outputter.SetError(fmt.Errorf("failed to check if rootchain contracts are deployed: %w", err)) - - return - } else if code != "0x" { - outputter.SetCommandResult(&helper.MessageResult{ - Message: fmt.Sprintf("%s contracts are already deployed. Aborting.", contractsDeploymentTitle), - }) - - return - } - } - - // set event tracker start blocks for rootchain contract(s) of interest - // the block number should be queried before deploying contracts so that no events during deployment - // and initialization are missed - blockNum, err := client.Eth().BlockNumber() - if err != nil { - outputter.SetError(fmt.Errorf("failed to query rootchain latest block number: %w", err)) - - return - } - - deploymentResultInfo, err := deployContracts(outputter, client, - chainConfig.Params.ChainID, consensusCfg.InitialValidatorSet, cmd.Context()) - if err != nil { - outputter.SetError(fmt.Errorf("failed to deploy rootchain contracts: %w", err)) - outputter.SetCommandResult(command.Results(deploymentResultInfo.CommandResults)) - - return - } - - // populate bridge configuration - bridgeConfig := deploymentResultInfo.RootchainCfg.ToBridgeConfig() - if consensusCfg.Bridge != nil { - // only true if stake-manager-deploy command was executed - // users can still deploy stake manager manually - // only used for e2e tests - bridgeConfig.StakeTokenAddr = consensusCfg.Bridge.StakeTokenAddr - } - - consensusCfg.Bridge = bridgeConfig - - consensusCfg.Bridge.EventTrackerStartBlocks = map[types.Address]uint64{ - deploymentResultInfo.RootchainCfg.StateSenderAddress: blockNum, - } - consensusCfg.SupernetID = deploymentResultInfo.SupernetID - - // write updated consensus configuration - chainConfig.Params.Engine[polybft.ConsensusName] = consensusCfg - - if err := cmdHelper.WriteGenesisConfigToDisk(chainConfig, params.genesisPath); err != nil { - outputter.SetError(fmt.Errorf("failed to save chain configuration bridge data: %w", err)) - - return - } - - deploymentResultInfo.CommandResults = append(deploymentResultInfo.CommandResults, &helper.MessageResult{ - Message: fmt.Sprintf("%s finished. All contracts are successfully deployed and initialized.", - contractsDeploymentTitle), - }) - outputter.SetCommandResult(command.Results(deploymentResultInfo.CommandResults)) -} - -// deployContracts deploys and initializes rootchain smart contracts -func deployContracts(outputter command.OutputFormatter, client *jsonrpc.Client, chainID int64, - initialValidators []*validator.GenesisValidator, cmdCtx context.Context) (deploymentResultInfo, error) { - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithClient(client), txrelayer.WithWriter(outputter)) - if err != nil { - return deploymentResultInfo{RootchainCfg: nil, SupernetID: 0, CommandResults: nil}, - fmt.Errorf("failed to initialize tx relayer: %w", err) - } - - deployerKey, err := helper.DecodePrivateKey(params.deployerKey) - if err != nil { - return deploymentResultInfo{RootchainCfg: nil, SupernetID: 0, CommandResults: nil}, - fmt.Errorf("failed to initialize deployer key: %w", err) - } - - if params.isTestMode { - deployerAddr := deployerKey.Address() - - txn := helper.CreateTransaction(ethgo.ZeroAddress, &deployerAddr, nil, ethgo.Ether(1), true) - if _, err = txRelayer.SendTransactionLocal(txn); err != nil { - return deploymentResultInfo{RootchainCfg: nil, SupernetID: 0, CommandResults: nil}, err - } - } - - type contractInfo struct { - name string - artifact *artifact.Artifact - hasProxy bool - byteCodeBuilder func() ([]byte, error) - } - - rootchainConfig := &polybft.RootchainConfig{ - JSONRPCAddr: params.jsonRPCAddress, - // update stake manager address in genesis in case if stake manager was deployed manually - StakeManagerAddress: types.StringToAddress(params.stakeManagerAddr), - } - - tokenContracts := []*contractInfo{} - - // deploy root ERC20 token only if non-mintable native token flavor is used on a child chain - if !consensusCfg.NativeTokenConfig.IsMintable { - if params.rootERC20TokenAddr != "" { - // use existing root chain ERC20 token - if err := populateExistingTokenAddr(client.Eth(), - params.rootERC20TokenAddr, rootERC20Name, rootchainConfig); err != nil { - return deploymentResultInfo{RootchainCfg: nil, SupernetID: 0, CommandResults: nil}, err - } - } else { - // deploy MockERC20 as a root chain root native token - tokenContracts = append(tokenContracts, - &contractInfo{name: rootERC20Name, artifact: contractsapi.RootERC20}) - } - } - - allContracts := []*contractInfo{ - { - name: stateSenderName, - artifact: contractsapi.StateSender, - }, - { - name: checkpointManagerName, - artifact: contractsapi.CheckpointManager, - hasProxy: true, - byteCodeBuilder: func() ([]byte, error) { - constructorFn := &contractsapi.CheckpointManagerConstructorFn{ - Initiator: types.Address(deployerKey.Address()), - } - - input, err := constructorFn.EncodeAbi() - if err != nil { - return nil, err - } - - return append(contractsapi.CheckpointManager.Bytecode, input...), nil - }, - }, - { - name: blsName, - artifact: contractsapi.BLS, - hasProxy: true, - }, - { - name: bn256G2Name, - artifact: contractsapi.BLS256, - hasProxy: true, - }, - { - name: exitHelperName, - artifact: contractsapi.ExitHelper, - hasProxy: true, - }, - { - name: rootERC20PredicateName, - artifact: contractsapi.RootERC20Predicate, - hasProxy: true, - }, - { - name: childERC20MintablePredicateName, - artifact: contractsapi.ChildMintableERC20Predicate, - hasProxy: true, - }, - { - name: erc20TemplateName, - artifact: contractsapi.ChildERC20, - }, - { - name: rootERC721PredicateName, - artifact: contractsapi.RootERC721Predicate, - hasProxy: true, - }, - { - name: childERC721MintablePredicateName, - artifact: contractsapi.ChildMintableERC721Predicate, - hasProxy: true, - }, - { - name: erc721TemplateName, - artifact: contractsapi.ChildERC721, - }, - { - name: rootERC1155PredicateName, - artifact: contractsapi.RootERC1155Predicate, - hasProxy: true, - }, - { - name: childERC1155MintablePredicateName, - artifact: contractsapi.ChildMintableERC1155Predicate, - hasProxy: true, - }, - { - name: erc1155TemplateName, - artifact: contractsapi.ChildERC1155, - }, - { - name: customSupernetManagerName, - artifact: contractsapi.CustomSupernetManager, - hasProxy: true, - }, - } - - allContracts = append(tokenContracts, allContracts...) - - g, ctx := errgroup.WithContext(cmdCtx) - results := make(map[string]*deployContractResult, len(allContracts)) - resultsLock := sync.Mutex{} - proxyAdmin := types.StringToAddress(params.proxyContractsAdmin) - - for _, contract := range allContracts { - contract := contract - - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - default: - bytecode := contract.artifact.Bytecode - if contract.byteCodeBuilder != nil { - bytecode, err = contract.byteCodeBuilder() - if err != nil { - return err - } - } - - txn := helper.CreateTransaction(ethgo.ZeroAddress, nil, bytecode, nil, true) - - receipt, err := txRelayer.SendTransaction(txn, deployerKey) - if err != nil { - return fmt.Errorf("failed sending %s contract deploy transaction: %w", contract.name, err) - } - - if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { - return fmt.Errorf("deployment of %s contract failed", contract.name) - } - - deployResults := make([]*deployContractResult, 0, 2) - implementationAddress := types.Address(receipt.ContractAddress) - - deployResults = append(deployResults, newDeployContractsResult(contract.name, - implementationAddress, - receipt.TransactionHash, - receipt.GasUsed)) - - if contract.hasProxy { - proxyContractName := getProxyNameForImpl(contract.name) - - receipt, err := helper.DeployProxyContract( - txRelayer, deployerKey, proxyContractName, proxyAdmin, implementationAddress) - if err != nil { - return err - } - - if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { - return fmt.Errorf("deployment of %s contract failed", proxyContractName) - } - - deployResults = append(deployResults, newDeployContractsResult(proxyContractName, - types.Address(receipt.ContractAddress), - receipt.TransactionHash, - receipt.GasUsed)) - } - - resultsLock.Lock() - defer resultsLock.Unlock() - - for _, deployResult := range deployResults { - results[deployResult.Name] = deployResult - } - - return nil - } - }) - } - - if err := g.Wait(); err != nil { - return collectResultsOnError(results), err - } - - commandResults := make([]command.CommandResult, 0, len(results)) - - for _, result := range results { - commandResults = append(commandResults, result) - - populatorFn, exists := metadataPopulatorMap[result.Name] - if !exists { - continue - } - - populatorFn(rootchainConfig, result.Address) - } - - g, ctx = errgroup.WithContext(cmdCtx) - - for contractName := range results { - contractName := contractName - - initializer, exists := initializersMap[contractName] - if !exists { - continue - } - - g.Go(func() error { - select { - case <-cmdCtx.Done(): - return cmdCtx.Err() - default: - return initializer(outputter, txRelayer, rootchainConfig, deployerKey) - } - }) - } - - if err := g.Wait(); err != nil { - return deploymentResultInfo{RootchainCfg: nil, SupernetID: 0, CommandResults: nil}, err - } - - // register supernets manager on stake manager - supernetID, err := registerChainOnStakeManager(txRelayer, rootchainConfig, deployerKey) - if err != nil { - return deploymentResultInfo{RootchainCfg: nil, SupernetID: 0, CommandResults: nil}, err - } - - return deploymentResultInfo{ - RootchainCfg: rootchainConfig, - SupernetID: supernetID, - CommandResults: commandResults}, nil -} - -// populateExistingTokenAddr checks whether given token is deployed on the provided address. -// If it is, then its address is set to the rootchain config, otherwise an error is returned -func populateExistingTokenAddr(eth *jsonrpc.Eth, tokenAddr, tokenName string, - rootchainCfg *polybft.RootchainConfig) error { - addr := types.StringToAddress(tokenAddr) - - code, err := eth.GetCode(ethgo.Address(addr), ethgo.Latest) - if err != nil { - return fmt.Errorf("failed to check is %s token deployed: %w", tokenName, err) - } else if code == "0x" { - return fmt.Errorf("%s token is not deployed on provided address %s", tokenName, tokenAddr) - } - - populatorFn, ok := metadataPopulatorMap[tokenName] - if !ok { - return fmt.Errorf("root chain metadata populator not registered for contract '%s'", tokenName) - } - - populatorFn(rootchainCfg, addr) - - return nil -} - -// registerChainOnStakeManager registers child chain and its supernet manager on rootchain -func registerChainOnStakeManager(txRelayer txrelayer.TxRelayer, - rootchainCfg *polybft.RootchainConfig, deployerKey ethgo.Key) (int64, error) { - registerChainFn := &contractsapi.RegisterChildChainStakeManagerFn{ - Manager: rootchainCfg.CustomSupernetManagerAddress, - } - - encoded, err := registerChainFn.EncodeAbi() - if err != nil { - return 0, fmt.Errorf("failed to encode parameters for registering child chain on supernets. error: %w", err) - } - - receipt, err := helper.SendTransaction(txRelayer, ethgo.Address(rootchainCfg.StakeManagerAddress), - encoded, stakeManagerName, deployerKey) - if err != nil { - return 0, err - } - - var ( - childChainRegisteredEvent contractsapi.ChildManagerRegisteredEvent - found bool - supernetID int64 - ) - - for _, log := range receipt.Logs { - doesMatch, err := childChainRegisteredEvent.ParseLog(log) - if err != nil { - return 0, err - } - - if !doesMatch { - continue - } - - supernetID = childChainRegisteredEvent.ID.Int64() - found = true - - break - } - - if !found { - return 0, errors.New("could not find a log that child chain was registered on stake manager") - } - - return supernetID, nil -} - -// initContract initializes arbitrary contract with given parameters deployed on a given address -func initContract(cmdOutput command.OutputFormatter, txRelayer txrelayer.TxRelayer, - initInputFn contractsapi.StateTransactionInput, contractAddr types.Address, - contractName string, deployerKey ethgo.Key) error { - input, err := initInputFn.EncodeAbi() - if err != nil { - return fmt.Errorf("failed to encode initialization params for %s.initialize. error: %w", - contractName, err) - } - - if _, err := helper.SendTransaction(txRelayer, ethgo.Address(contractAddr), - input, contractName, deployerKey); err != nil { - return err - } - - cmdOutput.WriteCommandResult( - &helper.MessageResult{ - Message: fmt.Sprintf("%s %s contract is initialized", contractsDeploymentTitle, contractName), - }) - - return nil -} - -func collectResultsOnError(results map[string]*deployContractResult) deploymentResultInfo { - commandResults := make([]command.CommandResult, 0, len(results)+1) - messageResult := helper.MessageResult{Message: "[ROOTCHAIN - DEPLOY] Successfully deployed the following contracts\n"} - - for _, result := range results { - if result != nil { - // In case an error happened, some of the indices may not be populated. - // Filter those out. - commandResults = append(commandResults, result) - } - } - - commandResults = append([]command.CommandResult{messageResult}, commandResults...) - - return deploymentResultInfo{ - RootchainCfg: nil, - SupernetID: 0, - CommandResults: commandResults} -} - -func getProxyNameForImpl(input string) string { - return input + ProxySufix -} diff --git a/command/rootchain/deploy/deploy_test.go b/command/rootchain/deploy/deploy_test.go deleted file mode 100644 index 9e141f0..0000000 --- a/command/rootchain/deploy/deploy_test.go +++ /dev/null @@ -1,67 +0,0 @@ -package deploy - -import ( - "context" - "os" - "testing" - - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/jsonrpc" - "github.com/umbracle/ethgo/testutil" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/types" -) - -func TestDeployContracts_NoPanics(t *testing.T) { - t.Parallel() - - server := testutil.DeployTestServer(t, nil) - t.Cleanup(func() { - if err := os.RemoveAll(params.genesisPath); err != nil { - t.Fatal(err) - } - }) - - client, err := jsonrpc.NewClient(server.HTTPAddr()) - require.NoError(t, err) - - testKey, err := helper.DecodePrivateKey("") - require.NoError(t, err) - - receipt, err := server.Fund(testKey.Address()) - require.NoError(t, err) - require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) - - txn := ðgo.Transaction{ - To: nil, // contract deployment - Input: contractsapi.StakeManager.Bytecode, - } - - receipt, err = server.SendTxn(txn) - require.NoError(t, err) - require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) - - outputter := command.InitializeOutputter(GetCommand()) - params.stakeManagerAddr = receipt.ContractAddress.String() - params.stakeTokenAddr = types.StringToAddress("0x123456789").String() - params.proxyContractsAdmin = "0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed" - consensusCfg = polybft.PolyBFTConfig{ - NativeTokenConfig: &polybft.TokenConfig{ - Name: "Test", - Symbol: "TST", - Decimals: 18, - IsMintable: false, - }, - } - - require.NotPanics(t, func() { - _, err = deployContracts(outputter, client, 1, []*validator.GenesisValidator{}, context.Background()) - }) - require.NoError(t, err) -} diff --git a/command/rootchain/deploy/params.go b/command/rootchain/deploy/params.go deleted file mode 100644 index 2381e6b..0000000 --- a/command/rootchain/deploy/params.go +++ /dev/null @@ -1,55 +0,0 @@ -package deploy - -import ( - "errors" - "fmt" - "os" - - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/consensus/polybft" -) - -const ( - deployerKeyFlag = "deployer-key" - jsonRPCFlag = "json-rpc" - erc20AddrFlag = "erc20-token" -) - -type deployParams struct { - genesisPath string - deployerKey string - jsonRPCAddress string - stakeTokenAddr string - rootERC20TokenAddr string - stakeManagerAddr string - proxyContractsAdmin string - isTestMode bool -} - -func (ip *deployParams) validateFlags() error { - var err error - - if _, err = os.Stat(ip.genesisPath); err != nil { - return fmt.Errorf("provided genesis path '%s' is invalid. Error: %w ", ip.genesisPath, err) - } - - consensusCfg, err = polybft.LoadPolyBFTConfig(ip.genesisPath) - if err != nil { - return err - } - - if consensusCfg.NativeTokenConfig == nil { - return errors.New("native token configuration is undefined") - } - - // when using mintable native token, child native token on root chain gets mapped automatically - if consensusCfg.NativeTokenConfig.IsMintable && ip.rootERC20TokenAddr != "" { - return errors.New("if child chain native token is mintable, root native token must not pre-exist on root chain") - } - - if params.stakeTokenAddr == "" { - return errors.New("stake token address is not provided") - } - - return helper.ValidateProxyContractsAdmin(ip.proxyContractsAdmin) -} diff --git a/command/rootchain/deploy/result.go b/command/rootchain/deploy/result.go deleted file mode 100644 index c3ffc2a..0000000 --- a/command/rootchain/deploy/result.go +++ /dev/null @@ -1,45 +0,0 @@ -package deploy - -import ( - "bytes" - "fmt" - - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/types" -) - -type deployContractResult struct { - Name string `json:"name"` - Address types.Address `json:"address"` - Hash types.Hash `json:"hash"` - GasUsed uint64 `json:"gasUsed"` -} - -func newDeployContractsResult(name string, - address types.Address, - hash ethgo.Hash, gasUsed uint64) *deployContractResult { - return &deployContractResult{ - Name: name, - Address: address, - Hash: types.BytesToHash(hash.Bytes()), - GasUsed: gasUsed, - } -} - -func (r deployContractResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[ROOTCHAIN - DEPLOY CONTRACT]\n") - - vals := make([]string, 0, 4) - vals = append(vals, fmt.Sprintf("Name|%s", r.Name)) - vals = append(vals, fmt.Sprintf("Contract (address)|%s", r.Address)) - vals = append(vals, fmt.Sprintf("Transaction (hash)|%s", r.Hash)) - vals = append(vals, fmt.Sprintf("Transaction (gas used)|%d", r.GasUsed)) - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/fund/fund.go b/command/rootchain/fund/fund.go deleted file mode 100644 index c4bc1fa..0000000 --- a/command/rootchain/fund/fund.go +++ /dev/null @@ -1,187 +0,0 @@ -package fund - -import ( - "fmt" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "golang.org/x/sync/errgroup" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var ( - params fundParams -) - -// GetCommand returns the rootchain fund command -func GetCommand() *cobra.Command { - rootchainFundCmd := &cobra.Command{ - Use: "fund", - Short: "Fund validator account with given tokens amount", - PreRunE: preRunCommand, - Run: runCommand, - } - - setFlags(rootchainFundCmd) - - return rootchainFundCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringSliceVar( - ¶ms.addresses, - helper.AddressesFlag, - nil, - "validator addresses", - ) - - cmd.Flags().StringSliceVar( - ¶ms.amounts, - helper.AmountsFlag, - nil, - "token amounts which is funded to validator on a root chain", - ) - - cmd.Flags().StringVar( - ¶ms.jsonRPCAddress, - jsonRPCFlag, - txrelayer.DefaultRPCAddress, - "the rootchain JSON RPC endpoint", - ) - - cmd.Flags().StringVar( - ¶ms.stakeTokenAddr, - helper.StakeTokenFlag, - "", - helper.StakeTokenFlagDesc, - ) - - cmd.Flags().BoolVar( - ¶ms.mintStakeToken, - mintStakeTokenFlag, - false, - "indicates if stake token deployer should mint root tokens to given validators", - ) - - cmd.Flags().StringVar( - ¶ms.deployerPrivateKey, - polybftsecrets.PrivateKeyFlag, - "", - polybftsecrets.PrivateKeyFlagDesc, - ) -} - -func preRunCommand(_ *cobra.Command, _ []string) error { - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPCAddress)) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize tx relayer: %w", err)) - - return - } - - deployerKey, err := helper.DecodePrivateKey(params.deployerPrivateKey) - if err != nil { - outputter.SetError(fmt.Errorf("failed to initialize deployer private key: %w", err)) - - return - } - - var stakeTokenAddr types.Address - - if params.mintStakeToken { - stakeTokenAddr = types.StringToAddress(params.stakeTokenAddr) - } - - results := make([]command.CommandResult, len(params.addresses)) - g, ctx := errgroup.WithContext(cmd.Context()) - - for i := 0; i < len(params.addresses); i++ { - i := i - - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - - default: - validatorAddr := types.StringToAddress(params.addresses[i]) - fundAddr := ethgo.Address(validatorAddr) - txn := helper.CreateTransaction(ethgo.ZeroAddress, &fundAddr, nil, params.amountValues[i], true) - - var ( - receipt *ethgo.Receipt - err error - ) - - if params.deployerPrivateKey != "" { - receipt, err = txRelayer.SendTransaction(txn, deployerKey) - } else { - receipt, err = txRelayer.SendTransactionLocal(txn) - } - - if err != nil { - return fmt.Errorf("failed to send fund validator '%s' transaction: %w", validatorAddr, err) - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("failed to fund validator '%s'", validatorAddr) - } - - if params.mintStakeToken { - // mint tokens to validator, so he is able to send them - mintTxn, err := helper.CreateMintTxn(validatorAddr, stakeTokenAddr, params.amountValues[i], true) - if err != nil { - return fmt.Errorf("failed to create mint native tokens transaction for validator '%s'. err: %w", - validatorAddr, err) - } - - receipt, err := txRelayer.SendTransaction(mintTxn, deployerKey) - if err != nil { - return fmt.Errorf("failed to send mint native tokens transaction to validator '%s'. err: %w", validatorAddr, err) - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("failed to mint native tokens to validator '%s'", validatorAddr) - } - } - - results[i] = &result{ - ValidatorAddr: validatorAddr, - TxHash: types.Hash(receipt.TransactionHash), - IsMinted: params.mintStakeToken, - } - } - - return nil - }) - } - - if err := g.Wait(); err != nil { - outputter.SetError(err) - _, _ = outputter.Write([]byte("[ROOTCHAIN FUND] Successfully funded following accounts\n")) - - for _, result := range results { - if result != nil { - // In case an error happened, some of the indices may not be populated. - // Filter those out. - outputter.SetCommandResult(result) - } - } - - return - } - - outputter.SetCommandResult(command.Results(results)) -} diff --git a/command/rootchain/fund/params.go b/command/rootchain/fund/params.go deleted file mode 100644 index 70b1fcc..0000000 --- a/command/rootchain/fund/params.go +++ /dev/null @@ -1,70 +0,0 @@ -package fund - -import ( - "errors" - "fmt" - "math/big" - - cmdhelper "github.com/xgr-network/xgr-node/command/helper" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/types" -) - -const ( - jsonRPCFlag = "json-rpc" - mintStakeTokenFlag = "mint" -) - -var ( - errNoAddressesProvided = errors.New("no addresses provided") - errInconsistentLength = errors.New("addresses and amounts must be equal length") -) - -type fundParams struct { - addresses []string - amounts []string - stakeTokenAddr string - deployerPrivateKey string - mintStakeToken bool - jsonRPCAddress string - - amountValues []*big.Int -} - -func (fp *fundParams) validateFlags() error { - if len(fp.addresses) == 0 { - return rootHelper.ErrNoAddressesProvided - } - - if len(fp.amounts) != len(fp.addresses) { - return rootHelper.ErrInconsistentLength - } - - for _, addr := range fp.addresses { - if err := types.IsValidAddress(addr); err != nil { - return err - } - } - - fp.amountValues = make([]*big.Int, len(fp.amounts)) - for i, amountRaw := range fp.amounts { - amountValue, err := cmdhelper.ParseAmount(amountRaw) - if err != nil { - return err - } - - fp.amountValues[i] = amountValue - } - - if fp.mintStakeToken { - if fp.stakeTokenAddr == "" { - return rootHelper.ErrMandatoryStakeToken - } - - if err := types.IsValidAddress(fp.stakeTokenAddr); err != nil { - return fmt.Errorf("invalid stake token address is provided: %w", err) - } - } - - return nil -} diff --git a/command/rootchain/fund/params_test.go b/command/rootchain/fund/params_test.go deleted file mode 100644 index 11f0dec..0000000 --- a/command/rootchain/fund/params_test.go +++ /dev/null @@ -1,105 +0,0 @@ -package fund - -import ( - "fmt" - "testing" - - "github.com/stretchr/testify/require" - - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/types" -) - -func Test_validateFlags(t *testing.T) { - t.Parallel() - - cases := []struct { - buildParamsFn func() *fundParams - err string - }{ - { - // no addresses provided - buildParamsFn: func() *fundParams { - return &fundParams{} - }, - err: errNoAddressesProvided.Error(), - }, - { - // inconsistent length (addresses vs amounts) - buildParamsFn: func() *fundParams { - return &fundParams{ - addresses: []string{"0x1", "0x2"}, - amounts: []string{"10"}, - } - }, - err: errInconsistentLength.Error(), - }, - { - // address contains invalid characters - buildParamsFn: func() *fundParams { - return &fundParams{ - addresses: []string{"0x10", "0x20"}, - amounts: []string{"10", "20"}, - } - }, - err: "address \x10 has invalid length", - }, - { - // stake token address omitted - buildParamsFn: func() *fundParams { - return &fundParams{ - mintStakeToken: true, - addresses: []string{ - types.StringToAddress("0x10").String(), - types.StringToAddress("0x20").String()}, - amounts: []string{"10", "20"}, - } - }, - err: rootHelper.ErrMandatoryStakeToken.Error(), - }, - { - // stake token address omitted - buildParamsFn: func() *fundParams { - return &fundParams{ - mintStakeToken: true, - stakeTokenAddr: "0xA", - addresses: []string{ - types.StringToAddress("0x10").String(), - types.StringToAddress("0x20").String()}, - amounts: []string{"10", "20"}, - } - }, - err: "invalid stake token address is provided", - }, - { - // valid scenario - buildParamsFn: func() *fundParams { - return &fundParams{ - addresses: []string{ - types.StringToAddress("0x10").String(), - types.StringToAddress("0x20").String()}, - amounts: []string{"10", "20"}, - } - }, - err: "", - }, - } - - for i, c := range cases { - c := c - i := i - - t.Run(fmt.Sprintf("case#%d", i+1), func(t *testing.T) { - t.Parallel() - - fp := c.buildParamsFn() - - err := fp.validateFlags() - if c.err != "" { - require.ErrorContains(t, err, c.err) - } else { - require.NoError(t, err) - } - }) - } -} diff --git a/command/rootchain/fund/result.go b/command/rootchain/fund/result.go deleted file mode 100644 index 07a5647..0000000 --- a/command/rootchain/fund/result.go +++ /dev/null @@ -1,30 +0,0 @@ -package fund - -import ( - "bytes" - "fmt" - - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/types" -) - -type result struct { - ValidatorAddr types.Address `json:"address"` - TxHash types.Hash `json:"tx_hash"` - IsMinted bool `json:"mint"` -} - -func (r *result) GetOutput() string { - var buffer bytes.Buffer - - vals := make([]string, 0, 3) - vals = append(vals, fmt.Sprintf("Validator (address)|%s", r.ValidatorAddr)) - vals = append(vals, fmt.Sprintf("Transaction (hash)|%s", r.TxHash)) - vals = append(vals, fmt.Sprintf("Is minted|%v", r.IsMinted)) - - buffer.WriteString("\n[ROOTCHAIN FUND]\n") - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/helper/utils.go b/command/rootchain/helper/utils.go deleted file mode 100644 index bfe7602..0000000 --- a/command/rootchain/helper/utils.go +++ /dev/null @@ -1,330 +0,0 @@ -package helper - -import ( - "bytes" - "context" - "errors" - "fmt" - "math/big" - - dockertypes "github.com/docker/docker/api/types" - "github.com/docker/docker/client" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/wallet" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - polybftWallet "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/helper/hex" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -//nolint:gosec -const ( - TestAccountPrivKey = "aa75e9a7d427efc732f8e4f1a5b7646adcc61fd5bae40f80d13c8419c9f43d6d" - TestModeFlag = "test" - SupernetManagerFlag = "supernet-manager" - SupernetManagerFlagDesc = "address of supernet manager contract" - StakeManagerFlag = "stake-manager" - StakeManagerFlagDesc = "address of stake manager contract" - NativeRootTokenFlag = "native-root-token" - NativeRootTokenFlagDesc = "address of native root token" - GenesisPathFlag = "genesis" - GenesisPathFlagDesc = "genesis file path, which contains chain configuration" - DefaultGenesisPath = "./genesis.json" - StakeTokenFlag = "stake-token" - StakeTokenFlagDesc = "address of ERC20 token used for staking on rootchain" - ProxyContractsAdminFlag = "proxy-contracts-admin" - ProxyContractsAdminDesc = "admin for proxy contracts" - AddressesFlag = "addresses" - AmountsFlag = "amounts" - Erc20TokenFlag = "erc20-token" //nolint:gosec -) - -var ( - ErrRootchainNotFound = errors.New("rootchain not found") - ErrRootchainPortBind = errors.New("port 8545 is not bind with localhost") - ErrMandatoryStakeToken = errors.New("stake token address is mandatory") - errTestModeSecrets = errors.New("rootchain test mode does not imply specifying secrets parameters") - - ErrNoAddressesProvided = errors.New("no addresses provided") - ErrInconsistentLength = errors.New("addresses and amounts must be equal length") - - ErrMandatoryERC20Token = errors.New("erc20 token address is mandatory") - - rootchainAccountKey *wallet.Key -) - -type MessageResult struct { - Message string `json:"message"` -} - -func (r MessageResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString(r.Message) - buffer.WriteString("\n") - - return buffer.String() -} - -// DecodePrivateKey decodes a private key from provided raw private key -func DecodePrivateKey(rawKey string) (ethgo.Key, error) { - privateKeyRaw := TestAccountPrivKey - if rawKey != "" { - privateKeyRaw = rawKey - } - - dec, err := hex.DecodeString(privateKeyRaw) - if err != nil { - return nil, fmt.Errorf("failed to decode private key string '%s': %w", privateKeyRaw, err) - } - - rootchainAccountKey, err = wallet.NewWalletFromPrivKey(dec) - if err != nil { - return nil, fmt.Errorf("failed to initialize key from provided private key '%s': %w", privateKeyRaw, err) - } - - return rootchainAccountKey, nil -} - -func GetRootchainID() (string, error) { - cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation()) - if err != nil { - return "", fmt.Errorf("rootchain id error: %w", err) - } - - containers, err := cli.ContainerList(context.Background(), dockertypes.ContainerListOptions{}) - if err != nil { - return "", fmt.Errorf("rootchain id error: %w", err) - } - - for _, c := range containers { - if c.Labels["edge-type"] == "rootchain" { - return c.ID, nil - } - } - - return "", ErrRootchainNotFound -} - -func ReadRootchainIP() (string, error) { - cli, err := client.NewClientWithOpts(client.FromEnv) - if err != nil { - return "", fmt.Errorf("rootchain id error: %w", err) - } - - contID, err := GetRootchainID() - if err != nil { - return "", err - } - - inspect, err := cli.ContainerInspect(context.Background(), contID) - if err != nil { - return "", fmt.Errorf("rootchain ip error: %w", err) - } - - ports, ok := inspect.HostConfig.PortBindings["8545/tcp"] - if !ok || len(ports) == 0 { - return "", ErrRootchainPortBind - } - - return fmt.Sprintf("http://%s:%s", ports[0].HostIP, ports[0].HostPort), nil -} - -// GetECDSAKey returns the key based on provided parameters -// If private key is provided, it will return that key -// if not, it will return the key from the secrets manager -func GetECDSAKey(privateKey, accountDir, accountConfig string) (ethgo.Key, error) { - if privateKey != "" { - key, err := DecodePrivateKey(privateKey) - if err != nil { - return nil, fmt.Errorf("failed to initialize private key: %w", err) - } - - return key, nil - } - - secretsManager, err := polybftsecrets.GetSecretsManager(accountDir, accountConfig, true) - if err != nil { - return nil, err - } - - return polybftWallet.GetEcdsaFromSecret(secretsManager) -} - -// GetValidatorInfo queries SupernetManager smart contract on root -// and retrieves validator info for given address -func GetValidatorInfo(validatorAddr ethgo.Address, supernetManagerAddr, stakeManagerAddr types.Address, - chainID int64, txRelayer txrelayer.TxRelayer) (*polybft.ValidatorInfo, error) { - caller := ethgo.Address(contracts.SystemCaller) - getValidatorMethod := contractsapi.CustomSupernetManager.Abi.GetMethod("getValidator") - - encode, err := getValidatorMethod.Encode([]interface{}{validatorAddr}) - if err != nil { - return nil, err - } - - response, err := txRelayer.Call(caller, ethgo.Address(supernetManagerAddr), encode) - if err != nil { - return nil, err - } - - byteResponse, err := hex.DecodeHex(response) - if err != nil { - return nil, fmt.Errorf("unable to decode hex response, %w", err) - } - - decoded, err := getValidatorMethod.Outputs.Decode(byteResponse) - if err != nil { - return nil, err - } - - decodedOutputsMap, ok := decoded.(map[string]interface{}) - if !ok { - return nil, fmt.Errorf("could not convert decoded outputs to map") - } - - innerMap, ok := decodedOutputsMap["0"].(map[string]interface{}) - if !ok { - return nil, fmt.Errorf("could not convert decoded outputs map to inner map") - } - - //nolint:forcetypeassert - validatorInfo := &polybft.ValidatorInfo{ - Address: validatorAddr, - IsActive: innerMap["isActive"].(bool), - IsWhitelisted: innerMap["isWhitelisted"].(bool), - } - - stakeOfFn := &contractsapi.StakeOfStakeManagerFn{ - ID: new(big.Int).SetInt64(chainID), - Validator: types.Address(validatorAddr), - } - - encode, err = stakeOfFn.EncodeAbi() - if err != nil { - return nil, err - } - - response, err = txRelayer.Call(caller, ethgo.Address(stakeManagerAddr), encode) - if err != nil { - return nil, err - } - - stake, err := common.ParseUint256orHex(&response) - if err != nil { - return nil, err - } - - validatorInfo.Stake = stake - - return validatorInfo, nil -} - -// CreateMintTxn encodes parameters for mint function on rootchain token contract -func CreateMintTxn(receiver, erc20TokenAddr types.Address, - amount *big.Int, rootchainTx bool) (*ethgo.Transaction, error) { - mintFn := &contractsapi.MintRootERC20Fn{ - To: receiver, - Amount: amount, - } - - input, err := mintFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode provided parameters: %w", err) - } - - addr := ethgo.Address(erc20TokenAddr) - txn := CreateTransaction(ethgo.ZeroAddress, &addr, input, nil, rootchainTx) - - return txn, nil -} - -// CreateApproveERC20Txn sends approve transaction -// to ERC20 token for spender so that it is able to spend given tokens -func CreateApproveERC20Txn(amount *big.Int, - spender, erc20TokenAddr types.Address, rootchainTx bool) (*ethgo.Transaction, error) { - approveFnParams := &contractsapi.ApproveRootERC20Fn{ - Spender: spender, - Amount: amount, - } - - input, err := approveFnParams.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode parameters for RootERC20.approve. error: %w", err) - } - - addr := ethgo.Address(erc20TokenAddr) - - return CreateTransaction(ethgo.ZeroAddress, &addr, input, nil, rootchainTx), nil -} - -// SendTransaction sends provided transaction -func SendTransaction(txRelayer txrelayer.TxRelayer, addr ethgo.Address, input []byte, contractName string, - deployerKey ethgo.Key) (*ethgo.Receipt, error) { - txn := CreateTransaction(ethgo.ZeroAddress, &addr, input, nil, true) - - receipt, err := txRelayer.SendTransaction(txn, deployerKey) - if err != nil { - return nil, fmt.Errorf("failed to send transaction to %s contract (%s). error: %w", - contractName, txn.To.Address(), err) - } - - if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { - return nil, fmt.Errorf("transaction execution failed on %s contract", contractName) - } - - return receipt, nil -} - -// CreateTransaction is a helper function that creates either dynamic fee or legacy transaction based on provided flag -func CreateTransaction(sender ethgo.Address, receiver *ethgo.Address, - input []byte, value *big.Int, isDynamicFee bool) *ethgo.Transaction { - txn := ðgo.Transaction{ - From: sender, - To: receiver, - Input: input, - Value: value, - } - - if isDynamicFee { - txn.Type = ethgo.TransactionDynamicFee - } else { - txn.Type = ethgo.TransactionLegacy - } - - return txn -} - -func DeployProxyContract(txRelayer txrelayer.TxRelayer, deployerKey ethgo.Key, proxyContractName string, - proxyAdmin, logicAddress types.Address) (*ethgo.Receipt, error) { - proxyConstructorFn := contractsapi.TransparentUpgradeableProxyConstructorFn{ - Logic: logicAddress, - Admin_: proxyAdmin, - Data: []byte{}, - } - - constructorInput, err := proxyConstructorFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode proxy constructor function for %s contract. error: %w", - proxyContractName, err) - } - - var proxyDeployInput []byte - - proxyDeployInput = append(proxyDeployInput, contractsapi.TransparentUpgradeableProxy.Bytecode...) - proxyDeployInput = append(proxyDeployInput, constructorInput...) - - txn := CreateTransaction(ethgo.ZeroAddress, nil, proxyDeployInput, nil, true) - - receipt, err := txRelayer.SendTransaction(txn, deployerKey) - if err != nil { - return nil, fmt.Errorf("failed sending %s contract deploy transaction: %w", proxyContractName, err) - } - - return receipt, nil -} diff --git a/command/rootchain/premine/params.go b/command/rootchain/premine/params.go deleted file mode 100644 index 6c249de..0000000 --- a/command/rootchain/premine/params.go +++ /dev/null @@ -1,94 +0,0 @@ -package premine - -import ( - "bytes" - "errors" - "fmt" - "math/big" - - "github.com/xgr-network/xgr-node/command/helper" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/types" -) - -var ( - errMandatorySupernetManagerAddr = errors.New("custom supernet manager address not defined") - errMandatoryRootPredicateAddr = errors.New("root erc20 predicate address not defined") -) - -const rootERC20PredicateFlag = "root-erc20-predicate" - -type premineParams struct { - accountDir string - accountConfig string - privateKey string - customSupernetManager string - rootERC20Predicate string - nativeTokenRoot string - jsonRPC string - amount string - - amountValue *big.Int -} - -func (p *premineParams) validateFlags() (err error) { - if p.nativeTokenRoot == "" { - return rootHelper.ErrMandatoryERC20Token - } - - if err := types.IsValidAddress(p.nativeTokenRoot); err != nil { - return fmt.Errorf("invalid erc20 token address is provided: %w", err) - } - - if p.customSupernetManager == "" { - return errMandatorySupernetManagerAddr - } - - if err := types.IsValidAddress(p.customSupernetManager); err != nil { - return fmt.Errorf("invalid supernet manager address is provided: %w", err) - } - - if p.rootERC20Predicate == "" { - return errMandatoryRootPredicateAddr - } - - if err := types.IsValidAddress(p.rootERC20Predicate); err != nil { - return fmt.Errorf("invalid root erc20 predicate address is provided: %w", err) - } - - if p.amountValue, err = helper.ParseAmount(p.amount); err != nil { - return err - } - - // validate jsonrpc address - if _, err := helper.ParseJSONRPCAddress(p.jsonRPC); err != nil { - return fmt.Errorf("failed to parse json rpc address. Error: %w", err) - } - - if p.privateKey == "" { - return sidechainHelper.ValidateSecretFlags(p.accountDir, p.accountConfig) - } - - return nil -} - -type premineResult struct { - Address string `json:"address"` - Amount *big.Int `json:"amount"` -} - -func (p premineResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[NATIVE ROOT TOKEN PREMINE]\n") - - vals := make([]string, 0, 2) - vals = append(vals, fmt.Sprintf("Address|%s", p.Address)) - vals = append(vals, fmt.Sprintf("Amount Premined|%d", p.Amount)) - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/premine/premine.go b/command/rootchain/premine/premine.go deleted file mode 100644 index 44a03cc..0000000 --- a/command/rootchain/premine/premine.go +++ /dev/null @@ -1,158 +0,0 @@ -package premine - -import ( - "fmt" - "time" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var ( - params premineParams -) - -func GetCommand() *cobra.Command { - premineCmd := &cobra.Command{ - Use: "premine", - Short: "Premine native root token to the caller, which determines genesis balances. " + - "This command is used in case Supernets native token is rootchain originated.", - PreRunE: runPreRun, - RunE: runCommand, - } - - helper.RegisterJSONRPCFlag(premineCmd) - setFlags(premineCmd) - - return premineCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.privateKey, - polybftsecrets.PrivateKeyFlag, - "", - polybftsecrets.PrivateKeyFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.customSupernetManager, - rootHelper.SupernetManagerFlag, - "", - rootHelper.SupernetManagerFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.nativeTokenRoot, - rootHelper.Erc20TokenFlag, - "", - "address of root erc20 native token", - ) - - cmd.Flags().StringVar( - ¶ms.rootERC20Predicate, - rootERC20PredicateFlag, - "", - "address of root erc20 predicate", - ) - - cmd.Flags().StringVar( - ¶ms.amount, - sidechainHelper.AmountFlag, - "", - "amount to premine", - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.PrivateKeyFlag, polybftsecrets.AccountConfigFlag) - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.PrivateKeyFlag, polybftsecrets.AccountDirFlag) -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - ownerKey, err := rootHelper.GetECDSAKey(params.privateKey, params.accountDir, params.accountConfig) - if err != nil { - return err - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC), - txrelayer.WithReceiptTimeout(150*time.Millisecond)) - if err != nil { - return err - } - - approveTxn, err := rootHelper.CreateApproveERC20Txn( - params.amountValue, - types.StringToAddress(params.customSupernetManager), - types.StringToAddress(params.nativeTokenRoot), true) - if err != nil { - return err - } - - receipt, err := txRelayer.SendTransaction(approveTxn, ownerKey) - if err != nil { - return err - } - - if receipt == nil || receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("approve transaction failed on block %d", receipt.BlockNumber) - } - - premineFn := &contractsapi.AddGenesisBalanceCustomSupernetManagerFn{ - Amount: params.amountValue, - } - - premineInput, err := premineFn.EncodeAbi() - if err != nil { - return err - } - - supernetManagerAddr := ethgo.Address(types.StringToAddress(params.customSupernetManager)) - txn := rootHelper.CreateTransaction(ownerKey.Address(), &supernetManagerAddr, premineInput, nil, true) - - receipt, err = txRelayer.SendTransaction(txn, ownerKey) - if err != nil { - return err - } - - if receipt == nil || receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("premine transaction failed on block %d", receipt.BlockNumber) - } - - outputter.WriteCommandResult(&premineResult{ - Address: ownerKey.Address().String(), - Amount: params.amountValue, - }) - - return nil -} diff --git a/command/rootchain/registration/params.go b/command/rootchain/registration/params.go deleted file mode 100644 index 8b12c01..0000000 --- a/command/rootchain/registration/params.go +++ /dev/null @@ -1,45 +0,0 @@ -package registration - -import ( - "bytes" - "fmt" - - "github.com/xgr-network/xgr-node/command/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" -) - -type registerParams struct { - accountDir string - accountConfig string - supernetManagerAddress string - jsonRPC string -} - -func (rp *registerParams) validateFlags() error { - // validate jsonrpc address - _, err := helper.ParseJSONRPCAddress(rp.jsonRPC) - if err != nil { - return fmt.Errorf("failed to parse json rpc address. Error: %w", err) - } - - return sidechainHelper.ValidateSecretFlags(rp.accountDir, rp.accountConfig) -} - -type registerResult struct { - validatorAddress string - koskSignature string -} - -func (rr registerResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[VALIDATOR REGISTRATION]\n") - - vals := make([]string, 0, 2) - vals = append(vals, fmt.Sprintf("Validator Address|%s", rr.validatorAddress)) - vals = append(vals, fmt.Sprintf("KOSK Signature|%s", rr.koskSignature)) - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/registration/register_validator.go b/command/rootchain/registration/register_validator.go deleted file mode 100644 index 23941da..0000000 --- a/command/rootchain/registration/register_validator.go +++ /dev/null @@ -1,166 +0,0 @@ -package registration - -import ( - "encoding/hex" - "errors" - "fmt" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var params registerParams - -func GetCommand() *cobra.Command { - registerCmd := &cobra.Command{ - Use: "register-validator", - Short: "registers a whitelisted validator to supernet manager on rootchain", - PreRunE: runPreRun, - RunE: runCommand, - } - - setFlags(registerCmd) - - return registerCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.supernetManagerAddress, - rootHelper.SupernetManagerFlag, - "", - rootHelper.SupernetManagerFlagDesc, - ) - - helper.RegisterJSONRPCFlag(cmd) - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountConfigFlag, polybftsecrets.AccountDirFlag) -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - secretsManager, err := polybftsecrets.GetSecretsManager(params.accountDir, params.accountConfig, true) - if err != nil { - return err - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC)) - if err != nil { - return err - } - - rootChainID, err := txRelayer.Client().Eth().ChainID() - if err != nil { - return err - } - - newValidatorAccount, err := wallet.NewAccountFromSecret(secretsManager) - if err != nil { - return err - } - - koskSignature, err := signer.MakeKOSKSignature( - newValidatorAccount.Bls, newValidatorAccount.Address(), - rootChainID.Int64(), signer.DomainValidatorSet, types.StringToAddress(params.supernetManagerAddress)) - if err != nil { - return err - } - - receipt, err := registerValidator(txRelayer, newValidatorAccount, koskSignature) - if err != nil { - return err - } - - if receipt.Status != uint64(types.ReceiptSuccess) { - return errors.New("register validator transaction failed") - } - - result := ®isterResult{} - foundLog := false - - var validatorRegisteredEvent contractsapi.ValidatorRegisteredEvent - for _, log := range receipt.Logs { - doesMatch, err := validatorRegisteredEvent.ParseLog(log) - if err != nil { - return err - } - - if !doesMatch { - continue - } - - koskSignatureRaw, err := koskSignature.Marshal() - if err != nil { - return err - } - - result.koskSignature = hex.EncodeToString(koskSignatureRaw) - result.validatorAddress = validatorRegisteredEvent.Validator.String() - - foundLog = true - - break - } - - if !foundLog { - return fmt.Errorf("could not find an appropriate log in receipt that registration happened") - } - - outputter.WriteCommandResult(result) - - return nil -} - -func registerValidator(sender txrelayer.TxRelayer, account *wallet.Account, - signature *bls.Signature) (*ethgo.Receipt, error) { - sigMarshal, err := signature.ToBigInt() - if err != nil { - return nil, fmt.Errorf("register validator failed: %w", err) - } - - registerFn := &contractsapi.RegisterCustomSupernetManagerFn{ - Signature: sigMarshal, - Pubkey: account.Bls.PublicKey().ToBigInt(), - } - - input, err := registerFn.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("register validator failed: %w", err) - } - - supernetAddr := ethgo.Address(types.StringToAddress(params.supernetManagerAddress)) - txn := rootHelper.CreateTransaction(ethgo.ZeroAddress, &supernetAddr, input, nil, true) - - return sender.SendTransaction(txn, account.Ecdsa) -} diff --git a/command/rootchain/rootchain.go b/command/rootchain/rootchain.go deleted file mode 100644 index 4377fa5..0000000 --- a/command/rootchain/rootchain.go +++ /dev/null @@ -1,31 +0,0 @@ -package rootchain - -import ( - "github.com/spf13/cobra" - - "github.com/xgr-network/xgr-node/command/rootchain/deploy" - "github.com/xgr-network/xgr-node/command/rootchain/fund" - "github.com/xgr-network/xgr-node/command/rootchain/premine" - "github.com/xgr-network/xgr-node/command/rootchain/server" -) - -// GetCommand creates "rootchain" helper command -func GetCommand() *cobra.Command { - rootchainCmd := &cobra.Command{ - Use: "rootchain", - Short: "Top level rootchain helper command.", - } - - rootchainCmd.AddCommand( - // rootchain server - server.GetCommand(), - // rootchain deploy - deploy.GetCommand(), - // rootchain fund - fund.GetCommand(), - // rootchain premine - premine.GetCommand(), - ) - - return rootchainCmd -} diff --git a/command/rootchain/server/params.go b/command/rootchain/server/params.go deleted file mode 100644 index 5a20d7b..0000000 --- a/command/rootchain/server/params.go +++ /dev/null @@ -1,11 +0,0 @@ -package server - -const ( - dataDirFlag = "data-dir" - noConsole = "no-console" -) - -type serverParams struct { - dataDir string - noConsole bool -} diff --git a/command/rootchain/server/result.go b/command/rootchain/server/result.go deleted file mode 100644 index b44b070..0000000 --- a/command/rootchain/server/result.go +++ /dev/null @@ -1,41 +0,0 @@ -package server - -import ( - "bytes" - "fmt" - - "github.com/docker/docker/api/types/container" - - "github.com/xgr-network/xgr-node/command/helper" -) - -type containerStopResult struct { - Status int64 `json:"status"` - Err string `json:"err"` -} - -func newContainerStopResult(status container.WaitResponse) *containerStopResult { - errMsg := "" - if status.Error != nil { - errMsg = status.Error.Message - } - - return &containerStopResult{ - Status: status.StatusCode, - Err: errMsg, - } -} - -func (r containerStopResult) GetOutput() string { - var buffer bytes.Buffer - - vals := make([]string, 0, 2) - vals = append(vals, fmt.Sprintf("Status|%d", r.Status)) - vals = append(vals, fmt.Sprintf("Error|%s", r.Err)) - - buffer.WriteString("\n[ROOTCHAIN SERVER - STOP]\n") - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/server/server.go b/command/rootchain/server/server.go deleted file mode 100644 index 9709083..0000000 --- a/command/rootchain/server/server.go +++ /dev/null @@ -1,299 +0,0 @@ -package server - -import ( - "context" - "errors" - "fmt" - "io" - "log" - "net/http" - "os" - "os/signal" - "path/filepath" - "strings" - "syscall" - "time" - - dockertypes "github.com/docker/docker/api/types" - "github.com/docker/docker/api/types/container" - dockerclient "github.com/docker/docker/client" - "github.com/docker/docker/pkg/stdcopy" - "github.com/docker/go-connections/nat" - "github.com/spf13/cobra" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/helper/common" -) - -const ( - gethConsoleImage = "ghcr.io/0xpolygon/go-ethereum-console:latest" - gethImage = "ethereum/client-go:v1.9.25" - - defaultHostIP = "127.0.0.1" - defaultHostPort = "8545" -) - -var ( - params serverParams - dockerClient *dockerclient.Client - dockerContainerID string -) - -// GetCommand returns the rootchain server command -func GetCommand() *cobra.Command { - rootchainServerCmd := &cobra.Command{ - Use: "server", - Short: "Start the rootchain command", - PreRunE: runPreRun, - Run: runCommand, - } - - setFlags(rootchainServerCmd) - - return rootchainServerCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.dataDir, - dataDirFlag, - "test-rootchain", - "target directory for the chain", - ) - - cmd.Flags().BoolVar( - ¶ms.noConsole, - noConsole, - false, - "use the official geth image instead of the console fork", - ) -} - -func runPreRun(_ *cobra.Command, _ []string) error { - return nil -} - -func runCommand(cmd *cobra.Command, _ []string) { - ctx := cmd.Context() - - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - closeCh := make(chan struct{}) - - // Check if the client is already running - if cid, err := helper.GetRootchainID(); !errors.Is(err, helper.ErrRootchainNotFound) { - if err != nil { - outputter.SetError(err) - } else if cid != "" { - outputter.SetError(fmt.Errorf("rootchain already running: %s", cid)) - } - - return - } - - // Start the client - if err := runRootchain(ctx, outputter, closeCh); err != nil { - outputter.SetError(fmt.Errorf("failed to run rootchain: %w", err)) - - return - } - - // Ping geth server to make sure everything is up and running - if err := PingServer(closeCh); err != nil { - close(closeCh) - - if ip, err := helper.ReadRootchainIP(); err != nil { - outputter.SetError(fmt.Errorf("failed to ping rootchain server: %w", err)) - } else { - outputter.SetError(fmt.Errorf("failed to ping rootchain server at address %s: %w", ip, err)) - } - - return - } - - // Gather the logs - go func() { - if err := gatherLogs(ctx, outputter); err != nil { - outputter.SetError(fmt.Errorf("failed to gether logs: %w", err)) - - return - } - }() - - if err := handleSignals(ctx, closeCh); err != nil { - outputter.SetError(fmt.Errorf("failed to handle signals: %w", err)) - } -} - -func runRootchain(ctx context.Context, outputter command.OutputFormatter, closeCh chan struct{}) error { - var err error - if dockerClient, err = dockerclient.NewClientWithOpts(dockerclient.FromEnv, - dockerclient.WithAPIVersionNegotiation()); err != nil { - return err - } - - // target directory for the chain - if err = common.CreateDirSafe(params.dataDir, 0700); err != nil { - return err - } - - image := gethConsoleImage - if params.noConsole { - image = gethImage - } - - // try to pull the image - reader, err := dockerClient.ImagePull(ctx, image, dockertypes.ImagePullOptions{}) - if err != nil { - return err - } - defer reader.Close() - - if _, err = io.Copy(outputter, reader); err != nil { - return fmt.Errorf("cannot copy: %w", err) - } - - // create the client - args := []string{"--dev"} - - // add period of 2 seconds - args = append(args, "--dev.period", "2") - - // add data dir - args = append(args, "--datadir", "/eth1data") - - // add ipcpath - args = append(args, "--ipcpath", "/eth1data/geth.ipc") - - // enable rpc - args = append(args, "--http", "--http.addr", "0.0.0.0", "--http.api", "eth,net,web3,debug") - - // enable ws - args = append(args, "--ws", "--ws.addr", "0.0.0.0") - - config := &container.Config{ - Image: image, - Cmd: args, - Labels: map[string]string{ - "edge-type": "rootchain", - }, - } - - mountDir := params.dataDir - - // we need to use the full path - if !strings.HasPrefix(params.dataDir, "/") { - // if the path is not absolute, assume we want to create it locally - // in current folder - pwdDir, err := os.Getwd() - if err != nil { - log.Fatal(err) - } else { - mountDir = filepath.Join(pwdDir, params.dataDir) - } - } - - port := nat.Port(fmt.Sprintf("%s/tcp", defaultHostPort)) - hostConfig := &container.HostConfig{ - Binds: []string{ - mountDir + ":/eth1data", - }, - PortBindings: nat.PortMap{ - port: []nat.PortBinding{ - { - HostIP: defaultHostIP, - HostPort: defaultHostPort, - }, - }, - }, - } - - resp, err := dockerClient.ContainerCreate(ctx, config, hostConfig, nil, nil, "") - if err != nil { - return err - } - - // start the client - if err = dockerClient.ContainerStart(ctx, resp.ID, dockertypes.ContainerStartOptions{}); err != nil { - return err - } - - dockerContainerID = resp.ID - - // wait for it to finish - go func() { - statusCh, errCh := dockerClient.ContainerWait(ctx, dockerContainerID, container.WaitConditionNotRunning) - select { - case err = <-errCh: - outputter.SetError(err) - case status := <-statusCh: - outputter.SetCommandResult(newContainerStopResult(status)) - } - close(closeCh) - }() - - return nil -} - -func gatherLogs(ctx context.Context, outputter command.OutputFormatter) error { - opts := dockertypes.ContainerLogsOptions{ - ShowStderr: true, - ShowStdout: true, - Follow: true, - } - - out, err := dockerClient.ContainerLogs(ctx, dockerContainerID, opts) - if err != nil { - return fmt.Errorf("failed to retrieve container logs: %w", err) - } - - if _, err = stdcopy.StdCopy(outputter, outputter, out); err != nil { - return fmt.Errorf("failed to write container logs to the stdout: %w", err) - } - - return nil -} - -func PingServer(closeCh <-chan struct{}) error { - httpTimer := time.NewTimer(30 * time.Second) - httpClient := http.Client{ - Timeout: 5 * time.Second, - } - - for { - select { - case <-time.After(500 * time.Millisecond): - resp, err := httpClient.Post(fmt.Sprintf("http://%s:%s", defaultHostIP, defaultHostPort), "application/json", nil) - if err == nil { - return resp.Body.Close() - } - case <-httpTimer.C: - return fmt.Errorf("timeout to start http") - case <-closeCh: - return fmt.Errorf("closed before connecting with http. Is there any other process running and using rootchain dir?") - } - } -} - -func handleSignals(ctx context.Context, closeCh <-chan struct{}) error { - signalCh := make(chan os.Signal, 4) - signal.Notify(signalCh, os.Interrupt, syscall.SIGTERM, syscall.SIGHUP) - - stop := true - select { - case <-signalCh: - case <-closeCh: - stop = false - } - - // close the container if possible - if stop { - if err := dockerClient.ContainerStop(ctx, dockerContainerID, container.StopOptions{}); err != nil { - return fmt.Errorf("failed to stop container: %w", err) - } - } - - return nil -} diff --git a/command/rootchain/staking/params.go b/command/rootchain/staking/params.go deleted file mode 100644 index 68cd93d..0000000 --- a/command/rootchain/staking/params.go +++ /dev/null @@ -1,57 +0,0 @@ -package staking - -import ( - "bytes" - "fmt" - "math/big" - - "github.com/xgr-network/xgr-node/command/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" -) - -var supernetIDFlag = "supernet-id" - -type stakeParams struct { - accountDir string - accountConfig string - stakeManagerAddr string - stakeTokenAddr string - jsonRPC string - supernetID int64 - amount string - - amountValue *big.Int -} - -func (sp *stakeParams) validateFlags() (err error) { - if sp.amountValue, err = helper.ParseAmount(sp.amount); err != nil { - return err - } - - // validate jsonrpc address - if _, err := helper.ParseJSONRPCAddress(sp.jsonRPC); err != nil { - return fmt.Errorf("failed to parse json rpc address. Error: %w", err) - } - - return sidechainHelper.ValidateSecretFlags(sp.accountDir, sp.accountConfig) -} - -type stakeResult struct { - ValidatorAddress string `json:"validatorAddress"` - Amount *big.Int `json:"amount"` -} - -func (sr stakeResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[VALIDATOR STAKE]\n") - - vals := make([]string, 0, 2) - vals = append(vals, fmt.Sprintf("Validator Address|%s", sr.ValidatorAddress)) - vals = append(vals, fmt.Sprintf("Amount Staked|%d", sr.Amount)) - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/staking/stake.go b/command/rootchain/staking/stake.go deleted file mode 100644 index 860b3f8..0000000 --- a/command/rootchain/staking/stake.go +++ /dev/null @@ -1,177 +0,0 @@ -package staking - -import ( - "fmt" - "math/big" - "time" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var ( - params stakeParams -) - -func GetCommand() *cobra.Command { - stakeCmd := &cobra.Command{ - Use: "stake", - Short: "Stakes the amount sent for validator on rootchain", - PreRunE: runPreRun, - RunE: runCommand, - } - - helper.RegisterJSONRPCFlag(stakeCmd) - setFlags(stakeCmd) - - return stakeCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.stakeManagerAddr, - rootHelper.StakeManagerFlag, - "", - rootHelper.StakeManagerFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.amount, - sidechainHelper.AmountFlag, - "", - "amount to stake", - ) - - cmd.Flags().Int64Var( - ¶ms.supernetID, - supernetIDFlag, - 0, - "ID of supernet provided by stake manager on supernet registration", - ) - - cmd.Flags().StringVar( - ¶ms.stakeTokenAddr, - rootHelper.StakeTokenFlag, - "", - rootHelper.StakeTokenFlagDesc, - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - validatorAccount, err := sidechainHelper.GetAccount(params.accountDir, params.accountConfig) - if err != nil { - return err - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC), - txrelayer.WithReceiptTimeout(150*time.Millisecond)) - if err != nil { - return err - } - - approveTxn, err := rootHelper.CreateApproveERC20Txn(params.amountValue, - types.StringToAddress(params.stakeManagerAddr), types.StringToAddress(params.stakeTokenAddr), true) - if err != nil { - return err - } - - receipt, err := txRelayer.SendTransaction(approveTxn, validatorAccount.Ecdsa) - if err != nil { - return err - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("approve transaction failed on block %d", receipt.BlockNumber) - } - - stakeFn := contractsapi.StakeForStakeManagerFn{ - ID: new(big.Int).SetInt64(params.supernetID), - Amount: params.amountValue, - } - - encoded, err := stakeFn.EncodeAbi() - if err != nil { - return err - } - - stakeManagerAddr := ethgo.Address(types.StringToAddress(params.stakeManagerAddr)) - - txn := rootHelper.CreateTransaction(validatorAccount.Ecdsa.Address(), &stakeManagerAddr, encoded, nil, true) - - receipt, err = txRelayer.SendTransaction(txn, validatorAccount.Ecdsa) - if err != nil { - return err - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("staking transaction failed on block %d", receipt.BlockNumber) - } - - result := &stakeResult{ - ValidatorAddress: validatorAccount.Ecdsa.Address().String(), - } - - var ( - stakeAddedEvent contractsapi.StakeAddedEvent - foundLog bool - ) - - // check the logs to check for the result - for _, log := range receipt.Logs { - doesMatch, err := stakeAddedEvent.ParseLog(log) - if err != nil { - return err - } - - if !doesMatch { - continue - } - - result.Amount = stakeAddedEvent.Amount - result.ValidatorAddress = stakeAddedEvent.Validator.String() - foundLog = true - - break - } - - if !foundLog { - return fmt.Errorf("could not find an appropriate log in receipt that stake happened") - } - - outputter.WriteCommandResult(result) - - return nil -} diff --git a/command/rootchain/supernet/params.go b/command/rootchain/supernet/params.go deleted file mode 100644 index e566fff..0000000 --- a/command/rootchain/supernet/params.go +++ /dev/null @@ -1,69 +0,0 @@ -package supernet - -import ( - "bytes" - "fmt" - "os" - - "github.com/xgr-network/xgr-node/command/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" -) - -const ( - finalizeGenesisSetFlag = "finalize-genesis-set" - enableStakingFlag = "enable-staking" -) - -type supernetParams struct { - accountDir string - accountConfig string - privateKey string - jsonRPC string - supernetManagerAddress string - genesisPath string - stakeManagerAddress string - finalizeGenesisSet bool - enableStaking bool -} - -func (sp *supernetParams) validateFlags() error { - if sp.privateKey == "" { - return sidechainHelper.ValidateSecretFlags(sp.accountDir, sp.accountConfig) - } - - if _, err := os.Stat(sp.genesisPath); err != nil { - return fmt.Errorf("provided genesis path '%s' is invalid. Error: %w ", sp.genesisPath, err) - } - - // validate jsonrpc address - _, err := helper.ParseJSONRPCAddress(sp.jsonRPC) - - return err -} - -type supernetResult struct { - IsGenesisSetFinalized bool `json:"isGenesisSetFinalized"` - IsStakingEnabled bool `json:"isStakingEnabled"` -} - -func (sr supernetResult) GetOutput() string { - var ( - buffer bytes.Buffer - vals []string - ) - - buffer.WriteString("\n[SUPERNET COMMAND]\n") - - if sr.IsGenesisSetFinalized { - vals = append(vals, "Genesis validator set finalized on supernet manager") - } - - if sr.IsStakingEnabled { - vals = append(vals, "Staking enabled on supernet manager") - } - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/supernet/stakemanager/params.go b/command/rootchain/supernet/stakemanager/params.go deleted file mode 100644 index 60d0a17..0000000 --- a/command/rootchain/supernet/stakemanager/params.go +++ /dev/null @@ -1,53 +0,0 @@ -package stakemanager - -import ( - "fmt" - "os" - - "github.com/xgr-network/xgr-node/command/helper" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/types" -) - -type stakeManagerDeployParams struct { - accountDir string - accountConfig string - privateKey string - jsonRPC string - genesisPath string - stakeTokenAddress string - proxyContractsAdmin string - isTestMode bool -} - -func (s *stakeManagerDeployParams) validateFlags() error { - if !s.isTestMode { - // private key is mandatory - if s.privateKey == "" { - return sidechainHelper.ValidateSecretFlags(s.accountDir, s.accountConfig) - } - - // stake token address is mandatory - if s.stakeTokenAddress == "" { - return rootHelper.ErrMandatoryStakeToken - } - - if err := types.IsValidAddress(s.stakeTokenAddress); err != nil { - return fmt.Errorf("invalid stake token address is provided: %w", err) - } - } - - // check if provided genesis path is valid - if _, err := os.Stat(s.genesisPath); err != nil { - return fmt.Errorf("provided genesis path '%s' is invalid. Error: %w ", s.genesisPath, err) - } - - // validate jsonrpc address - _, err := helper.ParseJSONRPCAddress(s.jsonRPC) - if err != nil { - return err - } - - return helper.ValidateProxyContractsAdmin(s.proxyContractsAdmin) -} diff --git a/command/rootchain/supernet/stakemanager/params_test.go b/command/rootchain/supernet/stakemanager/params_test.go deleted file mode 100644 index 421bac4..0000000 --- a/command/rootchain/supernet/stakemanager/params_test.go +++ /dev/null @@ -1,48 +0,0 @@ -package stakemanager - -import ( - "fmt" - "testing" - - "github.com/stretchr/testify/require" - - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" -) - -func TestValidateFlags(t *testing.T) { - t.Parallel() - - testCases := []struct { - params *stakeManagerDeployParams - errMsg string - }{ - { - params: &stakeManagerDeployParams{ - isTestMode: false, - privateKey: rootHelper.TestAccountPrivKey, - stakeTokenAddress: "", - }, - errMsg: rootHelper.ErrMandatoryStakeToken.Error(), - }, - { - params: &stakeManagerDeployParams{ - isTestMode: false, - privateKey: rootHelper.TestAccountPrivKey, - stakeTokenAddress: "0x1B", - }, - errMsg: "invalid stake token address is provided", - }, - } - - for i, tc := range testCases { - i := i - tc := tc - - t.Run(fmt.Sprintf("case#%d", i+1), func(t *testing.T) { - t.Parallel() - - err := tc.params.validateFlags() - require.ErrorContains(t, err, tc.errMsg) - }) - } -} diff --git a/command/rootchain/supernet/stakemanager/stake_manager_deploy.go b/command/rootchain/supernet/stakemanager/stake_manager_deploy.go deleted file mode 100644 index 4c13ce9..0000000 --- a/command/rootchain/supernet/stakemanager/stake_manager_deploy.go +++ /dev/null @@ -1,282 +0,0 @@ -package stakemanager - -import ( - "errors" - "fmt" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi/artifact" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" - "golang.org/x/sync/errgroup" -) - -var params stakeManagerDeployParams - -func GetCommand() *cobra.Command { - stakeMgrDeployCmd := &cobra.Command{ - Use: "stake-manager-deploy", - Short: "Command for deploying stake manager contract on rootchain", - PreRunE: preRunCommand, - RunE: runCommand, - } - - setFlags(stakeMgrDeployCmd) - - return stakeMgrDeployCmd -} - -func preRunCommand(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.privateKey, - polybftsecrets.PrivateKeyFlag, - "", - polybftsecrets.PrivateKeyFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.genesisPath, - rootHelper.GenesisPathFlag, - rootHelper.DefaultGenesisPath, - rootHelper.GenesisPathFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.stakeTokenAddress, - rootHelper.StakeTokenFlag, - "", - rootHelper.StakeTokenFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.proxyContractsAdmin, - rootHelper.ProxyContractsAdminFlag, - "", - rootHelper.ProxyContractsAdminDesc, - ) - - cmd.Flags().BoolVar( - ¶ms.isTestMode, - rootHelper.TestModeFlag, - false, - "indicates if command is run in test mode. If test mode is used contract will be deployed using test account "+ - "and a test stake ERC20 token will be deployed to be used for staking", - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.PrivateKeyFlag, polybftsecrets.AccountConfigFlag) - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.PrivateKeyFlag, polybftsecrets.AccountDirFlag) - cmd.MarkFlagsMutuallyExclusive(rootHelper.TestModeFlag, polybftsecrets.PrivateKeyFlag) - cmd.MarkFlagsMutuallyExclusive(rootHelper.TestModeFlag, polybftsecrets.AccountConfigFlag) - cmd.MarkFlagsMutuallyExclusive(rootHelper.TestModeFlag, polybftsecrets.AccountDirFlag) - cmd.MarkFlagsMutuallyExclusive(rootHelper.TestModeFlag, rootHelper.StakeTokenFlag) - - helper.RegisterJSONRPCFlag(cmd) -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - var ( - deployerKey ethgo.Key - err error - ) - - if params.isTestMode { - deployerKey, err = rootHelper.DecodePrivateKey("") - } else { - deployerKey, err = rootHelper.GetECDSAKey(params.privateKey, params.accountDir, params.accountConfig) - } - - if err != nil { - return fmt.Errorf("failed to get deployer key: %w", err) - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC)) - if err != nil { - return fmt.Errorf("deploying stake manager failed: %w", err) - } - - if params.isTestMode { - // fund deployer so that he can deploy contracts - deployerAddr := deployerKey.Address() - txn := rootHelper.CreateTransaction(ethgo.ZeroAddress, &deployerAddr, nil, ethgo.Ether(1), true) - - if _, err = txRelayer.SendTransactionLocal(txn); err != nil { - return fmt.Errorf("failed to send local transaction: %w", err) - } - } - - var ( - stakeManagerAddress types.Address - stakeTokenAddress = types.StringToAddress(params.stakeTokenAddress) - g, ctx = errgroup.WithContext(cmd.Context()) - ) - - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - default: - // deploy stake manager - contractAddress, err := deployContract(txRelayer, deployerKey, - contractsapi.StakeManager, "StakeManager") - if err != nil { - return err - } - - // deploy stake manager proxy - receipt, err := rootHelper.DeployProxyContract(txRelayer, deployerKey, "StakeManagerProxy", - types.StringToAddress(params.proxyContractsAdmin), contractAddress) - if err != nil { - return err - } - - if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { - return errors.New("deployment of StakeManagerProxy contract failed") - } - - outputter.WriteCommandResult(&rootHelper.MessageResult{ - Message: "[STAKEMANAGER - DEPLOY] Successfully deployed StakeManager contract", - }) - - stakeManagerAddress = types.Address(receipt.ContractAddress) - - return nil - } - }) - - if params.isTestMode { - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - default: - // this is only used for testing, we are deploying a test ERC20 token to use for staking - // this should not be used in production - // deploy stake manager - contractAddress, err := deployContract(txRelayer, deployerKey, - contractsapi.RootERC20, "MockERC20StakeToken") - if err != nil { - return err - } - - outputter.WriteCommandResult(&rootHelper.MessageResult{ - Message: "[STAKEMANAGER - DEPLOY] Successfully deployed MockERC20StakeToken contract", - }) - - stakeTokenAddress = contractAddress - - return nil - } - }) - } - - if err := g.Wait(); err != nil { - return err - } - - // initialize stake manager - if err := initializeStakeManager(outputter, txRelayer, - stakeManagerAddress, stakeTokenAddress, deployerKey); err != nil { - return fmt.Errorf("could not initialize stake manager contract. Error: %w", err) - } - - // update stake manager address in genesis - chainConfig, err := chain.ImportFromFile(params.genesisPath) - if err != nil { - return fmt.Errorf("failed to read chain configuration: %w", err) - } - - consensusConfig, err := polybft.GetPolyBFTConfig(chainConfig) - if err != nil { - return fmt.Errorf("failed to retrieve consensus configuration: %w", err) - } - - if consensusConfig.Bridge == nil { - consensusConfig.Bridge = &polybft.BridgeConfig{} - } - - consensusConfig.Bridge.StakeManagerAddr = stakeManagerAddress - consensusConfig.Bridge.StakeTokenAddr = stakeTokenAddress - - // write updated chain configuration - chainConfig.Params.Engine[polybft.ConsensusName] = consensusConfig - - if err = helper.WriteGenesisConfigToDisk(chainConfig, params.genesisPath); err != nil { - return fmt.Errorf("failed to save chain configuration bridge data: %w", err) - } - - return nil -} - -// initializeStakeManager invokes initialize function on StakeManager contract -func initializeStakeManager(cmdOutput command.OutputFormatter, - txRelayer txrelayer.TxRelayer, - stakeManagerAddress types.Address, - stakeTokenAddress types.Address, - deployerKey ethgo.Key) error { - initFn := &contractsapi.InitializeStakeManagerFn{NewStakingToken: stakeTokenAddress} - - input, err := initFn.EncodeAbi() - if err != nil { - return err - } - - if _, err := rootHelper.SendTransaction(txRelayer, ethgo.Address(stakeManagerAddress), - input, "StakeManager", deployerKey); err != nil { - return err - } - - cmdOutput.WriteCommandResult(&rootHelper.MessageResult{ - Message: "[STAKEMANAGER - DEPLOY] StakeManager contract is initialized", - }) - - return nil -} - -func deployContract(txRelayer txrelayer.TxRelayer, deployerKey ethgo.Key, - artifact *artifact.Artifact, contractName string) (types.Address, error) { - txn := rootHelper.CreateTransaction(ethgo.ZeroAddress, nil, artifact.Bytecode, nil, true) - - receipt, err := txRelayer.SendTransaction(txn, deployerKey) - if err != nil { - return types.ZeroAddress, - fmt.Errorf("failed sending %s contract deploy transaction: %w", contractName, err) - } - - if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { - return types.ZeroAddress, fmt.Errorf("deployment of %s contract failed", contractName) - } - - return types.Address(receipt.ContractAddress), nil -} diff --git a/command/rootchain/supernet/supernet.go b/command/rootchain/supernet/supernet.go deleted file mode 100644 index 475a0e4..0000000 --- a/command/rootchain/supernet/supernet.go +++ /dev/null @@ -1,400 +0,0 @@ -package supernet - -import ( - "errors" - "fmt" - "math/big" - "strings" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/genesis" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/helper/hex" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var ( - params supernetParams - genesisSetABIFn = contractsapi.CustomSupernetManager.Abi.Methods["genesisSet"] - genesisBalancesABIFn = contractsapi.CustomSupernetManager.Abi.Methods["genesisBalances"] -) - -func GetCommand() *cobra.Command { - registerCmd := &cobra.Command{ - Use: "supernet", - Short: "Supernet initialization & finalization command", - PreRunE: runPreRun, - RunE: runCommand, - } - - setFlags(registerCmd) - - return registerCmd -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.privateKey, - polybftsecrets.PrivateKeyFlag, - "", - polybftsecrets.PrivateKeyFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.genesisPath, - rootHelper.GenesisPathFlag, - rootHelper.DefaultGenesisPath, - rootHelper.GenesisPathFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.supernetManagerAddress, - rootHelper.SupernetManagerFlag, - "", - rootHelper.SupernetManagerFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.stakeManagerAddress, - rootHelper.StakeManagerFlag, - "", - fmt.Sprintf("[DEPRECATED] %s", rootHelper.StakeManagerFlagDesc), - ) - - cmd.Flags().BoolVar( - ¶ms.finalizeGenesisSet, - finalizeGenesisSetFlag, - false, - "indicates if genesis validator set should be finalized on rootchain", - ) - - cmd.Flags().BoolVar( - ¶ms.enableStaking, - enableStakingFlag, - false, - "indicates if staking will be enabled after finalization of genesis validators on rootchain", - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.PrivateKeyFlag, polybftsecrets.AccountConfigFlag) - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.PrivateKeyFlag, polybftsecrets.AccountDirFlag) - - helper.RegisterJSONRPCFlag(cmd) -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - ownerKey, err := rootHelper.GetECDSAKey(params.privateKey, params.accountDir, params.accountConfig) - if err != nil { - return err - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC)) - if err != nil { - return fmt.Errorf("enlist validator failed: %w", err) - } - - supernetAddr := ethgo.Address(types.StringToAddress(params.supernetManagerAddress)) - - if params.finalizeGenesisSet { - encoded, err := contractsapi.CustomSupernetManager.Abi.Methods["finalizeGenesis"].Encode([]interface{}{}) - if err != nil { - return err - } - - txn := rootHelper.CreateTransaction(ownerKey.Address(), &supernetAddr, encoded, nil, true) - - if _, err = txRelayer.Call(ownerKey.Address(), supernetAddr, encoded); err == nil { - receipt, err := txRelayer.SendTransaction(txn, ownerKey) - if err != nil { - return fmt.Errorf("finalizing genesis validator set failed. Error: %w", err) - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("finalizing genesis validator set transaction failed on block %d", receipt.BlockNumber) - } - } else if !strings.Contains(err.Error(), "execution reverted: GenesisLib: already finalized") { - return err - } - - chainConfig, err := chain.ImportFromFile(params.genesisPath) - if err != nil { - return fmt.Errorf("failed to read chain configuration: %w", err) - } - - consensusConfig, err := polybft.GetPolyBFTConfig(chainConfig) - if err != nil { - return fmt.Errorf("failed to retrieve consensus configuration: %w", err) - } - - validatorMetadata := make([]*validator.ValidatorMetadata, len(consensusConfig.InitialValidatorSet)) - - genesisSetInput, err := genesisSetABIFn.Encode([]interface{}{}) - if err != nil { - return fmt.Errorf("failed to encode genesis set input: %w", err) - } - - genesisSetHexOut, err := txRelayer.Call(ethgo.ZeroAddress, supernetAddr, genesisSetInput) - if err != nil { - return fmt.Errorf("failed to retrieve genesis set: %w", err) - } - - genesisAccounts, err := decodeGenesisAccounts(genesisSetHexOut) - if err != nil { - return err - } - - genesisAccsMap := make(map[types.Address]*validator.GenesisValidator, len(genesisAccounts)) - - for _, genesisAcc := range genesisAccounts { - genesisBalanceInput, err := genesisBalancesABIFn.Encode([]interface{}{genesisAcc.Address}) - if err != nil { - return err - } - - genesisBalanceRaw, err := txRelayer.Call(ethgo.ZeroAddress, supernetAddr, genesisBalanceInput) - if err != nil { - return err - } - - genesisBalance, err := common.ParseUint256orHex(&genesisBalanceRaw) - if err != nil { - return fmt.Errorf("failed to convert genesis balance '%s' to number: %w", - genesisBalanceRaw, err) - } - - genesisAccsMap[genesisAcc.Address] = genesisAcc - - if genesisBalance.Sign() > 0 { - // premine genesis accounts - chainConfig.Genesis.Alloc[genesisAcc.Address] = - &chain.GenesisAccount{Balance: genesisBalance} - } - } - - // update Stake field of validators in genesis file - // based on their finalized stake on rootchain - for i, v := range consensusConfig.InitialValidatorSet { - genesisAcc, exists := genesisAccsMap[v.Address] - if !exists { - return fmt.Errorf("validator with address %s not found among genesis accounts", v.Address) - } - - v.Stake = genesisAcc.Stake - - metadata, err := v.ToValidatorMetadata() - if err != nil { - return err - } - - validatorMetadata[i] = metadata - } - - // update the voting power in genesis block extra - // based on finalized stake on rootchain - genesisExtraData, err := genesis.GenerateExtraDataPolyBft(validatorMetadata) - if err != nil { - return err - } - - chainConfig.Genesis.ExtraData = genesisExtraData - chainConfig.Params.Engine[polybft.ConsensusName] = consensusConfig - - // save updated stake and genesis extra to genesis file on disk - if err := helper.WriteGenesisConfigToDisk(chainConfig, params.genesisPath); err != nil { - return fmt.Errorf("failed to save chain configuration bridge data: %w", err) - } - - // initialize CheckpointManager contract since it needs to have a valid VotingPowers of validators - if err := initializeCheckpointManager(outputter, txRelayer, - consensusConfig, chainConfig.Params.ChainID, ownerKey); err != nil { - return fmt.Errorf("could not initialize CheckpointManager with finalized genesis validator set: %w", err) - } - } - - if params.enableStaking { - encoded, err := contractsapi.CustomSupernetManager.Abi.Methods["enableStaking"].Encode([]interface{}{}) - if err != nil { - return err - } - - txn := rootHelper.CreateTransaction(ownerKey.Address(), &supernetAddr, encoded, nil, true) - - receipt, err := txRelayer.SendTransaction(txn, ownerKey) - if err != nil { - return fmt.Errorf("enabling staking on supernet manager failed. Error: %w", err) - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("enable staking transaction failed on block %d", receipt.BlockNumber) - } - } - - result := &supernetResult{ - IsGenesisSetFinalized: params.finalizeGenesisSet, - IsStakingEnabled: params.enableStaking, - } - - outputter.WriteCommandResult(result) - - return nil -} - -// decodeGenesisAccounts decodes genesis set retrieved from CustomSupernetManager contract -func decodeGenesisAccounts(genesisSetRaw string) ([]*validator.GenesisValidator, error) { - decodeAccount := func(rawAccount map[string]interface{}) (*validator.GenesisValidator, error) { - addr, ok := rawAccount["addr"].(ethgo.Address) - if !ok { - return nil, errors.New("failed to retrieve genesis account address") - } - - stake, ok := rawAccount["initialStake"].(*big.Int) - if !ok { - return nil, errors.New("failed to retrieve genesis account stake") - } - - return &validator.GenesisValidator{ - Address: types.Address(addr), - Stake: stake, - }, nil - } - - genesisSetRawOut, err := hex.DecodeHex(genesisSetRaw) - if err != nil { - return nil, fmt.Errorf("failed to decode genesis set from hex format: %w", err) - } - - decodedGenesisSet, err := genesisSetABIFn.Outputs.Decode(genesisSetRawOut) - if err != nil { - return nil, fmt.Errorf("failed to decode genesis set from raw format: %w", err) - } - - decodedGenesisSetMap, ok := decodedGenesisSet.(map[string]interface{}) - if !ok { - return nil, errors.New("failed to convert genesis set to map") - } - - decodedGenesisSetSliceMap, ok := decodedGenesisSetMap["0"].([]map[string]interface{}) - if !ok { - return nil, errors.New("failed to convert genesis set to slice") - } - - genesisAccounts := make([]*validator.GenesisValidator, len(decodedGenesisSetSliceMap)) - for i, rawGenesisAccount := range decodedGenesisSetSliceMap { - genesisAccounts[i], err = decodeAccount(rawGenesisAccount) - if err != nil { - return nil, err - } - } - - return genesisAccounts, nil -} - -// validatorSetToABISlice converts given validators to generic map -// which is used for ABI encoding validator set being sent to the rootchain contract -func validatorSetToABISlice(o command.OutputFormatter, - validators []*validator.GenesisValidator) ([]*contractsapi.Validator, error) { - accSet := make(validator.AccountSet, len(validators)) - - if _, err := o.Write([]byte("[VALIDATORS - CHECKPOINT MANAGER] \n")); err != nil { - return nil, err - } - - for i, val := range validators { - if _, err := o.Write([]byte(fmt.Sprintf("%v\n", val))); err != nil { - return nil, err - } - - blsKey, err := val.UnmarshalBLSPublicKey() - if err != nil { - return nil, err - } - - accSet[i] = &validator.ValidatorMetadata{ - Address: val.Address, - BlsKey: blsKey, - VotingPower: new(big.Int).Set(val.Stake), - } - } - - hash, err := accSet.Hash() - if err != nil { - return nil, err - } - - if _, err := o.Write([]byte( - fmt.Sprintf("[VALIDATORS - CHECKPOINT MANAGER] Validators hash: %s\n", hash))); err != nil { - return nil, err - } - - return accSet.ToAPIBinding(), nil -} - -// initializeCheckpointManager initializes CheckpointManager contract on rootchain -// based on finalized stake (voting power) of genesis validators on root -func initializeCheckpointManager(outputter command.OutputFormatter, - txRelayer txrelayer.TxRelayer, - consensusConfig polybft.PolyBFTConfig, chainID int64, - deployerKey ethgo.Key) error { - validatorSet, err := validatorSetToABISlice(outputter, consensusConfig.InitialValidatorSet) - if err != nil { - return fmt.Errorf("failed to convert validators to map: %w", err) - } - - initParams := &contractsapi.InitializeCheckpointManagerFn{ - ChainID_: big.NewInt(chainID), - NewBls: consensusConfig.Bridge.BLSAddress, - NewBn256G2: consensusConfig.Bridge.BN256G2Address, - NewValidatorSet: validatorSet, - } - - input, err := initParams.EncodeAbi() - if err != nil { - return fmt.Errorf("failed to encode initialization params for CheckpointManager.initialize. error: %w", err) - } - - if _, err := rootHelper.SendTransaction(txRelayer, ethgo.Address(consensusConfig.Bridge.CheckpointManagerAddr), - input, "CheckpointManager", deployerKey); err != nil { - return err - } - - outputter.WriteCommandResult( - &rootHelper.MessageResult{ - Message: fmt.Sprintf("CheckpointManager contract is initialized"), - }) - - return nil -} diff --git a/command/rootchain/validators/params.go b/command/rootchain/validators/params.go deleted file mode 100644 index 936b770..0000000 --- a/command/rootchain/validators/params.go +++ /dev/null @@ -1,50 +0,0 @@ -package validators - -import ( - "bytes" - "fmt" - - "github.com/xgr-network/xgr-node/command/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" -) - -type validatorInfoParams struct { - accountDir string - accountConfig string - jsonRPC string - supernetManagerAddress string - stakeManagerAddress string - chainID int64 -} - -func (v *validatorInfoParams) validateFlags() error { - if _, err := helper.ParseJSONRPCAddress(v.jsonRPC); err != nil { - return fmt.Errorf("failed to parse json rpc address. Error: %w", err) - } - - return sidechainHelper.ValidateSecretFlags(v.accountDir, v.accountConfig) -} - -type validatorsInfoResult struct { - Address string `json:"address"` - Stake uint64 `json:"stake"` - Active bool `json:"active"` - Whitelisted bool `json:"whitelisted"` -} - -func (vr validatorsInfoResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[VALIDATOR INFO]\n") - - vals := make([]string, 4) - vals[0] = fmt.Sprintf("Validator Address|%s", vr.Address) - vals[1] = fmt.Sprintf("Stake|%v", vr.Stake) - vals[2] = fmt.Sprintf("Is Whitelisted|%v", vr.Whitelisted) - vals[3] = fmt.Sprintf("Is Active|%v", vr.Active) - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/validators/validator_info.go b/command/rootchain/validators/validator_info.go deleted file mode 100644 index 8df0adb..0000000 --- a/command/rootchain/validators/validator_info.go +++ /dev/null @@ -1,111 +0,0 @@ -package validators - -import ( - "fmt" - - "github.com/spf13/cobra" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var ( - params validatorInfoParams -) - -func GetCommand() *cobra.Command { - validatorInfoCmd := &cobra.Command{ - Use: "validator-info", - Short: "Gets validator info", - PreRunE: runPreRun, - RunE: runCommand, - } - - helper.RegisterJSONRPCFlag(validatorInfoCmd) - setFlags(validatorInfoCmd) - - return validatorInfoCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.supernetManagerAddress, - rootHelper.SupernetManagerFlag, - "", - rootHelper.SupernetManagerFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.stakeManagerAddress, - rootHelper.StakeManagerFlag, - "", - rootHelper.StakeManagerFlagDesc, - ) - - cmd.Flags().Int64Var( - ¶ms.chainID, - polybftsecrets.ChainIDFlag, - 0, - polybftsecrets.ChainIDFlagDesc, - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - validatorAccount, err := sidechainHelper.GetAccount(params.accountDir, params.accountConfig) - if err != nil { - return err - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC)) - if err != nil { - return err - } - - validatorAddr := validatorAccount.Ecdsa.Address() - supernetManagerAddr := types.StringToAddress(params.supernetManagerAddress) - stakeManagerAddr := types.StringToAddress(params.stakeManagerAddress) - - validatorInfo, err := rootHelper.GetValidatorInfo(validatorAddr, - supernetManagerAddr, stakeManagerAddr, params.chainID, txRelayer) - if err != nil { - return fmt.Errorf("failed to get validator info for %s: %w", validatorAddr, err) - } - - outputter.WriteCommandResult(&validatorsInfoResult{ - Address: validatorInfo.Address.String(), - Stake: validatorInfo.Stake.Uint64(), - Active: validatorInfo.IsActive, - Whitelisted: validatorInfo.IsWhitelisted, - }) - - return nil -} diff --git a/command/rootchain/whitelist/params.go b/command/rootchain/whitelist/params.go deleted file mode 100644 index 81e9c49..0000000 --- a/command/rootchain/whitelist/params.go +++ /dev/null @@ -1,62 +0,0 @@ -package whitelist - -import ( - "bytes" - "errors" - "fmt" - - "github.com/xgr-network/xgr-node/command/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" -) - -const ( - newValidatorAddressesFlag = "addresses" -) - -var ( - errNoNewValidatorsProvided = errors.New("no new validators addresses provided") -) - -type whitelistParams struct { - accountDir string - accountConfig string - privateKey string - jsonRPC string - newValidatorAddresses []string - supernetManagerAddress string -} - -func (ep *whitelistParams) validateFlags() error { - if len(ep.newValidatorAddresses) == 0 { - return errNoNewValidatorsProvided - } - - if ep.privateKey == "" { - return sidechainHelper.ValidateSecretFlags(ep.accountDir, ep.accountConfig) - } - - // validate jsonrpc address - _, err := helper.ParseJSONRPCAddress(ep.jsonRPC) - - return err -} - -type whitelistResult struct { - NewValidatorAddresses []string `json:"newValidatorAddresses"` -} - -func (wr whitelistResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[WHITELIST VALIDATORS]\n") - - vals := make([]string, len(wr.NewValidatorAddresses)) - for i, addr := range wr.NewValidatorAddresses { - vals[i] = fmt.Sprintf("Validator address|%s", addr) - } - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/whitelist/whitelist_validators.go b/command/rootchain/whitelist/whitelist_validators.go deleted file mode 100644 index d7f43fd..0000000 --- a/command/rootchain/whitelist/whitelist_validators.go +++ /dev/null @@ -1,152 +0,0 @@ -package whitelist - -import ( - "fmt" - "time" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var params whitelistParams - -func GetCommand() *cobra.Command { - registerCmd := &cobra.Command{ - Use: "whitelist-validators", - Short: "whitelist new validators", - PreRunE: runPreRun, - RunE: runCommand, - } - - setFlags(registerCmd) - - return registerCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.privateKey, - polybftsecrets.PrivateKeyFlag, - "", - polybftsecrets.PrivateKeyFlagDesc, - ) - - cmd.Flags().StringSliceVar( - ¶ms.newValidatorAddresses, - newValidatorAddressesFlag, - []string{}, - "account addresses of a possible validators", - ) - - cmd.Flags().StringVar( - ¶ms.supernetManagerAddress, - rootHelper.SupernetManagerFlag, - "", - rootHelper.SupernetManagerFlagDesc, - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.PrivateKeyFlag, polybftsecrets.AccountConfigFlag) - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.PrivateKeyFlag, polybftsecrets.AccountDirFlag) - - helper.RegisterJSONRPCFlag(cmd) -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - ecdsaKey, err := rootHelper.GetECDSAKey(params.privateKey, params.accountDir, params.accountConfig) - if err != nil { - return err - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC), - txrelayer.WithReceiptTimeout(150*time.Millisecond)) - if err != nil { - return fmt.Errorf("whitelist validator failed. Could not create tx relayer: %w", err) - } - - whitelistFn := &contractsapi.WhitelistValidatorsCustomSupernetManagerFn{ - Validators_: stringSliceToAddressSlice(params.newValidatorAddresses), - } - - encoded, err := whitelistFn.EncodeAbi() - if err != nil { - return fmt.Errorf("whitelist validator failed. Could not abi encode whitelist function: %w", err) - } - - supernetAddr := ethgo.Address(types.StringToAddress(params.supernetManagerAddress)) - txn := rootHelper.CreateTransaction(ecdsaKey.Address(), &supernetAddr, encoded, nil, true) - - receipt, err := txRelayer.SendTransaction(txn, ecdsaKey) - if err != nil { - return fmt.Errorf("whitelist validator failed %w", err) - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("whitelist validator transaction failed on block %d", receipt.BlockNumber) - } - - var ( - whitelistEvent contractsapi.AddedToWhitelistEvent - result = &whitelistResult{} - ) - - for _, log := range receipt.Logs { - doesMatch, err := whitelistEvent.ParseLog(log) - if !doesMatch { - continue - } - - if err != nil { - return err - } - - result.NewValidatorAddresses = append(result.NewValidatorAddresses, whitelistEvent.Validator.String()) - } - - if len(result.NewValidatorAddresses) != len(params.newValidatorAddresses) { - return fmt.Errorf("whitelist of validators did not pass successfully") - } - - outputter.WriteCommandResult(result) - - return nil -} - -func stringSliceToAddressSlice(addrs []string) []ethgo.Address { - res := make([]ethgo.Address, len(addrs)) - for indx, addr := range addrs { - res[indx] = ethgo.Address(types.StringToAddress(addr)) - } - - return res -} diff --git a/command/rootchain/withdraw/params.go b/command/rootchain/withdraw/params.go deleted file mode 100644 index 84b0a89..0000000 --- a/command/rootchain/withdraw/params.go +++ /dev/null @@ -1,59 +0,0 @@ -package withdraw - -import ( - "bytes" - "fmt" - "math/big" - - "github.com/xgr-network/xgr-node/command/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" -) - -var ( - addressToFlag = "to" -) - -type withdrawParams struct { - accountDir string - accountConfig string - jsonRPC string - stakeManagerAddr string - addressTo string - amount string - - amountValue *big.Int -} - -func (v *withdrawParams) validateFlags() (err error) { - if v.amountValue, err = helper.ParseAmount(v.amount); err != nil { - return err - } - - if _, err = helper.ParseJSONRPCAddress(v.jsonRPC); err != nil { - return fmt.Errorf("failed to parse json rpc address. Error: %w", err) - } - - return sidechainHelper.ValidateSecretFlags(v.accountDir, v.accountConfig) -} - -type withdrawResult struct { - ValidatorAddress string `json:"validatorAddress"` - Amount uint64 `json:"amount"` - WithdrawnTo string `json:"withdrawnTo"` -} - -func (wr withdrawResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[WITHDRAWN AMOUNT]\n") - - vals := make([]string, 0, 3) - vals = append(vals, fmt.Sprintf("Validator Address|%s", wr.ValidatorAddress)) - vals = append(vals, fmt.Sprintf("Amount Withdrawn|%v", wr.Amount)) - vals = append(vals, fmt.Sprintf("Withdrawn To|%s", wr.WithdrawnTo)) - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/rootchain/withdraw/withdraw.go b/command/rootchain/withdraw/withdraw.go deleted file mode 100644 index fe22441..0000000 --- a/command/rootchain/withdraw/withdraw.go +++ /dev/null @@ -1,150 +0,0 @@ -package withdraw - -import ( - "fmt" - "time" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var params withdrawParams - -func GetCommand() *cobra.Command { - withdrawCmd := &cobra.Command{ - Use: "withdraw-root", - Short: "Withdraws sender's withdrawable amount to specified address on the root chain", - PreRunE: runPreRun, - RunE: runCommand, - } - - setFlags(withdrawCmd) - - return withdrawCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.addressTo, - addressToFlag, - "", - "address where to withdraw withdrawable amount", - ) - - cmd.Flags().StringVar( - ¶ms.stakeManagerAddr, - rootHelper.StakeManagerFlag, - "", - rootHelper.StakeManagerFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.amount, - sidechainHelper.AmountFlag, - "", - "amount to withdraw", - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) - helper.RegisterJSONRPCFlag(cmd) -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - validatorAccount, err := sidechainHelper.GetAccount(params.accountDir, params.accountConfig) - if err != nil { - return err - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC), - txrelayer.WithReceiptTimeout(150*time.Millisecond)) - if err != nil { - return err - } - - withdrawFn := &contractsapi.WithdrawStakeStakeManagerFn{ - To: types.StringToAddress(params.addressTo), - Amount: params.amountValue, - } - - encoded, err := withdrawFn.EncodeAbi() - if err != nil { - return err - } - - stakeManagerAddr := ethgo.Address(types.StringToAddress(params.stakeManagerAddr)) - txn := rootHelper.CreateTransaction(validatorAccount.Ecdsa.Address(), &stakeManagerAddr, encoded, nil, true) - - receipt, err := txRelayer.SendTransaction(txn, validatorAccount.Ecdsa) - if err != nil { - return err - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("withdraw transaction failed on block %d", receipt.BlockNumber) - } - - result := &withdrawResult{ - ValidatorAddress: validatorAccount.Ecdsa.Address().String(), - } - - var ( - withdrawalEvent contractsapi.StakeWithdrawnEvent - foundLog bool - ) - - for _, log := range receipt.Logs { - doesMatch, err := withdrawalEvent.ParseLog(log) - if !doesMatch { - continue - } - - if err != nil { - return err - } - - result.Amount = withdrawalEvent.Amount.Uint64() - result.WithdrawnTo = withdrawalEvent.Recipient.String() - foundLog = true - - break - } - - if !foundLog { - return fmt.Errorf("could not find an appropriate log in receipt that withdrawal happened") - } - - outputter.WriteCommandResult(result) - - return nil -} diff --git a/command/server/server.go b/command/server/server.go index 6a47e32..ccc6f34 100644 --- a/command/server/server.go +++ b/command/server/server.go @@ -218,7 +218,7 @@ func setFlags(cmd *cobra.Command) { ¶ms.rawConfig.Relayer, relayerFlag, defaultConfig.Relayer, - "start the state sync relayer service (PolyBFT only)", + "start the state sync relayer service", ) cmd.Flags().Uint64Var( diff --git a/command/sidechain/helper.go b/command/sidechain/helper.go deleted file mode 100644 index 9e2e33a..0000000 --- a/command/sidechain/helper.go +++ /dev/null @@ -1,90 +0,0 @@ -package sidechain - -import ( - "errors" - "fmt" - "os" - - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -const ( - AmountFlag = "amount" -) - -func CheckIfDirectoryExist(dir string) error { - if _, err := os.Stat(dir); errors.Is(err, os.ErrNotExist) { - return fmt.Errorf("provided directory '%s' doesn't exist", dir) - } - - return nil -} - -func ValidateSecretFlags(dataDir, config string) error { - if config == "" { - if dataDir == "" { - return polybftsecrets.ErrInvalidParams - } else { - return CheckIfDirectoryExist(dataDir) - } - } - - return nil -} - -// GetAccount resolves secrets manager and returns an account object -func GetAccount(accountDir, accountConfig string) (*wallet.Account, error) { - // resolve secrets manager instance and allow usage of insecure local secrets manager - secretsManager, err := polybftsecrets.GetSecretsManager(accountDir, accountConfig, true) - if err != nil { - return nil, err - } - - return wallet.NewAccountFromSecret(secretsManager) -} - -// GetAccountFromDir returns an account object from local secrets manager -func GetAccountFromDir(accountDir string) (*wallet.Account, error) { - return GetAccount(accountDir, "") -} - -// GetValidatorInfo queries CustomSupernetManager, StakeManager and RewardPool smart contracts -// to retrieve validator info for given address -func GetValidatorInfo(validatorAddr ethgo.Address, supernetManager, stakeManager types.Address, - chainID int64, rootRelayer, childRelayer txrelayer.TxRelayer) (*polybft.ValidatorInfo, error) { - validatorInfo, err := rootHelper.GetValidatorInfo(validatorAddr, supernetManager, stakeManager, - chainID, rootRelayer) - if err != nil { - return nil, err - } - - withdrawableFn := contractsapi.RewardPool.Abi.GetMethod("pendingRewards") - - encode, err := withdrawableFn.Encode([]interface{}{validatorAddr}) - if err != nil { - return nil, err - } - - response, err := childRelayer.Call(ethgo.ZeroAddress, ethgo.Address(contracts.RewardPoolContract), encode) - if err != nil { - return nil, err - } - - withdrawableRewards, err := common.ParseUint256orHex(&response) - if err != nil { - return nil, err - } - - validatorInfo.WithdrawableRewards = withdrawableRewards - - return validatorInfo, nil -} diff --git a/command/sidechain/rewards/params.go b/command/sidechain/rewards/params.go deleted file mode 100644 index cc0def8..0000000 --- a/command/sidechain/rewards/params.go +++ /dev/null @@ -1,43 +0,0 @@ -package rewards - -import ( - "bytes" - "fmt" - - "github.com/xgr-network/xgr-node/command/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" -) - -type withdrawRewardsParams struct { - accountDir string - accountConfig string - jsonRPC string -} - -type withdrawRewardResult struct { - ValidatorAddress string `json:"validatorAddress"` - RewardAmount uint64 `json:"rewardAmount"` -} - -func (w *withdrawRewardsParams) validateFlags() error { - if _, err := helper.ParseJSONRPCAddress(w.jsonRPC); err != nil { - return fmt.Errorf("failed to parse json rpc address. Error: %w", err) - } - - return sidechainHelper.ValidateSecretFlags(w.accountDir, w.accountConfig) -} - -func (wr withdrawRewardResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[WITHDRAW REWARDS]\n") - - vals := make([]string, 0, 2) - vals = append(vals, fmt.Sprintf("Validator Address|%s", wr.ValidatorAddress)) - vals = append(vals, fmt.Sprintf("Amount Withdrawn|%v", wr.RewardAmount)) - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/sidechain/rewards/rewards.go b/command/sidechain/rewards/rewards.go deleted file mode 100644 index bbf97a9..0000000 --- a/command/sidechain/rewards/rewards.go +++ /dev/null @@ -1,119 +0,0 @@ -package rewards - -import ( - "fmt" - "time" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var params withdrawRewardsParams - -func GetCommand() *cobra.Command { - unstakeCmd := &cobra.Command{ - Use: "withdraw-rewards", - Short: "Withdraws pending rewards on child chain for given validator", - PreRunE: runPreRun, - RunE: runCommand, - } - - helper.RegisterJSONRPCFlag(unstakeCmd) - setFlags(unstakeCmd) - - return unstakeCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - validatorAccount, err := sidechainHelper.GetAccount(params.accountDir, params.accountConfig) - if err != nil { - return err - } - - validatorAddr := validatorAccount.Ecdsa.Address() - rewardPoolAddr := ethgo.Address(contracts.RewardPoolContract) - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC), - txrelayer.WithReceiptTimeout(150*time.Millisecond)) - if err != nil { - return err - } - - encoded, err := contractsapi.RewardPool.Abi.Methods["pendingRewards"].Encode([]interface{}{validatorAddr}) - if err != nil { - return err - } - - response, err := txRelayer.Call(validatorAddr, rewardPoolAddr, encoded) - if err != nil { - return err - } - - amount, err := common.ParseUint256orHex(&response) - if err != nil { - return err - } - - encoded, err = contractsapi.RewardPool.Abi.Methods["withdrawReward"].Encode([]interface{}{}) - if err != nil { - return err - } - - txn := rootHelper.CreateTransaction(validatorAddr, &rewardPoolAddr, encoded, nil, false) - - receipt, err := txRelayer.SendTransaction(txn, validatorAccount.Ecdsa) - if err != nil { - return err - } - - if receipt.Status != uint64(types.ReceiptSuccess) { - return fmt.Errorf("withdraw transaction failed on block: %d", receipt.BlockNumber) - } - - result := &withdrawRewardResult{ - ValidatorAddress: validatorAccount.Ecdsa.Address().String(), - RewardAmount: amount.Uint64(), - } - - outputter.WriteCommandResult(result) - - return nil -} diff --git a/command/sidechain/unstaking/params.go b/command/sidechain/unstaking/params.go deleted file mode 100644 index d209186..0000000 --- a/command/sidechain/unstaking/params.go +++ /dev/null @@ -1,55 +0,0 @@ -package unstaking - -import ( - "bytes" - "fmt" - "math/big" - - "github.com/xgr-network/xgr-node/command/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" -) - -var ( - undelegateAddressFlag = "undelegate" -) - -type unstakeParams struct { - accountDir string - accountConfig string - jsonRPC string - amount string - - amountValue *big.Int -} - -func (v *unstakeParams) validateFlags() (err error) { - if v.amountValue, err = helper.ParseAmount(v.amount); err != nil { - return err - } - - if _, err = helper.ParseJSONRPCAddress(v.jsonRPC); err != nil { - return fmt.Errorf("failed to parse json rpc address. Error: %w", err) - } - - return sidechainHelper.ValidateSecretFlags(v.accountDir, v.accountConfig) -} - -type unstakeResult struct { - ValidatorAddress string `json:"validatorAddress"` - Amount uint64 `json:"amount"` -} - -func (ur unstakeResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[UNSTAKE]\n") - - vals := make([]string, 0, 2) - vals = append(vals, fmt.Sprintf("Validator Address|%s", ur.ValidatorAddress)) - vals = append(vals, fmt.Sprintf("Amount Unstaked|%v", ur.Amount)) - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/sidechain/unstaking/unstake.go b/command/sidechain/unstaking/unstake.go deleted file mode 100644 index d6412d7..0000000 --- a/command/sidechain/unstaking/unstake.go +++ /dev/null @@ -1,136 +0,0 @@ -package unstaking - -import ( - "fmt" - "time" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var params unstakeParams - -func GetCommand() *cobra.Command { - unstakeCmd := &cobra.Command{ - Use: "unstake", - Short: "Unstakes the amount sent for validator or undelegates amount from validator", - PreRunE: runPreRun, - RunE: runCommand, - } - - helper.RegisterJSONRPCFlag(unstakeCmd) - setFlags(unstakeCmd) - - return unstakeCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.amount, - sidechainHelper.AmountFlag, - "", - "amount to unstake from validator", - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - validatorAccount, err := sidechainHelper.GetAccount(params.accountDir, params.accountConfig) - if err != nil { - return err - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC), - txrelayer.WithReceiptTimeout(150*time.Millisecond)) - if err != nil { - return err - } - - unstakeFn := &contractsapi.UnstakeValidatorSetFn{ - Amount: params.amountValue, - } - - encoded, err := unstakeFn.EncodeAbi() - if err != nil { - return err - } - - txn := ðgo.Transaction{ - From: validatorAccount.Ecdsa.Address(), - Input: encoded, - To: (*ethgo.Address)(&contracts.ValidatorSetContract), - } - - receipt, err := txRelayer.SendTransaction(txn, validatorAccount.Ecdsa) - if err != nil { - return err - } - - if receipt.Status != uint64(types.ReceiptSuccess) { - return fmt.Errorf("unstake transaction failed on block: %d", receipt.BlockNumber) - } - - var ( - withdrawalRegisteredEvent contractsapi.WithdrawalRegisteredEvent - foundLog bool - ) - - result := &unstakeResult{ - ValidatorAddress: validatorAccount.Ecdsa.Address().String(), - } - - // check the logs to check for the result - for _, log := range receipt.Logs { - doesMatch, err := withdrawalRegisteredEvent.ParseLog(log) - if err != nil { - return err - } - - if doesMatch { - foundLog = true - result.Amount = withdrawalRegisteredEvent.Amount.Uint64() - - break - } - } - - if !foundLog { - return fmt.Errorf("could not find an appropriate log in receipt that unstake happened (withdrawal registered)") - } - - outputter.WriteCommandResult(result) - - return nil -} diff --git a/command/sidechain/withdraw/params.go b/command/sidechain/withdraw/params.go deleted file mode 100644 index 2a77307..0000000 --- a/command/sidechain/withdraw/params.go +++ /dev/null @@ -1,48 +0,0 @@ -package withdraw - -import ( - "bytes" - "fmt" - "math/big" - - "github.com/xgr-network/xgr-node/command/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" -) - -type withdrawParams struct { - accountDir string - accountConfig string - jsonRPC string -} - -func (w *withdrawParams) validateFlags() error { - if _, err := helper.ParseJSONRPCAddress(w.jsonRPC); err != nil { - return fmt.Errorf("failed to parse json rpc address. Error: %w", err) - } - - return sidechainHelper.ValidateSecretFlags(w.accountDir, w.accountConfig) -} - -type withdrawResult struct { - ValidatorAddress string `json:"validatorAddress"` - Amount *big.Int `json:"amount"` - ExitEventIDs []*big.Int `json:"exitEventIDs"` - BlockNumber uint64 `json:"blockNumber"` -} - -func (r *withdrawResult) GetOutput() string { - var buffer bytes.Buffer - - buffer.WriteString("\n[WITHDRAWAL]\n") - - vals := make([]string, 0, 4) - vals = append(vals, fmt.Sprintf("Validator Address|%s", r.ValidatorAddress)) - vals = append(vals, fmt.Sprintf("Amount Withdrawn|%d", r.Amount)) - vals = append(vals, fmt.Sprintf("Exit Event IDs|%d", r.ExitEventIDs)) - vals = append(vals, fmt.Sprintf("Inclusion Block Number|%d", r.BlockNumber)) - - buffer.WriteString(helper.FormatKV(vals)) - buffer.WriteString("\n") - - return buffer.String() -} diff --git a/command/sidechain/withdraw/withdraw.go b/command/sidechain/withdraw/withdraw.go deleted file mode 100644 index 30e161a..0000000 --- a/command/sidechain/withdraw/withdraw.go +++ /dev/null @@ -1,131 +0,0 @@ -package withdraw - -import ( - "fmt" - "time" - - "github.com/spf13/cobra" - "github.com/umbracle/ethgo" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/bridge/common" - "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - sidechainHelper "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var params withdrawParams - -func GetCommand() *cobra.Command { - unstakeCmd := &cobra.Command{ - Use: "withdraw-child", - Short: "Withdraws pending withdrawals on child chain for given validator", - PreRunE: runPreRun, - RunE: runCommand, - } - - helper.RegisterJSONRPCFlag(unstakeCmd) - setFlags(unstakeCmd) - - return unstakeCmd -} - -func setFlags(cmd *cobra.Command) { - cmd.Flags().StringVar( - ¶ms.accountDir, - polybftsecrets.AccountDirFlag, - "", - polybftsecrets.AccountDirFlagDesc, - ) - - cmd.Flags().StringVar( - ¶ms.accountConfig, - polybftsecrets.AccountConfigFlag, - "", - polybftsecrets.AccountConfigFlagDesc, - ) - - cmd.MarkFlagsMutuallyExclusive(polybftsecrets.AccountDirFlag, polybftsecrets.AccountConfigFlag) -} - -func runPreRun(cmd *cobra.Command, _ []string) error { - params.jsonRPC = helper.GetJSONRPCAddress(cmd) - - return params.validateFlags() -} - -func runCommand(cmd *cobra.Command, _ []string) error { - outputter := command.InitializeOutputter(cmd) - defer outputter.WriteOutput() - - validatorAccount, err := sidechainHelper.GetAccount(params.accountDir, params.accountConfig) - if err != nil { - return err - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(params.jsonRPC), - txrelayer.WithReceiptTimeout(150*time.Millisecond)) - if err != nil { - return err - } - - encoded, err := contractsapi.ValidatorSet.Abi.Methods["withdraw"].Encode([]interface{}{}) - if err != nil { - return err - } - - receiver := (*ethgo.Address)(&contracts.ValidatorSetContract) - txn := rootHelper.CreateTransaction(validatorAccount.Ecdsa.Address(), receiver, encoded, nil, false) - - receipt, err := txRelayer.SendTransaction(txn, validatorAccount.Ecdsa) - if err != nil { - return err - } - - if receipt.Status != uint64(types.ReceiptSuccess) { - return fmt.Errorf("withdraw transaction failed on block: %d", receipt.BlockNumber) - } - - var ( - withdrawalEvent contractsapi.WithdrawalEvent - foundLog bool - ) - - // check the logs to check for the result - for _, log := range receipt.Logs { - doesMatch, err := withdrawalEvent.ParseLog(log) - if err != nil { - return err - } - - if doesMatch { - foundLog = true - - break - } - } - - if !foundLog { - return fmt.Errorf("could not find an appropriate log in receipt that withdraw happened on ValidatorSet") - } - - exitEventIDs, err := common.ExtractExitEventIDs(receipt) - if err != nil { - return fmt.Errorf("withdrawal failed: %w", err) - } - - outputter.WriteCommandResult( - &withdrawResult{ - ValidatorAddress: validatorAccount.Ecdsa.Address().String(), - Amount: withdrawalEvent.Amount, - ExitEventIDs: exitEventIDs, - BlockNumber: receipt.BlockNumber, - }) - - return nil -} diff --git a/consensus/ibft/consensus.go b/consensus/ibft/consensus.go index 74bcd03..5170212 100644 --- a/consensus/ibft/consensus.go +++ b/consensus/ibft/consensus.go @@ -3,6 +3,7 @@ package ibft import ( "context" "sync" + "time" "github.com/0xPolygon/go-ibft/core" ) @@ -13,6 +14,7 @@ type IBFTConsensus struct { wg sync.WaitGroup + sequenceMu sync.RWMutex cancelSequence context.CancelFunc } @@ -27,15 +29,21 @@ func newIBFT( } } +// ExtendRoundTimeout extends each round timeout. +func (c *IBFTConsensus) ExtendRoundTimeout(amount time.Duration) { + c.IBFT.ExtendRoundTimeout(amount) +} + // runSequence starts the underlying consensus mechanism for the given height. // It may be called by a single thread at any given time func (c *IBFTConsensus) runSequence(height uint64) <-chan struct{} { done := make(chan struct{}) ctx, cancel := context.WithCancel(context.Background()) + c.sequenceMu.Lock() c.cancelSequence = cancel - c.wg.Add(1) + c.sequenceMu.Unlock() go func() { defer func() { @@ -52,6 +60,12 @@ func (c *IBFTConsensus) runSequence(height uint64) <-chan struct{} { // stopSequence terminates the running IBFT sequence gracefully and waits for it to return func (c *IBFTConsensus) stopSequence() { - c.cancelSequence() + c.sequenceMu.Lock() + cancel := c.cancelSequence + if cancel != nil { + cancel() + } c.wg.Wait() + c.cancelSequence = nil + c.sequenceMu.Unlock() } diff --git a/consensus/ibft/consensus_backend.go b/consensus/ibft/consensus_backend.go index b435c23..f1c5565 100644 --- a/consensus/ibft/consensus_backend.go +++ b/consensus/ibft/consensus_backend.go @@ -9,6 +9,7 @@ import ( "github.com/0xPolygon/go-ibft/messages" "github.com/0xPolygon/go-ibft/messages/proto" "github.com/xgr-network/xgr-node/consensus" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" "github.com/xgr-network/xgr-node/consensus/ibft/signer" "github.com/xgr-network/xgr-node/helper/hex" "github.com/xgr-network/xgr-node/state" @@ -16,11 +17,19 @@ import ( ) func (i *backendIBFT) BuildProposal(view *proto.View) []byte { + + if view == nil { + if i.logger != nil { + i.logger.Error("build proposal requested with nil view") + } + + return nil + } + var ( latestHeader = i.blockchain.Header() latestBlockNumber = latestHeader.Number ) - if latestBlockNumber+1 != view.Height { i.logger.Error( "unable to build block, due to lack of parent block", @@ -104,7 +113,6 @@ func (i *backendIBFT) InsertProposal( return } - i.updateMetrics(newBlock) // i.logger.Info( @@ -140,24 +148,42 @@ func (i *backendIBFT) MaximumFaultyNodes() uint64 { return uint64(CalcMaxFaultyNodes(i.currentValidators)) } -// DISCLAIMER: IBFT will be deprecated so we set 1 as a voting power to all validators func (i *backendIBFT) GetVotingPowers(height uint64) (map[string]*big.Int, error) { + if height == 0 { + return nil, fmt.Errorf("invalid height 0") + } + validators, err := i.forkManager.GetValidators(height) if err != nil { return nil, err } + parentHeader, ok := i.blockchain.GetHeaderByNumber(height - 1) + if !ok { + return nil, fmt.Errorf("parent header not found for height %d", height) + } - result := make(map[string]*big.Int, validators.Len()) - - for index := 0; index < validators.Len(); index++ { - strAddress := types.AddressToString(validators.At(uint64(index)).Addr()) - result[strAddress] = big.NewInt(1) // set 1 as voting power to everyone + result, snapshot, err := i.effectiveVotingPowerSnapshot(height, validators, parentHeader) + if err != nil { + return nil, err + } + if i.logger != nil && i.forkManager.IsPosActive(height) { + i.logger.Info( + "ibft voting powers", + "height", height, + "parentNumber", parentHeader.Number, + "parentHash", parentHeader.Hash, + "parentStateRoot", parentHeader.StateRoot, + "stakeWeightedActive", i.forkManager.IsPosActive(parentHeader.Number), + "totalVotingPower", snapshot.totalVotingPower, + "quorumThreshold", snapshot.quorumThreshold, + "votingPowers", snapshot.powers, + ) } return result, nil } -// buildBlock builds the block, based on the passed in snapshot and parent header +// buildBlock builds the block, based on the passed in snapshot and parent header. func (i *backendIBFT) buildBlock(parent *types.Header) (*types.Block, error) { header := &types.Header{ ParentHash: parent.Hash, @@ -187,8 +213,13 @@ func (i *backendIBFT) buildBlock(parent *types.Header) (*types.Block, error) { return nil, err } - // Set the header timestamp - potentialTimestamp := i.calcHeaderTimestamp(parent.Timestamp, time.Now().UTC()) + // Set the header timestamp. + // PoS mode may still use round-bound logical timestamps in the header, + // but runtime transaction writing / pacing should stay aligned with normal + // IBFT wall-clock scheduling. + var potentialTimestamp time.Time + runtimeDeadline := i.calcHeaderTimestamp(parent.Timestamp, time.Now().UTC()) + potentialTimestamp = runtimeDeadline header.Timestamp = uint64(potentialTimestamp.Unix()) parentCommittedSeals, err := i.extractParentCommittedSeals(parent) @@ -203,7 +234,7 @@ func (i *backendIBFT) buildBlock(parent *types.Header) (*types.Block, error) { return nil, err } // Get the block transactions - writeCtx, cancelFn := context.WithDeadline(context.Background(), potentialTimestamp) + writeCtx, cancelFn := context.WithDeadline(context.Background(), runtimeDeadline) defer cancelFn() txs := i.writeTransactions( @@ -212,11 +243,19 @@ func (i *backendIBFT) buildBlock(parent *types.Header) (*types.Block, error) { header.Number, transition, ) - - // provide dummy block instance to the PreCommitState - // (for the IBFT consensus, it is correct to have just a header, as only it is used) - if err := i.PreCommitState(&types.Block{Header: header}, transition); err != nil { - return nil, err + // Provide the in-progress block body to PreCommitState. PoS epoch boundary + // finalization writes a deterministic internal system receipt; when that + // happens, append the matching system transaction to the otherwise user-tx-free + // block so receipt count, receipt root, and tx root remain deterministic. + preCommitBlock := &types.Block{Header: header, Transactions: txs} + if err := i.PreCommitState(preCommitBlock, transition); err != nil { + return nil, fmt.Errorf("pre-commit state failed at block %d: %w", header.Number, err) + } + if len(transition.Receipts()) == len(txs)+1 { + finalizationTx := pos.EpochFinalizationSystemTx(header.Number) + if transition.Receipts()[len(transition.Receipts())-1].TxHash == finalizationTx.Hash { + txs = append(txs, finalizationTx) + } } _, root, err := transition.Commit() if err != nil { @@ -246,7 +285,6 @@ func (i *backendIBFT) buildBlock(parent *types.Header) (*types.Block, error) { block.Header.ComputeHash() i.logger.Info("build block", "number", header.Number, "txs", len(txs)) - return block, nil } @@ -353,7 +391,8 @@ write: } } - // wait for the timer to expire + // wait for the timer to expire so the built block is aligned with the + // configured block time schedule <-writeCtx.Done() return diff --git a/consensus/ibft/consensus_backend_test.go b/consensus/ibft/consensus_backend_test.go deleted file mode 100644 index 7566443..0000000 --- a/consensus/ibft/consensus_backend_test.go +++ /dev/null @@ -1,113 +0,0 @@ -package ibft - -import ( - "testing" - "time" - - "github.com/stretchr/testify/assert" -) - -// TestIBFTBackend_CalculateHeaderTimestamp verifies that the header timestamp -// is successfully calculated -func TestIBFTBackend_CalculateHeaderTimestamp(t *testing.T) { - t.Parallel() - - // Reference time - now := time.Unix(time.Now().UTC().Unix(), 0) // Round down - - testTable := []struct { - name string - parentTimestamp int64 - currentTime time.Time - blockTime uint64 - - expectedTimestamp time.Time - }{ - { - "Valid clock block timestamp", - now.Add(time.Duration(-1) * time.Second).Unix(), // 1s before - now, - 1, - now, // 1s after - }, - { - "Next multiple block clock", - now.Add(time.Duration(-4) * time.Second).Unix(), // 4s before - now, - 3, - roundUpTime(now, 3*time.Second), - }, - } - - for _, testCase := range testTable { - testCase := testCase - - t.Run(testCase.name, func(t *testing.T) { - t.Parallel() - - i := &backendIBFT{ - blockTime: time.Duration(testCase.blockTime) * time.Second, - } - - assert.Equal( - t, - testCase.expectedTimestamp.Unix(), - i.calcHeaderTimestamp( - uint64(testCase.parentTimestamp), - testCase.currentTime, - ).Unix(), - ) - }) - } -} - -// TestIBFTBackend_RoundUpTime verifies time is rounded up correctly -func TestIBFTBackend_RoundUpTime(t *testing.T) { - t.Parallel() - - // Reference time - now := time.Now().UTC() - - calcExpected := func(time int64, multiple int64) int64 { - if time%multiple == 0 { - return time + multiple - } - - return ((time + multiple/2) / multiple) * multiple - } - - testTable := []struct { - name string - time time.Time - multiple time.Duration - - expectedTime int64 - }{ - { - "No rounding needed", - now, - 0 * time.Second, - now.Unix(), - }, - { - "Rounded up time even", - now, - 2 * time.Second, - calcExpected(now.Unix(), 2), - }, - } - - for _, testCase := range testTable { - testCase := testCase - - t.Run(testCase.name, func(t *testing.T) { - t.Parallel() - - assert.Equal( - t, - testCase.expectedTime, - roundUpTime(testCase.time, testCase.multiple).Unix(), - ) - }) - } -} diff --git a/consensus/ibft/consensus_no_unsafe_test.go b/consensus/ibft/consensus_no_unsafe_test.go new file mode 100644 index 0000000..538b1e0 --- /dev/null +++ b/consensus/ibft/consensus_no_unsafe_test.go @@ -0,0 +1,19 @@ +package ibft + +import ( + "os" + "strings" + "testing" + + "github.com/stretchr/testify/require" +) + +func TestConsensusWrapper_DoesNotUseReflectOrUnsafe(t *testing.T) { + data, err := os.ReadFile("consensus.go") + require.NoError(t, err) + + source := string(data) + require.NotContains(t, source, "\"reflect\"") + require.NotContains(t, source, "\"unsafe\"") + require.False(t, strings.Contains(source, "Unsafe")) +} diff --git a/consensus/ibft/effective_power.go b/consensus/ibft/effective_power.go new file mode 100644 index 0000000..cf53dc2 --- /dev/null +++ b/consensus/ibft/effective_power.go @@ -0,0 +1,230 @@ +package ibft + +import ( + "encoding/binary" + "fmt" + "math/big" + + "github.com/xgr-network/xgr-node/consensus/ibft/pos" + xcrypto "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" + contractstore "github.com/xgr-network/xgr-node/validators/store/contract" +) + +func (i *backendIBFT) effectiveVotingPowerSnapshot( + height uint64, + validatorSet validators.Validators, + parentHeader *types.Header, +) (map[string]*big.Int, effectivePowerSnapshot, error) { + var ( + stateTx *state.Transition + err error + ) + if parentHeader == nil { + return nil, effectivePowerSnapshot{}, fmt.Errorf("parent header required for stake-weighted snapshot at height %d", height) + } + // Block 1 in direct-PoS chains has parent=genesis(0). Genesis bootstrap stakes + // are marked joinedAtBlock=1, so snapshot(0) is intentionally not mature yet. + // Keep block 1 in unit voting mode and enable stake-weighted mode from block 2. + parentPoSActive := parentHeader != nil && parentHeader.Number > 0 && i.forkManager.IsPosActive(parentHeader.Number) + heightPoSActive := i.forkManager.IsPosActive(height) + stakeWeightedActive := parentPoSActive + snapshotHeight, err := i.stakeSnapshotHeight(height, parentHeader, stakeWeightedActive) + if err != nil { + return nil, effectivePowerSnapshot{}, err + } + + snapshotHeader := parentHeader + if stakeWeightedActive && snapshotHeight != parentHeader.Number { + if i.blockchain == nil { + return nil, effectivePowerSnapshot{}, fmt.Errorf( + "stake-weighted voting power snapshot requires blockchain header lookup: height=%d snapshotHeight=%d parent=%d", + height, + snapshotHeight, + parentHeader.Number, + ) + } + + var ok bool + snapshotHeader, ok = i.blockchain.GetHeaderByNumber(snapshotHeight) + if !ok { + return nil, effectivePowerSnapshot{}, fmt.Errorf("stake-weighted voting power snapshot header not found at height %d", snapshotHeight) + } + } + + stateTx, err = i.executor.BeginTxn(snapshotHeader.StateRoot, snapshotHeader, types.ZeroAddress) + if err != nil { + return nil, effectivePowerSnapshot{}, err + } + + result, snapshot, err := i.snapshotVotingPowers(height, snapshotHeight, validatorSet, stateTx, stakeWeightedActive) + if err != nil { + return nil, effectivePowerSnapshot{}, err + } + if stakeWeightedActive && stateTx != nil && !contractstore.IsEmergencyModeActive(stateTx) && i.uptimeCfg.MicroEpochNominalWeight > 1 && validatorSet.Len() > 1 { + total := uint64(0) + allUnit := true + for idx := 0; idx < validatorSet.Len(); idx++ { + addr := validatorSet.At(uint64(idx)).Addr() + p := result[types.AddressToString(addr)] + if p == nil { + p = big.NewInt(0) + } + v := p.Uint64() + total += v + if v != 1 { + allUnit = false + } + } + if total == uint64(validatorSet.Len()) && allUnit { + parentNumber := uint64(0) + parentHash := types.ZeroHash.String() + parentStateRoot := types.ZeroHash.String() + if parentHeader != nil { + parentNumber = parentHeader.Number + parentHash = parentHeader.Hash.String() + parentStateRoot = parentHeader.StateRoot.String() + } + return nil, effectivePowerSnapshot{}, fmt.Errorf( + "stake-weighted verify rejected classic-unit fallback: height=%d parentNumber=%d parentHash=%s parentStateRoot=%s isPosActiveAtParent=%t isPosActiveAtHeight=%t nominalWeightUnits=%d total=%d validatorCount=%d votingPowers=%v", + height, + parentNumber, + parentHash, + parentStateRoot, + parentPoSActive, + heightPoSActive, + i.uptimeCfg.MicroEpochNominalWeight, + total, + validatorSet.Len(), + snapshot.powers, + ) + } + } + + return result, snapshot, nil +} + +func (i *backendIBFT) snapshotVotingPowers( + height uint64, + snapshotHeight uint64, + validatorSet validators.Validators, + stateTx *state.Transition, + stakeWeightedActive bool, +) (map[string]*big.Int, effectivePowerSnapshot, error) { + result := make(map[string]*big.Int, validatorSet.Len()) + snapshotPowers := make(map[string]string, validatorSet.Len()) + total := big.NewInt(0) + emergency := stakeWeightedActive && stateTx != nil && contractstore.IsEmergencyModeActive(stateTx) + for index := 0; index < validatorSet.Len(); index++ { + addr := validatorSet.At(uint64(index)).Addr() + if !stakeWeightedActive || stateTx == nil { + result[types.AddressToString(addr)] = big.NewInt(1) + snapshotPowers[addr.String()] = "1" + total.Add(total, big.NewInt(1)) + continue + } + weight := pos.EffectiveWeight(stateTx.Txn(), addr, i.uptimeCfg) + nominal := pos.UptimeNominalWeight(stateTx.Txn(), addr) + if nominal == 0 { + nominal = i.uptimeCfg.MicroEpochNominalWeight + } + stake := contractstore.ReadValidatorVotingStakeAt(stateTx, addr, snapshotHeight) + + if stake == nil || stake.Sign() <= 0 { + return nil, effectivePowerSnapshot{}, fmt.Errorf("missing effective stake for stake-weighted validator %s at height %d", addr, height) + } + + w := big.NewInt(1) + if !emergency { + w = pos.WeightedStake(stake, weight, nominal) + if stake.Sign() > 0 && weight > 0 && nominal > 0 && w.Sign() == 0 { + w = big.NewInt(1) + } + } + result[types.AddressToString(addr)] = w + snapshotPowers[addr.String()] = w.String() + total.Add(total, w) + } + + quorum := weightedQuorumThreshold(total) + + return result, effectivePowerSnapshot{ + hash: hashEffectiveWeights(result, validatorSet, total, quorum), + powers: snapshotPowers, + totalVotingPower: total.String(), + quorumThreshold: quorum.String(), + }, nil +} + +func (i *backendIBFT) stakeSnapshotHeight(height uint64, parentHeader *types.Header, stakeWeightedActive bool) (uint64, error) { + if !stakeWeightedActive { + // Unit voting mode ignores stake snapshots entirely. + return 0, nil + } + + if parentHeader == nil { + if height == 0 { + return 0, fmt.Errorf("stake-weighted voting power snapshot requires parent state (height=0)") + } + + return height - 1, nil + } + + if i == nil || i.epochSize < 2 { + return parentHeader.Number, nil + } + + var snapshotHeight uint64 + if height%uint64(i.epochSize) == 0 { + if height == 0 { + return 0, fmt.Errorf("stake-weighted voting power snapshot requires parent state (height=0)") + } + snapshotHeight = height - 1 + } else { + snapshotHeight = (height / uint64(i.epochSize)) * uint64(i.epochSize) + } + + if snapshotHeight > parentHeader.Number { + return parentHeader.Number, nil + } + + if i.forkManager != nil && !i.forkManager.IsPosActive(snapshotHeight) { + for h := snapshotHeight + 1; h <= parentHeader.Number; h++ { + if i.forkManager.IsPosActive(h) { + return h, nil + } + } + + return parentHeader.Number, nil + } + + return snapshotHeight, nil +} + +func hashEffectiveWeights(weights map[string]*big.Int, set validators.Validators, total, quorum *big.Int) types.Hash { + hasher := make([]byte, 0, set.Len()*64+64) + for idx := 0; idx < set.Len(); idx++ { + addr := set.At(uint64(idx)).Addr() + hasher = append(hasher, addr.Bytes()...) + w := weights[types.AddressToString(addr)] + if w == nil { + w = big.NewInt(0) + } + hasher = append(hasher, w.FillBytes(make([]byte, 32))...) + } + + hasher = append(hasher, total.FillBytes(make([]byte, 32))...) + hasher = append(hasher, quorum.FillBytes(make([]byte, 32))...) + + var size [8]byte + binary.BigEndian.PutUint64(size[:], uint64(set.Len())) + hasher = append(hasher, size[:]...) + + if len(hasher) == 0 { + return types.ZeroHash + } + + return types.BytesToHash(xcrypto.Keccak256(hasher)) +} diff --git a/consensus/ibft/effective_power_snapshot_height_test.go b/consensus/ibft/effective_power_snapshot_height_test.go new file mode 100644 index 0000000..a17baef --- /dev/null +++ b/consensus/ibft/effective_power_snapshot_height_test.go @@ -0,0 +1,76 @@ +package ibft + +import ( + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestStakeSnapshotHeight_UnitModeReturnsZero(t *testing.T) { + t.Parallel() + + h, err := (&backendIBFT{}).stakeSnapshotHeight(12, nil, false) + require.NoError(t, err) + require.Equal(t, uint64(0), h) +} + +func TestStakeSnapshotHeight_PosWithoutEpochUsesParentHeaderNumber(t *testing.T) { + t.Parallel() + + h, err := (&backendIBFT{}).stakeSnapshotHeight(100, &types.Header{Number: 77}, true) + require.NoError(t, err) + require.Equal(t, uint64(77), h) +} + +func TestStakeSnapshotHeight_PosUsesEpochBoundarySnapshot(t *testing.T) { + t.Parallel() + + backend := &backendIBFT{epochSize: 10} + + h, err := backend.stakeSnapshotHeight(32, &types.Header{Number: 31}, true) + require.NoError(t, err) + require.Equal(t, uint64(30), h) + + h, err = backend.stakeSnapshotHeight(40, &types.Header{Number: 39}, true) + require.NoError(t, err) + require.Equal(t, uint64(39), h) +} + +func TestStakeSnapshotHeight_PosClampsToFirstActiveHeight(t *testing.T) { + t.Parallel() + + backend := &backendIBFT{ + epochSize: 20, + forkManager: &votingPowerForkManager{active: func(h uint64) bool { return h >= 15 }}, + } + + h, err := backend.stakeSnapshotHeight(17, &types.Header{Number: 16}, true) + require.NoError(t, err) + require.Equal(t, uint64(15), h) +} + +func TestEffectiveVotingPowerSnapshot_RequiresBlockchainLookupForHistoricalStakeSnapshot(t *testing.T) { + t.Parallel() + + backend := &backendIBFT{ + epochSize: 10, + forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}, + } + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + ) + + _, _, err := backend.effectiveVotingPowerSnapshot(32, valSet, &types.Header{Number: 31}) + require.Error(t, err) + require.Contains(t, err.Error(), "requires blockchain header lookup") +} + +func TestStakeSnapshotHeight_PosHeightZeroWithoutParentFails(t *testing.T) { + t.Parallel() + + _, err := (&backendIBFT{}).stakeSnapshotHeight(0, nil, true) + require.Error(t, err) + require.Contains(t, err.Error(), "requires parent state") +} diff --git a/consensus/ibft/effective_power_stake_test.go b/consensus/ibft/effective_power_stake_test.go new file mode 100644 index 0000000..d3dc9db --- /dev/null +++ b/consensus/ibft/effective_power_stake_test.go @@ -0,0 +1,1635 @@ +package ibft + +import ( + "encoding/binary" + "math/big" + "os" + "path/filepath" + "testing" + + "github.com/hashicorp/go-hclog" + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/blockchain" + "github.com/xgr-network/xgr-node/chain" + "github.com/xgr-network/xgr-node/consensus/ibft/fork" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/helper/keccak" + stakingHelper "github.com/xgr-network/xgr-node/helper/staking" + "github.com/xgr-network/xgr-node/state" + itrie "github.com/xgr-network/xgr-node/state/immutable-trie" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" + contractstore "github.com/xgr-network/xgr-node/validators/store/contract" +) + +func posKeyLastProposer() types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte("xgr.pos.last.proposer"))) +} +func addressToHash(addr types.Address) types.Hash { + var out types.Hash + copy(out[12:], addr[:]) + return out +} + +type sequenceSigner struct { + extra *signer.IstanbulExtra + proposers map[uint64]types.Address +} + +func (m *sequenceSigner) Type() validators.ValidatorType { return validators.ECDSAValidatorType } +func (m *sequenceSigner) Address() types.Address { return types.ZeroAddress } +func (m *sequenceSigner) InitIBFTExtra(*types.Header, validators.Validators, signer.Seals) {} +func (m *sequenceSigner) GetIBFTExtra(*types.Header) (*signer.IstanbulExtra, error) { + return m.extra, nil +} +func (m *sequenceSigner) GetValidators(*types.Header) (validators.Validators, error) { + return m.extra.Validators, nil +} +func (m *sequenceSigner) WriteProposerSeal(h *types.Header) (*types.Header, error) { return h, nil } +func (m *sequenceSigner) EcrecoverFromHeader(h *types.Header) (types.Address, error) { + return m.proposers[h.Number], nil +} +func (m *sequenceSigner) CreateCommittedSeal([]byte) ([]byte, error) { return nil, nil } +func (m *sequenceSigner) VerifyCommittedSeal(validators.Validators, types.Address, []byte, []byte) error { + return nil +} +func (m *sequenceSigner) WriteCommittedSeals(*types.Header, uint64, map[types.Address][]byte) (*types.Header, error) { + return nil, nil +} +func (m *sequenceSigner) VerifyCommittedSeals(types.Hash, signer.Seals, validators.Validators, int) error { + return nil +} +func (m *sequenceSigner) VerifyParentCommittedSeals(types.Hash, *types.Header, validators.Validators, int, bool) error { + return nil +} +func (m *sequenceSigner) SignIBFTMessage([]byte) ([]byte, error) { return nil, nil } +func (m *sequenceSigner) EcrecoverFromIBFTMessage([]byte, []byte) (types.Address, error) { + return types.ZeroAddress, nil +} +func (m *sequenceSigner) CalculateHeaderHash(*types.Header) (types.Hash, error) { + return types.ZeroHash, nil +} +func (m *sequenceSigner) FilterHeaderForHash(h *types.Header) (*types.Header, error) { return h, nil } + +func TestSnapshotVotingPowers_PrePoS_UnitBasedWithoutStakeState(t *testing.T) { + t.Parallel() + pool := newTesterAccountPool(t, 3) + backend := &backendIBFT{} + + powers, snap, err := backend.snapshotVotingPowers(11, 10, pool.ValidatorSet(), nil, false) + require.NoError(t, err) + require.Equal(t, "3", snap.totalVotingPower) + for i := 0; i < pool.ValidatorSet().Len(); i++ { + addr := pool.ValidatorSet().At(uint64(i)).Addr() + require.Equal(t, uint64(1), powers[types.AddressToString(addr)].Uint64()) + } +} + +func TestSnapshotVotingPowers_StakeWeightedInactive_DoesNotReadStakeState(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001"))) + stateTx := newBareVotingPowerTestTransition(t, 10) + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochNominalWeight: 10_000}} + + powers, snap, err := backend.snapshotVotingPowers(11, 0, valSet, stateTx, false) + require.NoError(t, err) + require.Equal(t, "1", snap.totalVotingPower) + require.Equal(t, uint64(1), powers[types.AddressToString(valSet.At(0).Addr())].Uint64()) +} + +func TestSnapshotVotingPowers_BootstrapStakeDecayFloorsToOne(t *testing.T) { + t.Parallel() + val := types.StringToAddress("0x10000000000000000000000000000000000000f1") + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(val)) + stateTx := newVotingPowerTestTransition(t, valSet, 10) + require.False(t, contractstore.IsEmergencyModeActive(stateTx)) + setNominalAndEffectiveWeight(stateTx, val, 10_000, 1) + + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 1, MicroEpochNominalWeight: 10_000}} + powers, snap, err := backend.snapshotVotingPowers(11, 10, valSet, stateTx, true) + require.NoError(t, err) + require.Equal(t, uint64(1), powers[types.AddressToString(val)].Uint64()) + require.Equal(t, "1", snap.totalVotingPower) +} + +func TestSnapshotVotingPowers_BootstrapStakeDecayTotalVotingPowerNonZero(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x10000000000000000000000000000000000000f2")), + validators.NewECDSAValidator(types.StringToAddress("0x10000000000000000000000000000000000000f3")), + ) + stateTx := newVotingPowerTestTransition(t, valSet, 10) + setStakingConfigForVotingPowerTest(t, stateTx, 2, 1, uint64(valSet.Len())) + for i := 0; i < valSet.Len(); i++ { + setNominalAndEffectiveWeight(stateTx, valSet.At(uint64(i)).Addr(), 10_000, 1) + } + + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 1, MicroEpochNominalWeight: 10_000}} + powers, snap, err := backend.snapshotVotingPowers(11, 10, valSet, stateTx, true) + require.NoError(t, err) + require.Equal(t, "2", snap.totalVotingPower) + for i := 0; i < valSet.Len(); i++ { + require.Equal(t, uint64(1), powers[types.AddressToString(valSet.At(uint64(i)).Addr())].Uint64()) + } +} + +func TestSnapshotVotingPowers_EmergencyModeUsesDeterministicUnitVotingPower(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x10000000000000000000000000000000000000f4")), + validators.NewECDSAValidator(types.StringToAddress("0x10000000000000000000000000000000000000f5")), + ) + stateTx := newVotingPowerTestTransition(t, valSet, 10) + setStakingConfigForVotingPowerTest(t, stateTx, 2, 1, uint64(valSet.Len())) + setValidatorSelfStake(t, stateTx, valSet.At(0).Addr(), 10) + setValidatorSelfStake(t, stateTx, valSet.At(1).Addr(), 1_000_000) + for i := 0; i < valSet.Len(); i++ { + setNominalAndEffectiveWeight(stateTx, valSet.At(uint64(i)).Addr(), 10_000, 5_000) + } + require.True(t, contractstore.IsEmergencyModeActive(stateTx)) + + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 1, MicroEpochNominalWeight: 10_000}} + powers, snap, err := backend.snapshotVotingPowers(11, 10, valSet, stateTx, true) + require.NoError(t, err) + require.Equal(t, "2", snap.totalVotingPower) + for i := 0; i < valSet.Len(); i++ { + require.Equal(t, uint64(1), powers[types.AddressToString(valSet.At(uint64(i)).Addr())].Uint64()) + } +} + +func TestSnapshotVotingPowers_FirstPoSBlock_UsesParentStateStake(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000002")), + ) + stateTx := newVotingPowerTestTransition(t, valSet, 9) + a := valSet.At(0).Addr() + b := valSet.At(1).Addr() + setValidatorSelfStake(t, stateTx, a, 10_000) + setValidatorSelfStake(t, stateTx, b, 30_000) + setNominalAndEffectiveWeight(stateTx, a, 10_000, 10_000) + setNominalAndEffectiveWeight(stateTx, b, 10_000, 10_000) + + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(h uint64) bool { return h >= 10 }}} + res, snap, err := backend.snapshotVotingPowers(10, 9, valSet, stateTx, true) + require.NoError(t, err) + require.Equal(t, uint64(10_000), res[types.AddressToString(a)].Uint64()) + require.Equal(t, uint64(30_000), res[types.AddressToString(b)].Uint64()) + require.Equal(t, "40000", snap.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(big.NewInt(40_000)).String(), snap.quorumThreshold) +} + +func TestSnapshotVotingPowers_PoS_MissingStakeIsHardError(t *testing.T) { + t.Parallel() + val := types.StringToAddress("0x1000000000000000000000000000000000000001") + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(val)) + stateTx := newBareVotingPowerTestTransition(t, 10) + setValidatorSelfStakeRaw(t, stateTx, val, 0, 0, types.ZeroAddress) + setNominalAndEffectiveWeight(stateTx, val, 10_000, 10_000) + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + + _, _, err := backend.snapshotVotingPowers(10, 9, valSet, stateTx, true) + require.Error(t, err) + require.Contains(t, err.Error(), "missing effective stake") +} + +func TestSnapshotVotingPowers_UsesRawSelfStake_WithoutJoinMaturity(t *testing.T) { + t.Parallel() + val := types.StringToAddress("0x1000000000000000000000000000000000000001") + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(val)) + stateTx := newBareVotingPowerTestTransition(t, 10) + setValidatorSelfStakeRaw(t, stateTx, val, 10_000, 10, val) + setNominalAndEffectiveWeight(stateTx, val, 10_000, 10_000) + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + + res, _, err := backend.snapshotVotingPowers(10, 9, valSet, stateTx, true) + require.NoError(t, err) + require.Equal(t, uint64(10_000), res[types.AddressToString(val)].Uint64()) +} + +func TestSnapshotVotingPowers_UsesRawSelfStake_WithoutJoinMetadata(t *testing.T) { + t.Parallel() + val := types.StringToAddress("0x1000000000000000000000000000000000000001") + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(val)) + stateTx := newBareVotingPowerTestTransition(t, 10) + setValidatorSelfStakeRaw(t, stateTx, val, 42, 0, val) + setNominalAndEffectiveWeight(stateTx, val, 10_000, 10_000) + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + + res, _, err := backend.snapshotVotingPowers(10, 9, valSet, stateTx, true) + require.NoError(t, err) + require.Equal(t, uint64(42), res[types.AddressToString(val)].Uint64()) +} + +func TestSnapshotVotingPowers_ActiveDelegationIncludedInactiveExcluded(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000002")), + ) + stateTx := newVotingPowerTestTransition(t, valSet, 10) + validatorA := valSet.At(0).Addr() + validatorB := valSet.At(1).Addr() + activeDelegator := types.StringToAddress("0x2000000000000000000000000000000000000001") + inactiveDelegator := types.StringToAddress("0x2000000000000000000000000000000000000002") + + setValidatorSelfStake(t, stateTx, validatorA, 200) + setValidatorSelfStake(t, stateTx, validatorB, 500) + setValidatorDelegatedStakeTotals(t, stateTx, validatorA, 700, 300) + setDelegatorStakeForValidator(t, stateTx, validatorA, activeDelegator, 300, 1, 0, true) + // Raw-only delegated stake is present in the validator's delegation snapshot, + // but it joined at the snapshot height and is therefore not epoch-effective yet. + setDelegatorStakeForValidator(t, stateTx, validatorA, inactiveDelegator, 400, 9, 0, false) + setNominalAndEffectiveWeight(stateTx, validatorA, 10_000, 10_000) + setNominalAndEffectiveWeight(stateTx, validatorB, 10_000, 10_000) + + backend := &backendIBFT{ + uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, + forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}, + } + powers, snap, err := backend.snapshotVotingPowers(10, 9, valSet, stateTx, true) + require.NoError(t, err) + + validatorAPower := powers[types.AddressToString(validatorA)] + validatorBPower := powers[types.AddressToString(validatorB)] + require.Equal(t, uint64(500), validatorAPower.Uint64(), "validatorA must include self stake plus active delegated stake") + require.Equal(t, validatorBPower, validatorAPower, "validatorA self 200 + active delegation 300 must equal validatorB self 500") + require.NotEqual(t, uint64(900), validatorAPower.Uint64(), "inactive/raw-only delegated stake must not contribute") + require.Equal(t, uint64(500), validatorBPower.Uint64()) + require.Equal(t, "1000", snap.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(big.NewInt(1_000)).String(), snap.quorumThreshold) + + setValidatorDelegatedStakeTotals(t, stateTx, validatorA, 700, 0) + setStakerStakeForValidator(t, stateTx, activeDelegator, validatorA, 300, 9, 0, false) + powers, snap, err = backend.snapshotVotingPowers(10, 9, valSet, stateTx, true) + require.NoError(t, err) + + validatorAPower = powers[types.AddressToString(validatorA)] + validatorBPower = powers[types.AddressToString(validatorB)] + require.Equal(t, uint64(200), validatorAPower.Uint64(), "validatorA must fall back to self stake when all raw delegation is inactive") + require.Equal(t, uint64(500), validatorBPower.Uint64(), "validatorB must be unchanged") + require.Equal(t, "700", snap.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(big.NewInt(700)).String(), snap.quorumThreshold) +} + +func TestSnapshotVotingPowers_MidEpochStakeChangesDoNotAffectCurrentPower(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000002")), + ) + validatorA := valSet.At(0).Addr() + validatorB := valSet.At(1).Addr() + delegatorA := types.StringToAddress("0x2000000000000000000000000000000000000001") + + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + genesisRoot, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + ex.GetHash = func(h *types.Header) state.GetHashByNumber { + return func(i uint64) types.Hash { return genesisRoot } + } + beginTxn := func(root types.Hash, block uint64) *state.Transition { + t.Helper() + tx, err := ex.BeginTxn(root, &types.Header{Number: block}, types.ZeroAddress) + require.NoError(t, err) + return tx + } + commitTxn := func(tx *state.Transition) types.Hash { + t.Helper() + _, root, err := tx.Commit() + require.NoError(t, err) + return root + } + + currentTx := beginTxn(genesisRoot, 15) + contractState, err := stakingHelper.PredeployStakingSC(valSet, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: uint64(valSet.Len()), EpochSize: 20}) + require.NoError(t, err) + require.NoError(t, currentTx.SetAccountDirectly(staking.AddrStakingContract, contractState)) + setValidatorSelfStake(t, currentTx, validatorA, 500) + setValidatorSelfStake(t, currentTx, validatorB, 500) + setNominalAndEffectiveWeight(currentTx, validatorA, 10_000, 10_000) + setNominalAndEffectiveWeight(currentTx, validatorB, 10_000, 10_000) + currentRoot := commitTxn(currentTx) + currentParent := &types.Header{Number: 15, StateRoot: currentRoot} + + backend := &backendIBFT{ + executor: ex, + uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, + forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}, + } + assertVotingPower := func(parent *types.Header, height uint64, wantA uint64, wantB uint64, wantTotal uint64) { + t.Helper() + powers, snap, err := backend.effectiveVotingPowerSnapshot(height, valSet, parent) + require.NoError(t, err) + require.Equal(t, wantA, powers[types.AddressToString(validatorA)].Uint64()) + require.Equal(t, wantB, powers[types.AddressToString(validatorB)].Uint64()) + require.Equal(t, new(big.Int).SetUint64(wantTotal).String(), snap.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(new(big.Int).SetUint64(wantTotal)).String(), snap.quorumThreshold) + } + + assertVotingPower(currentParent, 16, 500, 500, 1_000) + + // Commit live StakingV2 state changes on top of the current parent root. The + // current voting-power path must keep using currentParent.StateRoot, while the + // next parent root models the first snapshot after the epoch boundary. + nextTx := beginTxn(currentRoot, 20) + setValidatorSelfStakeRaw(t, nextTx, validatorA, 900, 1, validatorA) + setValidatorDelegatedStakeTotals(t, nextTx, validatorA, 600, 600) + setDelegatorStakeForValidator(t, nextTx, validatorA, delegatorA, 600, 15, 0, true) + nextRoot := commitTxn(nextTx) + nextParent := &types.Header{Number: 20, StateRoot: nextRoot} + + assertVotingPower(currentParent, 16, 500, 500, 1_000) + assertVotingPower(nextParent, 21, 1_500, 500, 2_000) +} + +func TestEffectiveVotingPowerSnapshot_ValidatorFullUnstakeUsesEpochBoundaryStake(t *testing.T) { + const epochSize uint64 = 10 + + pool := newTesterAccountPool(t) + pool.add("A", "B", "C", "D") + valSet := pool.ValidatorSet() + validatorsByName := map[string]types.Address{ + "A": pool.get("A").Address(), + "B": pool.get("B").Address(), + "C": pool.get("C").Address(), + "D": pool.get("D").Address(), + } + + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + genesisRoot, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + ex.GetHash = func(*types.Header) state.GetHashByNumber { return func(uint64) types.Hash { return genesisRoot } } + + boundaryTx, err := ex.BeginTxn(genesisRoot, &types.Header{Number: 30}, types.ZeroAddress) + require.NoError(t, err) + contractState, err := stakingHelper.PredeployStakingSC(valSet, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: uint64(valSet.Len()), EpochSize: epochSize}) + require.NoError(t, err) + require.NoError(t, boundaryTx.SetAccountDirectly(staking.AddrStakingContract, contractState)) + stakes := map[string]uint64{"A": 10_000, "B": 20_000, "C": 30_000, "D": 40_000} + for name, stake := range stakes { + addr := validatorsByName[name] + setValidatorSelfStake(t, boundaryTx, addr, stake) + setNominalAndEffectiveWeight(boundaryTx, addr, 10_000, 10_000) + } + _, boundaryRoot, err := boundaryTx.Commit() + require.NoError(t, err) + + exited := validatorsByName["D"] + exitTx, err := ex.BeginTxn(boundaryRoot, &types.Header{Number: 31}, types.ZeroAddress) + require.NoError(t, err) + setValidatorSelfStakeRaw(t, exitTx, exited, 0, 0, types.ZeroAddress) + setNominalAndEffectiveWeight(exitTx, exited, 10_000, 10_000) + _, exitRoot, err := exitTx.Commit() + require.NoError(t, err) + + headers := make([]*types.Header, 32) + for n := uint64(0); n <= 31; n++ { + h := &types.Header{Number: n, Difficulty: 1, StateRoot: genesisRoot} + if n > 0 { + h.ParentHash = headers[n-1].Hash + } + switch n { + case 30: + h.StateRoot = boundaryRoot + case 31: + h.StateRoot = exitRoot + } + h.ComputeHash() + headers[n] = h + } + + backend := &backendIBFT{ + blockchain: blockchain.NewTestBlockchain(t, headers), + executor: ex, + epochSize: epochSize, + uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, + forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}, + } + + powers, snap, err := backend.effectiveVotingPowerSnapshot(32, valSet, headers[31]) + require.NoError(t, err) + require.Equal(t, "100000", snap.totalVotingPower) + require.Equal(t, uint64(40_000), powers[types.AddressToString(exited)].Uint64(), "exited validator must retain last positive boundary stake while still in the epoch validator set") + require.NotEqual(t, uint64(1), powers[types.AddressToString(exited)].Uint64(), "stake-weighted path must not fall back to classic unit voting power") + for name, stake := range stakes { + addr := validatorsByName[name] + require.Equal(t, stake, powers[types.AddressToString(addr)].Uint64(), "validator %s must use stake-weighted boundary power", name) + } + + parentTx, err := ex.BeginTxn(headers[31].StateRoot, headers[31], types.ZeroAddress) + require.NoError(t, err) + _, _, err = backend.snapshotVotingPowers(32, 31, valSet, parentTx, true) + require.Error(t, err) + require.Contains(t, err.Error(), "missing effective stake", "parent state after full unstake intentionally lacks the exited validator stake") +} + +func TestPoS_Slashing_ReducesValidatorSelfStakeAndVotingPowerWithoutDelegationDrift(t *testing.T) { + validatorA := types.StringToAddress("0x1000000000000000000000000000000000000101") + validatorB := types.StringToAddress("0x1000000000000000000000000000000000000102") + delegatorA := types.StringToAddress("0x2000000000000000000000000000000000000101") + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(validatorA), + validators.NewECDSAValidator(validatorB), + ) + const epochSize uint64 = 10 + const slashEpoch uint64 = 2 + + tx := newVotingPowerTestTransitionWithFeePoolSplit(t, valSet, 20) + setStakingConfigForVotingPowerTest(t, tx, epochSize, 0, uint64(valSet.Len())) + setValidatorSelfStake(t, tx, validatorA, 1_000) + setValidatorSelfStake(t, tx, validatorB, 1_000) + setDelegatorStakeForValidator(t, tx, validatorA, delegatorA, 500, 1, 0, true) + setValidatorDelegatedStakeTotals(t, tx, validatorA, 500, 500) + setNominalAndEffectiveWeight(tx, validatorA, 10_000, 10_000) + setNominalAndEffectiveWeight(tx, validatorB, 10_000, 10_000) + tx.Txn().SetBalance(staking.AddrStakingContract, big.NewInt(2_500)) + + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + assertSnapshot := func(height, parent uint64, wantA, wantB, wantTotal uint64) { + t.Helper() + powers, snap, err := backend.snapshotVotingPowers(height, parent, valSet, tx, true) + require.NoError(t, err) + require.Equal(t, wantA, powers[types.AddressToString(validatorA)].Uint64()) + require.Equal(t, wantB, powers[types.AddressToString(validatorB)].Uint64()) + require.Equal(t, new(big.Int).SetUint64(wantTotal).String(), snap.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(new(big.Int).SetUint64(wantTotal)).String(), snap.quorumThreshold) + } + + require.Equal(t, uint64(1_000), readStakerAmountForVotingPowerTest(tx, validatorA)) + require.Equal(t, uint64(500), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, uint64(500), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9)) + require.Equal(t, uint64(500), readStakerAmountForVotingPowerTest(tx, delegatorA)) + assertSnapshot(20, 19, 1_500, 1_000, 2_500) + + setPoSEpochValidatorsSnapshotForVotingPowerTest(t, tx, slashEpoch, valSet) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.stake.snapshot", slashEpoch, validatorA, big.NewInt(1_500)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.stake.snapshot", slashEpoch, validatorB, big.NewInt(1_000)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, validatorA, big.NewInt(1_000)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, delegatorA, big.NewInt(500)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, validatorB, big.NewInt(1_000)) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.slots", slashEpoch, validatorA, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.miss", slashEpoch, validatorA, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.slots", slashEpoch, validatorB, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.miss", slashEpoch, validatorB, 0) + + header := &types.Header{Number: 20} + headerSigner := &sequenceSigner{extra: &signer.IstanbulExtra{Validators: valSet}} + require.NoError(t, pos.FinalizeEpoch(header, epochSize, pos.UptimeConfig{}, headerSigner, tx)) + + logs := tx.Txn().Logs() + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, validatorA, 1, 10, 1_000, 1_000, 990) + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, delegatorA, 2, 5, 500, 500, 495) + require.Zero(t, readPoSU64StateForVotingPowerTest(tx, "xgr.pos.slashed", slashEpoch, validatorA)) + require.Zero(t, readPoSBigStateForVotingPowerTest(tx, "xgr.pos.slash.amount", slashEpoch, validatorA).Sign()) + require.Equal(t, uint64(990), readStakerAmountForVotingPowerTest(tx, validatorA)) + require.Equal(t, uint64(1_000), readStakerAmountForVotingPowerTest(tx, validatorB)) + + // Current production slashing intentionally allocates the epoch slash across + // effective self and delegated positions; these assertions ensure the raw and + // active delegation aggregates track the delegator staker amount exactly. + require.Equal(t, uint64(495), readStakerAmountForVotingPowerTest(tx, delegatorA)) + require.Equal(t, uint64(495), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, uint64(495), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9)) + require.Positive(t, readStakerAmountForVotingPowerTest(tx, validatorA)) + require.Positive(t, readStakerAmountForVotingPowerTest(tx, delegatorA)) + require.False(t, isStakerActiveForVotingPowerTest(tx, validatorA), "zero-uptime validator is deactivated by finalize") + assertSnapshot(21, 20, 1_485, 1_000, 2_485) +} + +func TestPoS_Slashing_InactiveDelegationAccounting(t *testing.T) { + validatorA := types.StringToAddress("0x1000000000000000000000000000000000000121") + validatorB := types.StringToAddress("0x1000000000000000000000000000000000000122") + activeDelegator := types.StringToAddress("0x2000000000000000000000000000000000000121") + inactiveDelegator := types.StringToAddress("0x2000000000000000000000000000000000000122") + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(validatorA), + validators.NewECDSAValidator(validatorB), + ) + const epochSize uint64 = 10 + const slashEpoch uint64 = 2 + + tx := newVotingPowerTestTransitionWithFeePoolSplit(t, valSet, 20) + setStakingConfigForVotingPowerTest(t, tx, epochSize, 0, uint64(valSet.Len())) + setValidatorSelfStake(t, tx, validatorA, 1_000) + setValidatorSelfStake(t, tx, validatorB, 1_000) + setDelegatorStakeForValidator(t, tx, validatorA, activeDelegator, 500, 1, 0, true) + setDelegatorStakeForValidator(t, tx, validatorA, inactiveDelegator, 300, 1, 9, false) + setValidatorDelegatedStakeTotals(t, tx, validatorA, 800, 500) + setNominalAndEffectiveWeight(tx, validatorA, 10_000, 10_000) + setNominalAndEffectiveWeight(tx, validatorB, 10_000, 10_000) + tx.Txn().SetBalance(staking.AddrStakingContract, big.NewInt(2_800)) + + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + assertSnapshot := func(height, parent uint64, wantA, wantB, wantTotal uint64) { + t.Helper() + powers, snap, err := backend.snapshotVotingPowers(height, parent, valSet, tx, true) + require.NoError(t, err) + require.Equal(t, wantA, powers[types.AddressToString(validatorA)].Uint64()) + require.Equal(t, wantB, powers[types.AddressToString(validatorB)].Uint64()) + require.Equal(t, new(big.Int).SetUint64(wantTotal).String(), snap.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(new(big.Int).SetUint64(wantTotal)).String(), snap.quorumThreshold) + } + + require.Equal(t, uint64(800), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, uint64(500), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9)) + assertSnapshot(20, 19, 1_500, 1_000, 2_500) + + setPoSEpochValidatorsSnapshotForVotingPowerTest(t, tx, slashEpoch, valSet) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.stake.snapshot", slashEpoch, validatorA, big.NewInt(1_500)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.stake.snapshot", slashEpoch, validatorB, big.NewInt(1_000)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, validatorA, big.NewInt(1_000)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, activeDelegator, big.NewInt(500)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, inactiveDelegator, big.NewInt(300)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, validatorB, big.NewInt(1_000)) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.slots", slashEpoch, validatorA, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.miss", slashEpoch, validatorA, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.slots", slashEpoch, validatorB, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.miss", slashEpoch, validatorB, 0) + + header := &types.Header{Number: 20} + headerSigner := &sequenceSigner{extra: &signer.IstanbulExtra{Validators: valSet}} + var finalizeErr error + require.NotPanics(t, func() { finalizeErr = pos.FinalizeEpoch(header, epochSize, pos.UptimeConfig{}, headerSigner, tx) }) + require.NoError(t, finalizeErr) + + logs := tx.Txn().Logs() + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, validatorA, 1, 9, 1_000, 1_000, 991) + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, activeDelegator, 2, 4, 500, 500, 496) + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, inactiveDelegator, 2, 2, 300, 300, 298) + require.Zero(t, readPoSU64StateForVotingPowerTest(tx, "xgr.pos.slashed", slashEpoch, validatorA)) + require.Zero(t, readPoSBigStateForVotingPowerTest(tx, "xgr.pos.slash.amount", slashEpoch, validatorA).Sign()) + require.Equal(t, uint64(991), readStakerAmountForVotingPowerTest(tx, validatorA)) + require.Equal(t, uint64(496), readStakerAmountForVotingPowerTest(tx, activeDelegator)) + require.Equal(t, uint64(298), readStakerAmountForVotingPowerTest(tx, inactiveDelegator), "inactive delegator with an epoch stake snapshot is slashed, but does not contribute to active delegated aggregate") + require.Equal(t, uint64(794), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, uint64(496), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9)) + require.Equal(t, readStakerAmountForVotingPowerTest(tx, activeDelegator)+readStakerAmountForVotingPowerTest(tx, inactiveDelegator), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, readStakerAmountForVotingPowerTest(tx, activeDelegator), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9)) + require.Equal(t, uint64(1_000), readStakerAmountForVotingPowerTest(tx, validatorB)) + require.Equal(t, uint64(2_785), txnBalanceUint64ForVotingPowerTest(tx, staking.AddrStakingContract)) + require.False(t, isStakerActiveForVotingPowerTest(tx, validatorA)) + assertSnapshot(21, 20, 1_487, 1_000, 2_487) +} + +func TestPoS_Slashing_MultipleDelegators_ProportionalAndDustAccounting(t *testing.T) { + validatorA := types.StringToAddress("0x1000000000000000000000000000000000000131") + validatorB := types.StringToAddress("0x1000000000000000000000000000000000000132") + delegator1 := types.StringToAddress("0x2000000000000000000000000000000000000131") + delegator2 := types.StringToAddress("0x2000000000000000000000000000000000000132") + delegator3 := types.StringToAddress("0x2000000000000000000000000000000000000133") + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validatorA), validators.NewECDSAValidator(validatorB)) + const epochSize uint64 = 10 + const slashEpoch uint64 = 2 + + tx := newVotingPowerTestTransitionWithFeePoolSplit(t, valSet, 20) + setStakingConfigForVotingPowerTest(t, tx, epochSize, 0, uint64(valSet.Len())) + setValidatorSelfStake(t, tx, validatorA, 1_000) + setValidatorSelfStake(t, tx, validatorB, 2_000) + setDelegatorStakeForValidator(t, tx, validatorA, delegator1, 333, 1, 0, true) + setDelegatorStakeForValidator(t, tx, validatorA, delegator2, 777, 1, 0, true) + setDelegatorStakeForValidator(t, tx, validatorA, delegator3, 111, 1, 0, true) + setValidatorDelegatedStakeTotals(t, tx, validatorA, 1_221, 1_221) + setNominalAndEffectiveWeight(tx, validatorA, 10_000, 10_000) + setNominalAndEffectiveWeight(tx, validatorB, 10_000, 10_000) + tx.Txn().SetBalance(staking.AddrStakingContract, big.NewInt(4_221)) + + setPoSEpochValidatorsSnapshotForVotingPowerTest(t, tx, slashEpoch, valSet) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.stake.snapshot", slashEpoch, validatorA, big.NewInt(2_221)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.stake.snapshot", slashEpoch, validatorB, big.NewInt(2_000)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, validatorA, big.NewInt(1_000)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, delegator1, big.NewInt(333)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, delegator2, big.NewInt(777)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, delegator3, big.NewInt(111)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, validatorB, big.NewInt(2_000)) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.slots", slashEpoch, validatorA, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.miss", slashEpoch, validatorA, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.slots", slashEpoch, validatorB, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.miss", slashEpoch, validatorB, 0) + + require.NoError(t, pos.FinalizeEpoch(&types.Header{Number: 20}, epochSize, pos.UptimeConfig{}, &sequenceSigner{extra: &signer.IstanbulExtra{Validators: valSet}}, tx)) + + const wantSlash uint64 = 22 + reductions := (uint64(1_000) - readStakerAmountForVotingPowerTest(tx, validatorA)) + + (uint64(333) - readStakerAmountForVotingPowerTest(tx, delegator1)) + + (uint64(777) - readStakerAmountForVotingPowerTest(tx, delegator2)) + + (uint64(111) - readStakerAmountForVotingPowerTest(tx, delegator3)) + logs := tx.Txn().Logs() + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, validatorA, 1, 10, 1_000, 1_000, 990) + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, delegator1, 2, 4, 333, 333, 329) + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, delegator2, 2, 7, 777, 777, 770) + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, delegator3, 2, 1, 111, 111, 110) + require.Zero(t, readPoSU64StateForVotingPowerTest(tx, "xgr.pos.slashed", slashEpoch, validatorA)) + require.Zero(t, readPoSBigStateForVotingPowerTest(tx, "xgr.pos.slash.amount", slashEpoch, validatorA).Sign()) + require.Equal(t, wantSlash, reductions) + require.Equal(t, uint64(990), readStakerAmountForVotingPowerTest(tx, validatorA), "two wei of rounding dust are assigned to the first slashable positions in deterministic staker order") + require.Equal(t, uint64(329), readStakerAmountForVotingPowerTest(tx, delegator1)) + require.Equal(t, uint64(770), readStakerAmountForVotingPowerTest(tx, delegator2)) + require.Equal(t, uint64(110), readStakerAmountForVotingPowerTest(tx, delegator3)) + require.Equal(t, uint64(1_209), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, uint64(1_209), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9)) + require.Equal(t, readStakerAmountForVotingPowerTest(tx, delegator1)+readStakerAmountForVotingPowerTest(tx, delegator2)+readStakerAmountForVotingPowerTest(tx, delegator3), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, uint64(2_000), readStakerAmountForVotingPowerTest(tx, validatorB)) + require.Equal(t, uint64(4_199), txnBalanceUint64ForVotingPowerTest(tx, staking.AddrStakingContract)) + + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + powers, snap, err := backend.snapshotVotingPowers(21, 20, valSet, tx, true) + require.NoError(t, err) + require.Equal(t, uint64(2_199), powers[types.AddressToString(validatorA)].Uint64()) + require.Equal(t, uint64(2_000), powers[types.AddressToString(validatorB)].Uint64()) + require.Equal(t, "4199", snap.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(big.NewInt(4_199)).String(), snap.quorumThreshold) +} + +func TestPoS_Slashing_BelowMinimumStakeValidatorStateAndVotingPower(t *testing.T) { + validatorA := types.StringToAddress("0x1000000000000000000000000000000000000111") + validatorB := types.StringToAddress("0x1000000000000000000000000000000000000112") + delegatorA := types.StringToAddress("0x2000000000000000000000000000000000000111") + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(validatorA), + validators.NewECDSAValidator(validatorB), + ) + const epochSize uint64 = 10 + const slashEpoch uint64 = 2 + const validatorASelfStake uint64 = 2 + const validatorADelegatedStake uint64 = 199 + const validatorBStake uint64 = 1_000 + + tx := newVotingPowerTestTransitionWithFeePoolSplit(t, valSet, 20) + setStakingConfigForVotingPowerTest(t, tx, epochSize, 0, uint64(valSet.Len())) + setValidatorSelfStake(t, tx, validatorA, validatorASelfStake) + setValidatorSelfStake(t, tx, validatorB, validatorBStake) + setDelegatorStakeForValidator(t, tx, validatorA, delegatorA, validatorADelegatedStake, 1, 0, true) + setValidatorDelegatedStakeTotals(t, tx, validatorA, validatorADelegatedStake, validatorADelegatedStake) + setNominalAndEffectiveWeight(tx, validatorA, 10_000, 10_000) + setNominalAndEffectiveWeight(tx, validatorB, 10_000, 10_000) + tx.Txn().SetBalance(staking.AddrStakingContract, new(big.Int).SetUint64(validatorASelfStake+validatorADelegatedStake+validatorBStake)) + + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + assertSnapshot := func(height, parent uint64, wantA, wantB, wantTotal uint64) { + t.Helper() + powers, snap, err := backend.snapshotVotingPowers(height, parent, valSet, tx, true) + require.NoError(t, err) + require.Equal(t, wantA, powers[types.AddressToString(validatorA)].Uint64()) + require.Equal(t, wantB, powers[types.AddressToString(validatorB)].Uint64()) + require.Equal(t, new(big.Int).SetUint64(wantTotal).String(), snap.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(new(big.Int).SetUint64(wantTotal)).String(), snap.quorumThreshold) + } + + require.Equal(t, validatorASelfStake, readStakerAmountForVotingPowerTest(tx, validatorA)) + require.Equal(t, validatorADelegatedStake, readStakerAmountForVotingPowerTest(tx, delegatorA)) + require.Equal(t, validatorADelegatedStake, readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, validatorADelegatedStake, readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9)) + require.Equal(t, validatorBStake, readStakerAmountForVotingPowerTest(tx, validatorB)) + assertSnapshot(20, 19, validatorASelfStake+validatorADelegatedStake, validatorBStake, validatorASelfStake+validatorADelegatedStake+validatorBStake) + + setPoSEpochValidatorsSnapshotForVotingPowerTest(t, tx, slashEpoch, valSet) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.stake.snapshot", slashEpoch, validatorA, new(big.Int).SetUint64(validatorASelfStake+validatorADelegatedStake)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.stake.snapshot", slashEpoch, validatorB, new(big.Int).SetUint64(validatorBStake)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, validatorA, new(big.Int).SetUint64(validatorASelfStake)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, delegatorA, new(big.Int).SetUint64(validatorADelegatedStake)) + setPoSBigStateForVotingPowerTest(tx, "xgr.pos.staker.stake.snapshot", slashEpoch, validatorB, new(big.Int).SetUint64(validatorBStake)) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.slots", slashEpoch, validatorA, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.miss", slashEpoch, validatorA, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.slots", slashEpoch, validatorB, 1) + setPoSU64StateForVotingPowerTest(tx, "xgr.pos.prop.miss", slashEpoch, validatorB, 0) + + header := &types.Header{Number: 20} + headerSigner := &sequenceSigner{extra: &signer.IstanbulExtra{Validators: valSet}} + var finalizeErr error + require.NotPanics(t, func() { + finalizeErr = pos.FinalizeEpoch(header, epochSize, pos.UptimeConfig{}, headerSigner, tx) + }) + require.NoError(t, finalizeErr) + + const wantSlashAmount uint64 = 2 + const wantValidatorASelfStake uint64 = 1 + const wantDelegatorAStake uint64 = 198 + const wantValidatorAPower uint64 = wantValidatorASelfStake + wantDelegatorAStake + const wantTotalPower uint64 = wantValidatorAPower + validatorBStake + + logs := tx.Txn().Logs() + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, validatorA, 1, 1, validatorASelfStake, validatorASelfStake, wantValidatorASelfStake) + assertStakerSlashedLogForVotingPowerTest(t, logs, slashEpoch, validatorA, delegatorA, 2, 1, validatorADelegatedStake, validatorADelegatedStake, wantDelegatorAStake) + require.Zero(t, readPoSU64StateForVotingPowerTest(tx, "xgr.pos.slashed", slashEpoch, validatorA)) + require.Zero(t, readPoSBigStateForVotingPowerTest(tx, "xgr.pos.slash.amount", slashEpoch, validatorA).Sign()) + require.LessOrEqual(t, wantSlashAmount, validatorASelfStake+validatorADelegatedStake) + require.Equal(t, wantValidatorASelfStake, readStakerAmountForVotingPowerTest(tx, validatorA)) + require.Equal(t, wantDelegatorAStake, readStakerAmountForVotingPowerTest(tx, delegatorA)) + require.Equal(t, wantDelegatorAStake, readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, wantDelegatorAStake, readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9)) + require.Equal(t, readStakerAmountForVotingPowerTest(tx, delegatorA), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8)) + require.Equal(t, readStakerAmountForVotingPowerTest(tx, delegatorA), readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9)) + require.Equal(t, validatorBStake, readStakerAmountForVotingPowerTest(tx, validatorB)) + require.Equal(t, validatorASelfStake+validatorADelegatedStake+validatorBStake-wantSlashAmount, txnBalanceUint64ForVotingPowerTest(tx, staking.AddrStakingContract)) + require.Positive(t, readStakerAmountForVotingPowerTest(tx, validatorA)) + require.Positive(t, readStakerAmountForVotingPowerTest(tx, delegatorA)) + require.False(t, isStakerActiveForVotingPowerTest(tx, validatorA), "zero-uptime validator is deactivated by finalize") + require.Equal(t, uint64(20), readStakerDeactivatedAtForVotingPowerTest(tx, validatorA)) + assertSnapshot(21, 20, wantValidatorAPower, validatorBStake, wantTotalPower) + + t.Logf("slash amount=%d final validatorA self=%d delegatorA=%d rawDelegated=%d activeDelegated=%d validatorB=%d totalVotingPower=%d", + wantSlashAmount, + readStakerAmountForVotingPowerTest(tx, validatorA), + readStakerAmountForVotingPowerTest(tx, delegatorA), + readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 8), + readValidatorDelegatedStakeTotalForVotingPowerTest(tx, validatorA, 9), + readStakerAmountForVotingPowerTest(tx, validatorB), + wantTotalPower, + ) +} + +func TestWeightedCommittedSeals_StakeAndUptimePowerThreshold(t *testing.T) { + pool := newTesterAccountPool(t) + pool.add("A", "B", "C", "D") + valSet := pool.ValidatorSet() + hash := types.BytesToHash(crypto.Keccak256([]byte("weighted committed seals power threshold"))) + round := uint64(1) + proposal := &types.Header{Number: 11} + + type votingPowerConfig struct { + stake uint64 + nominal uint64 + effective uint64 + } + + newWeightedSealBackend := func(powers map[string]votingPowerConfig) (*backendIBFT, *types.Header) { + t.Helper() + + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + genesisRoot, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + ex.GetHash = func(h *types.Header) state.GetHashByNumber { + return func(i uint64) types.Hash { return genesisRoot } + } + + tx, err := ex.BeginTxn(genesisRoot, &types.Header{Number: 10}, types.ZeroAddress) + require.NoError(t, err) + contractState, err := stakingHelper.PredeployStakingSC(valSet, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: uint64(valSet.Len()), EpochSize: 2}) + require.NoError(t, err) + require.NoError(t, tx.SetAccountDirectly(staking.AddrStakingContract, contractState)) + tx.Txn().SetNonce(pos.PosSysAddr, 1) + + for name, power := range powers { + addr := pool.get(name).Address() + setValidatorSelfStake(t, tx, addr, power.stake) + setNominalAndEffectiveWeight(tx, addr, power.nominal, power.effective) + } + + _, root, err := tx.Commit() + require.NoError(t, err) + + parent := &types.Header{Number: 10, StateRoot: root} + parent.ComputeHash() + + backend := &backendIBFT{ + executor: ex, + uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, + forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}, + } + + return backend, parent + } + + committedSealsFrom := func(names ...string) signer.Seals { + t.Helper() + + seals := signer.SerializedSeal{} + for _, name := range names { + acc := pool.get(name) + s := signer.NewSigner( + signer.NewECDSAKeyManagerFromKey(acc.priv), + signer.NewECDSAKeyManagerFromKey(acc.priv), + ) + seal, err := s.CreateCommittedSeal(hash.Bytes()) + require.NoError(t, err) + seals = append(seals, seal) + } + + return &seals + } + + fullPowerBackend, fullPowerParent := newWeightedSealBackend(map[string]votingPowerConfig{ + "A": {stake: 700, nominal: 10_000, effective: 10_000}, + "B": {stake: 100, nominal: 10_000, effective: 10_000}, + "C": {stake: 100, nominal: 10_000, effective: 10_000}, + "D": {stake: 100, nominal: 10_000, effective: 10_000}, + }) + require.Equal(t, "667", weightedQuorumThreshold(big.NewInt(1_000)).String()) + require.NoError(t, fullPowerBackend.verifyWeightedCommittedPower(11, hash, committedSealsFrom("A"), valSet, proposal, fullPowerParent, &round), "one high-power signer must satisfy weighted quorum even though signer count is low") + err := fullPowerBackend.verifyWeightedCommittedPower(11, hash, committedSealsFrom("B", "C", "D"), valSet, proposal, fullPowerParent, &round) + require.ErrorIs(t, err, signer.ErrNotEnoughCommittedSeals, "three low-power signers must not satisfy stake-weighted quorum by validator count alone") + require.Contains(t, err.Error(), "collected=300") + require.Contains(t, err.Error(), "quorum=667") + + decayedBackend, decayedParent := newWeightedSealBackend(map[string]votingPowerConfig{ + "A": {stake: 700, nominal: 10_000, effective: 2_858}, + "B": {stake: 100, nominal: 10_000, effective: 10_000}, + "C": {stake: 100, nominal: 10_000, effective: 10_000}, + "D": {stake: 100, nominal: 10_000, effective: 10_000}, + }) + decayedPowers, decayedSnap, err := decayedBackend.effectiveVotingPowerSnapshot(11, valSet, decayedParent) + require.NoError(t, err) + require.Equal(t, uint64(200), decayedPowers[types.AddressToString(pool.get("A").Address())].Uint64()) + require.Equal(t, "500", decayedSnap.totalVotingPower) + require.Equal(t, "334", weightedQuorumThreshold(big.NewInt(500)).String()) + err = decayedBackend.verifyWeightedCommittedPower(11, hash, committedSealsFrom("A", "B"), valSet, proposal, decayedParent, &round) + require.ErrorIs(t, err, signer.ErrNotEnoughCommittedSeals, "nominally high stake must not count after uptime decay lowers effective power") + require.Contains(t, err.Error(), "collected=300") + require.Contains(t, err.Error(), "quorum=334") + require.NoError(t, decayedBackend.verifyWeightedCommittedPower(11, hash, committedSealsFrom("A", "B", "C", "D"), valSet, proposal, decayedParent, &round), "additional effective power must satisfy weighted quorum after uptime decay") +} + +func TestWeightedCommittedSeals_RejectsDuplicateUnknownAndWrongSealPower(t *testing.T) { + pool := newTesterAccountPool(t) + pool.add("A", "B", "C", "D", "E") + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(pool.get("A").Address()), + validators.NewECDSAValidator(pool.get("B").Address()), + validators.NewECDSAValidator(pool.get("C").Address()), + validators.NewECDSAValidator(pool.get("D").Address()), + ) + hash := types.BytesToHash(crypto.Keccak256([]byte("weighted committed seals duplicate unknown wrong hash"))) + wrongHash := types.BytesToHash(crypto.Keccak256([]byte("wrong committed hash"))) + round := uint64(1) + wrongRound := uint64(2) + proposal := &types.Header{Number: 11} + + type votingPowerConfig struct{ stake, nominal, effective uint64 } + newWeightedSealBackend := func(powers map[string]votingPowerConfig) (*backendIBFT, *types.Header) { + t.Helper() + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + genesisRoot, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + ex.GetHash = func(h *types.Header) state.GetHashByNumber { return func(i uint64) types.Hash { return genesisRoot } } + tx, err := ex.BeginTxn(genesisRoot, &types.Header{Number: 10}, types.ZeroAddress) + require.NoError(t, err) + contractState, err := stakingHelper.PredeployStakingSC(valSet, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: uint64(valSet.Len()), EpochSize: 2}) + require.NoError(t, err) + require.NoError(t, tx.SetAccountDirectly(staking.AddrStakingContract, contractState)) + for name, power := range powers { + addr := pool.get(name).Address() + setValidatorSelfStake(t, tx, addr, power.stake) + setNominalAndEffectiveWeight(tx, addr, power.nominal, power.effective) + } + _, root, err := tx.Commit() + require.NoError(t, err) + parent := &types.Header{Number: 10, StateRoot: root} + parent.ComputeHash() + return &backendIBFT{executor: ex, uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}}, parent + } + + sealFor := func(name string, sealHash types.Hash) []byte { + t.Helper() + acc := pool.get(name) + s := signer.NewSigner(signer.NewECDSAKeyManagerFromKey(acc.priv), signer.NewECDSAKeyManagerFromKey(acc.priv)) + seal, err := s.CreateCommittedSeal(sealHash.Bytes()) + require.NoError(t, err) + return seal + } + seals := func(items ...[]byte) signer.Seals { + t.Helper() + out := signer.SerializedSeal{} + for _, item := range items { + out = append(out, item) + } + return &out + } + + fullBackend, fullParent := newWeightedSealBackend(map[string]votingPowerConfig{ + "A": {stake: 700, nominal: 10_000, effective: 10_000}, + "B": {stake: 100, nominal: 10_000, effective: 10_000}, + "C": {stake: 100, nominal: 10_000, effective: 10_000}, + "D": {stake: 100, nominal: 10_000, effective: 10_000}, + }) + require.NoError(t, fullBackend.verifyWeightedCommittedPower(11, hash, seals(sealFor("A", hash), sealFor("A", hash)), valSet, proposal, fullParent, &round), "duplicate high-power signer is deduplicated; A alone legitimately satisfies quorum") + require.ErrorIs(t, fullBackend.verifyWeightedCommittedPower(11, hash, seals(sealFor("E", hash)), valSet, proposal, fullParent, &round), signer.ErrNonValidatorCommittedSeal) + require.Error(t, fullBackend.verifyWeightedCommittedPower(11, hash, seals(sealFor("A", wrongHash)), valSet, proposal, fullParent, &round), "a validator seal over the wrong commit hash must not be accepted for this hash") + require.Error(t, fullBackend.verifyWeightedCommittedPower(11, hash, seals([]byte{0x01, 0x02, 0x03}), valSet, proposal, fullParent, &round), "malformed ECDSA seal must fail recovery") + + thresholdBackend, thresholdParent := newWeightedSealBackend(map[string]votingPowerConfig{ + "A": {stake: 400, nominal: 10_000, effective: 10_000}, + "B": {stake: 300, nominal: 10_000, effective: 10_000}, + "C": {stake: 200, nominal: 10_000, effective: 10_000}, + "D": {stake: 100, nominal: 10_000, effective: 10_000}, + }) + err := thresholdBackend.verifyWeightedCommittedPower(11, hash, seals(sealFor("B", hash), sealFor("B", hash), sealFor("C", hash)), valSet, proposal, thresholdParent, &round) + require.ErrorIs(t, err, signer.ErrNotEnoughCommittedSeals, "duplicate B must not be double-counted to cross quorum") + require.Contains(t, err.Error(), "collected=500") + require.Contains(t, err.Error(), "quorum=667") + + ordered := seals(sealFor("A", hash), sealFor("B", hash)) + reversed := seals(sealFor("B", hash), sealFor("A", hash)) + require.NoError(t, thresholdBackend.verifyWeightedCommittedPower(11, hash, ordered, valSet, proposal, thresholdParent, &round)) + require.NoError(t, thresholdBackend.verifyWeightedCommittedPower(11, hash, reversed, valSet, proposal, thresholdParent, &round), "signer ordering does not change collected power") + require.NoError(t, thresholdBackend.verifyWeightedCommittedPower(11, hash, ordered, valSet, proposal, thresholdParent, &wrongRound), "current ECDSA committed-seal power path does not encode round in the seal digest") +} + +func TestSnapshotVotingPowers_MicroDecayAsStakeMultiplier_AndRestore(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000002")), + ) + stateTx := newVotingPowerTestTransition(t, valSet, 10) + a := valSet.At(0).Addr() + b := valSet.At(1).Addr() + setValidatorSelfStake(t, stateTx, a, 10_000) + setValidatorSelfStake(t, stateTx, b, 30_000) + setNominalAndEffectiveWeight(stateTx, a, 10_000, 10_000) + setNominalAndEffectiveWeight(stateTx, b, 10_000, 5_000) + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + + res, _, err := backend.snapshotVotingPowers(10, 9, valSet, stateTx, true) + require.NoError(t, err) + require.Equal(t, uint64(10_000), res[types.AddressToString(a)].Uint64()) + require.Equal(t, uint64(15_000), res[types.AddressToString(b)].Uint64()) + + setNominalAndEffectiveWeight(stateTx, b, 10_000, 10_000) + res, _, err = backend.snapshotVotingPowers(10, 9, valSet, stateTx, true) + require.NoError(t, err) + require.Equal(t, uint64(30_000), res[types.AddressToString(b)].Uint64()) +} + +func TestSnapshotVotingPowers_FirstPoSBlock_UsesUnitWeights_WhenParentPrePoS(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000002")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000003")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000004")), + ) + backend := &backendIBFT{} + powers, snap, err := backend.snapshotVotingPowers(50, 49, valSet, nil, false) + require.NoError(t, err) + require.Equal(t, "4", snap.totalVotingPower) + require.Equal(t, "3", snap.quorumThreshold) + for i := 0; i < valSet.Len(); i++ { + addr := valSet.At(uint64(i)).Addr() + require.Equal(t, uint64(1), powers[types.AddressToString(addr)].Uint64()) + } +} + +func TestSnapshotVotingPowers_SecondPoSBlock_MissingStakeFails(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001"))) + stateTx := newBareVotingPowerTestTransition(t, 50) + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}} + _, _, err := backend.snapshotVotingPowers(51, 50, valSet, stateTx, true) + require.Error(t, err) + require.Contains(t, err.Error(), "missing effective stake") +} + +func TestSnapshotVotingPowers_UsesConsensusStake_WhenValidatorDeactivated(t *testing.T) { + t.Parallel() + val := types.StringToAddress("0x1000000000000000000000000000000000000001") + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(val)) + stateTx := newVotingPowerTestTransition(t, valSet, 250) + setValidatorSelfStake(t, stateTx, val, 10) + setStakerDeactivatedAt(t, stateTx, val, 200) + setNominalAndEffectiveWeight(stateTx, val, 10_000, 10_000) + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + + res, _, err := backend.snapshotVotingPowers(251, 250, valSet, stateTx, true) + require.NoError(t, err) + require.Equal(t, uint64(10), res[types.AddressToString(val)].Uint64()) +} + +func TestSnapshotVotingPowers_EpochBoundaryDeactivationRegression(t *testing.T) { + t.Parallel() + val := types.StringToAddress("0x1000000000000000000000000000000000000001") + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(val)) + stateTx := newVotingPowerTestTransition(t, valSet, 250) + setEpochSizeForVotingPowerTest(t, stateTx, 50) + setValidatorSelfStake(t, stateTx, val, 10) + setStakerDeactivatedAt(t, stateTx, val, 200) + setNominalAndEffectiveWeight(stateTx, val, 10_000, 10_000) + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + + _, _, err := backend.snapshotVotingPowers(251, 250, valSet, stateTx, true) + require.NoError(t, err) +} + +func TestConsensusDoesNotReferenceRemovedPoSWrappers(t *testing.T) { + t.Parallel() + content, err := os.ReadFile(filepath.Join("..", "..", "consensus", "ibft", "ibft.go")) + require.NoError(t, err) + require.NotContains(t, string(content), "is"+"PoSActiveAt(") + require.NotContains(t, string(content), "is"+"StakeWeightedVotingActive(") + require.NotContains(t, string(content), "is"+"BeaconActiveAt(") +} + +func TestPoAToPoSBoundary_DoesNotDeadlockVotingPowerInit(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000002")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000003")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000004")), + ) + backend := &backendIBFT{} + powers, snap, err := backend.snapshotVotingPowers(50, 49, valSet, nil, false) + require.NoError(t, err) + require.Equal(t, "4", snap.totalVotingPower) + for i := 0; i < valSet.Len(); i++ { + addr := valSet.At(uint64(i)).Addr() + require.Equal(t, uint64(1), powers[types.AddressToString(addr)].Uint64()) + } +} + +func TestSnapshotVotingPowers_MicroEpochDutyWithoutSeen_DecaysOnlyAfterBoundary(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000002")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000003")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000004")), + ) + tx := newVotingPowerTestTransitionWithFeePoolSplit(t, valSet, 110) + setEpochSizeForVotingPowerTest(t, tx, 100) + cfg := pos.UptimeConfig{MicroEpochSize: 4, MicroEpochNominalWeight: 10_000, MicroEpochInactivityDecayBps: 9_000} + backend := &backendIBFT{uptimeCfg: cfg, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + for i := 0; i < valSet.Len(); i++ { + addr := valSet.At(uint64(i)).Addr() + setValidatorSelfStake(t, tx, addr, 10) + setNominalAndEffectiveWeight(tx, addr, 10_000, 10_000) + } + + last := valSet.At(0).Addr() + tx.Txn().SetState(pos.PosSysAddr, posKeyLastProposer(), addressToHash(last)) + s := &sequenceSigner{proposers: map[uint64]types.Address{ + 101: valSet.At(0).Addr(), + 102: valSet.At(0).Addr(), + 103: valSet.At(0).Addr(), + 104: valSet.At(0).Addr(), + 105: valSet.At(0).Addr(), + }} + for _, block := range []uint64{101, 102, 103, 104} { + r := uint64(0) + extra := &signer.IstanbulExtra{Validators: valSet, RoundNumber: &r, CommittedSeals: &signer.SerializedSeal{}, ParentCommittedSeals: &signer.SerializedSeal{}} + header := &types.Header{Number: block, ExtraData: extra.MarshalRLPTo(make([]byte, signer.IstanbulExtraVanity))} + s.extra = extra + require.NoError(t, pos.RecordBlockUptime(header, 100, valSet, s, cfg, tx)) + } + target := valSet.At(1).Addr() + require.Equal(t, uint64(10_000), pos.UptimeEffectiveWeight(tx.Txn(), target)) + + powersBefore, snapBefore, err := backend.snapshotVotingPowers(105, 104, valSet, tx, true) + require.NoError(t, err) + require.Equal(t, uint64(10), powersBefore[types.AddressToString(target)].Uint64()) + require.Equal(t, "40", snapBefore.totalVotingPower) + + r := uint64(0) + extra := &signer.IstanbulExtra{Validators: valSet, RoundNumber: &r, CommittedSeals: &signer.SerializedSeal{}, ParentCommittedSeals: &signer.SerializedSeal{}} + header := &types.Header{Number: 105, ExtraData: extra.MarshalRLPTo(make([]byte, signer.IstanbulExtraVanity))} + s.extra = extra + require.NoError(t, pos.RecordBlockUptime(header, 100, valSet, s, cfg, tx)) + + require.Equal(t, uint64(9_000), pos.UptimeEffectiveWeight(tx.Txn(), target)) + powersAfter, snapAfter, err := backend.snapshotVotingPowers(106, 105, valSet, tx, true) + require.NoError(t, err) + require.Equal(t, uint64(9), powersAfter[types.AddressToString(target)].Uint64()) + require.Equal(t, "39", snapAfter.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(big.NewInt(39)).String(), snapAfter.quorumThreshold) +} + +func TestSnapshotVotingPowers_Height201DeactivatedValidatorSelfStakeRegression(t *testing.T) { + t.Parallel() + valSet := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000002")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000003")), + validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000004")), + ) + tx := newVotingPowerTestTransition(t, valSet, 200) + setEpochSizeForVotingPowerTest(t, tx, 50) + backend := &backendIBFT{uptimeCfg: pos.UptimeConfig{MicroEpochSize: 4, MicroEpochNominalWeight: 10_000}, forkManager: &votingPowerForkManager{active: func(uint64) bool { return true }}} + + for i := 0; i < valSet.Len(); i++ { + addr := valSet.At(uint64(i)).Addr() + setValidatorSelfStake(t, tx, addr, 10) + setNominalAndEffectiveWeight(tx, addr, 10_000, 10_000) + } + + deactivated := valSet.At(0).Addr() + setStakerDeactivatedAt(t, tx, deactivated, 55) + + powers, snap, err := backend.snapshotVotingPowers(201, 200, valSet, tx, true) + require.NoError(t, err) + require.Equal(t, uint64(10), powers[types.AddressToString(deactivated)].Uint64()) + require.Equal(t, "40", snap.totalVotingPower) + require.Equal(t, weightedQuorumThreshold(big.NewInt(40)).String(), snap.quorumThreshold) + + effective := contractstore.ReadValidatorEffectiveTotalStakeAt(tx, deactivated, 200) + voting := contractstore.ReadValidatorVotingStakeAt(tx, deactivated, 200) + require.Equal(t, int64(0), effective.Int64()) + require.Equal(t, int64(10), voting.Int64()) +} + +func slashEventTopicForVotingPowerTest() types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte("StakerSlashed(uint256,address,address,uint8,uint256,uint256,uint256,uint256,uint256,uint256,uint256,address)"))) +} + +func abiHashU64ForVotingPowerTest(v uint64) types.Hash { + return types.BytesToHash(logWordBigForVotingPowerTest(new(big.Int).SetUint64(v))) +} + +func abiHashAddressForVotingPowerTest(addr types.Address) types.Hash { + return types.BytesToHash(abiWordAddressForVotingPowerTest(addr)) +} + +func abiWordAddressForVotingPowerTest(addr types.Address) []byte { + var out [32]byte + copy(out[12:], addr[:]) + return out[:] +} + +func logWordBigForVotingPowerTest(v *big.Int) []byte { + var out [32]byte + if v == nil || v.Sign() == 0 { + return out[:] + } + b := v.Bytes() + if len(b) > 32 { + b = b[len(b)-32:] + } + copy(out[32-len(b):], b) + return out[:] +} + +func assertStakerSlashedLogForVotingPowerTest( + t *testing.T, + logs []*types.Log, + epoch uint64, + validator types.Address, + staker types.Address, + role uint8, + amount uint64, + stakeSnapshot uint64, + stakeBefore uint64, + stakeAfter uint64, +) { + t.Helper() + + wantTopic := slashEventTopicForVotingPowerTest() + wantEpoch := abiHashU64ForVotingPowerTest(epoch) + wantValidator := abiHashAddressForVotingPowerTest(validator) + wantStaker := abiHashAddressForVotingPowerTest(staker) + + for _, log := range logs { + if log.Address != pos.PosSysAddr || len(log.Topics) != 4 || log.Topics[0] != wantTopic || log.Topics[1] != wantEpoch || log.Topics[2] != wantValidator || log.Topics[3] != wantStaker { + continue + } + + require.Len(t, log.Data, 9*32) + require.Equal(t, new(big.Int).SetUint64(uint64(role)), logWordBigIntForVotingPowerTest(log.Data, 0)) + require.Equal(t, new(big.Int).SetUint64(amount), logWordBigIntForVotingPowerTest(log.Data, 1)) + require.Equal(t, new(big.Int).SetUint64(stakeSnapshot), logWordBigIntForVotingPowerTest(log.Data, 2)) + require.Equal(t, new(big.Int).SetUint64(stakeBefore), logWordBigIntForVotingPowerTest(log.Data, 3)) + require.Equal(t, new(big.Int).SetUint64(stakeAfter), logWordBigIntForVotingPowerTest(log.Data, 4)) + require.Equal(t, new(big.Int).SetUint64(1), logWordBigIntForVotingPowerTest(log.Data, 5), "slots") + require.Equal(t, new(big.Int).SetUint64(1), logWordBigIntForVotingPowerTest(log.Data, 6), "missed") + require.Equal(t, new(big.Int).SetUint64(100), logWordBigIntForVotingPowerTest(log.Data, 7), "slashBps") + require.Equal(t, abiWordAddressForVotingPowerTest(chain.DefaultBurnedAddress), log.Data[8*32:9*32], "destination") + return + } + + require.Failf(t, "missing StakerSlashed log", "epoch=%d validator=%s staker=%s", epoch, validator, staker) +} + +func logWordBigIntForVotingPowerTest(data []byte, idx int) *big.Int { + return new(big.Int).SetBytes(data[idx*32 : (idx+1)*32]) +} + +func posStateKeyForVotingPowerTest(prefix string, epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(prefix), eb[:], addr.Bytes())) +} + +func posEpochValidatorsLenKeyForVotingPowerTest(epoch uint64) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte("xgr.pos.epoch.validators.len"), eb[:])) +} + +func posEpochValidatorKeyForVotingPowerTest(epoch, idx uint64) types.Hash { + var eb [8]byte + var ib [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + binary.BigEndian.PutUint64(ib[:], idx) + + return types.BytesToHash(crypto.Keccak256([]byte("xgr.pos.epoch.validators.val"), eb[:], ib[:])) +} + +func setPoSEpochValidatorsSnapshotForVotingPowerTest(t *testing.T, txn *state.Transition, epoch uint64, vals validators.Validators) { + t.Helper() + txn.Txn().SetState(pos.PosSysAddr, posEpochValidatorsLenKeyForVotingPowerTest(epoch), types.BytesToHash(new(big.Int).SetUint64(uint64(vals.Len())).Bytes())) + for i := 0; i < vals.Len(); i++ { + txn.Txn().SetState(pos.PosSysAddr, posEpochValidatorKeyForVotingPowerTest(epoch, uint64(i)), addressToHash(vals.At(uint64(i)).Addr())) + } +} + +func setPoSU64StateForVotingPowerTest(txn *state.Transition, prefix string, epoch uint64, addr types.Address, value uint64) { + var b [32]byte + binary.BigEndian.PutUint64(b[24:], value) + txn.Txn().SetState(pos.PosSysAddr, posStateKeyForVotingPowerTest(prefix, epoch, addr), types.BytesToHash(b[:])) +} + +func readPoSU64StateForVotingPowerTest(txn *state.Transition, prefix string, epoch uint64, addr types.Address) uint64 { + h := txn.Txn().GetState(pos.PosSysAddr, posStateKeyForVotingPowerTest(prefix, epoch, addr)) + return binary.BigEndian.Uint64(h[24:]) +} + +func setPoSBigStateForVotingPowerTest(txn *state.Transition, prefix string, epoch uint64, addr types.Address, value *big.Int) { + txn.Txn().SetState(pos.PosSysAddr, posStateKeyForVotingPowerTest(prefix, epoch, addr), types.BytesToHash(value.Bytes())) +} + +func readPoSBigStateForVotingPowerTest(txn *state.Transition, prefix string, epoch uint64, addr types.Address) *big.Int { + h := txn.Txn().GetState(pos.PosSysAddr, posStateKeyForVotingPowerTest(prefix, epoch, addr)) + return new(big.Int).SetBytes(h[:]) +} + +func readStakerAmountForVotingPowerTest(txn *state.Transition, staker types.Address) uint64 { + h := txn.Txn().GetState(staking.AddrStakingContract, stakingTestStakerSlotWithOffset(staker, 1)) + return new(big.Int).SetBytes(h[:]).Uint64() +} + +func readValidatorDelegatedStakeTotalForVotingPowerTest(txn *state.Transition, validator types.Address, slot int64) uint64 { + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32)...), + ) + h := txn.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(base)) + return new(big.Int).SetBytes(h[:]).Uint64() +} + +func txnBalanceUint64ForVotingPowerTest(txn *state.Transition, addr types.Address) uint64 { + return new(big.Int).Set(txn.Txn().GetBalance(addr)).Uint64() +} + +func isStakerActiveForVotingPowerTest(txn *state.Transition, staker types.Address) bool { + h := txn.Txn().GetState(staking.AddrStakingContract, stakingTestStakerSlotWithOffset(staker, 0)) + packed := new(big.Int).SetBytes(h[:]) + active := new(big.Int).Rsh(packed, 8) + active.And(active, new(big.Int).SetUint64(0xff)) + + return active.Sign() != 0 +} + +func readStakerDeactivatedAtForVotingPowerTest(txn *state.Transition, staker types.Address) uint64 { + h := txn.Txn().GetState(staking.AddrStakingContract, stakingTestStakerSlotWithOffset(staker, 3)) + return new(big.Int).SetBytes(h[:]).Uint64() +} + +func newVotingPowerTestTransition(t *testing.T, vals validators.Validators, block uint64) *state.Transition { + t.Helper() + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + root, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + ex.GetHash = func(h *types.Header) state.GetHashByNumber { + return func(i uint64) types.Hash { return root } + } + txn, err := ex.BeginTxn(root, &types.Header{Number: block}, types.ZeroAddress) + require.NoError(t, err) + contractState, err := stakingHelper.PredeployStakingSC(vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: uint64(vals.Len()), EpochSize: 2}) + require.NoError(t, err) + require.NoError(t, txn.SetAccountDirectly(staking.AddrStakingContract, contractState)) + return txn +} + +func newVotingPowerTestTransitionWithFeePoolSplit(t *testing.T, vals validators.Validators, block uint64) *state.Transition { + t.Helper() + st := itrie.NewState(itrie.NewMemoryStorage()) + forks := chain.AllForksEnabled.Copy() + forks.SetFork(chain.FeePoolSplit, chain.NewFork(0)) + ex := state.NewExecutor(&chain.Params{Forks: forks, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + root, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + ex.GetHash = func(h *types.Header) state.GetHashByNumber { + return func(i uint64) types.Hash { return root } + } + txn, err := ex.BeginTxn(root, &types.Header{Number: block}, types.ZeroAddress) + require.NoError(t, err) + contractState, err := stakingHelper.PredeployStakingSC(vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: uint64(vals.Len()), EpochSize: 2}) + require.NoError(t, err) + require.NoError(t, txn.SetAccountDirectly(staking.AddrStakingContract, contractState)) + return txn +} + +func newBareVotingPowerTestTransition(t *testing.T, block uint64) *state.Transition { + t.Helper() + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + root, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + ex.GetHash = func(h *types.Header) state.GetHashByNumber { + return func(i uint64) types.Hash { return root } + } + txn, err := ex.BeginTxn(root, &types.Header{Number: block}, types.ZeroAddress) + require.NoError(t, err) + return txn +} + +func setNominalAndEffectiveWeight(txn *state.Transition, addr types.Address, nominal, effective uint64) { + toHash := func(v uint64) types.Hash { + var b [32]byte + binary.BigEndian.PutUint64(b[24:], v) + return types.BytesToHash(b[:]) + } + txn.Txn().SetState(pos.PosSysAddr, types.BytesToHash(crypto.Keccak256([]byte("xgr.uptime.nominal.weight"), addr.Bytes())), toHash(nominal)) + txn.Txn().SetState(pos.PosSysAddr, types.BytesToHash(crypto.Keccak256([]byte("xgr.uptime.effective.weight"), addr.Bytes())), toHash(effective)) +} + +func setValidatorSelfStake(t *testing.T, txn *state.Transition, validator types.Address, stake uint64) { + t.Helper() + stakerSlotWithOffset := func(addr types.Address, offset int64) types.Hash { + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(addr.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(3).Bytes(), 32)...), + ) + i := new(big.Int).SetBytes(base) + i.Add(i, big.NewInt(offset)) + return types.BytesToHash(i.Bytes()) + } + toHashBig := func(v *big.Int) types.Hash { return types.BytesToHash(v.Bytes()) } + // staker self amount + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(validator, 1), toHashBig(new(big.Int).SetUint64(stake))) + // staker validator pointer = self + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(validator, 4), types.BytesToHash(validator.Bytes())) + // active from genesis, not deactivated + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(validator, 2), types.BytesToHash(new(big.Int).SetUint64(1).Bytes())) + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(validator, 3), types.Hash{}) + + base := keccak.Keccak256(nil, append(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(6).Bytes(), 32)...)) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(base), types.BytesToHash(new(big.Int).SetUint64(1).Bytes())) + slot := new(big.Int).SetBytes(keccak.Keccak256(nil, common.PadLeftOrTrim(base, 32))) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(slot.Bytes()), types.BytesToHash(validator.Bytes())) +} + +func setValidatorSelfStakeRaw(t *testing.T, txn *state.Transition, validator types.Address, stake uint64, joinedAt uint64, mappedValidator types.Address) { + t.Helper() + stakerSlotWithOffset := func(addr types.Address, offset int64) types.Hash { + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(addr.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(3).Bytes(), 32)...), + ) + idx := new(big.Int).SetBytes(base) + idx.Add(idx, big.NewInt(offset)) + return types.BytesToHash(idx.Bytes()) + } + toHashBig := func(v *big.Int) types.Hash { return types.BytesToHash(v.Bytes()) } + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(validator, 1), toHashBig(new(big.Int).SetUint64(stake))) + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(validator, 4), types.BytesToHash(mappedValidator.Bytes())) + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(validator, 2), types.BytesToHash(new(big.Int).SetUint64(joinedAt).Bytes())) + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(validator, 3), types.Hash{}) +} + +func setDelegatorStakeForValidator( + t *testing.T, + txn *state.Transition, + validator types.Address, + delegator types.Address, + amount uint64, + joinedAt uint64, + deactivatedAt uint64, + active bool, +) { + t.Helper() + setStakerStakeForValidator(t, txn, delegator, validator, amount, joinedAt, deactivatedAt, active) + appendStakerForValidator(t, txn, validator, delegator) +} + +func setStakerStakeForValidator( + t *testing.T, + txn *state.Transition, + staker types.Address, + validator types.Address, + amount uint64, + joinedAt uint64, + deactivatedAt uint64, + active bool, +) { + t.Helper() + packed := big.NewInt(1) + if active { + packed.SetBit(packed, 8, 1) + } + txn.Txn().SetState(staking.AddrStakingContract, stakingTestStakerSlotWithOffset(staker, 0), types.BytesToHash(packed.Bytes())) + txn.Txn().SetState(staking.AddrStakingContract, stakingTestStakerSlotWithOffset(staker, 1), types.BytesToHash(new(big.Int).SetUint64(amount).Bytes())) + txn.Txn().SetState(staking.AddrStakingContract, stakingTestStakerSlotWithOffset(staker, 2), types.BytesToHash(new(big.Int).SetUint64(joinedAt).Bytes())) + txn.Txn().SetState(staking.AddrStakingContract, stakingTestStakerSlotWithOffset(staker, 3), types.BytesToHash(new(big.Int).SetUint64(deactivatedAt).Bytes())) + txn.Txn().SetState(staking.AddrStakingContract, stakingTestStakerSlotWithOffset(staker, 4), types.BytesToHash(validator.Bytes())) +} + +func appendStakerForValidator(t *testing.T, txn *state.Transition, validator types.Address, staker types.Address) { + t.Helper() + stakersByValidatorBase := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(6).Bytes(), 32)...), + ) + lengthKey := types.BytesToHash(stakersByValidatorBase) + lengthRaw := txn.Txn().GetState(staking.AddrStakingContract, lengthKey) + length := new(big.Int).SetBytes(lengthRaw[:]).Uint64() + + arrayBase := new(big.Int).SetBytes(keccak.Keccak256(nil, common.PadLeftOrTrim(stakersByValidatorBase, 32))) + arraySlot := new(big.Int).Add(arrayBase, new(big.Int).SetUint64(length)) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(arraySlot.Bytes()), types.BytesToHash(staker.Bytes())) + txn.Txn().SetState(staking.AddrStakingContract, lengthKey, types.BytesToHash(new(big.Int).SetUint64(length+1).Bytes())) + + stakerIndexOuter := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(7).Bytes(), 32)...), + ) + stakerIndexInner := append(common.PadLeftOrTrim(staker.Bytes(), 32), common.PadLeftOrTrim(stakerIndexOuter, 32)...) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(keccak.Keccak256(nil, stakerIndexInner)), types.BytesToHash(new(big.Int).SetUint64(length+1).Bytes())) +} + +func setValidatorDelegatedStakeTotals(t *testing.T, txn *state.Transition, validator types.Address, raw uint64, active uint64) { + t.Helper() + setValidatorDelegatedStakeTotal(t, txn, validator, 8, raw) + setValidatorDelegatedStakeTotal(t, txn, validator, 9, active) +} + +func setValidatorDelegatedStakeTotal(t *testing.T, txn *state.Transition, validator types.Address, slot int64, amount uint64) { + t.Helper() + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32)...), + ) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(base), types.BytesToHash(new(big.Int).SetUint64(amount).Bytes())) +} + +func stakingTestStakerSlotWithOffset(addr types.Address, offset int64) types.Hash { + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(addr.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(3).Bytes(), 32)...), + ) + idx := new(big.Int).SetBytes(base) + idx.Add(idx, big.NewInt(offset)) + return types.BytesToHash(idx.Bytes()) +} + +func setStakerDeactivatedAt(t *testing.T, txn *state.Transition, staker types.Address, block uint64) { + t.Helper() + stakerSlotWithOffset := func(addr types.Address, offset int64) types.Hash { + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(addr.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(3).Bytes(), 32)...), + ) + i := new(big.Int).SetBytes(base) + i.Add(i, big.NewInt(offset)) + return types.BytesToHash(i.Bytes()) + } + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(staker, 3), types.BytesToHash(new(big.Int).SetUint64(block).Bytes())) +} + +func setStakingConfigForVotingPowerTest(t *testing.T, txn *state.Transition, epochSize, minValidators, maxValidators uint64) { + t.Helper() + v := new(big.Int).SetUint64(maxValidators) + v.Lsh(v, 64) + v.Or(v, new(big.Int).SetUint64(minValidators)) + v.Lsh(v, 64) + v.Or(v, new(big.Int).SetUint64(epochSize)) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(big.NewInt(1).Bytes()), types.BytesToHash(v.Bytes())) +} + +func setEpochSizeForVotingPowerTest(t *testing.T, txn *state.Transition, epochSize uint64) { + t.Helper() + raw := txn.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(big.NewInt(0).Bytes())) + v := new(big.Int).SetBytes(raw[:]) + mask64 := new(big.Int).SetUint64(^uint64(0)) + clearMask := new(big.Int).Not(mask64) + v.And(v, clearMask) + v.Or(v, new(big.Int).SetUint64(epochSize)) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(big.NewInt(0).Bytes()), types.BytesToHash(v.Bytes())) +} + +type votingPowerForkManager struct{ active func(uint64) bool } + +func (m *votingPowerForkManager) Initialize() error { return nil } +func (m *votingPowerForkManager) Close() error { return nil } +func (m *votingPowerForkManager) GetSigner(uint64) (signer.Signer, error) { return nil, nil } +func (m *votingPowerForkManager) GetValidatorStore(uint64) (fork.ValidatorStore, error) { + return nil, nil +} +func (m *votingPowerForkManager) GetValidators(uint64) (validators.Validators, error) { + return nil, nil +} +func (m *votingPowerForkManager) GetHooks(uint64) fork.HooksInterface { return nil } +func (m *votingPowerForkManager) IsPosActive(h uint64) bool { return m.active != nil && m.active(h) } + +func TestPoAToPoSBoundaryVotingPowerSemantics(t *testing.T) { + pool := newTesterAccountPool(t) + pool.add("A", "B", "C") + valSet := pool.ValidatorSet() + const forkHeight uint64 = 10 + + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + genesisRoot, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + ex.GetHash = func(*types.Header) state.GetHashByNumber { return func(uint64) types.Hash { return genesisRoot } } + + tx, err := ex.BeginTxn(genesisRoot, &types.Header{Number: forkHeight - 1}, types.ZeroAddress) + require.NoError(t, err) + contractState, err := stakingHelper.PredeployStakingSC(valSet, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: uint64(valSet.Len()), EpochSize: 20}) + require.NoError(t, err) + require.NoError(t, tx.SetAccountDirectly(staking.AddrStakingContract, contractState)) + setValidatorSelfStake(t, tx, pool.get("A").Address(), 700) + setValidatorSelfStake(t, tx, pool.get("B").Address(), 200) + setValidatorSelfStake(t, tx, pool.get("C").Address(), 100) + for _, name := range []string{"A", "B", "C"} { + setNominalAndEffectiveWeight(tx, pool.get(name).Address(), 10_000, 10_000) + } + _, root, err := tx.Commit() + require.NoError(t, err) + + parentBeforeFork := &types.Header{Number: forkHeight - 1, StateRoot: root} + parentBeforeFork.ComputeHash() + parentAtFork := &types.Header{Number: forkHeight, StateRoot: root, ParentHash: parentBeforeFork.Hash} + parentAtFork.ComputeHash() + + backend := &backendIBFT{ + executor: ex, + uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, + forkManager: &votingPowerForkManager{active: func(h uint64) bool { return h >= forkHeight }}, + } + + powersAtFork, snapAtFork, err := backend.effectiveVotingPowerSnapshot(forkHeight, valSet, parentBeforeFork) + require.NoError(t, err) + require.Equal(t, "3", snapAtFork.totalVotingPower) + require.Equal(t, "2", snapAtFork.quorumThreshold) + for _, name := range []string{"A", "B", "C"} { + require.Equal(t, uint64(1), powersAtFork[types.AddressToString(pool.get(name).Address())].Uint64(), "height F must not read weighted stake from a non-PoS parent") + } + + powersAfterFork, snapAfterFork, err := backend.effectiveVotingPowerSnapshot(forkHeight+1, valSet, parentAtFork) + require.NoError(t, err) + require.Equal(t, uint64(700), powersAfterFork[types.AddressToString(pool.get("A").Address())].Uint64()) + require.Equal(t, uint64(200), powersAfterFork[types.AddressToString(pool.get("B").Address())].Uint64()) + require.Equal(t, uint64(100), powersAfterFork[types.AddressToString(pool.get("C").Address())].Uint64()) + require.Equal(t, "1000", snapAfterFork.totalVotingPower) + require.Equal(t, "667", snapAfterFork.quorumThreshold) +} + +func TestPoAToPoSBoundaryParentCommittedSealWeightedRules(t *testing.T) { + pool := newTesterAccountPool(t) + pool.add("A", "B", "C") + valSet := pool.ValidatorSet() + const forkHeight uint64 = 10 + + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + genesisRoot, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + ex.GetHash = func(*types.Header) state.GetHashByNumber { return func(uint64) types.Hash { return genesisRoot } } + + tx, err := ex.BeginTxn(genesisRoot, &types.Header{Number: forkHeight}, types.ZeroAddress) + require.NoError(t, err) + contractState, err := stakingHelper.PredeployStakingSC(valSet, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: uint64(valSet.Len()), EpochSize: 20}) + require.NoError(t, err) + require.NoError(t, tx.SetAccountDirectly(staking.AddrStakingContract, contractState)) + setValidatorSelfStake(t, tx, pool.get("A").Address(), 700) + setValidatorSelfStake(t, tx, pool.get("B").Address(), 200) + setValidatorSelfStake(t, tx, pool.get("C").Address(), 100) + for _, name := range []string{"A", "B", "C"} { + setNominalAndEffectiveWeight(tx, pool.get(name).Address(), 10_000, 10_000) + } + _, root, err := tx.Commit() + require.NoError(t, err) + posParent := &types.Header{Number: forkHeight, StateRoot: root} + posParent.ComputeHash() + + backend := &backendIBFT{ + executor: ex, + uptimeCfg: pos.UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10_000}, + forkManager: &votingPowerForkManager{active: func(h uint64) bool { return h >= forkHeight }}, + } + hash := types.BytesToHash(crypto.Keccak256([]byte("pos boundary committed seals"))) + proposal := &types.Header{Number: forkHeight + 1, ParentHash: posParent.Hash} + round := uint64(0) + sealsFrom := func(names ...string) signer.Seals { + out := signer.SerializedSeal{} + for _, name := range names { + s := signer.NewSigner(signer.NewECDSAKeyManagerFromKey(pool.get(name).priv), signer.NewECDSAKeyManagerFromKey(pool.get(name).priv)) + seal, err := s.CreateCommittedSeal(hash.Bytes()) + require.NoError(t, err) + out = append(out, seal) + } + return &out + } + + require.NoError(t, backend.verifyWeightedCommittedPower(forkHeight+1, hash, sealsFrom("A"), valSet, proposal, posParent, &round)) + err = backend.verifyWeightedCommittedPower(forkHeight+1, hash, sealsFrom("B", "C"), valSet, proposal, posParent, &round) + require.ErrorIs(t, err, signer.ErrNotEnoughCommittedSeals) + require.Contains(t, err.Error(), "collected=300") + require.Contains(t, err.Error(), "quorum=667") + + // Height F is PoS, but its parent is still PoA, so parent committed-seal voting power remains unit-based. + require.NoError(t, backend.verifyWeightedCommittedPower(forkHeight, hash, sealsFrom("B", "C"), valSet, &types.Header{Number: forkHeight}, &types.Header{Number: forkHeight - 1, StateRoot: root}, &round)) +} diff --git a/consensus/ibft/fork/hookregister.go b/consensus/ibft/fork/hookregister.go index 1e0c793..b6172b5 100644 --- a/consensus/ibft/fork/hookregister.go +++ b/consensus/ibft/fork/hookregister.go @@ -2,6 +2,8 @@ package fork import ( "github.com/xgr-network/xgr-node/consensus/ibft/hook" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" ) // PoAHookRegisterer that registers hooks for PoA mode @@ -61,19 +63,34 @@ func (r *PoAHookRegister) RegisterHooks(hooks *hook.Hooks, height uint64) { type PoSHookRegister struct { posForks IBFTForks epochSize uint64 + firstPoSFrom uint64 + hasPoS bool deployContractForks map[uint64]*IBFTFork + uptimeCfg pos.UptimeConfig + getSigner func(uint64) (signer.Signer, error) } // NewPoSHookRegister is a constructor of PoSHookRegister func NewPoSHookRegister( forks IBFTForks, epochSize uint64, + uptimeCfg pos.UptimeConfig, + getSigner func(uint64) (signer.Signer, error), ) *PoSHookRegister { posForks := forks.filterByType(PoS) deployContractForks := make(map[uint64]*IBFTFork) + var ( + firstPoSFrom uint64 + hasPoS bool + ) for _, fork := range posForks { + if !hasPoS || fork.From.Value < firstPoSFrom { + firstPoSFrom = fork.From.Value + hasPoS = true + } + if fork.Deployment == nil { continue } @@ -84,7 +101,11 @@ func NewPoSHookRegister( return &PoSHookRegister{ posForks: posForks, epochSize: epochSize, + firstPoSFrom: firstPoSFrom, + hasPoS: hasPoS, deployContractForks: deployContractForks, + uptimeCfg: uptimeCfg, + getSigner: getSigner, } } @@ -92,11 +113,11 @@ func NewPoSHookRegister( func (r *PoSHookRegister) RegisterHooks(hooks *hook.Hooks, height uint64) { if currentFork := r.posForks.getFork(height); currentFork != nil { // in PoS mode currently - registerTxInclusionGuardHooks(hooks, r.epochSize) + registerTxInclusionGuardHooks(hooks, r.epochSize, r.uptimeCfg, r.getSigner, r.firstPoSFrom) } if deploymentFork, ok := r.deployContractForks[height]; ok { // deploy or update staking contract in deployment height - registerStakingContractDeploymentHooks(hooks, deploymentFork) + registerStakingContractDeploymentHooks(hooks, deploymentFork, r.epochSize) } } diff --git a/consensus/ibft/fork/hooks.go b/consensus/ibft/fork/hooks.go index 56bd479..0e32de3 100644 --- a/consensus/ibft/fork/hooks.go +++ b/consensus/ibft/fork/hooks.go @@ -2,10 +2,12 @@ package fork import ( "errors" + "fmt" "github.com/xgr-network/xgr-node/consensus/ibft/hook" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" "github.com/xgr-network/xgr-node/contracts/staking" - "github.com/xgr-network/xgr-node/helper/hex" stakingHelper "github.com/xgr-network/xgr-node/helper/staking" "github.com/xgr-network/xgr-node/state" "github.com/xgr-network/xgr-node/types" @@ -17,6 +19,67 @@ var ( ErrTxInLastEpochOfBlock = errors.New("block must not have transactions in the last of epoch") ) +func chainShouldWriteTransactions(a, b hook.ShouldWriteTransactionsFunc) hook.ShouldWriteTransactionsFunc { + if a == nil { + return b + } + if b == nil { + return a + } + + return func(height uint64) bool { + return a(height) && b(height) + } +} + +func chainVerifyBlock(a, b hook.VerifyBlockFunc) hook.VerifyBlockFunc { + if a == nil { + return b + } + if b == nil { + return a + } + + return func(block *types.Block) error { + if err := a(block); err != nil { + return err + } + return b(block) + } +} + +func chainPreCommitState(a, b hook.PreCommitStateFunc) hook.PreCommitStateFunc { + if a == nil { + return b + } + if b == nil { + return a + } + + return func(header *types.Header, txn *state.Transition) error { + if err := a(header, txn); err != nil { + return err + } + return b(header, txn) + } +} + +func chainPostInsertBlock(a, b hook.PostInsertBlockFunc) hook.PostInsertBlockFunc { + if a == nil { + return b + } + if b == nil { + return a + } + + return func(block *types.Block) error { + if err := a(block); err != nil { + return err + } + return b(block) + } +} + // HeaderModifier is an interface for the struct that modifies block header for additional process type HeaderModifier interface { ModifyHeader(*types.Header, types.Address) error @@ -51,7 +114,7 @@ func registerUpdateValidatorsHooks( fromHeight uint64, ) { if us, ok := validatorStore.(Updatable); ok { - hooks.PostInsertBlockFunc = func(b *types.Block) error { + next := func(b *types.Block) error { if fromHeight != b.Number()+1 { return nil } @@ -59,26 +122,85 @@ func registerUpdateValidatorsHooks( // update validators if the block height is the one before beginning height return us.UpdateValidatorSet(validators, fromHeight) } + + hooks.PostInsertBlockFunc = chainPostInsertBlock(hooks.PostInsertBlockFunc, next) } } // registerPoSVerificationHooks registers that hooks to prevent the last epoch block from having transactions -func registerTxInclusionGuardHooks(hooks *hook.Hooks, epochSize uint64) { +func registerTxInclusionGuardHooks( + hooks *hook.Hooks, + epochSize uint64, + uptimeCfg pos.UptimeConfig, + getSigner func(uint64) (signer.Signer, error), + firstPoSFrom uint64, +) { isLastEpoch := func(height uint64) bool { return height > 0 && height%epochSize == 0 } - hooks.ShouldWriteTransactionFunc = func(height uint64) bool { - return !isLastEpoch(height) + guardShouldWrite := func(height uint64) bool { + return !isLastEpoch(height) || shouldSkipEpochFinalizationBeforePoS(height, firstPoSFrom) } - hooks.VerifyBlockFunc = func(block *types.Block) error { - if isLastEpoch(block.Number()) && len(block.Transactions) > 0 { + guardVerify := func(block *types.Block) error { + if !isLastEpoch(block.Number()) { + return nil + } + + if shouldSkipEpochFinalizationBeforePoS(block.Number(), firstPoSFrom) { + return nil + } + + if len(block.Transactions) == 0 { return ErrTxInLastEpochOfBlock } - return nil + if len(block.Transactions) == 1 && pos.IsEpochFinalizationSystemTx(block.Transactions[0], block.Number()) { + return nil + } + + return ErrTxInLastEpochOfBlock + } + + // 1) user-tx-free last epoch block once PoS finalization is active + hooks.ShouldWriteTransactionFunc = chainShouldWriteTransactions(hooks.ShouldWriteTransactionFunc, guardShouldWrite) + hooks.VerifyBlockFunc = chainVerifyBlock(hooks.VerifyBlockFunc, guardVerify) + + // 2) deterministic native epoch-finalize on the epoch boundary block + hooks.PreCommitStateFunc = chainPreCommitState(hooks.PreCommitStateFunc, func(header *types.Header, txn *state.Transition) error { + if !isLastEpoch(header.Number) { + return nil + } + if shouldSkipEpochFinalizationBeforePoS(header.Number, firstPoSFrom) { + return nil + } + if getSigner == nil { + return fmt.Errorf("missing signer getter") + } + headerSigner, err := getSigner(header.Number) + if err != nil { + return err + } + if headerSigner == nil { + return fmt.Errorf("missing signer") + } + finalizationTx := pos.EpochFinalizationSystemTx(header.Number) + + if err := pos.FinalizeEpoch(header, epochSize, uptimeCfg, headerSigner, txn); err != nil { + return err + } + + return txn.WriteSystemReceipt(finalizationTx) + }) +} + +func shouldSkipEpochFinalizationBeforePoS(boundaryBlock, firstPoSFrom uint64) bool { + if boundaryBlock == 0 { + return false } + + return boundaryBlock-1 < firstPoSFrom } // registerStakingContractDeploymentHooks registers hooks @@ -86,51 +208,190 @@ func registerTxInclusionGuardHooks(hooks *hook.Hooks, epochSize uint64) { func registerStakingContractDeploymentHooks( hooks *hook.Hooks, fork *IBFTFork, + epochSize uint64, ) { - hooks.PreCommitStateFunc = func(header *types.Header, txn *state.Transition) error { + deployOrUpdate := func(header *types.Header, txn *state.Transition) error { // safe check if header.Number != fork.Deployment.Value { return nil } - if txn.AccountExists(staking.AddrStakingContract) { - // update bytecode of deployed contract - codeBytes, err := hex.DecodeHex(stakingHelper.StakingSCBytecode) + // Bootstrap validator set: + // At PoA -> PoS transition, validators may not have staked yet. + // The contract must still contain the current validator list (with BLS keys) + // to keep the chain live. Stake filtering is applied later by fetcher. + bootstrapVals := fork.Validators + if bootstrapVals == nil || bootstrapVals.Len() == 0 { + parsedBootstrapVals, err := parseValidatorsFromHeader(header, fork.ValidatorType) if err != nil { - return err + return fmt.Errorf( + "staking predeploy bootstrap validator fallback failed at block %d (validatorType=%s): %w", + header.Number, + fork.ValidatorType, + err, + ) + } + bootstrapVals = parsedBootstrapVals + + if bootstrapVals == nil || bootstrapVals.Len() == 0 { + return fmt.Errorf( + "staking predeploy bootstrap validator fallback returned empty validator set at block %d", + header.Number, + ) } + } - return txn.SetCodeDirectly(staking.AddrStakingContract, codeBytes) - } else { - // deploy contract - contractState, err := stakingHelper.PredeployStakingSC( - fork.Validators, - getPreDeployParams(fork), + params, err := getPreDeployParams(fork, epochSize, uint64(bootstrapVals.Len())) + if err != nil { + return fmt.Errorf( + "staking predeploy params invalid at block %d (bootstrapValidators=%d): %w", + header.Number, + bootstrapVals.Len(), + err, ) + } - if err != nil { - return err + contractState, err := stakingHelper.PredeployStakingSCBootstrap( + bootstrapVals, + params, + ) + if err != nil { + return fmt.Errorf( + "staking predeploy bootstrap failed at block %d (validators=%d min=%d max=%d epochSize=%d): %w", + header.Number, + bootstrapVals.Len(), + params.MinValidatorCount, + params.MaxValidatorCount, + params.EpochSize, + err, + ) + } + + if txn.AccountExists(staking.AddrStakingContract) { + // Update bytecode (if needed) and ensure storage is bootstrapped exactly once. + // Use the precomputed runtime code (contractState.Code), not creation bytecode. + if err := txn.SetCodeDirectly(staking.AddrStakingContract, contractState.Code); err != nil { + return fmt.Errorf("staking predeploy code update failed at block %d: %w", header.Number, err) + } + + // If the contract storage is not initialized yet (e.g. maxNumValidators == 0), + // apply the bootstrap storage map. + // When uninitialized, stale bootstrap slots can still exist from a previous + // partial recovery and must be overwritten to match the deterministic + // bootstrap snapshot. + if stakingHelper.IsUninitializedStakingStorage(txn, staking.AddrStakingContract) { + for k, v := range contractState.Storage { + txn.Txn().SetState(staking.AddrStakingContract, k, v) + } } - return txn.SetAccountDirectly(staking.AddrStakingContract, contractState) + return nil + } + + // Deploy contract with fully bootstrapped storage. + if err := txn.SetAccountDirectly(staking.AddrStakingContract, contractState); err != nil { + return fmt.Errorf("staking predeploy account deployment failed at block %d: %w", header.Number, err) } + + return nil } + // Deploy/update must run first in the deployment block, before any other pre-commit hooks. + hooks.PreCommitStateFunc = chainPreCommitState(deployOrUpdate, hooks.PreCommitStateFunc) +} + +func parseValidatorsFromHeader( + header *types.Header, + validatorType validators.ValidatorType, +) (validators.Validators, error) { + if header == nil { + return nil, fmt.Errorf("header is nil") + } + + if len(header.ExtraData) < signer.IstanbulExtraVanity { + return nil, fmt.Errorf( + "extra-data shorter than vanity length (%d < %d)", + len(header.ExtraData), + signer.IstanbulExtraVanity, + ) + } + + extra := &signer.IstanbulExtra{ + Validators: validators.NewValidatorSetFromType(validatorType), + } + + switch validatorType { + case validators.ECDSAValidatorType: + extra.CommittedSeals = &signer.SerializedSeal{} + extra.ParentCommittedSeals = &signer.SerializedSeal{} + case validators.BLSValidatorType: + extra.CommittedSeals = &signer.AggregatedSeal{} + extra.ParentCommittedSeals = &signer.AggregatedSeal{} + default: + return nil, fmt.Errorf("unsupported validator type: %s", validatorType) + } + + if err := extra.UnmarshalRLP(header.ExtraData[signer.IstanbulExtraVanity:]); err != nil { + return nil, fmt.Errorf("unable to decode IBFT extra: %w", err) + } + + if extra.Validators == nil || extra.Validators.Len() == 0 { + return nil, fmt.Errorf("decoded validator set is empty") + } + + return extra.Validators, nil } // getPreDeployParams returns PredeployParams for Staking Contract from IBFTFork -func getPreDeployParams(fork *IBFTFork) stakingHelper.PredeployParams { - params := stakingHelper.PredeployParams{ - MinValidatorCount: stakingHelper.MinValidatorCount, - MaxValidatorCount: stakingHelper.MaxValidatorCount, +func getPreDeployParams( + fork *IBFTFork, + epochSize uint64, + bootstrapValidatorCount uint64, +) (stakingHelper.PredeployParams, error) { + if fork == nil { + return stakingHelper.PredeployParams{}, fmt.Errorf("PoS staking predeploy requires fork configuration") } + if bootstrapValidatorCount == 0 { + return stakingHelper.PredeployParams{}, fmt.Errorf("PoS staking predeploy requires at least one bootstrap validator") + } + + minValidatorCount := bootstrapValidatorCount if fork.MinValidatorCount != nil { - params.MinValidatorCount = fork.MinValidatorCount.Value + minValidatorCount = fork.MinValidatorCount.Value } + maxValidatorCount := uint64(0) if fork.MaxValidatorCount != nil { - params.MaxValidatorCount = fork.MaxValidatorCount.Value + maxValidatorCount = fork.MaxValidatorCount.Value + } else { + maxValidatorCount = bootstrapValidatorCount + } + + if maxValidatorCount > pos.MaxEpochValidatorsSnapshot { + return stakingHelper.PredeployParams{}, fmt.Errorf( + "invalid staking predeploy params: max validator count (%d) exceeds epoch snapshot max (%d)", + maxValidatorCount, + pos.MaxEpochValidatorsSnapshot, + ) + } + if minValidatorCount > maxValidatorCount { + return stakingHelper.PredeployParams{}, fmt.Errorf( + "invalid staking predeploy params: min validator count (%d) exceeds max (%d)", + minValidatorCount, + maxValidatorCount, + ) + } + if minValidatorCount > bootstrapValidatorCount { + return stakingHelper.PredeployParams{}, fmt.Errorf( + "invalid staking predeploy params: min validator count (%d) exceeds bootstrap validator count (%d)", + minValidatorCount, + bootstrapValidatorCount, + ) } - return params + return stakingHelper.PredeployParams{ + MinValidatorCount: minValidatorCount, + MaxValidatorCount: maxValidatorCount, + EpochSize: epochSize, + }, nil } diff --git a/consensus/ibft/fork/hooks_test.go b/consensus/ibft/fork/hooks_test.go index 5d6090e..6070f0b 100644 --- a/consensus/ibft/fork/hooks_test.go +++ b/consensus/ibft/fork/hooks_test.go @@ -2,12 +2,15 @@ package fork import ( "errors" + "math/big" "testing" "github.com/hashicorp/go-hclog" "github.com/stretchr/testify/assert" "github.com/xgr-network/xgr-node/chain" "github.com/xgr-network/xgr-node/consensus/ibft/hook" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" "github.com/xgr-network/xgr-node/contracts/staking" "github.com/xgr-network/xgr-node/crypto" "github.com/xgr-network/xgr-node/helper/common" @@ -27,6 +30,145 @@ type mockHeaderModifierStore struct { ProcessHeaderFunc func(*types.Header) error } +func Test_registerStakingContractDeploymentHooks_overwritesStaleBootstrapSlotsWhenUninitialized(t *testing.T) { + t.Parallel() + + oldVals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1111")), + ) + newVals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x2222")), + ) + + params := stakingHelper.PredeployParams{ + MinValidatorCount: 1, + MaxValidatorCount: 10, + EpochSize: 10, + } + + oldState, err := stakingHelper.PredeployStakingSCBootstrap(oldVals, params) + assert.NoError(t, err) + + newState, err := stakingHelper.PredeployStakingSCBootstrap(newVals, params) + assert.NoError(t, err) + + // Find the validators[0] storage slot (same key, different value between old/new bootstrap sets). + var validators0Key types.Hash + for k, oldV := range oldState.Storage { + newV, ok := newState.Storage[k] + if !ok || oldV == newV || oldV == (types.Hash{}) || newV == (types.Hash{}) { + continue + } + + validators0Key = k + + break + } + assert.NotEqual(t, types.Hash{}, validators0Key) + + maxValidatorsKey := types.BytesToHash(big.NewInt(6).Bytes()) + validatorsLengthKey := types.BytesToHash(big.NewInt(0).Bytes()) + + txn := newTestTransition(t) + // Existing contract account with partial recovery state: + // - capacity is set (slot 6 non-zero) + // - validator length is zero (slot 0 => uninitialized) + // - stale validators[0] slot is still populated from old state + err = txn.SetAccountDirectly(staking.AddrStakingContract, &chain.GenesisAccount{ + Code: oldState.Code, + Balance: big.NewInt(0), + Storage: map[types.Hash]types.Hash{ + maxValidatorsKey: oldState.Storage[maxValidatorsKey], + validatorsLengthKey: {}, + validators0Key: oldState.Storage[validators0Key], + }, + }) + assert.NoError(t, err) + + hooks := &hook.Hooks{} + fork := &IBFTFork{ + Deployment: &common.JSONNumber{Value: 10}, + MinValidatorCount: &common.JSONNumber{Value: params.MinValidatorCount}, + MaxValidatorCount: &common.JSONNumber{Value: params.MaxValidatorCount}, + ValidatorType: validators.ECDSAValidatorType, + Validators: newVals, + } + registerStakingContractDeploymentHooks(hooks, fork, 10) + + assert.NoError(t, hooks.PreCommitState(&types.Header{Number: 10}, txn)) + + assert.Equal( + t, + newState.Storage[validators0Key], + txn.Txn().GetState(staking.AddrStakingContract, validators0Key), + ) +} + +func Test_registerStakingContractDeploymentHooks_bootstrapsWhenEpochSizeSlotMissing(t *testing.T) { + t.Parallel() + + oldVals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1111")), + ) + newVals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x2222")), + ) + + params := stakingHelper.PredeployParams{ + MinValidatorCount: 1, + MaxValidatorCount: 10, + EpochSize: 10, + } + + oldState, err := stakingHelper.PredeployStakingSCBootstrap(oldVals, params) + assert.NoError(t, err) + + newState, err := stakingHelper.PredeployStakingSCBootstrap(newVals, params) + assert.NoError(t, err) + + var validators0Key types.Hash + for k, oldV := range oldState.Storage { + newV, ok := newState.Storage[k] + if !ok || oldV == newV || oldV == (types.Hash{}) || newV == (types.Hash{}) { + continue + } + validators0Key = k + break + } + assert.NotEqual(t, types.Hash{}, validators0Key) + + capKey := types.BytesToHash(big.NewInt(0).Bytes()) + lenKey := types.BytesToHash(big.NewInt(1).Bytes()) + epochKey := types.BytesToHash(big.NewInt(8).Bytes()) + + txn := newTestTransition(t) + err = txn.SetAccountDirectly(staking.AddrStakingContract, &chain.GenesisAccount{ + Code: oldState.Code, + Balance: big.NewInt(0), + Storage: map[types.Hash]types.Hash{ + capKey: oldState.Storage[capKey], + lenKey: oldState.Storage[lenKey], + epochKey: {}, // missing epoch size must trigger bootstrap rewrite + validators0Key: oldState.Storage[validators0Key], + }, + }) + assert.NoError(t, err) + + hooks := &hook.Hooks{} + fork := &IBFTFork{ + Deployment: &common.JSONNumber{Value: 10}, + MinValidatorCount: &common.JSONNumber{Value: params.MinValidatorCount}, + MaxValidatorCount: &common.JSONNumber{Value: params.MaxValidatorCount}, + ValidatorType: validators.ECDSAValidatorType, + Validators: newVals, + } + registerStakingContractDeploymentHooks(hooks, fork, 10) + + assert.NoError(t, hooks.PreCommitState(&types.Header{Number: 10}, txn)) + assert.Equal(t, newState.Storage[epochKey], txn.Txn().GetState(staking.AddrStakingContract, epochKey)) + assert.Equal(t, newState.Storage[validators0Key], txn.Txn().GetState(staking.AddrStakingContract, validators0Key)) +} + func (m *mockHeaderModifierStore) ModifyHeader(header *types.Header, addr types.Address) error { return m.ModifyHeaderFunc(header, addr) } @@ -216,14 +358,23 @@ func Test_registerTxInclusionGuardHooks(t *testing.T) { epochSize := uint64(10) hooks := &hook.Hooks{} - registerTxInclusionGuardHooks(hooks, epochSize) + key, err := crypto.GenerateECDSAKey() + assert.NoError(t, err) + keyManager := signer.NewECDSAKeyManagerFromKey(key) + headerSigner := signer.NewSigner(keyManager, keyManager) + + registerTxInclusionGuardHooks(hooks, epochSize, pos.DefaultUptimeConfig(), func(uint64) (signer.Signer, error) { + return headerSigner, nil + }, 1) assert.Nil(t, hooks.ModifyHeaderFunc) assert.Nil(t, hooks.VerifyHeaderFunc) assert.Nil(t, hooks.ProcessHeaderFunc) - assert.Nil(t, hooks.PreCommitStateFunc) + assert.NotNil(t, hooks.PreCommitStateFunc) assert.Nil(t, hooks.PostInsertBlockFunc) + assert.NoError(t, hooks.PreCommitStateFunc(&types.Header{Number: 1}, newTestTransition(t))) + var ( cases = map[uint64]bool{ 0: true, @@ -259,17 +410,127 @@ func Test_registerTxInclusionGuardHooks(t *testing.T) { blockWithTransactions.Header.Number = h blockWithoutTransactions.Header.Number = h + blockWithSystemTransaction := &types.Block{ + Header: &types.Header{Number: h}, + Transactions: []*types.Transaction{pos.EpochFinalizationSystemTx(h)}, + } if ok { assert.NoError(t, hooks.VerifyBlock(blockWithoutTransactions)) assert.NoError(t, hooks.VerifyBlock(blockWithTransactions)) } else { - assert.NoError(t, hooks.VerifyBlock(blockWithoutTransactions)) + assert.ErrorIs(t, ErrTxInLastEpochOfBlock, hooks.VerifyBlock(blockWithoutTransactions)) + assert.NoError(t, hooks.VerifyBlock(blockWithSystemTransaction)) assert.ErrorIs(t, ErrTxInLastEpochOfBlock, hooks.VerifyBlock(blockWithTransactions)) } } } +func Test_registerTxInclusionGuardHooks_PrePoAForkSafety(t *testing.T) { + t.Parallel() + + epochSize := uint64(10) + firstPoSFrom := uint64(100) + hooks := &hook.Hooks{} + + registerTxInclusionGuardHooks(hooks, epochSize, pos.DefaultUptimeConfig(), func(uint64) (signer.Signer, error) { + return nil, errors.New("signer must not be requested before PoS activation") + }, firstPoSFrom) + + boundary := epochSize + assert.True(t, hooks.ShouldWriteTransactions(boundary), "PoA boundary block production must still allow normal transactions") + assert.NoError(t, hooks.VerifyBlock(&types.Block{Header: &types.Header{Number: boundary}}), "empty PoA boundary block remains valid") + assert.NoError(t, hooks.VerifyBlock(&types.Block{ + Header: &types.Header{Number: boundary}, + Transactions: []*types.Transaction{{Nonce: 1}}, + }), "user transactions remain valid before PoS activation") + + txn := newTestTransition(t) + assert.NoError(t, hooks.PreCommitStateFunc(&types.Header{Number: boundary}, txn)) + assert.Empty(t, txn.Receipts(), "no epoch-finalization system receipt is produced before PoS activation") +} + +func Test_registerTxInclusionGuardHooks_RejectsMalformedEpochFinalizationSystemTx(t *testing.T) { + t.Parallel() + + epochSize := uint64(10) + hooks := &hook.Hooks{} + + registerTxInclusionGuardHooks(hooks, epochSize, pos.DefaultUptimeConfig(), func(uint64) (signer.Signer, error) { + return nil, nil + }, 1) + + boundary := epochSize + valid := pos.EpochFinalizationSystemTx(boundary) + assert.NoError(t, hooks.VerifyBlock(&types.Block{ + Header: &types.Header{Number: boundary}, + Transactions: []*types.Transaction{valid}, + })) + + cases := map[string]func(*types.Transaction){ + "wrong nonce": func(tx *types.Transaction) { tx.Nonce = boundary + 1 }, + "wrong hash": func(tx *types.Transaction) { tx.Hash[0] ^= 0x01 }, + "wrong from": func(tx *types.Transaction) { tx.From = types.ZeroAddress }, + "wrong input": func(tx *types.Transaction) { tx.Input = []byte("bad-input") }, + } + + for name, mutate := range cases { + t.Run(name, func(t *testing.T) { + tx := valid.Copy() + mutate(tx) + + assert.ErrorIs(t, ErrTxInLastEpochOfBlock, hooks.VerifyBlock(&types.Block{ + Header: &types.Header{Number: boundary}, + Transactions: []*types.Transaction{tx}, + })) + }) + } +} + +func Test_shouldSkipEpochFinalizationBeforePoS(t *testing.T) { + t.Parallel() + + tests := []struct { + name string + boundary uint64 + firstPoSFrom uint64 + skip bool + }{ + { + name: "skip when finalized epoch is fully pre-PoS at cutover boundary", + boundary: 50, + firstPoSFrom: 50, + skip: true, + }, + { + name: "do not skip direct PoS from genesis", + boundary: 50, + firstPoSFrom: 1, + skip: false, + }, + { + name: "do not skip when PoS starts mid-previous epoch", + boundary: 50, + firstPoSFrom: 45, + skip: false, + }, + { + name: "do not skip next boundary after cutover", + boundary: 100, + firstPoSFrom: 50, + skip: false, + }, + } + + for _, tt := range tests { + tt := tt + t.Run(tt.name, func(t *testing.T) { + t.Parallel() + assert.Equal(t, tt.skip, shouldSkipEpochFinalizationBeforePoS(tt.boundary, tt.firstPoSFrom)) + }) + } +} + func newTestTransition( t *testing.T, ) *state.Transition { @@ -311,9 +572,21 @@ func Test_registerStakingContractDeploymentHooks(t *testing.T) { Deployment: &common.JSONNumber{ Value: 10, }, + MinValidatorCount: &common.JSONNumber{Value: 1}, + MaxValidatorCount: &common.JSONNumber{Value: 10}, + ValidatorType: validators.ECDSAValidatorType, + Validators: validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1234")), + ), } - registerStakingContractDeploymentHooks(hooks, fork) + registerStakingContractDeploymentHooks(hooks, fork, 10) + + expectedState, err := stakingHelper.PredeployStakingSCBootstrap( + fork.Validators, + stakingHelper.PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 10, EpochSize: 10}, + ) + assert.NoError(t, err) assert.Nil(t, hooks.ShouldWriteTransactionFunc) assert.Nil(t, hooks.ModifyHeaderFunc) @@ -344,6 +617,7 @@ func Test_registerStakingContractDeploymentHooks(t *testing.T) { t, txn.AccountExists(staking.AddrStakingContract), ) + assert.Equal(t, expectedState.Code, txn.GetCode(staking.AddrStakingContract)) // should update only bytecode (if contract is deployed again, it returns error) assert.NoError( @@ -355,34 +629,72 @@ func Test_registerStakingContractDeploymentHooks(t *testing.T) { t, txn.AccountExists(staking.AddrStakingContract), ) + assert.Equal(t, expectedState.Code, txn.GetCode(staking.AddrStakingContract)) } func Test_getPreDeployParams(t *testing.T) { t.Parallel() tests := []struct { - name string - fork *IBFTFork - params stakingHelper.PredeployParams + name string + fork *IBFTFork + bootstrapValidatorCount uint64 + params stakingHelper.PredeployParams + wantErr bool }{ { - name: "should use the given heights", + name: "uses the given values", fork: &IBFTFork{ MinValidatorCount: &common.JSONNumber{Value: 10}, MaxValidatorCount: &common.JSONNumber{Value: 20}, }, + bootstrapValidatorCount: 10, params: stakingHelper.PredeployParams{ MinValidatorCount: 10, MaxValidatorCount: 20, + EpochSize: 10, }, }, { - name: "should use the default values", - fork: &IBFTFork{}, + name: "missing values default to bootstrap validator count", + fork: &IBFTFork{}, + bootstrapValidatorCount: 4, params: stakingHelper.PredeployParams{ - MinValidatorCount: stakingHelper.MinValidatorCount, - MaxValidatorCount: stakingHelper.MaxValidatorCount, + MinValidatorCount: 4, + MaxValidatorCount: 4, + EpochSize: 10, + }, + }, + { + name: "errors when bootstrap validator count is empty", + fork: &IBFTFork{}, + bootstrapValidatorCount: 0, + wantErr: true, + }, + { + name: "errors when min exceeds max", + fork: &IBFTFork{ + MinValidatorCount: &common.JSONNumber{Value: 5}, + MaxValidatorCount: &common.JSONNumber{Value: 4}, + }, + wantErr: true, + }, + { + name: "errors when max exceeds epoch snapshot max", + fork: &IBFTFork{ + MaxValidatorCount: &common.JSONNumber{Value: pos.MaxEpochValidatorsSnapshot + 1}, }, + bootstrapValidatorCount: 4, + wantErr: true, + }, + { + name: "errors when min exceeds bootstrap validator count", + fork: &IBFTFork{ + MinValidatorCount: &common.JSONNumber{Value: 5}, + MaxValidatorCount: &common.JSONNumber{Value: 10}, + }, + bootstrapValidatorCount: 4, + wantErr: true, }, } @@ -392,11 +704,71 @@ func Test_getPreDeployParams(t *testing.T) { t.Run(test.name, func(t *testing.T) { t.Parallel() - assert.Equal( - t, - test.params, - getPreDeployParams(test.fork), - ) + params, err := getPreDeployParams(test.fork, 10, test.bootstrapValidatorCount) + if test.wantErr { + assert.Error(t, err) + return + } + assert.NoError(t, err) + assert.Equal(t, test.params, params) }) } } + +func Test_registerStakingContractDeploymentHooks_UsesHeaderValidatorsWhenForkValidatorsEmpty(t *testing.T) { + t.Parallel() + + headerValidators := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1111")), + validators.NewECDSAValidator(types.StringToAddress("0x2222")), + ) + + hooks := &hook.Hooks{} + fork := &IBFTFork{ + Deployment: &common.JSONNumber{Value: 10}, + MinValidatorCount: &common.JSONNumber{Value: 1}, + MaxValidatorCount: &common.JSONNumber{Value: 4}, + ValidatorType: validators.ECDSAValidatorType, + Validators: validators.NewECDSAValidatorSet(), + } + + registerStakingContractDeploymentHooks(hooks, fork, 10) + + txn := newTestTransition(t) + err := hooks.PreCommitState(newHeaderWithECDSAValidators(10, headerValidators), txn) + assert.NoError(t, err) + assert.True(t, txn.AccountExists(staking.AddrStakingContract)) +} + +func Test_registerStakingContractDeploymentHooks_RejectsEmptyHeaderBootstrapValidators(t *testing.T) { + t.Parallel() + + hooks := &hook.Hooks{} + fork := &IBFTFork{ + Deployment: &common.JSONNumber{Value: 10}, + MinValidatorCount: &common.JSONNumber{Value: 1}, + MaxValidatorCount: &common.JSONNumber{Value: 4}, + ValidatorType: validators.ECDSAValidatorType, + Validators: validators.NewECDSAValidatorSet(), + } + + registerStakingContractDeploymentHooks(hooks, fork, 10) + + err := hooks.PreCommitState(newHeaderWithECDSAValidators(10, validators.NewECDSAValidatorSet()), newTestTransition(t)) + assert.Error(t, err) + assert.Contains(t, err.Error(), "fallback failed") + assert.Contains(t, err.Error(), "decoded validator set is empty") +} + +func newHeaderWithECDSAValidators(number uint64, vals validators.Validators) *types.Header { + extra := &signer.IstanbulExtra{ + Validators: vals, + CommittedSeals: &signer.SerializedSeal{}, + ParentCommittedSeals: &signer.SerializedSeal{}, + } + + return &types.Header{ + Number: number, + ExtraData: extra.MarshalRLPTo(make([]byte, signer.IstanbulExtraVanity)), + } +} diff --git a/consensus/ibft/fork/manager.go b/consensus/ibft/fork/manager.go index 18d61e8..775fd81 100644 --- a/consensus/ibft/fork/manager.go +++ b/consensus/ibft/fork/manager.go @@ -5,6 +5,7 @@ import ( "github.com/hashicorp/go-hclog" "github.com/xgr-network/xgr-node/consensus/ibft/hook" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" "github.com/xgr-network/xgr-node/consensus/ibft/signer" "github.com/xgr-network/xgr-node/secrets" "github.com/xgr-network/xgr-node/state" @@ -66,6 +67,7 @@ type ForkManager struct { forks IBFTForks filePath string epochSize uint64 + uptimeCfg pos.UptimeConfig // submodule lookup keyManagers map[validators.ValidatorType]signer.KeyManager @@ -95,6 +97,7 @@ func NewForkManager( secretsManager: secretManager, filePath: filePath, epochSize: epochSize, + uptimeCfg: pos.ParseUptimeConfig(ibftConfig), forks: forks, keyManagers: make(map[validators.ValidatorType]signer.KeyManager), validatorStores: make(map[store.SourceType]ValidatorStore), @@ -198,6 +201,12 @@ func (m *ForkManager) GetHooks(height uint64) HooksInterface { return hooks } +// IsPosActive returns whether the IBFT mode at the given height is PoS. +func (m *ForkManager) IsPosActive(height uint64) bool { + f := m.forks.getFork(height) + return f != nil && f.Type == PoS +} + func (m *ForkManager) getValidatorStoreByIBFTFork(fork *IBFTFork) ValidatorStore { set, ok := m.validatorStores[ibftTypesToSourceType[fork.Type]] if !ok { @@ -321,6 +330,8 @@ func (m *ForkManager) initializeHooksRegister(ibftType IBFTType) { m.hooksRegisters[PoS] = NewPoSHookRegister( m.forks, m.epochSize, + m.uptimeCfg, + m.GetSigner, ) } } diff --git a/consensus/ibft/fork/storewrapper.go b/consensus/ibft/fork/storewrapper.go index 80fabec..8ad4671 100644 --- a/consensus/ibft/fork/storewrapper.go +++ b/consensus/ibft/fork/storewrapper.go @@ -4,6 +4,7 @@ import ( "encoding/json" "errors" "path/filepath" + "strings" "github.com/hashicorp/go-hclog" "github.com/xgr-network/xgr-node/consensus/ibft/signer" @@ -52,6 +53,10 @@ func (w *SnapshotValidatorStoreWrapper) Close() error { // GetValidators returns validators at the specific height func (w *SnapshotValidatorStoreWrapper) GetValidators(height, _, _ uint64) (validators.Validators, error) { + if height == 0 { + return nil, errors.New("height must be greater than 0") + } + // the biggest height of blocks that have been processed before the given height return w.GetValidatorsByHeight(height - 1) } @@ -117,7 +122,8 @@ func NewSnapshotValidatorStoreWrapper( // in order to add Close and GetValidators type ContractValidatorStoreWrapper struct { *contract.ContractValidatorStore - getSigner func(uint64) (signer.Signer, error) + blockchain store.HeaderGetter + getSigner func(uint64) (signer.Signer, error) } // NewContractValidatorStoreWrapper creates *ContractValidatorStoreWrapper @@ -140,6 +146,7 @@ func NewContractValidatorStoreWrapper( return &ContractValidatorStoreWrapper{ ContractValidatorStore: contractStore, + blockchain: blockchain, getSigner: getSigner, }, nil } @@ -151,44 +158,131 @@ func (w *ContractValidatorStoreWrapper) Close() error { // GetValidators gets and returns validators at the given height func (w *ContractValidatorStoreWrapper) GetValidators( - height, epochSize, forkFrom uint64, + height, + epochSize, + forkFrom uint64, ) (validators.Validators, error) { signer, err := w.getSigner(height) if err != nil { return nil, err } - return w.GetValidatorsByHeight( + if epochSize < 2 { + return nil, errors.New("epochSize must be greater than or equal to 2") + } + + fetchingHeight := calculateContractStoreFetchingHeight( + height, + epochSize, + forkFrom, + ) + + // Before PoS fork, contract store must not be used as validator source. + if height < forkFrom { + headerHeight := uint64(0) + if height > 0 { + headerHeight = height - 1 + } + + headerSigner, signErr := w.getSigner(headerHeight) + if signErr != nil { + return nil, signErr + } + + header, ok := w.blockchain.GetHeaderByNumber(headerHeight) + if !ok { + return nil, errors.New("failed to load pre-fork header validators") + } + + return headerSigner.GetValidators(header) + } + + vals, err := w.GetValidatorsByHeight( signer.Type(), - calculateContractStoreFetchingHeight( - height, - epochSize, - forkFrom, - ), + fetchingHeight, ) + if err == nil && vals != nil && vals.Len() > 0 { + return vals, nil + } + + // Before / at PoS fork boundary we may need to use pre-fork header validator set. + // Reason: the staking contract is deployed at the PoS deployment block, but the block itself + // must still be validated using the PoS fork boundary validator source. + if height <= forkFrom { + if err != nil && !strings.Contains(err.Error(), "empty input") { + return nil, err + } + + headerSigner, signErr := w.getSigner(fetchingHeight) + if signErr != nil { + if err != nil { + return nil, err + } + + return nil, signErr + } + + header, ok := w.blockchain.GetHeaderByNumber(fetchingHeight) + if !ok { + if err != nil { + return nil, err + } + return nil, errors.New("failed to load pre-fork header validators") + } + + fromHeader, hdrErr := headerSigner.GetValidators(header) + if hdrErr != nil { + if err != nil { + return nil, err + } + return nil, hdrErr + } + + return fromHeader, nil + } + + // After PoS fork, staking contract is the source of truth. + if err != nil { + return nil, err + } + + return nil, errors.New("staking contract returned empty validator set") } // calculateContractStoreFetchingHeight calculates the block height at which ContractStore fetches validators // based on height, epoch, and fork beginning height -func calculateContractStoreFetchingHeight(height, epochSize, forkFrom uint64) uint64 { - // calculates the beginning of the epoch the given height is in - beginningEpoch := (height / epochSize) * epochSize - - // calculates the end of the previous epoch - // to determine the height to fetch validators - fetchingHeight := uint64(0) - if beginningEpoch > 0 { - fetchingHeight = beginningEpoch - 1 +func calculateContractStoreFetchingHeight( + height uint64, + epochSize uint64, + forkFrom uint64, +) uint64 { + var fetchingHeight uint64 + + if height == 0 { + fetchingHeight = 0 + } else if height%epochSize == 0 { + // Epoch boundary block itself is finalized with the previous epoch context. + fetchingHeight = height - 1 + } else { + // Non-boundary blocks should read validator data at the epoch boundary block, + // because finalize hooks on that boundary can affect the effective next-epoch set. + fetchingHeight = (height / epochSize) * epochSize } - // use the calculated height if it's bigger than or equal to from - if fetchingHeight >= forkFrom { - return fetchingHeight + // For all heights up to and including the PoS forkFrom block, keep legacy behavior + // (contract fetch height pinned to the last PoA block) so the PoS deployment block can + // still be validated with the PoA validator set. + if height <= forkFrom { + if forkFrom == 0 { + return 0 + } + return forkFrom - 1 } - if forkFrom > 0 { - return forkFrom - 1 + // After the PoS fork, never fetch from a pre-fork height. + if fetchingHeight < forkFrom { + return forkFrom } - return forkFrom + return fetchingHeight } diff --git a/consensus/ibft/fork/storewrapper_test.go b/consensus/ibft/fork/storewrapper_test.go index 91d79dc..d468438 100644 --- a/consensus/ibft/fork/storewrapper_test.go +++ b/consensus/ibft/fork/storewrapper_test.go @@ -305,7 +305,7 @@ func TestSnapshotValidatorStoreWrapperGetValidators(t *testing.T) { } ) - store, err := snapshot.NewSnapshotValidatorStore( + snapshotStore, err := snapshot.NewSnapshotValidatorStore( hclog.NewNullLogger(), &store.MockBlockchain{ HeaderFn: func() *types.Header { @@ -323,12 +323,20 @@ func TestSnapshotValidatorStoreWrapperGetValidators(t *testing.T) { assert.NoError(t, err) wrapper := SnapshotValidatorStoreWrapper{ - SnapshotValidatorStore: store, + SnapshotValidatorStore: snapshotStore, } vals, err := wrapper.GetValidators(11, 0, 0) assert.NoError(t, err) assert.Equal(t, snapshots[0].Set, vals) + + t.Run("should return error for genesis height", func(t *testing.T) { + t.Parallel() + + genesisVals, err := wrapper.GetValidators(0, 0, 0) + assert.Nil(t, genesisVals) + assert.EqualError(t, err, "height must be greater than 0") + }) } func TestSnapshotValidatorStoreWrapperClose(t *testing.T) { @@ -480,6 +488,92 @@ func TestNewContractValidatorStoreWrapperGetValidators(t *testing.T) { assert.Nil(t, res) assert.ErrorContains(t, err, "header not found at 9") }) + + t.Run("should not use contract store before forkFrom", func(t *testing.T) { + t.Parallel() + + var beginTxnCalls int + + expected := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("1")), + ) + + wrapper, err := NewContractValidatorStoreWrapper( + hclog.NewNullLogger(), + &store.MockBlockchain{ + GetHeaderByNumberFn: func(u uint64) (*types.Header, bool) { + if u == 9 { + return &types.Header{Number: 9}, true + } + + return nil, false + }, + }, + &MockExecutor{ + BeginTxnFunc: func(types.Hash, *types.Header, types.Address) (*state.Transition, error) { + beginTxnCalls++ + + return nil, errTest + }, + }, + func(u uint64) (signer.Signer, error) { + return &mockSigner{ + TypeFn: func() validators.ValidatorType { + return validators.ECDSAValidatorType + }, + GetValidatorsFn: func(*types.Header) (validators.Validators, error) { + return expected, nil + }, + }, nil + }, + ) + + assert.NoError(t, err) + + res, err := wrapper.GetValidators(10, 10, 50) + assert.NoError(t, err) + assert.Equal(t, expected, res) + assert.Zero(t, beginTxnCalls) + }) + + t.Run("should use contract store at fork boundary", func(t *testing.T) { + t.Parallel() + + var beginTxnCalls int + + wrapper, err := NewContractValidatorStoreWrapper( + hclog.NewNullLogger(), + &store.MockBlockchain{ + GetHeaderByNumberFn: func(u uint64) (*types.Header, bool) { + if u == 49 { + return &types.Header{Number: 49}, true + } + + return nil, false + }, + }, + &MockExecutor{ + BeginTxnFunc: func(types.Hash, *types.Header, types.Address) (*state.Transition, error) { + beginTxnCalls++ + + return nil, errTest + }, + }, + func(u uint64) (signer.Signer, error) { + return signer.NewSigner( + &signer.ECDSAKeyManager{}, + nil, + ), nil + }, + ) + + assert.NoError(t, err) + + res, err := wrapper.GetValidators(50, 10, 50) + assert.Nil(t, res) + assert.ErrorIs(t, err, errTest) + assert.Equal(t, 1, beginTxnCalls) + }) } func Test_calculateContractStoreFetchingHeight(t *testing.T) { @@ -514,11 +608,11 @@ func Test_calculateContractStoreFetchingHeight(t *testing.T) { expected: 9, }, { - name: "should return 9 if the height is 19 (in the second epoch)", + name: "should return 10 if the height is 19 (in the second epoch)", height: 19, epochSize: 10, forkFrom: 0, - expected: 9, + expected: 10, }, { name: "should return 49 if the height is 10 but forkFrom is 50", @@ -534,6 +628,13 @@ func Test_calculateContractStoreFetchingHeight(t *testing.T) { forkFrom: 50, expected: 59, }, + { + name: "should return 60 if the height is 61 and forkFrom is 50", + height: 61, + epochSize: 10, + forkFrom: 50, + expected: 60, + }, } for _, test := range tests { diff --git a/consensus/ibft/ibft.go b/consensus/ibft/ibft.go index 0f055f7..f582420 100644 --- a/consensus/ibft/ibft.go +++ b/consensus/ibft/ibft.go @@ -3,15 +3,22 @@ package ibft import ( "errors" "fmt" + "math/big" + "sort" + "strconv" "time" + ibftProtoMessages "github.com/0xPolygon/go-ibft/messages/proto" "github.com/armon/go-metrics" "github.com/hashicorp/go-hclog" "github.com/xgr-network/xgr-node/blockchain" + "github.com/xgr-network/xgr-node/chain" "github.com/xgr-network/xgr-node/consensus" "github.com/xgr-network/xgr-node/consensus/ibft/fork" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" "github.com/xgr-network/xgr-node/consensus/ibft/proto" "github.com/xgr-network/xgr-node/consensus/ibft/signer" + xcrypto "github.com/xgr-network/xgr-node/crypto" "github.com/xgr-network/xgr-node/helper/progress" "github.com/xgr-network/xgr-node/network" "github.com/xgr-network/xgr-node/secrets" @@ -41,6 +48,13 @@ var ( ErrWrongDifficulty = errors.New("wrong difficulty") ) +type effectivePowerSnapshot struct { + hash types.Hash + powers map[string]string + totalVotingPower string + quorumThreshold string +} + type txPoolInterface interface { Prepare() Length() uint64 @@ -59,6 +73,7 @@ type forkManagerInterface interface { GetValidatorStore(uint64) (fork.ValidatorStore, error) GetValidators(uint64) (validators.Validators, error) GetHooks(uint64) fork.HooksInterface + IsPosActive(uint64) bool } // backendIBFT represents the IBFT consensus mechanism object @@ -88,6 +103,7 @@ type backendIBFT struct { epochSize uint64 quorumSizeBlockNum uint64 blockTime time.Duration // Minimum block generation time in seconds + uptimeCfg pos.UptimeConfig // Channels closeCh chan struct{} // Channel for closing @@ -95,11 +111,17 @@ type backendIBFT struct { // Factory implements the base consensus Factory method func Factory(params *consensus.Params) (consensus.Consensus, error) { + if err := alignFeePoolSplitWithPoSFork(params.Config.Params, params.Config.Config); err != nil { + return nil, err + } + // defaults for user set fields in genesis var ( epochSize = uint64(DefaultEpochSize) quorumSizeBlockNum = uint64(0) + uptimeCfg = pos.ParseUptimeConfig(params.Config.Config) ) + uptimeCfg.ChainID = params.Config.Params.ChainID if definedEpochSize, ok := params.Config.Config[KeyEpochSize]; ok { // Epoch size is defined, use the passed in one @@ -110,6 +132,12 @@ func Factory(params *consensus.Params) (consensus.Consensus, error) { epochSize = uint64(readSize) } + if err := validateEpochSize(epochSize); err != nil { + return nil, err + } + if err := validateUptimeConfig(uptimeCfg); err != nil { + return nil, err + } if rawBlockNum, ok := params.Config.Config["quorumSizeBlockNum"]; ok { // Block number specified for quorum size switch @@ -159,17 +187,68 @@ func Factory(params *consensus.Params) (consensus.Consensus, error) { epochSize: epochSize, quorumSizeBlockNum: quorumSizeBlockNum, blockTime: time.Duration(params.BlockTime) * time.Second, + uptimeCfg: uptimeCfg, // Channels closeCh: make(chan struct{}), } - // Istanbul requires a different header hash function p.SetHeaderHash() return p, nil } +// alignFeePoolSplitWithPoSFork ensures FeePoolSplit activates exactly when the first PoS IBFT fork starts. +// This removes double-gating at genesis level (PoS-from + feePoolSplit block). +func alignFeePoolSplitWithPoSFork(chainParams *chain.Params, ibftConfig map[string]interface{}) error { + if chainParams == nil { + return nil + } + if ibftConfig == nil { + return nil + } + + ibftForks, err := fork.GetIBFTForks(ibftConfig) + if err != nil { + return err + } + + firstPoSFrom := uint64(0) + foundPoS := false + + for _, ibftFork := range ibftForks { + if ibftFork.Type != fork.PoS { + continue + } + + if !foundPoS || ibftFork.From.Value < firstPoSFrom { + firstPoSFrom = ibftFork.From.Value + foundPoS = true + } + } + + if !foundPoS { + return nil + } + + if chainParams.Forks == nil { + forks := make(chain.Forks) + chainParams.Forks = &forks + } + + if feePoolSplitFork, exists := (*chainParams.Forks)[chain.FeePoolSplit]; exists { + if feePoolSplitFork.Block != firstPoSFrom { + return fmt.Errorf("feePoolSplit fork must match first PoS fork: feePoolSplit=%d firstPoSFrom=%d", feePoolSplitFork.Block, firstPoSFrom) + } + + return nil + } + + chainParams.Forks.SetFork(chain.FeePoolSplit, chain.NewFork(firstPoSFrom)) + + return nil +} + func (i *backendIBFT) Initialize() error { // register the grpc operator if i.Grpc != nil { @@ -208,12 +287,15 @@ func (i *backendIBFT) Initialize() error { // sync runs the syncer in the background to receive blocks from advanced peers func (i *backendIBFT) startSyncing() { callInsertBlockHook := func(fullBlock *types.FullBlock) bool { - if err := i.currentHooks.PostInsertBlock(fullBlock.Block); err != nil { + hooks := i.forkManager.GetHooks(fullBlock.Block.Number()) + + if err := hooks.PostInsertBlock(fullBlock.Block); err != nil { i.logger.Error("failed to call PostInsertBlock", "height", fullBlock.Block.Header.Number, "error", err) } if err := i.updateCurrentModules(fullBlock.Block.Number() + 1); err != nil { i.logger.Error("failed to update sub modules", "height", fullBlock.Block.Number()+1, "err", err) + i.txpool.SetSealing(false) } i.txpool.ResetWithHeaders(fullBlock.Block.Header) @@ -293,6 +375,22 @@ func (i *backendIBFT) startConsensus() { "height", pending, "err", err, ) + + i.txpool.SetSealing(false) + + retryTimer := time.NewTimer(i.blockTime) + + select { + case <-syncerBlockCh: + retryTimer.Stop() + goto nextHeight + case <-retryTimer.C: + goto nextHeight + case <-i.closeCh: + retryTimer.Stop() + + return + } } // Update the No.of validator metric @@ -301,25 +399,31 @@ func (i *backendIBFT) startConsensus() { isValidator = i.isActiveValidator() i.txpool.SetSealing(isValidator) + sequenceCh = make(<-chan struct{}) if isValidator { sequenceCh = i.consensus.runSequence(pending) } - select { - case <-syncerBlockCh: - if isValidator { - i.consensus.stopSequence() - i.logger.Info("canceled sequence", "sequence", pending) - } - case <-sequenceCh: - case <-i.closeCh: - if isValidator { - i.consensus.stopSequence() - } + for { + select { + case <-syncerBlockCh: + if isValidator { + i.consensus.stopSequence() + i.logger.Info("canceled sequence", "sequence", pending) + } + goto nextHeight + case <-sequenceCh: + goto nextHeight + case <-i.closeCh: + if isValidator { + i.consensus.stopSequence() + } - return + return + } } + nextHeight: } } @@ -328,6 +432,18 @@ func (i *backendIBFT) isActiveValidator() bool { return i.currentValidators.Includes(i.currentSigner.Address()) } +// RoundStarts notifies the backend that IBFT is about to start a new round. +func (i *backendIBFT) RoundStarts(view *ibftProtoMessages.View) error { + _ = i + _ = view + return nil +} + +// SequenceCancelled notifies the backend that the active sequence was cancelled. +func (i *backendIBFT) SequenceCancelled(*ibftProtoMessages.View) error { + return nil +} + // updateMetrics will update various metrics based on the given block // currently we capture No.of Txs and block interval metrics using this function func (i *backendIBFT) updateMetrics(block *types.Block) { @@ -374,7 +490,6 @@ func (i *backendIBFT) verifyHeaderImpl( if _, err := headerSigner.GetIBFTExtra(header); err != nil { return err } - // verify the ProposerSeal if err := verifyProposerSeal( header, @@ -391,7 +506,6 @@ func (i *backendIBFT) verifyHeaderImpl( ); err != nil { return err } - // Additional header verification if err := hooks.VerifyHeader(header); err != nil { return err @@ -402,10 +516,18 @@ func (i *backendIBFT) verifyHeaderImpl( // VerifyHeader wrapper for verifying headers func (i *backendIBFT) VerifyHeader(header *types.Header) error { - parent, ok := i.blockchain.GetHeaderByNumber(header.Number - 1) + parent, ok := i.blockchain.GetHeaderByHash(header.ParentHash) if !ok { return fmt.Errorf( - "unable to get parent header for block number %d", + "unable to get parent header %s for block number %d", + header.ParentHash, + header.Number, + ) + } + if parent.Number+1 != header.Number { + return fmt.Errorf( + "invalid parent header number %d for block number %d", + parent.Number, header.Number, ) } @@ -436,7 +558,6 @@ func (i *backendIBFT) VerifyHeader(header *types.Header) error { } hashForCommittedSeal, err := i.calculateProposalHash( - headerSigner, header, extra.RoundNumber, ) @@ -446,15 +567,27 @@ func (i *backendIBFT) VerifyHeader(header *types.Header) error { // verify the Committed Seals // CommittedSeals exists only in the finalized header + committedSealQuorum := i.quorumSize(header.Number)(validators) + if i.forkManager.IsPosActive(header.Number) { + // In PoS weighted mode, signer-level verification is used only for + // structural/cryptographic validation. Weighted voting power check below + // is the sole quorum acceptance rule. + committedSealQuorum = 0 + } + if err := headerSigner.VerifyCommittedSeals( hashForCommittedSeal, extra.CommittedSeals, validators, - i.quorumSize(header.Number)(validators), + committedSealQuorum, ); err != nil { return err } + if err := i.verifyWeightedCommittedPower(header.Number, hashForCommittedSeal, extra.CommittedSeals, validators, header, parent, extra.RoundNumber); err != nil { + return err + } + return nil } @@ -494,9 +627,49 @@ func (i *backendIBFT) GetBlockCreator(header *types.Header) (types.Address, erro // PreCommitState a hook to be called before finalizing state transition on inserting block func (i *backendIBFT) PreCommitState(block *types.Block, txn *state.Transition) error { - hooks := i.forkManager.GetHooks(block.Number()) + if block == nil || block.Header == nil { + return fmt.Errorf("missing block header in PreCommitState") + } + // Deterministic uptime accounting MUST use the parent header (already sealed/final). + // Counting on the current header breaks determinism during buildBlock because proposer seal/hash + // may not be present yet. + parentHeader, ok := i.blockchain.GetHeaderByHash(block.Header.ParentHash) + if !ok { + return fmt.Errorf("parent header %s not found for block %d", block.Header.ParentHash, block.Number()) + } + + parentPosActive := i.forkManager.IsPosActive(parentHeader.Number) + requiresValidators := parentPosActive + var parentValidators validators.Validators + if requiresValidators { + vLoaded, vErr := i.forkManager.GetValidators(parentHeader.Number) + if vErr != nil { + if parentPosActive { + return fmt.Errorf("failed to get validators for uptime at height %d: %w", parentHeader.Number, vErr) + } - return hooks.PreCommitState(block.Header, txn) + return fmt.Errorf("failed to get validators at height %d: %w", parentHeader.Number, vErr) + } + parentValidators = vLoaded + } + + if parentPosActive { + parentSigner, err := i.forkManager.GetSigner(parentHeader.Number) + if err != nil { + return fmt.Errorf("failed to get signer for uptime at height %d: %w", parentHeader.Number, err) + } + if parentSigner == nil { + return fmt.Errorf("missing signer for uptime at height %d", parentHeader.Number) + } + if err := pos.RecordBlockUptime(parentHeader, i.epochSize, parentValidators, parentSigner, i.uptimeCfg, txn); err != nil { + return fmt.Errorf("failed to record parent uptime for block %d: %w", block.Number(), err) + } + } + hooks := i.forkManager.GetHooks(block.Number()) + if err := hooks.PreCommitState(block.Header, txn); err != nil { + return err + } + return nil } // GetEpoch returns the current epoch @@ -534,7 +707,7 @@ func (i *backendIBFT) Close() error { // SetHeaderHash updates hash calculation function for IBFT func (i *backendIBFT) SetHeaderHash() { - types.HeaderHash = func(h *types.Header) types.Hash { + types.SetHeaderHash(func(h *types.Header) types.Hash { signer, err := i.forkManager.GetSigner(h.Number) if err != nil { return types.ZeroHash @@ -546,7 +719,7 @@ func (i *backendIBFT) SetHeaderHash() { } return hash - } + }) } // GetBridgeProvider returns an instance of BridgeDataProvider @@ -615,7 +788,6 @@ func (i *backendIBFT) verifyParentCommittedSeals( } parentHash, err := i.calculateProposalHash( - parentSigner, parentHeader, parentExtra.RoundNumber, ) @@ -625,15 +797,260 @@ func (i *backendIBFT) verifyParentCommittedSeals( // if shouldVerifyParentCommittedSeals is false, skip the verification // when header doesn't have Parent Committed Seals (Backward Compatibility) - return parentSigner.VerifyParentCommittedSeals( + parentCommittedSealQuorum := i.quorumSize(parent.Number)(parentValidators) + if i.forkManager.IsPosActive(parent.Number) { + // In PoS weighted mode, signer-level verification remains a + // structural/cryptographic guard only. Weighted parent committed power + // verification below is the sole quorum acceptance rule. + parentCommittedSealQuorum = 0 + } + + if err := parentSigner.VerifyParentCommittedSeals( parentHash, header, parentValidators, - i.quorumSize(parent.Number)(parentValidators), + parentCommittedSealQuorum, shouldVerifyParentCommittedSeals, + ); err != nil { + return err + } + + if !i.forkManager.IsPosActive(parent.Number) { + return nil + } + + parentCommittedSealsGetter, ok := parentSigner.(interface { + GetParentCommittedSeals(*types.Header) (signer.Seals, error) + }) + if !ok { + return errors.New("parent signer does not support extracting parent committed seals") + } + + parentCommittedSeals, err := parentCommittedSealsGetter.GetParentCommittedSeals(header) + if err != nil { + return err + } + if parentCommittedSeals == nil || parentCommittedSeals.Num() == 0 { + return fmt.Errorf("missing parent committed seals in PoS weighted mode at height %d", parent.Number) + } + + parentParentHeader, ok := i.blockchain.GetHeaderByHash(parentHeader.ParentHash) + if !ok { + return fmt.Errorf("header %s not found", parentHeader.ParentHash) + } + + // ParentCommittedSeals stored in child header are signatures for the parent proposal. + // Verify weighted quorum in the same consensus context: + // state at parent height + evidence transition from grandparent -> parent. + return i.verifyWeightedCommittedPower( + parent.Number, + parentHash, + parentCommittedSeals, + parentValidators, + parentHeader, + parentParentHeader, + parentExtra.RoundNumber, ) } +func validateUptimeConfig(cfg pos.UptimeConfig) error { + if cfg.MicroEpochSize == 0 { + return nil + } + + if cfg.MicroEpochNominalWeight == 0 { + return errors.New("microEpochNominalWeightUnits must be greater than 0 when microEpochSize is enabled") + } + if cfg.MicroEpochInactivityDecayBps == 0 { + return errors.New("microEpochInactivityDecayBps must be greater than 0 when microEpochSize is enabled") + } + if cfg.MicroEpochInactivityDecayBps > 10000 { + return errors.New("microEpochInactivityDecayBps must be less than or equal to 10000") + } + + return nil +} + +func validateEpochSize(epochSize uint64) error { + if epochSize < 2 { + return errors.New("epochSize must be greater than or equal to 2") + } + + return nil +} + +func (i *backendIBFT) verifyWeightedCommittedPower( + height uint64, + hash types.Hash, + committedSeals signer.Seals, + validatorSet validators.Validators, + proposalHeader *types.Header, + parentHeader *types.Header, + roundNumber *uint64, +) error { + if !i.forkManager.IsPosActive(height) { + return nil + } + + votingPowers, err := i.getVotingPowersWithProposal(height, validatorSet, proposalHeader, parentHeader, roundNumber) + if err != nil { + return err + } + + signers, err := committedSealSigners(hash, committedSeals, validatorSet) + if err != nil { + return err + } + + collected := new(big.Int) + total := new(big.Int) + powerByValidator := make(map[string]string, validatorSet.Len()) + for idx := 0; idx < validatorSet.Len(); idx++ { + addr := validatorSet.At(uint64(idx)).Addr() + p, ok := votingPowers[types.AddressToString(addr)] + if !ok { + p = big.NewInt(0) + } + total.Add(total, p) + powerByValidator[addr.String()] = p.String() + if _, ok := signers[addr]; ok { + collected.Add(collected, p) + } + } + + if !hasWeightedQuorum(collected, total) { + signerAddrs := make([]string, 0, len(signers)) + for addr := range signers { + signerAddrs = append(signerAddrs, addr.String()) + } + sort.Strings(signerAddrs) + quorumThreshold := weightedQuorumThreshold(total) + proposalNumber := uint64(0) + proposalHash := types.ZeroHash.String() + proposalTimestamp := uint64(0) + if proposalHeader != nil { + proposalNumber = proposalHeader.Number + proposalHash = proposalHeader.Hash.String() + proposalTimestamp = proposalHeader.Timestamp + } + parentNumber := uint64(0) + parentHash := types.ZeroHash.String() + parentTimestamp := uint64(0) + if parentHeader != nil { + parentNumber = parentHeader.Number + parentHash = parentHeader.Hash.String() + parentTimestamp = parentHeader.Timestamp + } + roundDisplay := "nil" + if roundNumber != nil { + roundDisplay = strconv.FormatUint(*roundNumber, 10) + } + committedSealsCount := 0 + if committedSeals != nil { + committedSealsCount = committedSeals.Num() + } + + return fmt.Errorf( + "not enough weighted committed power: height=%d round=%s committedSeals=%d collected=%s quorum=%s total=%s proposalNumber=%d proposalHash=%s proposalTimestamp=%d parentNumber=%d parentHash=%s parentTimestamp=%d signerAddresses=%v votingPowers=%v: %w", + height, + roundDisplay, + committedSealsCount, + collected.String(), + quorumThreshold.String(), + total.String(), + proposalNumber, + proposalHash, + proposalTimestamp, + parentNumber, + parentHash, + parentTimestamp, + signerAddrs, + powerByValidator, + signer.ErrNotEnoughCommittedSeals, + ) + } + + return nil +} + +func weightedQuorumThreshold(total *big.Int) *big.Int { + if total == nil || total.Sign() <= 0 { + return big.NewInt(0) + } + + // Equivalent to ceil((2*total)/3), integer-safe. + // Keep this aligned with the classic PoA quorum behavior for equal weights. + quorum := new(big.Int).Mul(total, big.NewInt(2)) + quorum.Add(quorum, big.NewInt(2)) + quorum.Div(quorum, big.NewInt(3)) + + return quorum +} + +func hasWeightedQuorum(collected, total *big.Int) bool { + if total == nil || total.Sign() <= 0 { + return false + } + if collected == nil || collected.Sign() <= 0 { + return false + } + + return collected.Cmp(weightedQuorumThreshold(total)) >= 0 +} + +func (i *backendIBFT) getVotingPowersWithProposal( + height uint64, + validatorSet validators.Validators, + proposalHeader *types.Header, + parentHeader *types.Header, + _ *uint64, +) (map[string]*big.Int, error) { + _ = proposalHeader + result, _, err := i.effectiveVotingPowerSnapshot(height, validatorSet, parentHeader) + return result, err +} + +func committedSealSigners( + hash types.Hash, + committedSeals signer.Seals, + validatorSet validators.Validators, +) (map[types.Address]struct{}, error) { + out := map[types.Address]struct{}{} + if committedSeals == nil { + return out, nil + } + + switch seals := committedSeals.(type) { + case *signer.AggregatedSeal: + if seals.Bitmap == nil { + return out, nil + } + for idx := 0; idx < validatorSet.Len(); idx++ { + if seals.Bitmap.Bit(idx) == 0 { + continue + } + out[validatorSet.At(uint64(idx)).Addr()] = struct{}{} + } + return out, nil + case *signer.SerializedSeal: + digest := signer.LegacyCommitDigest(hash.Bytes()) + for _, raw := range *seals { + pub, err := xcrypto.RecoverPubkey(raw, digest) + if err != nil { + return nil, err + } + addr := xcrypto.PubKeyToAddress(pub) + if !validatorSet.Includes(addr) { + return nil, signer.ErrNonValidatorCommittedSeal + } + out[addr] = struct{}{} + } + return out, nil + default: + return nil, signer.ErrInvalidCommittedSealType + } +} + // getModulesFromForkManager is a helper function to get all modules from ForkManager func getModulesFromForkManager(forkManager forkManagerInterface, height uint64) ( signer.Signer, diff --git a/consensus/ibft/ibft_config_validation_test.go b/consensus/ibft/ibft_config_validation_test.go new file mode 100644 index 0000000..c3ce1fc --- /dev/null +++ b/consensus/ibft/ibft_config_validation_test.go @@ -0,0 +1,35 @@ +package ibft + +import ( + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" +) + +func TestValidateUptimeConfig(t *testing.T) { + t.Run("disabled micro epoch is valid", func(t *testing.T) { + require.NoError(t, validateUptimeConfig(pos.UptimeConfig{MicroEpochSize: 0})) + }) + + t.Run("enabled micro epoch requires nominal weight", func(t *testing.T) { + err := validateUptimeConfig(pos.UptimeConfig{MicroEpochSize: 8, MicroEpochInactivityDecayBps: 9000, MicroEpochNominalWeight: 0}) + require.Error(t, err) + }) + + t.Run("enabled micro epoch requires decay bps", func(t *testing.T) { + err := validateUptimeConfig(pos.UptimeConfig{MicroEpochSize: 8, MicroEpochInactivityDecayBps: 0, MicroEpochNominalWeight: 10000}) + require.Error(t, err) + }) + + t.Run("enabled micro epoch rejects decay over 10000", func(t *testing.T) { + err := validateUptimeConfig(pos.UptimeConfig{MicroEpochSize: 8, MicroEpochInactivityDecayBps: 10001, MicroEpochNominalWeight: 10000}) + require.Error(t, err) + }) +} + +func TestValidateEpochSize(t *testing.T) { + require.EqualError(t, validateEpochSize(0), "epochSize must be greater than or equal to 2") + require.EqualError(t, validateEpochSize(1), "epochSize must be greater than or equal to 2") + require.NoError(t, validateEpochSize(2)) +} diff --git a/consensus/ibft/ibft_gate_alignment_test.go b/consensus/ibft/ibft_gate_alignment_test.go new file mode 100644 index 0000000..92ea907 --- /dev/null +++ b/consensus/ibft/ibft_gate_alignment_test.go @@ -0,0 +1,72 @@ +package ibft + +import ( + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/chain" +) + +func Test_alignFeePoolSplitWithPoSFork(t *testing.T) { + t.Run("sets FeePoolSplit to first PoS from", func(t *testing.T) { + forks := chain.Forks{} + params := &chain.Params{Forks: &forks} + ibftConfig := map[string]interface{}{ + "types": []interface{}{ + map[string]interface{}{"type": "PoA", "from": 0.0, "to": 99.0}, + map[string]interface{}{"type": "PoS", "from": 100.0}, + }, + } + + require.NoError(t, alignFeePoolSplitWithPoSFork(params, ibftConfig)) + require.True(t, params.Forks.IsActive(chain.FeePoolSplit, 100)) + require.False(t, params.Forks.IsActive(chain.FeePoolSplit, 99)) + }) + + t.Run("accepts explicit FeePoolSplit matching first PoS from", func(t *testing.T) { + forks := chain.Forks{chain.FeePoolSplit: chain.NewFork(200)} + params := &chain.Params{Forks: &forks} + ibftConfig := map[string]interface{}{ + "types": []interface{}{ + map[string]interface{}{"type": "PoA", "from": 0.0, "to": 199.0}, + map[string]interface{}{"type": "PoS", "from": 200.0}, + }, + } + + require.NoError(t, alignFeePoolSplitWithPoSFork(params, ibftConfig)) + require.True(t, params.Forks.IsActive(chain.FeePoolSplit, 200)) + require.False(t, params.Forks.IsActive(chain.FeePoolSplit, 199)) + }) + + t.Run("returns error when explicit FeePoolSplit does not match first PoS from", func(t *testing.T) { + forks := chain.Forks{chain.FeePoolSplit: chain.NewFork(500)} + params := &chain.Params{Forks: &forks} + ibftConfig := map[string]interface{}{ + "types": []interface{}{ + map[string]interface{}{"type": "PoA", "from": 0.0, "to": 199.0}, + map[string]interface{}{"type": "PoS", "from": 200.0}, + }, + } + + require.EqualError(t, alignFeePoolSplitWithPoSFork(params, ibftConfig), "feePoolSplit fork must match first PoS fork: feePoolSplit=500 firstPoSFrom=200") + }) + + t.Run("does nothing when PoS is not configured", func(t *testing.T) { + forks := chain.Forks{chain.FeePoolSplit: chain.NewFork(42)} + params := &chain.Params{Forks: &forks} + ibftConfig := map[string]interface{}{"type": "PoA"} + + require.NoError(t, alignFeePoolSplitWithPoSFork(params, ibftConfig)) + require.True(t, params.Forks.IsActive(chain.FeePoolSplit, 42)) + require.False(t, params.Forks.IsActive(chain.FeePoolSplit, 41)) + }) + + t.Run("does nothing for legacy config without types", func(t *testing.T) { + forks := chain.Forks{} + params := &chain.Params{Forks: &forks} + ibftConfig := map[string]interface{}{"type": "PoA"} + + require.NoError(t, alignFeePoolSplitWithPoSFork(params, ibftConfig)) + require.False(t, params.Forks.IsActive(chain.FeePoolSplit, 1)) + }) +} diff --git a/consensus/ibft/ibft_hardening_test.go b/consensus/ibft/ibft_hardening_test.go new file mode 100644 index 0000000..b828120 --- /dev/null +++ b/consensus/ibft/ibft_hardening_test.go @@ -0,0 +1,323 @@ +package ibft + +import ( + "errors" + "sync" + "testing" + "time" + + "github.com/hashicorp/go-hclog" + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/blockchain" + "github.com/xgr-network/xgr-node/chain" + "github.com/xgr-network/xgr-node/consensus/ibft/fork" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + xcrypto "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/helper/progress" + "github.com/xgr-network/xgr-node/state" + itrie "github.com/xgr-network/xgr-node/state/immutable-trie" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +type hardeningTxPool struct { + mu sync.Mutex + sealing []bool + callsCh chan bool +} + +func newHardeningTxPool() *hardeningTxPool { + return &hardeningTxPool{callsCh: make(chan bool, 16)} +} + +func (m *hardeningTxPool) Prepare() {} +func (m *hardeningTxPool) Length() uint64 { return 0 } +func (m *hardeningTxPool) Peek() *types.Transaction { return nil } +func (m *hardeningTxPool) Pop(tx *types.Transaction) {} +func (m *hardeningTxPool) Drop(tx *types.Transaction) {} +func (m *hardeningTxPool) Demote(tx *types.Transaction) {} +func (m *hardeningTxPool) ResetWithHeaders(headers ...*types.Header) {} +func (m *hardeningTxPool) SetSealing(v bool) { + m.mu.Lock() + m.sealing = append(m.sealing, v) + m.mu.Unlock() + + select { + case m.callsCh <- v: + default: + } +} + +func (m *hardeningTxPool) seenTrue() bool { + m.mu.Lock() + defer m.mu.Unlock() + + for _, v := range m.sealing { + if v { + return true + } + } + + return false +} + +type hardeningHooks struct { + mu sync.Mutex + postInsertHeights []uint64 +} + +func (h *hardeningHooks) ShouldWriteTransactions(uint64) bool { return true } +func (h *hardeningHooks) ModifyHeader(*types.Header, types.Address) error { + return nil +} +func (h *hardeningHooks) VerifyHeader(*types.Header) error { return nil } +func (h *hardeningHooks) VerifyBlock(*types.Block) error { return nil } +func (h *hardeningHooks) ProcessHeader(*types.Header) error { + return nil +} +func (h *hardeningHooks) PreCommitState(*types.Header, *state.Transition) error { + return nil +} +func (h *hardeningHooks) PostInsertBlock(block *types.Block) error { + h.mu.Lock() + h.postInsertHeights = append(h.postInsertHeights, block.Number()) + h.mu.Unlock() + + return nil +} + +func (h *hardeningHooks) heights() []uint64 { + h.mu.Lock() + defer h.mu.Unlock() + + cloned := make([]uint64, len(h.postInsertHeights)) + copy(cloned, h.postInsertHeights) + + return cloned +} + +type hardeningForkManager struct { + signer signer.Signer + validators validators.Validators + validatorsByH map[uint64]validators.Validators + getValidators func(uint64) (validators.Validators, error) + hooksByHeight map[uint64]fork.HooksInterface + getSignerError map[uint64]error +} + +func (m *hardeningForkManager) Initialize() error { return nil } +func (m *hardeningForkManager) Close() error { return nil } +func (m *hardeningForkManager) GetSigner(height uint64) (signer.Signer, error) { + if err := m.getSignerError[height]; err != nil { + return nil, err + } + + return m.signer, nil +} +func (m *hardeningForkManager) GetValidatorStore(uint64) (fork.ValidatorStore, error) { + return nil, nil +} +func (m *hardeningForkManager) GetValidators(height uint64) (validators.Validators, error) { + if m.getValidators != nil { + return m.getValidators(height) + } + + if vals, ok := m.validatorsByH[height]; ok { + return vals, nil + } + + return m.validators, nil +} +func (m *hardeningForkManager) GetHooks(height uint64) fork.HooksInterface { + if hooks, ok := m.hooksByHeight[height]; ok { + return hooks + } + + return &hardeningHooks{} +} +func (m *hardeningForkManager) IsPosActive(uint64) bool { return false } + +type hardeningSyncer struct { + syncFn func(func(*types.FullBlock) bool) error +} + +func (s *hardeningSyncer) Start() error { return nil } +func (s *hardeningSyncer) Close() error { return nil } +func (s *hardeningSyncer) GetSyncProgression() *progress.Progression { return nil } +func (s *hardeningSyncer) HasSyncPeer() bool { return false } +func (s *hardeningSyncer) Sync(hook func(*types.FullBlock) bool) error { return s.syncFn(hook) } + +func newHardeningSigner(t *testing.T) signer.Signer { + t.Helper() + + key, err := xcrypto.GenerateECDSAKey() + require.NoError(t, err) + keyManager := signer.NewECDSAKeyManagerFromKey(key) + + return signer.NewSigner(keyManager, keyManager) +} + +func TestStartConsensus_UpdateCurrentModulesError_DisablesSealing(t *testing.T) { + t.Parallel() + + genesis := &types.Header{Number: 0, Difficulty: 1} + genesis.ComputeHash() + h1 := &types.Header{Number: 1, ParentHash: genesis.Hash, Difficulty: 1} + h1.ComputeHash() + bc := blockchain.NewTestBlockchain(t, []*types.Header{genesis, h1}) + + testSigner := newHardeningSigner(t) + staleValidators := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(testSigner.Address())) + + txpool := newHardeningTxPool() + + backend := &backendIBFT{ + logger: hclog.NewNullLogger(), + blockchain: bc, + txpool: txpool, + forkManager: &hardeningForkManager{getSignerError: map[uint64]error{2: errors.New("boom")}}, + currentSigner: testSigner, + currentValidators: staleValidators, + blockTime: 5 * time.Millisecond, + closeCh: make(chan struct{}), + } + + done := make(chan struct{}) + go func() { + backend.startConsensus() + close(done) + }() + + select { + case sealing := <-txpool.callsCh: + require.False(t, sealing) + case <-time.After(time.Second): + t.Fatal("timeout waiting for SetSealing call") + } + + require.False(t, txpool.seenTrue(), "sealing must not be enabled when updateCurrentModules fails") + + close(backend.closeCh) + + select { + case <-done: + case <-time.After(time.Second): + t.Fatal("timeout waiting for startConsensus shutdown") + } +} + +func TestStartSyncing_PostInsertBlock_UsesImportedBlockHooks(t *testing.T) { + t.Parallel() + + staleHooks := &hardeningHooks{} + importedHooks := &hardeningHooks{} + nextHeightHooks := &hardeningHooks{} + + testSigner := newHardeningSigner(t) + valSet := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(testSigner.Address())) + forkManager := &hardeningForkManager{ + signer: testSigner, + validators: valSet, + hooksByHeight: map[uint64]fork.HooksInterface{ + 7: importedHooks, + 8: nextHeightHooks, + }, + } + + txpool := newHardeningTxPool() + block := &types.Block{Header: &types.Header{Number: 7}} + + backend := &backendIBFT{ + logger: hclog.NewNullLogger(), + txpool: txpool, + forkManager: forkManager, + currentHooks: staleHooks, + syncer: &hardeningSyncer{syncFn: func(hook func(*types.FullBlock) bool) error { + hook(&types.FullBlock{Block: block}) + return nil + }}, + } + + backend.startSyncing() + + require.Empty(t, staleHooks.heights(), "stale currentHooks must not be used for PostInsertBlock") + require.Equal(t, []uint64{7}, importedHooks.heights(), "PostInsertBlock must run on hooks resolved for imported height") +} + +func TestStartConsensus_ValidatorToNonValidator_DoesNotReuseClosedSequenceChannel(t *testing.T) { + t.Parallel() + + genesis := &types.Header{Number: 0, Difficulty: 1} + genesis.ComputeHash() + h1 := &types.Header{Number: 1, ParentHash: genesis.Hash, Difficulty: 1} + h1.ComputeHash() + bc := blockchain.NewTestBlockchain(t, []*types.Header{genesis, h1}) + + testSigner := newHardeningSigner(t) + otherSigner := newHardeningSigner(t) + + validatorSetWithSelf := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(testSigner.Address())) + validatorSetWithoutSelf := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(otherSigner.Address())) + + txpool := newHardeningTxPool() + st := itrie.NewState(itrie.NewMemoryStorage()) + executor := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled}, st, hclog.NewNullLogger()) + + getValidatorsCalls := 0 + backend := &backendIBFT{ + logger: hclog.NewNullLogger(), + blockchain: bc, + executor: executor, + txpool: txpool, + forkManager: &hardeningForkManager{ + signer: testSigner, + getValidators: func(uint64) (validators.Validators, error) { + if getValidatorsCalls == 0 { + getValidatorsCalls++ + return validatorSetWithSelf, nil + } + + return validatorSetWithoutSelf, nil + }, + }, + blockTime: 5 * time.Millisecond, + closeCh: make(chan struct{}), + } + backend.consensus = newIBFT(hclog.NewNullLogger(), backend, backend) + + done := make(chan struct{}) + go func() { + backend.startConsensus() + close(done) + }() + + select { + case sealing := <-txpool.callsCh: + require.True(t, sealing) + case <-time.After(time.Second): + t.Fatal("timeout waiting for validator SetSealing(true) call") + } + + backend.consensus.stopSequence() + + select { + case sealing := <-txpool.callsCh: + require.False(t, sealing) + case <-time.After(time.Second): + t.Fatal("timeout waiting for non-validator SetSealing(false) call") + } + + select { + case sealing := <-txpool.callsCh: + t.Fatalf("unexpected extra SetSealing(%v) call, non-validator path should wait instead of spinning", sealing) + case <-time.After(100 * time.Millisecond): + } + + close(backend.closeCh) + + select { + case <-done: + case <-time.After(time.Second): + t.Fatal("timeout waiting for startConsensus shutdown") + } +} diff --git a/consensus/ibft/ibft_parent_committed_seals_test.go b/consensus/ibft/ibft_parent_committed_seals_test.go new file mode 100644 index 0000000..aa9de8c --- /dev/null +++ b/consensus/ibft/ibft_parent_committed_seals_test.go @@ -0,0 +1,116 @@ +package ibft + +import ( + "testing" + + "github.com/hashicorp/go-hclog" + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/blockchain" + "github.com/xgr-network/xgr-node/consensus/ibft/fork" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +type parentSealsTestSigner struct { + extra *signer.IstanbulExtra + seals signer.Seals +} + +func (m *parentSealsTestSigner) Type() validators.ValidatorType { return validators.ECDSAValidatorType } +func (m *parentSealsTestSigner) Address() types.Address { return types.ZeroAddress } +func (m *parentSealsTestSigner) InitIBFTExtra(*types.Header, validators.Validators, signer.Seals) { +} +func (m *parentSealsTestSigner) GetIBFTExtra(*types.Header) (*signer.IstanbulExtra, error) { + return m.extra, nil +} +func (m *parentSealsTestSigner) GetValidators(*types.Header) (validators.Validators, error) { + return m.extra.Validators, nil +} +func (m *parentSealsTestSigner) WriteProposerSeal(h *types.Header) (*types.Header, error) { + return h, nil +} +func (m *parentSealsTestSigner) EcrecoverFromHeader(*types.Header) (types.Address, error) { + return types.ZeroAddress, nil +} +func (m *parentSealsTestSigner) CreateCommittedSeal([]byte) ([]byte, error) { return nil, nil } +func (m *parentSealsTestSigner) VerifyCommittedSeal(validators.Validators, types.Address, []byte, []byte) error { + return nil +} +func (m *parentSealsTestSigner) WriteCommittedSeals(*types.Header, uint64, map[types.Address][]byte) (*types.Header, error) { + return nil, nil +} +func (m *parentSealsTestSigner) VerifyCommittedSeals(types.Hash, signer.Seals, validators.Validators, int) error { + return nil +} +func (m *parentSealsTestSigner) VerifyParentCommittedSeals(types.Hash, *types.Header, validators.Validators, int, bool) error { + return nil +} +func (m *parentSealsTestSigner) GetParentCommittedSeals(*types.Header) (signer.Seals, error) { + return m.seals, nil +} +func (m *parentSealsTestSigner) SignIBFTMessage([]byte) ([]byte, error) { return nil, nil } +func (m *parentSealsTestSigner) EcrecoverFromIBFTMessage([]byte, []byte) (types.Address, error) { + return types.ZeroAddress, nil +} +func (m *parentSealsTestSigner) CalculateHeaderHash(*types.Header) (types.Hash, error) { + return types.ZeroHash, nil +} +func (m *parentSealsTestSigner) FilterHeaderForHash(h *types.Header) (*types.Header, error) { + return h, nil +} + +type parentSealsForkManager struct { + signer signer.Signer + vals validators.Validators + pos bool +} + +func (m *parentSealsForkManager) Initialize() error { return nil } +func (m *parentSealsForkManager) Close() error { return nil } +func (m *parentSealsForkManager) GetSigner(uint64) (signer.Signer, error) { return m.signer, nil } +func (m *parentSealsForkManager) GetValidatorStore(uint64) (fork.ValidatorStore, error) { + return nil, nil +} +func (m *parentSealsForkManager) GetValidators(uint64) (validators.Validators, error) { + return m.vals, nil +} +func (m *parentSealsForkManager) GetHooks(uint64) fork.HooksInterface { return nil } +func (m *parentSealsForkManager) IsPosActive(uint64) bool { return m.pos } + +func TestVerifyParentCommittedSeals_PoSRequiresNonEmptySeals(t *testing.T) { + val := validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")) + valSet := validators.NewECDSAValidatorSet(val) + round := uint64(1) + ts := &parentSealsTestSigner{extra: &signer.IstanbulExtra{Validators: valSet, RoundNumber: &round}, seals: nil} + + genesis := &types.Header{Number: 0, Difficulty: 1} + genesis.ComputeHash() + parent := &types.Header{Number: 1, ParentHash: genesis.Hash, Difficulty: 1} + parent.ComputeHash() + child := &types.Header{Number: 2, ParentHash: parent.Hash, Difficulty: 1} + bc := blockchain.NewTestBlockchain(t, []*types.Header{genesis, parent}) + + backend := &backendIBFT{logger: hclog.NewNullLogger(), blockchain: bc, forkManager: &parentSealsForkManager{signer: ts, vals: valSet, pos: true}} + + err := backend.verifyParentCommittedSeals(parent, child, true) + require.EqualError(t, err, "missing parent committed seals in PoS weighted mode at height 1") +} + +func TestVerifyParentCommittedSeals_NonPoSKeepsCompatibility(t *testing.T) { + val := validators.NewECDSAValidator(types.StringToAddress("0x1000000000000000000000000000000000000001")) + valSet := validators.NewECDSAValidatorSet(val) + round := uint64(1) + ts := &parentSealsTestSigner{extra: &signer.IstanbulExtra{Validators: valSet, RoundNumber: &round}, seals: nil} + + genesis := &types.Header{Number: 0, Difficulty: 1} + genesis.ComputeHash() + parent := &types.Header{Number: 1, ParentHash: genesis.Hash, Difficulty: 1} + parent.ComputeHash() + child := &types.Header{Number: 2, ParentHash: parent.Hash, Difficulty: 1} + bc := blockchain.NewTestBlockchain(t, []*types.Header{genesis, parent}) + + backend := &backendIBFT{logger: hclog.NewNullLogger(), blockchain: bc, forkManager: &parentSealsForkManager{signer: ts, vals: valSet, pos: false}} + + require.NoError(t, backend.verifyParentCommittedSeals(parent, child, true)) +} diff --git a/consensus/ibft/messages.go b/consensus/ibft/messages.go index f4cf0a2..c4e0342 100644 --- a/consensus/ibft/messages.go +++ b/consensus/ibft/messages.go @@ -6,7 +6,7 @@ import ( protoIBFT "github.com/0xPolygon/go-ibft/messages/proto" ) -func (i *backendIBFT) signMessage(msg *protoIBFT.Message) *protoIBFT.Message { +func (i *backendIBFT) signMessage(msg *protoIBFT.IbftMessage) *protoIBFT.IbftMessage { raw, err := proto.Marshal(msg) if err != nil { return nil @@ -23,7 +23,7 @@ func (i *backendIBFT) BuildPrePrepareMessage( rawProposal []byte, certificate *protoIBFT.RoundChangeCertificate, view *protoIBFT.View, -) *protoIBFT.Message { +) *protoIBFT.IbftMessage { proposedBlock := &protoIBFT.Proposal{ RawProposal: rawProposal, Round: view.Round, @@ -35,11 +35,11 @@ func (i *backendIBFT) BuildPrePrepareMessage( return nil } - msg := &protoIBFT.Message{ + msg := &protoIBFT.IbftMessage{ View: view, From: i.ID(), Type: protoIBFT.MessageType_PREPREPARE, - Payload: &protoIBFT.Message_PreprepareData{ + Payload: &protoIBFT.IbftMessage_PreprepareData{ PreprepareData: &protoIBFT.PrePrepareMessage{ Proposal: proposedBlock, ProposalHash: proposalHash.Bytes(), @@ -51,12 +51,12 @@ func (i *backendIBFT) BuildPrePrepareMessage( return i.signMessage(msg) } -func (i *backendIBFT) BuildPrepareMessage(proposalHash []byte, view *protoIBFT.View) *protoIBFT.Message { - msg := &protoIBFT.Message{ +func (i *backendIBFT) BuildPrepareMessage(proposalHash []byte, view *protoIBFT.View) *protoIBFT.IbftMessage { + msg := &protoIBFT.IbftMessage{ View: view, From: i.ID(), Type: protoIBFT.MessageType_PREPARE, - Payload: &protoIBFT.Message_PrepareData{ + Payload: &protoIBFT.IbftMessage_PrepareData{ PrepareData: &protoIBFT.PrepareMessage{ ProposalHash: proposalHash, }, @@ -66,7 +66,7 @@ func (i *backendIBFT) BuildPrepareMessage(proposalHash []byte, view *protoIBFT.V return i.signMessage(msg) } -func (i *backendIBFT) BuildCommitMessage(proposalHash []byte, view *protoIBFT.View) *protoIBFT.Message { +func (i *backendIBFT) BuildCommitMessage(proposalHash []byte, view *protoIBFT.View) *protoIBFT.IbftMessage { committedSeal, err := i.currentSigner.CreateCommittedSeal(proposalHash) if err != nil { i.logger.Error("Unable to build commit message, %v", err) @@ -74,11 +74,11 @@ func (i *backendIBFT) BuildCommitMessage(proposalHash []byte, view *protoIBFT.Vi return nil } - msg := &protoIBFT.Message{ + msg := &protoIBFT.IbftMessage{ View: view, From: i.ID(), Type: protoIBFT.MessageType_COMMIT, - Payload: &protoIBFT.Message_CommitData{ + Payload: &protoIBFT.IbftMessage_CommitData{ CommitData: &protoIBFT.CommitMessage{ ProposalHash: proposalHash, CommittedSeal: committedSeal, @@ -93,12 +93,12 @@ func (i *backendIBFT) BuildRoundChangeMessage( proposal *protoIBFT.Proposal, certificate *protoIBFT.PreparedCertificate, view *protoIBFT.View, -) *protoIBFT.Message { - msg := &protoIBFT.Message{ +) *protoIBFT.IbftMessage { + msg := &protoIBFT.IbftMessage{ View: view, From: i.ID(), Type: protoIBFT.MessageType_ROUND_CHANGE, - Payload: &protoIBFT.Message_RoundChangeData{RoundChangeData: &protoIBFT.RoundChangeMessage{ + Payload: &protoIBFT.IbftMessage_RoundChangeData{RoundChangeData: &protoIBFT.RoundChangeMessage{ LastPreparedProposal: proposal, LatestPreparedCertificate: certificate, }}, diff --git a/consensus/ibft/operator_service.go b/consensus/ibft/operator_service.go index f33563b..f489fd4 100644 --- a/consensus/ibft/operator_service.go +++ b/consensus/ibft/operator_service.go @@ -5,9 +5,11 @@ import ( "errors" "fmt" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" "github.com/xgr-network/xgr-node/consensus/ibft/proto" "github.com/xgr-network/xgr-node/consensus/ibft/signer" "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/state" "github.com/xgr-network/xgr-node/types" "github.com/xgr-network/xgr-node/validators" "github.com/xgr-network/xgr-node/validators/store" @@ -66,10 +68,26 @@ func (o *operator) GetSnapshot(ctx context.Context, req *proto.SnapshotReq) (*pr return nil, err } + stateTx, err := o.stateAtHeader(header) + if err != nil { + return nil, err + } + + uptimeActive := o.ibft.forkManager.IsPosActive(height) + resp := &proto.Snapshot{ Number: height, Hash: header.Hash.String(), - Validators: validatorsToProtoValidators(validators), + Validators: validatorsToProtoValidators(validators, stateTx, o.ibft.uptimeCfg, uptimeActive), + } + + if uptimeActive { + for idx := 0; idx < len(resp.Validators); idx++ { + resp.UptimeTotalEffectiveWeight += resp.Validators[idx].UptimeEffectiveWeight + } + for idx := 0; idx < validators.Len(); idx++ { + resp.UptimeActiveEffectiveWeight += pos.UptimeEffectiveWeight(stateTx.Txn(), validators.At(uint64(idx)).Addr()) + } } votes, err := getVotes(validatorsStore, height) @@ -181,17 +199,23 @@ func (o *operator) getLatestSigner() (signer.Signer, error) { } // validatorsToProtoValidators converts validators to response of validators -func validatorsToProtoValidators(validators validators.Validators) []*proto.Snapshot_Validator { +func validatorsToProtoValidators(validators validators.Validators, tx *state.Transition, cfg pos.UptimeConfig, uptimeActive bool) []*proto.Snapshot_Validator { protoValidators := make([]*proto.Snapshot_Validator, validators.Len()) for idx := 0; idx < validators.Len(); idx++ { validator := validators.At(uint64(idx)) - protoValidators[idx] = &proto.Snapshot_Validator{ + entry := &proto.Snapshot_Validator{ Type: string(validator.Type()), Address: validator.Addr().String(), Data: validator.Bytes(), } + if uptimeActive && cfg.Enabled() && tx != nil { + entry.UptimeNominalWeight = pos.UptimeNominalWeight(tx.Txn(), validator.Addr()) + entry.UptimeEffectiveWeight = pos.UptimeEffectiveWeight(tx.Txn(), validator.Addr()) + entry.UptimeInactivity = pos.UptimeInactivity(tx.Txn(), validator.Addr()) + } + protoValidators[idx] = entry } return protoValidators @@ -229,6 +253,14 @@ func candidatesToProtoCandidates(candidates []*store.Candidate) []*proto.Candida return protoCandidates } +func (o *operator) stateAtHeader(header *types.Header) (*state.Transition, error) { + if header == nil { + return nil, ErrHeaderNotFound + } + + return o.ibft.executor.BeginTxn(header.StateRoot, header, types.ZeroAddress) +} + // getVotes gets votes from validator store only if store supports voting func getVotes(validatorStore store.ValidatorStore, height uint64) ([]*store.Vote, error) { votableStore, ok := validatorStore.(Votable) diff --git a/consensus/ibft/pos/epoch_validators.go b/consensus/ibft/pos/epoch_validators.go new file mode 100644 index 0000000..9504b82 --- /dev/null +++ b/consensus/ibft/pos/epoch_validators.go @@ -0,0 +1,83 @@ +package pos + +import ( + "fmt" + + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +const MaxEpochValidatorsSnapshot = uint64(4096) + +const maxEpochValidatorsSnapshot = MaxEpochValidatorsSnapshot + +func addrToHash(addr types.Address) types.Hash { + var h types.Hash + // Left-pad with 12 zero bytes, Solidity-style. + copy(h[12:], addr[:]) + + return h +} + +func addrFromHash(h types.Hash) types.Address { + var a types.Address + copy(a[:], h[12:]) + + return a +} + +func ensureEpochValidatorsSnapshot(txn *state.Transition, epoch uint64, vals validators.Validators) (bool, error) { + if txn == nil || epoch == 0 || vals == nil { + return false, nil + } + if vals.Len() == 0 { + return false, nil + } + + lenKey := keyEpochValidatorsLen(epoch) + if u64FromHash(txn.Txn().GetState(PosSysAddr, lenKey)) != 0 { + return false, nil + } + + l := vals.Len() + if uint64(l) > maxEpochValidatorsSnapshot { + return false, fmt.Errorf( + "epoch validator snapshot exceeds max: have %d max %d", + l, + maxEpochValidatorsSnapshot, + ) + } + + txn.Txn().SetState(PosSysAddr, lenKey, u64ToHash(uint64(l))) + + for i := 0; i < l; i++ { + addr := vals.At(uint64(i)).Addr() + txn.Txn().SetState(PosSysAddr, keyEpochValidator(epoch, uint64(i)), addrToHash(addr)) + } + + return true, nil +} + +func loadEpochValidatorsSnapshot(txn *state.Transition, epoch uint64) []types.Address { + if txn == nil || epoch == 0 { + return nil + } + + l := u64FromHash(txn.Txn().GetState(PosSysAddr, keyEpochValidatorsLen(epoch))) + if l == 0 { + return nil + } + if l > maxEpochValidatorsSnapshot { + // Defensive guard: malformed state must not force huge loops in epoch-finalize. + return nil + } + + out := make([]types.Address, 0, l) + for i := uint64(0); i < l; i++ { + h := txn.Txn().GetState(PosSysAddr, keyEpochValidator(epoch, i)) + out = append(out, addrFromHash(h)) + } + + return out +} diff --git a/consensus/ibft/pos/epoch_validators_test.go b/consensus/ibft/pos/epoch_validators_test.go new file mode 100644 index 0000000..e2ccfa2 --- /dev/null +++ b/consensus/ibft/pos/epoch_validators_test.go @@ -0,0 +1,79 @@ +package pos + +import ( + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func requireSnapshotCreated(t *testing.T, txn *state.Transition, epoch uint64, vals validators.Validators) { + t.Helper() + + created, err := ensureEpochValidatorsSnapshot(txn, epoch, vals) + require.NoError(t, err) + require.True(t, created) +} + +func makeEpochValidatorSet(t *testing.T, count uint64) validators.Validators { + t.Helper() + + set := validators.NewECDSAValidatorSet() + for i := uint64(0); i < count; i++ { + n := i + 1 + addr := types.Address{} + addr[12] = byte(n >> 56) + addr[13] = byte(n >> 48) + addr[14] = byte(n >> 40) + addr[15] = byte(n >> 32) + addr[16] = byte(n >> 24) + addr[17] = byte(n >> 16) + addr[18] = byte(n >> 8) + addr[19] = byte(n) + require.NoError(t, set.Add(validators.NewECDSAValidator(addr))) + } + + return set +} + +func TestEnsureEpochValidatorsSnapshotRejectsOverMaxWithoutWrites(t *testing.T) { + txn := newPosTestTransition(t) + epoch := uint64(2) + set := makeEpochValidatorSet(t, maxEpochValidatorsSnapshot+1) + + created, err := ensureEpochValidatorsSnapshot(txn, epoch, set) + require.Error(t, err) + require.False(t, created) + require.Contains(t, err.Error(), "epoch validator snapshot exceeds max") + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyEpochValidatorsLen(epoch)))) + for i := uint64(0); i < uint64(set.Len()); i++ { + require.Equal(t, types.ZeroHash, txn.Txn().GetState(PosSysAddr, keyEpochValidator(epoch, i))) + } +} + +func TestEnsureEpochValidatorsSnapshotValidCountAndLoadMax(t *testing.T) { + txn := newPosTestTransition(t) + epoch := uint64(3) + set := makeEpochValidatorSet(t, maxEpochValidatorsSnapshot) + + created, err := ensureEpochValidatorsSnapshot(txn, epoch, set) + require.NoError(t, err) + require.True(t, created) + require.Equal(t, maxEpochValidatorsSnapshot, u64FromHash(txn.Txn().GetState(PosSysAddr, keyEpochValidatorsLen(epoch)))) + + loaded := loadEpochValidatorsSnapshot(txn, epoch) + require.Len(t, loaded, int(maxEpochValidatorsSnapshot)) + for i := uint64(0); i < maxEpochValidatorsSnapshot; i++ { + require.Equal(t, set.At(i).Addr(), loaded[i]) + } +} + +func TestLoadEpochValidatorsSnapshotReturnsNilForMalformedOverMaxLen(t *testing.T) { + txn := newPosTestTransition(t) + epoch := uint64(4) + txn.Txn().SetState(PosSysAddr, keyEpochValidatorsLen(epoch), u64ToHash(maxEpochValidatorsSnapshot+1)) + + require.Nil(t, loadEpochValidatorsSnapshot(txn, epoch)) +} diff --git a/consensus/ibft/pos/events.go b/consensus/ibft/pos/events.go new file mode 100644 index 0000000..bdcc466 --- /dev/null +++ b/consensus/ibft/pos/events.go @@ -0,0 +1,134 @@ +package pos + +import ( + "math/big" + + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" +) + +var ( + posEventEpochFinalizedTopic = eventTopic("EpochFinalized(uint256,uint256,uint256,uint256,uint256,uint256,uint256)") + posEventStakerRewardedTopic = eventTopic("StakerRewarded(uint256,address,address,uint8,uint256,uint256,uint256,uint256)") + posEventStakerSlashedTopic = eventTopic("StakerSlashed(uint256,address,address,uint8,uint256,uint256,uint256,uint256,uint256,uint256,uint256,address)") + posEventValidatorUptimeFinalizedTopic = eventTopic("ValidatorUptimeFinalized(uint256,address,uint256,uint256,uint256,uint256,uint256,bool,bool)") +) + +type posStakerRewardEvent struct { + Epoch uint64 + Validator types.Address + Staker types.Address + Role uint8 + Amount *big.Int + StakeSnapshot *big.Int + StakeBefore *big.Int + StakeAfter *big.Int +} + +type posValidatorUptimeFinalizedEvent struct { + Epoch uint64 + Validator types.Address + Slots uint64 + Missed uint64 + UptimeBps uint64 + EffectiveWeight *big.Int + StakeSnapshot *big.Int + RewardEligible bool + Slashed bool +} + +type posStakerSlashEvent struct { + Epoch uint64 + Validator types.Address + Staker types.Address + Role uint8 + Amount *big.Int + StakeSnapshot *big.Int + StakeBefore *big.Int + StakeAfter *big.Int + Slots uint64 + Missed uint64 + SlashBps uint64 + Destination types.Address +} + +func eventTopic(signature string) types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(signature))) +} + +func abiWordBig(v *big.Int) []byte { + var out [32]byte + if v == nil || v.Sign() == 0 { + return out[:] + } + b := v.Bytes() + if len(b) > 32 { + b = b[len(b)-32:] + } + copy(out[32-len(b):], b) + return out[:] +} + +func abiWordU64(v uint64) []byte { return abiWordBig(new(big.Int).SetUint64(v)) } +func abiWordU8(v uint8) []byte { return abiWordBig(new(big.Int).SetUint64(uint64(v))) } + +func abiWordBool(v bool) []byte { + if !v { + return abiWordU64(0) + } + + return abiWordU64(1) +} + +func abiWordAddress(addr types.Address) []byte { + var out [32]byte + copy(out[12:], addr[:]) + return out[:] +} + +func abiHashU64(v uint64) types.Hash { return types.BytesToHash(abiWordU64(v)) } +func abiHashAddress(addr types.Address) types.Hash { return types.BytesToHash(abiWordAddress(addr)) } + +func abiData(words ...[]byte) []byte { + out := make([]byte, 0, len(words)*32) + for _, word := range words { + out = append(out, word...) + } + return out +} + +func appendPosSystemLog(txn *state.Transition, topics []types.Hash, data []byte) { + if txn == nil || txn.GetTxContext().NonPayable { + return + } + txn.EmitLog(PosSysAddr, topics, data) +} + +func appendPosEpochFinalizedLog(txn *state.Transition, epoch, blockNumber uint64, poolBalanceBefore, totalDistributed, poolRemainder, totalSlashed *big.Int, activeValidators uint64) { + appendPosSystemLog(txn, + []types.Hash{posEventEpochFinalizedTopic, abiHashU64(epoch), abiHashU64(blockNumber)}, + abiData(abiWordBig(poolBalanceBefore), abiWordBig(totalDistributed), abiWordBig(poolRemainder), abiWordBig(totalSlashed), abiWordU64(activeValidators)), + ) +} + +func appendPosValidatorUptimeFinalizedLog(txn *state.Transition, ev posValidatorUptimeFinalizedEvent) { + appendPosSystemLog(txn, + []types.Hash{posEventValidatorUptimeFinalizedTopic, abiHashU64(ev.Epoch), abiHashAddress(ev.Validator)}, + abiData(abiWordU64(ev.Slots), abiWordU64(ev.Missed), abiWordU64(ev.UptimeBps), abiWordBig(ev.EffectiveWeight), abiWordBig(ev.StakeSnapshot), abiWordBool(ev.RewardEligible), abiWordBool(ev.Slashed)), + ) +} + +func appendPosStakerRewardedLog(txn *state.Transition, ev posStakerRewardEvent) { + appendPosSystemLog(txn, + []types.Hash{posEventStakerRewardedTopic, abiHashU64(ev.Epoch), abiHashAddress(ev.Validator), abiHashAddress(ev.Staker)}, + abiData(abiWordU8(ev.Role), abiWordBig(ev.Amount), abiWordBig(ev.StakeSnapshot), abiWordBig(ev.StakeBefore), abiWordBig(ev.StakeAfter)), + ) +} + +func appendPosStakerSlashedLog(txn *state.Transition, ev posStakerSlashEvent) { + appendPosSystemLog(txn, + []types.Hash{posEventStakerSlashedTopic, abiHashU64(ev.Epoch), abiHashAddress(ev.Validator), abiHashAddress(ev.Staker)}, + abiData(abiWordU8(ev.Role), abiWordBig(ev.Amount), abiWordBig(ev.StakeSnapshot), abiWordBig(ev.StakeBefore), abiWordBig(ev.StakeAfter), abiWordU64(ev.Slots), abiWordU64(ev.Missed), abiWordU64(ev.SlashBps), abiWordAddress(ev.Destination)), + ) +} diff --git a/consensus/ibft/pos/finalize.go b/consensus/ibft/pos/finalize.go new file mode 100644 index 0000000..95bd5af --- /dev/null +++ b/consensus/ibft/pos/finalize.go @@ -0,0 +1,1038 @@ +package pos + +import ( + "bytes" + "encoding/binary" + "fmt" + "math/big" + "sort" + + "github.com/xgr-network/xgr-node/chain" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" + contractstore "github.com/xgr-network/xgr-node/validators/store/contract" +) + +var ( + posTransferFn = func(txn *state.Transition, from, to types.Address, amount *big.Int) error { + return txn.Transfer(from, to, amount) + } + finalizeEpochRewardSplitFn = splitValidatorRewardByDelegation +) + +// Epoch policy parameters (consensus-critical; fork-gated by FeePoolSplit). +const ( + slashBpsDefault uint64 = 100 // 1% + + // Defense-in-depth only. + // Under current invariants, bootstrap stakes can only participate through emergency mode, + // and emergency mode disables slashing. Normal slashable validators are Tier-1 eligible + // and therefore far above this floor. Keep this guard to avoid slashing bootstrap dust + // if future selection/slashing invariants change. + noSlashStakeFloorWei uint64 = 10 +) + +// FinalizeEpoch runs on the tx-free epoch boundary block (height % epochSize == 0). +// It distributes the pooled fees and applies uptime-based penalties. +// +// Design choice: the epoch boundary block itself is treated as a system/finalize block and is NOT +// included in uptime accounting. Uptime counters are derived from RoundNumber (missed proposer slots), +// i.e. blocks 1..(epochEnd-1) for each epoch. +func FinalizeEpoch(header *types.Header, epochSize uint64, uptimeCfg UptimeConfig, headerSigner signer.Signer, txn *state.Transition) error { + if header == nil || txn == nil { + posDiagLogger.Debug("FinalizeEpoch skipped: nil input", "headerNil", header == nil, "txnNil", txn == nil) + return nil + } + + // Fork-gated: no PoS policy logic before pooling is enabled. + if !txn.ForksInTime().FeePoolSplit { + posDiagLogger.Debug("FinalizeEpoch skipped: FeePoolSplit not active", "block", header.Number) + return nil + } + + // IMPORTANT: keep PosSysAddr alive (otherwise storage is pruned every block). + ensurePosSysAccount(txn) + if epochSize < 2 { + posDiagLogger.Error("FinalizeEpoch failed: epochSize must be >= 2", "block", header.Number, "epochSize", epochSize) + return fmt.Errorf("epochSize must be greater than or equal to 2") + } + + // Only at epoch boundary block (tx-free by hook guard) + if header.Number == 0 || header.Number%epochSize != 0 { + posDiagLogger.Debug("FinalizeEpoch skipped: not epoch boundary", "block", header.Number, "epochSize", epochSize) + return nil + } + + // Finalize the epoch for blocks up to (header.Number - 1) + epoch := epochOf(header.Number-1, epochSize) + if epoch == 0 { + posDiagLogger.Debug("FinalizeEpoch skipped: epoch=0", "block", header.Number, "epochSize", epochSize) + return nil + } + + posDiagLogger.Debug("FinalizeEpoch start", "block", header.Number, "epoch", epoch, "epochSize", epochSize, "hash", header.Hash, "parent", header.ParentHash, "stateRoot", header.StateRoot) + + extra, err := getIBFTExtra(headerSigner, header) + if err != nil { + posDiagLogger.Error("FinalizeEpoch failed decoding extra", "block", header.Number, "epoch", epoch, "err", err) + return fmt.Errorf("decode ibft extra for epoch finalization: %w", err) + } + if extra == nil || extra.Validators == nil || extra.Validators.Len() == 0 { + posDiagLogger.Error("FinalizeEpoch decoded extra but validators are empty", "block", header.Number, "epoch", epoch) + return fmt.Errorf("decode ibft extra for epoch finalization: empty validator set") + } + epochValidators := loadEpochValidatorsSnapshot(txn, epoch) + if len(epochValidators) == 0 { + posDiagLogger.Error("FinalizeEpoch failed: missing epoch validator snapshot", "block", header.Number, "epoch", epoch) + return fmt.Errorf("missing epoch validator snapshot for epoch %d", epoch) + } + posDiagLogger.Debug("FinalizeEpoch using stored epoch validator snapshot", "block", header.Number, "epoch", epoch, "validatorsLen", len(epochValidators)) + uptimeLastProcessed := u64FromHash(txn.Txn().GetState(PosSysAddr, keyUptimeLastProcessedSlot())) + posDiagLogger.Debug("FinalizeEpoch validator source ready", "block", header.Number, "epoch", epoch, "validatorsLen", len(epochValidators), "uptimeLastProcessed", uptimeLastProcessed) + + // Resolve donation address (slash target). + donationAddr := resolveDonationAddress(txn) + slashingEnabled := !contractstore.IsEmergencyModeActive(txn) + posDiagLogger.Debug("FinalizeEpoch donation address", "block", header.Number, "epoch", epoch, "donationAddr", donationAddr) + posDiagLogger.Debug("FinalizeEpoch slashing mode", "block", header.Number, "epoch", epoch, "slashingEnabled", slashingEnabled) + + // Collect per-validator effective weights. + type vinfo struct { + addr types.Address + weight *big.Int + } + + infos := make([]vinfo, 0, len(epochValidators)) + sumWeights := new(big.Int) + slashEvents := make([]posStakerSlashEvent, 0) + uptimeEvents := make([]posValidatorUptimeFinalizedEvent, 0, len(epochValidators)) + snapshotStakers := make([]types.Address, 0, len(epochValidators)) + + for _, addr := range epochValidators { + + // Proposer-slot based availability (provable from RoundNumber). + slotsKey := keyProposerSlots(epoch, addr) + missedKey := keyProposerMissed(epoch, addr) + slots := u64FromHash(txn.Txn().GetState(PosSysAddr, slotsKey)) + missed := u64FromHash(txn.Txn().GetState(PosSysAddr, missedKey)) + + // Diagnostic context: include key material and neighbor-epoch values to isolate + // cross-path epoch/key mismatches without changing consensus behavior. + var ( + slotsPrev uint64 + slotsNext uint64 + missedPrev uint64 + missedNext uint64 + ) + if epoch > 0 { + slotsPrev = u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch-1, addr))) + missedPrev = u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerMissed(epoch-1, addr))) + } + slotsNext = u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch+1, addr))) + missedNext = u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerMissed(epoch+1, addr))) + posDiagLogger.Debug("FinalizeEpoch validator counters", + "epoch", epoch, + "validator", addr, + "slotsKey", slotsKey, + "missedKey", missedKey, + "slots", slots, + "missed", missed, + "slotsPrev", slotsPrev, + "missedPrev", missedPrev, + "slotsNext", slotsNext, + "missedNext", missedNext, + ) + + // If the validator had no proposer slots in this epoch (e.g. joined later), + // do NOT reward and do NOT penalize. + if slots == 0 { + posDiagLogger.Debug("FinalizeEpoch validator slots=0", "epoch", epoch, "validator", addr) + uptimeEvents = append(uptimeEvents, posValidatorUptimeFinalizedEvent{ + Epoch: epoch, + Validator: addr, + EffectiveWeight: new(big.Int), + StakeSnapshot: bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakeSnapshot(epoch, addr))), + }) + infos = append(infos, vinfo{addr: addr, weight: new(big.Int)}) + continue + } + if missed > slots { + missed = slots + } + okSlots := slots - missed + uptimeBps := okSlots * 10_000 / slots + if okSlots == 0 { + setValidatorInactiveInStaking(txn, addr, header.Number) + } + + stakeSnap, err := getOrInitStakeSnapshot(txn, epoch, addr) + if err != nil { + return fmt.Errorf("load stake snapshot for validator %s in epoch %d: %w", addr, epoch, err) + } + + // Thresholds are applied on okSlots/slots. + // >= 90% => full weight + // 80..90 => linear reduced weight: factor = (okSlots/0.9) + // < 80% => 0 weight (reward-ineligible for this epoch) + // < 50% => 0 weight + slash(stake) + eff := new(big.Int) + rewardEligible := okSlots*10 >= slots*8 + slashed := false + if !rewardEligible { + posDiagLogger.Debug("FinalizeEpoch validator below uptime threshold", "epoch", epoch, "validator", addr, "slots", slots, "missed", missed, "okSlots", okSlots) + if okSlots*2 < slots { // <50% + if slashingEnabled { + posDiagLogger.Debug("FinalizeEpoch slashing validator", "epoch", epoch, "validator", addr, "stakeSnap", stakeSnap) + slashEvent, err := slashByEffectiveStakeFromStakingContract(txn, epoch, addr, donationAddr, stakeSnap, slots, missed, slashBpsDefault, header.Number-1, epochSize) + if err != nil { + return fmt.Errorf("slash validator %s in epoch %d: %w", addr, epoch, err) + } + if len(slashEvent) > 0 { + slashed = true + slashEvents = append(slashEvents, slashEvent...) + for _, stakerEvent := range slashEvent { + snapshotStakers = append(snapshotStakers, stakerEvent.Staker) + } + } + } else { + posDiagLogger.Debug("FinalizeEpoch slashing skipped: emergency mode active", "epoch", epoch, "validator", addr) + } + } + uptimeEvents = append(uptimeEvents, posValidatorUptimeFinalizedEvent{ + Epoch: epoch, + Validator: addr, + Slots: slots, + Missed: missed, + UptimeBps: uptimeBps, + EffectiveWeight: eff, + StakeSnapshot: new(big.Int).Set(stakeSnap), + RewardEligible: false, + Slashed: slashed, + }) + infos = append(infos, vinfo{addr: addr, weight: eff}) + continue + } + + // factor = 1 for >=90%, else factor = (okSlots/slots) / 0.9 = okSlots*10/(slots*9) + if okSlots*10 >= slots*9 { + eff = new(big.Int).Set(stakeSnap) + } else { + num := new(big.Int).Mul(stakeSnap, new(big.Int).SetUint64(okSlots*10)) + den := new(big.Int).SetUint64(slots * 9) + eff = num.Div(num, den) + } + + uptimeEvents = append(uptimeEvents, posValidatorUptimeFinalizedEvent{ + Epoch: epoch, + Validator: addr, + Slots: slots, + Missed: missed, + UptimeBps: uptimeBps, + EffectiveWeight: new(big.Int).Set(eff), + StakeSnapshot: new(big.Int).Set(stakeSnap), + RewardEligible: true, + Slashed: false, + }) + infos = append(infos, vinfo{addr: addr, weight: eff}) + sumWeights.Add(sumWeights, eff) + posDiagLogger.Debug("FinalizeEpoch validator weight", "epoch", epoch, "validator", addr, "slots", slots, "missed", missed, "weight", eff) + } + + // Distribute pooled fees proportional to effective weights. + // Note: if there are no pooled fees, we still enforce jail/slash deterministically. + poolBal := new(big.Int).Set(txn.Txn().GetBalance(state.FeePoolAddress)) + posDiagLogger.Debug("FinalizeEpoch pool/weights", "block", header.Number, "epoch", epoch, "poolBal", poolBal, "sumWeights", sumWeights) + if poolBal.Sign() == 0 || sumWeights.Sign() == 0 { + posDiagLogger.Debug("FinalizeEpoch no payout", "block", header.Number, "epoch", epoch, "poolZero", poolBal.Sign() == 0, "weightsZero", sumWeights.Sign() == 0) + } + + type plannedReward struct { + addr types.Address + share *big.Int + parts validatorRewardSplit + } + + plans := make([]plannedReward, 0, len(infos)) + if poolBal.Sign() > 0 && sumWeights.Sign() > 0 { + for _, it := range infos { + if it.weight.Sign() == 0 { + continue + } + + share := new(big.Int).Mul(poolBal, it.weight) + share.Div(share, sumWeights) + if share.Sign() == 0 { + posDiagLogger.Debug("FinalizeEpoch zero share for validator", "epoch", epoch, "validator", it.addr, "weight", it.weight) + continue + } + + rewardParts, err := finalizeEpochRewardSplitFn(txn, header.Number-1, epochSize, it.addr, share) + if err != nil { + return fmt.Errorf("split validator reward for %s in epoch %d: %w", it.addr, epoch, err) + } + if err := validateRewardSplit(epoch, it.addr, share, rewardParts); err != nil { + return err + } + plans = append(plans, plannedReward{ + addr: it.addr, + share: share, + parts: rewardParts, + }) + } + } + + rewardEvents := make([]posStakerRewardEvent, 0, len(plans)) + totalDistributed := new(big.Int) + for _, plan := range plans { + if err := posTransferFn(txn, state.FeePoolAddress, staking.AddrStakingContract, plan.share); err != nil { + posDiagLogger.Error("FinalizeEpoch transfer failed", "epoch", epoch, "validator", plan.addr, "share", plan.share, "err", err) + return fmt.Errorf("transfer epoch reward for validator %s in epoch %d: %w", plan.addr, epoch, err) + } + rewardEvent := creditStakeReward(txn, epoch, plan.addr, plan.parts) + rewardEvents = append(rewardEvents, rewardEvent...) + totalDistributed.Add(totalDistributed, plan.share) + for _, stakerEvent := range rewardEvent { + snapshotStakers = append(snapshotStakers, stakerEvent.Staker) + } + posDiagLogger.Debug("FinalizeEpoch payout", "epoch", epoch, "validator", plan.addr, "share", plan.share) + } + + totalSlashed := new(big.Int) + for _, ev := range slashEvents { + totalSlashed.Add(totalSlashed, ev.Amount) + } + remainder := new(big.Int).Sub(new(big.Int).Set(poolBal), totalDistributed) + activeValidatorsAfter := countActiveEpochValidators(txn, epochValidators) + snapshotStakers = append(snapshotStakers, collectEpochValidatorStakers(txn, epochValidators)...) + cleanupFinalizedEpochState(txn, epoch, epochValidators, snapshotStakers) + + appendPosEpochFinalizedLog(txn, epoch, header.Number, poolBal, totalDistributed, remainder, totalSlashed, activeValidatorsAfter) + for _, ev := range uptimeEvents { + appendPosValidatorUptimeFinalizedLog(txn, ev) + } + for _, ev := range rewardEvents { + appendPosStakerRewardedLog(txn, ev) + } + for _, ev := range slashEvents { + appendPosStakerSlashedLog(txn, ev) + } + + posDiagLogger.Debug("FinalizeEpoch complete", "block", header.Number, "epoch", epoch) + + return nil +} + +func countActiveEpochValidators(txn *state.Transition, validators []types.Address) uint64 { + var active uint64 + for _, validator := range validators { + if readStakerActive(txn, validator) { + active++ + } + } + + return active +} + +func collectEpochValidatorStakers(txn *state.Transition, validators []types.Address) []types.Address { + stakers := make([]types.Address, 0, len(validators)) + for _, validator := range validators { + stakers = append(stakers, validator) + stakers = append(stakers, readValidatorStakers(txn, validator)...) + } + + return stakers +} + +func resolveDonationAddress(txn *state.Transition) types.Address { + // Slashed stake is always burned at 0x...0666. + return chain.DefaultBurnedAddress +} + +func getOrInitStakeSnapshot(txn *state.Transition, epoch uint64, addr types.Address) (*big.Int, error) { + if txn == nil { + return nil, fmt.Errorf("nil transition") + } + + key := keyStakeSnapshot(epoch, addr) + cur := bigFromHash(txn.Txn().GetState(PosSysAddr, key)) + if cur.Sign() != 0 { + return cur, nil + } + + blockNumber := uint64(0) + if txn != nil { + blockNumber = uint64(txn.GetTxContext().Number) + if blockNumber > 0 { + blockNumber-- + } + } + + stakeAmt := contractstore.ReadValidatorEffectiveTotalStakeAt(txn, addr, blockNumber) + txn.Txn().SetState(PosSysAddr, key, bigToHash(stakeAmt)) + return stakeAmt, nil +} + +func getOrInitStakerStakeSnapshot(txn *state.Transition, epoch uint64, addr types.Address) (*big.Int, error) { + if txn == nil { + return nil, fmt.Errorf("nil transition") + } + + key := keyStakerStakeSnapshot(epoch, addr) + cur := bigFromHash(txn.Txn().GetState(PosSysAddr, key)) + if cur.Sign() != 0 { + return cur, nil + } + + blockNumber := uint64(0) + if txn != nil { + blockNumber = uint64(txn.GetTxContext().Number) + if blockNumber > 0 { + blockNumber-- + } + } + + stakeAmt := contractstore.ReadStakerEffectiveStakeAt(txn, addr, blockNumber) + txn.Txn().SetState(PosSysAddr, key, bigToHash(stakeAmt)) + + return stakeAmt, nil +} + +type slashPosition struct { + addr types.Address + amount *big.Int + active bool +} + +type slashAllocation struct { + position slashPosition + slash *big.Int +} + +func slashByEffectiveStakeFromStakingContract(txn *state.Transition, epoch uint64, validator, donationAddr types.Address, stakeSnap *big.Int, slots, missed, slashBps, blockNumber, epochSize uint64) ([]posStakerSlashEvent, error) { + if slashBps == 0 { + posDiagLogger.Debug("slashByEffectiveStakeFromStakingContract skipped: slashBps=0", "epoch", epoch, "validator", validator) + return nil, nil + } + if stakeSnap == nil || stakeSnap.Sign() == 0 { + posDiagLogger.Debug("slashByEffectiveStakeFromStakingContract skipped: empty stake snapshot", "epoch", epoch, "validator", validator) + return nil, nil + } + if stakeSnap.Cmp(new(big.Int).SetUint64(noSlashStakeFloorWei)) <= 0 { + posDiagLogger.Debug("slashByEffectiveStakeFromStakingContract skipped: at no-slash floor", "epoch", epoch, "validator", validator, "stakeSnap", stakeSnap, "floorWei", noSlashStakeFloorWei) + return nil, nil + } + + totalSlash := new(big.Int).Mul(stakeSnap, new(big.Int).SetUint64(slashBps)) + totalSlash.Div(totalSlash, new(big.Int).SetUint64(10_000)) + if totalSlash.Sign() == 0 { + posDiagLogger.Debug("slashByEffectiveStakeFromStakingContract skipped: slash amount zero", "epoch", epoch, "validator", validator) + return nil, nil + } + + effectiveTotalStake := new(big.Int) + positions := make([]slashPosition, 0, 1) + if isStakerEffectiveAt(txn, validator, blockNumber, epochSize) { + selfStake, err := readStakeWeightAtEpoch(txn, epoch, validator) + if err != nil { + return nil, err + } + positions = append(positions, slashPosition{addr: validator, amount: selfStake, active: true}) + effectiveTotalStake.Add(effectiveTotalStake, selfStake) + } + delegations, err := readValidatorEffectiveDelegationsAt(txn, epoch, validator, blockNumber, epochSize) + if err != nil { + return nil, err + } + for _, delegation := range delegations { + positions = append(positions, slashPosition{ + addr: delegation.Delegator, + amount: delegation.Amount, + active: readStakerActive(txn, delegation.Delegator), + }) + effectiveTotalStake.Add(effectiveTotalStake, delegation.Amount) + } + if effectiveTotalStake.Sign() == 0 { + posDiagLogger.Debug("slashByEffectiveStakeFromStakingContract skipped: effective stake zero", "epoch", epoch, "validator", validator) + return nil, nil + } + + if totalSlash.Cmp(effectiveTotalStake) > 0 { + totalSlash.Set(effectiveTotalStake) + } + + contractBal := new(big.Int).Set(txn.Txn().GetBalance(staking.AddrStakingContract)) + if contractBal.Sign() == 0 { + posDiagLogger.Debug("slashByEffectiveStakeFromStakingContract skipped: staking contract balance zero", "epoch", epoch, "validator", validator) + return nil, nil + } + if totalSlash.Cmp(contractBal) > 0 { + totalSlash.Set(contractBal) + } + if totalSlash.Sign() == 0 { + posDiagLogger.Debug("slashByEffectiveStakeFromStakingContract skipped: slash amount zero after caps", "epoch", epoch, "validator", validator) + return nil, nil + } + + remaining := new(big.Int).Set(totalSlash) + allocations := make([]slashAllocation, 0, len(positions)) + for _, position := range positions { + part := new(big.Int).Mul(new(big.Int).Set(totalSlash), position.amount) + part.Div(part, effectiveTotalStake) + if part.Cmp(position.amount) > 0 { + return nil, fmt.Errorf("slash amount exceeds stake for %s: have %s, need %s", position.addr, position.amount, part) + } + allocations = append(allocations, slashAllocation{ + position: position, + slash: part, + }) + remaining.Sub(remaining, part) + } + + sort.Slice(allocations, func(i, j int) bool { + return bytes.Compare(allocations[i].position.addr.Bytes(), allocations[j].position.addr.Bytes()) < 0 + }) + + for remaining.Sign() > 0 { + progress := false + for i := range allocations { + if allocations[i].slash.Cmp(allocations[i].position.amount) >= 0 { + continue + } + allocations[i].slash.Add(allocations[i].slash, big.NewInt(1)) + remaining.Sub(remaining, big.NewInt(1)) + progress = true + if remaining.Sign() == 0 { + break + } + } + if !progress { + return nil, fmt.Errorf("unable to distribute slash remainder %s", remaining) + } + } + + stakerEvents := make([]posStakerSlashEvent, 0, len(allocations)) + for _, allocation := range allocations { + if allocation.slash.Sign() == 0 { + continue + } + curStake := new(big.Int).Set(readStakedAmount(txn, allocation.position.addr)) + if allocation.slash.Cmp(curStake) > 0 { + return nil, fmt.Errorf("slash underflow for %s: have %s, need %s", allocation.position.addr, curStake, allocation.slash) + } + newStake := new(big.Int).Sub(curStake, allocation.slash) + if err := posTransferFn(txn, staking.AddrStakingContract, donationAddr, allocation.slash); err != nil { + return nil, fmt.Errorf("transfer slash amount: %w", err) + } + writeStakedAmount(txn, allocation.position.addr, newStake) + if allocation.position.addr != validator { + if err := reduceValidatorDelegatedAggregate(txn, validator, allocation.slash, allocation.position.active); err != nil { + return nil, err + } + } + role := uint8(2) + if allocation.position.addr == validator { + role = 1 + } + stakerEvents = append(stakerEvents, posStakerSlashEvent{ + Epoch: epoch, Validator: validator, Staker: allocation.position.addr, Role: role, + Amount: new(big.Int).Set(allocation.slash), StakeSnapshot: new(big.Int).Set(allocation.position.amount), + StakeBefore: curStake, StakeAfter: newStake, Slots: slots, Missed: missed, SlashBps: slashBps, Destination: donationAddr, + }) + } + + posDiagLogger.Debug("slashByEffectiveStakeFromStakingContract applied", "epoch", epoch, "validator", validator, "donationAddr", donationAddr, "amount", totalSlash) + + return stakerEvents, nil +} + +type validatorRewardSplit struct { + ValidatorNet *big.Int + Commission *big.Int + DelegatorsNet *big.Int + DelegatorsNetAfterCommission *big.Int + SelfStakeReward *big.Int + DelegatorRemainder *big.Int + DelegatorParts []delegationShare +} + +type delegationShare struct { + Delegator types.Address + Amount *big.Int +} + +func splitValidatorRewardByDelegation(txn *state.Transition, blockNumber, epochSize uint64, validator types.Address, reward *big.Int) (validatorRewardSplit, error) { + out := validatorRewardSplit{ + ValidatorNet: new(big.Int), + Commission: new(big.Int), + DelegatorsNet: new(big.Int), + DelegatorsNetAfterCommission: new(big.Int), + SelfStakeReward: new(big.Int), + DelegatorRemainder: new(big.Int), + } + if reward == nil || reward.Sign() == 0 { + return out, nil + } + + epoch := epochOf(blockNumber, epochSize) + selfStake := new(big.Int) + if isStakerEffectiveAt(txn, validator, blockNumber, epochSize) { + var err error + selfStake, err = readStakeWeightAtEpoch(txn, epoch, validator) + if err != nil { + return out, err + } + } + delegations, err := readValidatorEffectiveDelegationsAt(txn, epoch, validator, blockNumber, epochSize) + if err != nil { + return out, err + } + if len(delegations) == 0 { + out.ValidatorNet = new(big.Int).Set(reward) + out.SelfStakeReward = new(big.Int).Set(reward) + return out, nil + } + + activeDelegatedTotal := new(big.Int) + for _, delegation := range delegations { + activeDelegatedTotal.Add(activeDelegatedTotal, delegation.Amount) + } + if activeDelegatedTotal.Sign() == 0 { + out.ValidatorNet = new(big.Int).Set(reward) + out.SelfStakeReward = new(big.Int).Set(reward) + return out, nil + } + + totalActiveStake := new(big.Int).Add(new(big.Int).Set(selfStake), activeDelegatedTotal) + if totalActiveStake.Sign() == 0 { + return out, nil + } + + selfShare := new(big.Int).Mul(new(big.Int).Set(reward), selfStake) + selfShare.Div(selfShare, totalActiveStake) + delegatedShare := new(big.Int).Sub(new(big.Int).Set(reward), selfShare) + + commissionBps := uint64(readValidatorCommissionBps(txn, validator)) + commission := new(big.Int).Mul(new(big.Int).Set(delegatedShare), new(big.Int).SetUint64(commissionBps)) + commission.Div(commission, new(big.Int).SetUint64(10_000)) + delegatorsNet := new(big.Int).Sub(new(big.Int).Set(delegatedShare), commission) + + allocated := new(big.Int) + out.DelegatorParts = make([]delegationShare, 0, len(delegations)) + for _, delegation := range delegations { + part := new(big.Int).Mul(new(big.Int).Set(delegatorsNet), delegation.Amount) + part.Div(part, activeDelegatedTotal) + if part.Sign() == 0 { + continue + } + allocated.Add(allocated, part) + out.DelegatorParts = append(out.DelegatorParts, delegationShare{ + Delegator: delegation.Delegator, + Amount: part, + }) + } + + delegatorRemainder := new(big.Int).Sub(new(big.Int).Set(delegatorsNet), allocated) + out.Commission.Set(commission) + out.DelegatorsNet.Set(allocated) + out.DelegatorsNetAfterCommission.Set(delegatorsNet) + out.SelfStakeReward.Set(selfShare) + out.DelegatorRemainder.Set(delegatorRemainder) + out.ValidatorNet.Add(selfShare, commission) + out.ValidatorNet.Add(out.ValidatorNet, delegatorRemainder) + + return out, nil +} + +func readValidatorEffectiveDelegationsAt(txn *state.Transition, epoch uint64, validator types.Address, _ uint64, _ uint64) ([]delegationShare, error) { + if txn == nil { + return nil, nil + } + stakers := readValidatorStakers(txn, validator) + out := make([]delegationShare, 0, len(stakers)) + for _, owner := range stakers { + if owner == validator { + continue + } + amount := bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakerStakeSnapshot(epoch, owner))) + if amount.Sign() == 0 { + continue + } + out = append(out, delegationShare{Delegator: owner, Amount: amount}) + } + + return out, nil +} + +func readStakeWeightAtEpoch(txn *state.Transition, epoch uint64, addr types.Address) (*big.Int, error) { + if epoch == 0 { + return nil, fmt.Errorf("invalid epoch for staker snapshot %s", addr) + } + + snap := bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakerStakeSnapshot(epoch, addr))) + if snap.Sign() == 0 { + return nil, fmt.Errorf("missing staker snapshot for epoch %d staker %s", epoch, addr) + } + + return snap, nil +} + +func readValidatorCommissionBps(txn *state.Transition, validator types.Address) uint16 { + base := crypto.Keccak256( + common.PadLeftOrTrim(validator.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(5).Bytes(), 32), + ) + idx := new(big.Int).Add(new(big.Int).SetBytes(base), big.NewInt(3)) + raw := txn.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(idx.Bytes())) + v := new(big.Int).SetBytes(raw[:]).Uint64() + if v > 10_000 { + return 10_000 + } + + return uint16(v) +} + +func readValidatorStakers(txn *state.Transition, validator types.Address) []types.Address { + base := crypto.Keccak256( + common.PadLeftOrTrim(validator.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(6).Bytes(), 32), + ) + lengthRaw := txn.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(base)) + length := new(big.Int).SetBytes(lengthRaw[:]).Uint64() + if length == 0 { + return nil + } + dataBase := crypto.Keccak256(common.PadLeftOrTrim(base, 32)) + idx := new(big.Int).SetBytes(dataBase) + out := make([]types.Address, 0, length) + for i := uint64(0); i < length; i++ { + slot := new(big.Int).Add(idx, new(big.Int).SetUint64(i)) + raw := txn.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(slot.Bytes())) + out = append(out, types.BytesToAddress(raw[12:])) + } + + return out +} + +func readStakerJoinedAt(txn *state.Transition, addr types.Address) uint64 { + raw := txn.Txn().GetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 2)) + return new(big.Int).SetBytes(raw[:]).Uint64() +} + +func readStakerDeactivatedAt(txn *state.Transition, addr types.Address) uint64 { + raw := txn.Txn().GetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 3)) + return new(big.Int).SetBytes(raw[:]).Uint64() +} + +func readStakerActive(txn *state.Transition, addr types.Address) bool { + raw := txn.Txn().GetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 0)) + packed := new(big.Int).SetBytes(raw[:]) + if packed.Sign() == 0 { + return false + } + + activeByte := new(big.Int).Rsh(packed, 8) + activeByte.And(activeByte, new(big.Int).SetUint64(0xff)) + + return activeByte.Sign() != 0 +} + +func isStakerEffectiveAt(txn *state.Transition, addr types.Address, blockNumber, epochSize uint64) bool { + joined := readStakerJoinedAt(txn, addr) + if joined == 0 || epochSize == 0 { + return false + } + if blockNumber/epochSize <= joined/epochSize { + return false + } + deactivated := readStakerDeactivatedAt(txn, addr) + if deactivated == 0 { + return true + } + + return blockNumber/epochSize <= deactivated/epochSize +} + +func nonNilBig(v *big.Int) *big.Int { + if v == nil { + return new(big.Int) + } + + return v +} + +func validateRewardSplit(epoch uint64, addr types.Address, totalReward *big.Int, split validatorRewardSplit) error { + totalReward = nonNilBig(totalReward) + split.ValidatorNet = nonNilBig(split.ValidatorNet) + split.Commission = nonNilBig(split.Commission) + split.DelegatorsNetAfterCommission = nonNilBig(split.DelegatorsNetAfterCommission) + split.SelfStakeReward = nonNilBig(split.SelfStakeReward) + split.DelegatorRemainder = nonNilBig(split.DelegatorRemainder) + + delegatorsPaid := new(big.Int) + for _, part := range split.DelegatorParts { + if part.Amount != nil { + delegatorsPaid.Add(delegatorsPaid, part.Amount) + } + } + delegatorsNetAfterCommission := new(big.Int).Set(split.DelegatorsNetAfterCommission) + if delegatorsNetAfterCommission.Sign() == 0 { + delegatorsNetAfterCommission.Add(delegatorsPaid, split.DelegatorRemainder) + } + if new(big.Int).Sub(delegatorsNetAfterCommission, delegatorsPaid).Sign() < 0 { + return fmt.Errorf("negative delegator remainder for validator %s epoch %d", addr, epoch) + } + if split.SelfStakeReward.Sign() < 0 { + return fmt.Errorf("negative self stake reward for validator %s epoch %d", addr, epoch) + } + validatorNetCheck := new(big.Int).Add(new(big.Int).Set(split.SelfStakeReward), split.Commission) + validatorNetCheck.Add(validatorNetCheck, split.DelegatorRemainder) + if validatorNetCheck.Cmp(split.ValidatorNet) != 0 { + return fmt.Errorf("validator reward split mismatch for validator %s epoch %d: self+commission+remainder=%s validatorNet=%s", addr, epoch, validatorNetCheck, split.ValidatorNet) + } + shareCheck := new(big.Int).Add(new(big.Int).Set(split.ValidatorNet), delegatorsPaid) + if shareCheck.Cmp(totalReward) != 0 { + return fmt.Errorf("validator total reward mismatch for validator %s epoch %d: credited+delegators=%s total=%s", addr, epoch, shareCheck, totalReward) + } + + return nil +} + +func creditStakeReward(txn *state.Transition, epoch uint64, addr types.Address, split validatorRewardSplit) []posStakerRewardEvent { + split.ValidatorNet = nonNilBig(split.ValidatorNet) + // Historical reward state is consensus-observable through deterministic PosSysAddr logs, + // not permanent PosSysAddr storage. stakeSnapshot and stakeAfter let explorers prove + // eligibility and reconstruct the post-operation personal stake. + rewardEvents := make([]posStakerRewardEvent, 0, 1+len(split.DelegatorParts)) + + if split.ValidatorNet.Sign() > 0 { + curStake := new(big.Int).Set(readStakedAmount(txn, addr)) + newStake := new(big.Int).Add(new(big.Int).Set(curStake), split.ValidatorNet) + writeStakedAmount(txn, addr, newStake) + stakeSnapshot := bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakerStakeSnapshot(epoch, addr))) + rewardEvents = append(rewardEvents, posStakerRewardEvent{ + Epoch: epoch, Validator: addr, Staker: addr, Role: 1, + Amount: new(big.Int).Set(split.ValidatorNet), StakeSnapshot: stakeSnapshot, + StakeBefore: curStake, StakeAfter: newStake, + }) + } + + for _, part := range split.DelegatorParts { + if part.Amount == nil || part.Amount.Sign() == 0 { + continue + } + + curDelegatorStake := new(big.Int).Set(readStakedAmount(txn, part.Delegator)) + newDelegatorStake := new(big.Int).Add(new(big.Int).Set(curDelegatorStake), part.Amount) + writeStakedAmount(txn, part.Delegator, newDelegatorStake) + // Reward eligibility uses the epoch snapshot, while raw/active pool updates use + // current active status so future voting power reflects current live state. + addValidatorDelegatedAggregate(txn, addr, part.Amount, readStakerActive(txn, part.Delegator)) + stakeSnapshot := bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakerStakeSnapshot(epoch, part.Delegator))) + rewardEvents = append(rewardEvents, posStakerRewardEvent{ + Epoch: epoch, Validator: addr, Staker: part.Delegator, Role: 2, + Amount: new(big.Int).Set(part.Amount), StakeSnapshot: stakeSnapshot, + StakeBefore: curDelegatorStake, StakeAfter: newDelegatorStake, + }) + } + + return rewardEvents +} + +func cleanupFinalizedEpochState(txn *state.Transition, epoch uint64, validators, stakers []types.Address) { + if txn == nil || epoch == 0 { + return + } + // No ringbuffer or marker history is retained: finalized epoch working keys are deleted. + zero := types.Hash{} + for _, validator := range validators { + txn.Txn().SetState(PosSysAddr, keyProposerSlots(epoch, validator), zero) + txn.Txn().SetState(PosSysAddr, keyProposerMissed(epoch, validator), zero) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validator), zero) + txn.Txn().SetState(PosSysAddr, keyStakerStakeSnapshot(epoch, validator), zero) + txn.Txn().SetState(PosSysAddr, keySlashed(epoch, validator), zero) + txn.Txn().SetState(PosSysAddr, keySlashAmount(epoch, validator), zero) + } + uniq := make(map[types.Address]struct{}, len(stakers)+len(validators)) + for _, validator := range validators { + uniq[validator] = struct{}{} + } + for _, staker := range stakers { + uniq[staker] = struct{}{} + } + ordered := make([]types.Address, 0, len(uniq)) + for staker := range uniq { + ordered = append(ordered, staker) + } + sort.Slice(ordered, func(i, j int) bool { return bytes.Compare(ordered[i].Bytes(), ordered[j].Bytes()) < 0 }) + for _, staker := range ordered { + txn.Txn().SetState(PosSysAddr, keyStakerStakeSnapshot(epoch, staker), zero) + } + l := u64FromHash(txn.Txn().GetState(PosSysAddr, keyEpochValidatorsLen(epoch))) + for i := uint64(0); i < l && i < maxEpochValidatorsSnapshot; i++ { + txn.Txn().SetState(PosSysAddr, keyEpochValidator(epoch, i), zero) + } + txn.Txn().SetState(PosSysAddr, keyEpochValidatorsLen(epoch), zero) +} + +func readStakedAmount(txn *state.Transition, addr types.Address) *big.Int { + key := stakingAmountKey(addr) + h := txn.Txn().GetState(staking.AddrStakingContract, key) + return new(big.Int).SetBytes(h[:]) +} + +func writeStakedAmount(txn *state.Transition, addr types.Address, v *big.Int) { + key := stakingAmountKey(addr) + txn.Txn().SetState(staking.AddrStakingContract, key, bigToHash(v)) +} + +func addValidatorDelegatedAggregate(txn *state.Transition, validator types.Address, amount *big.Int, active bool) { + if amount == nil || amount.Sign() == 0 { + return + } + + // StakingV2 storage layout: + // slot 8: _validatorDelegatedStakeRaw + // slot 9: _validatorDelegatedStakeActive + for _, slot := range []int64{8, 9} { + if slot == 9 && !active { + continue + } + base := crypto.Keccak256( + common.PadLeftOrTrim(validator.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32), + ) + key := types.BytesToHash(base) + raw := txn.Txn().GetState(staking.AddrStakingContract, key) + cur := new(big.Int).SetBytes(raw[:]) + cur.Add(cur, amount) + txn.Txn().SetState(staking.AddrStakingContract, key, bigToHash(cur)) + } +} + +func reduceValidatorDelegatedAggregate(txn *state.Transition, validator types.Address, amount *big.Int, active bool) error { + if amount == nil || amount.Sign() == 0 { + return nil + } + + // StakingV2 storage layout: + // slot 8: _validatorDelegatedStakeRaw + // slot 9: _validatorDelegatedStakeActive + for _, slot := range []int64{8, 9} { + if slot == 9 && !active { + continue + } + base := crypto.Keccak256( + common.PadLeftOrTrim(validator.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32), + ) + key := types.BytesToHash(base) + raw := txn.Txn().GetState(staking.AddrStakingContract, key) + cur := new(big.Int).SetBytes(raw[:]) + if amount.Cmp(cur) > 0 { + return fmt.Errorf("delegated aggregate underflow for validator %s slot %d: have %s, need %s", validator, slot, cur, amount) + } + cur.Sub(cur, amount) + txn.Txn().SetState(staking.AddrStakingContract, key, bigToHash(cur)) + } + + return nil +} + +func stakerSlotWithOffset(addr types.Address, offset int64) types.Hash { + base := crypto.Keccak256( + common.PadLeftOrTrim(addr.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(3).Bytes(), 32), + ) + idx := new(big.Int).SetBytes(base) + idx.Add(idx, big.NewInt(offset)) + + return types.BytesToHash(idx.Bytes()) +} + +func setValidatorInactiveInStaking(txn *state.Transition, addr types.Address, blockNum uint64) { + packedKey := stakingMetaPackedKey(addr) + packedState := txn.Txn().GetState(staking.AddrStakingContract, packedKey) + packedVal := new(big.Int).SetBytes(packedState[:]) + if packedVal.Sign() == 0 { + return + } + if !isValidatorMetaActive(packedVal) { + return + } + + // ValidatorMeta packed slot layout: + // byte0: exists, byte1: active, bytes2..9: index + activeMask := new(big.Int).SetUint64(0xff) + activeMask.Lsh(activeMask, 8) + packedVal.AndNot(packedVal, activeMask) + txn.Txn().SetState(staking.AddrStakingContract, packedKey, bigToHash(packedVal)) + + poolKey := stakingPoolConfigPackedKey(addr) + poolState := txn.Txn().GetState(staking.AddrStakingContract, poolKey) + poolVal := new(big.Int).SetBytes(poolState[:]) + if poolVal.Sign() != 0 { + poolVal.AndNot(poolVal, activeMask) + txn.Txn().SetState(staking.AddrStakingContract, poolKey, bigToHash(poolVal)) + } + + txn.Txn().SetState(staking.AddrStakingContract, stakingDeactivatedAtBlockKey(addr), bigToHash(new(big.Int).SetUint64(blockNum))) +} + +func isValidatorMetaActive(packedVal *big.Int) bool { + if packedVal == nil || packedVal.Sign() == 0 { + return false + } + + activeByte := new(big.Int).Rsh(new(big.Int).Set(packedVal), 8) + activeByte.And(activeByte, new(big.Int).SetUint64(0xff)) + + return activeByte.Sign() != 0 +} + +func stakingMetaPackedKey(addr types.Address) types.Hash { + base := stakingMetaBase(addr) + return types.BytesToHash(base.Bytes()) +} + +func stakingPoolConfigPackedKey(addr types.Address) types.Hash { + base := crypto.Keccak256( + common.PadLeftOrTrim(addr.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(5).Bytes(), 32), + ) + + return types.BytesToHash(base) +} + +func stakingDeactivatedAtBlockKey(addr types.Address) types.Hash { + base := stakingMetaBase(addr) + base.Add(base, big.NewInt(3)) + return types.BytesToHash(base.Bytes()) +} + +func stakingMetaBase(addr types.Address) *big.Int { + var a [32]byte + copy(a[12:], addr.Bytes()) + + var slot [32]byte + binary.BigEndian.PutUint64(slot[24:], 3) + + return new(big.Int).SetBytes(crypto.Keccak256(a[:], slot[:])) +} + +func stakingAmountKey(addr types.Address) types.Hash { + // StakingV2 storage layout: + // slot 0: VALIDATOR_THRESHOLD + // slot 1: epochSize/minNumValidators/maxNumValidators (packed) + // slot 2: _validators dynamic array + // slot 3: mapping(address => Staker) _staker + // + // Staker.amount is the second storage slot of the struct => base + 1. + base := stakingMetaBase(addr) + base.Add(base, big.NewInt(1)) + + return types.BytesToHash(base.Bytes()) +} diff --git a/consensus/ibft/pos/finalize_epoch_rewards_test.go b/consensus/ibft/pos/finalize_epoch_rewards_test.go new file mode 100644 index 0000000..9b9736e --- /dev/null +++ b/consensus/ibft/pos/finalize_epoch_rewards_test.go @@ -0,0 +1,712 @@ +package pos + +import ( + "fmt" + "math/big" + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/chain" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/helper/common" + stakingHelper "github.com/xgr-network/xgr-node/helper/staking" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func setStakerForEpoch(t *testing.T, txn *state.Transition, epoch uint64, addr types.Address, joinedAt uint64, amount int64) { + t.Helper() + writeStakerInfo(txn, addr, true, true, joinedAt, 0, types.ZeroAddress) + txn.Txn().SetState(PosSysAddr, keyStakerStakeSnapshot(epoch, addr), bigToHash(big.NewInt(amount))) + writeStakedAmount(txn, addr, big.NewInt(amount)) +} + +func writeStakerInfo(txn *state.Transition, addr types.Address, exists bool, active bool, joinedAt uint64, deactivatedAt uint64, validator types.Address) { + flags := uint64(0) + if exists { + flags |= 1 + } + if active { + flags |= 1 << 8 + } + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 0), bigToHash(new(big.Int).SetUint64(flags))) + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 2), bigToHash(new(big.Int).SetUint64(joinedAt))) + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 3), bigToHash(new(big.Int).SetUint64(deactivatedAt))) + txn.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 4), types.BytesToHash(common.PadLeftOrTrim(validator.Bytes(), 32))) +} + +func appendValidatorStaker(txn *state.Transition, validator types.Address, staker types.Address) { + base := crypto.Keccak256(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(6).Bytes(), 32)) + baseHash := types.BytesToHash(base) + curState := txn.Txn().GetState(staking.AddrStakingContract, baseHash) + cur := new(big.Int).SetBytes(curState[:]).Uint64() + txn.Txn().SetState(staking.AddrStakingContract, baseHash, bigToHash(new(big.Int).SetUint64(cur+1))) + dataBase := crypto.Keccak256(common.PadLeftOrTrim(base, 32)) + slot := new(big.Int).Add(new(big.Int).SetBytes(dataBase), new(big.Int).SetUint64(cur)) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(slot.Bytes()), types.BytesToHash(common.PadLeftOrTrim(staker.Bytes(), 32))) +} + +func writeValidatorPoolConfig(txn *state.Transition, validator types.Address, enabled bool, maxDelegated *big.Int, minDelegatorStake *big.Int, commission uint16) { + base := crypto.Keccak256(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(5).Bytes(), 32)) + var packed uint64 + packed |= 1 + packed |= 1 << 8 + if enabled { + packed |= 1 << 16 + } + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(base), bigToHash(new(big.Int).SetUint64(packed))) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(new(big.Int).Add(new(big.Int).SetBytes(base), big.NewInt(1)).Bytes()), bigToHash(maxDelegated)) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(new(big.Int).Add(new(big.Int).SetBytes(base), big.NewInt(2)).Bytes()), bigToHash(minDelegatorStake)) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(new(big.Int).Add(new(big.Int).SetBytes(base), big.NewInt(3)).Bytes()), bigToHash(new(big.Int).SetUint64(uint64(commission)))) +} + +func newPosTestTransitionWithStakingConfig(t *testing.T, vals validators.Validators, params stakingHelper.PredeployParams) *state.Transition { + t.Helper() + + txn := newPosTestTransition(t) + contractState, err := stakingHelper.PredeployStakingSC(vals, params) + require.NoError(t, err) + require.NoError(t, txn.SetAccountDirectly(staking.AddrStakingContract, contractState)) + + return txn +} + +func setUptimeCounters(txn *state.Transition, epoch uint64, addr types.Address, slots, missed uint64) { + txn.Txn().SetState(PosSysAddr, keyProposerSlots(epoch, addr), u64ToHash(slots)) + txn.Txn().SetState(PosSysAddr, keyProposerMissed(epoch, addr), u64ToHash(missed)) +} + +func TestFinalizeEpoch_RewardSplitError_DoesNotTransferFromFeePool(t *testing.T) { + validator := types.StringToAddress("0x1636") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + setUptimeCounters(txn, epoch, validator, 10, 0) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validator), bigToHash(big.NewInt(100))) + writeStakedAmount(txn, validator, big.NewInt(100)) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(200)) + + origSplit := finalizeEpochRewardSplitFn + finalizeEpochRewardSplitFn = func(_ *state.Transition, _ uint64, _ uint64, _ types.Address, _ *big.Int) (validatorRewardSplit, error) { + return validatorRewardSplit{}, fmt.Errorf("injected split failure") + } + t.Cleanup(func() { finalizeEpochRewardSplitFn = origSplit }) + + preFeePool := new(big.Int).Set(txn.Txn().GetBalance(state.FeePoolAddress)) + preStakingBal := new(big.Int).Set(txn.Txn().GetBalance(staking.AddrStakingContract)) + + err := FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn) + require.Error(t, err) + require.Contains(t, err.Error(), "injected split failure") + + require.Equal(t, preFeePool.String(), txn.Txn().GetBalance(state.FeePoolAddress).String()) + require.Equal(t, preStakingBal.String(), txn.Txn().GetBalance(staking.AddrStakingContract).String()) + require.Equal(t, int64(100), readStakedAmount(txn, validator).Int64()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyRewardTotal(epoch))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, validator))).Sign()) +} + +func TestFinalizeEpoch_RewardSplitError_SecondValidator_DoesNotMutateFirstValidator(t *testing.T) { + v1 := types.StringToAddress("0x1638") + v2 := types.StringToAddress("0x1639") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v1), validators.NewECDSAValidator(v2)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + setUptimeCounters(txn, epoch, v1, 10, 0) + setUptimeCounters(txn, epoch, v2, 10, 0) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v1), bigToHash(big.NewInt(100))) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v2), bigToHash(big.NewInt(100))) + writeStakedAmount(txn, v1, big.NewInt(100)) + writeStakedAmount(txn, v2, big.NewInt(100)) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(200)) + + origSplit := finalizeEpochRewardSplitFn + finalizeEpochRewardSplitFn = func(_ *state.Transition, _ uint64, _ uint64, validator types.Address, reward *big.Int) (validatorRewardSplit, error) { + if validator == v2 { + return validatorRewardSplit{}, fmt.Errorf("injected split failure on second validator") + } + return validatorRewardSplit{ValidatorNet: new(big.Int).Set(reward), Commission: new(big.Int), DelegatorsNet: new(big.Int), DelegatorsNetAfterCommission: new(big.Int), SelfStakeReward: new(big.Int).Set(reward), DelegatorRemainder: new(big.Int)}, nil + } + t.Cleanup(func() { finalizeEpochRewardSplitFn = origSplit }) + + preFeePool := new(big.Int).Set(txn.Txn().GetBalance(state.FeePoolAddress)) + preStakingBal := new(big.Int).Set(txn.Txn().GetBalance(staking.AddrStakingContract)) + + err := FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn) + require.Error(t, err) + require.Contains(t, err.Error(), "injected split failure on second validator") + + require.Equal(t, preFeePool.String(), txn.Txn().GetBalance(state.FeePoolAddress).String()) + require.Equal(t, preStakingBal.String(), txn.Txn().GetBalance(staking.AddrStakingContract).String()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyRewardTotal(epoch))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, v1))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, v2))).Sign()) + require.Equal(t, int64(100), readStakedAmount(txn, v1).Int64()) + require.Equal(t, int64(100), readStakedAmount(txn, v2).Int64()) +} + +func TestFinalizeEpoch_DelegatorWithoutSnapshotDoesNotGetRewardAndDoesNotCrash(t *testing.T) { + v := types.StringToAddress("0x1701") + d := types.StringToAddress("0x1702") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + epoch := uint64(2) + reward := big.NewInt(100) + + writeStakerInfo(txn, v, true, true, 1, 0, types.ZeroAddress) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v), bigToHash(big.NewInt(100))) + setStakerForEpoch(t, txn, epoch, v, 1, 100) + writeStakerInfo(txn, d, true, true, 5, 0, v) // live active, but no epoch snapshot on purpose + writeStakedAmount(txn, d, big.NewInt(50)) + appendValidatorStaker(txn, v, d) + + split, err := splitValidatorRewardByDelegation(txn, 19, 10, v, reward) + require.NoError(t, err) + require.Equal(t, "100", split.ValidatorNet.String()) + require.Zero(t, split.Commission.Sign()) + require.Zero(t, split.DelegatorsNet.Sign()) + require.Empty(t, split.DelegatorParts) +} + +func TestFinalizeEpoch_DelegatorFromPreviousEpochGetsReward(t *testing.T) { + v := types.StringToAddress("0x1703") + d := types.StringToAddress("0x1704") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + epoch := uint64(2) + + writeStakerInfo(txn, v, true, true, 1, 0, types.ZeroAddress) + setStakerForEpoch(t, txn, epoch, v, 1, 100) + setStakerForEpoch(t, txn, epoch, d, 8, 100) + appendValidatorStaker(txn, v, d) + + split, err := splitValidatorRewardByDelegation(txn, 19, 10, v, big.NewInt(100)) + require.NoError(t, err) + require.Equal(t, "50", split.ValidatorNet.String()) + require.Equal(t, "50", split.DelegatorsNet.String()) + require.Len(t, split.DelegatorParts, 1) + require.Equal(t, d, split.DelegatorParts[0].Delegator) + require.Equal(t, "50", split.DelegatorParts[0].Amount.String()) +} + +func TestFinalizeEpoch_ReadValidatorEffectiveDelegationsAt_UsesSnapshotOnly(t *testing.T) { + v := types.StringToAddress("0x1710") + withSnapshot := types.StringToAddress("0x1711") + noSnapshot := types.StringToAddress("0x1712") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + epoch := uint64(2) + + setStakerForEpoch(t, txn, epoch, v, 1, 100) + setStakerForEpoch(t, txn, epoch, withSnapshot, 1, 40) + writeStakerInfo(txn, noSnapshot, true, true, 1, 0, v) + writeStakedAmount(txn, noSnapshot, big.NewInt(60)) + appendValidatorStaker(txn, v, withSnapshot) + appendValidatorStaker(txn, v, noSnapshot) + + delegations, err := readValidatorEffectiveDelegationsAt(txn, epoch, v, 19, 10) + require.NoError(t, err) + require.Len(t, delegations, 1) + require.Equal(t, withSnapshot, delegations[0].Delegator) + require.Equal(t, "40", delegations[0].Amount.String()) +} + +func TestFinalizeEpoch_DelegatorRewardHonorsCommission(t *testing.T) { + v := types.StringToAddress("0x1705") + d := types.StringToAddress("0x1706") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + epoch := uint64(2) + + minDelegatorStake := big.NewInt(7777) + commissionBps := uint16(1000) + require.NotZero(t, minDelegatorStake.Sign()) + require.NotEqual(t, minDelegatorStake.Uint64(), uint64(commissionBps)) + writeValidatorPoolConfig(txn, v, true, big.NewInt(1000), minDelegatorStake, commissionBps) // 10% + setStakerForEpoch(t, txn, epoch, v, 1, 100) + setStakerForEpoch(t, txn, epoch, d, 8, 100) + appendValidatorStaker(txn, v, d) + + split, err := splitValidatorRewardByDelegation(txn, 19, 10, v, big.NewInt(100)) + require.NoError(t, err) + require.Equal(t, "55", split.ValidatorNet.String()) // self 50 + commission 5 + require.Equal(t, "5", split.Commission.String()) + require.Equal(t, "45", split.DelegatorsNet.String()) + require.Len(t, split.DelegatorParts, 1) + require.Equal(t, "45", split.DelegatorParts[0].Amount.String()) +} + +func TestFinalizeEpoch_CommissionUsesCurrentPoolConfigSlot(t *testing.T) { + v := types.StringToAddress("0x1713") + d := types.StringToAddress("0x1714") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + + minDelegatorStake := big.NewInt(7777) + commissionBps := uint16(1000) + require.NotZero(t, minDelegatorStake.Sign()) + require.NotEqual(t, minDelegatorStake.Uint64(), uint64(commissionBps)) + writeValidatorPoolConfig(txn, v, true, big.NewInt(1000), minDelegatorStake, commissionBps) + setStakerForEpoch(t, txn, epoch, v, 1, 100) + setStakerForEpoch(t, txn, epoch, d, 8, 100) + appendValidatorStaker(txn, v, d) + setUptimeCounters(txn, epoch, v, 10, 0) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v), bigToHash(big.NewInt(200))) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(100)) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, v))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorCommissionReward(epoch, v))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorDelegatorsRewardTotal(epoch, v))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyDelegatorReward(epoch, v, d))).Sign()) + require.Equal(t, "155", readStakedAmount(txn, v).String()) + require.Equal(t, "145", readStakedAmount(txn, d).String()) +} + +func writeValidatorDelegatedAggregateForRewardTest(txn *state.Transition, validator types.Address, raw, active *big.Int) { + for slot, amount := range map[int64]*big.Int{8: raw, 9: active} { + base := crypto.Keccak256(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32)) + txn.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(base), bigToHash(amount)) + } +} + +func readValidatorDelegatedAggregateForRewardTest(txn *state.Transition, validator types.Address, slot int64) *big.Int { + base := crypto.Keccak256(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32)) + h := txn.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(base)) + return new(big.Int).SetBytes(h[:]) +} + +func TestFinalizeEpoch_SlashingAndRewards_AccountingOrderAndConservation(t *testing.T) { + validatorA := types.StringToAddress("0x1721") + validatorB := types.StringToAddress("0x1722") + delegatorA := types.StringToAddress("0x1723") + delegatorB := types.StringToAddress("0x1724") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validatorA), validators.NewECDSAValidator(validatorB)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + + writeValidatorPoolConfig(txn, validatorB, true, big.NewInt(10_000), big.NewInt(1), 1_000) + writeStakerInfo(txn, validatorA, true, true, 1, 0, validatorA) + writeStakerInfo(txn, validatorB, true, true, 1, 0, validatorB) + setStakerForEpoch(t, txn, epoch, validatorA, 1, 1_000) + setStakerForEpoch(t, txn, epoch, delegatorA, 1, 500) + setStakerForEpoch(t, txn, epoch, validatorB, 1, 2_000) + setStakerForEpoch(t, txn, epoch, delegatorB, 1, 1_000) + appendValidatorStaker(txn, validatorA, validatorA) + appendValidatorStaker(txn, validatorA, delegatorA) + appendValidatorStaker(txn, validatorB, validatorB) + appendValidatorStaker(txn, validatorB, delegatorB) + writeValidatorDelegatedAggregateForRewardTest(txn, validatorA, big.NewInt(500), big.NewInt(500)) + writeValidatorDelegatedAggregateForRewardTest(txn, validatorB, big.NewInt(1_000), big.NewInt(1_000)) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validatorA), bigToHash(big.NewInt(1_500))) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validatorB), bigToHash(big.NewInt(3_000))) + setUptimeCounters(txn, epoch, validatorA, 1, 1) + setUptimeCounters(txn, epoch, validatorB, 1, 0) + txn.Txn().SetBalance(staking.AddrStakingContract, big.NewInt(4_500)) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(900)) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keySlashed(epoch, validatorA))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keySlashAmount(epoch, validatorA))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, validatorA))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, validatorB))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorCommissionReward(epoch, validatorB))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorDelegatorsRewardTotal(epoch, validatorB))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyDelegatorReward(epoch, validatorB, delegatorB))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyRewardTotal(epoch))).Sign()) + require.Equal(t, "0", txn.Txn().GetBalance(state.FeePoolAddress).String()) + require.Equal(t, "990", readStakedAmount(txn, validatorA).String()) + require.Equal(t, "495", readStakedAmount(txn, delegatorA).String()) + require.Equal(t, "2630", readStakedAmount(txn, validatorB).String()) + require.Equal(t, "1270", readStakedAmount(txn, delegatorB).String()) + require.Equal(t, "495", readValidatorDelegatedAggregateForRewardTest(txn, validatorA, 8).String()) + require.Equal(t, "495", readValidatorDelegatedAggregateForRewardTest(txn, validatorA, 9).String()) + require.Equal(t, "1270", readValidatorDelegatedAggregateForRewardTest(txn, validatorB, 8).String()) + require.Equal(t, "1270", readValidatorDelegatedAggregateForRewardTest(txn, validatorB, 9).String()) + require.Equal(t, "5385", txn.Txn().GetBalance(staking.AddrStakingContract).String()) + require.Equal(t, "0", txn.Txn().GetBalance(state.FeePoolAddress).String()) +} + +func TestFinalizeEpoch_FiveValidatorsEqualStakeEqualUptime_EqualRewardsAndFinalStake(t *testing.T) { + v1 := types.StringToAddress("0x1801") + v2 := types.StringToAddress("0x1802") + v3 := types.StringToAddress("0x1803") + v4 := types.StringToAddress("0x1804") + v5 := types.StringToAddress("0x1805") + vals := []types.Address{v1, v2, v3, v4, v5} + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v1), validators.NewECDSAValidator(v2), validators.NewECDSAValidator(v3), validators.NewECDSAValidator(v4), validators.NewECDSAValidator(v5)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + + stake := int64(2_000_000) + for _, v := range vals { + setUptimeCounters(txn, epoch, v, 10, 0) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v), bigToHash(big.NewInt(stake))) + txn.Txn().SetState(PosSysAddr, keyStakerStakeSnapshot(epoch, v), bigToHash(big.NewInt(stake))) + writeStakedAmount(txn, v, big.NewInt(stake)) + } + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(1_000_000)) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + + for _, v := range vals { + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, v))).Sign()) + require.Equal(t, int64(2_200_000), readStakedAmount(txn, v).Int64()) + } + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyRewardTotal(epoch))).Sign()) + require.Equal(t, int64(0), txn.Txn().GetBalance(state.FeePoolAddress).Int64()) +} + +func TestFinalizeEpoch_FiveValidators_MissedZeroRewardsIndependentOfSlots(t *testing.T) { + v1 := types.StringToAddress("0x1901") + v2 := types.StringToAddress("0x1902") + v3 := types.StringToAddress("0x1903") + v4 := types.StringToAddress("0x1904") + v5 := types.StringToAddress("0x1905") + vals := []types.Address{v1, v2, v3, v4, v5} + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v1), validators.NewECDSAValidator(v2), validators.NewECDSAValidator(v3), validators.NewECDSAValidator(v4), validators.NewECDSAValidator(v5)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + + stake := int64(2_000_000) + slotsByVal := map[types.Address]uint64{v1: 1, v2: 2, v3: 5, v4: 10, v5: 20} + for _, v := range vals { + setUptimeCounters(txn, epoch, v, slotsByVal[v], 0) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v), bigToHash(big.NewInt(stake))) + txn.Txn().SetState(PosSysAddr, keyStakerStakeSnapshot(epoch, v), bigToHash(big.NewInt(stake))) + writeStakedAmount(txn, v, big.NewInt(stake)) + } + header := makeFinalizeHeader(20, 10, set) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(1_000_000)) + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + + firstReward := bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, v1))) + firstFinalStake := readStakedAmount(txn, v1) + for _, v := range vals { + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerMissed(epoch, v)))) + require.Equal(t, firstReward.String(), bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, v))).String()) + require.Equal(t, firstFinalStake.String(), readStakedAmount(txn, v).String()) + } +} + +func TestFinalizeEpoch_MissedSlotsCauseExplainedRewardDifference(t *testing.T) { + v1 := types.StringToAddress("0x1a01") + v2 := types.StringToAddress("0x1a02") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v1), validators.NewECDSAValidator(v2)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + for _, v := range []types.Address{v1, v2} { + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v), bigToHash(big.NewInt(2_000_000))) + txn.Txn().SetState(PosSysAddr, keyStakerStakeSnapshot(epoch, v), bigToHash(big.NewInt(2_000_000))) + writeStakedAmount(txn, v, big.NewInt(2_000_000)) + } + setUptimeCounters(txn, epoch, v1, 10, 0) + setUptimeCounters(txn, epoch, v2, 10, 2) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(1_000_000)) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + require.True(t, readStakedAmount(txn, v1).Cmp(readStakedAmount(txn, v2)) > 0) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch, v1)))) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch, v2)))) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerMissed(epoch, v1)))) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerMissed(epoch, v2)))) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakeSnapshot(epoch, v1))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakeSnapshot(epoch, v2))).Sign()) + require.Equal(t, int64(1), txn.Txn().GetBalance(state.FeePoolAddress).Int64()) +} + +func TestFinalizeEpoch_EmitsDeterministicPosSystemLogsAndClearsHistoryState(t *testing.T) { + validatorA := types.StringToAddress("0x2721") + validatorB := types.StringToAddress("0x2722") + delegatorA := types.StringToAddress("0x2723") + delegatorB := types.StringToAddress("0x2724") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validatorA), validators.NewECDSAValidator(validatorB)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + + writeValidatorPoolConfig(txn, validatorB, true, big.NewInt(10_000), big.NewInt(1), 1_000) + writeStakerInfo(txn, validatorA, true, true, 1, 0, validatorA) + writeStakerInfo(txn, validatorB, true, true, 1, 0, validatorB) + setStakerForEpoch(t, txn, epoch, validatorA, 1, 1_000) + setStakerForEpoch(t, txn, epoch, delegatorA, 1, 500) + setStakerForEpoch(t, txn, epoch, validatorB, 1, 2_000) + setStakerForEpoch(t, txn, epoch, delegatorB, 1, 1_000) + appendValidatorStaker(txn, validatorA, validatorA) + appendValidatorStaker(txn, validatorA, delegatorA) + appendValidatorStaker(txn, validatorB, validatorB) + appendValidatorStaker(txn, validatorB, delegatorB) + writeValidatorDelegatedAggregateForRewardTest(txn, validatorA, big.NewInt(500), big.NewInt(500)) + writeValidatorDelegatedAggregateForRewardTest(txn, validatorB, big.NewInt(1_000), big.NewInt(1_000)) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validatorA), bigToHash(big.NewInt(1_500))) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validatorB), bigToHash(big.NewInt(3_000))) + setUptimeCounters(txn, epoch, validatorA, 1, 1) + setUptimeCounters(txn, epoch, validatorB, 1, 0) + txn.Txn().SetBalance(staking.AddrStakingContract, big.NewInt(4_500)) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(900)) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + + logs := txn.Txn().Logs() + require.Len(t, logs, 7) + for _, log := range logs { + require.Equal(t, PosSysAddr, log.Address) + } + require.Equal(t, posEventEpochFinalizedTopic, logs[0].Topics[0]) + require.Equal(t, posEventValidatorUptimeFinalizedTopic, logs[1].Topics[0]) + require.Equal(t, posEventValidatorUptimeFinalizedTopic, logs[2].Topics[0]) + require.Equal(t, posEventStakerRewardedTopic, logs[3].Topics[0]) + require.Equal(t, posEventStakerRewardedTopic, logs[4].Topics[0]) + require.Equal(t, posEventStakerSlashedTopic, logs[5].Topics[0]) + require.Equal(t, posEventStakerSlashedTopic, logs[6].Topics[0]) + + word := func(data []byte, idx int) *big.Int { return new(big.Int).SetBytes(data[idx*32 : (idx+1)*32]) } + require.Equal(t, "900", word(logs[0].Data, 0).String()) // poolBalanceBefore + require.Equal(t, "900", word(logs[0].Data, 1).String()) // totalDistributed + require.Equal(t, "0", word(logs[0].Data, 2).String()) // poolRemainder + require.Equal(t, "15", word(logs[0].Data, 3).String()) // totalSlashed + require.Equal(t, "1", word(logs[0].Data, 4).String()) // activeValidators + + require.Equal(t, abiHashAddress(validatorA), logs[1].Topics[2]) + require.Equal(t, "1", word(logs[1].Data, 0).String()) // slots + require.Equal(t, "1", word(logs[1].Data, 1).String()) // missed + require.Equal(t, "0", word(logs[1].Data, 2).String()) // uptimeBps + require.Equal(t, "0", word(logs[1].Data, 3).String()) // effectiveWeight + require.Equal(t, "1500", word(logs[1].Data, 4).String()) // stakeSnapshot + require.Equal(t, "0", word(logs[1].Data, 5).String()) // rewardEligible + require.Equal(t, "1", word(logs[1].Data, 6).String()) // slashed + + require.Equal(t, abiHashAddress(validatorB), logs[2].Topics[2]) + require.Equal(t, "1", word(logs[2].Data, 0).String()) // slots + require.Equal(t, "0", word(logs[2].Data, 1).String()) // missed + require.Equal(t, "10000", word(logs[2].Data, 2).String()) // uptimeBps + require.Equal(t, "3000", word(logs[2].Data, 3).String()) // effectiveWeight + require.Equal(t, "3000", word(logs[2].Data, 4).String()) // stakeSnapshot + require.Equal(t, "1", word(logs[2].Data, 5).String()) // rewardEligible + require.Equal(t, "0", word(logs[2].Data, 6).String()) // slashed + + require.Equal(t, abiHashAddress(validatorB), logs[3].Topics[2]) + require.Equal(t, abiHashAddress(validatorB), logs[3].Topics[3]) + require.Equal(t, "1", word(logs[3].Data, 0).String()) // validator role + require.Equal(t, "630", word(logs[3].Data, 1).String()) // amount + require.Equal(t, "2000", word(logs[3].Data, 2).String()) // stakeSnapshot + require.Equal(t, "2000", word(logs[3].Data, 3).String()) // stakeBefore + require.Equal(t, "2630", word(logs[3].Data, 4).String()) // stakeAfter + + require.Equal(t, abiHashAddress(validatorB), logs[4].Topics[2]) + require.Equal(t, abiHashAddress(delegatorB), logs[4].Topics[3]) + require.Equal(t, "2", word(logs[4].Data, 0).String()) // delegator role + require.Equal(t, "270", word(logs[4].Data, 1).String()) // amount + require.Equal(t, "1000", word(logs[4].Data, 2).String()) // stakeSnapshot + require.Equal(t, "1000", word(logs[4].Data, 3).String()) // stakeBefore + require.Equal(t, "1270", word(logs[4].Data, 4).String()) // stakeAfter + + require.Equal(t, abiHashAddress(validatorA), logs[5].Topics[2]) + require.Equal(t, abiHashAddress(validatorA), logs[5].Topics[3]) + require.Equal(t, "1", word(logs[5].Data, 0).String()) // validator role + require.Equal(t, "10", word(logs[5].Data, 1).String()) // slash amount + require.Equal(t, "1000", word(logs[5].Data, 2).String()) // stakeSnapshot + require.Equal(t, "1000", word(logs[5].Data, 3).String()) // stakeBefore + require.Equal(t, "990", word(logs[5].Data, 4).String()) // stakeAfter + require.Equal(t, "1", word(logs[5].Data, 5).String()) // slots + require.Equal(t, "1", word(logs[5].Data, 6).String()) // missed + require.Equal(t, "100", word(logs[5].Data, 7).String()) // slashBps + require.Equal(t, abiWordAddress(chain.DefaultBurnedAddress), logs[5].Data[8*32:9*32]) + + require.Equal(t, abiHashAddress(validatorA), logs[6].Topics[2]) + require.Equal(t, abiHashAddress(delegatorA), logs[6].Topics[3]) + require.Equal(t, "2", word(logs[6].Data, 0).String()) // delegator role + require.Equal(t, "5", word(logs[6].Data, 1).String()) // slash amount + require.Equal(t, "500", word(logs[6].Data, 2).String()) // stakeSnapshot + require.Equal(t, "500", word(logs[6].Data, 3).String()) // stakeBefore + require.Equal(t, "495", word(logs[6].Data, 4).String()) // stakeAfter + require.Equal(t, "1", word(logs[6].Data, 5).String()) // slots + require.Equal(t, "1", word(logs[6].Data, 6).String()) // missed + require.Equal(t, "100", word(logs[6].Data, 7).String()) // slashBps + require.Equal(t, abiWordAddress(chain.DefaultBurnedAddress), logs[6].Data[8*32:9*32]) + + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyRewardTotal(epoch))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyValidatorReward(epoch, validatorB))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyDelegatorReward(epoch, validatorB, delegatorB))).Sign()) + require.Zero(t, u64FromHash(txn.Txn().GetState(PosSysAddr, keyEpochValidatorsLen(epoch)))) + require.Zero(t, u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch, validatorB)))) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakeSnapshot(epoch, validatorA))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakerStakeSnapshot(epoch, delegatorB))).Sign()) +} + +func TestFinalizeEpoch_ValidatorUptimeFinalized_EmitsAllValidatorsWithoutRewardsOrSlash(t *testing.T) { + v1 := types.StringToAddress("0x2a01") + v2 := types.StringToAddress("0x2a02") + v3 := types.StringToAddress("0x2a03") + v4 := types.StringToAddress("0x2a04") + set := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(v1), + validators.NewECDSAValidator(v2), + validators.NewECDSAValidator(v3), + validators.NewECDSAValidator(v4), + ) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + + for _, v := range []types.Address{v1, v2, v3, v4} { + writeStakerInfo(txn, v, true, true, 1, 0, v) + writeStakedAmount(txn, v, big.NewInt(900)) + } + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v1), bigToHash(big.NewInt(900))) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v2), bigToHash(big.NewInt(900))) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v3), bigToHash(big.NewInt(900))) + setUptimeCounters(txn, epoch, v1, 10, 0) + setUptimeCounters(txn, epoch, v2, 10, 2) + setUptimeCounters(txn, epoch, v3, 10, 3) + setUptimeCounters(txn, epoch, v4, 0, 0) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(0)) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + + logs := txn.Txn().Logs() + require.Len(t, logs, 5) + require.Equal(t, posEventEpochFinalizedTopic, logs[0].Topics[0]) + for i, v := range []types.Address{v1, v2, v3, v4} { + log := logs[i+1] + require.Equal(t, PosSysAddr, log.Address) + require.Equal(t, posEventValidatorUptimeFinalizedTopic, log.Topics[0]) + require.Equal(t, abiHashU64(epoch), log.Topics[1]) + require.Equal(t, abiHashAddress(v), log.Topics[2]) + } + + word := func(data []byte, idx int) *big.Int { return new(big.Int).SetBytes(data[idx*32 : (idx+1)*32]) } + assertUptime := func(logIdx int, slots, missed, uptimeBps, effectiveWeight, stakeSnapshot uint64, rewardEligible, slashed bool) { + t.Helper() + log := logs[logIdx] + require.Equal(t, new(big.Int).SetUint64(slots).String(), word(log.Data, 0).String()) + require.Equal(t, new(big.Int).SetUint64(missed).String(), word(log.Data, 1).String()) + require.Equal(t, new(big.Int).SetUint64(uptimeBps).String(), word(log.Data, 2).String()) + require.Equal(t, new(big.Int).SetUint64(effectiveWeight).String(), word(log.Data, 3).String()) + require.Equal(t, new(big.Int).SetUint64(stakeSnapshot).String(), word(log.Data, 4).String()) + if rewardEligible { + require.Equal(t, "1", word(log.Data, 5).String()) + } else { + require.Equal(t, "0", word(log.Data, 5).String()) + } + if slashed { + require.Equal(t, "1", word(log.Data, 6).String()) + } else { + require.Equal(t, "0", word(log.Data, 6).String()) + } + } + assertUptime(1, 10, 0, 10_000, 900, 900, true, false) + assertUptime(2, 10, 2, 8_000, 800, 900, true, false) + assertUptime(3, 10, 3, 7_000, 0, 900, false, false) + assertUptime(4, 0, 0, 0, 0, 0, false, false) + + for _, v := range []types.Address{v1, v2, v3, v4} { + require.Zero(t, u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch, v)))) + require.Zero(t, u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerMissed(epoch, v)))) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakeSnapshot(epoch, v))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keySlashed(epoch, v))).Sign()) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keySlashAmount(epoch, v))).Sign()) + } + require.Zero(t, u64FromHash(txn.Txn().GetState(PosSysAddr, keyEpochValidatorsLen(epoch)))) +} + +func TestFinalizeEpoch_NonPayableDoesNotEmitPosSystemLogs(t *testing.T) { + validator := types.StringToAddress("0x2821") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + setStakerForEpoch(t, txn, epoch, validator, 1, 1_000) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validator), bigToHash(big.NewInt(1_000))) + setUptimeCounters(txn, epoch, validator, 1, 0) + txn.SetNonPayable(true) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + require.Empty(t, txn.Txn().Logs()) +} + +func TestFinalizeEpoch_ClearsZeroRewardDelegatorSnapshot(t *testing.T) { + validator := types.StringToAddress("0x2921") + delegator := types.StringToAddress("0x2922") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + requireSnapshotCreated(t, txn, epoch, set) + + setStakerForEpoch(t, txn, epoch, validator, 1, 100) + setStakerForEpoch(t, txn, epoch, delegator, 1, 50) + appendValidatorStaker(txn, validator, delegator) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validator), bigToHash(big.NewInt(150))) + setUptimeCounters(txn, epoch, validator, 1, 0) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(0)) + + require.NotZero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakerStakeSnapshot(epoch, delegator))).Sign()) + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + require.Zero(t, bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakerStakeSnapshot(epoch, delegator))).Sign()) +} + +func TestFinalizeEpochLogsPersistInSystemReceipt(t *testing.T) { + validator := types.StringToAddress("0x17f1") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + txn := newPosTestTransitionWithStakingConfig(t, set, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + header := makeFinalizeHeader(20, 10, set) + epoch := uint64(2) + receiptTx := EpochFinalizationSystemTx(header.Number) + + requireSnapshotCreated(t, txn, epoch, set) + setUptimeCounters(txn, epoch, validator, 10, 0) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validator), bigToHash(big.NewInt(100))) + txn.Txn().SetState(PosSysAddr, keyStakerStakeSnapshot(epoch, validator), bigToHash(big.NewInt(100))) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(10)) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + require.NoError(t, txn.WriteSystemReceipt(receiptTx)) + require.Empty(t, txn.Txn().Logs(), "system logs must be drained into the receipt") + + receipts := txn.Receipts() + require.Len(t, receipts, 1) + require.Equal(t, receiptTx.Hash, receipts[0].TxHash) + require.Equal(t, types.StateTx, receipts[0].TransactionType) + require.NotEmpty(t, receipts[0].Logs) + require.Equal(t, posEventEpochFinalizedTopic, receipts[0].Logs[0].Topics[0]) + + var foundUptime bool + for _, log := range receipts[0].Logs { + require.Equal(t, PosSysAddr, log.Address) + require.Equal(t, receiptTx.Hash, log.TxHash) + require.Equal(t, uint64(0), log.BlockNumber) + if log.Topics[0] == posEventValidatorUptimeFinalizedTopic { + foundUptime = true + } + } + require.True(t, foundUptime, "ValidatorUptimeFinalized log must be persisted in receipt logs") + require.NotEqual(t, types.Bloom{}, receipts[0].LogsBloom) + for _, log := range receipts[0].Logs { + require.True(t, receipts[0].LogsBloom.IsLogInBloom(log), "receipt bloom must include PosSysAddr finalization logs") + } +} diff --git a/consensus/ibft/pos/finalize_epoch_test.go b/consensus/ibft/pos/finalize_epoch_test.go new file mode 100644 index 0000000..0f4eb18 --- /dev/null +++ b/consensus/ibft/pos/finalize_epoch_test.go @@ -0,0 +1,203 @@ +package pos + +import ( + "errors" + "math/big" + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" + contractstore "github.com/xgr-network/xgr-node/validators/store/contract" +) + +func makeFinalizeHeader(number uint64, epochSize uint64, set validators.Validators) *types.Header { + extra := &signer.IstanbulExtra{ + Validators: set, + CommittedSeals: &signer.SerializedSeal{}, + ParentCommittedSeals: &signer.SerializedSeal{}, + } + + return &types.Header{ + Number: number, + Timestamp: number * epochSize, + ExtraData: extra.MarshalRLPTo(make([]byte, signer.IstanbulExtraVanity)), + } +} + +func TestFinalizeEpoch_ZeroSlotsDoesNotDeactivateValidator(t *testing.T) { + t.Parallel() + + validator := types.StringToAddress("0xabc1") + txn := newPosTestTransitionWithStaking(t, validator) + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + header := makeFinalizeHeader(20, 10, set) + epoch := epochOf(header.Number-1, 10) + requireSnapshotCreated(t, txn, epoch, set) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + + packed := txn.Txn().GetState(staking.AddrStakingContract, stakingMetaPackedKey(validator)) + require.True(t, isValidatorMetaActive(bigFromHash(packed))) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingDeactivatedAtBlockKey(validator)))) +} + +func TestFinalizeEpoch_DeactivatedAtBlockIsIdempotent(t *testing.T) { + t.Parallel() + + validator := types.StringToAddress("0xabc2") + txn := newPosTestTransitionWithStaking(t, validator) + + setValidatorInactiveInStaking(txn, validator, 100) + require.Equal(t, uint64(100), u64FromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingDeactivatedAtBlockKey(validator)))) + + setValidatorInactiveInStaking(txn, validator, 200) + require.Equal(t, uint64(100), u64FromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingDeactivatedAtBlockKey(validator)))) +} + +func TestFinalizeEpoch_ReturnsErrorOnDecodeFailure(t *testing.T) { + validator := types.StringToAddress("0xabc3") + txn := newPosTestTransitionWithStaking(t, validator) + header := &types.Header{ + Number: 20, + Timestamp: 200, + ExtraData: []byte{0x1, 0x2, 0x3}, + } + + err := FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn) + require.Error(t, err) +} + +func TestFinalizeEpoch_ReturnsErrorOnEmptyValidators(t *testing.T) { + validator := types.StringToAddress("0xabc4") + txn := newPosTestTransitionWithStaking(t, validator) + header := makeFinalizeHeader(20, 10, validators.NewECDSAValidatorSet()) + + err := FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn) + require.Error(t, err) +} + +func TestFinalizeEpoch_ReturnsErrorOnMissingEpochValidatorSnapshot(t *testing.T) { + validator := types.StringToAddress("0xabca") + txn := newPosTestTransitionWithStaking(t, validator) + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + header := makeFinalizeHeader(20, 10, set) + txn.Txn().SetState(PosSysAddr, keyUptimeLastProcessedSlot(), u64ToHash(header.Number-1)) + + err := FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn) + require.Error(t, err) + require.Contains(t, err.Error(), "missing epoch validator snapshot for epoch 2") +} + +func TestFinalizeEpoch_MissingSnapshotForPrePoSEpochAtCutoverBoundaryErrors(t *testing.T) { + t.Parallel() + + validator := types.StringToAddress("0xabcb") + txn := newPosTestTransitionWithStaking(t, validator) + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + header := makeFinalizeHeader(50, 50, set) + + require.Error(t, FinalizeEpoch(header, 50, UptimeConfig{}, testHeaderSigner(), txn)) +} + +func TestFinalizeEpoch_DoesNotSkipMissingSnapshotOutsideMigrationCase(t *testing.T) { + t.Parallel() + + validator := types.StringToAddress("0xabcc") + txn := newPosTestTransitionWithStaking(t, validator) + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + header := makeFinalizeHeader(150, 50, set) + + err := FinalizeEpoch(header, 50, UptimeConfig{}, testHeaderSigner(), txn) + require.Error(t, err) + require.Contains(t, err.Error(), "missing epoch validator snapshot for epoch 3") +} + +func TestFinalizeEpoch_ReturnsErrorOnRewardTransferFailure(t *testing.T) { + validator := types.StringToAddress("0xabc5") + txn := newPosTestTransitionWithStaking(t, validator) + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + header := makeFinalizeHeader(20, 10, set) + epoch := epochOf(header.Number-1, 10) + requireSnapshotCreated(t, txn, epoch, set) + originalStake := new(big.Int).Set(readStakedAmount(txn, validator)) + + txn.Txn().SetState(PosSysAddr, keyProposerSlots(epoch, validator), u64ToHash(1)) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, validator), bigToHash(big.NewInt(100))) + txn.Txn().SetBalance(state.FeePoolAddress, big.NewInt(100)) + + origTransfer := posTransferFn + posTransferFn = func(txn *state.Transition, from, to types.Address, amount *big.Int) error { + if from == state.FeePoolAddress && to == staking.AddrStakingContract { + return errors.New("injected transfer failure") + } + return origTransfer(txn, from, to, amount) + } + defer func() { + posTransferFn = origTransfer + }() + + err := FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn) + require.Error(t, err) + require.Equal(t, 0, readStakedAmount(txn, validator).Cmp(originalStake)) +} + +func TestFinalizeEpoch_ZeroUptimeMarksValidatorInactiveAndFetcherExcludesFromEligiblePath(t *testing.T) { + v1 := types.StringToAddress("0xabc6") + v2 := types.StringToAddress("0xabc7") + set := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(v1), + validators.NewECDSAValidator(v2), + ) + txn := newPosTestTransitionWithStakingValidatorsAtBlock(t, set, 1, 10, 21) + header := makeFinalizeHeader(20, 10, set) + epoch := epochOf(header.Number-1, 10) + requireSnapshotCreated(t, txn, epoch, set) + + // Ensure both pass strict threshold before uptime filtering in finalize (values in wei). + wei := big.NewInt(1_000_000_000_000_000_000) + highStakeWei := new(big.Int).Mul(big.NewInt(3_000_000), wei) // 3,000,000 XGR + writeStakedAmount(txn, v1, highStakeWei) + writeStakedAmount(txn, v2, highStakeWei) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v1), bigToHash(highStakeWei)) + txn.Txn().SetState(PosSysAddr, keyStakeSnapshot(epoch, v2), bigToHash(highStakeWei)) + txn.Txn().SetState(PosSysAddr, keyStakerStakeSnapshot(epoch, v1), bigToHash(highStakeWei)) + txn.Txn().SetState(PosSysAddr, keyStakerStakeSnapshot(epoch, v2), bigToHash(highStakeWei)) + + // v1 has zero uptime for this epoch; v2 is healthy. + txn.Txn().SetState(PosSysAddr, keyProposerSlots(epoch, v1), u64ToHash(1)) + txn.Txn().SetState(PosSysAddr, keyProposerMissed(epoch, v1), u64ToHash(1)) + txn.Txn().SetState(PosSysAddr, keyProposerSlots(epoch, v2), u64ToHash(1)) + txn.Txn().SetState(PosSysAddr, keyProposerMissed(epoch, v2), u64ToHash(0)) + + require.NoError(t, FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn)) + logs := txn.Txn().Logs() + require.NotEmpty(t, logs) + require.Equal(t, posEventEpochFinalizedTopic, logs[0].Topics[0]) + require.Equal(t, uint64(1), new(big.Int).SetBytes(logs[0].Data[4*32:5*32]).Uint64(), "EpochFinalized.activeValidators must reflect post-finalization active validators") + + packed := bigFromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingMetaPackedKey(v1))) + require.False(t, isValidatorMetaActive(packed)) + require.Equal(t, uint64(header.Number), u64FromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingDeactivatedAtBlockKey(v1)))) + require.Greater(t, readStakedAmount(txn, v1).Sign(), 0, "validator must remain in registry/state with stake") + require.False(t, contractstore.IsEmergencyModeActive(txn), "fetcher must use normal strict eligible path in this test") + + fetched, err := contractstore.FetchECDSAValidators(txn, types.ZeroAddress) + require.NoError(t, err) + require.Equal(t, 1, fetched.Len()) + require.Equal(t, v2, fetched.At(0).Addr(), "inactive validator must not be in the regular eligible set") +} + +func TestFinalizeEpoch_FailsDeterministicallyWhenEpochProducedNoUsableSnapshot(t *testing.T) { + validator := types.StringToAddress("0xabd0") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + txn := newPosTestTransitionWithStakingValidators(t, set, 1, 10) + + // Finalize epoch 2 at boundary block 20 without any successful RecordBlockUptime freeze in epoch 2. + header := makeFinalizeHeader(20, 10, set) + err := FinalizeEpoch(header, 10, UptimeConfig{}, testHeaderSigner(), txn) + require.EqualError(t, err, "missing epoch validator snapshot for epoch 2") +} diff --git a/consensus/ibft/pos/finalize_test.go b/consensus/ibft/pos/finalize_test.go new file mode 100644 index 0000000..665e9dc --- /dev/null +++ b/consensus/ibft/pos/finalize_test.go @@ -0,0 +1,274 @@ +package pos + +import ( + "math/big" + "testing" + + "github.com/hashicorp/go-hclog" + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/chain" + "github.com/xgr-network/xgr-node/contracts/staking" + stakingHelper "github.com/xgr-network/xgr-node/helper/staking" + "github.com/xgr-network/xgr-node/state" + itrie "github.com/xgr-network/xgr-node/state/immutable-trie" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestSlashByEffectiveStake_DistributesRemainderBySortedAddress(t *testing.T) { + t.Parallel() + + validator := types.StringToAddress("0x00000000000000000000000000000000000000f3") + delegatorHigh := types.StringToAddress("0x00000000000000000000000000000000000000f2") + delegatorLow := types.StringToAddress("0x00000000000000000000000000000000000000f1") + donation := types.StringToAddress("0x2006") + txn := newPosTestTransitionWithStaking(t, validator) + epoch := uint64(2) + + setStakerForEpoch(t, txn, epoch, validator, 1, 101) + setStakerForEpoch(t, txn, epoch, delegatorHigh, 1, 101) + setStakerForEpoch(t, txn, epoch, delegatorLow, 1, 101) + appendValidatorStaker(txn, validator, delegatorHigh) + appendValidatorStaker(txn, validator, delegatorLow) + addValidatorDelegatedAggregate(txn, validator, big.NewInt(101), true) + addValidatorDelegatedAggregate(txn, validator, big.NewInt(101), true) + txn.Txn().SetBalance(staking.AddrStakingContract, big.NewInt(303)) + + before := map[types.Address]*big.Int{ + validator: new(big.Int).Set(readStakedAmount(txn, validator)), + delegatorHigh: new(big.Int).Set(readStakedAmount(txn, delegatorHigh)), + delegatorLow: new(big.Int).Set(readStakedAmount(txn, delegatorLow)), + } + + slashEvent, err := slashByEffectiveStakeFromStakingContract(txn, epoch, validator, donation, big.NewInt(500), 10, 10, 100, 20, 10) + require.NoError(t, err) + require.NotNil(t, slashEvent) + + allocated := map[types.Address]*big.Int{} + totalAllocated := big.NewInt(0) + for addr, stakeBefore := range before { + allocation := new(big.Int).Sub(stakeBefore, readStakedAmount(txn, addr)) + allocated[addr] = allocation + totalAllocated.Add(totalAllocated, allocation) + require.LessOrEqual(t, allocation.Cmp(stakeBefore), 0) + } + + require.Equal(t, int64(5), totalAllocated.Int64()) + require.Equal(t, int64(5), txn.Txn().GetBalance(donation).Int64()) + require.Equal(t, int64(2), allocated[delegatorLow].Int64(), "lowest address receives first remainder wei") + require.Equal(t, int64(2), allocated[delegatorHigh].Int64(), "second-lowest address receives second remainder wei") + require.Equal(t, int64(1), allocated[validator].Int64(), "highest address does not receive remainder before lower addresses") +} + +func TestSetValidatorInactiveInStaking_ClearsPoolConfigActiveAndIsIdempotent(t *testing.T) { + t.Parallel() + + validator := types.StringToAddress("0x1006") + txn := newPosTestTransitionWithStaking(t, validator) + poolKey := stakingPoolConfigPackedKey(validator) + poolPacked := new(big.Int).SetUint64(0x0101 | 1<<16) + txn.Txn().SetState(staking.AddrStakingContract, poolKey, bigToHash(poolPacked)) + poolBase := new(big.Int).SetBytes(poolKey.Bytes()) + maxKey := types.BytesToHash(new(big.Int).Add(new(big.Int).Set(poolBase), big.NewInt(2)).Bytes()) + minKey := types.BytesToHash(new(big.Int).Add(new(big.Int).Set(poolBase), big.NewInt(3)).Bytes()) + commissionKey := types.BytesToHash(new(big.Int).Add(new(big.Int).Set(poolBase), big.NewInt(4)).Bytes()) + txn.Txn().SetState(staking.AddrStakingContract, maxKey, bigToHash(big.NewInt(123))) + txn.Txn().SetState(staking.AddrStakingContract, minKey, bigToHash(big.NewInt(456))) + txn.Txn().SetState(staking.AddrStakingContract, commissionKey, bigToHash(big.NewInt(789))) + maxBefore := txn.Txn().GetState(staking.AddrStakingContract, maxKey) + minBefore := txn.Txn().GetState(staking.AddrStakingContract, minKey) + commissionBefore := txn.Txn().GetState(staking.AddrStakingContract, commissionKey) + + require.True(t, poolConfigActiveForTest(txn, validator)) + setValidatorInactiveInStaking(txn, validator, 100) + + packed := new(big.Int).SetBytes(txn.Txn().GetState(staking.AddrStakingContract, stakingMetaPackedKey(validator)).Bytes()) + require.False(t, isValidatorMetaActive(packed)) + require.False(t, poolConfigActiveForTest(txn, validator)) + require.True(t, poolConfigDelegationEnabledForTest(txn, validator)) + require.Equal(t, maxBefore, txn.Txn().GetState(staking.AddrStakingContract, maxKey)) + require.Equal(t, minBefore, txn.Txn().GetState(staking.AddrStakingContract, minKey)) + require.Equal(t, commissionBefore, txn.Txn().GetState(staking.AddrStakingContract, commissionKey)) + require.Equal(t, uint64(100), u64FromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingDeactivatedAtBlockKey(validator)))) + + setValidatorInactiveInStaking(txn, validator, 200) + require.Equal(t, uint64(100), u64FromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingDeactivatedAtBlockKey(validator)))) +} + +func TestPosSysAddrNormalUserCallCannotMutateInternalStorage(t *testing.T) { + t.Parallel() + + user := types.StringToAddress("0x3001") + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{Forks: chain.AllForksEnabled, BurnContract: map[uint64]types.Address{0: types.ZeroAddress}}, st, hclog.NewNullLogger()) + root, err := ex.WriteGenesis(map[types.Address]*chain.GenesisAccount{user: {Balance: big.NewInt(1_000_000)}}, types.ZeroHash) + require.NoError(t, err) + ex.GetHash = func(h *types.Header) state.GetHashByNumber { + return func(i uint64) types.Hash { return root } + } + txn, err := ex.BeginTxn(root, &types.Header{GasLimit: 100_000}, types.ZeroAddress) + require.NoError(t, err) + key := keyUptimeLastProcessedSlot() + before := u64ToHash(777) + txn.Txn().SetState(PosSysAddr, key, before) + unknownKey := types.StringToHash("0x1234") + + tx := &types.Transaction{ + From: user, + To: &PosSysAddr, + Value: big.NewInt(1), + Gas: 50_000, + GasPrice: big.NewInt(0), + Input: []byte{0x55, 0x00, 0x55}, + } + _, err = txn.Apply(tx) + require.NoError(t, err) + + require.Equal(t, before, txn.Txn().GetState(PosSysAddr, key)) + require.Equal(t, types.ZeroHash, txn.Txn().GetState(PosSysAddr, unknownKey)) + require.Equal(t, int64(1), txn.Txn().GetBalance(PosSysAddr).Int64()) +} + +func poolConfigActiveForTest(txn *state.Transition, validator types.Address) bool { + packed := new(big.Int).SetBytes(txn.Txn().GetState(staking.AddrStakingContract, stakingPoolConfigPackedKey(validator)).Bytes()) + active := new(big.Int).Rsh(packed, 8) + active.And(active, new(big.Int).SetUint64(0xff)) + return active.Sign() != 0 +} + +func poolConfigDelegationEnabledForTest(txn *state.Transition, validator types.Address) bool { + packed := new(big.Int).SetBytes(txn.Txn().GetState(staking.AddrStakingContract, stakingPoolConfigPackedKey(validator)).Bytes()) + enabled := new(big.Int).Rsh(packed, 16) + enabled.And(enabled, new(big.Int).SetUint64(0xff)) + return enabled.Sign() != 0 +} + +func TestSetValidatorInactiveInStaking_DoesNotRewriteDeactivatedAtBlockForAlreadyInactive(t *testing.T) { + t.Parallel() + + validator := types.StringToAddress("0x1004") + txn := newPosTestTransitionWithStaking(t, validator) + + setValidatorInactiveInStaking(txn, validator, 100) + firstPackedState := txn.Txn().GetState(staking.AddrStakingContract, stakingMetaPackedKey(validator)) + firstPacked := new(big.Int).SetBytes(firstPackedState[:]) + require.False(t, isValidatorMetaActive(firstPacked)) + require.Equal(t, uint64(100), u64FromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingDeactivatedAtBlockKey(validator)))) + + setValidatorInactiveInStaking(txn, validator, 200) + secondPackedState := txn.Txn().GetState(staking.AddrStakingContract, stakingMetaPackedKey(validator)) + secondPacked := new(big.Int).SetBytes(secondPackedState[:]) + require.False(t, isValidatorMetaActive(secondPacked)) + require.Equal(t, uint64(100), u64FromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingDeactivatedAtBlockKey(validator)))) +} + +func newPosTestTransition(t *testing.T) *state.Transition { + t.Helper() + + st := itrie.NewState(itrie.NewMemoryStorage()) + + forks := chain.Forks{} + for name, fork := range *chain.AllForksEnabled { + forks[name] = fork + } + forks[chain.FeePoolSplit] = chain.NewFork(0) + + ex := state.NewExecutor(&chain.Params{ + Forks: &forks, + BurnContract: map[uint64]types.Address{ + 0: types.ZeroAddress, + }, + }, st, hclog.NewNullLogger()) + + rootHash, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + + ex.GetHash = func(h *types.Header) state.GetHashByNumber { + return func(i uint64) types.Hash { + return rootHash + } + } + + transition, err := ex.BeginTxn(rootHash, &types.Header{}, types.ZeroAddress) + require.NoError(t, err) + + return transition +} + +func newPosTestTransitionWithStaking(t *testing.T, validator types.Address) *state.Transition { + t.Helper() + + txn := newPosTestTransition(t) + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(validator)) + + contractState, err := stakingHelper.PredeployStakingSC(vals, stakingHelper.PredeployParams{ + MinValidatorCount: 1, + MaxValidatorCount: 10, + EpochSize: 10, + }) + require.NoError(t, err) + require.NoError(t, txn.SetAccountDirectly(staking.AddrStakingContract, contractState)) + + return txn +} + +func newPosTestTransitionWithStakingValidators(t *testing.T, vals validators.Validators, minValidators, maxValidators uint64) *state.Transition { + t.Helper() + + txn := newPosTestTransition(t) + + contractState, err := stakingHelper.PredeployStakingSC(vals, stakingHelper.PredeployParams{ + MinValidatorCount: minValidators, + MaxValidatorCount: maxValidators, + EpochSize: 10, + }) + require.NoError(t, err) + require.NoError(t, txn.SetAccountDirectly(staking.AddrStakingContract, contractState)) + + return txn +} + +func newPosTestTransitionWithStakingValidatorsAtBlock( + t *testing.T, + vals validators.Validators, + minValidators, maxValidators, blockNumber uint64, +) *state.Transition { + t.Helper() + + st := itrie.NewState(itrie.NewMemoryStorage()) + + forks := chain.Forks{} + for name, fork := range *chain.AllForksEnabled { + forks[name] = fork + } + forks[chain.FeePoolSplit] = chain.NewFork(0) + + ex := state.NewExecutor(&chain.Params{ + Forks: &forks, + BurnContract: map[uint64]types.Address{ + 0: types.ZeroAddress, + }, + }, st, hclog.NewNullLogger()) + + rootHash, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + + ex.GetHash = func(h *types.Header) state.GetHashByNumber { + return func(i uint64) types.Hash { + return rootHash + } + } + + txn, err := ex.BeginTxn(rootHash, &types.Header{Number: blockNumber}, types.ZeroAddress) + require.NoError(t, err) + + contractState, err := stakingHelper.PredeployStakingSC(vals, stakingHelper.PredeployParams{ + MinValidatorCount: minValidators, + MaxValidatorCount: maxValidators, + EpochSize: 10, + }) + require.NoError(t, err) + require.NoError(t, txn.SetAccountDirectly(staking.AddrStakingContract, contractState)) + + return txn +} diff --git a/consensus/ibft/pos/keys.go b/consensus/ibft/pos/keys.go new file mode 100644 index 0000000..b33e7c6 --- /dev/null +++ b/consensus/ibft/pos/keys.go @@ -0,0 +1,222 @@ +package pos + +import ( + "encoding/binary" + "math/big" + + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/types" +) + +// PosSysAddr is a PoS system state address (consensus-owned storage namespace). +// It remains fixed so fork-gating stays deterministic. +var PosSysAddr = types.StringToAddress("0x0000000000000000000000000000000000009999") + +const ( + keyPrefixPropSlots = "xgr.pos.prop.slots" + keyPrefixPropMiss = "xgr.pos.prop.miss" + keyPrefixLastProp = "xgr.pos.last.proposer" + keyPrefixEpochValsLen = "xgr.pos.epoch.validators.len" + keyPrefixEpochVal = "xgr.pos.epoch.validators.val" + keyPrefixStakeSnap = "xgr.pos.stake.snapshot" + keyPrefixStakerStakeSnap = "xgr.pos.staker.stake.snapshot" + keyPrefixSlashed = "xgr.pos.slashed" + keyPrefixSlashAmt = "xgr.pos.slash.amount" + keyPrefixRewardTot = "xgr.pos.reward.total" + keyPrefixRewardVal = "xgr.pos.reward.validator" + keyPrefixRewardValComm = "xgr.pos.reward.validator.commission" + keyPrefixRewardDelTot = "xgr.pos.reward.delegators.total" + keyPrefixRewardDelegator = "xgr.pos.reward.delegator" + keyPrefixMicroEpApplied = "xgr.uptime.microepoch.last.applied" + keyPrefixMicroEpSeen = "xgr.uptime.microepoch.seen" + keyPrefixMicroEpDuty = "xgr.uptime.microepoch.duty" + keyPrefixUptimeEffW = "xgr.uptime.effective.weight" + keyPrefixUptimeNomW = "xgr.uptime.nominal.weight" + keyPrefixUptimeInact = "xgr.uptime.inactivity.count" + keyPrefixUptimeLastSlot = "xgr.uptime.last.processed.slot" +) + +func epochOf(number, epochSize uint64) uint64 { + // mirror polygon-edge logic: + // if number % epochSize == 0 => epoch = number/epochSize + // else => epoch = number/epochSize + 1 + if number == 0 || epochSize == 0 { + return 0 + } + + if number%epochSize == 0 { + return number / epochSize + } + + return number/epochSize + 1 +} + +func u64ToHash(v uint64) types.Hash { + var b [32]byte + binary.BigEndian.PutUint64(b[24:], v) + + return types.BytesToHash(b[:]) +} + +func u64FromHash(h types.Hash) uint64 { + return binary.BigEndian.Uint64(h[24:]) +} + +func keyProposerSlots(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixPropSlots), eb[:], addr.Bytes())) +} + +func keyProposerMissed(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixPropMiss), eb[:], addr.Bytes())) +} + +func keyLastProposer() types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixLastProp))) +} + +func keyEpochValidatorsLen(epoch uint64) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixEpochValsLen), eb[:])) +} + +func keyEpochValidator(epoch, idx uint64) types.Hash { + var eb [8]byte + var ib [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + binary.BigEndian.PutUint64(ib[:], idx) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixEpochVal), eb[:], ib[:])) +} + +func keyStakeSnapshot(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixStakeSnap), eb[:], addr.Bytes())) +} + +func keyStakerStakeSnapshot(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixStakerStakeSnap), eb[:], addr.Bytes())) +} + +func keySlashed(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixSlashed), eb[:], addr.Bytes())) +} + +func keySlashAmount(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixSlashAmt), eb[:], addr.Bytes())) +} + +// Legacy reward-history keys. Do not write these keys. Kept only for tests/audit +// checks that finalized PosSysAddr reward history remains absent. +func keyRewardTotal(epoch uint64) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardTot), eb[:])) +} + +func keyValidatorReward(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardVal), eb[:], addr.Bytes())) +} + +func keyValidatorCommissionReward(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardValComm), eb[:], addr.Bytes())) +} + +func keyValidatorDelegatorsRewardTotal(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardDelTot), eb[:], addr.Bytes())) +} + +func keyDelegatorReward(epoch uint64, validator, delegator types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardDelegator), eb[:], validator.Bytes(), delegator.Bytes())) +} + +func keyMicroEpochApplied() types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixMicroEpApplied))) +} + +func keyMicroEpochSeen(me uint64, addr types.Address) types.Hash { + var mb [8]byte + binary.BigEndian.PutUint64(mb[:], me) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixMicroEpSeen), mb[:], addr.Bytes())) +} + +func keyMicroEpochDuty(me uint64, addr types.Address) types.Hash { + var mb [8]byte + binary.BigEndian.PutUint64(mb[:], me) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixMicroEpDuty), mb[:], addr.Bytes())) +} + +func keyUptimeNominalWeight(addr types.Address) types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixUptimeNomW), addr.Bytes())) +} + +func keyUptimeEffectiveWeight(addr types.Address) types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixUptimeEffW), addr.Bytes())) +} + +func keyUptimeInactivity(addr types.Address) types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixUptimeInact), addr.Bytes())) +} + +func keyUptimeLastProcessedSlot() types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixUptimeLastSlot))) +} + +func bigToHash(v *big.Int) types.Hash { + if v == nil { + return types.Hash{} + } + + b := v.Bytes() + if len(b) == 0 { + return types.Hash{} + } + + var out [32]byte + if len(b) > 32 { + copy(out[:], b[len(b)-32:]) + } else { + copy(out[32-len(b):], b) + } + + return types.BytesToHash(out[:]) +} + +func bigFromHash(h types.Hash) *big.Int { + if h == (types.Hash{}) { + return new(big.Int) + } + + return new(big.Int).SetBytes(h[:]) +} diff --git a/consensus/ibft/pos/signer_test_helpers_test.go b/consensus/ibft/pos/signer_test_helpers_test.go new file mode 100644 index 0000000..2d34095 --- /dev/null +++ b/consensus/ibft/pos/signer_test_helpers_test.go @@ -0,0 +1,27 @@ +package pos + +import ( + "sync" + + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + xcrypto "github.com/xgr-network/xgr-node/crypto" +) + +var ( + testSignerOnce sync.Once + testSignerInst signer.Signer +) + +func testHeaderSigner() signer.Signer { + testSignerOnce.Do(func() { + key, err := xcrypto.GenerateECDSAKey() + if err != nil { + panic(err) + } + + keyManager := signer.NewECDSAKeyManagerFromKey(key) + testSignerInst = signer.NewSigner(keyManager, keyManager) + }) + + return testSignerInst +} diff --git a/consensus/ibft/pos/sys_account.go b/consensus/ibft/pos/sys_account.go new file mode 100644 index 0000000..6ba7d63 --- /dev/null +++ b/consensus/ibft/pos/sys_account.go @@ -0,0 +1,20 @@ +package pos + +import ( + "github.com/xgr-network/xgr-node/state" +) + +// ensurePosSysAccount makes the PoS system storage account non-empty so it won't be pruned +// by CleanDeleteObjects(deleteEmptyObjects=true). StateObject.Empty() ignores storage, so a +// pure "storage-only" account would be deleted every block otherwise. +// +// Consensus-critical: deterministic and idempotent. +func ensurePosSysAccount(txn *state.Transition) { + if txn == nil { + return + } + + if txn.Txn().GetNonce(PosSysAddr) == 0 { + txn.Txn().SetNonce(PosSysAddr, 1) + } +} diff --git a/consensus/ibft/pos/system_tx.go b/consensus/ibft/pos/system_tx.go new file mode 100644 index 0000000..70adb3b --- /dev/null +++ b/consensus/ibft/pos/system_tx.go @@ -0,0 +1,33 @@ +package pos + +import ( + "math/big" + + "github.com/xgr-network/xgr-node/contracts" + "github.com/xgr-network/xgr-node/types" +) + +// EpochFinalizationSystemTx returns the deterministic native +// epoch-finalization system transaction for boundary blocks. It is +// consensus-generated, not mempool/user-provided, and represents native epoch +// finalization for receipt/log/indexing purposes. +func EpochFinalizationSystemTx(blockNumber uint64) *types.Transaction { + tx := &types.Transaction{ + Nonce: blockNumber, + GasPrice: big.NewInt(0), + Gas: types.StateTransactionGasLimit, + To: &PosSysAddr, + Value: big.NewInt(0), + Input: []byte(types.EpochFinalizationSystemTxInput), + From: contracts.SystemCaller, + Type: types.StateTx, + } + + return tx.ComputeHash(blockNumber) +} + +// IsEpochFinalizationSystemTx reports whether tx is the deterministic native +// PoS epoch-finalization system transaction for blockNumber. +func IsEpochFinalizationSystemTx(tx *types.Transaction, blockNumber uint64) bool { + return types.IsEpochFinalizationSystemTxForBlock(tx, blockNumber, contracts.SystemCaller) +} diff --git a/consensus/ibft/pos/test_txn_helper_test.go b/consensus/ibft/pos/test_txn_helper_test.go new file mode 100644 index 0000000..86f8e43 --- /dev/null +++ b/consensus/ibft/pos/test_txn_helper_test.go @@ -0,0 +1,10 @@ +package pos + +import "github.com/xgr-network/xgr-node/types" + +type memUptimeTxn struct { + m map[types.Hash]types.Hash +} + +func (m *memUptimeTxn) SetState(_ types.Address, k types.Hash, v types.Hash) { m.m[k] = v } +func (m *memUptimeTxn) GetState(_ types.Address, k types.Hash) types.Hash { return m.m[k] } diff --git a/consensus/ibft/pos/uptime.go b/consensus/ibft/pos/uptime.go new file mode 100644 index 0000000..bbdc130 --- /dev/null +++ b/consensus/ibft/pos/uptime.go @@ -0,0 +1,289 @@ +package pos + +import ( + "fmt" + + "github.com/hashicorp/go-hclog" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +var posDiagLogger = hclog.L().Named("ibft-pos-diag") + +var ensureEpochValidatorsSnapshotFn = ensureEpochValidatorsSnapshot +var getOrInitStakeSnapshotFn = getOrInitStakeSnapshot +var getOrInitStakerStakeSnapshotFn = getOrInitStakerStakeSnapshot + +const maxFinalRoundForUptime = uint64(1000) + +// RecordBlockUptime accounts proposer availability deterministically from the finalized header. +// +// Rationale: +// Counting commit signatures is unsafe if the header only contains quorum seals (subset), +// which can lead to systematic false slashing. RoundNumber is consensus-verified and lets +// us penalize only provable missed proposer slots. +// +// Accounting model (per epoch, per validator): +// - proposerSlots += 1 for each assigned proposer slot (for each round attempt) +// - proposerMissed += 1 for each failed round (r < finalRound) +// +// Notes: +// - Genesis (block 0) is ignored. +// - Epoch boundary blocks (height % epochSize == 0) are skipped to keep alignment with FinalizeEpoch +// (which finalizes epochOf(height-1)). +func RecordBlockUptime( + header *types.Header, + epochSize uint64, + epochValidators validators.Validators, + headerSigner signer.Signer, + uptimeCfg UptimeConfig, + txn *state.Transition, +) error { + if header == nil || txn == nil { + return nil + } + + // Fork-gated: no PoS accounting before pooling overlay is active. + if !txn.ForksInTime().FeePoolSplit { + return nil + } + + // IMPORTANT: keep PosSysAddr alive (otherwise storage is pruned every block). + ensurePosSysAccount(txn) + if epochSize < 2 { + posDiagLogger.Error("RecordBlockUptime failed: epochSize must be >= 2", "block", header.Number, "epochSize", epochSize) + return fmt.Errorf("epochSize must be greater than or equal to 2") + } + + if header.Number == 0 { + return nil + } + + // Skip the tx-free epoch boundary block. This block exists as a deterministic finalize/system block. + if header.Number%epochSize == 0 { + return nil + } + + epoch := epochOf(header.Number, epochSize) + if epoch == 0 { + return nil + } + + // A single monotonic slot guard replaces unbounded per-block processed keys. + // Reprocessing the same or an older block is idempotently ignored. + if u64FromHash(txn.Txn().GetState(PosSysAddr, keyUptimeLastProcessedSlot())) >= header.Number { + return nil + } + + extra, err := getIBFTExtra(headerSigner, header) + if err != nil { + // Don't brick block import. + posDiagLogger.Error("RecordBlockUptime cannot decode IBFT extra", "block", header.Number, "epoch", epoch, "err", err) + return fmt.Errorf("decode IBFT extra for block %d epoch %d: %w", header.Number, epoch, err) + } + + valSet := epochValidators + if valSet == nil || valSet.Len() == 0 { + valSet = extra.Validators + } + if valSet == nil || valSet.Len() == 0 { + posDiagLogger.Error("RecordBlockUptime skipped: validator set is empty", "block", header.Number, "epoch", epoch) + return fmt.Errorf("validator set empty for block %d epoch %d", header.Number, epoch) + } + // Freeze the exact validator membership of this epoch on the first processed + // non-boundary block. FinalizeEpoch and monitoring for epoch X must use the + // epoch-X membership, even if set-active=false was toggled during X and only + // becomes effective at X+1. + lenKey := keyEpochValidatorsLen(epoch) + if u64FromHash(txn.Txn().GetState(PosSysAddr, lenKey)) == 0 { + ok, err := ensureEpochValidatorsSnapshotFn(txn, epoch, valSet) + if err != nil { + return fmt.Errorf("freeze epoch validator snapshot for epoch %d: %w", epoch, err) + } + if !ok { + return fmt.Errorf("freeze epoch validator snapshot for epoch %d", epoch) + } + if u64FromHash(txn.Txn().GetState(PosSysAddr, lenKey)) == 0 { + return fmt.Errorf("freeze epoch validator snapshot for epoch %d: missing after write", epoch) + } + } + + // Freeze per-epoch stake snapshots as early as possible (first processed block in epoch) + // for all validators in the consensus set, so last-minute stake changes do not distort + // epoch reward/slash weights at finalize. + for i := 0; i < valSet.Len(); i++ { + addr := valSet.At(uint64(i)).Addr() + if _, err := getOrInitStakeSnapshotFn(txn, epoch, addr); err != nil { + return fmt.Errorf("freeze stake snapshot for validator %s in epoch %d: %w", addr, epoch, err) + } + if _, err := getOrInitStakerStakeSnapshotFn(txn, epoch, addr); err != nil { + return fmt.Errorf("freeze staker snapshot for validator %s in epoch %d: %w", addr, epoch, err) + } + for _, staker := range readValidatorStakers(txn, addr) { + if !isStakerEffectiveAt(txn, staker, header.Number-1, epochSize) { + continue + } + if _, err := getOrInitStakerStakeSnapshotFn(txn, epoch, staker); err != nil { + return fmt.Errorf("freeze staker snapshot for staker %s (validator %s) in epoch %d: %w", staker, addr, epoch, err) + } + } + } + + // Round begins with zero; nil means 0 for backward compatibility. + finalRound := uint64(0) + if extra.RoundNumber != nil { + finalRound = *extra.RoundNumber + } + if finalRound > maxFinalRoundForUptime { + posDiagLogger.Error( + "RecordBlockUptime finalRound too large, clamping", + "block", header.Number, + "epoch", epoch, + "finalRound", finalRound, + "maxFinalRoundForUptime", maxFinalRoundForUptime, + ) + finalRound = maxFinalRoundForUptime + } + actual, err := resolveProposer(headerSigner, header, valSet) + if err != nil { + posDiagLogger.Error("RecordBlockUptime cannot resolve proposer", "block", header.Number, "epoch", epoch, "err", err) + return fmt.Errorf("resolve proposer for block %d epoch %d: %w", header.Number, epoch, err) + } + + // Use chain-persistent proposer context (previous block proposer), + // instead of deriving it from the current block's actual proposer. + // Deriving from actual makes expected==actual tautological and can skew rewards. + lastProp := getLastProposer(txn) + + if uptimeCfg.MicroEpochSize > 0 { + for i := 0; i < valSet.Len(); i++ { + addr := valSet.At(uint64(i)).Addr() + if UptimeNominalWeight(txn.Txn(), addr) == 0 { + txn.Txn().SetState(PosSysAddr, keyUptimeNominalWeight(addr), u64ToHash(uptimeCfg.MicroEpochNominalWeight)) + } + if UptimeEffectiveWeight(txn.Txn(), addr) == 0 { + txn.Txn().SetState(PosSysAddr, keyUptimeEffectiveWeight(addr), u64ToHash(uptimeCfg.MicroEpochNominalWeight)) + } + } + + currentME := microEpochOfBlock(header.Number, uptimeCfg.MicroEpochSize) + if actual != types.ZeroAddress { + txn.Txn().SetState(PosSysAddr, keyMicroEpochSeen(currentME, actual), u64ToHash(1)) + } + + for r := uint64(0); r <= finalRound; r++ { + p := calcProposer(valSet, r, lastProp) + if p == types.ZeroAddress { + continue + } + txn.Txn().SetState(PosSysAddr, keyMicroEpochDuty(currentME, p), u64ToHash(1)) + } + + if err := applyMicroEpochUptime(txn, valSet, header.Number, actual, uptimeCfg); err != nil { + return err + } + } + + // Attribute missed proposer slots for each failed round. + for r := uint64(0); r < finalRound; r++ { + p := calcProposer(valSet, r, lastProp) + if p == types.ZeroAddress { + continue + } + incU64State(txn, keyProposerSlots(epoch, p), 1) + incU64State(txn, keyProposerMissed(epoch, p), 1) + } + // Attribute the successful finalized round to the actual finalized proposer. + + incU64State(txn, keyProposerSlots(epoch, actual), 1) + + // Persist the finalized block proposer for the next height proposer selection context. + setLastProposer(txn, actual) + + // Mark this slot as accounted without creating per-block history. + txn.Txn().SetState(PosSysAddr, keyUptimeLastProcessedSlot(), u64ToHash(header.Number)) + + return nil +} + +func calcProposer(set validators.Validators, round uint64, lastProposer types.Address) types.Address { + if set == nil || set.Len() == 0 { + return types.ZeroAddress + } + + var seed uint64 + if lastProposer == types.ZeroAddress { + seed = round + } else { + offset := int64(0) + if index := set.Index(lastProposer); index != -1 { + offset = int64(index) + } + seed = uint64(offset) + round + 1 + } + + pick := seed % uint64(set.Len()) + return set.At(pick).Addr() +} + +func getLastProposer(txn *state.Transition) types.Address { + if txn == nil { + return types.ZeroAddress + } + + raw := txn.Txn().GetState(PosSysAddr, keyLastProposer()) + var addr types.Address + copy(addr[:], raw[12:]) + + return addr +} + +func setLastProposer(txn *state.Transition, addr types.Address) { + if txn == nil || addr == types.ZeroAddress { + return + } + + var raw types.Hash + copy(raw[12:], addr[:]) + txn.Txn().SetState(PosSysAddr, keyLastProposer(), raw) +} + +func incU64State(txn *state.Transition, key types.Hash, delta uint64) { + cur := txn.Txn().GetState(PosSysAddr, key) + v := u64FromHash(cur) + v += delta + txn.Txn().SetState(PosSysAddr, key, u64ToHash(v)) +} + +func resolveProposer(headerSigner signer.Signer, header *types.Header, set validators.Validators) (types.Address, error) { + if headerSigner == nil || header == nil { + return types.ZeroAddress, fmt.Errorf("nil") + } + + proposer, err := headerSigner.EcrecoverFromHeader(header) + if err == nil { + if set != nil && set.Index(proposer) >= 0 { + return proposer, nil + } + + return types.ZeroAddress, fmt.Errorf("recovered proposer not in validator set: %s", proposer.String()) + } + + return types.ZeroAddress, fmt.Errorf("proposer seal recovery failed: %w", err) +} + +func getIBFTExtra(headerSigner signer.Signer, header *types.Header) (*signer.IstanbulExtra, error) { + if headerSigner == nil || header == nil { + return nil, fmt.Errorf("nil") + } + + extra, err := headerSigner.GetIBFTExtra(header) + if err != nil { + posDiagLogger.Error("getIBFTExtra decode failed via signer", "block", header.Number, "err", err) + return nil, err + } + + return extra, nil +} diff --git a/consensus/ibft/pos/uptime_bls_test.go b/consensus/ibft/pos/uptime_bls_test.go new file mode 100644 index 0000000..9b50154 --- /dev/null +++ b/consensus/ibft/pos/uptime_bls_test.go @@ -0,0 +1,67 @@ +package pos + +import ( + "math/big" + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestCollectSignedAddresses_BLSAggregatedSeal(t *testing.T) { + v1 := validators.NewBLSValidator(types.StringToAddress("0x11"), validators.BLSValidatorPublicKey("pk1")) + v2 := validators.NewBLSValidator(types.StringToAddress("0x22"), validators.BLSValidatorPublicKey("pk2")) + v3 := validators.NewBLSValidator(types.StringToAddress("0x33"), validators.BLSValidatorPublicKey("pk3")) + + bitmap := new(big.Int) + bitmap.SetBit(bitmap, 1, 1) + bitmap.SetBit(bitmap, 2, 1) + + extra := &signer.IstanbulExtra{ + Validators: validators.NewBLSValidatorSet(v1, v2, v3), + ParentCommittedSeals: &signer.AggregatedSeal{ + Bitmap: bitmap, + Signature: []byte("aggregate-signature"), + }, + } + + seen := collectSignedAddresses(extra, types.StringToHash("0xabc"), nil) + require.Len(t, seen, 2) + _, ok2 := seen[v2.Addr()] + require.True(t, ok2) + _, ok3 := seen[v3.Addr()] + require.True(t, ok3) +} + +func TestShouldSkipUptimeAccounting_BLSBitmapWithoutValidators(t *testing.T) { + bitmap := new(big.Int) + bitmap.SetBit(bitmap, 0, 1) + + extra := &signer.IstanbulExtra{ + Validators: validators.NewBLSValidatorSet(), + ParentCommittedSeals: &signer.AggregatedSeal{ + Bitmap: bitmap, + Signature: []byte("aggregate-signature"), + }, + } + + require.True(t, shouldSkipUptimeAccounting(extra, nil, map[types.Address]struct{}{})) +} + +func TestShouldSkipUptimeAccounting_BLSBitmapWithCollectedSigners(t *testing.T) { + v1 := validators.NewBLSValidator(types.StringToAddress("0x11"), validators.BLSValidatorPublicKey("pk1")) + bitmap := new(big.Int) + bitmap.SetBit(bitmap, 0, 1) + + extra := &signer.IstanbulExtra{ + Validators: validators.NewBLSValidatorSet(v1), + ParentCommittedSeals: &signer.AggregatedSeal{ + Bitmap: bitmap, + Signature: []byte("aggregate-signature"), + }, + } + + require.False(t, shouldSkipUptimeAccounting(extra, nil, map[types.Address]struct{}{v1.Addr(): {}})) +} diff --git a/consensus/ibft/pos/uptime_config.go b/consensus/ibft/pos/uptime_config.go new file mode 100644 index 0000000..45f6af9 --- /dev/null +++ b/consensus/ibft/pos/uptime_config.go @@ -0,0 +1,68 @@ +package pos + +import "encoding/json" + +const ( + keyMicroEpochSize = "microEpochSize" + keyMicroEpochInactivityDecayBps = "microEpochInactivityDecayBps" + keyMicroEpochNominalWeightUnits = "microEpochNominalWeightUnits" +) + +// UptimeConfig holds the micro-epoch uptime/liveness configuration used by PoS. +type UptimeConfig struct { + MicroEpochSize uint64 + MicroEpochInactivityDecayBps uint64 + MicroEpochNominalWeight uint64 + ChainID int64 +} + +// DefaultUptimeConfig returns default micro-epoch uptime/liveness parameters. +func DefaultUptimeConfig() UptimeConfig { + return UptimeConfig{ + MicroEpochSize: 0, + MicroEpochInactivityDecayBps: 9000, + MicroEpochNominalWeight: 10000, + } +} + +// ParseUptimeConfig parses uptime/micro-epoch configuration from IBFT config. +func ParseUptimeConfig(ibftConfig map[string]interface{}) UptimeConfig { + cfg := DefaultUptimeConfig() + if ibftConfig == nil { + return cfg + } + + readOK := func(key string) (uint64, bool) { + raw, ok := ibftConfig[key] + if !ok || raw == nil { + return 0, false + } + n, ok := raw.(float64) + if !ok || n < 0 { + return 0, false + } + return uint64(n), true + } + + if v, ok := readOK(keyMicroEpochSize); ok { + cfg.MicroEpochSize = v + } + + if v, ok := readOK(keyMicroEpochInactivityDecayBps); ok { + cfg.MicroEpochInactivityDecayBps = v + } + + if v, ok := readOK(keyMicroEpochNominalWeightUnits); ok { + cfg.MicroEpochNominalWeight = v + } + + return cfg +} + +func (c UptimeConfig) Enabled() bool { + return c.MicroEpochSize > 0 && c.MicroEpochNominalWeight > 0 +} + +func MarshalUptimeConfigJSON(cfg UptimeConfig) ([]byte, error) { + return json.Marshal(cfg) +} diff --git a/consensus/ibft/pos/uptime_config_test.go b/consensus/ibft/pos/uptime_config_test.go new file mode 100644 index 0000000..86d61a1 --- /dev/null +++ b/consensus/ibft/pos/uptime_config_test.go @@ -0,0 +1,39 @@ +package pos + +import ( + "testing" + + "github.com/stretchr/testify/require" +) + +func TestParseUptimeConfig_NewKeys(t *testing.T) { + cfg := ParseUptimeConfig(map[string]interface{}{ + keyMicroEpochSize: float64(8), + keyMicroEpochInactivityDecayBps: float64(9000), + keyMicroEpochNominalWeightUnits: float64(10000), + }) + + require.Equal(t, uint64(8), cfg.MicroEpochSize) + require.Equal(t, uint64(9000), cfg.MicroEpochInactivityDecayBps) + require.Equal(t, uint64(10000), cfg.MicroEpochNominalWeight) +} + +func TestParseUptimeConfig_LegacyBeaconKeysIgnored(t *testing.T) { + cfg := ParseUptimeConfig(map[string]interface{}{ + "beaconSlotsPerEpoch": float64(8), + "beaconInactivityDecayBps": float64(9000), + "beaconNominalWeightUnits": float64(10000), + }) + + require.Equal(t, uint64(0), cfg.MicroEpochSize) + require.Equal(t, uint64(9000), cfg.MicroEpochInactivityDecayBps) + require.Equal(t, uint64(10000), cfg.MicroEpochNominalWeight) +} + +func TestDefaultUptimeConfig(t *testing.T) { + cfg := DefaultUptimeConfig() + + require.Equal(t, uint64(0), cfg.MicroEpochSize) + require.Equal(t, uint64(9000), cfg.MicroEpochInactivityDecayBps) + require.Equal(t, uint64(10000), cfg.MicroEpochNominalWeight) +} diff --git a/consensus/ibft/pos/uptime_extra_decode_test.go b/consensus/ibft/pos/uptime_extra_decode_test.go new file mode 100644 index 0000000..2a0a8f7 --- /dev/null +++ b/consensus/ibft/pos/uptime_extra_decode_test.go @@ -0,0 +1,58 @@ +package pos + +import ( + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + xcrypto "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestGetIBFTExtra_UsesProvidedSignerForECDSAExtra(t *testing.T) { + v := types.StringToAddress("0x9991") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + header := makeUptimeHeader(42, set) + + extra, err := getIBFTExtra(testHeaderSigner(), header) + require.NoError(t, err) + require.NotNil(t, extra) + require.NotNil(t, extra.Validators) + require.Equal(t, 1, extra.Validators.Len()) + require.Equal(t, v, extra.Validators.At(0).Addr()) +} + +func TestGetIBFTExtra_ReturnsErrorOnMalformedExtraPayload(t *testing.T) { + header := &types.Header{ + Number: 43, + ExtraData: []byte{0x01, 0x02, 0x03, 0x04}, + } + + extra, err := getIBFTExtra(testHeaderSigner(), header) + require.Error(t, err) + require.Nil(t, extra) +} + +func TestGetIBFTExtra_UsesProvidedSignerForBLSExtra(t *testing.T) { + v := validators.NewBLSValidator(types.StringToAddress("0x9992"), validators.BLSValidatorPublicKey("pk1")) + set := validators.NewBLSValidatorSet(v) + header := makeUptimeHeader(44, set) + + ecdsaExtra, ecdsaErr := getIBFTExtra(testHeaderSigner(), header) + require.Error(t, ecdsaErr) + require.Nil(t, ecdsaExtra) + + ecdsaKey, err := xcrypto.GenerateECDSAKey() + require.NoError(t, err) + blsKey, err := xcrypto.GenerateBLSKey() + require.NoError(t, err) + blsKeyManager := signer.NewBLSKeyManagerFromKeys(ecdsaKey, blsKey) + blsSigner := signer.NewSigner(blsKeyManager, blsKeyManager) + + blsExtra, err := getIBFTExtra(blsSigner, header) + require.NoError(t, err) + require.NotNil(t, blsExtra) + require.Equal(t, 1, blsExtra.Validators.Len()) + require.Equal(t, v.Addr(), blsExtra.Validators.At(0).Addr()) +} diff --git a/consensus/ibft/pos/uptime_microepoch.go b/consensus/ibft/pos/uptime_microepoch.go new file mode 100644 index 0000000..c729379 --- /dev/null +++ b/consensus/ibft/pos/uptime_microepoch.go @@ -0,0 +1,66 @@ +package pos + +import ( + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func microEpochOfBlock(blockNumber, microEpochSize uint64) uint64 { + if blockNumber == 0 || microEpochSize == 0 { + return 0 + } + + return (blockNumber - 1) / microEpochSize +} + +func applyMicroEpochUptime(txn *state.Transition, valSet validators.Validators, currentBlock uint64, _ types.Address, cfg UptimeConfig) error { + if txn == nil || valSet == nil || cfg.MicroEpochSize == 0 { + return nil + } + + currentME := microEpochOfBlock(currentBlock, cfg.MicroEpochSize) + lastApplied := u64FromHash(txn.Txn().GetState(PosSysAddr, keyMicroEpochApplied())) + + for me := lastApplied; me < currentME; me++ { + for i := 0; i < valSet.Len(); i++ { + addr := valSet.At(uint64(i)).Addr() + dutyKey := keyMicroEpochDuty(me, addr) + seenKey := keyMicroEpochSeen(me, addr) + duty := u64FromHash(txn.Txn().GetState(PosSysAddr, dutyKey)) == 1 + seen := u64FromHash(txn.Txn().GetState(PosSysAddr, seenKey)) == 1 + + nominal := UptimeNominalWeight(txn.Txn(), addr) + if nominal == 0 { + nominal = cfg.MicroEpochNominalWeight + } + eff := UptimeEffectiveWeight(txn.Txn(), addr) + if eff == 0 { + eff = nominal + } + + switch { + case seen: + txn.Txn().SetState(PosSysAddr, keyUptimeEffectiveWeight(addr), u64ToHash(nominal)) + txn.Txn().SetState(PosSysAddr, keyUptimeInactivity(addr), u64ToHash(0)) + eff = nominal + case duty: + decayed := eff * cfg.MicroEpochInactivityDecayBps / 10000 + if decayed < 1 { + decayed = 1 + } + txn.Txn().SetState(PosSysAddr, keyUptimeEffectiveWeight(addr), u64ToHash(decayed)) + incU64State(txn, keyUptimeInactivity(addr), 1) + eff = decayed + } + + // Micro-epoch duty/seen flags are working state only; clear them once applied + // so old flags cannot affect future uptime calculations. + txn.Txn().SetState(PosSysAddr, dutyKey, types.Hash{}) + txn.Txn().SetState(PosSysAddr, seenKey, types.Hash{}) + } + txn.Txn().SetState(PosSysAddr, keyMicroEpochApplied(), u64ToHash(me+1)) + } + + return nil +} diff --git a/consensus/ibft/pos/uptime_microepoch_test.go b/consensus/ibft/pos/uptime_microepoch_test.go new file mode 100644 index 0000000..06b5d4e --- /dev/null +++ b/consensus/ibft/pos/uptime_microepoch_test.go @@ -0,0 +1,178 @@ +package pos + +import ( + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestMicroEpochOfBlock(t *testing.T) { + require.Equal(t, uint64(0), microEpochOfBlock(0, 8)) + require.Equal(t, uint64(0), microEpochOfBlock(1, 8)) + require.Equal(t, uint64(0), microEpochOfBlock(8, 8)) + require.Equal(t, uint64(1), microEpochOfBlock(9, 8)) + require.Equal(t, uint64(1), microEpochOfBlock(16, 8)) + require.Equal(t, uint64(2), microEpochOfBlock(17, 8)) +} + +func TestApplyMicroEpochUptime_DutySeenSemantics(t *testing.T) { + txn := newPosTestTransition(t) + v0 := types.StringToAddress("0x1001") + v1 := types.StringToAddress("0x1002") + v2 := types.StringToAddress("0x1003") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v0), validators.NewECDSAValidator(v1), validators.NewECDSAValidator(v2)) + cfg := UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10000, MicroEpochInactivityDecayBps: 9000} + for _, a := range []types.Address{v0, v1, v2} { + txn.Txn().SetState(PosSysAddr, keyUptimeNominalWeight(a), u64ToHash(10000)) + txn.Txn().SetState(PosSysAddr, keyUptimeEffectiveWeight(a), u64ToHash(10000)) + } + txn.Txn().SetState(PosSysAddr, keyMicroEpochDuty(0, v0), u64ToHash(1)) + txn.Txn().SetState(PosSysAddr, keyMicroEpochDuty(0, v1), u64ToHash(1)) + txn.Txn().SetState(PosSysAddr, keyMicroEpochSeen(0, v1), u64ToHash(1)) + + require.NoError(t, applyMicroEpochUptime(txn, set, 3, types.ZeroAddress, cfg)) + require.Equal(t, uint64(9000), UptimeEffectiveWeight(txn.Txn(), v0)) + require.Equal(t, uint64(10000), UptimeEffectiveWeight(txn.Txn(), v1)) + require.Equal(t, uint64(10000), UptimeEffectiveWeight(txn.Txn(), v2)) + require.Zero(t, u64FromHash(txn.Txn().GetState(PosSysAddr, keyMicroEpochDuty(0, v0)))) + require.Zero(t, u64FromHash(txn.Txn().GetState(PosSysAddr, keyMicroEpochDuty(0, v1)))) + require.Zero(t, u64FromHash(txn.Txn().GetState(PosSysAddr, keyMicroEpochSeen(0, v1)))) +} + +func TestApplyMicroEpochUptime_RestoreUsesNominalNotEffective(t *testing.T) { + txn := newPosTestTransition(t) + v := types.StringToAddress("0x2001") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + cfg := UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10000, MicroEpochInactivityDecayBps: 9000} + txn.Txn().SetState(PosSysAddr, keyUptimeNominalWeight(v), u64ToHash(10000)) + txn.Txn().SetState(PosSysAddr, keyUptimeEffectiveWeight(v), u64ToHash(5000)) + txn.Txn().SetState(PosSysAddr, keyMicroEpochSeen(0, v), u64ToHash(1)) + require.NoError(t, applyMicroEpochUptime(txn, set, 3, types.ZeroAddress, cfg)) + require.Equal(t, uint64(10000), UptimeEffectiveWeight(txn.Txn(), v)) +} + +func TestApplyMicroEpochUptime_DoesNotRestoreFromCurrentBlockActual(t *testing.T) { + txn := newPosTestTransition(t) + v := types.StringToAddress("0x3001") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + cfg := UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10000, MicroEpochInactivityDecayBps: 9000} + txn.Txn().SetState(PosSysAddr, keyUptimeNominalWeight(v), u64ToHash(10000)) + txn.Txn().SetState(PosSysAddr, keyUptimeEffectiveWeight(v), u64ToHash(10000)) + txn.Txn().SetState(PosSysAddr, keyMicroEpochDuty(0, v), u64ToHash(1)) + require.NoError(t, applyMicroEpochUptime(txn, set, 3, v, cfg)) + require.Equal(t, uint64(9000), UptimeEffectiveWeight(txn.Txn(), v)) + require.Equal(t, uint64(1), u64FromHash(txn.Txn().GetState(PosSysAddr, keyUptimeInactivity(v)))) +} + +func TestApplyMicroEpochUptime_NoOpWhenMicroEpochSizeZero(t *testing.T) { + txn := newPosTestTransition(t) + v := types.StringToAddress("0x4001") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + cfg := UptimeConfig{MicroEpochSize: 0, MicroEpochNominalWeight: 10000, MicroEpochInactivityDecayBps: 9000} + txn.Txn().SetState(PosSysAddr, keyUptimeEffectiveWeight(v), u64ToHash(7777)) + require.NoError(t, applyMicroEpochUptime(txn, set, 3, v, cfg)) + require.Equal(t, uint64(7777), UptimeEffectiveWeight(txn.Txn(), v)) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyMicroEpochApplied()))) +} + +func TestRecordBlockUptime_MicroEpochMarksDutyAndSeen(t *testing.T) { + v := types.StringToAddress("0x5001") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + r := uint64(0) + extra := &signer.IstanbulExtra{Validators: set, RoundNumber: &r, CommittedSeals: &signer.SerializedSeal{}, ParentCommittedSeals: &signer.SerializedSeal{}} + h := &types.Header{Number: 11, ExtraData: extra.MarshalRLPTo(make([]byte, signer.IstanbulExtraVanity))} + s := &fixedSigner{proposer: v, extra: extra} + txn := newPosTestTransitionWithStaking(t, v) + cfg := UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10000, MicroEpochInactivityDecayBps: 9000} + require.NoError(t, RecordBlockUptime(h, 10, set, s, cfg, txn)) + me := microEpochOfBlock(h.Number, cfg.MicroEpochSize) + require.Equal(t, uint64(1), u64FromHash(txn.Txn().GetState(PosSysAddr, keyMicroEpochSeen(me, v)))) + require.Equal(t, uint64(1), u64FromHash(txn.Txn().GetState(PosSysAddr, keyMicroEpochDuty(me, v)))) + require.Equal(t, uint64(10000), UptimeNominalWeight(txn.Txn(), v)) + require.Equal(t, uint64(10000), UptimeEffectiveWeight(txn.Txn(), v)) +} + +func TestRecordBlockUptime_MicroEpochMissedDutyDecaysAfterBoundary(t *testing.T) { + txn := newPosTestTransition(t) + v := types.StringToAddress("0x6001") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + cfg := UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10000, MicroEpochInactivityDecayBps: 9000} + txn.Txn().SetState(PosSysAddr, keyUptimeNominalWeight(v), u64ToHash(10000)) + txn.Txn().SetState(PosSysAddr, keyUptimeEffectiveWeight(v), u64ToHash(10000)) + txn.Txn().SetState(PosSysAddr, keyMicroEpochDuty(0, v), u64ToHash(1)) + require.NoError(t, applyMicroEpochUptime(txn, set, 3, types.ZeroAddress, cfg)) + require.Equal(t, uint64(9000), UptimeEffectiveWeight(txn.Txn(), v)) +} + +func TestRecordBlockUptime_MicroEpochMismatchStillMarksDutyAndDecays(t *testing.T) { + a := types.StringToAddress("0x7001") + b := types.StringToAddress("0x7002") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(a), validators.NewECDSAValidator(b)) + txn := newPosTestTransitionWithStakingValidators(t, set, 1, uint64(set.Len())) + cfg := UptimeConfig{MicroEpochSize: 2, MicroEpochNominalWeight: 10000, MicroEpochInactivityDecayBps: 9000} + + for _, addr := range []types.Address{a, b} { + txn.Txn().SetState(PosSysAddr, keyUptimeNominalWeight(addr), u64ToHash(10000)) + txn.Txn().SetState(PosSysAddr, keyUptimeEffectiveWeight(addr), u64ToHash(10000)) + } + + // lastProposer=a => expected proposer for round 0 is b. We set actual proposer to a (mismatch). + setLastProposer(txn, a) + r := uint64(0) + extra := &signer.IstanbulExtra{Validators: set, RoundNumber: &r, CommittedSeals: &signer.SerializedSeal{}, ParentCommittedSeals: &signer.SerializedSeal{}} + h1 := &types.Header{Number: 11, ExtraData: extra.MarshalRLPTo(make([]byte, signer.IstanbulExtraVanity))} + s := &fixedSigner{proposer: a, extra: extra} + require.NoError(t, RecordBlockUptime(h1, 10, set, s, cfg, txn)) + + me0 := microEpochOfBlock(11, cfg.MicroEpochSize) + require.Equal(t, uint64(1), u64FromHash(txn.Txn().GetState(PosSysAddr, keyMicroEpochSeen(me0, a)))) + require.Equal(t, uint64(1), u64FromHash(txn.Txn().GetState(PosSysAddr, keyMicroEpochDuty(me0, b)))) + require.Equal(t, uint64(10000), UptimeEffectiveWeight(txn.Txn(), b)) + + h2 := &types.Header{Number: 13, ExtraData: extra.MarshalRLPTo(make([]byte, signer.IstanbulExtraVanity))} + require.NoError(t, RecordBlockUptime(h2, 10, set, s, cfg, txn)) + + require.Equal(t, uint64(9000), UptimeEffectiveWeight(txn.Txn(), b)) + require.Equal(t, uint64(1), u64FromHash(txn.Txn().GetState(PosSysAddr, keyUptimeInactivity(b)))) +} + +type fixedSigner struct { + proposer types.Address + extra *signer.IstanbulExtra +} + +func (m *fixedSigner) Type() validators.ValidatorType { return validators.ECDSAValidatorType } +func (m *fixedSigner) Address() types.Address { return m.proposer } +func (m *fixedSigner) InitIBFTExtra(*types.Header, validators.Validators, signer.Seals) {} +func (m *fixedSigner) GetIBFTExtra(*types.Header) (*signer.IstanbulExtra, error) { return m.extra, nil } +func (m *fixedSigner) GetValidators(*types.Header) (validators.Validators, error) { + return m.extra.Validators, nil +} +func (m *fixedSigner) WriteProposerSeal(h *types.Header) (*types.Header, error) { return h, nil } +func (m *fixedSigner) EcrecoverFromHeader(*types.Header) (types.Address, error) { + return m.proposer, nil +} +func (m *fixedSigner) CreateCommittedSeal([]byte) ([]byte, error) { return nil, nil } +func (m *fixedSigner) VerifyCommittedSeal(validators.Validators, types.Address, []byte, []byte) error { + return nil +} +func (m *fixedSigner) WriteCommittedSeals(*types.Header, uint64, map[types.Address][]byte) (*types.Header, error) { + return nil, nil +} +func (m *fixedSigner) VerifyCommittedSeals(types.Hash, signer.Seals, validators.Validators, int) error { + return nil +} +func (m *fixedSigner) VerifyParentCommittedSeals(types.Hash, *types.Header, validators.Validators, int, bool) error { + return nil +} +func (m *fixedSigner) SignIBFTMessage([]byte) ([]byte, error) { return nil, nil } +func (m *fixedSigner) EcrecoverFromIBFTMessage([]byte, []byte) (types.Address, error) { + return m.proposer, nil +} +func (m *fixedSigner) CalculateHeaderHash(*types.Header) (types.Hash, error) { + return types.ZeroHash, nil +} +func (m *fixedSigner) FilterHeaderForHash(h *types.Header) (*types.Header, error) { return h, nil } diff --git a/consensus/ibft/pos/uptime_record_test.go b/consensus/ibft/pos/uptime_record_test.go new file mode 100644 index 0000000..32f0dfa --- /dev/null +++ b/consensus/ibft/pos/uptime_record_test.go @@ -0,0 +1,293 @@ +package pos + +import ( + "errors" + "math/big" + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func makeUptimeHeader(number uint64, set validators.Validators) *types.Header { + extra := &signer.IstanbulExtra{ + Validators: set, + CommittedSeals: &signer.SerializedSeal{}, + ParentCommittedSeals: &signer.SerializedSeal{}, + } + + return &types.Header{ + Number: number, + ExtraData: extra.MarshalRLPTo(make([]byte, signer.IstanbulExtraVanity)), + } +} + +func makeUptimeHeaderWithFixedSigner(number uint64, set validators.Validators, proposer types.Address) (*types.Header, *fixedSigner) { + r := uint64(0) + extra := &signer.IstanbulExtra{ + Validators: set, + RoundNumber: &r, + CommittedSeals: &signer.SerializedSeal{}, + ParentCommittedSeals: &signer.SerializedSeal{}, + } + + return &types.Header{ + Number: number, + ExtraData: extra.MarshalRLPTo(make([]byte, signer.IstanbulExtraVanity)), + }, &fixedSigner{proposer: proposer, extra: extra} +} + +func TestRecordBlockUptime_ReturnsErrorWhenEpochValidatorSnapshotFreezeFails(t *testing.T) { + v := types.StringToAddress("0x1111") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + header := makeUptimeHeader(11, set) + txn := newPosTestTransitionWithStaking(t, v) + + origEnsure := ensureEpochValidatorsSnapshotFn + ensureEpochValidatorsSnapshotFn = func(_ *state.Transition, _ uint64, _ validators.Validators) (bool, error) { + return false, nil + } + defer func() { ensureEpochValidatorsSnapshotFn = origEnsure }() + + err := RecordBlockUptime(header, 10, set, testHeaderSigner(), UptimeConfig{}, txn) + require.Error(t, err) + require.Contains(t, err.Error(), "freeze epoch validator snapshot") +} + +func TestRecordBlockUptime_PropagatesEpochValidatorSnapshotFreezeError(t *testing.T) { + v := types.StringToAddress("0x1112") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + header := makeUptimeHeader(11, set) + txn := newPosTestTransitionWithStaking(t, v) + + origEnsure := ensureEpochValidatorsSnapshotFn + ensureEpochValidatorsSnapshotFn = func(_ *state.Transition, _ uint64, _ validators.Validators) (bool, error) { + return false, errors.New("snapshot cap exceeded") + } + defer func() { ensureEpochValidatorsSnapshotFn = origEnsure }() + + err := RecordBlockUptime(header, 10, set, testHeaderSigner(), UptimeConfig{}, txn) + require.Error(t, err) + require.Contains(t, err.Error(), "freeze epoch validator snapshot") + require.Contains(t, err.Error(), "snapshot cap exceeded") +} + +func TestRecordBlockUptime_IdempotentWhenEpochValidatorSnapshotExists(t *testing.T) { + v := types.StringToAddress("0x2222") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + header, fs := makeUptimeHeaderWithFixedSigner(11, set, v) + txn := newPosTestTransitionWithStaking(t, v) + epoch := epochOf(header.Number, 10) + requireSnapshotCreated(t, txn, epoch, set) + + origEnsure := ensureEpochValidatorsSnapshotFn + ensureEpochValidatorsSnapshotFn = func(_ *state.Transition, _ uint64, _ validators.Validators) (bool, error) { + t.Fatalf("ensureEpochValidatorsSnapshot should not be called when snapshot already exists") + return false, nil + } + defer func() { ensureEpochValidatorsSnapshotFn = origEnsure }() + + err := RecordBlockUptime(header, 10, set, fs, UptimeConfig{}, txn) + require.NoError(t, err) + require.Equal(t, header.Number, u64FromHash(txn.Txn().GetState(PosSysAddr, keyUptimeLastProcessedSlot()))) + slots := u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch, v))) + require.NoError(t, RecordBlockUptime(header, 10, set, fs, UptimeConfig{}, txn)) + require.Equal(t, slots, u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch, v)))) +} + +func TestRecordBlockUptime_ReturnsErrorWhenStakeSnapshotFreezeFails(t *testing.T) { + v := types.StringToAddress("0x3333") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + header := makeUptimeHeader(11, set) + txn := newPosTestTransitionWithStaking(t, v) + + origStake := getOrInitStakeSnapshotFn + getOrInitStakeSnapshotFn = func(_ *state.Transition, _ uint64, _ types.Address) (*big.Int, error) { + return nil, errors.New("injected stake snapshot failure") + } + defer func() { getOrInitStakeSnapshotFn = origStake }() + + err := RecordBlockUptime(header, 10, set, testHeaderSigner(), UptimeConfig{}, txn) + require.Error(t, err) + require.Contains(t, err.Error(), "freeze stake snapshot") +} + +func TestRecordBlockUptime_UsesHeaderValidatorSetWhenEpochValidatorsUnavailable(t *testing.T) { + v := types.StringToAddress("0x4444") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + header, fs := makeUptimeHeaderWithFixedSigner(11, set, v) + txn := newPosTestTransitionWithStaking(t, v) + + origEnsure := ensureEpochValidatorsSnapshotFn + var capturedLen int + ensureEpochValidatorsSnapshotFn = func(st *state.Transition, epoch uint64, got validators.Validators) (bool, error) { + if got != nil { + capturedLen = got.Len() + } + + return origEnsure(st, epoch, got) + } + defer func() { ensureEpochValidatorsSnapshotFn = origEnsure }() + + err := RecordBlockUptime(header, 10, nil, fs, UptimeConfig{}, txn) + require.NoError(t, err) + require.Equal(t, set.Len(), capturedLen) +} + +func TestRecordBlockUptime_DoesNotRefreezeEpochSnapshotWhenReprocessingWithMissingEpochValidators(t *testing.T) { + v := types.StringToAddress("0x5555") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + header, fs := makeUptimeHeaderWithFixedSigner(11, set, v) + txn := newPosTestTransitionWithStaking(t, v) + + origEnsure := ensureEpochValidatorsSnapshotFn + calls := 0 + ensureEpochValidatorsSnapshotFn = func(st *state.Transition, epoch uint64, got validators.Validators) (bool, error) { + calls++ + return origEnsure(st, epoch, got) + } + defer func() { ensureEpochValidatorsSnapshotFn = origEnsure }() + + require.NoError(t, RecordBlockUptime(header, 10, nil, fs, UptimeConfig{}, txn)) + require.NoError(t, RecordBlockUptime(header, 10, nil, fs, UptimeConfig{}, txn)) + require.Equal(t, 1, calls) +} + +func TestRecordBlockUptime_FreezesEpochSnapshotsOnceAndKeepsFinalizeBasisStable(t *testing.T) { + v1 := types.StringToAddress("0x7771") + v2 := types.StringToAddress("0x7772") + set := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(v1), + validators.NewECDSAValidator(v2), + ) + headerA, fsA := makeUptimeHeaderWithFixedSigner(11, set, v1) // first non-boundary block of epoch 2 + headerB, fsB := makeUptimeHeaderWithFixedSigner(12, set, v1) + txn := newPosTestTransitionWithStakingValidators(t, set, 1, 10) + epoch := epochOf(headerA.Number, 10) + + writeStakedAmount(txn, v1, big.NewInt(100)) + writeStakedAmount(txn, v2, big.NewInt(200)) + + origEnsure := ensureEpochValidatorsSnapshotFn + origStake := getOrInitStakeSnapshotFn + origStakerStake := getOrInitStakerStakeSnapshotFn + calls := 0 + currentStake := map[types.Address]*big.Int{ + v1: big.NewInt(100), + v2: big.NewInt(200), + } + ensureEpochValidatorsSnapshotFn = func(st *state.Transition, ep uint64, got validators.Validators) (bool, error) { + calls++ + return origEnsure(st, ep, got) + } + getOrInitStakeSnapshotFn = func(st *state.Transition, ep uint64, addr types.Address) (*big.Int, error) { + key := keyStakeSnapshot(ep, addr) + cur := bigFromHash(st.Txn().GetState(PosSysAddr, key)) + if cur.Sign() != 0 { + return cur, nil + } + v, ok := currentStake[addr] + if !ok { + v = big.NewInt(0) + } + st.Txn().SetState(PosSysAddr, key, bigToHash(v)) + return new(big.Int).Set(v), nil + } + getOrInitStakerStakeSnapshotFn = func(st *state.Transition, ep uint64, addr types.Address) (*big.Int, error) { + key := keyStakerStakeSnapshot(ep, addr) + cur := bigFromHash(st.Txn().GetState(PosSysAddr, key)) + if cur.Sign() != 0 { + return cur, nil + } + v, ok := currentStake[addr] + if !ok { + v = big.NewInt(0) + } + st.Txn().SetState(PosSysAddr, key, bigToHash(v)) + return new(big.Int).Set(v), nil + } + defer func() { + ensureEpochValidatorsSnapshotFn = origEnsure + getOrInitStakeSnapshotFn = origStake + getOrInitStakerStakeSnapshotFn = origStakerStake + }() + + require.NoError(t, RecordBlockUptime(headerA, 10, set, fsA, UptimeConfig{}, txn)) + require.Equal(t, 1, calls) + + // Mutate staking state after the initial epoch freeze. + writeStakedAmount(txn, v1, big.NewInt(999)) + currentStake[v1] = big.NewInt(999) + setValidatorInactiveInStaking(txn, v2, 12) + require.False(t, isValidatorMetaActive(bigFromHash(txn.Txn().GetState(staking.AddrStakingContract, stakingMetaPackedKey(v2))))) + + require.NoError(t, RecordBlockUptime(headerB, 10, set, fsB, UptimeConfig{}, txn)) + require.Equal(t, 1, calls, "epoch snapshot must only be frozen once per epoch") + + // Snapshot-backed finalize basis must stay frozen to the first processed block state. + require.Equal(t, int64(100), bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakeSnapshot(epoch, v1))).Int64()) + require.Equal(t, int64(200), bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakeSnapshot(epoch, v2))).Int64()) + require.ElementsMatch(t, []types.Address{v1, v2}, loadEpochValidatorsSnapshot(txn, epoch)) +} + +func TestRecordBlockUptime_ProposerUnavailableDoesNotOverwriteSnapshotOrDoubleCount(t *testing.T) { + v := types.StringToAddress("0x8881") + set := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v)) + header := makeUptimeHeader(11, set) // empty proposer seal => proposer unavailable path + txn := newPosTestTransitionWithStakingValidators(t, set, 1, 10) + epoch := epochOf(header.Number, 10) + + writeStakedAmount(txn, v, big.NewInt(55)) + + origEnsure := ensureEpochValidatorsSnapshotFn + origStake := getOrInitStakeSnapshotFn + origStakerStake := getOrInitStakerStakeSnapshotFn + calls := 0 + currentStake := big.NewInt(55) + ensureEpochValidatorsSnapshotFn = func(st *state.Transition, ep uint64, got validators.Validators) (bool, error) { + calls++ + return origEnsure(st, ep, got) + } + getOrInitStakeSnapshotFn = func(st *state.Transition, ep uint64, addr types.Address) (*big.Int, error) { + key := keyStakeSnapshot(ep, addr) + cur := bigFromHash(st.Txn().GetState(PosSysAddr, key)) + if cur.Sign() != 0 { + return cur, nil + } + st.Txn().SetState(PosSysAddr, key, bigToHash(currentStake)) + return new(big.Int).Set(currentStake), nil + } + getOrInitStakerStakeSnapshotFn = func(st *state.Transition, ep uint64, addr types.Address) (*big.Int, error) { + key := keyStakerStakeSnapshot(ep, addr) + cur := bigFromHash(st.Txn().GetState(PosSysAddr, key)) + if cur.Sign() != 0 { + return cur, nil + } + st.Txn().SetState(PosSysAddr, key, bigToHash(currentStake)) + return new(big.Int).Set(currentStake), nil + } + defer func() { + ensureEpochValidatorsSnapshotFn = origEnsure + getOrInitStakeSnapshotFn = origStake + getOrInitStakerStakeSnapshotFn = origStakerStake + }() + + require.Error(t, RecordBlockUptime(header, 10, set, testHeaderSigner(), UptimeConfig{}, txn)) + require.Equal(t, 1, calls) + require.Equal(t, int64(55), bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakeSnapshot(epoch, v))).Int64()) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch, v)))) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerMissed(epoch, v)))) + + // Reprocessing same block with changed live stake must not rewrite frozen snapshot or double count. + writeStakedAmount(txn, v, big.NewInt(777)) + currentStake = big.NewInt(777) + require.Error(t, RecordBlockUptime(header, 10, set, testHeaderSigner(), UptimeConfig{}, txn)) + require.Equal(t, 1, calls) + require.Equal(t, int64(55), bigFromHash(txn.Txn().GetState(PosSysAddr, keyStakeSnapshot(epoch, v))).Int64()) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerSlots(epoch, v)))) + require.Equal(t, uint64(0), u64FromHash(txn.Txn().GetState(PosSysAddr, keyProposerMissed(epoch, v)))) +} diff --git a/consensus/ibft/pos/uptime_state_account.go b/consensus/ibft/pos/uptime_state_account.go new file mode 100644 index 0000000..5b95353 --- /dev/null +++ b/consensus/ibft/pos/uptime_state_account.go @@ -0,0 +1,25 @@ +package pos + +import "github.com/xgr-network/xgr-node/types" + +// TxnWrapper captures SetState/GetState used by uptime helpers. +type TxnWrapper interface { + SetState(types.Address, types.Hash, types.Hash) + GetState(types.Address, types.Hash) types.Hash +} + +type nonceTxnWrapper interface { + GetNonce(types.Address) uint64 + SetNonce(types.Address, uint64) +} + +func ensureUptimeStateAccount(tx TxnWrapper) { + nonceTx, ok := tx.(nonceTxnWrapper) + if !ok { + return + } + + if nonceTx.GetNonce(PosSysAddr) == 0 { + nonceTx.SetNonce(PosSysAddr, 1) + } +} diff --git a/consensus/ibft/pos/uptime_test.go b/consensus/ibft/pos/uptime_test.go new file mode 100644 index 0000000..3c7917d --- /dev/null +++ b/consensus/ibft/pos/uptime_test.go @@ -0,0 +1,44 @@ +package pos + +import ( + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestDeriveLastProposer(t *testing.T) { + v1 := validators.NewECDSAValidator(types.StringToAddress("0x1001")) + v2 := validators.NewECDSAValidator(types.StringToAddress("0x1002")) + v3 := validators.NewECDSAValidator(types.StringToAddress("0x1003")) + v4 := validators.NewECDSAValidator(types.StringToAddress("0x1004")) + set := validators.NewECDSAValidatorSet(v1, v2, v3, v4) + + t.Run("round zero derives previous validator", func(t *testing.T) { + last := deriveLastProposer(set, 0, v3.Addr()) + require.Equal(t, v2.Addr(), last) + }) + + t.Run("non-zero round derives parent proposer", func(t *testing.T) { + last := deriveLastProposer(set, 2, v1.Addr()) + require.Equal(t, v2.Addr(), last) + + expected := calcProposer(set, 2, last) + require.Equal(t, v1.Addr(), expected) + }) + + t.Run("wrap-around works", func(t *testing.T) { + last := deriveLastProposer(set, 1, v1.Addr()) + require.Equal(t, v3.Addr(), last) + + expected := calcProposer(set, 1, last) + require.Equal(t, v1.Addr(), expected) + }) + + t.Run("unknown proposer returns zero", func(t *testing.T) { + last := deriveLastProposer(set, 0, types.StringToAddress("0x9999")) + require.Equal(t, types.ZeroAddress, last) + }) +} + diff --git a/consensus/ibft/pos/uptime_test_helpers_test.go b/consensus/ibft/pos/uptime_test_helpers_test.go new file mode 100644 index 0000000..48349bf --- /dev/null +++ b/consensus/ibft/pos/uptime_test_helpers_test.go @@ -0,0 +1,82 @@ +package pos + +import ( + "github.com/hashicorp/go-hclog" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + xcrypto "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +// deriveLastProposer is test helper that reconstructs previous proposer context. +func deriveLastProposer(set validators.Validators, round uint64, proposer types.Address) types.Address { + if set == nil || set.Len() == 0 { + return types.ZeroAddress + } + + idx := set.Index(proposer) + if idx == -1 { + return types.ZeroAddress + } + + l := uint64(set.Len()) + lastIdx := (uint64(idx) + l - ((round+1)%l)) % l + + return set.At(lastIdx).Addr() +} + +// collectSignedAddresses is a test helper for seal/bitmap signer extraction. +func collectSignedAddresses(extra *signer.IstanbulExtra, blockHash types.Hash, _ hclog.Logger) map[types.Address]struct{} { + seen := make(map[types.Address]struct{}) + if extra == nil || extra.Validators == nil || extra.ParentCommittedSeals == nil { + return seen + } + + switch seals := extra.ParentCommittedSeals.(type) { + case *signer.AggregatedSeal: + if seals.Bitmap == nil { + return seen + } + + for i := 0; i < extra.Validators.Len(); i++ { + if seals.Bitmap.Bit(i) == 0 { + continue + } + + seen[extra.Validators.At(uint64(i)).Addr()] = struct{}{} + } + case *signer.SerializedSeal: + digest := signer.LegacyCommitDigest(blockHash.Bytes()) + + for _, sig := range *seals { + pub, err := xcrypto.RecoverPubkey(sig, digest) + if err != nil { + continue + } + + seen[xcrypto.PubKeyToAddress(pub)] = struct{}{} + } + } + + return seen +} + +// shouldSkipUptimeAccounting mirrors old guard behavior used by dedicated tests. +func shouldSkipUptimeAccounting(extra *signer.IstanbulExtra, _ hclog.Logger, signed map[types.Address]struct{}) bool { + if extra == nil || extra.ParentCommittedSeals == nil { + return true + } + + switch seals := extra.ParentCommittedSeals.(type) { + case *signer.AggregatedSeal: + if seals.Bitmap != nil && seals.Bitmap.Sign() > 0 { + if extra.Validators == nil || extra.Validators.Len() == 0 { + return true + } + + return len(signed) == 0 + } + } + + return false +} diff --git a/consensus/ibft/pos/uptime_weight.go b/consensus/ibft/pos/uptime_weight.go new file mode 100644 index 0000000..9dc3649 --- /dev/null +++ b/consensus/ibft/pos/uptime_weight.go @@ -0,0 +1,44 @@ +package pos + +import ( + "math/big" + + "github.com/xgr-network/xgr-node/types" +) + +func EffectiveWeight(tx TxnWrapper, addr types.Address, cfg UptimeConfig) uint64 { + eff := u64FromHash(tx.GetState(PosSysAddr, keyUptimeEffectiveWeight(addr))) + if eff > 0 { + return eff + } + + nom := u64FromHash(tx.GetState(PosSysAddr, keyUptimeNominalWeight(addr))) + if nom > 0 { + return nom + } + + return cfg.MicroEpochNominalWeight +} + +func WeightedStake(stake *big.Int, effective, nominal uint64) *big.Int { + if stake == nil || stake.Sign() == 0 || nominal == 0 { + return new(big.Int) + } + if effective >= nominal { + return new(big.Int).Set(stake) + } + num := new(big.Int).Mul(stake, new(big.Int).SetUint64(effective)) + return num.Div(num, new(big.Int).SetUint64(nominal)) +} + +func UptimeNominalWeight(tx TxnWrapper, addr types.Address) uint64 { + return u64FromHash(tx.GetState(PosSysAddr, keyUptimeNominalWeight(addr))) +} + +func UptimeEffectiveWeight(tx TxnWrapper, addr types.Address) uint64 { + return u64FromHash(tx.GetState(PosSysAddr, keyUptimeEffectiveWeight(addr))) +} + +func UptimeInactivity(tx TxnWrapper, addr types.Address) uint64 { + return u64FromHash(tx.GetState(PosSysAddr, keyUptimeInactivity(addr))) +} diff --git a/consensus/ibft/proto/ibft_operator.pb.go b/consensus/ibft/proto/ibft_operator.pb.go index 2863467..ff7cb5d 100644 --- a/consensus/ibft/proto/ibft_operator.pb.go +++ b/consensus/ibft/proto/ibft_operator.pb.go @@ -128,10 +128,14 @@ type Snapshot struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - Validators []*Snapshot_Validator `protobuf:"bytes,1,rep,name=validators,proto3" json:"validators,omitempty"` - Number uint64 `protobuf:"varint,2,opt,name=number,proto3" json:"number,omitempty"` - Hash string `protobuf:"bytes,3,opt,name=hash,proto3" json:"hash,omitempty"` - Votes []*Snapshot_Vote `protobuf:"bytes,4,rep,name=votes,proto3" json:"votes,omitempty"` + Validators []*Snapshot_Validator `protobuf:"bytes,1,rep,name=validators,proto3" json:"validators,omitempty"` + Number uint64 `protobuf:"varint,2,opt,name=number,proto3" json:"number,omitempty"` + Hash string `protobuf:"bytes,3,opt,name=hash,proto3" json:"hash,omitempty"` + Votes []*Snapshot_Vote `protobuf:"bytes,4,rep,name=votes,proto3" json:"votes,omitempty"` + MicroEpoch uint64 `protobuf:"varint,5,opt,name=micro_epoch,json=microEpoch,proto3" json:"micro_epoch,omitempty"` + UptimeEpoch uint64 `protobuf:"varint,6,opt,name=uptime_epoch,json=uptimeEpoch,proto3" json:"uptime_epoch,omitempty"` + UptimeTotalEffectiveWeight uint64 `protobuf:"varint,7,opt,name=uptime_total_effective_weight,json=uptimeTotalEffectiveWeight,proto3" json:"uptime_total_effective_weight,omitempty"` + UptimeActiveEffectiveWeight uint64 `protobuf:"varint,8,opt,name=uptime_active_effective_weight,json=uptimeActiveEffectiveWeight,proto3" json:"uptime_active_effective_weight,omitempty"` } func (x *Snapshot) Reset() { @@ -194,6 +198,34 @@ func (x *Snapshot) GetVotes() []*Snapshot_Vote { return nil } +func (x *Snapshot) GetMicroEpoch() uint64 { + if x != nil { + return x.MicroEpoch + } + return 0 +} + +func (x *Snapshot) GetUptimeEpoch() uint64 { + if x != nil { + return x.UptimeEpoch + } + return 0 +} + +func (x *Snapshot) GetUptimeTotalEffectiveWeight() uint64 { + if x != nil { + return x.UptimeTotalEffectiveWeight + } + return 0 +} + +func (x *Snapshot) GetUptimeActiveEffectiveWeight() uint64 { + if x != nil { + return x.UptimeActiveEffectiveWeight + } + return 0 +} + type ProposeReq struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache @@ -364,9 +396,12 @@ type Snapshot_Validator struct { sizeCache protoimpl.SizeCache unknownFields protoimpl.UnknownFields - Type string `protobuf:"bytes,1,opt,name=type,proto3" json:"type,omitempty"` - Address string `protobuf:"bytes,2,opt,name=address,proto3" json:"address,omitempty"` - Data []byte `protobuf:"bytes,3,opt,name=data,proto3" json:"data,omitempty"` + Type string `protobuf:"bytes,1,opt,name=type,proto3" json:"type,omitempty"` + Address string `protobuf:"bytes,2,opt,name=address,proto3" json:"address,omitempty"` + Data []byte `protobuf:"bytes,3,opt,name=data,proto3" json:"data,omitempty"` + UptimeNominalWeight uint64 `protobuf:"varint,4,opt,name=uptime_nominal_weight,json=uptimeNominalWeight,proto3" json:"uptime_nominal_weight,omitempty"` + UptimeEffectiveWeight uint64 `protobuf:"varint,5,opt,name=uptime_effective_weight,json=uptimeEffectiveWeight,proto3" json:"uptime_effective_weight,omitempty"` + UptimeInactivity uint64 `protobuf:"varint,6,opt,name=uptime_inactivity,json=uptimeInactivity,proto3" json:"uptime_inactivity,omitempty"` } func (x *Snapshot_Validator) Reset() { @@ -422,6 +457,27 @@ func (x *Snapshot_Validator) GetData() []byte { return nil } +func (x *Snapshot_Validator) GetUptimeNominalWeight() uint64 { + if x != nil { + return x.UptimeNominalWeight + } + return 0 +} + +func (x *Snapshot_Validator) GetUptimeEffectiveWeight() uint64 { + if x != nil { + return x.UptimeEffectiveWeight + } + return 0 +} + +func (x *Snapshot_Validator) GetUptimeInactivity() uint64 { + if x != nil { + return x.UptimeInactivity + } + return 0 +} + type Snapshot_Vote struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache diff --git a/consensus/ibft/proto/ibft_operator.proto b/consensus/ibft/proto/ibft_operator.proto index 8c75026..90710e6 100644 --- a/consensus/ibft/proto/ibft_operator.proto +++ b/consensus/ibft/proto/ibft_operator.proto @@ -31,10 +31,18 @@ message Snapshot { repeated Vote votes = 4; + uint64 micro_epoch = 5; + uint64 uptime_epoch = 6; + uint64 uptime_total_effective_weight = 7; + uint64 uptime_active_effective_weight = 8; + message Validator { string type = 1; string address = 2; bytes data = 3; + uint64 uptime_nominal_weight = 4; + uint64 uptime_effective_weight = 5; + uint64 uptime_inactivity = 6; } message Vote { diff --git a/consensus/ibft/quorum_semantics_test.go b/consensus/ibft/quorum_semantics_test.go new file mode 100644 index 0000000..8dcb9fc --- /dev/null +++ b/consensus/ibft/quorum_semantics_test.go @@ -0,0 +1,96 @@ +package ibft + +import ( + "math/big" + "strconv" + "testing" + + "github.com/stretchr/testify/require" +) + +func TestHasWeightedQuorum_ThresholdMatrix(t *testing.T) { + t.Parallel() + + cases := []struct { + name string + total uint64 + collected uint64 + ok bool + }{ + {name: "total=0,signed=0", total: 0, collected: 0, ok: false}, + {name: "total=5,signed=0", total: 5, collected: 0, ok: false}, + {name: "total=0,signed=1", total: 0, collected: 1, ok: false}, + {name: "total=5,signed=3", total: 5, collected: 3, ok: false}, + {name: "total=5,signed=4", total: 5, collected: 4, ok: true}, + {name: "total=6,signed=4", total: 6, collected: 4, ok: true}, + {name: "total=6,signed=3", total: 6, collected: 3, ok: false}, + {name: "total=8,signed=5", total: 8, collected: 5, ok: false}, + {name: "total=8,signed=6", total: 8, collected: 6, ok: true}, + {name: "total=9,signed=6", total: 9, collected: 6, ok: true}, + {name: "total=9,signed=5", total: 9, collected: 5, ok: false}, + } + + for _, tc := range cases { + tc := tc + t.Run(tc.name, func(t *testing.T) { + t.Parallel() + + require.Equal( + t, + tc.ok, + hasWeightedQuorum( + new(big.Int).SetUint64(tc.collected), + new(big.Int).SetUint64(tc.total), + ), + ) + }) + } +} + +func TestEqualWeights_PoAAndWeightedSemantics(t *testing.T) { + t.Parallel() + + cases := []struct { + totalPower uint64 + weightedQuorum uint64 + classicPoAQuorum int + }{ + // Weighted PoS quorum intentionally uses ceil(2/3 * totalVotingPower). + // For N=3 equal unit weights this differs from classic IBFT + // OptimalQuorumSize, which requires the full set when F=0. + {totalPower: 1, weightedQuorum: 1, classicPoAQuorum: 1}, + {totalPower: 2, weightedQuorum: 2, classicPoAQuorum: 2}, + {totalPower: 3, weightedQuorum: 2, classicPoAQuorum: 3}, + {totalPower: 5, weightedQuorum: 4, classicPoAQuorum: 4}, + {totalPower: 6, weightedQuorum: 4, classicPoAQuorum: 4}, + {totalPower: 8, weightedQuorum: 6, classicPoAQuorum: 6}, + {totalPower: 9, weightedQuorum: 6, classicPoAQuorum: 6}, + } + + for _, tc := range cases { + tc := tc + t.Run("N="+strconv.FormatUint(tc.totalPower, 10), func(t *testing.T) { + t.Parallel() + + pool := newTesterAccountPool(t, int(tc.totalPower)) + require.Equal(t, tc.classicPoAQuorum, OptimalQuorumSize(pool.ValidatorSet())) + require.Equal( + t, + new(big.Int).SetUint64(tc.weightedQuorum), + weightedQuorumThreshold(new(big.Int).SetUint64(tc.totalPower)), + ) + }) + } +} + +func TestSnapshotVotingPowers_UsesUnifiedWeightedThreshold(t *testing.T) { + t.Parallel() + + pool := newTesterAccountPool(t, 6) + backend := &backendIBFT{} + + _, snapshot, err := backend.snapshotVotingPowers(1, 0, pool.ValidatorSet(), nil, false) + require.NoError(t, err) + require.Equal(t, "6", snapshot.totalVotingPower) + require.Equal(t, "4", snapshot.quorumThreshold) +} diff --git a/consensus/ibft/signer/extra.go b/consensus/ibft/signer/extra.go index 82fd189..8ac4e56 100644 --- a/consensus/ibft/signer/extra.go +++ b/consensus/ibft/signer/extra.go @@ -283,6 +283,10 @@ func packProposerSealIntoExtra( newArrayValue.Set(oldValues[4]) } + for idx := 5; idx < len(oldValues); idx++ { + newArrayValue.Set(oldValues[idx]) + } + return nil }, ) @@ -325,6 +329,10 @@ func packCommittedSealsAndRoundNumberIntoExtra( )) } + for idx := 5; idx < len(oldValues); idx++ { + newArrayValue.Set(oldValues[idx]) + } + return nil }, ) diff --git a/consensus/ibft/signer/extra_core_test.go b/consensus/ibft/signer/extra_core_test.go new file mode 100644 index 0000000..3b43cff --- /dev/null +++ b/consensus/ibft/signer/extra_core_test.go @@ -0,0 +1,35 @@ +package signer + +import ( + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestIstanbulExtra_CoreRLPFieldsOnly(t *testing.T) { + t.Parallel() + + round := uint64(7) + set := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(types.StringToAddress("0x1001")), + ) + extra := &IstanbulExtra{ + Validators: set, + ProposerSeal: []byte{0x1, 0x2}, + CommittedSeals: &SerializedSeal{[]byte{0xaa}}, + ParentCommittedSeals: &SerializedSeal{[]byte{0xbb}}, + RoundNumber: &round, + } + + enc := extra.MarshalRLPTo(nil) + dec := &IstanbulExtra{Validators: validators.NewECDSAValidatorSet(), CommittedSeals: &SerializedSeal{}, ParentCommittedSeals: &SerializedSeal{}} + require.NoError(t, dec.UnmarshalRLP(enc)) + require.Equal(t, 1, dec.Validators.Len()) + require.Equal(t, []byte{0x1, 0x2}, dec.ProposerSeal) + require.Equal(t, 1, dec.CommittedSeals.Num()) + require.Equal(t, 1, dec.ParentCommittedSeals.Num()) + require.NotNil(t, dec.RoundNumber) + require.Equal(t, round, *dec.RoundNumber) +} diff --git a/consensus/ibft/signer/extra_test.go b/consensus/ibft/signer/extra_test.go deleted file mode 100644 index 9c5a753..0000000 --- a/consensus/ibft/signer/extra_test.go +++ /dev/null @@ -1,491 +0,0 @@ -package signer - -import ( - "encoding/json" - "math/big" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/xgr-network/xgr-node/types" - "github.com/xgr-network/xgr-node/validators" -) - -func JSONMarshalHelper(t *testing.T, extra *IstanbulExtra) string { - t.Helper() - - res, err := json.Marshal(extra) - - assert.NoError(t, err) - - return string(res) -} - -func TestIstanbulExtraMarshalAndUnmarshal(t *testing.T) { - tests := []struct { - name string - extra *IstanbulExtra - }{ - { - name: "ECDSAExtra", - extra: &IstanbulExtra{ - Validators: validators.NewECDSAValidatorSet( - validators.NewECDSAValidator( - testAddr1, - ), - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &SerializedSeal{ - []byte{0x1}, - []byte{0x2}, - }, - ParentCommittedSeals: &SerializedSeal{ - []byte{0x3}, - []byte{0x4}, - }, - }, - }, - { - name: "ECDSAExtra without ParentCommittedSeals", - extra: &IstanbulExtra{ - Validators: validators.NewECDSAValidatorSet( - ecdsaValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &SerializedSeal{ - []byte{0x1}, - []byte{0x2}, - }, - }, - }, - { - name: "BLSExtra", - extra: &IstanbulExtra{ - Validators: validators.NewBLSValidatorSet( - blsValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x8}), - Signature: []byte{0x1}, - }, - ParentCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x9}), - Signature: []byte{0x2}, - }, - }, - }, - { - name: "BLSExtra without ParentCommittedSeals", - extra: &IstanbulExtra{ - Validators: validators.NewBLSValidatorSet( - blsValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x8}), - Signature: []byte{0x1}, - }, - ParentCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x9}), - Signature: []byte{0x2}, - }, - }, - }, - } - - for _, test := range tests { - test := test - - t.Run(test.name, func(t *testing.T) { - // create original data - originalExtraJSON := JSONMarshalHelper(t, test.extra) - - bytesData := test.extra.MarshalRLPTo(nil) - err := test.extra.UnmarshalRLP(bytesData) - assert.NoError(t, err) - - // make sure all data is recovered - assert.Equal( - t, - originalExtraJSON, - JSONMarshalHelper(t, test.extra), - ) - }) - } -} - -func Test_packProposerSealIntoExtra(t *testing.T) { - newProposerSeal := []byte("new proposer seal") - - tests := []struct { - name string - extra *IstanbulExtra - }{ - { - name: "ECDSAExtra", - extra: &IstanbulExtra{ - Validators: validators.NewECDSAValidatorSet( - ecdsaValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &SerializedSeal{ - []byte{0x1}, - []byte{0x2}, - }, - ParentCommittedSeals: &SerializedSeal{ - []byte{0x3}, - []byte{0x4}, - }, - }, - }, - { - name: "ECDSAExtra without ParentCommittedSeals", - extra: &IstanbulExtra{ - Validators: validators.NewECDSAValidatorSet( - ecdsaValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &SerializedSeal{ - []byte{0x1}, - []byte{0x2}, - }, - }, - }, - { - name: "BLSExtra", - extra: &IstanbulExtra{ - Validators: validators.NewBLSValidatorSet( - blsValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x8}), - Signature: []byte{0x1}, - }, - ParentCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x9}), - Signature: []byte{0x2}, - }, - }, - }, - { - name: "BLSExtra without ParentCommittedSeals", - extra: &IstanbulExtra{ - Validators: validators.NewBLSValidatorSet( - blsValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x8}), - Signature: []byte{0x1}, - }, - ParentCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x9}), - Signature: []byte{0x2}, - }, - }, - }, - } - - for _, test := range tests { - test := test - - t.Run(test.name, func(t *testing.T) { - originalProposerSeal := test.extra.ProposerSeal - - // create expected data - test.extra.ProposerSeal = newProposerSeal - expectedJSON := JSONMarshalHelper(t, test.extra) - test.extra.ProposerSeal = originalProposerSeal - - newExtraBytes := packProposerSealIntoExtra( - // prepend IstanbulExtraHeader to parse - append( - make([]byte, IstanbulExtraVanity), - test.extra.MarshalRLPTo(nil)..., - ), - newProposerSeal, - ) - - assert.NoError( - t, - test.extra.UnmarshalRLP(newExtraBytes[IstanbulExtraVanity:]), - ) - - // check json of decoded data matches with the original data - jsonData := JSONMarshalHelper(t, test.extra) - - assert.Equal( - t, - expectedJSON, - jsonData, - ) - }) - } -} - -func Test_packCommittedSealsAndRoundNumberIntoExtra(t *testing.T) { - tests := []struct { - name string - extra *IstanbulExtra - newCommittedSeals Seals - roundNumber *uint64 - }{ - { - name: "ECDSAExtra", - extra: &IstanbulExtra{ - Validators: validators.NewECDSAValidatorSet( - ecdsaValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &SerializedSeal{ - []byte{0x1}, - []byte{0x2}, - }, - ParentCommittedSeals: &SerializedSeal{ - []byte{0x3}, - []byte{0x4}, - }, - }, - newCommittedSeals: &SerializedSeal{ - []byte{0x3}, - []byte{0x4}, - }, - roundNumber: nil, - }, - { - name: "ECDSAExtra without ParentCommittedSeals", - extra: &IstanbulExtra{ - Validators: validators.NewECDSAValidatorSet( - ecdsaValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &SerializedSeal{ - []byte{0x1}, - []byte{0x2}, - }, - }, - newCommittedSeals: &SerializedSeal{ - []byte{0x3}, - []byte{0x4}, - }, - roundNumber: nil, - }, - { - name: "BLSExtra", - extra: &IstanbulExtra{ - Validators: validators.NewBLSValidatorSet( - blsValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x8}), - Signature: []byte{0x1}, - }, - ParentCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x9}), - Signature: []byte{0x2}, - }, - }, - newCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0xa}), - Signature: []byte{0x2}, - }, - roundNumber: nil, - }, - { - name: "BLSExtra without ParentCommittedSeals", - extra: &IstanbulExtra{ - Validators: validators.NewBLSValidatorSet( - blsValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x8}), - Signature: []byte{0x1}, - }, - ParentCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x9}), - Signature: []byte{0x2}, - }, - }, - newCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0xa}), - Signature: []byte{0x2}, - }, - roundNumber: nil, - }, - } - - for _, test := range tests { - test := test - - t.Run(test.name, func(t *testing.T) { - originalCommittedSeals := test.extra.CommittedSeals - - // create expected data - test.extra.CommittedSeals = test.newCommittedSeals - expectedJSON := JSONMarshalHelper(t, test.extra) - test.extra.CommittedSeals = originalCommittedSeals - - // update committed seals - newExtraBytes := packCommittedSealsAndRoundNumberIntoExtra( - // prepend IstanbulExtraHeader - append( - make([]byte, IstanbulExtraVanity), - test.extra.MarshalRLPTo(nil)..., - ), - test.newCommittedSeals, - test.roundNumber, - ) - - // decode RLP data - assert.NoError( - t, - test.extra.UnmarshalRLP(newExtraBytes[IstanbulExtraVanity:]), - ) - - // check json of decoded data matches with the original data - jsonData := JSONMarshalHelper(t, test.extra) - - assert.Equal( - t, - expectedJSON, - jsonData, - ) - }) - } -} - -func Test_unmarshalRLPForParentCS(t *testing.T) { - tests := []struct { - name string - extra *IstanbulExtra - targetExtra *IstanbulExtra - }{ - { - name: "ECDSAExtra", - extra: &IstanbulExtra{ - Validators: validators.NewECDSAValidatorSet( - ecdsaValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &SerializedSeal{ - []byte{0x1}, - []byte{0x2}, - }, - ParentCommittedSeals: &SerializedSeal{ - []byte{0x3}, - []byte{0x4}, - }, - }, - targetExtra: &IstanbulExtra{ - ParentCommittedSeals: &SerializedSeal{}, - }, - }, - { - name: "BLSExtra", - extra: &IstanbulExtra{ - Validators: validators.NewBLSValidatorSet( - blsValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x8}), - Signature: []byte{0x1}, - }, - ParentCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x9}), - Signature: []byte{0x2}, - }, - }, - targetExtra: &IstanbulExtra{ - ParentCommittedSeals: &AggregatedSeal{}, - }, - }, - } - - for _, test := range tests { - test := test - - t.Run(test.name, func(t *testing.T) { - bytesData := test.extra.MarshalRLPTo(nil) - - assert.NoError(t, test.targetExtra.unmarshalRLPForParentCS(bytesData)) - - // make sure all data is recovered - assert.Equal( - t, - test.extra.ParentCommittedSeals, - test.targetExtra.ParentCommittedSeals, - ) - }) - } -} - -func Test_putIbftExtra(t *testing.T) { - tests := []struct { - name string - header *types.Header - extra *IstanbulExtra - }{ - { - name: "ECDSAExtra", - header: &types.Header{ - ExtraData: []byte{}, - }, - extra: &IstanbulExtra{ - Validators: validators.NewECDSAValidatorSet( - ecdsaValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &SerializedSeal{ - []byte{0x1}, - []byte{0x2}, - }, - ParentCommittedSeals: &SerializedSeal{ - []byte{0x3}, - []byte{0x4}, - }, - }, - }, - { - name: "BLSExtra", - header: &types.Header{ - ExtraData: make([]byte, IstanbulExtraVanity+10), - }, - extra: &IstanbulExtra{ - Validators: validators.NewBLSValidatorSet( - blsValidator1, - ), - ProposerSeal: testProposerSeal, - CommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x8}), - Signature: []byte{0x1}, - }, - ParentCommittedSeals: &AggregatedSeal{ - Bitmap: new(big.Int).SetBytes([]byte{0x9}), - Signature: []byte{0x2}, - }, - }, - }, - } - - for _, test := range tests { - test := test - - t.Run(test.name, func(t *testing.T) { - putIbftExtra(test.header, test.extra) - - expectedExtraHeader := make([]byte, IstanbulExtraVanity) - expectedExtraBody := test.extra.MarshalRLPTo(nil) - expectedExtra := append(expectedExtraHeader, expectedExtraBody...) //nolint:makezero - - assert.Equal( - t, - expectedExtra, - test.header.ExtraData, - ) - }) - } -} diff --git a/consensus/ibft/signer/helper.go b/consensus/ibft/signer/helper.go index fc722cd..6cced02 100644 --- a/consensus/ibft/signer/helper.go +++ b/consensus/ibft/signer/helper.go @@ -3,6 +3,7 @@ package signer import ( "crypto/ecdsa" "fmt" + "sync" "testing" "github.com/coinbase/kryptology/pkg/signatures/bls/bls_sig" @@ -15,6 +16,8 @@ import ( "github.com/xgr-network/xgr-node/validators" ) +var testHeaderHashOverrideMu sync.Mutex + const ( // legacyCommitCode is the value that is contained in // legacy committed seals, so it needs to be preserved in order @@ -126,17 +129,20 @@ func verifyIBFTExtraSize(header *types.Header) error { func UseIstanbulHeaderHashInTest(t *testing.T, signer Signer) { t.Helper() - originalHashCalc := types.HeaderHash - types.HeaderHash = func(h *types.Header) types.Hash { + testHeaderHashOverrideMu.Lock() + + originalHashCalc := types.GetHeaderHash() + types.SetHeaderHash(func(h *types.Header) types.Hash { hash, err := signer.CalculateHeaderHash(h) if err != nil { return types.ZeroHash } return hash - } + }) t.Cleanup(func() { - types.HeaderHash = originalHashCalc + types.SetHeaderHash(originalHashCalc) + testHeaderHashOverrideMu.Unlock() }) } diff --git a/consensus/ibft/signer/legacy_commit.go b/consensus/ibft/signer/legacy_commit.go new file mode 100644 index 0000000..2a233ad --- /dev/null +++ b/consensus/ibft/signer/legacy_commit.go @@ -0,0 +1,10 @@ +package signer + +import "github.com/xgr-network/xgr-node/crypto" + +// LegacyCommitDigest returns the *exact* digest used by the legacy IBFT committed-seal scheme. +// Consensus-critical: must stay bit-identical to CreateCommittedSeal / VerifyParentCommittedSeals. +func LegacyCommitDigest(hash []byte) []byte { + // Same as in signer.go: crypto.Keccak256(wrapCommitHash(hash)) + return crypto.Keccak256(wrapCommitHash(hash)) +} diff --git a/consensus/ibft/signer/signer.go b/consensus/ibft/signer/signer.go index 1dcd829..7b9f3f2 100644 --- a/consensus/ibft/signer/signer.go +++ b/consensus/ibft/signer/signer.go @@ -379,6 +379,5 @@ func (s *SignerImpl) FilterHeaderForHash(header *types.Header) (*types.Header, e // This will effectively remove the Seal and CommittedSeals from the IBFT Extra of header, // while keeping proposer vanity, validator set, and ParentCommittedSeals s.initIbftExtra(clone, extra.Validators, parentCommittedSeals) - return clone, nil } diff --git a/consensus/ibft/transport.go b/consensus/ibft/transport.go index 37b4faa..44a2f5f 100644 --- a/consensus/ibft/transport.go +++ b/consensus/ibft/transport.go @@ -4,31 +4,37 @@ import ( "github.com/0xPolygon/go-ibft/messages/proto" "github.com/libp2p/go-libp2p/core/peer" "github.com/xgr-network/xgr-node/network" - "github.com/xgr-network/xgr-node/types" ) type transport interface { - Multicast(msg *proto.Message) error + Multicast(msg *proto.IbftMessage) error } type gossipTransport struct { topic *network.Topic } -func (g *gossipTransport) Multicast(msg *proto.Message) error { +func (g *gossipTransport) Multicast(msg *proto.IbftMessage) error { return g.topic.Publish(msg) } -func (i *backendIBFT) Multicast(msg *proto.Message) { +func (i *backendIBFT) Multicast(msg *proto.IbftMessage) { if err := i.transport.Multicast(msg); err != nil { i.logger.Error("fail to gossip", "err", err) } + + // Ensure locally-originated messages are visible to the consensus core immediately. + // Relying solely on pubsub loopback can cause higher-round RCC starvation in some + // network setups where self-published messages aren't delivered back to the sender. + if i.consensus != nil && i.isActiveValidator() && msg != nil { + i.consensus.AddMessage(msg) + } } // setupTransport sets up the gossip transport protocol func (i *backendIBFT) setupTransport() error { // Define a new topic - topic, err := i.network.NewTopic(ibftProto, &proto.Message{}) + topic, err := i.network.NewTopic(ibftProto, &proto.IbftMessage{}) if err != nil { return err } @@ -40,7 +46,7 @@ func (i *backendIBFT) setupTransport() error { return } - msg, ok := obj.(*proto.Message) + msg, ok := obj.(*proto.IbftMessage) if !ok { i.logger.Error("invalid type assertion for message request") @@ -48,14 +54,6 @@ func (i *backendIBFT) setupTransport() error { } i.consensus.AddMessage(msg) - - i.logger.Debug( - "validator message received", - "type", msg.Type.String(), - "height", msg.GetView().Height, - "round", msg.GetView().Round, - "addr", types.BytesToAddress(msg.From).String(), - ) }, ); err != nil { return err diff --git a/consensus/ibft/verifier.go b/consensus/ibft/verifier.go index 44b01d0..0658382 100644 --- a/consensus/ibft/verifier.go +++ b/consensus/ibft/verifier.go @@ -7,7 +7,6 @@ import ( "github.com/0xPolygon/go-ibft/messages" protoIBFT "github.com/0xPolygon/go-ibft/messages/proto" - "github.com/xgr-network/xgr-node/consensus/ibft/signer" "github.com/xgr-network/xgr-node/crypto" "github.com/xgr-network/xgr-node/types" ) @@ -24,13 +23,12 @@ func (i *backendIBFT) calculateProposalHashFromBlockBytes( return types.ZeroHash, err } - signer, err := i.forkManager.GetSigner(block.Number()) + _, err := i.forkManager.GetSigner(block.Number()) if err != nil { return types.ZeroHash, err } return i.calculateProposalHash( - signer, block.Header, round, ) @@ -39,7 +37,6 @@ func (i *backendIBFT) calculateProposalHashFromBlockBytes( // calculateProposalHash is new hash calculation for proposal in go-ibft, // which includes round number block is finalized at func (i *backendIBFT) calculateProposalHash( - signer signer.Signer, header *types.Header, round *uint64, ) (types.Hash, error) { @@ -107,11 +104,10 @@ func (i *backendIBFT) IsValidProposal(rawProposal []byte) bool { return false } - return true } -func (i *backendIBFT) IsValidValidator(msg *protoIBFT.Message) bool { +func (i *backendIBFT) IsValidValidator(msg *protoIBFT.IbftMessage) bool { msgNoSig, err := msg.PayloadNoSig() if err != nil { return false @@ -173,16 +169,17 @@ func (i *backendIBFT) IsProposer(id []byte, height, round uint64) bool { return false } - nextProposer := CalcProposer( - i.currentValidators, - round, - previousProposer, - ) + nextProposer := CalcProposer(i.currentValidators, round, previousProposer) return types.BytesToAddress(id) == nextProposer.Addr() } func (i *backendIBFT) IsValidProposalHash(proposal *protoIBFT.Proposal, hash []byte) bool { + block := &types.Block{} + if err := block.UnmarshalRLP(proposal.RawProposal); err != nil { + return false + } + proposalHash, err := i.calculateProposalHashFromBlockBytes(proposal.RawProposal, &proposal.Round) if err != nil { return false diff --git a/consensus/ibft/weighted_quorum_state_test.go b/consensus/ibft/weighted_quorum_state_test.go new file mode 100644 index 0000000..64f41d7 --- /dev/null +++ b/consensus/ibft/weighted_quorum_state_test.go @@ -0,0 +1,19 @@ +package ibft + +import ( + "math/big" + "testing" + + "github.com/stretchr/testify/require" +) + +func TestWeightedQuorum_TwoOfFourEqualWeightsIsNotEnough(t *testing.T) { + t.Parallel() + + total := big.NewInt(40000) + quorum := weightedQuorumThreshold(total) + require.Equal(t, "26667", quorum.String()) + + collected := big.NewInt(20000) // 2 of 4 validators with equal 10000 weight each + require.False(t, hasWeightedQuorum(collected, total)) +} diff --git a/consensus/polybft/README.md b/consensus/polybft/README.md deleted file mode 100644 index 6d4effc..0000000 --- a/consensus/polybft/README.md +++ /dev/null @@ -1,158 +0,0 @@ - -# Polybft consensus protocol - -Polybft is a consensus protocol, which runs [go-ibft](https://github.com/0xPolygon/go-ibft) consensus engine. - -It has a native support for running bridge, which enables running cross-chain transactions with Ethereum-compatible blockchains. - -## Setup local testing environment - -1. Build binary - - ```bash - $ go build -o xgrchain . - ``` - -2. Init secrets - this command is used to generate account secrets (ECDSA, BLS as well as P2P networking node id). `--data-dir` denotes folder prefix names and `--num` how many accounts need to be created. **This command is for testing purposes only.** - - ```bash - $ xgrchain polybft-secrets --data-dir test-chain- --num 4 - ``` - -3. Create chain configuration - this command creates chain configuration, which is needed to run a blockchain. - It contains initial validator set as well and there are two ways to specify it: - - - all the validators information are present in local storage of single host and therefore directory if provided using `--validators-path` flag and validators folder prefix names using `--validators-prefix` flag - - for reward distribution to work, user must define a reward wallet address with its balance. Wallet address is used to distribute reward tokens from that address to validators that signed blocks in that epoch. - - ```bash - $ xgrchain genesis --block-gas-limit 10000000 --epoch-size 10 \ - --proxy-contracts-admin 0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed \ - [--validators-path ./] [--validators-prefix test-chain-] \ - [--consensus polybft] \ - [--reward-wallet address:amount] - ``` - - - validators information are scafollded on multiple hosts and therefore necessary information are supplied using `--validators` flag. Validator information needs to be supplied in the strictly following format: - `:::`. - **Note:** when specifying validators via validators flag, entire multi address must be specified. - - ```bash - $ xgrchain genesis --block-gas-limit 10000000 --epoch-size 10 \ - --proxy-contracts-admin 0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed \ - --validators /ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmV5hqAp77untfJRorxqKmyUxgaVn8YHFjBJm9gKMms3mr:0xDcBe0024206ec42b0Ef4214Ac7B71aeae1A11af0:1cf134e02c6b2afb2ceda50bf2c9a01da367ac48f7783ee6c55444e1cab418ec0f52837b90a4d8cf944814073fc6f2bd96f35366a3846a8393e3cb0b19197cde23e2b40c6401fa27ff7d0c36779d9d097d1393cab6fc1d332f92fb3df850b78703b2989d567d1344e219f0667a1863f52f7663092276770cf513f9704b5351c4:11b18bde524f4b02258a8d196b687f8d8e9490d536718666dc7babca14eccb631c238fb79aa2b44a5a4dceccad2dd797f537008dda185d952226a814c1acf7c2 - [--validators /ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmGmidRQY5BGJPGVRF8p1pYFdfzuf1StHzXGLDizuxJxex:0x2da750eD4AE1D5A7F7c996Faec592F3d44060e90:088d92c25b5f278750534e8a902da604a1aa39b524b4511f5f47c3a386374ca3031b667beb424faef068a01cee3428a1bc8c1c8bab826f30a1ee03fbe90cb5f01abcf4abd7af3bbe83eaed6f82179b9cbdc417aad65d919b802d91c2e1aaefec27ba747158bc18a0556e39bfc9175c099dd77517a85731894bbea3d191a622bc:08dc3006352fdc01b331907fd3a68d4d68ed40329032598c1c0faa260421d66720965ace3ba29c6d6608ec1facdbf4624bca72df36c34afd4bdd753c4dfe049c] - ``` - -4. Start rootchain server - rootchain server is a Geth instance running in dev mode, which simulates Ethereum network. **This command is for testing purposes only.** - - ```bash - $ xgrchain rootchain server - ``` - -5. Deploy StakeManager - if not already deployed to rootchain. Command has a test flag used only in testing purposes which would deploy a mock ERC20 token which would be used for staking. If not used for testing, stake-token flag should be provided: - - ```bash - $ xgrchain polybft stake-manager-deploy \ - --deployer-key \ - --proxy-contracts-admin 0xaddressOfProxyContractsAdmin \ - [--genesis ./genesis.json] \ - [--json-rpc http://127.0.0.1:8545] \ - [--stake-token 0xaddressOfStakeToken] \ - [--test] - ``` - -6. Deploy and initialize rootchain contracts - this command deploys rootchain smart contracts and initializes them. It also updates genesis configuration with rootchain contract addresses and rootchain default sender address. - - ```bash - $ xgrchain rootchain deploy \ - --deployer-key \ - --stake-manager \ - --stake-token 0xaddressOfStakeToken \ - --proxy-contracts-admin 0xaddressOfProxyContractsAdmin \ - [--genesis ./genesis.json] \ - [--json-rpc http://127.0.0.1:8545] \ - [--test] - ``` - -7. Fund validators on rootchain - in order for validators to be able to send transactions to Ethereum, they need to be funded in order to be able to cover gas cost. **This command is for testing purposes only.** - - ```bash - $ xgrchain rootchain fund \ - --addresses 0x1234567890123456789012345678901234567890 \ - --amounts 200000000000000000000 - ``` - -8. Whitelist validators on rootchain - in order for validators to be able to be registered on the SupernetManager contract on rootchain. Note that only deployer of SupernetManager contract (the one who run the deploy command) can whitelist validators on rootchain. He can use either its hex encoded private key, or data-dir flag if he has secerets initialized: - - ```bash - $ xgrchain polybft whitelist-validators --private-key \ - --addresses --supernet-manager - ``` - -9. Register validators on rootchain - each validator registers itself on SupernetManager. **This command is for testing purposes only.** - - ```bash - $ xgrchain polybft register-validator --data-dir ./test-chain-1 \ - --supernet-manager - ``` - -10. Initial staking on rootchain - each validator needs to do initial staking on rootchain (StakeManager) contract. **This command is for testing purposes only.** - - ```bash - $ xgrchain polybft stake --data-dir ./test-chain-1 --supernet-id \ - --amount \ - --stake-manager --stake-token - ``` - -11. Do mint and premine for relayer node. **These commands should only be executed if non-mintable erc20 token is used** - - ```bash - $ xgrchain bridge mint-erc20 \ - --erc20-token \ - --private-key \ - --addresses \ - --amounts - ``` - - ```bash - $ xgrchain rootchain premine \ - --erc20-token \ - --root-erc20-predicate \ - --supernet-manager \ - --private-key \ - --amount - ``` - -12. Finalize genesis validator set on rootchain (SupernetManager) contract. This is done after all validators from genesis do initial staking on rootchain, and it's a final step that is required before starting the child chain. This needs to be done by the deployer of SupernetManager contract (the user that run the deploy command). He can use either its hex encoded private key, or data-dir flag if he has secerets initialized. If enable-staking flag is provided, validators will be able to continue staking on rootchain. If not, genesis validators will not be able update its stake or unstake, nor will newly registered validators after genesis will be able to stake tokens on the rootchain. Enabling of staking can be done through this command, or later after the child chain starts. - - ```bash - $ xgrchain polybft supernet --private-key \ - --genesis \ - --supernet-manager \ - --finalize-genesis --enable-staking - ``` - -13. Run (child chain) cluster, consisting of 4 Edge clients in this particular example - - ```bash - $ xgrchain server --data-dir ./test-chain-1 --chain genesis.json --grpc-address :5001 --libp2p :30301 --jsonrpc :9545 \ - --seal --log-level DEBUG - - $ xgrchain server --data-dir ./test-chain-2 --chain genesis.json --grpc-address :5002 --libp2p :30302 --jsonrpc :10002 \ - --seal --log-level DEBUG - - $ xgrchain server --data-dir ./test-chain-3 --chain genesis.json --grpc-address :5003 --libp2p :30303 --jsonrpc :10003 \ - --seal --log-level DEBUG - - $ xgrchain server --data-dir ./test-chain-4 --chain genesis.json --grpc-address :5004 --libp2p :30304 --jsonrpc :10004 \ - --seal --log-level DEBUG - ``` - - It is possible to run child chain nodes in "relayer" mode. It allows automatic execution of deposit events on behalf of users. - In order to start node in relayer mode, it is necessary to supply `--relayer` flag: - - ```bash - $ xgrchain server --data-dir ./test-chain-1 --chain genesis.json --grpc-address :5001 --libp2p :30301 --jsonrpc :9545 \ - --seal --log-level DEBUG --relayer - ``` diff --git a/consensus/polybft/bitmap/bitmap.go b/consensus/polybft/bitmap/bitmap.go deleted file mode 100644 index 5e56fea..0000000 --- a/consensus/polybft/bitmap/bitmap.go +++ /dev/null @@ -1,37 +0,0 @@ -package bitmap - -// Bitmap Index 0 is LSB from the first bitmap byte -type Bitmap []byte - -func (b *Bitmap) Set(idx uint64) { - index := idx / 8 - *b = extendByteSlice(*b, int(index)+1) - - bit := uint8(1 << (idx % 8)) - (*b)[idx/8] |= bit -} - -func (b *Bitmap) Len() uint64 { - return uint64(len(*b) * 8) -} - -func (b *Bitmap) IsSet(idx uint64) bool { - if b.Len() <= idx { - return false - } - - bit := uint8(1 << (idx % 8)) - - return (*b)[idx/8]&bit == bit -} - -func extendByteSlice(b []byte, needLen int) []byte { - // for example if we need to store idx 277 we need 35 bytes - // But if have slice which length is 5 bytes we need to add additional 30 bytes - // append function is smart enough to use capacity of slice if needed otherwise it will create new slice - if n := needLen - len(b); n > 0 { - b = append(b, make([]byte, n)...) - } - - return b -} diff --git a/consensus/polybft/bitmap/bitmap_test.go b/consensus/polybft/bitmap/bitmap_test.go deleted file mode 100644 index 2d01027..0000000 --- a/consensus/polybft/bitmap/bitmap_test.go +++ /dev/null @@ -1,63 +0,0 @@ -package bitmap - -import ( - "testing" - - "github.com/stretchr/testify/require" -) - -func TestBitmap_Set(t *testing.T) { - t.Parallel() - - data := []int{8, 15, 0, 7, 31, 60, 112, 7, 16, 241, 189, 60, 0, 19, 14, 25} - unique := map[int]struct{}{} - - b := Bitmap{} - - for _, v := range data { - unique[v] = struct{}{} - - b.Set(uint64(v)) - } - - // check if only values from data are populated - for _, v := range data { - require.True(t, b.IsSet(uint64(v))) - } - - cntSet := 0 - - for i := uint64(0); i < b.Len(); i++ { - if _, exists := unique[int(i)]; exists { - cntSet++ - } - } - - require.Equal(t, len(unique), cntSet) -} - -func TestBitmap_Extend(t *testing.T) { - t.Parallel() - - data := []struct { - index uint64 - length uint64 - }{ - {0, 1}, - {8, 2}, - {15, 2}, - {30, 4}, - {17, 4}, - {120, 16}, - {39, 16}, - {277, 35}, - {8, 35}, - } - b := Bitmap{} - - for _, dt := range data { - b.Set(dt.index) - require.True(t, b.Len() == dt.length*8, "assertion failed when setting index %d", dt.index) - require.Len(t, b, int(dt.length)) - } -} diff --git a/consensus/polybft/block_builder.go b/consensus/polybft/block_builder.go deleted file mode 100644 index 2ebff72..0000000 --- a/consensus/polybft/block_builder.go +++ /dev/null @@ -1,221 +0,0 @@ -package polybft - -import ( - "fmt" - "time" - - hcf "github.com/hashicorp/go-hclog" - "github.com/xgr-network/xgr-node/consensus" - "github.com/xgr-network/xgr-node/state" - "github.com/xgr-network/xgr-node/txpool" - "github.com/xgr-network/xgr-node/types" -) - -//nolint:godox -// TODO: Add opentracing (to be fixed in EVM-540) - -// BlockBuilderParams are fields for the block that cannot be changed -type BlockBuilderParams struct { - // Parent block - Parent *types.Header - - // Executor - Executor *state.Executor - - // Coinbase that is signing the block - Coinbase types.Address - - // GasLimit is the gas limit for the block - GasLimit uint64 - - // duration for one block - BlockTime time.Duration - - // Logger - Logger hcf.Logger - - // txPoolInterface implementation - TxPool txPoolInterface - - // BaseFee is the base fee - BaseFee uint64 -} - -func NewBlockBuilder(params *BlockBuilderParams) *BlockBuilder { - return &BlockBuilder{ - params: params, - } -} - -var _ blockBuilder = &BlockBuilder{} - -type BlockBuilder struct { - // input params for the block - params *BlockBuilderParams - - // header is the header for the block being created - header *types.Header - - // transactions are the data included in the block - txns []*types.Transaction - - // block is a reference to the already built block - block *types.Block - - // state is in memory state transition - state *state.Transition -} - -// Init initializes block builder before adding transactions and actual block building -func (b *BlockBuilder) Reset() error { - // set the timestamp - parentTime := time.Unix(int64(b.params.Parent.Timestamp), 0) - headerTime := parentTime.Add(b.params.BlockTime) - - if headerTime.Before(time.Now().UTC()) { - headerTime = time.Now().UTC() - } - - b.header = &types.Header{ - ParentHash: b.params.Parent.Hash, - Number: b.params.Parent.Number + 1, - Miner: b.params.Coinbase[:], - Difficulty: 1, - StateRoot: types.EmptyRootHash, // this avoids needing state for now - TxRoot: types.EmptyRootHash, - ReceiptsRoot: types.EmptyRootHash, // this avoids needing state for now - Sha3Uncles: types.EmptyUncleHash, - GasLimit: b.params.GasLimit, - BaseFee: b.params.BaseFee, - Timestamp: uint64(headerTime.Unix()), - } - - transition, err := b.params.Executor.BeginTxn(b.params.Parent.StateRoot, b.header, b.params.Coinbase) - if err != nil { - return err - } - - b.state = transition - b.block = nil - b.txns = []*types.Transaction{} - - return nil -} - -// Block returns the built block if nil, it is not built yet -func (b *BlockBuilder) Block() *types.Block { - return b.block -} - -// Build creates the state and the final block -func (b *BlockBuilder) Build(handler func(h *types.Header)) (*types.FullBlock, error) { - if handler != nil { - handler(b.header) - } - - _, stateRoot, err := b.state.Commit() - if err != nil { - return nil, fmt.Errorf("failed to commit the state changes: %w", err) - } - - b.header.StateRoot = stateRoot - b.header.GasUsed = b.state.TotalGas() - b.header.LogsBloom = types.CreateBloom(b.Receipts()) - - // build the block - b.block = consensus.BuildBlock(consensus.BuildBlockParams{ - Header: b.header, - Txns: b.txns, - Receipts: b.state.Receipts(), - }) - - b.block.Header.ComputeHash() - - return &types.FullBlock{ - Block: b.block, - Receipts: b.state.Receipts(), - }, nil -} - -// WriteTx applies given transaction to the state. If transaction apply fails, it reverts the saved snapshot. -func (b *BlockBuilder) WriteTx(tx *types.Transaction) error { - if tx.Gas > b.params.GasLimit { - b.params.Logger.Info("Transaction gas limit exceedes block gas limit", "hash", tx.Hash, - "tx gas limit", tx.Gas, "block gas limt", b.params.GasLimit) - - return txpool.ErrBlockLimitExceeded - } - - if err := b.state.Write(tx); err != nil { - return err - } - - b.txns = append(b.txns, tx) - - return nil -} - -// Fill fills the block with transactions from the txpool -func (b *BlockBuilder) Fill() { - blockTimer := time.NewTimer(b.params.BlockTime) - - b.params.TxPool.Prepare() -write: - for { - select { - case <-blockTimer.C: - return - default: - tx := b.params.TxPool.Peek() - - // execute transactions one by one - finished, err := b.writeTxPoolTransaction(tx) - if err != nil { - b.params.Logger.Debug("Fill transaction error", "hash", tx.Hash, "err", err) - } - - if finished { - break write - } - } - } - - // wait for the timer to expire - <-blockTimer.C -} - -// Receipts returns the collection of transaction receipts for given block -func (b *BlockBuilder) Receipts() []*types.Receipt { - return b.state.Receipts() -} - -func (b *BlockBuilder) writeTxPoolTransaction(tx *types.Transaction) (bool, error) { - if tx == nil { - return true, nil - } - - if err := b.WriteTx(tx); err != nil { - if _, ok := err.(*state.GasLimitReachedTransitionApplicationError); ok { //nolint:errorlint - // stop processing - return true, err - } else if appErr, ok := err.(*state.TransitionApplicationError); ok && appErr.IsRecoverable { //nolint:errorlint - b.params.TxPool.Demote(tx) - - return false, err - } else { - b.params.TxPool.Drop(tx) - - return false, err - } - } - - // remove tx from the pool and add it to the list of all block transactions - b.params.TxPool.Pop(tx) - - return false, nil -} - -// GetState returns Transition reference -func (b *BlockBuilder) GetState() *state.Transition { - return b.state -} diff --git a/consensus/polybft/block_builder_test.go b/consensus/polybft/block_builder_test.go deleted file mode 100644 index 7f62abd..0000000 --- a/consensus/polybft/block_builder_test.go +++ /dev/null @@ -1,160 +0,0 @@ -package polybft - -import ( - "math/big" - "testing" - "time" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/crypto" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/state" - itrie "github.com/xgr-network/xgr-node/state/immutable-trie" - "github.com/xgr-network/xgr-node/types" -) - -func TestBlockBuilder_BuildBlockTxOneFailedTxAndOneTakesTooMuchGas(t *testing.T) { - t.Parallel() - - const ( - amount = 1_000 - gasPrice = 1_000 - gasLimit = 21000 - blockGasLimit = 21000 * 3 - chainID = 100 - ) - - accounts := [6]*wallet.Account{} - - for i := range accounts { - accounts[i] = generateTestAccount(t) - } - - forks := &chain.Forks{} - logger := hclog.NewNullLogger() - signer := crypto.NewSigner(forks.At(0), chainID) - - mchain := &chain.Chain{ - Params: &chain.Params{ - ChainID: chainID, - Forks: forks, - }, - } - - mstate := itrie.NewState(itrie.NewMemoryStorage()) - executor := state.NewExecutor(mchain.Params, mstate, logger) - - executor.GetHash = func(header *types.Header) func(i uint64) types.Hash { - return func(i uint64) (res types.Hash) { - return types.BytesToHash(common.EncodeUint64ToBytes(i)) - } - } - - balanceMap := map[types.Address]*chain.GenesisAccount{} - - for i, acc := range accounts { - // the third tx will fail because of insufficient balance - if i != 2 { - balanceMap[types.Address(acc.Ecdsa.Address())] = &chain.GenesisAccount{ - Balance: ethgo.Ether(1), - } - } - } - - hash, err := executor.WriteGenesis(balanceMap, types.ZeroHash) - - require.NoError(t, err) - require.NotEqual(t, types.ZeroHash, hash) - - // Gas Limit is important to be high for tx pool - parentHeader := &types.Header{StateRoot: hash, GasLimit: 1_000_000_000_000_000} - - txPool := &txPoolMock{} - txPool.On("Prepare").Once() - - for i, acc := range accounts { - receiver := types.Address(acc.Ecdsa.Address()) - privateKey, err := acc.GetEcdsaPrivateKey() - - require.NoError(t, err) - - tx := &types.Transaction{ - Value: big.NewInt(amount), - GasPrice: big.NewInt(gasPrice), - Gas: gasLimit, - Nonce: 0, - To: &receiver, - } - - // fifth tx will cause filling to stop - if i == 4 { - tx.Gas = blockGasLimit - 1 - } - - tx, err = signer.SignTx(tx, privateKey) - require.NoError(t, err) - - // all tx until the fifth will be retrieved from the pool - if i <= 4 { - txPool.On("Peek").Return(tx).Once() - } - - // first two and fourth will be added to the block, third will be demoted - if i == 2 { - txPool.On("Demote", tx) - } else if i < 4 { - txPool.On("Pop", tx) - } - } - - bb := NewBlockBuilder(&BlockBuilderParams{ - BlockTime: time.Millisecond * 100, - Parent: parentHeader, - Coinbase: types.ZeroAddress, - Executor: executor, - GasLimit: blockGasLimit, - TxPool: txPool, - Logger: logger, - }) - - require.NoError(t, bb.Reset()) - - bb.Fill() - - fb, err := bb.Build(func(h *types.Header) { - // fake the logs for bloom - rs := bb.Receipts() - - if len(rs) == 3 { - rs[0].Logs = []*types.Log{ - {Address: types.StringToAddress("ff7783")}, - } - rs[1].Logs = []*types.Log{ - {Address: types.StringToAddress("03bbcc")}, - {Address: types.StringToAddress("112233")}, - } - } - }) - require.NoError(t, err) - - txPool.AssertExpectations(t) - require.Len(t, bb.txns, 3, "Should have 3 transactions but has %d", len(bb.txns)) - require.Len(t, bb.Receipts(), 3) - - // assert logs bloom - for _, r := range bb.Receipts() { - for _, l := range r.Logs { - assert.True(t, fb.Block.Header.LogsBloom.IsLogInBloom(l)) - } - } - - assert.False(t, fb.Block.Header.LogsBloom.IsLogInBloom( - &types.Log{Address: types.StringToAddress("999911117777")})) - assert.False(t, fb.Block.Header.LogsBloom.IsLogInBloom( - &types.Log{Address: types.StringToAddress("111177779999")})) -} diff --git a/consensus/polybft/blockchain_wrapper.go b/consensus/polybft/blockchain_wrapper.go deleted file mode 100644 index a5055b8..0000000 --- a/consensus/polybft/blockchain_wrapper.go +++ /dev/null @@ -1,227 +0,0 @@ -package polybft - -import ( - "errors" - "fmt" - "math/big" - "time" - - "github.com/hashicorp/go-hclog" - - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/contract" - "github.com/xgr-network/xgr-node/blockchain" - "github.com/xgr-network/xgr-node/consensus" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/state" - "github.com/xgr-network/xgr-node/types" -) - -const ( - consensusSource = "consensus" -) - -var ( - errSendTxnUnsupported = errors.New("system state does not support send transactions") -) - -// blockchain is an interface that wraps the methods called on blockchain -type blockchainBackend interface { - // CurrentHeader returns the header of blockchain block head - CurrentHeader() *types.Header - - // CommitBlock commits a block to the chain. - CommitBlock(block *types.FullBlock) error - - // NewBlockBuilder is a factory method that returns a block builder on top of 'parent'. - NewBlockBuilder(parent *types.Header, coinbase types.Address, - txPool txPoolInterface, blockTime time.Duration, logger hclog.Logger) (blockBuilder, error) - - // ProcessBlock builds a final block from given 'block' on top of 'parent'. - ProcessBlock(parent *types.Header, block *types.Block) (*types.FullBlock, error) - - // GetStateProviderForBlock returns a reference to make queries to the state at 'block'. - GetStateProviderForBlock(block *types.Header) (contract.Provider, error) - - // GetStateProvider returns a reference to make queries to the provided state. - GetStateProvider(transition *state.Transition) contract.Provider - - // GetHeaderByNumber returns a reference to block header for the given block number. - GetHeaderByNumber(number uint64) (*types.Header, bool) - - // GetHeaderByHash returns a reference to block header for the given block hash - GetHeaderByHash(hash types.Hash) (*types.Header, bool) - - // GetSystemState creates a new instance of SystemState interface - GetSystemState(provider contract.Provider) SystemState - - // SubscribeEvents subscribes to blockchain events - SubscribeEvents() blockchain.Subscription - - // UnubscribeEvents unsubscribes from blockchain events - UnubscribeEvents(subscription blockchain.Subscription) - - // GetChainID returns chain id of the current blockchain - GetChainID() uint64 - - // GetReceiptsByHash retrieves receipts by hash - GetReceiptsByHash(hash types.Hash) ([]*types.Receipt, error) -} - -var _ blockchainBackend = &blockchainWrapper{} - -type blockchainWrapper struct { - executor *state.Executor - blockchain *blockchain.Blockchain -} - -// CurrentHeader returns the header of blockchain block head -func (p *blockchainWrapper) CurrentHeader() *types.Header { - return p.blockchain.Header() -} - -// CommitBlock commits a block to the chain -func (p *blockchainWrapper) CommitBlock(block *types.FullBlock) error { - return p.blockchain.WriteFullBlock(block, consensusSource) -} - -// ProcessBlock builds a final block from given 'block' on top of 'parent' -func (p *blockchainWrapper) ProcessBlock(parent *types.Header, block *types.Block) (*types.FullBlock, error) { - header := block.Header.Copy() - start := time.Now().UTC() - - transition, err := p.executor.BeginTxn(parent.StateRoot, header, types.BytesToAddress(header.Miner)) - if err != nil { - return nil, err - } - - // apply transactions from block - for _, tx := range block.Transactions { - if err = transition.Write(tx); err != nil { - return nil, fmt.Errorf("process block tx error, tx = %v, err = %w", tx.Hash, err) - } - } - - _, root, err := transition.Commit() - if err != nil { - return nil, fmt.Errorf("failed to commit the state changes: %w", err) - } - - updateBlockExecutionMetric(start) - - if root != block.Header.StateRoot { - return nil, fmt.Errorf("incorrect state root: (%s, %s)", root, block.Header.StateRoot) - } - - // build the block - builtBlock := consensus.BuildBlock(consensus.BuildBlockParams{ - Header: header, - Txns: block.Transactions, - Receipts: transition.Receipts(), - }) - - if builtBlock.Header.TxRoot != block.Header.TxRoot { - return nil, fmt.Errorf("incorrect tx root (expected: %s, actual: %s)", - builtBlock.Header.TxRoot, block.Header.TxRoot) - } - - return &types.FullBlock{ - Block: builtBlock, - Receipts: transition.Receipts(), - }, nil -} - -// GetStateProviderForBlock is an implementation of blockchainBackend interface -func (p *blockchainWrapper) GetStateProviderForBlock(header *types.Header) (contract.Provider, error) { - transition, err := p.executor.BeginTxn(header.StateRoot, header, types.ZeroAddress) - if err != nil { - return nil, err - } - - return NewStateProvider(transition), nil -} - -// GetStateProvider returns a reference to make queries to the provided state -func (p *blockchainWrapper) GetStateProvider(transition *state.Transition) contract.Provider { - return NewStateProvider(transition) -} - -// GetHeaderByNumber is an implementation of blockchainBackend interface -func (p *blockchainWrapper) GetHeaderByNumber(number uint64) (*types.Header, bool) { - return p.blockchain.GetHeaderByNumber(number) -} - -// GetHeaderByHash is an implementation of blockchainBackend interface -func (p *blockchainWrapper) GetHeaderByHash(hash types.Hash) (*types.Header, bool) { - return p.blockchain.GetHeaderByHash(hash) -} - -// NewBlockBuilder is an implementation of blockchainBackend interface -func (p *blockchainWrapper) NewBlockBuilder( - parent *types.Header, coinbase types.Address, - txPool txPoolInterface, blockTime time.Duration, logger hclog.Logger) (blockBuilder, error) { - gasLimit, err := p.blockchain.CalculateGasLimit(parent.Number + 1) - if err != nil { - return nil, err - } - - return NewBlockBuilder(&BlockBuilderParams{ - BlockTime: blockTime, - Parent: parent, - Coinbase: coinbase, - Executor: p.executor, - GasLimit: gasLimit, - BaseFee: p.blockchain.CalculateBaseFee(parent), - TxPool: txPool, - Logger: logger, - }), nil -} - -// GetSystemState is an implementation of blockchainBackend interface -func (p *blockchainWrapper) GetSystemState(provider contract.Provider) SystemState { - return NewSystemState(contracts.ValidatorSetContract, contracts.StateReceiverContract, provider) -} - -func (p *blockchainWrapper) SubscribeEvents() blockchain.Subscription { - return p.blockchain.SubscribeEvents() -} - -func (p *blockchainWrapper) UnubscribeEvents(subscription blockchain.Subscription) { - p.blockchain.UnsubscribeEvents(subscription) -} - -func (p *blockchainWrapper) GetChainID() uint64 { - return uint64(p.blockchain.Config().ChainID) -} - -func (p *blockchainWrapper) GetReceiptsByHash(hash types.Hash) ([]*types.Receipt, error) { - return p.blockchain.GetReceiptsByHash(hash) -} - -var _ contract.Provider = &stateProvider{} - -type stateProvider struct { - transition *state.Transition -} - -// NewStateProvider initializes EVM against given state and chain config and returns stateProvider instance -// which is an abstraction for smart contract calls -func NewStateProvider(transition *state.Transition) contract.Provider { - return &stateProvider{transition: transition} -} - -// Call implements the contract.Provider interface to make contract calls directly to the state -func (s *stateProvider) Call(addr ethgo.Address, input []byte, opts *contract.CallOpts) ([]byte, error) { - result := s.transition.Call2(contracts.SystemCaller, types.Address(addr), input, big.NewInt(0), 10000000) - if result.Failed() { - return nil, result.Err - } - - return result.ReturnValue, nil -} - -// Txn is part of the contract.Provider interface to make Ethereum transactions. We disable this function -// since the system state does not make any transaction -func (s *stateProvider) Txn(ethgo.Address, ethgo.Key, []byte) (contract.Txn, error) { - return nil, errSendTxnUnsupported -} diff --git a/consensus/polybft/checkpoint_manager.go b/consensus/polybft/checkpoint_manager.go deleted file mode 100644 index 4d174db..0000000 --- a/consensus/polybft/checkpoint_manager.go +++ /dev/null @@ -1,492 +0,0 @@ -package polybft - -import ( - "bytes" - "fmt" - "math/big" - "strconv" - - hclog "github.com/hashicorp/go-hclog" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/helper/hex" - "github.com/xgr-network/xgr-node/merkle-tree" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" -) - -var ( - // currentCheckpointBlockNumMethod is an ABI method object representation for - // currentCheckpointBlockNumber getter function on CheckpointManager contract - currentCheckpointBlockNumMethod = contractsapi.CheckpointManager.Abi.Methods["currentCheckpointBlockNumber"] - // frequency at which checkpoints are sent to the rootchain (in blocks count) - defaultCheckpointsOffset = uint64(900) -) - -type CheckpointManager interface { - EventSubscriber - PostBlock(req *PostBlockRequest) error - BuildEventRoot(epoch uint64) (types.Hash, error) - GenerateExitProof(exitID uint64) (types.Proof, error) -} - -var _ CheckpointManager = (*dummyCheckpointManager)(nil) - -type dummyCheckpointManager struct{} - -func (d *dummyCheckpointManager) PostBlock(req *PostBlockRequest) error { return nil } -func (d *dummyCheckpointManager) BuildEventRoot(epoch uint64) (types.Hash, error) { - return types.ZeroHash, nil -} -func (d *dummyCheckpointManager) GenerateExitProof(exitID uint64) (types.Proof, error) { - return types.Proof{}, nil -} - -// EventSubscriber implementation -func (d *dummyCheckpointManager) GetLogFilters() map[types.Address][]types.Hash { - return make(map[types.Address][]types.Hash) -} -func (d *dummyCheckpointManager) ProcessLog(header *types.Header, - log *ethgo.Log, dbTx *bolt.Tx) error { - return nil -} - -var _ CheckpointManager = (*checkpointManager)(nil) - -// checkpointManager encapsulates logic for checkpoint data submission -type checkpointManager struct { - // key is the identity of the node submitting a checkpoint - key ethgo.Key - // blockchain is abstraction for blockchain - blockchain blockchainBackend - // consensusBackend is abstraction for polybft consensus specific functions - consensusBackend polybftBackend - // rootChainRelayer abstracts rootchain interaction logic (Call and SendTransaction invocations to the rootchain) - rootChainRelayer txrelayer.TxRelayer - // checkpointsOffset represents offset between checkpoint blocks (applicable only for non-epoch ending blocks) - checkpointsOffset uint64 - // checkpointManagerAddr is address of CheckpointManager smart contract - checkpointManagerAddr types.Address - // lastSentBlock represents the last block on which a checkpoint transaction was sent - lastSentBlock uint64 - // logger instance - logger hclog.Logger - // state boltDb instance - state *State -} - -// newCheckpointManager creates a new instance of checkpointManager -func newCheckpointManager(key ethgo.Key, checkpointOffset uint64, - checkpointManagerSC types.Address, txRelayer txrelayer.TxRelayer, - blockchain blockchainBackend, backend polybftBackend, logger hclog.Logger, - state *State) *checkpointManager { - return &checkpointManager{ - key: key, - blockchain: blockchain, - consensusBackend: backend, - rootChainRelayer: txRelayer, - checkpointsOffset: checkpointOffset, - checkpointManagerAddr: checkpointManagerSC, - logger: logger, - state: state, - } -} - -// getCurrentCheckpointBlock queries CheckpointManager smart contract and retrieves the current checkpoint block number -func getCurrentCheckpointBlock(relayer txrelayer.TxRelayer, checkpointManagerAddr types.Address) (uint64, error) { - checkpointBlockNumInput, err := currentCheckpointBlockNumMethod.Encode([]interface{}{}) - if err != nil { - return 0, fmt.Errorf("failed to encode currentCheckpointBlockNumber function parameters: %w", err) - } - - currentCheckpointBlockRaw, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(checkpointManagerAddr), - checkpointBlockNumInput) - if err != nil { - return 0, fmt.Errorf("failed to invoke currentCheckpointBlockNumber function on the rootchain: %w", err) - } - - currentCheckpointBlock, err := strconv.ParseUint(currentCheckpointBlockRaw, 0, 64) - if err != nil { - return 0, fmt.Errorf("failed to convert current checkpoint block number '%s' to number: %w", - currentCheckpointBlockRaw, err) - } - - return currentCheckpointBlock, nil -} - -// submitCheckpoint sends a transaction with checkpoint data to the rootchain -func (c *checkpointManager) submitCheckpoint(latestHeader *types.Header, isEndOfEpoch bool) error { - lastCheckpointBlockNumber, err := getCurrentCheckpointBlock(c.rootChainRelayer, c.checkpointManagerAddr) - if err != nil { - return err - } - - if lastCheckpointBlockNumber > latestHeader.Number { - // node is out of sync (haven't reached the tip of the chain), so even though it is a proposer, - // it would checkpoint block that is already checkpointed and transaction would fail anyway - return nil - } - - c.logger.Debug("submitCheckpoint invoked...", - "latest checkpoint block", lastCheckpointBlockNumber, - "checkpoint block", latestHeader.Number) - - var ( - initialBlockNumber = lastCheckpointBlockNumber + 1 - parentExtra *Extra - parentHeader *types.Header - currentExtra *Extra - found bool - ) - - if initialBlockNumber < latestHeader.Number { - parentHeader, found = c.blockchain.GetHeaderByNumber(initialBlockNumber) - if !found { - return fmt.Errorf("block %d was not found", initialBlockNumber) - } - - parentExtra, err = GetIbftExtra(parentHeader.ExtraData) - if err != nil { - return err - } - } - - // detect any pending (previously failed) checkpoints and send them - for blockNumber := initialBlockNumber + 1; blockNumber <= latestHeader.Number; blockNumber++ { - currentHeader, found := c.blockchain.GetHeaderByNumber(blockNumber) - if !found { - return fmt.Errorf("block %d was not found", blockNumber) - } - - currentExtra, err = GetIbftExtra(currentHeader.ExtraData) - if err != nil { - return err - } - - parentEpochNumber := parentExtra.Checkpoint.EpochNumber - currentEpochNumber := currentExtra.Checkpoint.EpochNumber - // send pending checkpoints only for epoch ending blocks - if blockNumber == 1 || parentEpochNumber == currentEpochNumber { - parentHeader = currentHeader - parentExtra = currentExtra - - continue - } - - if err = c.encodeAndSendCheckpoint(parentHeader, parentExtra, true); err != nil { - return err - } - - parentHeader = currentHeader - parentExtra = currentExtra - } - - // latestHeader extra could be set in the for loop above - // (in case there were pending checkpoint blocks) - if currentExtra == nil { - // we need to send checkpoint for the latest block - currentExtra, err = GetIbftExtra(latestHeader.ExtraData) - if err != nil { - return err - } - } - - return c.encodeAndSendCheckpoint(latestHeader, currentExtra, isEndOfEpoch) -} - -// encodeAndSendCheckpoint encodes checkpoint data for the given block and -// sends a transaction to the CheckpointManager rootchain contract -func (c *checkpointManager) encodeAndSendCheckpoint(header *types.Header, extra *Extra, isEndOfEpoch bool) error { - c.logger.Debug("send checkpoint txn...", "block number", header.Number) - - checkpointManager := ethgo.Address(c.checkpointManagerAddr) - - nextEpochValidators := validator.AccountSet{} - - if isEndOfEpoch { - var err error - nextEpochValidators, err = c.consensusBackend.GetValidators(header.Number, nil) - - if err != nil { - return err - } - } - - input, err := c.abiEncodeCheckpointBlock(header.Number, header.Hash, extra, nextEpochValidators) - if err != nil { - return fmt.Errorf("failed to encode checkpoint data to ABI for block %d: %w", header.Number, err) - } - - txn := ðgo.Transaction{ - To: &checkpointManager, - Input: input, - Type: ethgo.TransactionDynamicFee, - } - - receipt, err := c.rootChainRelayer.SendTransaction(txn, c.key) - if err != nil { - return err - } - - if receipt.Status == uint64(types.ReceiptFailed) { - return fmt.Errorf("checkpoint submission transaction failed for block %d", header.Number) - } - - c.logger.Debug("send checkpoint txn success", "block number", header.Number, "gasUsed", receipt.GasUsed) - - return nil -} - -// abiEncodeCheckpointBlock encodes checkpoint data into ABI format for a given header -func (c *checkpointManager) abiEncodeCheckpointBlock(blockNumber uint64, blockHash types.Hash, extra *Extra, - nextValidators validator.AccountSet) ([]byte, error) { - aggs, err := bls.UnmarshalSignature(extra.Committed.AggregatedSignature) - if err != nil { - return nil, err - } - - encodedAggSigs, err := aggs.ToBigInt() - if err != nil { - return nil, err - } - - submit := &contractsapi.SubmitCheckpointManagerFn{ - CheckpointMetadata: &contractsapi.CheckpointMetadata{ - BlockHash: blockHash, - BlockRound: new(big.Int).SetUint64(extra.Checkpoint.BlockRound), - CurrentValidatorSetHash: extra.Checkpoint.CurrentValidatorsHash, - }, - Checkpoint: &contractsapi.Checkpoint{ - Epoch: new(big.Int).SetUint64(extra.Checkpoint.EpochNumber), - BlockNumber: new(big.Int).SetUint64(blockNumber), - EventRoot: extra.Checkpoint.EventRoot, - }, - Signature: encodedAggSigs, - Bitmap: extra.Committed.Bitmap, - NewValidatorSet: nextValidators.ToAPIBinding(), - } - - return submit.EncodeAbi() -} - -// isCheckpointBlock returns true for blocks in the middle of the epoch -// which are offset by predefined count of blocks -// or if given block is an epoch ending block -func (c *checkpointManager) isCheckpointBlock(blockNumber uint64, isEpochEndingBlock bool) bool { - return isEpochEndingBlock || blockNumber == c.lastSentBlock+c.checkpointsOffset -} - -// PostBlock is called on every insert of finalized block (either from consensus or syncer) -// It sends a checkpoint if given block is checkpoint block and block proposer is given validator -func (c *checkpointManager) PostBlock(req *PostBlockRequest) error { - if c.isCheckpointBlock(req.FullBlock.Block.Header.Number, req.IsEpochEndingBlock) && - bytes.Equal(c.key.Address().Bytes(), req.FullBlock.Block.Header.Miner) { - go func(header *types.Header, epochNumber uint64) { - if err := c.submitCheckpoint(header, req.IsEpochEndingBlock); err != nil { - c.logger.Warn("failed to submit checkpoint", - "checkpoint block", header.Number, - "epoch number", epochNumber, - "error", err) - } - }(req.FullBlock.Block.Header, req.Epoch) - - c.lastSentBlock = req.FullBlock.Block.Number() - } - - return nil -} - -// BuildEventRoot returns an exit event root hash for exit tree of given epoch -func (c *checkpointManager) BuildEventRoot(epoch uint64) (types.Hash, error) { - exitEvents, err := c.state.CheckpointStore.getExitEventsByEpoch(epoch) - if err != nil { - return types.ZeroHash, err - } - - if len(exitEvents) == 0 { - return types.ZeroHash, nil - } - - tree, err := createExitTree(exitEvents) - if err != nil { - return types.ZeroHash, err - } - - return tree.Hash(), nil -} - -// GenerateExitProof generates proof of exit event -func (c *checkpointManager) GenerateExitProof(exitID uint64) (types.Proof, error) { - c.logger.Debug("Generating proof for exit", "exitID", exitID) - - exitEvent, err := c.state.CheckpointStore.getExitEvent(exitID) - if err != nil { - return types.Proof{}, err - } - - getCheckpointBlockFn := &contractsapi.GetCheckpointBlockCheckpointManagerFn{ - BlockNumber: new(big.Int).SetUint64(exitEvent.BlockNumber), - } - - input, err := getCheckpointBlockFn.EncodeAbi() - if err != nil { - return types.Proof{}, fmt.Errorf("failed to encode get checkpoint block input: %w", err) - } - - getCheckpointBlockResp, err := c.rootChainRelayer.Call( - ethgo.ZeroAddress, - ethgo.Address(c.checkpointManagerAddr), - input) - if err != nil { - return types.Proof{}, fmt.Errorf("failed to retrieve checkpoint block for exit ID %d: %w", exitID, err) - } - - getCheckpointBlockRespRaw, err := hex.DecodeHex(getCheckpointBlockResp) - if err != nil { - return types.Proof{}, fmt.Errorf("failed to decode hex response for exit ID %d: %w", exitID, err) - } - - getCheckpointBlockGeneric, err := contractsapi.GetCheckpointBlockABIResponse.Decode(getCheckpointBlockRespRaw) - if err != nil { - return types.Proof{}, fmt.Errorf("failed to decode checkpoint block response for exit ID %d: %w", exitID, err) - } - - checkpointBlockMap, ok := getCheckpointBlockGeneric.(map[string]interface{}) - if !ok { - return types.Proof{}, fmt.Errorf("failed to convert for checkpoint block response exit ID %d", exitID) - } - - isFoundGeneric, ok := checkpointBlockMap["isFound"] - if !ok { - return types.Proof{}, fmt.Errorf("invalid response for exit ID %d", exitID) - } - - isCheckpointFound, ok := isFoundGeneric.(bool) - if !ok || !isCheckpointFound { - return types.Proof{}, fmt.Errorf("checkpoint block not found for exit ID %d", exitID) - } - - checkpointBlockGeneric, ok := checkpointBlockMap["checkpointBlock"] - if !ok { - return types.Proof{}, fmt.Errorf("checkpoint block not found for exit ID %d", exitID) - } - - checkpointBlock, ok := checkpointBlockGeneric.(*big.Int) - if !ok { - return types.Proof{}, fmt.Errorf("checkpoint block not found for exit ID %d", exitID) - } - - exitEventEncoded, err := exitEvent.L2StateSyncedEvent.Encode() - if err != nil { - return types.Proof{}, err - } - - exitEvents, err := c.state.CheckpointStore.getExitEventsForProof(exitEvent.EpochNumber, checkpointBlock.Uint64()) - if err != nil { - return types.Proof{}, err - } - - tree, err := createExitTree(exitEvents) - if err != nil { - return types.Proof{}, err - } - - leafIndex, err := tree.LeafIndex(exitEventEncoded) - if err != nil { - return types.Proof{}, err - } - - proof, err := tree.GenerateProof(exitEventEncoded) - if err != nil { - return types.Proof{}, err - } - - c.logger.Debug("Generated proof for exit", "exitID", exitID, "leafIndex", leafIndex, "proofLen", len(proof)) - - exitEventHex := hex.EncodeToString(exitEventEncoded) - - return types.Proof{ - Data: proof, - Metadata: map[string]interface{}{ - "LeafIndex": leafIndex, - "ExitEvent": exitEventHex, - "CheckpointBlock": checkpointBlock, - }, - }, nil -} - -// EventSubscriber implementation - -// GetLogFilters returns a map of log filters for getting desired events, -// where the key is the address of contract that emits desired events, -// and the value is a slice of signatures of events we want to get. -// This function is the implementation of EventSubscriber interface -func (c *checkpointManager) GetLogFilters() map[types.Address][]types.Hash { - var l2StateSyncedEvent contractsapi.L2StateSyncedEvent - - return map[types.Address][]types.Hash{ - contracts.L2StateSenderContract: {types.Hash(l2StateSyncedEvent.Sig())}, - } -} - -// ProcessLog is the implementation of EventSubscriber interface, -// used to handle a log defined in GetLogFilters, provided by event provider -func (c *checkpointManager) ProcessLog(header *types.Header, log *ethgo.Log, dbTx *bolt.Tx) error { - exitEvent, doesMatch, err := parseExitEvent(header, log) - if err != nil { - return err - } - - if !doesMatch { - return nil - } - - return c.state.CheckpointStore.insertExitEvent(exitEvent, dbTx) -} - -// createExitTree creates an exit event merkle tree from provided exit events -func createExitTree(exitEvents []*ExitEvent) (*merkle.MerkleTree, error) { - numOfEvents := len(exitEvents) - data := make([][]byte, numOfEvents) - - for i := 0; i < numOfEvents; i++ { - b, err := exitEvents[i].L2StateSyncedEvent.Encode() - if err != nil { - return nil, err - } - - data[i] = b - } - - return merkle.NewMerkleTree(data) -} - -// parseExitEvent parses exit event from provided log -func parseExitEvent(h *types.Header, l *ethgo.Log) (*ExitEvent, bool, error) { - extra, err := GetIbftExtra(h.ExtraData) - if err != nil { - return nil, false, - fmt.Errorf("could not get header extra on exit event parsing. Error: %w", err) - } - - epoch := extra.Checkpoint.EpochNumber - block := h.Number - - if extra.Validators != nil { - // exit events that happened in epoch ending blocks, - // should be added to the tree of the next epoch - epoch++ - block++ - } - - event, err := decodeExitEvent(l, epoch, block) - if err != nil { - return nil, false, err - } - - return event, true, nil -} diff --git a/consensus/polybft/checkpoint_manager_test.go b/consensus/polybft/checkpoint_manager_test.go deleted file mode 100644 index 12f8dda..0000000 --- a/consensus/polybft/checkpoint_manager_test.go +++ /dev/null @@ -1,524 +0,0 @@ -package polybft - -import ( - "encoding/hex" - "errors" - "math/big" - "strconv" - "testing" - - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/ethgo/jsonrpc" - - hclog "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/merkle-tree" - - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -func TestCheckpointManager_SubmitCheckpoint(t *testing.T) { - t.Parallel() - - const ( - blocksCount = 10 - epochSize = 2 - ) - - t.Run("submit checkpoint happy path", func(t *testing.T) { - t.Parallel() - - var aliases = []string{"A", "B", "C", "D", "E"} - - validators := validator.NewTestValidatorsWithAliases(t, aliases) - validatorsMetadata := validators.GetPublicIdentities() - - txRelayerMock := newDummyTxRelayer(t) - txRelayerMock.On("Call", mock.Anything, mock.Anything, mock.Anything). - Return("2", error(nil)). - Once() - txRelayerMock.On("SendTransaction", mock.Anything, mock.Anything). - Return(ðgo.Receipt{Status: uint64(types.ReceiptSuccess)}, error(nil)). - Times(4) // send transactions for checkpoint blocks: 4, 6, 8 (pending checkpoint blocks) and 10 (latest checkpoint block) - - backendMock := new(polybftBackendMock) - backendMock.On("GetValidators", mock.Anything, mock.Anything).Return(validatorsMetadata) - - var ( - headersMap = &testHeadersMap{} - epochNumber = uint64(1) - dummyMsg = []byte("checkpoint") - idx = uint64(0) - header *types.Header - bitmap bitmap.Bitmap - signatures bls.Signatures - ) - - validators.IterAcct(aliases, func(t *validator.TestValidator) { - bitmap.Set(idx) - signatures = append(signatures, t.MustSign(dummyMsg, signer.DomainCheckpointManager)) - idx++ - }) - - signature, err := signatures.Aggregate().Marshal() - require.NoError(t, err) - - for i := uint64(1); i <= blocksCount; i++ { - if i%epochSize == 1 { - // epoch-beginning block - checkpoint := &CheckpointData{ - BlockRound: 0, - EpochNumber: epochNumber, - EventRoot: types.BytesToHash(generateRandomBytes(t)), - } - extra := createTestExtraObject(validatorsMetadata, validatorsMetadata, 3, 3, 3) - extra.Checkpoint = checkpoint - extra.Committed = &Signature{Bitmap: bitmap, AggregatedSignature: signature} - header = &types.Header{ - ExtraData: extra.MarshalRLPTo(nil), - } - epochNumber++ - } else { - header = header.Copy() - } - - header.Number = i - header.ComputeHash() - headersMap.addHeader(header) - } - - // mock blockchain - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headersMap.getHeader) - - validatorAcc := validators.GetValidator("A") - c := &checkpointManager{ - key: wallet.NewEcdsaSigner(validatorAcc.Key()), - rootChainRelayer: txRelayerMock, - consensusBackend: backendMock, - blockchain: blockchainMock, - logger: hclog.NewNullLogger(), - } - - err = c.submitCheckpoint(headersMap.getHeader(blocksCount), false) - require.NoError(t, err) - txRelayerMock.AssertExpectations(t) - - // make sure that expected blocks are checkpointed (epoch-ending ones) - for _, checkpointBlock := range txRelayerMock.checkpointBlocks { - header := headersMap.getHeader(checkpointBlock) - require.NotNil(t, header) - require.True(t, isEndOfPeriod(header.Number, epochSize)) - } - }) - - t.Run("checkpoint not submitted when node is syncing", func(t *testing.T) { - t.Parallel() - - var aliases = []string{"A"} - - validators := validator.NewTestValidatorsWithAliases(t, aliases) - - txRelayerMock := newDummyTxRelayer(t) - txRelayerMock.On("Call", mock.Anything, mock.Anything, mock.Anything). - Return("20", error(nil)). - Once() - - c := &checkpointManager{ - key: wallet.NewEcdsaSigner(validators.GetValidator("A").Key()), - rootChainRelayer: txRelayerMock, - logger: hclog.NewNullLogger(), - } - - err := c.submitCheckpoint(&types.Header{Number: 19 /*lower than what Call returns*/}, false) - require.NoError(t, err) - // since transaction will not be sent to CheckpointManager, we only expect that Call - // will called on tx relayer, and nothing else in submitCheckpoint will be executed - txRelayerMock.AssertExpectations(t) - }) -} - -func TestCheckpointManager_abiEncodeCheckpointBlock(t *testing.T) { - t.Parallel() - - const epochSize = uint64(10) - - currentValidators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D"}) - nextValidators := validator.NewTestValidatorsWithAliases(t, []string{"E", "F", "G", "H"}) - header := &types.Header{Number: 50} - checkpoint := &CheckpointData{ - BlockRound: 1, - EpochNumber: getEpochNumber(t, header.Number, epochSize), - EventRoot: types.BytesToHash(generateRandomBytes(t)), - } - - proposalHash := generateRandomBytes(t) - - bmp := bitmap.Bitmap{} - i := uint64(0) - - var signatures bls.Signatures - - currentValidators.IterAcct(nil, func(v *validator.TestValidator) { - signatures = append(signatures, v.MustSign(proposalHash, signer.DomainCheckpointManager)) - bmp.Set(i) - i++ - }) - - aggSignature, err := signatures.Aggregate().Marshal() - require.NoError(t, err) - - extra := &Extra{Checkpoint: checkpoint} - extra.Committed = &Signature{ - AggregatedSignature: aggSignature, - Bitmap: bmp, - } - header.ExtraData = extra.MarshalRLPTo(nil) - header.ComputeHash() - - backendMock := new(polybftBackendMock) - backendMock.On("GetValidators", mock.Anything, mock.Anything).Return(currentValidators.GetPublicIdentities()) - - c := &checkpointManager{ - blockchain: &blockchainMock{}, - consensusBackend: backendMock, - logger: hclog.NewNullLogger(), - } - checkpointDataEncoded, err := c.abiEncodeCheckpointBlock(header.Number, header.Hash, extra, nextValidators.GetPublicIdentities()) - require.NoError(t, err) - - submit := &contractsapi.SubmitCheckpointManagerFn{} - require.NoError(t, submit.DecodeAbi(checkpointDataEncoded)) - - require.Equal(t, new(big.Int).SetUint64(checkpoint.EpochNumber), submit.Checkpoint.Epoch) - require.Equal(t, new(big.Int).SetUint64(header.Number), submit.Checkpoint.BlockNumber) - require.Equal(t, checkpoint.EventRoot, submit.Checkpoint.EventRoot) - require.Equal(t, new(big.Int).SetUint64(checkpoint.BlockRound), submit.CheckpointMetadata.BlockRound) -} - -func TestCheckpointManager_getCurrentCheckpointID(t *testing.T) { - t.Parallel() - - cases := []struct { - name string - checkpointID string - returnError error - errSubstring string - }{ - { - name: "Happy path", - checkpointID: "16", - returnError: error(nil), - errSubstring: "", - }, - { - name: "Rootchain call returns an error", - checkpointID: "", - returnError: errors.New("internal error"), - errSubstring: "failed to invoke currentCheckpointBlockNumber function on the rootchain", - }, - { - name: "Failed to parse return value from rootchain", - checkpointID: "Hello World!", - returnError: error(nil), - errSubstring: "failed to convert current checkpoint block number", - }, - } - - for _, c := range cases { - c := c - t.Run(c.name, func(t *testing.T) { - t.Parallel() - - txRelayerMock := newDummyTxRelayer(t) - txRelayerMock.On("Call", mock.Anything, mock.Anything, mock.Anything). - Return(c.checkpointID, c.returnError). - Once() - acc, err := wallet.GenerateAccount() - require.NoError(t, err) - - checkpointMgr := &checkpointManager{ - rootChainRelayer: txRelayerMock, - key: acc.Ecdsa, - logger: hclog.NewNullLogger(), - } - actualCheckpointID, err := getCurrentCheckpointBlock(checkpointMgr.rootChainRelayer, - checkpointMgr.checkpointManagerAddr) - if c.errSubstring == "" { - expectedCheckpointID, err := strconv.ParseUint(c.checkpointID, 0, 64) - require.NoError(t, err) - require.Equal(t, expectedCheckpointID, actualCheckpointID) - } else { - require.ErrorContains(t, err, c.errSubstring) - } - - txRelayerMock.AssertExpectations(t) - }) - } -} - -func TestCheckpointManager_IsCheckpointBlock(t *testing.T) { - t.Parallel() - - cases := []struct { - name string - blockNumber uint64 - checkpointsOffset uint64 - isEpochEndingBlock bool - isCheckpointBlock bool - }{ - { - name: "Not checkpoint block", - blockNumber: 3, - checkpointsOffset: 6, - isEpochEndingBlock: false, - isCheckpointBlock: false, - }, - { - name: "Checkpoint block", - blockNumber: 6, - checkpointsOffset: 6, - isEpochEndingBlock: false, - isCheckpointBlock: true, - }, - { - name: "Epoch ending block - Fixed epoch size met", - blockNumber: 10, - checkpointsOffset: 5, - isEpochEndingBlock: true, - isCheckpointBlock: true, - }, - { - name: "Epoch ending block - Epoch ended before fix size was met", - blockNumber: 9, - checkpointsOffset: 5, - isEpochEndingBlock: true, - isCheckpointBlock: true, - }, - } - - for _, c := range cases { - c := c - t.Run(c.name, func(t *testing.T) { - t.Parallel() - - checkpointMgr := newCheckpointManager(wallet.NewEcdsaSigner(createTestKey(t)), c.checkpointsOffset, types.ZeroAddress, nil, nil, nil, hclog.NewNullLogger(), nil) - require.Equal(t, c.isCheckpointBlock, checkpointMgr.isCheckpointBlock(c.blockNumber, c.isEpochEndingBlock)) - }) - } -} - -func TestCheckpointManager_BuildEventRoot(t *testing.T) { - t.Parallel() - - const ( - numOfBlocks = 10 - numOfEventsPerBlock = 2 - ) - - state := newTestState(t) - checkpointManager := &checkpointManager{state: state} - - encodedEvents := insertTestExitEvents(t, state, 1, numOfBlocks, numOfEventsPerBlock) - - t.Run("Get exit event root hash", func(t *testing.T) { - t.Parallel() - - tree, err := createExitTree(encodedEvents) - require.NoError(t, err) - - hash, err := checkpointManager.BuildEventRoot(1) - require.NoError(t, err) - require.Equal(t, tree.Hash(), hash) - }) - - t.Run("Get exit event root hash - no events", func(t *testing.T) { - t.Parallel() - - hash, err := checkpointManager.BuildEventRoot(2) - require.NoError(t, err) - require.Equal(t, types.Hash{}, hash) - }) -} - -func TestCheckpointManager_GenerateExitProof(t *testing.T) { - t.Parallel() - - const ( - numOfBlocks = 10 - numOfEventsPerBlock = 2 - correctBlockToGetExit = 1 - futureBlockToGetExit = 2 - ) - - state := newTestState(t) - - // setup mocks for valid case - foundCheckpointReturn, err := contractsapi.GetCheckpointBlockABIResponse.Encode(map[string]interface{}{ - "isFound": true, - "checkpointBlock": 1, - }) - require.NoError(t, err) - - getCheckpointBlockFn := &contractsapi.GetCheckpointBlockCheckpointManagerFn{ - BlockNumber: new(big.Int).SetUint64(correctBlockToGetExit), - } - - input, err := getCheckpointBlockFn.EncodeAbi() - require.NoError(t, err) - - dummyTxRelayer := newDummyTxRelayer(t) - dummyTxRelayer.On("Call", ethgo.ZeroAddress, ethgo.ZeroAddress, input). - Return(hex.EncodeToString(foundCheckpointReturn), error(nil)) - - // create checkpoint manager and insert exit events - checkpointMgr := newCheckpointManager(wallet.NewEcdsaSigner( - createTestKey(t)), - 0, - types.ZeroAddress, - dummyTxRelayer, - nil, - nil, - hclog.NewNullLogger(), - state) - - exitEvents := insertTestExitEvents(t, state, 1, numOfBlocks, numOfEventsPerBlock) - encodedEvents := encodeExitEvents(t, exitEvents) - checkpointEvents := encodedEvents[:numOfEventsPerBlock] - - // manually create merkle tree for a desired checkpoint to verify the generated proof - tree, err := merkle.NewMerkleTree(checkpointEvents) - require.NoError(t, err) - - proof, err := checkpointMgr.GenerateExitProof(correctBlockToGetExit) - require.NoError(t, err) - require.NotNil(t, proof) - - t.Run("Generate and validate exit proof", func(t *testing.T) { - t.Parallel() - // verify generated proof on desired tree - require.NoError(t, merkle.VerifyProof(correctBlockToGetExit, encodedEvents[1], proof.Data, tree.Hash())) - }) - - t.Run("Generate and validate exit proof - invalid proof", func(t *testing.T) { - t.Parallel() - - // copy and make proof invalid - invalidProof := make([]types.Hash, len(proof.Data)) - copy(invalidProof, proof.Data) - invalidProof[0][0]++ - - // verify generated proof on desired tree - require.ErrorContains(t, merkle.VerifyProof(correctBlockToGetExit, - encodedEvents[1], invalidProof, tree.Hash()), "not a member of merkle tree") - }) - - t.Run("Generate exit proof - no event", func(t *testing.T) { - t.Parallel() - - _, err := checkpointMgr.GenerateExitProof(21) - require.ErrorContains(t, err, "could not find any exit event that has an id") - }) - - t.Run("Generate exit proof - future lookup where checkpoint not yet submitted", func(t *testing.T) { - t.Parallel() - - // setup mocks for invalid case - notFoundCheckpointReturn, err := contractsapi.GetCheckpointBlockABIResponse.Encode(map[string]interface{}{ - "isFound": false, - "checkpointBlock": 0, - }) - require.NoError(t, err) - - getCheckpointBlockFn.BlockNumber = new(big.Int).SetUint64(futureBlockToGetExit) - inputTwo, err := getCheckpointBlockFn.EncodeAbi() - require.NoError(t, err) - - dummyTxRelayer.On("Call", ethgo.ZeroAddress, ethgo.ZeroAddress, inputTwo). - Return(hex.EncodeToString(notFoundCheckpointReturn), error(nil)) - - _, err = checkpointMgr.GenerateExitProof(futureBlockToGetExit) - require.ErrorContains(t, err, "checkpoint block not found for exit ID") - }) -} - -var _ txrelayer.TxRelayer = (*dummyTxRelayer)(nil) - -type dummyTxRelayer struct { - mock.Mock - - test *testing.T - checkpointBlocks []uint64 -} - -func newDummyTxRelayer(t *testing.T) *dummyTxRelayer { - t.Helper() - - return &dummyTxRelayer{test: t} -} - -func (d *dummyTxRelayer) Call(from ethgo.Address, to ethgo.Address, input []byte) (string, error) { - args := d.Called(from, to, input) - - return args.String(0), args.Error(1) -} - -func (d *dummyTxRelayer) SendTransaction(transaction *ethgo.Transaction, key ethgo.Key) (*ethgo.Receipt, error) { - blockNumber := getBlockNumberCheckpointSubmitInput(d.test, transaction.Input) - d.checkpointBlocks = append(d.checkpointBlocks, blockNumber) - args := d.Called(transaction, key) - - return args.Get(0).(*ethgo.Receipt), args.Error(1) //nolint:forcetypeassert -} - -// SendTransactionLocal sends non-signed transaction (this is only for testing purposes) -func (d *dummyTxRelayer) SendTransactionLocal(txn *ethgo.Transaction) (*ethgo.Receipt, error) { - args := d.Called(txn) - - return args.Get(0).(*ethgo.Receipt), args.Error(1) //nolint:forcetypeassert -} - -func (d *dummyTxRelayer) Client() *jsonrpc.Client { - return nil -} - -func getBlockNumberCheckpointSubmitInput(t *testing.T, input []byte) uint64 { - t.Helper() - - submit := &contractsapi.SubmitCheckpointManagerFn{} - require.NoError(t, submit.DecodeAbi(input)) - - return submit.Checkpoint.BlockNumber.Uint64() -} - -func createTestLogForExitEvent(t *testing.T, exitEventID uint64) *types.Log { - t.Helper() - - var exitEvent contractsapi.L2StateSyncedEvent - - topics := make([]types.Hash, 4) - topics[0] = types.Hash(exitEvent.Sig()) - topics[1] = types.BytesToHash(common.EncodeUint64ToBytes(exitEventID)) - topics[2] = types.BytesToHash(types.StringToAddress("0x1111").Bytes()) - topics[3] = types.BytesToHash(types.StringToAddress("0x2222").Bytes()) - someType := abi.MustNewType("tuple(string firstName, string lastName)") - encodedData, err := someType.Encode(map[string]string{"firstName": "John", "lastName": "Doe"}) - require.NoError(t, err) - - return &types.Log{ - Address: contracts.L2StateSenderContract, - Topics: topics, - Data: encodedData, - } -} diff --git a/consensus/polybft/consensus_metrics.go b/consensus/polybft/consensus_metrics.go deleted file mode 100644 index d3b4426..0000000 --- a/consensus/polybft/consensus_metrics.go +++ /dev/null @@ -1,58 +0,0 @@ -package polybft - -import ( - "time" - - "github.com/armon/go-metrics" - "github.com/xgr-network/xgr-node/types" -) - -const ( - // consensusMetricsPrefix is a consensus-related metrics prefix - consensusMetricsPrefix = "consensus" -) - -// updateBlockMetrics updates various metrics based on the given block -// (such as block interval, number of transactions and block rounds metrics) -func updateBlockMetrics(currentBlock *types.Block, parentHeader *types.Header) error { - if currentBlock.Number() > 1 { - parentTime := time.Unix(int64(parentHeader.Timestamp), 0) - headerTime := time.Unix(int64(currentBlock.Header.Timestamp), 0) - // update the block interval metric - metrics.SetGauge([]string{consensusMetricsPrefix, "block_interval"}, float32(headerTime.Sub(parentTime).Seconds())) - } - - // update the number of transactions in the block metric - metrics.SetGauge([]string{consensusMetricsPrefix, "num_txs"}, float32(len(currentBlock.Transactions))) - - extra, err := GetIbftExtra(currentBlock.Header.ExtraData) - if err != nil { - return err - } - - // number of rounds needed to seal a block - metrics.SetGauge([]string{consensusMetricsPrefix, "rounds"}, float32(extra.Checkpoint.BlockRound)) - metrics.SetGauge([]string{consensusMetricsPrefix, "chain_head"}, float32(currentBlock.Number())) - metrics.IncrCounter([]string{consensusMetricsPrefix, "block_counter"}, float32(1)) - metrics.SetGauge([]string{consensusMetricsPrefix, "block_space_used"}, float32(currentBlock.Header.GasUsed)) - - // Update the base fee metric - metrics.SetGauge([]string{consensusMetricsPrefix, "base_fee"}, float32(currentBlock.Header.BaseFee)) - - return nil -} - -// updateEpochMetrics updates epoch-related metrics -// (e.g. epoch number, validator set length) -func updateEpochMetrics(epoch epochMetadata) { - // update epoch number metrics - metrics.SetGauge([]string{consensusMetricsPrefix, "epoch_number"}, float32(epoch.Number)) - // update number of validators metrics - metrics.SetGauge([]string{consensusMetricsPrefix, "validators"}, float32(epoch.Validators.Len())) -} - -// updateBlockExecutionMetric updates the block execution metric -func updateBlockExecutionMetric(start time.Time) { - metrics.SetGauge([]string{consensusMetricsPrefix, "block_execution_time"}, - float32(time.Now().UTC().Sub(start).Seconds())) -} diff --git a/consensus/polybft/consensus_runtime.go b/consensus/polybft/consensus_runtime.go deleted file mode 100644 index 03c5ce5..0000000 --- a/consensus/polybft/consensus_runtime.go +++ /dev/null @@ -1,1091 +0,0 @@ -package polybft - -import ( - "bytes" - "errors" - "fmt" - "math/big" - "sort" - "sync" - "sync/atomic" - "time" - - "github.com/xgr-network/xgr-node/consensus" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" - - "github.com/0xPolygon/go-ibft/messages" - "github.com/0xPolygon/go-ibft/messages/proto" - hcf "github.com/hashicorp/go-hclog" -) - -const ( - maxCommitmentSize = 10 - stateFileName = "consensusState.db" - commitEpochLookbackSize = 2 // number of blocks to calculate commit epoch info from the previous epoch -) - -var ( - // errNotAValidator represents "node is not a validator" error message - errNotAValidator = errors.New("node is not a validator") - // errQuorumNotReached represents "quorum not reached for commitment message" error message - errQuorumNotReached = errors.New("quorum not reached for commitment message") -) - -// txPoolInterface is an abstraction of transaction pool -type txPoolInterface interface { - Prepare() - Length() uint64 - Peek() *types.Transaction - Pop(*types.Transaction) - Drop(*types.Transaction) - Demote(*types.Transaction) - SetSealing(bool) - ResetWithHeaders(...*types.Header) -} - -// epochMetadata is the static info for epoch currently being processed -type epochMetadata struct { - // Number is the number of the epoch - Number uint64 - - FirstBlockInEpoch uint64 - - // Validators is the set of validators for the epoch - Validators validator.AccountSet -} - -type guardedDataDTO struct { - // last built block header at the time of collecting data - lastBuiltBlock *types.Header - - // epoch metadata at the time of collecting data - epoch *epochMetadata - - // proposerSnapshot at the time of collecting data - proposerSnapshot *ProposerSnapshot -} - -// runtimeConfig is a struct that holds configuration data for given consensus runtime -type runtimeConfig struct { - PolyBFTConfig *PolyBFTConfig - DataDir string - Key *wallet.Key - State *State - blockchain blockchainBackend - polybftBackend polybftBackend - txPool txPoolInterface - bridgeTopic topic - numBlockConfirmations uint64 - consensusConfig *consensus.Config -} - -// consensusRuntime is a struct that provides consensus runtime features like epoch, state and event management -type consensusRuntime struct { - // config represents wrapper around required parameters which are received from the outside - config *runtimeConfig - - // state is reference to the struct which encapsulates bridge events persistence logic - state *State - - // fsm instance which is created for each `runSequence` - fsm *fsm - - // lock is a lock to access 'epoch' and `lastBuiltBlock` - lock sync.RWMutex - - // epoch is the metadata for the current epoch - epoch *epochMetadata - - // lastBuiltBlock is the header of the last processed block - lastBuiltBlock *types.Header - - // activeValidatorFlag indicates whether the given node is amongst currently active validator set - activeValidatorFlag atomic.Bool - - // checkpointManager represents abstraction for checkpoint submission - checkpointManager CheckpointManager - - // proposerCalculator is the object which manipulates with ProposerSnapshot - proposerCalculator *ProposerCalculator - - // manager for state sync bridge transactions - stateSyncManager StateSyncManager - - // manager for handling validator stake change and updating validator set - stakeManager StakeManager - - eventProvider *EventProvider - - // stateSyncRelayer is relayer for commitment events - stateSyncRelayer StateSyncRelayer - - // logger instance - logger hcf.Logger -} - -// newConsensusRuntime creates and starts a new consensus runtime instance with event tracking -func newConsensusRuntime(log hcf.Logger, config *runtimeConfig) (*consensusRuntime, error) { - dbTx, err := config.State.beginDBTransaction(true) - if err != nil { - return nil, fmt.Errorf("could not begin dbTx to init consensus runtime: %w", err) - } - - defer dbTx.Rollback() //nolint:errcheck - - proposerCalculator, err := NewProposerCalculator(config, log.Named("proposer_calculator"), dbTx) - if err != nil { - return nil, fmt.Errorf("failed to create consensus runtime, error while creating proposer calculator %w", err) - } - - runtime := &consensusRuntime{ - state: config.State, - config: config, - lastBuiltBlock: config.blockchain.CurrentHeader(), - proposerCalculator: proposerCalculator, - logger: log.Named("consensus_runtime"), - eventProvider: NewEventProvider(config.blockchain), - } - - if err := runtime.initStateSyncManager(log); err != nil { - return nil, err - } - - if err := runtime.initCheckpointManager(log); err != nil { - return nil, err - } - - if err := runtime.initStakeManager(log, dbTx); err != nil { - return nil, err - } - - if err := runtime.initStateSyncRelayer(log); err != nil { - return nil, err - } - - // we need to call restart epoch on runtime to initialize epoch state - runtime.epoch, err = runtime.restartEpoch(runtime.lastBuiltBlock, dbTx) - if err != nil { - return nil, fmt.Errorf("consensus runtime creation - restart epoch failed: %w", err) - } - - if err := dbTx.Commit(); err != nil { - return nil, fmt.Errorf("could not commit db tx to init consensus runtime: %w", err) - } - - return runtime, nil -} - -// close is used to tear down allocated resources -func (c *consensusRuntime) close() { - c.stateSyncRelayer.Close() - c.stateSyncManager.Close() -} - -// initStateSyncManager initializes state sync manager -// if bridge is not enabled, then a dummy state sync manager will be used -func (c *consensusRuntime) initStateSyncManager(logger hcf.Logger) error { - if c.IsBridgeEnabled() { - stateSenderAddr := c.config.PolyBFTConfig.Bridge.StateSenderAddr - stateSyncManager := newStateSyncManager( - logger.Named("state-sync-manager"), - c.config.State, - &stateSyncConfig{ - key: c.config.Key, - stateSenderAddr: stateSenderAddr, - stateSenderStartBlock: c.config.PolyBFTConfig.Bridge.EventTrackerStartBlocks[stateSenderAddr], - jsonrpcAddr: c.config.PolyBFTConfig.Bridge.JSONRPCEndpoint, - dataDir: c.config.DataDir, - topic: c.config.bridgeTopic, - maxCommitmentSize: maxCommitmentSize, - numBlockConfirmations: c.config.numBlockConfirmations, - blockTrackerPollInterval: c.config.PolyBFTConfig.BlockTrackerPollInterval.Duration, - }, - c, - ) - - c.stateSyncManager = stateSyncManager - } else { - c.stateSyncManager = &dummyStateSyncManager{} - } - - return c.stateSyncManager.Init() -} - -// initCheckpointManager initializes checkpoint manager -// if bridge is not enabled, then a dummy checkpoint manager will be used -func (c *consensusRuntime) initCheckpointManager(logger hcf.Logger) error { - if c.IsBridgeEnabled() { - // enable checkpoint manager - txRelayer, err := txrelayer.NewTxRelayer( - txrelayer.WithIPAddress(c.config.PolyBFTConfig.Bridge.JSONRPCEndpoint), - txrelayer.WithWriter(logger.StandardWriter(&hcf.StandardLoggerOptions{}))) - if err != nil { - return err - } - - c.checkpointManager = newCheckpointManager( - wallet.NewEcdsaSigner(c.config.Key), - defaultCheckpointsOffset, - c.config.PolyBFTConfig.Bridge.CheckpointManagerAddr, - txRelayer, - c.config.blockchain, - c.config.polybftBackend, - logger.Named("checkpoint_manager"), - c.state) - } else { - c.checkpointManager = &dummyCheckpointManager{} - } - - c.eventProvider.Subscribe(c.checkpointManager) - - return nil -} - -// initStateSyncRelayer initializes state sync relayer -// if not enabled, then a dummy state sync relayer will be used -func (c *consensusRuntime) initStateSyncRelayer(logger hcf.Logger) error { - if c.config.consensusConfig.IsRelayer { - txRelayer, err := getStateSyncTxRelayer(c.config.consensusConfig.RPCEndpoint, logger) - if err != nil { - return err - } - - c.stateSyncRelayer = NewStateSyncRelayer( - txRelayer, - contracts.StateReceiverContract, - c.state.StateSyncStore, - c, - c.config.blockchain, - wallet.NewEcdsaSigner(c.config.Key), - nil, - logger.Named("state_sync_relayer")) - } else { - c.stateSyncRelayer = &dummyStateSyncRelayer{} - } - - c.eventProvider.Subscribe(c.stateSyncRelayer) - - return c.stateSyncRelayer.Init() -} - -// initStakeManager initializes stake manager -func (c *consensusRuntime) initStakeManager(logger hcf.Logger, dbTx *bolt.Tx) error { - rootRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(c.config.PolyBFTConfig.Bridge.JSONRPCEndpoint)) - if err != nil { - return err - } - - c.stakeManager, err = newStakeManager( - logger.Named("stake-manager"), - c.state, - rootRelayer, - wallet.NewEcdsaSigner(c.config.Key), - contracts.ValidatorSetContract, - c.config.PolyBFTConfig.Bridge.CustomSupernetManagerAddr, - c.config.blockchain, - c.config.polybftBackend, - int(c.config.PolyBFTConfig.MaxValidatorSetSize), - dbTx, - ) - - c.eventProvider.Subscribe(c.stakeManager) - - return err -} - -// getGuardedData returns last build block, proposer snapshot and current epochMetadata in a thread-safe manner. -func (c *consensusRuntime) getGuardedData() (guardedDataDTO, error) { - c.lock.RLock() - defer c.lock.RUnlock() - - lastBuiltBlock := c.lastBuiltBlock.Copy() - epoch := new(epochMetadata) - *epoch = *c.epoch // shallow copy, don't need to make validators copy because AccountSet is immutable - proposerSnapshot, ok := c.proposerCalculator.GetSnapshot() - - if !ok { - return guardedDataDTO{}, errors.New("cannot collect shared data, snapshot is empty") - } - - return guardedDataDTO{ - epoch: epoch, - lastBuiltBlock: lastBuiltBlock, - proposerSnapshot: proposerSnapshot, - }, nil -} - -func (c *consensusRuntime) IsBridgeEnabled() bool { - return c.config.PolyBFTConfig.IsBridgeEnabled() -} - -// OnBlockInserted is called whenever fsm or syncer inserts new block -func (c *consensusRuntime) OnBlockInserted(fullBlock *types.FullBlock) { - startTime := time.Now().UTC() - - c.lock.Lock() - defer c.lock.Unlock() - - if c.lastBuiltBlock != nil && c.lastBuiltBlock.Number >= fullBlock.Block.Number() { - c.logger.Debug("on block inserted already handled", - "current", c.lastBuiltBlock.Number, "block", fullBlock.Block.Number()) - - return - } - - if err := updateBlockMetrics(fullBlock.Block, c.lastBuiltBlock); err != nil { - c.logger.Error("failed to update block metrics", "error", err) - } - - // after the block has been written we reset the txpool so that the old transactions are removed - c.config.txPool.ResetWithHeaders(fullBlock.Block.Header) - - var ( - epoch = c.epoch - err error - // calculation of epoch and sprint end does not consider slashing currently - - isEndOfEpoch = c.isFixedSizeOfEpochMet(fullBlock.Block.Header.Number, epoch) - ) - - // begin DB transaction - dbTx, err := c.state.beginDBTransaction(true) - if err != nil { - c.logger.Error("failed to begin db transaction on block finalization", - "block", fullBlock.Block.Number(), "err", err) - - return - } - - defer dbTx.Rollback() //nolint:errcheck - - lastProcessedEventsBlock, err := c.state.getLastProcessedEventsBlock(dbTx) - if err != nil { - c.logger.Error("failed to get last processed events block on block finalization", - "block", fullBlock.Block.Number(), "err", err) - - return - } - - if err := c.eventProvider.GetEventsFromBlocks(lastProcessedEventsBlock, fullBlock, dbTx); err != nil { - c.logger.Error("failed to process events on block finalization", "block", fullBlock.Block.Number(), "err", err) - - return - } - - postBlock := &PostBlockRequest{ - FullBlock: fullBlock, - Epoch: epoch.Number, - IsEpochEndingBlock: isEndOfEpoch, - DBTx: dbTx, - } - - if err := c.stateSyncManager.PostBlock(postBlock); err != nil { - c.logger.Error("failed to post block state sync", "err", err) - - return - } - - // update proposer priorities - if err := c.proposerCalculator.PostBlock(postBlock); err != nil { - c.logger.Error("Could not update proposer calculator", "err", err) - - return - } - - // handle transfer events that happened in block - if err := c.stakeManager.PostBlock(postBlock); err != nil { - c.logger.Error("failed to post block in stake manager", "err", err) - - return - } - - // handle state sync relayer events that happened in block - if err := c.stateSyncRelayer.PostBlock(postBlock); err != nil { - c.logger.Error("post block callback failed in state sync relayer", "err", err) - } - - if isEndOfEpoch { - if epoch, err = c.restartEpoch(fullBlock.Block.Header, dbTx); err != nil { - c.logger.Error("failed to restart epoch after block inserted", "error", err) - - return - } - } - - if err := c.state.insertLastProcessedEventsBlock(fullBlock.Block.Number(), dbTx); err != nil { - c.logger.Error("failed to update the last processed events block in db", "error", err) - - return - } - - // commit DB transaction - if err := dbTx.Commit(); err != nil { - c.logger.Error("failed to commit transaction on PostBlock", - "block", fullBlock.Block.Number(), "error", err) - - return - } - - // finally update runtime state (lastBuiltBlock, epoch, proposerSnapshot) - c.epoch = epoch - c.lastBuiltBlock = fullBlock.Block.Header - - // we will do PostBlock on checkpoint manager at the end, because it only - // sends a checkpoint in a separate routine. It doesn't do any db operations - if err := c.checkpointManager.PostBlock(postBlock); err != nil { - c.logger.Error("failed to post block in checkpoint manager", "err", err) - } - - endTime := time.Now().UTC() - - c.logger.Debug("OnBlockInserted finished", "elapsedTime", endTime.Sub(startTime), - "epoch", epoch.Number, "block", fullBlock.Block.Number()) -} - -// FSM creates a new instance of fsm -func (c *consensusRuntime) FSM() error { - sharedData, err := c.getGuardedData() - if err != nil { - return fmt.Errorf("cannot create fsm: %w", err) - } - - parent, epoch, proposerSnapshot := sharedData.lastBuiltBlock, sharedData.epoch, sharedData.proposerSnapshot - - if !epoch.Validators.ContainsNodeID(c.config.Key.String()) { - return errNotAValidator - } - - blockBuilder, err := c.config.blockchain.NewBlockBuilder( - parent, - types.Address(c.config.Key.Address()), - c.config.txPool, - c.config.PolyBFTConfig.BlockTime.Duration, - c.logger, - ) - - if err != nil { - return fmt.Errorf("cannot create block builder for fsm: %w", err) - } - - pendingBlockNumber := parent.Number + 1 - // calculation of epoch and sprint end does not consider slashing currently - isEndOfSprint := c.isFixedSizeOfSprintMet(pendingBlockNumber, epoch) - isEndOfEpoch := c.isFixedSizeOfEpochMet(pendingBlockNumber, epoch) - - valSet := validator.NewValidatorSet(epoch.Validators, c.logger) - - exitRootHash, err := c.checkpointManager.BuildEventRoot(epoch.Number) - if err != nil { - return fmt.Errorf("could not build exit root hash for fsm: %w", err) - } - - ff := &fsm{ - config: c.config.PolyBFTConfig, - parent: parent, - backend: c.config.blockchain, - polybftBackend: c.config.polybftBackend, - exitEventRootHash: exitRootHash, - epochNumber: epoch.Number, - blockBuilder: blockBuilder, - validators: valSet, - isEndOfEpoch: isEndOfEpoch, - isEndOfSprint: isEndOfSprint, - proposerSnapshot: proposerSnapshot, - logger: c.logger.Named("fsm"), - } - - if isEndOfSprint { - commitment, err := c.stateSyncManager.Commitment(pendingBlockNumber) - if err != nil { - return err - } - - ff.proposerCommitmentToRegister = commitment - } - - if isEndOfEpoch { - ff.commitEpochInput, ff.distributeRewardsInput, err = c.calculateCommitEpochInput(parent, epoch) - if err != nil { - return fmt.Errorf("cannot calculate commit epoch info: %w", err) - } - - ff.newValidatorsDelta, err = c.stakeManager.UpdateValidatorSet(epoch.Number, epoch.Validators.Copy()) - if err != nil { - return fmt.Errorf("cannot update validator set on epoch ending: %w", err) - } - } - - c.logger.Info( - "[FSM built]", - "epoch", epoch.Number, - "endOfEpoch", isEndOfEpoch, - "endOfSprint", isEndOfSprint, - ) - - c.lock.Lock() - c.fsm = ff - c.lock.Unlock() - - return nil -} - -// restartEpoch resets the previously run epoch and moves to the next one -// returns *epochMetadata different from nil if the lastEpoch is not the current one and everything was successful -func (c *consensusRuntime) restartEpoch(header *types.Header, dbTx *bolt.Tx) (*epochMetadata, error) { - lastEpoch := c.epoch - - systemState, err := c.getSystemState(header) - if err != nil { - return nil, fmt.Errorf("get system state: %w", err) - } - - epochNumber, err := systemState.GetEpoch() - if err != nil { - return nil, fmt.Errorf("get epoch: %w", err) - } - - if lastEpoch != nil { - // Epoch might be already in memory, if its the same number do nothing -> just return provided last one - // Otherwise, reset the epoch metadata and restart the async services - if lastEpoch.Number == epochNumber { - return lastEpoch, nil - } - } - - validatorSet, err := c.config.polybftBackend.GetValidatorsWithTx(header.Number, nil, dbTx) - if err != nil { - return nil, fmt.Errorf("restart epoch - cannot get validators: %w", err) - } - - updateEpochMetrics(epochMetadata{ - Number: epochNumber, - Validators: validatorSet, - }) - - firstBlockInEpoch, err := c.getFirstBlockOfEpoch(epochNumber, header) - if err != nil { - return nil, err - } - - if err := c.state.EpochStore.cleanEpochsFromDB(dbTx); err != nil { - c.logger.Error("Could not clean previous epochs from db.", "error", err) - } - - if err := c.state.EpochStore.insertEpoch(epochNumber, dbTx); err != nil { - return nil, fmt.Errorf("an error occurred while inserting new epoch in db. Reason: %w", err) - } - - c.logger.Info( - "restartEpoch", - "block number", header.Number, - "epoch", epochNumber, - "validators", validatorSet.Len(), - "firstBlockInEpoch", firstBlockInEpoch, - ) - - reqObj := &PostEpochRequest{ - SystemState: systemState, - NewEpochID: epochNumber, - FirstBlockOfEpoch: firstBlockInEpoch, - ValidatorSet: validator.NewValidatorSet(validatorSet, c.logger), - DBTx: dbTx, - } - - if err := c.stateSyncManager.PostEpoch(reqObj); err != nil { - return nil, err - } - - return &epochMetadata{ - Number: epochNumber, - Validators: validatorSet, - FirstBlockInEpoch: firstBlockInEpoch, - }, nil -} - -// calculateCommitEpochInput calculates commit epoch input data for blocks starting from the last built block -// in the current epoch, and ending at the last block of previous epoch -func (c *consensusRuntime) calculateCommitEpochInput( - currentBlock *types.Header, - epoch *epochMetadata, -) (*contractsapi.CommitEpochValidatorSetFn, - *contractsapi.DistributeRewardForRewardPoolFn, error) { - uptimeCounter := map[types.Address]int64{} - blockHeader := currentBlock - epochID := epoch.Number - totalBlocks := int64(0) - - getSealersForBlock := func(blockExtra *Extra, validators validator.AccountSet) error { - signers, err := validators.GetFilteredValidators(blockExtra.Parent.Bitmap) - if err != nil { - return err - } - - totalBlocks++ - - for _, a := range signers.GetAddresses() { - uptimeCounter[a]++ - } - - return nil - } - - blockExtra, err := GetIbftExtra(currentBlock.ExtraData) - if err != nil { - return nil, nil, err - } - - // calculate uptime for current epoch - for blockHeader.Number > epoch.FirstBlockInEpoch { - if err := getSealersForBlock(blockExtra, epoch.Validators); err != nil { - return nil, nil, err - } - - blockHeader, blockExtra, err = getBlockData(blockHeader.Number-1, c.config.blockchain) - if err != nil { - return nil, nil, err - } - } - - // calculate uptime for blocks from previous epoch that were not processed in previous uptime - // since we can not calculate uptime for the last block in epoch (because of parent signatures) - if blockHeader.Number > commitEpochLookbackSize { - for i := 0; i < commitEpochLookbackSize; i++ { - validators, err := c.config.polybftBackend.GetValidators(blockHeader.Number-2, nil) - if err != nil { - return nil, nil, err - } - - if err := getSealersForBlock(blockExtra, validators); err != nil { - return nil, nil, err - } - - blockHeader, blockExtra, err = getBlockData(blockHeader.Number-1, c.config.blockchain) - if err != nil { - return nil, nil, err - } - } - } - - // include the data in the uptime counter in a deterministic way - addrSet := []types.Address{} - - for addr := range uptimeCounter { - addrSet = append(addrSet, addr) - } - - uptime := make([]*contractsapi.Uptime, len(addrSet)) - - sort.Slice(addrSet, func(i, j int) bool { - return bytes.Compare(addrSet[i][:], addrSet[j][:]) > 0 - }) - - for i, addr := range addrSet { - uptime[i] = &contractsapi.Uptime{ - Validator: addr, - SignedBlocks: new(big.Int).SetInt64(uptimeCounter[addr]), - } - } - - commitEpoch := &contractsapi.CommitEpochValidatorSetFn{ - ID: new(big.Int).SetUint64(epochID), - Epoch: &contractsapi.Epoch{ - StartBlock: new(big.Int).SetUint64(epoch.FirstBlockInEpoch), - EndBlock: new(big.Int).SetUint64(currentBlock.Number + 1), - EpochRoot: types.Hash{}, - }, - } - - distributeRewards := &contractsapi.DistributeRewardForRewardPoolFn{ - EpochID: new(big.Int).SetUint64(epochID), - Uptime: uptime, - } - - return commitEpoch, distributeRewards, nil -} - -// GenerateExitProof generates proof of exit and is a bridge endpoint store function -func (c *consensusRuntime) GenerateExitProof(exitID uint64) (types.Proof, error) { - return c.checkpointManager.GenerateExitProof(exitID) -} - -// GetStateSyncProof returns the proof for the state sync -func (c *consensusRuntime) GetStateSyncProof(stateSyncID uint64) (types.Proof, error) { - return c.stateSyncManager.GetStateSyncProof(stateSyncID) -} - -// setIsActiveValidator updates the activeValidatorFlag field -func (c *consensusRuntime) setIsActiveValidator(isActiveValidator bool) { - c.activeValidatorFlag.Store(isActiveValidator) -} - -// isActiveValidator indicates if node is in validator set or not -func (c *consensusRuntime) IsActiveValidator() bool { - return c.activeValidatorFlag.Load() -} - -// isFixedSizeOfEpochMet checks if epoch reached its end that was configured by its default size -// this is only true if no slashing occurred in the given epoch -func (c *consensusRuntime) isFixedSizeOfEpochMet(blockNumber uint64, epoch *epochMetadata) bool { - return epoch.FirstBlockInEpoch+c.config.PolyBFTConfig.EpochSize-1 == blockNumber -} - -// isFixedSizeOfSprintMet checks if an end of an sprint is reached with the current block -func (c *consensusRuntime) isFixedSizeOfSprintMet(blockNumber uint64, epoch *epochMetadata) bool { - return (blockNumber-epoch.FirstBlockInEpoch+1)%c.config.PolyBFTConfig.SprintSize == 0 -} - -// getSystemState builds SystemState instance for the most current block header -func (c *consensusRuntime) getSystemState(header *types.Header) (SystemState, error) { - provider, err := c.config.blockchain.GetStateProviderForBlock(header) - if err != nil { - return nil, err - } - - return c.config.blockchain.GetSystemState(provider), nil -} - -func (c *consensusRuntime) IsValidProposal(rawProposal []byte) bool { - if err := c.fsm.Validate(rawProposal); err != nil { - c.logger.Error("failed to validate proposal", "error", err) - - return false - } - - return true -} - -func (c *consensusRuntime) IsValidValidator(msg *proto.Message) bool { - c.lock.RLock() - defer c.lock.RUnlock() - - if c.fsm == nil { - c.logger.Warn("unable to validate IBFT message sender, because FSM is not initialized") - - return false - } - - if err := c.fsm.ValidateSender(msg); err != nil { - c.logger.Error("invalid IBFT message received", "error", err) - - return false - } - - return true -} - -func (c *consensusRuntime) IsProposer(id []byte, height, round uint64) bool { - c.lock.RLock() - defer c.lock.RUnlock() - - nextProposer, err := c.fsm.proposerSnapshot.CalcProposer(round, height) - if err != nil { - c.logger.Error("cannot calculate proposer", "error", err) - - return false - } - - c.logger.Info("Proposer calculated", "height", height, "round", round, "address", nextProposer) - - return bytes.Equal(id, nextProposer[:]) -} - -func (c *consensusRuntime) IsValidProposalHash(proposal *proto.Proposal, hash []byte) bool { - if len(proposal.RawProposal) == 0 { - c.logger.Error("proposal hash is not valid because proposal is empty") - - return false - } - - block := types.Block{} - if err := block.UnmarshalRLP(proposal.RawProposal); err != nil { - c.logger.Error("unable to unmarshal proposal", "error", err) - - return false - } - - extra, err := GetIbftExtra(block.Header.ExtraData) - if err != nil { - c.logger.Error("failed to retrieve extra", "block number", block.Number(), "error", err) - - return false - } - - proposalHash, err := extra.Checkpoint.Hash(c.config.blockchain.GetChainID(), block.Number(), block.Hash()) - if err != nil { - c.logger.Error("failed to calculate proposal hash", "block number", block.Number(), "error", err) - - return false - } - - return bytes.Equal(proposalHash.Bytes(), hash) -} - -func (c *consensusRuntime) IsValidCommittedSeal(proposalHash []byte, committedSeal *messages.CommittedSeal) bool { - err := c.fsm.ValidateCommit(committedSeal.Signer, committedSeal.Signature, proposalHash) - if err != nil { - c.logger.Info("Invalid committed seal", "error", err) - - return false - } - - return true -} - -func (c *consensusRuntime) BuildProposal(view *proto.View) []byte { - sharedData, err := c.getGuardedData() - if err != nil { - c.logger.Error("unable to build proposal", "error", err) - - return nil - } - - if sharedData.lastBuiltBlock.Number+1 != view.Height { - c.logger.Error("unable to build proposal, due to lack of parent block", - "parent height", sharedData.lastBuiltBlock.Number, "current height", view.Height) - - return nil - } - - proposal, err := c.fsm.BuildProposal(view.Round) - if err != nil { - c.logger.Error("unable to build proposal", "blockNumber", view, "error", err) - - return nil - } - - return proposal -} - -// InsertProposal inserts a proposal with the specified committed seals -func (c *consensusRuntime) InsertProposal(proposal *proto.Proposal, committedSeals []*messages.CommittedSeal) { - fsm := c.fsm - - fullBlock, err := fsm.Insert(proposal.RawProposal, committedSeals) - if err != nil { - c.logger.Error("cannot insert proposal", "error", err) - - return - } - - c.OnBlockInserted(fullBlock) -} - -// ID return ID (address actually) of the current node -func (c *consensusRuntime) ID() []byte { - return c.config.Key.Address().Bytes() -} - -// GetVotingPowers returns map of validators addresses and their voting powers for the specified height. -func (c *consensusRuntime) GetVotingPowers(height uint64) (map[string]*big.Int, error) { - c.lock.RLock() - defer c.lock.RUnlock() - - if c.fsm == nil { - return nil, errors.New("getting voting power failed - backend is not initialized") - } else if c.fsm.Height() != height { - return nil, fmt.Errorf("getting voting power failed - backend is not initialized for height %d, fsm height %d", - height, c.fsm.Height()) - } - - return c.fsm.validators.GetVotingPowers(), nil -} - -// BuildPrePrepareMessage builds a PREPREPARE message based on the passed in proposal -func (c *consensusRuntime) BuildPrePrepareMessage( - rawProposal []byte, - certificate *proto.RoundChangeCertificate, - view *proto.View, -) *proto.Message { - if len(rawProposal) == 0 { - c.logger.Error("can not build pre-prepare message, since proposal is empty") - - return nil - } - - block := types.Block{} - if err := block.UnmarshalRLP(rawProposal); err != nil { - c.logger.Error(fmt.Sprintf("cannot unmarshal RLP: %s", err)) - - return nil - } - - extra, err := GetIbftExtra(block.Header.ExtraData) - if err != nil { - c.logger.Error("failed to retrieve extra for block %d: %w", block.Number(), err) - - return nil - } - - proposalHash, err := extra.Checkpoint.Hash(c.config.blockchain.GetChainID(), block.Number(), block.Hash()) - if err != nil { - c.logger.Error("failed to calculate proposal hash", "block number", block.Number(), "error", err) - - return nil - } - - proposal := &proto.Proposal{ - RawProposal: rawProposal, - Round: view.Round, - } - - msg := proto.Message{ - View: view, - From: c.ID(), - Type: proto.MessageType_PREPREPARE, - Payload: &proto.Message_PreprepareData{ - PreprepareData: &proto.PrePrepareMessage{ - Proposal: proposal, - ProposalHash: proposalHash.Bytes(), - Certificate: certificate, - }, - }, - } - - message, err := c.config.Key.SignIBFTMessage(&msg) - if err != nil { - c.logger.Error("Cannot sign message", "error", err) - - return nil - } - - return message -} - -// BuildPrepareMessage builds a PREPARE message based on the passed in proposal -func (c *consensusRuntime) BuildPrepareMessage(proposalHash []byte, view *proto.View) *proto.Message { - msg := proto.Message{ - View: view, - From: c.ID(), - Type: proto.MessageType_PREPARE, - Payload: &proto.Message_PrepareData{ - PrepareData: &proto.PrepareMessage{ - ProposalHash: proposalHash, - }, - }, - } - - message, err := c.config.Key.SignIBFTMessage(&msg) - if err != nil { - c.logger.Error("Cannot sign message.", "error", err) - - return nil - } - - return message -} - -// BuildCommitMessage builds a COMMIT message based on the passed in proposal -func (c *consensusRuntime) BuildCommitMessage(proposalHash []byte, view *proto.View) *proto.Message { - committedSeal, err := c.config.Key.SignWithDomain(proposalHash, signer.DomainCheckpointManager) - if err != nil { - c.logger.Error("Cannot create committed seal message.", "error", err) - - return nil - } - - msg := proto.Message{ - View: view, - From: c.ID(), - Type: proto.MessageType_COMMIT, - Payload: &proto.Message_CommitData{ - CommitData: &proto.CommitMessage{ - ProposalHash: proposalHash, - CommittedSeal: committedSeal, - }, - }, - } - - message, err := c.config.Key.SignIBFTMessage(&msg) - if err != nil { - c.logger.Error("Cannot sign message", "Error", err) - - return nil - } - - return message -} - -// BuildRoundChangeMessage builds a ROUND_CHANGE message based on the passed in proposal -func (c *consensusRuntime) BuildRoundChangeMessage( - proposal *proto.Proposal, - certificate *proto.PreparedCertificate, - view *proto.View, -) *proto.Message { - msg := proto.Message{ - View: view, - From: c.ID(), - Type: proto.MessageType_ROUND_CHANGE, - Payload: &proto.Message_RoundChangeData{ - RoundChangeData: &proto.RoundChangeMessage{ - LastPreparedProposal: proposal, - LatestPreparedCertificate: certificate, - }}, - } - - signedMsg, err := c.config.Key.SignIBFTMessage(&msg) - if err != nil { - c.logger.Error("Cannot sign message", "Error", err) - - return nil - } - - return signedMsg -} - -// getFirstBlockOfEpoch returns the first block of epoch in which provided header resides -func (c *consensusRuntime) getFirstBlockOfEpoch(epochNumber uint64, latestHeader *types.Header) (uint64, error) { - if latestHeader.Number == 0 { - // if we are starting the chain, we know that the first block is block 1 - return 1, nil - } - - blockHeader := latestHeader - - blockExtra, err := GetIbftExtra(latestHeader.ExtraData) - if err != nil { - return 0, err - } - - if epochNumber != blockExtra.Checkpoint.EpochNumber { - // its a regular epoch ending. No out of sync happened - return latestHeader.Number + 1, nil - } - - // node was out of sync, so we need to figure out what was the first block of the given epoch - epoch := blockExtra.Checkpoint.EpochNumber - - var firstBlockInEpoch uint64 - - for blockExtra.Checkpoint.EpochNumber == epoch { - firstBlockInEpoch = blockHeader.Number - blockHeader, blockExtra, err = getBlockData(blockHeader.Number-1, c.config.blockchain) - - if err != nil { - return 0, err - } - } - - return firstBlockInEpoch, nil -} - -// getSealersForBlock checks who sealed a given block and updates the counter -func getSealersForBlock(sealersCounter map[types.Address]uint64, - blockExtra *Extra, validators validator.AccountSet) error { - signers, err := validators.GetFilteredValidators(blockExtra.Parent.Bitmap) - if err != nil { - return err - } - - for _, a := range signers.GetAddresses() { - sealersCounter[a]++ - } - - return nil -} diff --git a/consensus/polybft/consensus_runtime_test.go b/consensus/polybft/consensus_runtime_test.go deleted file mode 100644 index 35dcfae..0000000 --- a/consensus/polybft/consensus_runtime_test.go +++ /dev/null @@ -1,1093 +0,0 @@ -package polybft - -import ( - "fmt" - "math/big" - "math/rand" - "os" - "testing" - "time" - - "github.com/0xPolygon/go-ibft/messages/proto" - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/consensus" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/types" -) - -func TestConsensusRuntime_isFixedSizeOfEpochMet_NotReachedEnd(t *testing.T) { - t.Parallel() - - // because of slashing, we can assume some epochs started at random numbers - var cases = []struct { - epochSize, firstBlockInEpoch, parentBlockNumber uint64 - }{ - {4, 1, 2}, - {5, 1, 3}, - {6, 0, 6}, - {7, 0, 4}, - {8, 0, 5}, - {9, 4, 9}, - {10, 7, 10}, - {10, 1, 1}, - } - - runtime := &consensusRuntime{ - config: &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{}, - }, - lastBuiltBlock: &types.Header{}, - epoch: &epochMetadata{}, - } - - for _, c := range cases { - runtime.config.PolyBFTConfig.EpochSize = c.epochSize - runtime.epoch.FirstBlockInEpoch = c.firstBlockInEpoch - assert.False( - t, - runtime.isFixedSizeOfEpochMet(c.parentBlockNumber+1, runtime.epoch), - fmt.Sprintf( - "Not expected end of epoch for epoch size=%v and parent block number=%v", - c.epochSize, - c.parentBlockNumber), - ) - } -} - -func TestConsensusRuntime_isFixedSizeOfEpochMet_ReachedEnd(t *testing.T) { - t.Parallel() - - // because of slashing, we can assume some epochs started at random numbers - var cases = []struct { - epochSize, firstBlockInEpoch, blockNumber uint64 - }{ - {4, 1, 4}, - {5, 1, 5}, - {6, 0, 5}, - {7, 0, 6}, - {8, 0, 7}, - {9, 4, 12}, - {10, 7, 16}, - {10, 1, 10}, - } - - runtime := &consensusRuntime{ - config: &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{}, - }, - epoch: &epochMetadata{}, - } - - for _, c := range cases { - runtime.config.PolyBFTConfig.EpochSize = c.epochSize - runtime.epoch.FirstBlockInEpoch = c.firstBlockInEpoch - assert.True( - t, - runtime.isFixedSizeOfEpochMet(c.blockNumber, runtime.epoch), - fmt.Sprintf( - "Not expected end of epoch for epoch size=%v and parent block number=%v", - c.epochSize, - c.blockNumber), - ) - } -} - -func TestConsensusRuntime_isFixedSizeOfSprintMet_NotReachedEnd(t *testing.T) { - t.Parallel() - - // because of slashing, we can assume some epochs started at random numbers - var cases = []struct { - sprintSize, firstBlockInEpoch, blockNumber uint64 - }{ - {4, 1, 2}, - {5, 1, 3}, - {6, 0, 6}, - {7, 0, 4}, - {8, 0, 5}, - {9, 4, 9}, - {10, 7, 10}, - {10, 1, 1}, - } - - runtime := &consensusRuntime{ - config: &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{}, - }, - epoch: &epochMetadata{}, - } - - for _, c := range cases { - runtime.config.PolyBFTConfig.SprintSize = c.sprintSize - runtime.epoch.FirstBlockInEpoch = c.firstBlockInEpoch - assert.False(t, - runtime.isFixedSizeOfSprintMet(c.blockNumber, runtime.epoch), - fmt.Sprintf( - "Not expected end of sprint for sprint size=%v and parent block number=%v", - c.sprintSize, - c.blockNumber), - ) - } -} - -func TestConsensusRuntime_isFixedSizeOfSprintMet_ReachedEnd(t *testing.T) { - t.Parallel() - - // because of slashing, we can assume some epochs started at random numbers - var cases = []struct { - sprintSize, firstBlockInEpoch, blockNumber uint64 - }{ - {4, 1, 4}, - {5, 1, 5}, - {6, 0, 5}, - {7, 0, 6}, - {8, 0, 7}, - {9, 4, 12}, - {10, 7, 16}, - {10, 1, 10}, - {5, 1, 10}, - {3, 3, 5}, - } - - runtime := &consensusRuntime{ - config: &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{}, - }, - epoch: &epochMetadata{}, - } - - for _, c := range cases { - runtime.config.PolyBFTConfig.SprintSize = c.sprintSize - runtime.epoch.FirstBlockInEpoch = c.firstBlockInEpoch - assert.True(t, - runtime.isFixedSizeOfSprintMet(c.blockNumber, runtime.epoch), - fmt.Sprintf( - "Not expected end of sprint for sprint size=%v and parent block number=%v", - c.sprintSize, - c.blockNumber), - ) - } -} - -func TestConsensusRuntime_OnBlockInserted_EndOfEpoch(t *testing.T) { - t.Parallel() - - const ( - epochSize = uint64(10) - validatorsCount = 7 - ) - - currentEpochNumber := getEpochNumber(t, epochSize, epochSize) - validatorSet := validator.NewTestValidators(t, validatorsCount).GetPublicIdentities() - header, headerMap := createTestBlocks(t, epochSize, epochSize, validatorSet) - builtBlock := consensus.BuildBlock(consensus.BuildBlockParams{ - Header: header, - }) - - newEpochNumber := currentEpochNumber + 1 - systemStateMock := new(systemStateMock) - systemStateMock.On("GetEpoch").Return(newEpochNumber).Once() - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetStateProviderForBlock", mock.Anything).Return(new(stateProviderMock)).Once() - blockchainMock.On("GetSystemState", mock.Anything, mock.Anything).Return(systemStateMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headerMap.getHeader) - - polybftBackendMock := new(polybftBackendMock) - polybftBackendMock.On("GetValidatorsWithTx", mock.Anything, mock.Anything, mock.Anything).Return(validatorSet).Times(3) - - txPool := new(txPoolMock) - txPool.On("ResetWithHeaders", mock.Anything).Once() - - snapshot := NewProposerSnapshot(epochSize-1, validatorSet) - config := &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{ - EpochSize: epochSize, - }, - blockchain: blockchainMock, - polybftBackend: polybftBackendMock, - txPool: txPool, - State: newTestState(t), - } - require.NoError(t, config.State.insertLastProcessedEventsBlock(builtBlock.Number()-1, nil)) - - runtime := &consensusRuntime{ - proposerCalculator: NewProposerCalculatorFromSnapshot(snapshot, config, hclog.NewNullLogger()), - logger: hclog.NewNullLogger(), - state: config.State, - config: config, - epoch: &epochMetadata{ - Number: currentEpochNumber, - FirstBlockInEpoch: header.Number - epochSize + 1, - }, - lastBuiltBlock: &types.Header{Number: header.Number - 1}, - stateSyncManager: &dummyStateSyncManager{}, - checkpointManager: &dummyCheckpointManager{}, - stakeManager: &dummyStakeManager{}, - eventProvider: NewEventProvider(blockchainMock), - stateSyncRelayer: &dummyStateSyncRelayer{}, - } - runtime.OnBlockInserted(&types.FullBlock{Block: builtBlock}) - - require.True(t, runtime.state.EpochStore.isEpochInserted(currentEpochNumber+1)) - require.Equal(t, newEpochNumber, runtime.epoch.Number) - - blockchainMock.AssertExpectations(t) - systemStateMock.AssertExpectations(t) -} - -func TestConsensusRuntime_OnBlockInserted_MiddleOfEpoch(t *testing.T) { - t.Parallel() - - const ( - epoch = 2 - epochSize = uint64(10) - firstBlockInEpoch = epochSize + 1 - blockNumber = epochSize + 2 - ) - - header := &types.Header{Number: blockNumber} - builtBlock := consensus.BuildBlock(consensus.BuildBlockParams{ - Header: header, - }) - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(builtBlock.Header, true).Once() - - polybftBackendMock := new(polybftBackendMock) - polybftBackendMock.On("GetValidatorsWithTx", mock.Anything, mock.Anything, mock.Anything).Return(nil).Once() - - txPool := new(txPoolMock) - txPool.On("ResetWithHeaders", mock.Anything).Once() - - snapshot := NewProposerSnapshot(blockNumber, []*validator.ValidatorMetadata{}) - config := &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{EpochSize: epochSize}, - blockchain: blockchainMock, - txPool: txPool, - } - - runtime := &consensusRuntime{ - lastBuiltBlock: header, - config: &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{EpochSize: epochSize}, - blockchain: blockchainMock, - txPool: txPool, - }, - epoch: &epochMetadata{ - Number: epoch, - FirstBlockInEpoch: firstBlockInEpoch, - }, - logger: hclog.NewNullLogger(), - proposerCalculator: NewProposerCalculatorFromSnapshot(snapshot, config, hclog.NewNullLogger()), - } - runtime.OnBlockInserted(&types.FullBlock{Block: builtBlock}) - - require.Equal(t, header.Number, runtime.lastBuiltBlock.Number) -} - -func TestConsensusRuntime_FSM_NotInValidatorSet(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D"}) - - snapshot := NewProposerSnapshot(1, nil) - config := &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{ - EpochSize: 1, - }, - Key: createTestKey(t), - } - runtime := &consensusRuntime{ - proposerCalculator: NewProposerCalculatorFromSnapshot(snapshot, config, hclog.NewNullLogger()), - config: config, - epoch: &epochMetadata{ - Number: 1, - Validators: validators.GetPublicIdentities(), - }, - lastBuiltBlock: &types.Header{}, - } - runtime.setIsActiveValidator(true) - - err := runtime.FSM() - assert.ErrorIs(t, err, errNotAValidator) -} - -func TestConsensusRuntime_FSM_NotEndOfEpoch_NotEndOfSprint(t *testing.T) { - t.Parallel() - - extra := &Extra{ - Checkpoint: &CheckpointData{}, - } - lastBlock := &types.Header{ - Number: 1, - ExtraData: extra.MarshalRLPTo(nil), - } - - validators := validator.NewTestValidators(t, 3) - blockchainMock := new(blockchainMock) - blockchainMock.On("NewBlockBuilder", mock.Anything).Return(&BlockBuilder{}, nil).Once() - - snapshot := NewProposerSnapshot(1, nil) - config := &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{ - EpochSize: 10, - SprintSize: 5, - }, - Key: wallet.NewKey(validators.GetPrivateIdentities()[0]), - blockchain: blockchainMock, - } - runtime := &consensusRuntime{ - proposerCalculator: NewProposerCalculatorFromSnapshot(snapshot, config, hclog.NewNullLogger()), - logger: hclog.NewNullLogger(), - config: config, - epoch: &epochMetadata{ - Number: 1, - Validators: validators.GetPublicIdentities(), - FirstBlockInEpoch: 1, - }, - lastBuiltBlock: lastBlock, - state: newTestState(t), - stateSyncManager: &dummyStateSyncManager{}, - checkpointManager: &dummyCheckpointManager{}, - } - runtime.setIsActiveValidator(true) - - err := runtime.FSM() - require.NoError(t, err) - - assert.True(t, runtime.IsActiveValidator()) - assert.False(t, runtime.fsm.isEndOfEpoch) - assert.False(t, runtime.fsm.isEndOfSprint) - assert.Equal(t, lastBlock.Number, runtime.fsm.parent.Number) - - address := types.Address(runtime.config.Key.Address()) - assert.True(t, runtime.fsm.ValidatorSet().Includes(address)) - - assert.NotNil(t, runtime.fsm.blockBuilder) - assert.NotNil(t, runtime.fsm.backend) - - blockchainMock.AssertExpectations(t) -} - -func TestConsensusRuntime_FSM_EndOfEpoch_BuildCommitEpoch(t *testing.T) { - t.Parallel() - - const ( - epoch = 0 - epochSize = uint64(10) - sprintSize = uint64(3) - firstBlockInEpoch = uint64(1) - fromIndex = uint64(0) - toIndex = uint64(9) - ) - - validatorAccounts := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - validators := validatorAccounts.GetPublicIdentities() - - lastBuiltBlock, headerMap := createTestBlocks(t, 9, epochSize, validators) - - blockchainMock := new(blockchainMock) - blockchainMock.On("NewBlockBuilder", mock.Anything).Return(&BlockBuilder{}, nil).Once() - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headerMap.getHeader) - - state := newTestState(t) - require.NoError(t, state.EpochStore.insertEpoch(epoch, nil)) - - metadata := &epochMetadata{ - Validators: validators, - Number: epoch, - FirstBlockInEpoch: firstBlockInEpoch, - } - - config := &runtimeConfig{ - PolyBFTConfig: &PolyBFTConfig{ - EpochSize: epochSize, - SprintSize: sprintSize, - }, - Key: validatorAccounts.GetValidator("A").Key(), - blockchain: blockchainMock, - } - - snapshot := NewProposerSnapshot(1, nil) - runtime := &consensusRuntime{ - proposerCalculator: NewProposerCalculatorFromSnapshot(snapshot, config, hclog.NewNullLogger()), - logger: hclog.NewNullLogger(), - state: state, - epoch: metadata, - config: config, - lastBuiltBlock: lastBuiltBlock, - stateSyncManager: &dummyStateSyncManager{}, - checkpointManager: &dummyCheckpointManager{}, - stakeManager: &dummyStakeManager{}, - } - - err := runtime.FSM() - fsm := runtime.fsm - - assert.NoError(t, err) - assert.True(t, fsm.isEndOfEpoch) - assert.NotNil(t, fsm.commitEpochInput) - assert.NotEmpty(t, fsm.commitEpochInput) - - blockchainMock.AssertExpectations(t) -} - -func Test_NewConsensusRuntime(t *testing.T) { - t.Parallel() - - _, err := os.Create("/tmp/consensusState.db") - require.NoError(t, err) - - polyBftConfig := &PolyBFTConfig{ - Bridge: &BridgeConfig{ - StateSenderAddr: types.Address{0x13}, - CheckpointManagerAddr: types.Address{0x10}, - JSONRPCEndpoint: "testEndpoint", - }, - EpochSize: 10, - SprintSize: 10, - BlockTime: common.Duration{Duration: 2 * time.Second}, - } - - validators := validator.NewTestValidators(t, 3).GetPublicIdentities() - - systemStateMock := new(systemStateMock) - systemStateMock.On("GetEpoch").Return(uint64(1)).Once() - systemStateMock.On("GetNextCommittedIndex").Return(uint64(1)).Once() - - blockchainMock := &blockchainMock{} - blockchainMock.On("CurrentHeader").Return(&types.Header{Number: 1, ExtraData: createTestExtraForAccounts(t, 1, validators, nil)}) - blockchainMock.On("GetStateProviderForBlock", mock.Anything).Return(new(stateProviderMock)).Once() - blockchainMock.On("GetSystemState", mock.Anything, mock.Anything).Return(systemStateMock).Once() - blockchainMock.On("GetHeaderByNumber", uint64(0)).Return(&types.Header{Number: 0, ExtraData: createTestExtraForAccounts(t, 0, validators, nil)}) - blockchainMock.On("GetHeaderByNumber", uint64(1)).Return(&types.Header{Number: 1, ExtraData: createTestExtraForAccounts(t, 1, validators, nil)}) - - polybftBackendMock := new(polybftBackendMock) - polybftBackendMock.On("GetValidatorsWithTx", mock.Anything, mock.Anything, mock.Anything).Return(validators).Times(3) - - tmpDir := t.TempDir() - config := &runtimeConfig{ - polybftBackend: polybftBackendMock, - State: newTestState(t), - PolyBFTConfig: polyBftConfig, - DataDir: tmpDir, - Key: createTestKey(t), - blockchain: blockchainMock, - bridgeTopic: &mockTopic{}, - consensusConfig: &consensus.Config{}, - } - - require.NoError(t, config.State.StakeStore.insertFullValidatorSet(validatorSetState{ - BlockNumber: 1, - }, nil)) - - runtime, err := newConsensusRuntime(hclog.NewNullLogger(), config) - require.NoError(t, err) - - assert.False(t, runtime.IsActiveValidator()) - assert.Equal(t, runtime.config.DataDir, tmpDir) - assert.Equal(t, uint64(10), runtime.config.PolyBFTConfig.SprintSize) - assert.Equal(t, uint64(10), runtime.config.PolyBFTConfig.EpochSize) - assert.Equal(t, "0x0000000000000000000000000000000000000101", contracts.ValidatorSetContract.String()) - assert.Equal(t, "0x1300000000000000000000000000000000000000", runtime.config.PolyBFTConfig.Bridge.StateSenderAddr.String()) - assert.Equal(t, "0x1000000000000000000000000000000000000000", runtime.config.PolyBFTConfig.Bridge.CheckpointManagerAddr.String()) - assert.True(t, runtime.IsBridgeEnabled()) - systemStateMock.AssertExpectations(t) - blockchainMock.AssertExpectations(t) - polybftBackendMock.AssertExpectations(t) -} - -func TestConsensusRuntime_restartEpoch_SameEpochNumberAsTheLastOne(t *testing.T) { - t.Parallel() - - const originalBlockNumber = uint64(5) - - newCurrentHeader := &types.Header{Number: originalBlockNumber + 1} - validatorSet := validator.NewTestValidators(t, 3).GetPublicIdentities() - - systemStateMock := new(systemStateMock) - systemStateMock.On("GetEpoch").Return(uint64(1), nil).Once() - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetStateProviderForBlock", mock.Anything).Return(new(stateProviderMock)).Once() - blockchainMock.On("GetSystemState", mock.Anything, mock.Anything).Return(systemStateMock).Once() - - snapshot := NewProposerSnapshot(1, nil) - config := &runtimeConfig{ - blockchain: blockchainMock, - } - runtime := &consensusRuntime{ - proposerCalculator: NewProposerCalculatorFromSnapshot(snapshot, config, hclog.NewNullLogger()), - config: config, - epoch: &epochMetadata{ - Number: 1, - Validators: validatorSet, - FirstBlockInEpoch: 1, - }, - lastBuiltBlock: &types.Header{ - Number: originalBlockNumber, - }, - } - runtime.setIsActiveValidator(true) - - epoch, err := runtime.restartEpoch(newCurrentHeader, nil) - - require.NoError(t, err) - - for _, a := range validatorSet.GetAddresses() { - assert.True(t, epoch.Validators.ContainsAddress(a)) - } - - systemStateMock.AssertExpectations(t) - blockchainMock.AssertExpectations(t) -} - -func TestConsensusRuntime_calculateCommitEpochInput_SecondEpoch(t *testing.T) { - t.Parallel() - - const ( - epoch = 2 - epochSize = 10 - epochStartBlock = 11 - epochEndBlock = 20 - sprintSize = 5 - ) - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E"}) - polybftConfig := &PolyBFTConfig{ - EpochSize: epochSize, - SprintSize: sprintSize, - } - - lastBuiltBlock, headerMap := createTestBlocks(t, 19, epochSize, validators.GetPublicIdentities()) - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headerMap.getHeader) - - polybftBackendMock := new(polybftBackendMock) - polybftBackendMock.On("GetValidators", mock.Anything, mock.Anything).Return(validators.GetPublicIdentities()).Twice() - - config := &runtimeConfig{ - PolyBFTConfig: polybftConfig, - blockchain: blockchainMock, - polybftBackend: polybftBackendMock, - Key: validators.GetValidator("A").Key(), - } - - consensusRuntime := &consensusRuntime{ - config: config, - epoch: &epochMetadata{ - Number: epoch, - Validators: validators.GetPublicIdentities(), - FirstBlockInEpoch: epochStartBlock, - }, - lastBuiltBlock: lastBuiltBlock, - } - - commitEpochInput, distributeRewardsInput, err := consensusRuntime.calculateCommitEpochInput(lastBuiltBlock, - consensusRuntime.epoch) - assert.NoError(t, err) - assert.NotEmpty(t, commitEpochInput) - assert.Equal(t, uint64(epoch), commitEpochInput.ID.Uint64()) - assert.Equal(t, uint64(epochStartBlock), commitEpochInput.Epoch.StartBlock.Uint64()) - assert.Equal(t, uint64(epochEndBlock), commitEpochInput.Epoch.EndBlock.Uint64()) - assert.Equal(t, uint64(epoch), distributeRewardsInput.EpochID.Uint64()) - - blockchainMock.AssertExpectations(t) - polybftBackendMock.AssertExpectations(t) -} - -func TestConsensusRuntime_IsValidValidator_BasicCases(t *testing.T) { - t.Parallel() - - setupFn := func(t *testing.T) (*consensusRuntime, *validator.TestValidators) { - t.Helper() - - validatorAccounts := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - epoch := &epochMetadata{ - Validators: validatorAccounts.GetPublicIdentities("A", "B", "C", "D"), - } - runtime := &consensusRuntime{ - epoch: epoch, - logger: hclog.NewNullLogger(), - fsm: &fsm{validators: validator.NewValidatorSet(epoch.Validators, hclog.NewNullLogger())}, - } - - return runtime, validatorAccounts - } - - cases := []struct { - name string - signerAlias string - senderAlias string - isValidSender bool - }{ - { - name: "Valid sender", - signerAlias: "A", - senderAlias: "A", - isValidSender: true, - }, - { - name: "Sender not amongst current validators", - signerAlias: "F", - senderAlias: "F", - isValidSender: false, - }, - { - name: "Sender and signer accounts mismatch", - signerAlias: "A", - senderAlias: "B", - isValidSender: false, - }, - } - - for _, c := range cases { - c := c - t.Run(c.name, func(t *testing.T) { - t.Parallel() - - runtime, validatorAccounts := setupFn(t) - signer := validatorAccounts.GetValidator(c.signerAlias) - sender := validatorAccounts.GetValidator(c.senderAlias) - msg, err := signer.Key().SignIBFTMessage(&proto.Message{From: sender.Address().Bytes()}) - - require.NoError(t, err) - require.Equal(t, c.isValidSender, runtime.IsValidValidator(msg)) - }) - } -} - -func TestConsensusRuntime_IsValidValidator_TamperSignature(t *testing.T) { - t.Parallel() - - validatorAccounts := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - epoch := &epochMetadata{ - Validators: validatorAccounts.GetPublicIdentities("A", "B", "C", "D"), - } - runtime := &consensusRuntime{ - epoch: epoch, - logger: hclog.NewNullLogger(), - fsm: &fsm{validators: validator.NewValidatorSet(epoch.Validators, hclog.NewNullLogger())}, - } - - // provide invalid signature - sender := validatorAccounts.GetValidator("A") - msg := &proto.Message{ - From: sender.Address().Bytes(), - Signature: []byte{1, 2, 3, 4, 5}, - } - require.False(t, runtime.IsValidValidator(msg)) -} - -func TestConsensusRuntime_TamperMessageContent(t *testing.T) { - t.Parallel() - - validatorAccounts := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - epoch := &epochMetadata{ - Validators: validatorAccounts.GetPublicIdentities("A", "B", "C", "D"), - } - runtime := &consensusRuntime{ - epoch: epoch, - logger: hclog.NewNullLogger(), - fsm: &fsm{validators: validator.NewValidatorSet(epoch.Validators, hclog.NewNullLogger())}, - } - sender := validatorAccounts.GetValidator("A") - proposalHash := []byte{2, 4, 6, 8, 10} - proposalSignature, err := sender.Key().SignWithDomain(proposalHash, signer.DomainCheckpointManager) - require.NoError(t, err) - - msg := &proto.Message{ - View: &proto.View{}, - From: sender.Address().Bytes(), - Type: proto.MessageType_COMMIT, - Payload: &proto.Message_CommitData{ - CommitData: &proto.CommitMessage{ - ProposalHash: proposalHash, - CommittedSeal: proposalSignature, - }, - }, - } - // sign the message itself - msg, err = sender.Key().SignIBFTMessage(msg) - assert.NoError(t, err) - // signature verification works - assert.True(t, runtime.IsValidValidator(msg)) - - // modify message without signing it again - msg.Payload = &proto.Message_CommitData{ - CommitData: &proto.CommitMessage{ - ProposalHash: []byte{1, 3, 5, 7, 9}, // modification - CommittedSeal: proposalSignature, - }, - } - // signature isn't valid, because message was tampered - assert.False(t, runtime.IsValidValidator(msg)) -} - -func TestConsensusRuntime_IsValidProposalHash(t *testing.T) { - t.Parallel() - - extra := &Extra{ - Checkpoint: &CheckpointData{ - EpochNumber: 1, - BlockRound: 1, - }, - } - block := &types.Block{ - Header: &types.Header{ - Number: 10, - ExtraData: extra.MarshalRLPTo(nil), - }, - } - block.Header.ComputeHash() - - proposalHash, err := extra.Checkpoint.Hash(0, block.Number(), block.Hash()) - require.NoError(t, err) - - runtime := &consensusRuntime{ - logger: hclog.NewNullLogger(), - config: &runtimeConfig{blockchain: new(blockchainMock)}, - } - - require.True(t, runtime.IsValidProposalHash(&proto.Proposal{RawProposal: block.MarshalRLP()}, proposalHash.Bytes())) -} - -func TestConsensusRuntime_IsValidProposalHash_InvalidProposalHash(t *testing.T) { - t.Parallel() - - extra := &Extra{ - Checkpoint: &CheckpointData{ - EpochNumber: 1, - BlockRound: 1, - }, - } - - block := &types.Block{ - Header: &types.Header{ - Number: 10, - ExtraData: extra.MarshalRLPTo(nil), - }, - } - - proposalHash, err := extra.Checkpoint.Hash(0, block.Number(), block.Hash()) - require.NoError(t, err) - - extra.Checkpoint.BlockRound = 2 // change it so it is not the same as in proposal hash - block.Header.ExtraData = extra.MarshalRLPTo(nil) - block.Header.ComputeHash() - - runtime := &consensusRuntime{ - logger: hclog.NewNullLogger(), - config: &runtimeConfig{blockchain: new(blockchainMock)}, - } - - require.False(t, runtime.IsValidProposalHash(&proto.Proposal{RawProposal: block.MarshalRLP()}, proposalHash.Bytes())) -} - -func TestConsensusRuntime_IsValidProposalHash_InvalidExtra(t *testing.T) { - t.Parallel() - - extra := &Extra{ - Checkpoint: &CheckpointData{ - EpochNumber: 1, - BlockRound: 1, - }, - } - - block := &types.Block{ - Header: &types.Header{ - Number: 10, - ExtraData: []byte{1, 2, 3}, // invalid extra in block - }, - } - block.Header.ComputeHash() - - proposalHash, err := extra.Checkpoint.Hash(0, block.Number(), block.Hash()) - require.NoError(t, err) - - runtime := &consensusRuntime{ - logger: hclog.NewNullLogger(), - config: &runtimeConfig{blockchain: new(blockchainMock)}, - } - - require.False(t, runtime.IsValidProposalHash(&proto.Proposal{RawProposal: block.MarshalRLP()}, proposalHash.Bytes())) -} - -func TestConsensusRuntime_BuildProposal_InvalidParent(t *testing.T) { - config := &runtimeConfig{} - snapshot := NewProposerSnapshot(1, nil) - runtime := &consensusRuntime{ - logger: hclog.NewNullLogger(), - lastBuiltBlock: &types.Header{Number: 2}, - epoch: &epochMetadata{Number: 1}, - config: config, - proposerCalculator: NewProposerCalculatorFromSnapshot(snapshot, config, hclog.NewNullLogger()), - } - - require.Nil(t, runtime.BuildProposal(&proto.View{Round: 5})) -} - -func TestConsensusRuntime_ID(t *testing.T) { - t.Parallel() - - key1, key2 := createTestKey(t), createTestKey(t) - runtime := &consensusRuntime{ - config: &runtimeConfig{Key: key1}, - } - - require.Equal(t, runtime.ID(), key1.Address().Bytes()) - require.NotEqual(t, runtime.ID(), key2.Address().Bytes()) -} - -func TestConsensusRuntime_GetVotingPowers(t *testing.T) { - t.Parallel() - - const height = 100 - - validatorAccounts := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C"}, []uint64{1, 3, 2}) - runtime := &consensusRuntime{} - - _, err := runtime.GetVotingPowers(height) - require.Error(t, err) - - runtime.fsm = &fsm{ - validators: validatorAccounts.ToValidatorSet(), - parent: &types.Header{Number: height}, - } - - _, err = runtime.GetVotingPowers(height) - require.Error(t, err) - - runtime.fsm.parent.Number = height - 1 - - val, err := runtime.GetVotingPowers(height) - require.NoError(t, err) - - addresses := validatorAccounts.GetPublicIdentities([]string{"A", "B", "C"}...).GetAddresses() - - assert.Equal(t, uint64(1), val[types.AddressToString(addresses[0])].Uint64()) - assert.Equal(t, uint64(3), val[types.AddressToString(addresses[1])].Uint64()) - assert.Equal(t, uint64(2), val[types.AddressToString(addresses[2])].Uint64()) -} - -func TestConsensusRuntime_BuildRoundChangeMessage(t *testing.T) { - t.Parallel() - - key := createTestKey(t) - view, rawProposal, certificate := &proto.View{}, []byte{1}, &proto.PreparedCertificate{} - - runtime := &consensusRuntime{ - config: &runtimeConfig{ - Key: key, - }, - } - - proposal := &proto.Proposal{ - RawProposal: rawProposal, - Round: view.Round, - } - - expected := proto.Message{ - View: view, - From: key.Address().Bytes(), - Type: proto.MessageType_ROUND_CHANGE, - Payload: &proto.Message_RoundChangeData{RoundChangeData: &proto.RoundChangeMessage{ - LatestPreparedCertificate: certificate, - LastPreparedProposal: proposal, - }}, - } - - signedMsg, err := key.SignIBFTMessage(&expected) - require.NoError(t, err) - - assert.Equal(t, signedMsg, runtime.BuildRoundChangeMessage(proposal, certificate, view)) -} - -func TestConsensusRuntime_BuildCommitMessage(t *testing.T) { - t.Parallel() - - key := createTestKey(t) - view, proposalHash := &proto.View{}, []byte{1, 2, 4} - - runtime := &consensusRuntime{ - config: &runtimeConfig{ - Key: key, - }, - } - - committedSeal, err := key.SignWithDomain(proposalHash, signer.DomainCheckpointManager) - require.NoError(t, err) - - expected := proto.Message{ - View: view, - From: key.Address().Bytes(), - Type: proto.MessageType_COMMIT, - Payload: &proto.Message_CommitData{ - CommitData: &proto.CommitMessage{ - ProposalHash: proposalHash, - CommittedSeal: committedSeal, - }, - }, - } - - signedMsg, err := key.SignIBFTMessage(&expected) - require.NoError(t, err) - - assert.Equal(t, signedMsg, runtime.BuildCommitMessage(proposalHash, view)) -} - -func TestConsensusRuntime_BuildPrePrepareMessage_EmptyProposal(t *testing.T) { - t.Parallel() - - runtime := &consensusRuntime{logger: hclog.NewNullLogger()} - - assert.Nil(t, runtime.BuildPrePrepareMessage(nil, &proto.RoundChangeCertificate{}, &proto.View{Height: 1, Round: 0})) -} - -func TestConsensusRuntime_IsValidProposalHash_EmptyProposal(t *testing.T) { - t.Parallel() - - runtime := &consensusRuntime{logger: hclog.NewNullLogger()} - - assert.False(t, runtime.IsValidProposalHash(&proto.Proposal{}, []byte("hash"))) -} - -func TestConsensusRuntime_BuildPrepareMessage(t *testing.T) { - t.Parallel() - - key := createTestKey(t) - view, proposalHash := &proto.View{}, []byte{1, 2, 4} - - runtime := &consensusRuntime{ - config: &runtimeConfig{ - Key: key, - }, - } - - expected := proto.Message{ - View: view, - From: key.Address().Bytes(), - Type: proto.MessageType_PREPARE, - Payload: &proto.Message_PrepareData{ - PrepareData: &proto.PrepareMessage{ - ProposalHash: proposalHash, - }, - }, - } - - signedMsg, err := key.SignIBFTMessage(&expected) - require.NoError(t, err) - - assert.Equal(t, signedMsg, runtime.BuildPrepareMessage(proposalHash, view)) -} - -func createTestBlocks(t *testing.T, numberOfBlocks, defaultEpochSize uint64, - validatorSet validator.AccountSet) (*types.Header, *testHeadersMap) { - t.Helper() - - headerMap := &testHeadersMap{} - bitmaps := createTestBitmaps(t, validatorSet, numberOfBlocks) - - extra := &Extra{ - Checkpoint: &CheckpointData{EpochNumber: 0}, - } - - genesisBlock := &types.Header{ - Number: 0, - ExtraData: extra.MarshalRLPTo(nil), - } - parentHash := types.BytesToHash(big.NewInt(0).Bytes()) - - headerMap.addHeader(genesisBlock) - - var hash types.Hash - - var blockHeader *types.Header - - for i := uint64(1); i <= numberOfBlocks; i++ { - big := big.NewInt(int64(i)) - hash = types.BytesToHash(big.Bytes()) - - header := &types.Header{ - Number: i, - ParentHash: parentHash, - ExtraData: createTestExtraForAccounts(t, getEpochNumber(t, i, defaultEpochSize), validatorSet, bitmaps[i]), - GasLimit: types.StateTransactionGasLimit, - } - - headerMap.addHeader(header) - - parentHash = hash - blockHeader = header - } - - return blockHeader, headerMap -} - -func createTestBitmaps(t *testing.T, validators validator.AccountSet, numberOfBlocks uint64) map[uint64]bitmap.Bitmap { - t.Helper() - - bitmaps := make(map[uint64]bitmap.Bitmap, numberOfBlocks) - - rand.Seed(time.Now().UTC().Unix()) - - for i := numberOfBlocks; i > 1; i-- { - bitmap := bitmap.Bitmap{} - j := 0 - - for j != 3 { - validator := validators[rand.Intn(validators.Len())] - index := uint64(validators.Index(validator.Address)) - - if !bitmap.IsSet(index) { - bitmap.Set(index) - j++ - } - } - - bitmaps[i] = bitmap - } - - return bitmaps -} - -func createTestExtraForAccounts(t *testing.T, epoch uint64, validators validator.AccountSet, b bitmap.Bitmap) []byte { - t.Helper() - - dummySignature := [64]byte{} - extraData := Extra{ - Validators: &validator.ValidatorSetDelta{ - Added: validators, - Removed: bitmap.Bitmap{}, - }, - Parent: &Signature{Bitmap: b, AggregatedSignature: dummySignature[:]}, - Committed: &Signature{Bitmap: b, AggregatedSignature: dummySignature[:]}, - Checkpoint: &CheckpointData{EpochNumber: epoch}, - } - - return extraData.MarshalRLPTo(nil) -} - -func encodeExitEvents(t *testing.T, exitEvents []*ExitEvent) [][]byte { - t.Helper() - - encodedEvents := make([][]byte, len(exitEvents)) - - for i, e := range exitEvents { - encodedEvent, err := e.L2StateSyncedEvent.Encode() - require.NoError(t, err) - - encodedEvents[i] = encodedEvent - } - - return encodedEvents -} diff --git a/consensus/polybft/contracts_initializer.go b/consensus/polybft/contracts_initializer.go deleted file mode 100644 index 4513103..0000000 --- a/consensus/polybft/contracts_initializer.go +++ /dev/null @@ -1,278 +0,0 @@ -package polybft - -import ( - "fmt" - "math/big" - - "github.com/umbracle/ethgo/abi" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/state" - "github.com/xgr-network/xgr-node/types" -) - -const ( - contractCallGasLimit = 100_000_000 -) - -// initValidatorSet initializes ValidatorSet SC -func initValidatorSet(polyBFTConfig PolyBFTConfig, transition *state.Transition) error { - initialValidators := make([]*contractsapi.ValidatorInit, len(polyBFTConfig.InitialValidatorSet)) - for i, validator := range polyBFTConfig.InitialValidatorSet { - initialValidators[i] = &contractsapi.ValidatorInit{ - Addr: validator.Address, - Stake: validator.Stake, - } - } - - initFn := &contractsapi.InitializeValidatorSetFn{ - NewStateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewRootChainManager: polyBFTConfig.Bridge.CustomSupernetManagerAddr, - NewEpochSize: new(big.Int).SetUint64(polyBFTConfig.EpochSize), - InitialValidators: initialValidators, - } - - input, err := initFn.EncodeAbi() - if err != nil { - return fmt.Errorf("ValidatorSet.initialize params encoding failed: %w", err) - } - - return callContract(contracts.SystemCaller, - contracts.ValidatorSetContract, input, "ValidatorSet.initialize", transition) -} - -// initRewardPool initializes RewardPool SC -func initRewardPool(polybftConfig PolyBFTConfig, transition *state.Transition) error { - initFn := &contractsapi.InitializeRewardPoolFn{ - NewRewardToken: polybftConfig.RewardConfig.TokenAddress, - NewRewardWallet: polybftConfig.RewardConfig.WalletAddress, - NewValidatorSet: contracts.ValidatorSetContract, - NewBaseReward: new(big.Int).SetUint64(polybftConfig.EpochReward), - } - - input, err := initFn.EncodeAbi() - if err != nil { - return fmt.Errorf("RewardPool.initialize params encoding failed: %w", err) - } - - return callContract(contracts.SystemCaller, - contracts.RewardPoolContract, input, "RewardPool.initialize", transition) -} - -// getInitERC20PredicateInput builds initialization input parameters for child chain ERC20Predicate SC -func getInitERC20PredicateInput(config *BridgeConfig, childChainMintable bool) ([]byte, error) { - var params contractsapi.StateTransactionInput - if childChainMintable { - params = &contractsapi.InitializeRootMintableERC20PredicateFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewChildERC20Predicate: config.ChildMintableERC20PredicateAddr, - NewChildTokenTemplate: config.ChildERC20Addr, - } - } else { - params = &contractsapi.InitializeChildERC20PredicateFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewRootERC20Predicate: config.RootERC20PredicateAddr, - NewChildTokenTemplate: contracts.ChildERC20Contract, - NewNativeTokenRootAddress: config.RootNativeERC20Addr, - } - } - - return params.EncodeAbi() -} - -// getInitERC20PredicateACLInput builds initialization input parameters for child chain ERC20PredicateAccessList SC -func getInitERC20PredicateACLInput(config *BridgeConfig, owner types.Address, - useAllowList, useBlockList, childChainMintable bool) ([]byte, error) { - var params contractsapi.StateTransactionInput - if childChainMintable { - params = &contractsapi.InitializeRootMintableERC20PredicateACLFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewChildERC20Predicate: config.ChildMintableERC20PredicateAddr, - NewChildTokenTemplate: config.ChildERC20Addr, - NewUseAllowList: useAllowList, - NewUseBlockList: useBlockList, - NewOwner: owner, - } - } else { - params = &contractsapi.InitializeChildERC20PredicateACLFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewRootERC20Predicate: config.RootERC20PredicateAddr, - NewChildTokenTemplate: contracts.ChildERC20Contract, - NewNativeTokenRootAddress: config.RootNativeERC20Addr, - NewUseAllowList: useAllowList, - NewUseBlockList: useBlockList, - NewOwner: owner, - } - } - - return params.EncodeAbi() -} - -// getInitERC721PredicateInput builds initialization input parameters for child chain ERC721Predicate SC -func getInitERC721PredicateInput(config *BridgeConfig, childOriginatedTokens bool) ([]byte, error) { - var params contractsapi.StateTransactionInput - if childOriginatedTokens { - params = &contractsapi.InitializeRootMintableERC721PredicateFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewChildERC721Predicate: config.ChildMintableERC721PredicateAddr, - NewChildTokenTemplate: config.ChildERC721Addr, - } - } else { - params = &contractsapi.InitializeChildERC721PredicateFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewRootERC721Predicate: config.RootERC721PredicateAddr, - NewChildTokenTemplate: contracts.ChildERC721Contract, - } - } - - return params.EncodeAbi() -} - -// getInitERC721PredicateACLInput builds initialization input parameters -// for child chain ERC721PredicateAccessList SC -func getInitERC721PredicateACLInput(config *BridgeConfig, owner types.Address, - useAllowList, useBlockList, childChainMintable bool) ([]byte, error) { - var params contractsapi.StateTransactionInput - if childChainMintable { - params = &contractsapi.InitializeRootMintableERC721PredicateACLFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewChildERC721Predicate: config.ChildMintableERC721PredicateAddr, - NewChildTokenTemplate: config.ChildERC721Addr, - NewUseAllowList: useAllowList, - NewUseBlockList: useBlockList, - NewOwner: owner, - } - } else { - params = &contractsapi.InitializeChildERC721PredicateACLFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewRootERC721Predicate: config.RootERC721PredicateAddr, - NewChildTokenTemplate: contracts.ChildERC721Contract, - NewUseAllowList: useAllowList, - NewUseBlockList: useBlockList, - NewOwner: owner, - } - } - - return params.EncodeAbi() -} - -// getInitERC1155PredicateInput builds initialization input parameters for child chain ERC1155Predicate SC -func getInitERC1155PredicateInput(config *BridgeConfig, childChainMintable bool) ([]byte, error) { - var params contractsapi.StateTransactionInput - if childChainMintable { - params = &contractsapi.InitializeRootMintableERC1155PredicateFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewChildERC1155Predicate: config.ChildMintableERC1155PredicateAddr, - NewChildTokenTemplate: config.ChildERC1155Addr, - } - } else { - params = &contractsapi.InitializeChildERC1155PredicateFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewRootERC1155Predicate: config.RootERC1155PredicateAddr, - NewChildTokenTemplate: contracts.ChildERC1155Contract, - } - } - - return params.EncodeAbi() -} - -// getInitERC1155PredicateACLInput builds initialization input parameters -// for child chain ERC1155PredicateAccessList SC -func getInitERC1155PredicateACLInput(config *BridgeConfig, owner types.Address, - useAllowList, useBlockList, childChainMintable bool) ([]byte, error) { - var params contractsapi.StateTransactionInput - if childChainMintable { - params = &contractsapi.InitializeRootMintableERC1155PredicateACLFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewChildERC1155Predicate: config.ChildMintableERC1155PredicateAddr, - NewChildTokenTemplate: config.ChildERC1155Addr, - NewUseAllowList: useAllowList, - NewUseBlockList: useBlockList, - NewOwner: owner, - } - } else { - params = &contractsapi.InitializeChildERC1155PredicateACLFn{ - NewL2StateSender: contracts.L2StateSenderContract, - NewStateReceiver: contracts.StateReceiverContract, - NewRootERC1155Predicate: config.RootERC1155PredicateAddr, - NewChildTokenTemplate: contracts.ChildERC1155Contract, - NewUseAllowList: useAllowList, - NewUseBlockList: useBlockList, - NewOwner: owner, - } - } - - return params.EncodeAbi() -} - -// mintRewardTokensToWallet mints configured amount of reward tokens to reward wallet address -func mintRewardTokensToWallet(polyBFTConfig PolyBFTConfig, transition *state.Transition) error { - if isNativeRewardToken(polyBFTConfig) { - // if reward token is a native erc20 token, we don't need to mint an amount of tokens - // for given wallet address to it since this is done in premine - return nil - } - - mintFn := contractsapi.MintRootERC20Fn{ - To: polyBFTConfig.RewardConfig.WalletAddress, - Amount: polyBFTConfig.RewardConfig.WalletAmount, - } - - input, err := mintFn.EncodeAbi() - if err != nil { - return fmt.Errorf("RewardToken.mint params encoding failed: %w", err) - } - - return callContract(contracts.SystemCaller, polyBFTConfig.RewardConfig.TokenAddress, input, - "RewardToken.mint", transition) -} - -// approveRewardPoolAsSpender approves reward pool contract as reward token spender -// since reward pool distributes rewards. -func approveRewardPoolAsSpender(polyBFTConfig PolyBFTConfig, transition *state.Transition) error { - approveFn := &contractsapi.ApproveRootERC20Fn{ - Spender: contracts.RewardPoolContract, - Amount: polyBFTConfig.RewardConfig.WalletAmount, - } - - input, err := approveFn.EncodeAbi() - if err != nil { - return fmt.Errorf("RewardToken.approve params encoding failed: %w", err) - } - - return callContract(polyBFTConfig.RewardConfig.WalletAddress, - polyBFTConfig.RewardConfig.TokenAddress, input, "RewardToken.approve", transition) -} - -// callContract calls given smart contract function, encoded in input parameter -func callContract(from, to types.Address, input []byte, contractName string, transition *state.Transition) error { - result := transition.Call2(from, to, input, big.NewInt(0), contractCallGasLimit) - if result.Failed() { - if result.Reverted() { - if revertReason, err := abi.UnpackRevertError(result.ReturnValue); err == nil { - return fmt.Errorf("%s contract call was reverted: %s", contractName, revertReason) - } - } - - return fmt.Errorf("%s contract call failed: %w", contractName, result.Err) - } - - return nil -} - -// isNativeRewardToken returns true in case a native token is used as a reward token as well -func isNativeRewardToken(cfg PolyBFTConfig) bool { - return cfg.RewardConfig.TokenAddress == contracts.NativeERC20TokenContract -} diff --git a/consensus/polybft/contractsapi/artifact/artifacts.go b/consensus/polybft/contractsapi/artifact/artifacts.go deleted file mode 100644 index 358d416..0000000 --- a/consensus/polybft/contractsapi/artifact/artifacts.go +++ /dev/null @@ -1,47 +0,0 @@ -package artifact - -import ( - "encoding/json" - "fmt" - "os" - "path/filepath" - - "github.com/umbracle/ethgo/abi" - "github.com/xgr-network/xgr-node/helper/hex" -) - -func ReadArtifactData(rootFolder, contractPath, contractName string) ([]byte, error) { - fileName := filepath.Join(rootFolder, contractPath, fmt.Sprintf("%s.json", contractName)) - - absolutePath, err := filepath.Abs(fileName) - if err != nil { - return nil, err - } - - return os.ReadFile(filepath.Clean(absolutePath)) -} - -func DecodeArtifact(data []byte) (*Artifact, error) { - var hexRes HexArtifact - if err := json.Unmarshal(data, &hexRes); err != nil { - return nil, fmt.Errorf("artifact found but no correct format: %w", err) - } - - return &Artifact{ - Abi: hexRes.Abi, - Bytecode: hex.MustDecodeHex(hexRes.ByteCode), - DeployedBytecode: hex.MustDecodeHex(hexRes.DeployedBytecode), - }, nil -} - -type HexArtifact struct { - Abi *abi.ABI - ByteCode string - DeployedBytecode string -} - -type Artifact struct { - Abi *abi.ABI - Bytecode []byte - DeployedBytecode []byte -} diff --git a/consensus/polybft/contractsapi/artifacts-gen/main.go b/consensus/polybft/contractsapi/artifacts-gen/main.go deleted file mode 100644 index 206dcc7..0000000 --- a/consensus/polybft/contractsapi/artifacts-gen/main.go +++ /dev/null @@ -1,237 +0,0 @@ -package main - -import ( - "bytes" - "encoding/json" - "fmt" - "go/format" - "log" - "os" - "path" - "runtime" - "strings" - - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi/artifact" - "github.com/xgr-network/xgr-node/helper/common" -) - -const ( - extension = ".sol" -) - -func main() { - _, filename, _, _ := runtime.Caller(0) //nolint: dogsled - currentPath := path.Dir(filename) - scpath := path.Join(currentPath, "../../../../core-contracts/artifacts/contracts/") - - readContracts := []struct { - Path string - Name string - }{ - { - "child/L2StateSender.sol", - "L2StateSender", - }, - { - "child/StateReceiver.sol", - "StateReceiver", - }, - { - "child/NativeERC20.sol", - "NativeERC20", - }, - { - "child/NativeERC20Mintable.sol", - "NativeERC20Mintable", - }, - { - "child/ChildERC20.sol", - "ChildERC20", - }, - { - "child/ChildERC20Predicate.sol", - "ChildERC20Predicate", - }, - { - "child/ChildERC20PredicateAccessList.sol", - "ChildERC20PredicateACL", - }, - { - "child/RootMintableERC20Predicate.sol", - "RootMintableERC20Predicate", - }, - { - "child/RootMintableERC20PredicateAccessList.sol", - "RootMintableERC20PredicateACL", - }, - { - "child/ChildERC721.sol", - "ChildERC721", - }, - { - "child/ChildERC721Predicate.sol", - "ChildERC721Predicate", - }, - { - "child/ChildERC721PredicateAccessList.sol", - "ChildERC721PredicateACL", - }, - { - "child/RootMintableERC721Predicate.sol", - "RootMintableERC721Predicate", - }, - { - "child/RootMintableERC721PredicateAccessList.sol", - "RootMintableERC721PredicateACL", - }, - { - "child/ChildERC1155.sol", - "ChildERC1155", - }, - { - "child/ChildERC1155Predicate.sol", - "ChildERC1155Predicate", - }, - { - "child/ChildERC1155PredicateAccessList.sol", - "ChildERC1155PredicateACL", - }, - { - "child/RootMintableERC1155Predicate.sol", - "RootMintableERC1155Predicate", - }, - { - "child/RootMintableERC1155PredicateAccessList.sol", - "RootMintableERC1155PredicateACL", - }, - { - "child/System.sol", - "System", - }, - { - "common/BLS.sol", - "BLS", - }, - { - "common/BN256G2.sol", - "BN256G2", - }, - { - "common/Merkle.sol", - "Merkle", - }, - { - "root/CheckpointManager.sol", - "CheckpointManager", - }, - { - "root/ExitHelper.sol", - "ExitHelper", - }, - { - "root/StateSender.sol", - "StateSender", - }, - { - "mocks/MockERC20.sol", - "MockERC20", - }, - { - "root/RootERC20Predicate.sol", - "RootERC20Predicate", - }, - { - "root/ChildMintableERC20Predicate.sol", - "ChildMintableERC20Predicate", - }, - { - "mocks/MockERC721.sol", - "MockERC721", - }, - { - "root/RootERC721Predicate.sol", - "RootERC721Predicate", - }, - { - "root/ChildMintableERC721Predicate.sol", - "ChildMintableERC721Predicate", - }, - { - "mocks/MockERC1155.sol", - "MockERC1155", - }, - { - "root/RootERC1155Predicate.sol", - "RootERC1155Predicate", - }, - { - "root/ChildMintableERC1155Predicate.sol", - "ChildMintableERC1155Predicate", - }, - { - "root/staking/CustomSupernetManager.sol", - "CustomSupernetManager", - }, - { - "root/staking/StakeManager.sol", - "StakeManager", - }, - { - "child/validator/RewardPool.sol", - "RewardPool", - }, - { - "child/validator/ValidatorSet.sol", - "ValidatorSet", - }, - { - "child/EIP1559Burn.sol", - "EIP1559Burn", - }, - { - "lib/GenesisProxy.sol", - "GenesisProxy", - }, - { - "../@openzeppelin/contracts/proxy/transparent/TransparentUpgradeableProxy.sol", - "TransparentUpgradeableProxy", - }, - } - - str := `// This is auto-generated file. DO NOT EDIT. -package contractsapi - -` - - for _, v := range readContracts { - artifactBytes, err := artifact.ReadArtifactData(scpath, v.Path, getContractName(v.Path)) - if err != nil { - log.Fatal(err) - } - - dst := &bytes.Buffer{} - if err = json.Compact(dst, artifactBytes); err != nil { - log.Fatal(err) - } - - str += fmt.Sprintf("var %sArtifact string = `%s`\n", v.Name, dst.String()) - } - - output, err := format.Source([]byte(str)) - if err != nil { - fmt.Println(str) - log.Fatal(err) - } - - if err = common.SaveFileSafe(currentPath+"/../gen_sc_data.go", output, 0600); err != nil { - log.Fatal(err) - } -} - -// getContractName extracts smart contract name from provided path -func getContractName(path string) string { - pathSegments := strings.Split(path, string([]rune{os.PathSeparator})) - nameSegment := pathSegments[len(pathSegments)-1] - - return strings.Split(nameSegment, extension)[0] -} diff --git a/consensus/polybft/contractsapi/bindings-gen/main.go b/consensus/polybft/contractsapi/bindings-gen/main.go deleted file mode 100644 index b4dc8dd..0000000 --- a/consensus/polybft/contractsapi/bindings-gen/main.go +++ /dev/null @@ -1,805 +0,0 @@ -package main - -import ( - "bytes" - "errors" - "fmt" - "go/format" - "log" - "regexp" - "strconv" - "strings" - "text/template" - - "github.com/umbracle/ethgo/abi" - - gensc "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi/artifact" - "github.com/xgr-network/xgr-node/helper/common" -) - -const ( - abiTypeNameFormat = "var %sABIType = abi.MustNewType(\"%s\")" - eventNameFormat = "%sEvent" - functionNameFormat = "%sFn" -) - -var ( - signatureFunctionFormat = regexp.MustCompile(`^(.*)\((.*)\)$`) -) - -type generatedData struct { - resultString []string - structs []string -} - -func main() { - cases := []struct { - contractName string - artifact *artifact.Artifact - generateConstructor bool - functions []string - events []string - }{ - { - "StateReceiver", - gensc.StateReceiver, - false, - []string{ - "commit", - "execute", - "batchExecute", - }, - []string{ - "StateSyncResult", - "NewCommitment", - }, - }, - { - "StateSender", - gensc.StateSender, - false, - []string{ - "syncState", - }, - []string{ - "StateSynced", - }, - }, - { - "L2StateSender", - gensc.L2StateSender, - false, - []string{}, - []string{ - "L2StateSynced", - }, - }, - { - "CheckpointManager", - gensc.CheckpointManager, - true, - []string{ - "submit", - "initialize", - "getCheckpointBlock", - }, - []string{}, - }, - { - "ExitHelper", - gensc.ExitHelper, - false, - []string{ - "initialize", - "exit", - }, - []string{}, - }, - { - "ChildERC20Predicate", - gensc.ChildERC20Predicate, - false, - []string{ - "initialize", - "withdrawTo", - }, - []string{}, - }, - { - "ChildERC20PredicateACL", - gensc.ChildERC20PredicateACL, - false, - []string{ - "initialize(address,address,address,address,address,bool,bool,address)", - "withdrawTo", - }, - []string{}, - }, - { - "RootMintableERC20Predicate", - gensc.RootMintableERC20Predicate, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "RootMintableERC20PredicateACL", - gensc.RootMintableERC20PredicateACL, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "NativeERC20", - gensc.NativeERC20, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "NativeERC20Mintable", - gensc.NativeERC20Mintable, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "RootERC20Predicate", - gensc.RootERC20Predicate, - false, - []string{ - "initialize", - "depositTo", - }, - []string{ - "TokenMapped", - }, - }, - { - "ChildMintableERC20Predicate", - gensc.ChildMintableERC20Predicate, - false, - []string{ - "initialize", - }, - []string{ - "MintableTokenMapped", - }, - }, - { - "RootERC20", - gensc.RootERC20, - false, - []string{ - "balanceOf", - "approve", - "mint", - }, - []string{}, - }, - { - "RootERC1155Predicate", - gensc.RootERC1155Predicate, - false, - []string{ - "initialize", - "depositBatch", - }, - []string{}, - }, - { - "ChildMintableERC1155Predicate", - gensc.ChildMintableERC1155Predicate, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "RootERC1155", - gensc.RootERC1155, - false, - []string{ - "setApprovalForAll", - "mintBatch", - "balanceOf", - }, - []string{}, - }, - { - "ChildERC1155Predicate", - gensc.ChildERC1155Predicate, - false, - []string{ - "initialize", - "withdrawBatch", - }, - []string{}, - }, - { - "ChildERC1155PredicateACL", - gensc.ChildERC1155PredicateACL, - false, - []string{ - "initialize", - "withdrawBatch", - }, - []string{}, - }, - { - "RootMintableERC1155Predicate", - gensc.RootMintableERC1155Predicate, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "RootMintableERC1155PredicateACL", - gensc.RootMintableERC1155PredicateACL, - false, - []string{ - "initialize", - }, - []string{ - "L2MintableTokenMapped", - }, - }, - { - "ChildERC1155", - gensc.ChildERC1155, - false, - []string{ - "initialize", - "balanceOf", - }, - []string{}, - }, - { - "RootERC721Predicate", - gensc.RootERC721Predicate, - false, - []string{ - "initialize", - "depositBatch", - }, - []string{}, - }, - { - "ChildMintableERC721Predicate", - gensc.ChildMintableERC721Predicate, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "RootERC721", - gensc.RootERC721, - false, - []string{ - "setApprovalForAll", - "mint", - }, - []string{}, - }, - { - "ChildERC721Predicate", - gensc.ChildERC721Predicate, - false, - []string{ - "initialize", - "withdrawBatch", - }, - []string{}, - }, - { - "ChildERC721PredicateACL", - gensc.ChildERC721PredicateACL, - false, - []string{ - "initialize", - "withdrawBatch", - }, - []string{}, - }, - { - "RootMintableERC721Predicate", - gensc.RootMintableERC721Predicate, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "RootMintableERC721PredicateACL", - gensc.RootMintableERC721PredicateACL, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "ChildERC721", - gensc.ChildERC721, - false, - []string{ - "initialize", - "ownerOf", - }, - []string{}, - }, - { - "CustomSupernetManager", - gensc.CustomSupernetManager, - false, - []string{ - "initialize", - "whitelistValidators", - "register", - "getValidator", - "addGenesisBalance", - }, - []string{ - "ValidatorRegistered", - "AddedToWhitelist", - }, - }, - { - "StakeManager", - gensc.StakeManager, - false, - []string{ - "initialize", - "registerChildChain", - "stakeFor", - "releaseStakeOf", - "withdrawStake", - "stakeOf", - }, - []string{ - "ChildManagerRegistered", - "StakeAdded", - "StakeWithdrawn", - }, - }, - { - "ValidatorSet", - gensc.ValidatorSet, - false, - []string{ - "commitEpoch", - "unstake", - "initialize", - }, - []string{ - "Transfer", - "WithdrawalRegistered", - "Withdrawal", - }, - }, - { - "RewardPool", - gensc.RewardPool, - false, - []string{ - "initialize", - "distributeRewardFor", - }, - []string{}, - }, - { - "EIP1559Burn", - gensc.EIP1559Burn, - false, - []string{ - "initialize", - }, - []string{}, - }, - { - "GenesisProxy", - gensc.GenesisProxy, - false, - []string{ - "protectSetUpProxy", - "setUpProxy", - }, - []string{}, - }, - { - "TransparentUpgradeableProxy", - gensc.TransparentUpgradeableProxy, - true, - []string{}, - []string{}, - }, - } - - generatedData := &generatedData{} - - for _, c := range cases { - if c.generateConstructor { - if err := generateConstructor(generatedData, c.contractName, c.artifact.Abi.Constructor); err != nil { - log.Fatal(err) - } - } - - for _, methodRaw := range c.functions { - // There could be two objects with the same name in the generated JSON ABI (hardhat bug). - // This case can be fixed by specifying a function signature instead of just name - // e.g. "myFunc(address,bool,uint256)" instead of just "myFunc" - var ( - method *abi.Method - resolvedBySignature = false - ) - - if signatureFunctionFormat.MatchString(methodRaw) { - method = c.artifact.Abi.GetMethodBySignature(methodRaw) - resolvedBySignature = true - } else { - method = c.artifact.Abi.GetMethod(methodRaw) - } - - if err := generateFunction(generatedData, c.contractName, method, resolvedBySignature); err != nil { - log.Fatal(err) - } - } - - for _, event := range c.events { - if err := generateEvent(generatedData, c.contractName, c.artifact.Abi.Events[event]); err != nil { - log.Fatal(err) - } - } - } - - str := `// Code generated by scapi/gen. DO NOT EDIT. -package contractsapi - -import ( - "math/big" - - "github.com/xgr-network/xgr-node/types" - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/ethgo" -) - -` - str += strings.Join(generatedData.resultString, "\n") - - output, err := format.Source([]byte(str)) - if err != nil { - fmt.Println(str) - log.Fatal(err) - } - - if err = common.SaveFileSafe("./consensus/polybft/contractsapi/contractsapi.go", output, 0600); err != nil { - log.Fatal(err) - } -} - -func getInternalType(paramName string, paramAbiType *abi.Type) string { - internalType := paramAbiType.InternalType() - if internalType == "" { - internalType = strings.Title(paramName) - } else { - internalType = strings.TrimSuffix(internalType, "[]") // remove [] if it's struct array - internalType = strings.TrimPrefix(internalType, "struct ") // remove struct prefix - // if struct is taken from an interface (ICheckpoint.Validator), remove interface - parts := strings.Split(internalType, ".") - if len(parts) > 1 { - internalType = parts[1] - } - } - - return internalType -} - -// generateType generates code for structs used in smart contract functions and events -func generateType(generatedData *generatedData, name string, obj *abi.Type, res *[]string) (string, error) { - if obj.Kind() != abi.KindTuple { - return "", errors.New("type not expected") - } - - internalType := getInternalType(name, obj) - generatedData.structs = append(generatedData.structs, internalType) - - str := []string{ - "type " + internalType + " struct {", - } - - for _, tupleElem := range obj.TupleElems() { - elem := tupleElem.Elem - - var typ string - - if elem.Kind() == abi.KindTuple { - // Struct - nestedType, err := generateNestedType(generatedData, tupleElem.Name, elem, res) - if err != nil { - return "", err - } - - typ = nestedType - } else if elem.Kind() == abi.KindSlice && elem.Elem().Kind() == abi.KindTuple { - // []Struct - nestedType, err := generateNestedType(generatedData, getInternalType(tupleElem.Name, elem), elem.Elem(), res) - if err != nil { - return "", err - } - - typ = "[]" + nestedType - } else if elem.Kind() == abi.KindArray && elem.Elem().Kind() == abi.KindTuple { - // [n]Struct - nestedType, err := generateNestedType(generatedData, getInternalType(tupleElem.Name, elem), elem.Elem(), res) - if err != nil { - return "", err - } - - typ = "[" + strconv.Itoa(elem.Size()) + "]" + nestedType - } else if elem.Kind() == abi.KindAddress { - // for address use the native `types.Address` type instead of `ethgo.Address`. Note that - // this only works for simple types and not for []address inputs. This is good enough since - // there are no kinds like that in our smart contracts. - typ = "types.Address" - } else { - // for the rest of the types use the go type returned by abi - typ = elem.GoType().String() - } - - // []byte and [n]byte get rendered as []uint68 and [n]uint8, since we do not have any - // uint8 internally in polybft, we can use regexp to replace those values with the - // correct byte representation - typ = strings.Replace(typ, "[32]uint8", "types.Hash", -1) - typ = strings.Replace(typ, "]uint8", "]byte", -1) - - // Trim the leading _ from name if it exists - fieldName := strings.TrimPrefix(tupleElem.Name, "_") - - // Replacement of Id for ID to make the linter happy - fieldName = strings.Title(fieldName) - fieldName = strings.Replace(fieldName, "Id", "ID", -1) - - str = append(str, fmt.Sprintf("%s %s `abi:\"%s\"`", fieldName, typ, tupleElem.Name)) - } - - str = append(str, "}") - *res = append(*res, strings.Join(str, "\n")) - - return internalType, nil -} - -// generateNestedType generates code for nested types found in smart contracts structs -func generateNestedType(generatedData *generatedData, name string, obj *abi.Type, res *[]string) (string, error) { - for _, s := range generatedData.structs { - if s == name { - // do not generate the same type again if it's already generated - // this happens when two functions use the same struct type as one of its parameters - return "*" + name, nil - } - } - - result, err := generateType(generatedData, name, obj, res) - if err != nil { - return "", err - } - - *res = append(*res, fmt.Sprintf(abiTypeNameFormat, result, obj.Format(true))) - - nestedTypeFunctions, err := generateAbiFuncsForNestedType(result) - if err != nil { - return "", err - } - - *res = append(*res, nestedTypeFunctions) - - return "*" + result, nil -} - -// generateAbiFuncsForNestedType generates necessary functions for nested types smart contracts interaction -func generateAbiFuncsForNestedType(name string) (string, error) { - tmpl := `func ({{.Sig}} *{{.TName}}) EncodeAbi() ([]byte, error) { - return {{.Name}}ABIType.Encode({{.Sig}}) - } - - func ({{.Sig}} *{{.TName}}) DecodeAbi(buf []byte) error { - return decodeStruct({{.Name}}ABIType, buf, &{{.Sig}}) - }` - - title := strings.Title(name) - - inputs := map[string]interface{}{ - "Sig": strings.ToLower(string(name[0])), - "Name": title, - "TName": title, - } - - return renderTmpl(tmpl, inputs) -} - -// generateEvent generates code for smart contract events -func generateEvent(generatedData *generatedData, contractName string, event *abi.Event) error { - name := fmt.Sprintf(eventNameFormat, event.Name) - res := []string{} - - _, err := generateType(generatedData, name, event.Inputs, &res) - if err != nil { - return err - } - - // write encode/decode functions - tmplStr := ` -{{range .Structs}} - {{.}} -{{ end }} - -func (*{{.TName}}) Sig() ethgo.Hash { - return {{.ContractName}}.Abi.Events["{{.Name}}"].ID() -} - -func ({{.Sig}} *{{.TName}}) Encode() ([]byte, error) { - return {{.ContractName}}.Abi.Events["{{.Name}}"].Inputs.Encode({{.Sig}}) -} - -func ({{.Sig}} *{{.TName}}) ParseLog(log *ethgo.Log) (bool, error) { - if (!{{.ContractName}}.Abi.Events["{{.Name}}"].Match(log)) { - return false, nil - } - - return true, decodeEvent({{.ContractName}}.Abi.Events["{{.Name}}"], log, {{.Sig}}) -} - -func ({{.Sig}} *{{.TName}}) Decode(input []byte) error { - return {{.ContractName}}.Abi.Events["{{.Name}}"].Inputs.DecodeStruct(input, &{{.Sig}}) -} -` - - inputs := map[string]interface{}{ - "Structs": res, - "Sig": strings.ToLower(string(name[0])), - "Name": event.Name, - "TName": strings.Title(name), - "ContractName": contractName, - } - - renderedString, err := renderTmpl(tmplStr, inputs) - if err != nil { - return err - } - - generatedData.resultString = append(generatedData.resultString, renderedString) - - return nil -} - -// generateConstruct generates stubs for a smart contract constructor -func generateConstructor(generatedData *generatedData, - contractName string, constructor *abi.Method) error { - methodName := fmt.Sprintf(functionNameFormat, strings.Title(contractName+"Constructor")) - res := []string{} - - _, err := generateType(generatedData, methodName, constructor.Inputs, &res) - if err != nil { - return err - } - - // write encode/decode functions - tmplStr := ` -{{range .Structs}} - {{.}} -{{ end }} - -func ({{.Sig}} *{{.TName}}) Sig() []byte { - return {{.ContractName}}.Abi.Constructor.ID() -} - -func ({{.Sig}} *{{.TName}}) EncodeAbi() ([]byte, error) { - return {{.ContractName}}.Abi.Constructor.Inputs.Encode({{.Sig}}) -} - -func ({{.Sig}} *{{.TName}}) DecodeAbi(buf []byte) error { - return decodeMethod({{.ContractName}}.Abi.Constructor, buf, {{.Sig}}) -}` - - inputs := map[string]interface{}{ - "Structs": res, - "Sig": strings.ToLower(string(methodName[0])), - "ContractName": contractName, - "TName": strings.Title(methodName), - } - - renderedString, err := renderTmpl(tmplStr, inputs) - if err != nil { - return err - } - - generatedData.resultString = append(generatedData.resultString, renderedString) - - return nil -} - -// generateFunction generates code for smart contract function and its parameters -func generateFunction(generatedData *generatedData, contractName string, - method *abi.Method, fnSigResolution bool) error { - methodName := fmt.Sprintf(functionNameFormat, strings.Title(method.Name+contractName)) - res := []string{} - - _, err := generateType(generatedData, methodName, method.Inputs, &res) - if err != nil { - return err - } - - // write encode/decode functions - - tmplString := ` - {{range .Structs}} - {{.}} - {{ end }} - - func ({{.Sig}} *{{.TName}}) Sig() []byte { - return {{.ContractName}}.Abi.{{.MethodGetter}}["{{.Name}}"].ID() - } - - func ({{.Sig}} *{{.TName}}) EncodeAbi() ([]byte, error) { - return {{.ContractName}}.Abi.{{.MethodGetter}}["{{.Name}}"].Encode({{.Sig}}) - } - - func ({{.Sig}} *{{.TName}}) DecodeAbi(buf []byte) error { - return decodeMethod({{.ContractName}}.Abi.{{.MethodGetter}}["{{.Name}}"], buf, {{.Sig}}) - }` - - methodGetter := "Methods" - if fnSigResolution { - methodGetter = "MethodsBySignature" - } - - inputs := map[string]interface{}{ - "Structs": res, - "Sig": strings.ToLower(string(methodName[0])), - "Name": method.Name, - "ContractName": contractName, - "TName": strings.Title(methodName), - "MethodGetter": methodGetter, - } - - if fnSigResolution { - inputs["Name"] = method.Sig() - } - - renderedString, err := renderTmpl(tmplString, inputs) - if err != nil { - return err - } - - generatedData.resultString = append(generatedData.resultString, renderedString) - - return nil -} - -func renderTmpl(tmplStr string, inputs map[string]interface{}) (string, error) { - tmpl, err := template.New("name").Parse(tmplStr) - if err != nil { - return "", fmt.Errorf("failed to load template: %w", err) - } - - var tpl bytes.Buffer - if err = tmpl.Execute(&tpl, inputs); err != nil { - return "", fmt.Errorf("failed to render template: %w", err) - } - - return tpl.String(), nil -} diff --git a/consensus/polybft/contractsapi/contractsapi.go b/consensus/polybft/contractsapi/contractsapi.go deleted file mode 100644 index 4981a34..0000000 --- a/consensus/polybft/contractsapi/contractsapi.go +++ /dev/null @@ -1,1816 +0,0 @@ -// Code generated by scapi/gen. DO NOT EDIT. -package contractsapi - -import ( - "math/big" - - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/xgr-network/xgr-node/types" -) - -type StateSyncCommitment struct { - StartID *big.Int `abi:"startId"` - EndID *big.Int `abi:"endId"` - Root types.Hash `abi:"root"` -} - -var StateSyncCommitmentABIType = abi.MustNewType("tuple(uint256 startId,uint256 endId,bytes32 root)") - -func (s *StateSyncCommitment) EncodeAbi() ([]byte, error) { - return StateSyncCommitmentABIType.Encode(s) -} - -func (s *StateSyncCommitment) DecodeAbi(buf []byte) error { - return decodeStruct(StateSyncCommitmentABIType, buf, &s) -} - -type CommitStateReceiverFn struct { - Commitment *StateSyncCommitment `abi:"commitment"` - Signature []byte `abi:"signature"` - Bitmap []byte `abi:"bitmap"` -} - -func (c *CommitStateReceiverFn) Sig() []byte { - return StateReceiver.Abi.Methods["commit"].ID() -} - -func (c *CommitStateReceiverFn) EncodeAbi() ([]byte, error) { - return StateReceiver.Abi.Methods["commit"].Encode(c) -} - -func (c *CommitStateReceiverFn) DecodeAbi(buf []byte) error { - return decodeMethod(StateReceiver.Abi.Methods["commit"], buf, c) -} - -type StateSync struct { - ID *big.Int `abi:"id"` - Sender types.Address `abi:"sender"` - Receiver types.Address `abi:"receiver"` - Data []byte `abi:"data"` -} - -var StateSyncABIType = abi.MustNewType("tuple(uint256 id,address sender,address receiver,bytes data)") - -func (s *StateSync) EncodeAbi() ([]byte, error) { - return StateSyncABIType.Encode(s) -} - -func (s *StateSync) DecodeAbi(buf []byte) error { - return decodeStruct(StateSyncABIType, buf, &s) -} - -type ExecuteStateReceiverFn struct { - Proof []types.Hash `abi:"proof"` - Obj *StateSync `abi:"obj"` -} - -func (e *ExecuteStateReceiverFn) Sig() []byte { - return StateReceiver.Abi.Methods["execute"].ID() -} - -func (e *ExecuteStateReceiverFn) EncodeAbi() ([]byte, error) { - return StateReceiver.Abi.Methods["execute"].Encode(e) -} - -func (e *ExecuteStateReceiverFn) DecodeAbi(buf []byte) error { - return decodeMethod(StateReceiver.Abi.Methods["execute"], buf, e) -} - -type BatchExecuteStateReceiverFn struct { - Proofs [][]types.Hash `abi:"proofs"` - Objs []*StateSync `abi:"objs"` -} - -func (b *BatchExecuteStateReceiverFn) Sig() []byte { - return StateReceiver.Abi.Methods["batchExecute"].ID() -} - -func (b *BatchExecuteStateReceiverFn) EncodeAbi() ([]byte, error) { - return StateReceiver.Abi.Methods["batchExecute"].Encode(b) -} - -func (b *BatchExecuteStateReceiverFn) DecodeAbi(buf []byte) error { - return decodeMethod(StateReceiver.Abi.Methods["batchExecute"], buf, b) -} - -type StateSyncResultEvent struct { - Counter *big.Int `abi:"counter"` - Status bool `abi:"status"` - Message []byte `abi:"message"` -} - -func (*StateSyncResultEvent) Sig() ethgo.Hash { - return StateReceiver.Abi.Events["StateSyncResult"].ID() -} - -func (s *StateSyncResultEvent) Encode() ([]byte, error) { - return StateReceiver.Abi.Events["StateSyncResult"].Inputs.Encode(s) -} - -func (s *StateSyncResultEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !StateReceiver.Abi.Events["StateSyncResult"].Match(log) { - return false, nil - } - - return true, decodeEvent(StateReceiver.Abi.Events["StateSyncResult"], log, s) -} - -func (s *StateSyncResultEvent) Decode(input []byte) error { - return StateReceiver.Abi.Events["StateSyncResult"].Inputs.DecodeStruct(input, &s) -} - -type NewCommitmentEvent struct { - StartID *big.Int `abi:"startId"` - EndID *big.Int `abi:"endId"` - Root types.Hash `abi:"root"` -} - -func (*NewCommitmentEvent) Sig() ethgo.Hash { - return StateReceiver.Abi.Events["NewCommitment"].ID() -} - -func (n *NewCommitmentEvent) Encode() ([]byte, error) { - return StateReceiver.Abi.Events["NewCommitment"].Inputs.Encode(n) -} - -func (n *NewCommitmentEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !StateReceiver.Abi.Events["NewCommitment"].Match(log) { - return false, nil - } - - return true, decodeEvent(StateReceiver.Abi.Events["NewCommitment"], log, n) -} - -func (n *NewCommitmentEvent) Decode(input []byte) error { - return StateReceiver.Abi.Events["NewCommitment"].Inputs.DecodeStruct(input, &n) -} - -type SyncStateStateSenderFn struct { - Receiver types.Address `abi:"receiver"` - Data []byte `abi:"data"` -} - -func (s *SyncStateStateSenderFn) Sig() []byte { - return StateSender.Abi.Methods["syncState"].ID() -} - -func (s *SyncStateStateSenderFn) EncodeAbi() ([]byte, error) { - return StateSender.Abi.Methods["syncState"].Encode(s) -} - -func (s *SyncStateStateSenderFn) DecodeAbi(buf []byte) error { - return decodeMethod(StateSender.Abi.Methods["syncState"], buf, s) -} - -type StateSyncedEvent struct { - ID *big.Int `abi:"id"` - Sender types.Address `abi:"sender"` - Receiver types.Address `abi:"receiver"` - Data []byte `abi:"data"` -} - -func (*StateSyncedEvent) Sig() ethgo.Hash { - return StateSender.Abi.Events["StateSynced"].ID() -} - -func (s *StateSyncedEvent) Encode() ([]byte, error) { - return StateSender.Abi.Events["StateSynced"].Inputs.Encode(s) -} - -func (s *StateSyncedEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !StateSender.Abi.Events["StateSynced"].Match(log) { - return false, nil - } - - return true, decodeEvent(StateSender.Abi.Events["StateSynced"], log, s) -} - -func (s *StateSyncedEvent) Decode(input []byte) error { - return StateSender.Abi.Events["StateSynced"].Inputs.DecodeStruct(input, &s) -} - -type L2StateSyncedEvent struct { - ID *big.Int `abi:"id"` - Sender types.Address `abi:"sender"` - Receiver types.Address `abi:"receiver"` - Data []byte `abi:"data"` -} - -func (*L2StateSyncedEvent) Sig() ethgo.Hash { - return L2StateSender.Abi.Events["L2StateSynced"].ID() -} - -func (l *L2StateSyncedEvent) Encode() ([]byte, error) { - return L2StateSender.Abi.Events["L2StateSynced"].Inputs.Encode(l) -} - -func (l *L2StateSyncedEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !L2StateSender.Abi.Events["L2StateSynced"].Match(log) { - return false, nil - } - - return true, decodeEvent(L2StateSender.Abi.Events["L2StateSynced"], log, l) -} - -func (l *L2StateSyncedEvent) Decode(input []byte) error { - return L2StateSender.Abi.Events["L2StateSynced"].Inputs.DecodeStruct(input, &l) -} - -type CheckpointManagerConstructorFn struct { - Initiator types.Address `abi:"initiator"` -} - -func (c *CheckpointManagerConstructorFn) Sig() []byte { - return CheckpointManager.Abi.Constructor.ID() -} - -func (c *CheckpointManagerConstructorFn) EncodeAbi() ([]byte, error) { - return CheckpointManager.Abi.Constructor.Inputs.Encode(c) -} - -func (c *CheckpointManagerConstructorFn) DecodeAbi(buf []byte) error { - return decodeMethod(CheckpointManager.Abi.Constructor, buf, c) -} - -type CheckpointMetadata struct { - BlockHash types.Hash `abi:"blockHash"` - BlockRound *big.Int `abi:"blockRound"` - CurrentValidatorSetHash types.Hash `abi:"currentValidatorSetHash"` -} - -var CheckpointMetadataABIType = abi.MustNewType("tuple(bytes32 blockHash,uint256 blockRound,bytes32 currentValidatorSetHash)") - -func (c *CheckpointMetadata) EncodeAbi() ([]byte, error) { - return CheckpointMetadataABIType.Encode(c) -} - -func (c *CheckpointMetadata) DecodeAbi(buf []byte) error { - return decodeStruct(CheckpointMetadataABIType, buf, &c) -} - -type Checkpoint struct { - Epoch *big.Int `abi:"epoch"` - BlockNumber *big.Int `abi:"blockNumber"` - EventRoot types.Hash `abi:"eventRoot"` -} - -var CheckpointABIType = abi.MustNewType("tuple(uint256 epoch,uint256 blockNumber,bytes32 eventRoot)") - -func (c *Checkpoint) EncodeAbi() ([]byte, error) { - return CheckpointABIType.Encode(c) -} - -func (c *Checkpoint) DecodeAbi(buf []byte) error { - return decodeStruct(CheckpointABIType, buf, &c) -} - -type Validator struct { - Address types.Address `abi:"_address"` - BlsKey [4]*big.Int `abi:"blsKey"` - VotingPower *big.Int `abi:"votingPower"` -} - -var ValidatorABIType = abi.MustNewType("tuple(address _address,uint256[4] blsKey,uint256 votingPower)") - -func (v *Validator) EncodeAbi() ([]byte, error) { - return ValidatorABIType.Encode(v) -} - -func (v *Validator) DecodeAbi(buf []byte) error { - return decodeStruct(ValidatorABIType, buf, &v) -} - -type SubmitCheckpointManagerFn struct { - CheckpointMetadata *CheckpointMetadata `abi:"checkpointMetadata"` - Checkpoint *Checkpoint `abi:"checkpoint"` - Signature [2]*big.Int `abi:"signature"` - NewValidatorSet []*Validator `abi:"newValidatorSet"` - Bitmap []byte `abi:"bitmap"` -} - -func (s *SubmitCheckpointManagerFn) Sig() []byte { - return CheckpointManager.Abi.Methods["submit"].ID() -} - -func (s *SubmitCheckpointManagerFn) EncodeAbi() ([]byte, error) { - return CheckpointManager.Abi.Methods["submit"].Encode(s) -} - -func (s *SubmitCheckpointManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(CheckpointManager.Abi.Methods["submit"], buf, s) -} - -type InitializeCheckpointManagerFn struct { - NewBls types.Address `abi:"newBls"` - NewBn256G2 types.Address `abi:"newBn256G2"` - ChainID_ *big.Int `abi:"chainId_"` - NewValidatorSet []*Validator `abi:"newValidatorSet"` -} - -func (i *InitializeCheckpointManagerFn) Sig() []byte { - return CheckpointManager.Abi.Methods["initialize"].ID() -} - -func (i *InitializeCheckpointManagerFn) EncodeAbi() ([]byte, error) { - return CheckpointManager.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeCheckpointManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(CheckpointManager.Abi.Methods["initialize"], buf, i) -} - -type GetCheckpointBlockCheckpointManagerFn struct { - BlockNumber *big.Int `abi:"blockNumber"` -} - -func (g *GetCheckpointBlockCheckpointManagerFn) Sig() []byte { - return CheckpointManager.Abi.Methods["getCheckpointBlock"].ID() -} - -func (g *GetCheckpointBlockCheckpointManagerFn) EncodeAbi() ([]byte, error) { - return CheckpointManager.Abi.Methods["getCheckpointBlock"].Encode(g) -} - -func (g *GetCheckpointBlockCheckpointManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(CheckpointManager.Abi.Methods["getCheckpointBlock"], buf, g) -} - -type InitializeExitHelperFn struct { - NewCheckpointManager types.Address `abi:"newCheckpointManager"` -} - -func (i *InitializeExitHelperFn) Sig() []byte { - return ExitHelper.Abi.Methods["initialize"].ID() -} - -func (i *InitializeExitHelperFn) EncodeAbi() ([]byte, error) { - return ExitHelper.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeExitHelperFn) DecodeAbi(buf []byte) error { - return decodeMethod(ExitHelper.Abi.Methods["initialize"], buf, i) -} - -type ExitExitHelperFn struct { - BlockNumber *big.Int `abi:"blockNumber"` - LeafIndex *big.Int `abi:"leafIndex"` - UnhashedLeaf []byte `abi:"unhashedLeaf"` - Proof []types.Hash `abi:"proof"` -} - -func (e *ExitExitHelperFn) Sig() []byte { - return ExitHelper.Abi.Methods["exit"].ID() -} - -func (e *ExitExitHelperFn) EncodeAbi() ([]byte, error) { - return ExitHelper.Abi.Methods["exit"].Encode(e) -} - -func (e *ExitExitHelperFn) DecodeAbi(buf []byte) error { - return decodeMethod(ExitHelper.Abi.Methods["exit"], buf, e) -} - -type InitializeChildERC20PredicateFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewRootERC20Predicate types.Address `abi:"newRootERC20Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` - NewNativeTokenRootAddress types.Address `abi:"newNativeTokenRootAddress"` -} - -func (i *InitializeChildERC20PredicateFn) Sig() []byte { - return ChildERC20Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildERC20PredicateFn) EncodeAbi() ([]byte, error) { - return ChildERC20Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildERC20PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC20Predicate.Abi.Methods["initialize"], buf, i) -} - -type WithdrawToChildERC20PredicateFn struct { - ChildToken types.Address `abi:"childToken"` - Receiver types.Address `abi:"receiver"` - Amount *big.Int `abi:"amount"` -} - -func (w *WithdrawToChildERC20PredicateFn) Sig() []byte { - return ChildERC20Predicate.Abi.Methods["withdrawTo"].ID() -} - -func (w *WithdrawToChildERC20PredicateFn) EncodeAbi() ([]byte, error) { - return ChildERC20Predicate.Abi.Methods["withdrawTo"].Encode(w) -} - -func (w *WithdrawToChildERC20PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC20Predicate.Abi.Methods["withdrawTo"], buf, w) -} - -type InitializeChildERC20PredicateACLFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewRootERC20Predicate types.Address `abi:"newRootERC20Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` - NewNativeTokenRootAddress types.Address `abi:"newNativeTokenRootAddress"` - NewUseAllowList bool `abi:"newUseAllowList"` - NewUseBlockList bool `abi:"newUseBlockList"` - NewOwner types.Address `abi:"newOwner"` -} - -func (i *InitializeChildERC20PredicateACLFn) Sig() []byte { - return ChildERC20PredicateACL.Abi.MethodsBySignature["initialize(address,address,address,address,address,bool,bool,address)"].ID() -} - -func (i *InitializeChildERC20PredicateACLFn) EncodeAbi() ([]byte, error) { - return ChildERC20PredicateACL.Abi.MethodsBySignature["initialize(address,address,address,address,address,bool,bool,address)"].Encode(i) -} - -func (i *InitializeChildERC20PredicateACLFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC20PredicateACL.Abi.MethodsBySignature["initialize(address,address,address,address,address,bool,bool,address)"], buf, i) -} - -type WithdrawToChildERC20PredicateACLFn struct { - ChildToken types.Address `abi:"childToken"` - Receiver types.Address `abi:"receiver"` - Amount *big.Int `abi:"amount"` -} - -func (w *WithdrawToChildERC20PredicateACLFn) Sig() []byte { - return ChildERC20PredicateACL.Abi.Methods["withdrawTo"].ID() -} - -func (w *WithdrawToChildERC20PredicateACLFn) EncodeAbi() ([]byte, error) { - return ChildERC20PredicateACL.Abi.Methods["withdrawTo"].Encode(w) -} - -func (w *WithdrawToChildERC20PredicateACLFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC20PredicateACL.Abi.Methods["withdrawTo"], buf, w) -} - -type InitializeRootMintableERC20PredicateFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewChildERC20Predicate types.Address `abi:"newChildERC20Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeRootMintableERC20PredicateFn) Sig() []byte { - return RootMintableERC20Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRootMintableERC20PredicateFn) EncodeAbi() ([]byte, error) { - return RootMintableERC20Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRootMintableERC20PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootMintableERC20Predicate.Abi.Methods["initialize"], buf, i) -} - -type InitializeRootMintableERC20PredicateACLFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewChildERC20Predicate types.Address `abi:"newChildERC20Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` - NewUseAllowList bool `abi:"newUseAllowList"` - NewUseBlockList bool `abi:"newUseBlockList"` - NewOwner types.Address `abi:"newOwner"` -} - -func (i *InitializeRootMintableERC20PredicateACLFn) Sig() []byte { - return RootMintableERC20PredicateACL.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRootMintableERC20PredicateACLFn) EncodeAbi() ([]byte, error) { - return RootMintableERC20PredicateACL.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRootMintableERC20PredicateACLFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootMintableERC20PredicateACL.Abi.Methods["initialize"], buf, i) -} - -type InitializeNativeERC20Fn struct { - Predicate_ types.Address `abi:"predicate_"` - RootToken_ types.Address `abi:"rootToken_"` - Name_ string `abi:"name_"` - Symbol_ string `abi:"symbol_"` - Decimals_ uint8 `abi:"decimals_"` - TokenSupply_ *big.Int `abi:"tokenSupply_"` -} - -func (i *InitializeNativeERC20Fn) Sig() []byte { - return NativeERC20.Abi.Methods["initialize"].ID() -} - -func (i *InitializeNativeERC20Fn) EncodeAbi() ([]byte, error) { - return NativeERC20.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeNativeERC20Fn) DecodeAbi(buf []byte) error { - return decodeMethod(NativeERC20.Abi.Methods["initialize"], buf, i) -} - -type InitializeNativeERC20MintableFn struct { - Predicate_ types.Address `abi:"predicate_"` - Owner_ types.Address `abi:"owner_"` - RootToken_ types.Address `abi:"rootToken_"` - Name_ string `abi:"name_"` - Symbol_ string `abi:"symbol_"` - Decimals_ uint8 `abi:"decimals_"` - TokenSupply_ *big.Int `abi:"tokenSupply_"` -} - -func (i *InitializeNativeERC20MintableFn) Sig() []byte { - return NativeERC20Mintable.Abi.Methods["initialize"].ID() -} - -func (i *InitializeNativeERC20MintableFn) EncodeAbi() ([]byte, error) { - return NativeERC20Mintable.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeNativeERC20MintableFn) DecodeAbi(buf []byte) error { - return decodeMethod(NativeERC20Mintable.Abi.Methods["initialize"], buf, i) -} - -type InitializeRootERC20PredicateFn struct { - NewStateSender types.Address `abi:"newStateSender"` - NewExitHelper types.Address `abi:"newExitHelper"` - NewChildERC20Predicate types.Address `abi:"newChildERC20Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` - NewNativeTokenRoot types.Address `abi:"newNativeTokenRoot"` -} - -func (i *InitializeRootERC20PredicateFn) Sig() []byte { - return RootERC20Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRootERC20PredicateFn) EncodeAbi() ([]byte, error) { - return RootERC20Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRootERC20PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC20Predicate.Abi.Methods["initialize"], buf, i) -} - -type DepositToRootERC20PredicateFn struct { - RootToken types.Address `abi:"rootToken"` - Receiver types.Address `abi:"receiver"` - Amount *big.Int `abi:"amount"` -} - -func (d *DepositToRootERC20PredicateFn) Sig() []byte { - return RootERC20Predicate.Abi.Methods["depositTo"].ID() -} - -func (d *DepositToRootERC20PredicateFn) EncodeAbi() ([]byte, error) { - return RootERC20Predicate.Abi.Methods["depositTo"].Encode(d) -} - -func (d *DepositToRootERC20PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC20Predicate.Abi.Methods["depositTo"], buf, d) -} - -type TokenMappedEvent struct { - RootToken types.Address `abi:"rootToken"` - ChildToken types.Address `abi:"childToken"` -} - -func (*TokenMappedEvent) Sig() ethgo.Hash { - return RootERC20Predicate.Abi.Events["TokenMapped"].ID() -} - -func (t *TokenMappedEvent) Encode() ([]byte, error) { - return RootERC20Predicate.Abi.Events["TokenMapped"].Inputs.Encode(t) -} - -func (t *TokenMappedEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !RootERC20Predicate.Abi.Events["TokenMapped"].Match(log) { - return false, nil - } - - return true, decodeEvent(RootERC20Predicate.Abi.Events["TokenMapped"], log, t) -} - -func (t *TokenMappedEvent) Decode(input []byte) error { - return RootERC20Predicate.Abi.Events["TokenMapped"].Inputs.DecodeStruct(input, &t) -} - -type InitializeChildMintableERC20PredicateFn struct { - NewStateSender types.Address `abi:"newStateSender"` - NewExitHelper types.Address `abi:"newExitHelper"` - NewRootERC20Predicate types.Address `abi:"newRootERC20Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeChildMintableERC20PredicateFn) Sig() []byte { - return ChildMintableERC20Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildMintableERC20PredicateFn) EncodeAbi() ([]byte, error) { - return ChildMintableERC20Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildMintableERC20PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildMintableERC20Predicate.Abi.Methods["initialize"], buf, i) -} - -type MintableTokenMappedEvent struct { - RootToken types.Address `abi:"rootToken"` - ChildToken types.Address `abi:"childToken"` -} - -func (*MintableTokenMappedEvent) Sig() ethgo.Hash { - return ChildMintableERC20Predicate.Abi.Events["MintableTokenMapped"].ID() -} - -func (m *MintableTokenMappedEvent) Encode() ([]byte, error) { - return ChildMintableERC20Predicate.Abi.Events["MintableTokenMapped"].Inputs.Encode(m) -} - -func (m *MintableTokenMappedEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !ChildMintableERC20Predicate.Abi.Events["MintableTokenMapped"].Match(log) { - return false, nil - } - - return true, decodeEvent(ChildMintableERC20Predicate.Abi.Events["MintableTokenMapped"], log, m) -} - -func (m *MintableTokenMappedEvent) Decode(input []byte) error { - return ChildMintableERC20Predicate.Abi.Events["MintableTokenMapped"].Inputs.DecodeStruct(input, &m) -} - -type BalanceOfRootERC20Fn struct { - Account types.Address `abi:"account"` -} - -func (b *BalanceOfRootERC20Fn) Sig() []byte { - return RootERC20.Abi.Methods["balanceOf"].ID() -} - -func (b *BalanceOfRootERC20Fn) EncodeAbi() ([]byte, error) { - return RootERC20.Abi.Methods["balanceOf"].Encode(b) -} - -func (b *BalanceOfRootERC20Fn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC20.Abi.Methods["balanceOf"], buf, b) -} - -type ApproveRootERC20Fn struct { - Spender types.Address `abi:"spender"` - Amount *big.Int `abi:"amount"` -} - -func (a *ApproveRootERC20Fn) Sig() []byte { - return RootERC20.Abi.Methods["approve"].ID() -} - -func (a *ApproveRootERC20Fn) EncodeAbi() ([]byte, error) { - return RootERC20.Abi.Methods["approve"].Encode(a) -} - -func (a *ApproveRootERC20Fn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC20.Abi.Methods["approve"], buf, a) -} - -type MintRootERC20Fn struct { - To types.Address `abi:"to"` - Amount *big.Int `abi:"amount"` -} - -func (m *MintRootERC20Fn) Sig() []byte { - return RootERC20.Abi.Methods["mint"].ID() -} - -func (m *MintRootERC20Fn) EncodeAbi() ([]byte, error) { - return RootERC20.Abi.Methods["mint"].Encode(m) -} - -func (m *MintRootERC20Fn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC20.Abi.Methods["mint"], buf, m) -} - -type InitializeRootERC1155PredicateFn struct { - NewStateSender types.Address `abi:"newStateSender"` - NewExitHelper types.Address `abi:"newExitHelper"` - NewChildERC1155Predicate types.Address `abi:"newChildERC1155Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeRootERC1155PredicateFn) Sig() []byte { - return RootERC1155Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRootERC1155PredicateFn) EncodeAbi() ([]byte, error) { - return RootERC1155Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRootERC1155PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC1155Predicate.Abi.Methods["initialize"], buf, i) -} - -type DepositBatchRootERC1155PredicateFn struct { - RootToken types.Address `abi:"rootToken"` - Receivers []ethgo.Address `abi:"receivers"` - TokenIDs []*big.Int `abi:"tokenIds"` - Amounts []*big.Int `abi:"amounts"` -} - -func (d *DepositBatchRootERC1155PredicateFn) Sig() []byte { - return RootERC1155Predicate.Abi.Methods["depositBatch"].ID() -} - -func (d *DepositBatchRootERC1155PredicateFn) EncodeAbi() ([]byte, error) { - return RootERC1155Predicate.Abi.Methods["depositBatch"].Encode(d) -} - -func (d *DepositBatchRootERC1155PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC1155Predicate.Abi.Methods["depositBatch"], buf, d) -} - -type InitializeChildMintableERC1155PredicateFn struct { - NewStateSender types.Address `abi:"newStateSender"` - NewExitHelper types.Address `abi:"newExitHelper"` - NewRootERC1155Predicate types.Address `abi:"newRootERC1155Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeChildMintableERC1155PredicateFn) Sig() []byte { - return ChildMintableERC1155Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildMintableERC1155PredicateFn) EncodeAbi() ([]byte, error) { - return ChildMintableERC1155Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildMintableERC1155PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildMintableERC1155Predicate.Abi.Methods["initialize"], buf, i) -} - -type SetApprovalForAllRootERC1155Fn struct { - Operator types.Address `abi:"operator"` - Approved bool `abi:"approved"` -} - -func (s *SetApprovalForAllRootERC1155Fn) Sig() []byte { - return RootERC1155.Abi.Methods["setApprovalForAll"].ID() -} - -func (s *SetApprovalForAllRootERC1155Fn) EncodeAbi() ([]byte, error) { - return RootERC1155.Abi.Methods["setApprovalForAll"].Encode(s) -} - -func (s *SetApprovalForAllRootERC1155Fn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC1155.Abi.Methods["setApprovalForAll"], buf, s) -} - -type MintBatchRootERC1155Fn struct { - To types.Address `abi:"to"` - IDs []*big.Int `abi:"ids"` - Amounts []*big.Int `abi:"amounts"` - Data []byte `abi:"data"` -} - -func (m *MintBatchRootERC1155Fn) Sig() []byte { - return RootERC1155.Abi.Methods["mintBatch"].ID() -} - -func (m *MintBatchRootERC1155Fn) EncodeAbi() ([]byte, error) { - return RootERC1155.Abi.Methods["mintBatch"].Encode(m) -} - -func (m *MintBatchRootERC1155Fn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC1155.Abi.Methods["mintBatch"], buf, m) -} - -type BalanceOfRootERC1155Fn struct { - Account types.Address `abi:"account"` - ID *big.Int `abi:"id"` -} - -func (b *BalanceOfRootERC1155Fn) Sig() []byte { - return RootERC1155.Abi.Methods["balanceOf"].ID() -} - -func (b *BalanceOfRootERC1155Fn) EncodeAbi() ([]byte, error) { - return RootERC1155.Abi.Methods["balanceOf"].Encode(b) -} - -func (b *BalanceOfRootERC1155Fn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC1155.Abi.Methods["balanceOf"], buf, b) -} - -type InitializeChildERC1155PredicateFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewRootERC1155Predicate types.Address `abi:"newRootERC1155Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeChildERC1155PredicateFn) Sig() []byte { - return ChildERC1155Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildERC1155PredicateFn) EncodeAbi() ([]byte, error) { - return ChildERC1155Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildERC1155PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC1155Predicate.Abi.Methods["initialize"], buf, i) -} - -type WithdrawBatchChildERC1155PredicateFn struct { - ChildToken types.Address `abi:"childToken"` - Receivers []ethgo.Address `abi:"receivers"` - TokenIDs []*big.Int `abi:"tokenIds"` - Amounts []*big.Int `abi:"amounts"` -} - -func (w *WithdrawBatchChildERC1155PredicateFn) Sig() []byte { - return ChildERC1155Predicate.Abi.Methods["withdrawBatch"].ID() -} - -func (w *WithdrawBatchChildERC1155PredicateFn) EncodeAbi() ([]byte, error) { - return ChildERC1155Predicate.Abi.Methods["withdrawBatch"].Encode(w) -} - -func (w *WithdrawBatchChildERC1155PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC1155Predicate.Abi.Methods["withdrawBatch"], buf, w) -} - -type InitializeChildERC1155PredicateACLFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewRootERC1155Predicate types.Address `abi:"newRootERC1155Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` - NewUseAllowList bool `abi:"newUseAllowList"` - NewUseBlockList bool `abi:"newUseBlockList"` - NewOwner types.Address `abi:"newOwner"` -} - -func (i *InitializeChildERC1155PredicateACLFn) Sig() []byte { - return ChildERC1155PredicateACL.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildERC1155PredicateACLFn) EncodeAbi() ([]byte, error) { - return ChildERC1155PredicateACL.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildERC1155PredicateACLFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC1155PredicateACL.Abi.Methods["initialize"], buf, i) -} - -type WithdrawBatchChildERC1155PredicateACLFn struct { - ChildToken types.Address `abi:"childToken"` - Receivers []ethgo.Address `abi:"receivers"` - TokenIDs []*big.Int `abi:"tokenIds"` - Amounts []*big.Int `abi:"amounts"` -} - -func (w *WithdrawBatchChildERC1155PredicateACLFn) Sig() []byte { - return ChildERC1155PredicateACL.Abi.Methods["withdrawBatch"].ID() -} - -func (w *WithdrawBatchChildERC1155PredicateACLFn) EncodeAbi() ([]byte, error) { - return ChildERC1155PredicateACL.Abi.Methods["withdrawBatch"].Encode(w) -} - -func (w *WithdrawBatchChildERC1155PredicateACLFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC1155PredicateACL.Abi.Methods["withdrawBatch"], buf, w) -} - -type InitializeRootMintableERC1155PredicateFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewChildERC1155Predicate types.Address `abi:"newChildERC1155Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeRootMintableERC1155PredicateFn) Sig() []byte { - return RootMintableERC1155Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRootMintableERC1155PredicateFn) EncodeAbi() ([]byte, error) { - return RootMintableERC1155Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRootMintableERC1155PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootMintableERC1155Predicate.Abi.Methods["initialize"], buf, i) -} - -type InitializeRootMintableERC1155PredicateACLFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewChildERC1155Predicate types.Address `abi:"newChildERC1155Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` - NewUseAllowList bool `abi:"newUseAllowList"` - NewUseBlockList bool `abi:"newUseBlockList"` - NewOwner types.Address `abi:"newOwner"` -} - -func (i *InitializeRootMintableERC1155PredicateACLFn) Sig() []byte { - return RootMintableERC1155PredicateACL.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRootMintableERC1155PredicateACLFn) EncodeAbi() ([]byte, error) { - return RootMintableERC1155PredicateACL.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRootMintableERC1155PredicateACLFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootMintableERC1155PredicateACL.Abi.Methods["initialize"], buf, i) -} - -type L2MintableTokenMappedEvent struct { - RootToken types.Address `abi:"rootToken"` - ChildToken types.Address `abi:"childToken"` -} - -func (*L2MintableTokenMappedEvent) Sig() ethgo.Hash { - return RootMintableERC1155PredicateACL.Abi.Events["L2MintableTokenMapped"].ID() -} - -func (l *L2MintableTokenMappedEvent) Encode() ([]byte, error) { - return RootMintableERC1155PredicateACL.Abi.Events["L2MintableTokenMapped"].Inputs.Encode(l) -} - -func (l *L2MintableTokenMappedEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !RootMintableERC1155PredicateACL.Abi.Events["L2MintableTokenMapped"].Match(log) { - return false, nil - } - - return true, decodeEvent(RootMintableERC1155PredicateACL.Abi.Events["L2MintableTokenMapped"], log, l) -} - -func (l *L2MintableTokenMappedEvent) Decode(input []byte) error { - return RootMintableERC1155PredicateACL.Abi.Events["L2MintableTokenMapped"].Inputs.DecodeStruct(input, &l) -} - -type InitializeChildERC1155Fn struct { - RootToken_ types.Address `abi:"rootToken_"` - Uri_ string `abi:"uri_"` -} - -func (i *InitializeChildERC1155Fn) Sig() []byte { - return ChildERC1155.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildERC1155Fn) EncodeAbi() ([]byte, error) { - return ChildERC1155.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildERC1155Fn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC1155.Abi.Methods["initialize"], buf, i) -} - -type BalanceOfChildERC1155Fn struct { - Account types.Address `abi:"account"` - ID *big.Int `abi:"id"` -} - -func (b *BalanceOfChildERC1155Fn) Sig() []byte { - return ChildERC1155.Abi.Methods["balanceOf"].ID() -} - -func (b *BalanceOfChildERC1155Fn) EncodeAbi() ([]byte, error) { - return ChildERC1155.Abi.Methods["balanceOf"].Encode(b) -} - -func (b *BalanceOfChildERC1155Fn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC1155.Abi.Methods["balanceOf"], buf, b) -} - -type InitializeRootERC721PredicateFn struct { - NewStateSender types.Address `abi:"newStateSender"` - NewExitHelper types.Address `abi:"newExitHelper"` - NewChildERC721Predicate types.Address `abi:"newChildERC721Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeRootERC721PredicateFn) Sig() []byte { - return RootERC721Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRootERC721PredicateFn) EncodeAbi() ([]byte, error) { - return RootERC721Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRootERC721PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC721Predicate.Abi.Methods["initialize"], buf, i) -} - -type DepositBatchRootERC721PredicateFn struct { - RootToken types.Address `abi:"rootToken"` - Receivers []ethgo.Address `abi:"receivers"` - TokenIDs []*big.Int `abi:"tokenIds"` -} - -func (d *DepositBatchRootERC721PredicateFn) Sig() []byte { - return RootERC721Predicate.Abi.Methods["depositBatch"].ID() -} - -func (d *DepositBatchRootERC721PredicateFn) EncodeAbi() ([]byte, error) { - return RootERC721Predicate.Abi.Methods["depositBatch"].Encode(d) -} - -func (d *DepositBatchRootERC721PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC721Predicate.Abi.Methods["depositBatch"], buf, d) -} - -type InitializeChildMintableERC721PredicateFn struct { - NewStateSender types.Address `abi:"newStateSender"` - NewExitHelper types.Address `abi:"newExitHelper"` - NewRootERC721Predicate types.Address `abi:"newRootERC721Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeChildMintableERC721PredicateFn) Sig() []byte { - return ChildMintableERC721Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildMintableERC721PredicateFn) EncodeAbi() ([]byte, error) { - return ChildMintableERC721Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildMintableERC721PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildMintableERC721Predicate.Abi.Methods["initialize"], buf, i) -} - -type SetApprovalForAllRootERC721Fn struct { - Operator types.Address `abi:"operator"` - Approved bool `abi:"approved"` -} - -func (s *SetApprovalForAllRootERC721Fn) Sig() []byte { - return RootERC721.Abi.Methods["setApprovalForAll"].ID() -} - -func (s *SetApprovalForAllRootERC721Fn) EncodeAbi() ([]byte, error) { - return RootERC721.Abi.Methods["setApprovalForAll"].Encode(s) -} - -func (s *SetApprovalForAllRootERC721Fn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC721.Abi.Methods["setApprovalForAll"], buf, s) -} - -type MintRootERC721Fn struct { - To types.Address `abi:"to"` -} - -func (m *MintRootERC721Fn) Sig() []byte { - return RootERC721.Abi.Methods["mint"].ID() -} - -func (m *MintRootERC721Fn) EncodeAbi() ([]byte, error) { - return RootERC721.Abi.Methods["mint"].Encode(m) -} - -func (m *MintRootERC721Fn) DecodeAbi(buf []byte) error { - return decodeMethod(RootERC721.Abi.Methods["mint"], buf, m) -} - -type InitializeChildERC721PredicateFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewRootERC721Predicate types.Address `abi:"newRootERC721Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeChildERC721PredicateFn) Sig() []byte { - return ChildERC721Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildERC721PredicateFn) EncodeAbi() ([]byte, error) { - return ChildERC721Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildERC721PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC721Predicate.Abi.Methods["initialize"], buf, i) -} - -type WithdrawBatchChildERC721PredicateFn struct { - ChildToken types.Address `abi:"childToken"` - Receivers []ethgo.Address `abi:"receivers"` - TokenIDs []*big.Int `abi:"tokenIds"` -} - -func (w *WithdrawBatchChildERC721PredicateFn) Sig() []byte { - return ChildERC721Predicate.Abi.Methods["withdrawBatch"].ID() -} - -func (w *WithdrawBatchChildERC721PredicateFn) EncodeAbi() ([]byte, error) { - return ChildERC721Predicate.Abi.Methods["withdrawBatch"].Encode(w) -} - -func (w *WithdrawBatchChildERC721PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC721Predicate.Abi.Methods["withdrawBatch"], buf, w) -} - -type InitializeChildERC721PredicateACLFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewRootERC721Predicate types.Address `abi:"newRootERC721Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` - NewUseAllowList bool `abi:"newUseAllowList"` - NewUseBlockList bool `abi:"newUseBlockList"` - NewOwner types.Address `abi:"newOwner"` -} - -func (i *InitializeChildERC721PredicateACLFn) Sig() []byte { - return ChildERC721PredicateACL.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildERC721PredicateACLFn) EncodeAbi() ([]byte, error) { - return ChildERC721PredicateACL.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildERC721PredicateACLFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC721PredicateACL.Abi.Methods["initialize"], buf, i) -} - -type WithdrawBatchChildERC721PredicateACLFn struct { - ChildToken types.Address `abi:"childToken"` - Receivers []ethgo.Address `abi:"receivers"` - TokenIDs []*big.Int `abi:"tokenIds"` -} - -func (w *WithdrawBatchChildERC721PredicateACLFn) Sig() []byte { - return ChildERC721PredicateACL.Abi.Methods["withdrawBatch"].ID() -} - -func (w *WithdrawBatchChildERC721PredicateACLFn) EncodeAbi() ([]byte, error) { - return ChildERC721PredicateACL.Abi.Methods["withdrawBatch"].Encode(w) -} - -func (w *WithdrawBatchChildERC721PredicateACLFn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC721PredicateACL.Abi.Methods["withdrawBatch"], buf, w) -} - -type InitializeRootMintableERC721PredicateFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewChildERC721Predicate types.Address `abi:"newChildERC721Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` -} - -func (i *InitializeRootMintableERC721PredicateFn) Sig() []byte { - return RootMintableERC721Predicate.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRootMintableERC721PredicateFn) EncodeAbi() ([]byte, error) { - return RootMintableERC721Predicate.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRootMintableERC721PredicateFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootMintableERC721Predicate.Abi.Methods["initialize"], buf, i) -} - -type InitializeRootMintableERC721PredicateACLFn struct { - NewL2StateSender types.Address `abi:"newL2StateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewChildERC721Predicate types.Address `abi:"newChildERC721Predicate"` - NewChildTokenTemplate types.Address `abi:"newChildTokenTemplate"` - NewUseAllowList bool `abi:"newUseAllowList"` - NewUseBlockList bool `abi:"newUseBlockList"` - NewOwner types.Address `abi:"newOwner"` -} - -func (i *InitializeRootMintableERC721PredicateACLFn) Sig() []byte { - return RootMintableERC721PredicateACL.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRootMintableERC721PredicateACLFn) EncodeAbi() ([]byte, error) { - return RootMintableERC721PredicateACL.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRootMintableERC721PredicateACLFn) DecodeAbi(buf []byte) error { - return decodeMethod(RootMintableERC721PredicateACL.Abi.Methods["initialize"], buf, i) -} - -type InitializeChildERC721Fn struct { - RootToken_ types.Address `abi:"rootToken_"` - Name_ string `abi:"name_"` - Symbol_ string `abi:"symbol_"` -} - -func (i *InitializeChildERC721Fn) Sig() []byte { - return ChildERC721.Abi.Methods["initialize"].ID() -} - -func (i *InitializeChildERC721Fn) EncodeAbi() ([]byte, error) { - return ChildERC721.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeChildERC721Fn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC721.Abi.Methods["initialize"], buf, i) -} - -type OwnerOfChildERC721Fn struct { - TokenID *big.Int `abi:"tokenId"` -} - -func (o *OwnerOfChildERC721Fn) Sig() []byte { - return ChildERC721.Abi.Methods["ownerOf"].ID() -} - -func (o *OwnerOfChildERC721Fn) EncodeAbi() ([]byte, error) { - return ChildERC721.Abi.Methods["ownerOf"].Encode(o) -} - -func (o *OwnerOfChildERC721Fn) DecodeAbi(buf []byte) error { - return decodeMethod(ChildERC721.Abi.Methods["ownerOf"], buf, o) -} - -type InitializeCustomSupernetManagerFn struct { - NewStakeManager types.Address `abi:"newStakeManager"` - NewBls types.Address `abi:"newBls"` - NewStateSender types.Address `abi:"newStateSender"` - NewMatic types.Address `abi:"newMatic"` - NewChildValidatorSet types.Address `abi:"newChildValidatorSet"` - NewExitHelper types.Address `abi:"newExitHelper"` - NewRootERC20Predicate types.Address `abi:"newRootERC20Predicate"` - NewDomain string `abi:"newDomain"` -} - -func (i *InitializeCustomSupernetManagerFn) Sig() []byte { - return CustomSupernetManager.Abi.Methods["initialize"].ID() -} - -func (i *InitializeCustomSupernetManagerFn) EncodeAbi() ([]byte, error) { - return CustomSupernetManager.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeCustomSupernetManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(CustomSupernetManager.Abi.Methods["initialize"], buf, i) -} - -type WhitelistValidatorsCustomSupernetManagerFn struct { - Validators_ []ethgo.Address `abi:"validators_"` -} - -func (w *WhitelistValidatorsCustomSupernetManagerFn) Sig() []byte { - return CustomSupernetManager.Abi.Methods["whitelistValidators"].ID() -} - -func (w *WhitelistValidatorsCustomSupernetManagerFn) EncodeAbi() ([]byte, error) { - return CustomSupernetManager.Abi.Methods["whitelistValidators"].Encode(w) -} - -func (w *WhitelistValidatorsCustomSupernetManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(CustomSupernetManager.Abi.Methods["whitelistValidators"], buf, w) -} - -type RegisterCustomSupernetManagerFn struct { - Signature [2]*big.Int `abi:"signature"` - Pubkey [4]*big.Int `abi:"pubkey"` -} - -func (r *RegisterCustomSupernetManagerFn) Sig() []byte { - return CustomSupernetManager.Abi.Methods["register"].ID() -} - -func (r *RegisterCustomSupernetManagerFn) EncodeAbi() ([]byte, error) { - return CustomSupernetManager.Abi.Methods["register"].Encode(r) -} - -func (r *RegisterCustomSupernetManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(CustomSupernetManager.Abi.Methods["register"], buf, r) -} - -type GetValidatorCustomSupernetManagerFn struct { - Validator_ types.Address `abi:"validator_"` -} - -func (g *GetValidatorCustomSupernetManagerFn) Sig() []byte { - return CustomSupernetManager.Abi.Methods["getValidator"].ID() -} - -func (g *GetValidatorCustomSupernetManagerFn) EncodeAbi() ([]byte, error) { - return CustomSupernetManager.Abi.Methods["getValidator"].Encode(g) -} - -func (g *GetValidatorCustomSupernetManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(CustomSupernetManager.Abi.Methods["getValidator"], buf, g) -} - -type AddGenesisBalanceCustomSupernetManagerFn struct { - Amount *big.Int `abi:"amount"` -} - -func (a *AddGenesisBalanceCustomSupernetManagerFn) Sig() []byte { - return CustomSupernetManager.Abi.Methods["addGenesisBalance"].ID() -} - -func (a *AddGenesisBalanceCustomSupernetManagerFn) EncodeAbi() ([]byte, error) { - return CustomSupernetManager.Abi.Methods["addGenesisBalance"].Encode(a) -} - -func (a *AddGenesisBalanceCustomSupernetManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(CustomSupernetManager.Abi.Methods["addGenesisBalance"], buf, a) -} - -type ValidatorRegisteredEvent struct { - Validator types.Address `abi:"validator"` - BlsKey [4]*big.Int `abi:"blsKey"` -} - -func (*ValidatorRegisteredEvent) Sig() ethgo.Hash { - return CustomSupernetManager.Abi.Events["ValidatorRegistered"].ID() -} - -func (v *ValidatorRegisteredEvent) Encode() ([]byte, error) { - return CustomSupernetManager.Abi.Events["ValidatorRegistered"].Inputs.Encode(v) -} - -func (v *ValidatorRegisteredEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !CustomSupernetManager.Abi.Events["ValidatorRegistered"].Match(log) { - return false, nil - } - - return true, decodeEvent(CustomSupernetManager.Abi.Events["ValidatorRegistered"], log, v) -} - -func (v *ValidatorRegisteredEvent) Decode(input []byte) error { - return CustomSupernetManager.Abi.Events["ValidatorRegistered"].Inputs.DecodeStruct(input, &v) -} - -type AddedToWhitelistEvent struct { - Validator types.Address `abi:"validator"` -} - -func (*AddedToWhitelistEvent) Sig() ethgo.Hash { - return CustomSupernetManager.Abi.Events["AddedToWhitelist"].ID() -} - -func (a *AddedToWhitelistEvent) Encode() ([]byte, error) { - return CustomSupernetManager.Abi.Events["AddedToWhitelist"].Inputs.Encode(a) -} - -func (a *AddedToWhitelistEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !CustomSupernetManager.Abi.Events["AddedToWhitelist"].Match(log) { - return false, nil - } - - return true, decodeEvent(CustomSupernetManager.Abi.Events["AddedToWhitelist"], log, a) -} - -func (a *AddedToWhitelistEvent) Decode(input []byte) error { - return CustomSupernetManager.Abi.Events["AddedToWhitelist"].Inputs.DecodeStruct(input, &a) -} - -type InitializeStakeManagerFn struct { - NewStakingToken types.Address `abi:"newStakingToken"` -} - -func (i *InitializeStakeManagerFn) Sig() []byte { - return StakeManager.Abi.Methods["initialize"].ID() -} - -func (i *InitializeStakeManagerFn) EncodeAbi() ([]byte, error) { - return StakeManager.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeStakeManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(StakeManager.Abi.Methods["initialize"], buf, i) -} - -type RegisterChildChainStakeManagerFn struct { - Manager types.Address `abi:"manager"` -} - -func (r *RegisterChildChainStakeManagerFn) Sig() []byte { - return StakeManager.Abi.Methods["registerChildChain"].ID() -} - -func (r *RegisterChildChainStakeManagerFn) EncodeAbi() ([]byte, error) { - return StakeManager.Abi.Methods["registerChildChain"].Encode(r) -} - -func (r *RegisterChildChainStakeManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(StakeManager.Abi.Methods["registerChildChain"], buf, r) -} - -type StakeForStakeManagerFn struct { - ID *big.Int `abi:"id"` - Amount *big.Int `abi:"amount"` -} - -func (s *StakeForStakeManagerFn) Sig() []byte { - return StakeManager.Abi.Methods["stakeFor"].ID() -} - -func (s *StakeForStakeManagerFn) EncodeAbi() ([]byte, error) { - return StakeManager.Abi.Methods["stakeFor"].Encode(s) -} - -func (s *StakeForStakeManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(StakeManager.Abi.Methods["stakeFor"], buf, s) -} - -type ReleaseStakeOfStakeManagerFn struct { - Validator types.Address `abi:"validator"` - Amount *big.Int `abi:"amount"` -} - -func (r *ReleaseStakeOfStakeManagerFn) Sig() []byte { - return StakeManager.Abi.Methods["releaseStakeOf"].ID() -} - -func (r *ReleaseStakeOfStakeManagerFn) EncodeAbi() ([]byte, error) { - return StakeManager.Abi.Methods["releaseStakeOf"].Encode(r) -} - -func (r *ReleaseStakeOfStakeManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(StakeManager.Abi.Methods["releaseStakeOf"], buf, r) -} - -type WithdrawStakeStakeManagerFn struct { - To types.Address `abi:"to"` - Amount *big.Int `abi:"amount"` -} - -func (w *WithdrawStakeStakeManagerFn) Sig() []byte { - return StakeManager.Abi.Methods["withdrawStake"].ID() -} - -func (w *WithdrawStakeStakeManagerFn) EncodeAbi() ([]byte, error) { - return StakeManager.Abi.Methods["withdrawStake"].Encode(w) -} - -func (w *WithdrawStakeStakeManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(StakeManager.Abi.Methods["withdrawStake"], buf, w) -} - -type StakeOfStakeManagerFn struct { - Validator types.Address `abi:"validator"` - ID *big.Int `abi:"id"` -} - -func (s *StakeOfStakeManagerFn) Sig() []byte { - return StakeManager.Abi.Methods["stakeOf"].ID() -} - -func (s *StakeOfStakeManagerFn) EncodeAbi() ([]byte, error) { - return StakeManager.Abi.Methods["stakeOf"].Encode(s) -} - -func (s *StakeOfStakeManagerFn) DecodeAbi(buf []byte) error { - return decodeMethod(StakeManager.Abi.Methods["stakeOf"], buf, s) -} - -type ChildManagerRegisteredEvent struct { - ID *big.Int `abi:"id"` - Manager types.Address `abi:"manager"` -} - -func (*ChildManagerRegisteredEvent) Sig() ethgo.Hash { - return StakeManager.Abi.Events["ChildManagerRegistered"].ID() -} - -func (c *ChildManagerRegisteredEvent) Encode() ([]byte, error) { - return StakeManager.Abi.Events["ChildManagerRegistered"].Inputs.Encode(c) -} - -func (c *ChildManagerRegisteredEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !StakeManager.Abi.Events["ChildManagerRegistered"].Match(log) { - return false, nil - } - - return true, decodeEvent(StakeManager.Abi.Events["ChildManagerRegistered"], log, c) -} - -func (c *ChildManagerRegisteredEvent) Decode(input []byte) error { - return StakeManager.Abi.Events["ChildManagerRegistered"].Inputs.DecodeStruct(input, &c) -} - -type StakeAddedEvent struct { - ID *big.Int `abi:"id"` - Validator types.Address `abi:"validator"` - Amount *big.Int `abi:"amount"` -} - -func (*StakeAddedEvent) Sig() ethgo.Hash { - return StakeManager.Abi.Events["StakeAdded"].ID() -} - -func (s *StakeAddedEvent) Encode() ([]byte, error) { - return StakeManager.Abi.Events["StakeAdded"].Inputs.Encode(s) -} - -func (s *StakeAddedEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !StakeManager.Abi.Events["StakeAdded"].Match(log) { - return false, nil - } - - return true, decodeEvent(StakeManager.Abi.Events["StakeAdded"], log, s) -} - -func (s *StakeAddedEvent) Decode(input []byte) error { - return StakeManager.Abi.Events["StakeAdded"].Inputs.DecodeStruct(input, &s) -} - -type StakeWithdrawnEvent struct { - Validator types.Address `abi:"validator"` - Recipient types.Address `abi:"recipient"` - Amount *big.Int `abi:"amount"` -} - -func (*StakeWithdrawnEvent) Sig() ethgo.Hash { - return StakeManager.Abi.Events["StakeWithdrawn"].ID() -} - -func (s *StakeWithdrawnEvent) Encode() ([]byte, error) { - return StakeManager.Abi.Events["StakeWithdrawn"].Inputs.Encode(s) -} - -func (s *StakeWithdrawnEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !StakeManager.Abi.Events["StakeWithdrawn"].Match(log) { - return false, nil - } - - return true, decodeEvent(StakeManager.Abi.Events["StakeWithdrawn"], log, s) -} - -func (s *StakeWithdrawnEvent) Decode(input []byte) error { - return StakeManager.Abi.Events["StakeWithdrawn"].Inputs.DecodeStruct(input, &s) -} - -type Epoch struct { - StartBlock *big.Int `abi:"startBlock"` - EndBlock *big.Int `abi:"endBlock"` - EpochRoot types.Hash `abi:"epochRoot"` -} - -var EpochABIType = abi.MustNewType("tuple(uint256 startBlock,uint256 endBlock,bytes32 epochRoot)") - -func (e *Epoch) EncodeAbi() ([]byte, error) { - return EpochABIType.Encode(e) -} - -func (e *Epoch) DecodeAbi(buf []byte) error { - return decodeStruct(EpochABIType, buf, &e) -} - -type CommitEpochValidatorSetFn struct { - ID *big.Int `abi:"id"` - Epoch *Epoch `abi:"epoch"` -} - -func (c *CommitEpochValidatorSetFn) Sig() []byte { - return ValidatorSet.Abi.Methods["commitEpoch"].ID() -} - -func (c *CommitEpochValidatorSetFn) EncodeAbi() ([]byte, error) { - return ValidatorSet.Abi.Methods["commitEpoch"].Encode(c) -} - -func (c *CommitEpochValidatorSetFn) DecodeAbi(buf []byte) error { - return decodeMethod(ValidatorSet.Abi.Methods["commitEpoch"], buf, c) -} - -type UnstakeValidatorSetFn struct { - Amount *big.Int `abi:"amount"` -} - -func (u *UnstakeValidatorSetFn) Sig() []byte { - return ValidatorSet.Abi.Methods["unstake"].ID() -} - -func (u *UnstakeValidatorSetFn) EncodeAbi() ([]byte, error) { - return ValidatorSet.Abi.Methods["unstake"].Encode(u) -} - -func (u *UnstakeValidatorSetFn) DecodeAbi(buf []byte) error { - return decodeMethod(ValidatorSet.Abi.Methods["unstake"], buf, u) -} - -type ValidatorInit struct { - Addr types.Address `abi:"addr"` - Stake *big.Int `abi:"stake"` -} - -var ValidatorInitABIType = abi.MustNewType("tuple(address addr,uint256 stake)") - -func (v *ValidatorInit) EncodeAbi() ([]byte, error) { - return ValidatorInitABIType.Encode(v) -} - -func (v *ValidatorInit) DecodeAbi(buf []byte) error { - return decodeStruct(ValidatorInitABIType, buf, &v) -} - -type InitializeValidatorSetFn struct { - NewStateSender types.Address `abi:"newStateSender"` - NewStateReceiver types.Address `abi:"newStateReceiver"` - NewRootChainManager types.Address `abi:"newRootChainManager"` - NewEpochSize *big.Int `abi:"newEpochSize"` - InitialValidators []*ValidatorInit `abi:"initialValidators"` -} - -func (i *InitializeValidatorSetFn) Sig() []byte { - return ValidatorSet.Abi.Methods["initialize"].ID() -} - -func (i *InitializeValidatorSetFn) EncodeAbi() ([]byte, error) { - return ValidatorSet.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeValidatorSetFn) DecodeAbi(buf []byte) error { - return decodeMethod(ValidatorSet.Abi.Methods["initialize"], buf, i) -} - -type TransferEvent struct { - From types.Address `abi:"from"` - To types.Address `abi:"to"` - Value *big.Int `abi:"value"` -} - -func (*TransferEvent) Sig() ethgo.Hash { - return ValidatorSet.Abi.Events["Transfer"].ID() -} - -func (t *TransferEvent) Encode() ([]byte, error) { - return ValidatorSet.Abi.Events["Transfer"].Inputs.Encode(t) -} - -func (t *TransferEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !ValidatorSet.Abi.Events["Transfer"].Match(log) { - return false, nil - } - - return true, decodeEvent(ValidatorSet.Abi.Events["Transfer"], log, t) -} - -func (t *TransferEvent) Decode(input []byte) error { - return ValidatorSet.Abi.Events["Transfer"].Inputs.DecodeStruct(input, &t) -} - -type WithdrawalRegisteredEvent struct { - Account types.Address `abi:"account"` - Amount *big.Int `abi:"amount"` -} - -func (*WithdrawalRegisteredEvent) Sig() ethgo.Hash { - return ValidatorSet.Abi.Events["WithdrawalRegistered"].ID() -} - -func (w *WithdrawalRegisteredEvent) Encode() ([]byte, error) { - return ValidatorSet.Abi.Events["WithdrawalRegistered"].Inputs.Encode(w) -} - -func (w *WithdrawalRegisteredEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !ValidatorSet.Abi.Events["WithdrawalRegistered"].Match(log) { - return false, nil - } - - return true, decodeEvent(ValidatorSet.Abi.Events["WithdrawalRegistered"], log, w) -} - -func (w *WithdrawalRegisteredEvent) Decode(input []byte) error { - return ValidatorSet.Abi.Events["WithdrawalRegistered"].Inputs.DecodeStruct(input, &w) -} - -type WithdrawalEvent struct { - Account types.Address `abi:"account"` - Amount *big.Int `abi:"amount"` -} - -func (*WithdrawalEvent) Sig() ethgo.Hash { - return ValidatorSet.Abi.Events["Withdrawal"].ID() -} - -func (w *WithdrawalEvent) Encode() ([]byte, error) { - return ValidatorSet.Abi.Events["Withdrawal"].Inputs.Encode(w) -} - -func (w *WithdrawalEvent) ParseLog(log *ethgo.Log) (bool, error) { - if !ValidatorSet.Abi.Events["Withdrawal"].Match(log) { - return false, nil - } - - return true, decodeEvent(ValidatorSet.Abi.Events["Withdrawal"], log, w) -} - -func (w *WithdrawalEvent) Decode(input []byte) error { - return ValidatorSet.Abi.Events["Withdrawal"].Inputs.DecodeStruct(input, &w) -} - -type InitializeRewardPoolFn struct { - NewRewardToken types.Address `abi:"newRewardToken"` - NewRewardWallet types.Address `abi:"newRewardWallet"` - NewValidatorSet types.Address `abi:"newValidatorSet"` - NewBaseReward *big.Int `abi:"newBaseReward"` -} - -func (i *InitializeRewardPoolFn) Sig() []byte { - return RewardPool.Abi.Methods["initialize"].ID() -} - -func (i *InitializeRewardPoolFn) EncodeAbi() ([]byte, error) { - return RewardPool.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeRewardPoolFn) DecodeAbi(buf []byte) error { - return decodeMethod(RewardPool.Abi.Methods["initialize"], buf, i) -} - -type Uptime struct { - Validator types.Address `abi:"validator"` - SignedBlocks *big.Int `abi:"signedBlocks"` -} - -var UptimeABIType = abi.MustNewType("tuple(address validator,uint256 signedBlocks)") - -func (u *Uptime) EncodeAbi() ([]byte, error) { - return UptimeABIType.Encode(u) -} - -func (u *Uptime) DecodeAbi(buf []byte) error { - return decodeStruct(UptimeABIType, buf, &u) -} - -type DistributeRewardForRewardPoolFn struct { - EpochID *big.Int `abi:"epochId"` - Uptime []*Uptime `abi:"uptime"` -} - -func (d *DistributeRewardForRewardPoolFn) Sig() []byte { - return RewardPool.Abi.Methods["distributeRewardFor"].ID() -} - -func (d *DistributeRewardForRewardPoolFn) EncodeAbi() ([]byte, error) { - return RewardPool.Abi.Methods["distributeRewardFor"].Encode(d) -} - -func (d *DistributeRewardForRewardPoolFn) DecodeAbi(buf []byte) error { - return decodeMethod(RewardPool.Abi.Methods["distributeRewardFor"], buf, d) -} - -type InitializeEIP1559BurnFn struct { - NewChildERC20Predicate types.Address `abi:"newChildERC20Predicate"` - NewBurnDestination types.Address `abi:"newBurnDestination"` -} - -func (i *InitializeEIP1559BurnFn) Sig() []byte { - return EIP1559Burn.Abi.Methods["initialize"].ID() -} - -func (i *InitializeEIP1559BurnFn) EncodeAbi() ([]byte, error) { - return EIP1559Burn.Abi.Methods["initialize"].Encode(i) -} - -func (i *InitializeEIP1559BurnFn) DecodeAbi(buf []byte) error { - return decodeMethod(EIP1559Burn.Abi.Methods["initialize"], buf, i) -} - -type ProtectSetUpProxyGenesisProxyFn struct { - Initiator types.Address `abi:"initiator"` -} - -func (p *ProtectSetUpProxyGenesisProxyFn) Sig() []byte { - return GenesisProxy.Abi.Methods["protectSetUpProxy"].ID() -} - -func (p *ProtectSetUpProxyGenesisProxyFn) EncodeAbi() ([]byte, error) { - return GenesisProxy.Abi.Methods["protectSetUpProxy"].Encode(p) -} - -func (p *ProtectSetUpProxyGenesisProxyFn) DecodeAbi(buf []byte) error { - return decodeMethod(GenesisProxy.Abi.Methods["protectSetUpProxy"], buf, p) -} - -type SetUpProxyGenesisProxyFn struct { - Logic types.Address `abi:"logic"` - Admin types.Address `abi:"admin"` - Data []byte `abi:"data"` -} - -func (s *SetUpProxyGenesisProxyFn) Sig() []byte { - return GenesisProxy.Abi.Methods["setUpProxy"].ID() -} - -func (s *SetUpProxyGenesisProxyFn) EncodeAbi() ([]byte, error) { - return GenesisProxy.Abi.Methods["setUpProxy"].Encode(s) -} - -func (s *SetUpProxyGenesisProxyFn) DecodeAbi(buf []byte) error { - return decodeMethod(GenesisProxy.Abi.Methods["setUpProxy"], buf, s) -} - -type TransparentUpgradeableProxyConstructorFn struct { - Logic types.Address `abi:"_logic"` - Admin_ types.Address `abi:"admin_"` - Data []byte `abi:"_data"` -} - -func (t *TransparentUpgradeableProxyConstructorFn) Sig() []byte { - return TransparentUpgradeableProxy.Abi.Constructor.ID() -} - -func (t *TransparentUpgradeableProxyConstructorFn) EncodeAbi() ([]byte, error) { - return TransparentUpgradeableProxy.Abi.Constructor.Inputs.Encode(t) -} - -func (t *TransparentUpgradeableProxyConstructorFn) DecodeAbi(buf []byte) error { - return decodeMethod(TransparentUpgradeableProxy.Abi.Constructor, buf, t) -} diff --git a/consensus/polybft/contractsapi/contractsapi_test.go b/consensus/polybft/contractsapi/contractsapi_test.go deleted file mode 100644 index fae755f..0000000 --- a/consensus/polybft/contractsapi/contractsapi_test.go +++ /dev/null @@ -1,130 +0,0 @@ -package contractsapi - -import ( - "math/big" - "reflect" - "testing" - - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/types" -) - -type method interface { - EncodeAbi() ([]byte, error) - DecodeAbi(buf []byte) error -} - -func TestEncoding_Method(t *testing.T) { - t.Parallel() - - cases := []method{ - // empty commit - &CommitStateReceiverFn{ - Commitment: &StateSyncCommitment{ - StartID: big.NewInt(1), - EndID: big.NewInt(1), - Root: types.EmptyRootHash, - }, - Signature: []byte{}, - Bitmap: []byte{}, - }, - // empty commit epoch - &CommitEpochValidatorSetFn{ - ID: big.NewInt(1), - Epoch: &Epoch{ - StartBlock: big.NewInt(1), - EndBlock: big.NewInt(1), - }, - }, - } - - for _, c := range cases { - res, err := c.EncodeAbi() - require.NoError(t, err) - - // use reflection to create another type and decode - val := reflect.New(reflect.TypeOf(c).Elem()).Interface() - obj, ok := val.(method) - require.True(t, ok) - - err = obj.DecodeAbi(res) - require.NoError(t, err) - require.Equal(t, obj, c) - } -} - -func TestEncoding_Struct(t *testing.T) { - t.Parallel() - - commitment := &StateSyncCommitment{ - StartID: big.NewInt(1), - EndID: big.NewInt(10), - Root: types.StringToHash("hash"), - } - - encoding, err := commitment.EncodeAbi() - require.NoError(t, err) - - var commitmentDecoded StateSyncCommitment - - require.NoError(t, commitmentDecoded.DecodeAbi(encoding)) - require.Equal(t, commitment.StartID, commitmentDecoded.StartID) - require.Equal(t, commitment.EndID, commitmentDecoded.EndID) - require.Equal(t, commitment.Root, commitmentDecoded.Root) -} - -func TestEncodingAndParsingEvent(t *testing.T) { - t.Parallel() - - var ( - exitEventAPI L2StateSyncedEvent - stateSyncEventAPI StateSyncedEvent - ) - - topics := make([]ethgo.Hash, 4) - topics[0] = exitEventAPI.Sig() - topics[1] = ethgo.BytesToHash(common.EncodeUint64ToBytes(11)) - topics[2] = ethgo.BytesToHash(types.StringToAddress("0x1111").Bytes()) - topics[3] = ethgo.BytesToHash(types.StringToAddress("0x2222").Bytes()) - someType := abi.MustNewType("tuple(string firstName, string lastName)") - encodedData, err := someType.Encode(map[string]string{"firstName": "John", "lastName": "Doe"}) - require.NoError(t, err) - - log := ðgo.Log{ - Address: ethgo.Address(contracts.L2StateSenderContract), - Topics: topics, - Data: encodedData, - } - - var exitEvent L2StateSyncedEvent - - // log matches event - doesMatch, err := exitEvent.ParseLog(log) - require.NoError(t, err) - require.True(t, doesMatch) - require.Equal(t, uint64(11), exitEvent.ID.Uint64()) - - // change exit event id - log.Topics[1] = ethgo.BytesToHash(common.EncodeUint64ToBytes(22)) - doesMatch, err = exitEvent.ParseLog(log) - require.NoError(t, err) - require.True(t, doesMatch) - require.Equal(t, uint64(22), exitEvent.ID.Uint64()) - - // log does not match event - log.Topics[0] = stateSyncEventAPI.Sig() - doesMatch, err = exitEvent.ParseLog(log) - require.NoError(t, err) - require.False(t, doesMatch) - - // error on parsing log - log.Topics[0] = exitEventAPI.Sig() - log.Topics = log.Topics[:3] - doesMatch, err = exitEvent.ParseLog(log) - require.Error(t, err) - require.True(t, doesMatch) -} diff --git a/consensus/polybft/contractsapi/decoder.go b/consensus/polybft/contractsapi/decoder.go deleted file mode 100644 index 2a3852a..0000000 --- a/consensus/polybft/contractsapi/decoder.go +++ /dev/null @@ -1,99 +0,0 @@ -package contractsapi - -import ( - "bytes" - "fmt" - "math/big" - "reflect" - - "github.com/mitchellh/mapstructure" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" -) - -const abiMethodIDLength = 4 - -func decodeEvent(event *abi.Event, log *ethgo.Log, out interface{}) error { - val, err := event.ParseLog(log) - if err != nil { - return err - } - - return decodeImpl(val, out) -} - -func decodeMethod(method *abi.Method, input []byte, out interface{}) error { - if len(input) < abiMethodIDLength { - return fmt.Errorf("invalid method data, len = %d", len(input)) - } - - sig := method.ID() - if !bytes.HasPrefix(input, sig) { - return fmt.Errorf("prefix is not correct") - } - - val, err := abi.Decode(method.Inputs, input[abiMethodIDLength:]) - if err != nil { - return err - } - - return decodeImpl(val, out) -} - -func decodeStruct(t *abi.Type, input []byte, out interface{}) error { - if len(input) < abiMethodIDLength { - return fmt.Errorf("invalid struct data, len = %d", len(input)) - } - - val, err := abi.Decode(t, input) - if err != nil { - return err - } - - return decodeImpl(val, out) -} - -func decodeImpl(input interface{}, out interface{}) error { - metadata := &mapstructure.Metadata{} - dc := &mapstructure.DecoderConfig{ - Result: out, - TagName: "abi", - Metadata: metadata, - DecodeHook: customHook, - } - - ms, err := mapstructure.NewDecoder(dc) - if err != nil { - return err - } - - if err = ms.Decode(input); err != nil { - return err - } - - if len(metadata.Unused) != 0 { - return fmt.Errorf("some keys not used: %v", metadata.Unused) - } - - return nil -} - -var bigTyp = reflect.TypeOf(new(big.Int)) - -func customHook(f reflect.Type, t reflect.Type, data interface{}) (interface{}, error) { - if f == bigTyp && t.Kind() == reflect.Uint64 { - // convert big.Int to uint64 (if possible) - b, ok := data.(*big.Int) - if !ok { - return nil, fmt.Errorf("data not a big.Int") - } - - if !b.IsUint64() { - return nil, fmt.Errorf("cannot format big.Int to uint64") - } - - return b.Uint64(), nil - } - - return data, nil -} diff --git a/consensus/polybft/contractsapi/gen_sc_data.go b/consensus/polybft/contractsapi/gen_sc_data.go deleted file mode 100644 index 0f26c30..0000000 --- a/consensus/polybft/contractsapi/gen_sc_data.go +++ /dev/null @@ -1,45 +0,0 @@ -// This is auto-generated file. DO NOT EDIT. -package contractsapi - -var L2StateSenderArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"L2StateSender","sourceName":"contracts/child/L2StateSender.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"bytes","name":"data","type":"bytes"}],"name":"L2StateSynced","type":"event"},{"inputs":[],"name":"MAX_LENGTH","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"counter","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"syncState","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50610297806100206000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c806316f198311461004657806361bc221a1461005b578063a6f9885c14610076575b600080fd5b61005961005436600461017a565b61007f565b005b61006460005481565b60405190815260200160405180910390f35b61006461080081565b6001600160a01b0383166100cd5760405162461bcd60e51b815260206004820152601060248201526f24a72b20a624a22fa922a1a2a4ab22a960811b60448201526064015b60405180910390fd5b6108008111156101145760405162461bcd60e51b815260206004820152601260248201527108ab0868a8a88a6be9a82b0be988a9c8ea8960731b60448201526064016100c4565b826001600160a01b0316336001600160a01b031660008081546101369061020b565b9190508190557fedaf3c471ebd67d60c29efe34b639ede7d6a1d92eaeb3f503e784971e67118a5858560405161016d929190610232565b60405180910390a4505050565b60008060006040848603121561018f57600080fd5b83356001600160a01b03811681146101a657600080fd5b9250602084013567ffffffffffffffff808211156101c357600080fd5b818601915086601f8301126101d757600080fd5b8135818111156101e657600080fd5b8760208285010111156101f857600080fd5b6020830194508093505050509250925092565b60006001820161022b57634e487b7160e01b600052601160045260246000fd5b5060010190565b60208152816020820152818360408301376000818301604090810191909152601f909201601f1916010191905056fea264697066735822122041815082e2111df07ce129b83f0000ecca6c4886247dffeae7090f8f048b665164736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100415760003560e01c806316f198311461004657806361bc221a1461005b578063a6f9885c14610076575b600080fd5b61005961005436600461017a565b61007f565b005b61006460005481565b60405190815260200160405180910390f35b61006461080081565b6001600160a01b0383166100cd5760405162461bcd60e51b815260206004820152601060248201526f24a72b20a624a22fa922a1a2a4ab22a960811b60448201526064015b60405180910390fd5b6108008111156101145760405162461bcd60e51b815260206004820152601260248201527108ab0868a8a88a6be9a82b0be988a9c8ea8960731b60448201526064016100c4565b826001600160a01b0316336001600160a01b031660008081546101369061020b565b9190508190557fedaf3c471ebd67d60c29efe34b639ede7d6a1d92eaeb3f503e784971e67118a5858560405161016d929190610232565b60405180910390a4505050565b60008060006040848603121561018f57600080fd5b83356001600160a01b03811681146101a657600080fd5b9250602084013567ffffffffffffffff808211156101c357600080fd5b818601915086601f8301126101d757600080fd5b8135818111156101e657600080fd5b8760208285010111156101f857600080fd5b6020830194508093505050509250925092565b60006001820161022b57634e487b7160e01b600052601160045260246000fd5b5060010190565b60208152816020820152818360408301376000818301604090810191909152601f909201601f1916010191905056fea264697066735822122041815082e2111df07ce129b83f0000ecca6c4886247dffeae7090f8f048b665164736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var StateReceiverArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"StateReceiver","sourceName":"contracts/child/StateReceiver.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"startId","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"endId","type":"uint256"},{"indexed":false,"internalType":"bytes32","name":"root","type":"bytes32"}],"name":"NewCommitment","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"counter","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"},{"indexed":false,"internalType":"bytes","name":"message","type":"bytes"}],"name":"StateSyncResult","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32[][]","name":"proofs","type":"bytes32[][]"},{"components":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"internalType":"struct StateReceiver.StateSync[]","name":"objs","type":"tuple[]"}],"name":"batchExecute","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"startId","type":"uint256"},{"internalType":"uint256","name":"endId","type":"uint256"},{"internalType":"bytes32","name":"root","type":"bytes32"}],"internalType":"struct StateReceiver.StateSyncCommitment","name":"commitment","type":"tuple"},{"internalType":"bytes","name":"signature","type":"bytes"},{"internalType":"bytes","name":"bitmap","type":"bytes"}],"name":"commit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"commitmentCounter","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"commitmentIds","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"commitments","outputs":[{"internalType":"uint256","name":"startId","type":"uint256"},{"internalType":"uint256","name":"endId","type":"uint256"},{"internalType":"bytes32","name":"root","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"},{"components":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"internalType":"struct StateReceiver.StateSync","name":"obj","type":"tuple"}],"name":"execute","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"getCommitmentByStateSyncId","outputs":[{"components":[{"internalType":"uint256","name":"startId","type":"uint256"},{"internalType":"uint256","name":"endId","type":"uint256"},{"internalType":"bytes32","name":"root","type":"bytes32"}],"internalType":"struct StateReceiver.StateSyncCommitment","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"getRootByStateSyncId","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lastCommittedId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"processedStateSyncs","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611244806100206000396000f3fe608060405234801561001057600080fd5b50600436106101215760003560e01c806355b01e4d116100ad578063ad240c2a11610071578063ad240c2a1461026a578063c59a18f714610273578063c6df461714610286578063e0563ab114610299578063eb70ef44146102a257600080fd5b806355b01e4d1461022d5780635ea5df791461023b5780639017c12714610244578063947287cf1461025757806397e5230d1461026057600080fd5b80633b878c22116100f45780633b878c221461018457806349ce89971461018d57806350d5b95b146101d757806351351d53146101ec578063544c5e0f146101fa57600080fd5b806307b3e25214610126578063196f1b2d1461015157806323e281cf14610172578063284017f51461017b575b600080fd5b6101346004600360981b0181565b6040516001600160a01b0390911681526020015b60405180910390f35b61016461015f366004610cd6565b6102d7565b604051908152602001610148565b61016460325481565b61013461202081565b61013461101081565b6101bc61019b366004610cd6565b60356020526000908152604090208054600182015460029092015490919083565b60408051938452602084019290925290820152606001610148565b6101ea6101e5366004610d3a565b610356565b005b6101346002600160a01b0381565b61021d610208366004610cd6565b60346020526000908152604090205460ff1681565b6040519015158152602001610148565b6101346004600160991b0181565b61016461138881565b6101ea610252366004610da9565b61041d565b61016461520881565b610164620249f081565b61016460335481565b610164610281366004610cd6565b6105bd565b6101ea610294366004610e55565b6105de565b61013461203081565b6102b56102b0366004610cd6565b6107c2565b6040805182518152602080840151908201529181015190820152606001610148565b6000806035816102e8603686610885565b81526020810191909152604001600020600201549050806103505760405162461bcd60e51b815260206004820152601d60248201527f537461746552656365697665723a204e4f5f524f4f545f464f525f494400000060448201526064015b60405180910390fd5b92915050565b600061036282356107c2565b80519091506103d290610376908435610ef3565b825160208401516103879190610ef3565b610392906001610f06565b83604001518787876040516020016103aa9190610f5e565b604051602081830303815290604052805190602001206109329095949392919063ffffffff16565b61040e5760405162461bcd60e51b815260206004820152600d60248201526c24a72b20a624a22fa82927a7a360991b6044820152606401610347565b61041782610995565b50505050565b828181146104805760405162461bcd60e51b815260206004820152602a60248201527f537461746552656365697665723a20554e4d4154434845445f4c454e4754485f604482015269504152414d455445525360b01b6064820152608401610347565b60005b818110156105b55760006104ba8585848181106104a2576104a2610ffa565b90506020028101906104b49190611010565b356107c2565b9050600061056e82600001518787868181106104d8576104d8610ffa565b90506020028101906104ea9190611010565b6104f5919035610ef3565b835160208501516105069190610ef3565b610511906001610f06565b84604001518b8b8881811061052857610528610ffa565b905060200281019061053a9190611030565b8b8b8a81811061054c5761054c610ffa565b905060200281019061055e9190611010565b6040516020016103aa9190610f5e565b90508061057f575050600101610483565b6105ab86868581811061059457610594610ffa565b90506020028101906105a69190611010565b610995565b5050600101610483565b505050505050565b603681815481106105cd57600080fd5b600091825260209091200154905081565b336002600160a01b03146106225760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b6044820152606401610347565b603354610630906001610f06565b8535146106725760405162461bcd60e51b815260206004820152601060248201526f1253959053125117d4d510549517d25160821b6044820152606401610347565b8435602086013510156106b85760405162461bcd60e51b815260206004820152600e60248201526d1253959053125117d1539117d25160921b6044820152606401610347565b604080518635602080830191909152870135818301529086013560608201526106fd906080016040516020818303038152906040528051906020012085858585610bb0565b6032805486916035916000918261071383611079565b90915550815260208082019290925260409081016000208335815591830135600183015582013560028201555050603680546001810182556000919091526020868101357f4a11f94e20a93c79f6ec743a1954ec4fc2c08429ae2122118bf234b2185c81b89092018290556033829055604080519088013581528735917f11efd893530b26afc66d488ff54cb15df117cb6e0e4a08c6dcb166d766c3bf3b910160405180910390a35050505050565b60408051606081018252600080825260208201819052918101829052906107ea603684610885565b603654909150810361084a5760405162461bcd60e51b815260206004820152602360248201527f537461746552656365697665723a204e4f5f434f4d4d49544d454e545f464f5260448201526217d25160ea1b6064820152608401610347565b600090815260356020908152604091829020825160608101845281548152600182015492810192909252600201549181019190915292915050565b8154600090810361089857506000610350565b82546000905b808210156108e55760006108b28383610cb4565b600087815260209020909150859082015411156108d1578091506108df565b6108dc816001610f06565b92505b5061089e565b60008211801561091157508361090e86610900600186610ef3565b600091825260209091200190565b54145b1561092a57610921600183610ef3565b92505050610350565b509392505050565b60008115610971578160051b8301835b8760011660051b8981528135602082185250604060002098508760011c97506020810190508181106109425750505b85158488141660018084031b8611600180851b018710161690509695505050505050565b803560009081526034602052604090205460ff1615610a055760405162461bcd60e51b815260206004820152602660248201527f537461746552656365697665723a2053544154455f53594e435f49535f50524f60448201526510d154d4d15160d21b6064820152608401610347565b610a156060820160408301611092565b6001600160a01b03163b600003610a69576040805160208082526000908201819052918335917f31c652130602f3ce96ceaf8a4c2b8b49f049166c6fcf2eb31943a75ec7c936ae910160405180910390a350565b8035600090815260346020526040808220805460ff191660011790558190610a979060608501908501611092565b6001600160a01b03168335610ab26040860160208701611092565b610abf60608701876110ad565b604051602401610ad294939291906110f3565b60408051601f198184030181529181526020820180516001600160e01b031663eeb4994560e01b17905251610b07919061114c565b6000604051808303816000865af19150503d8060008114610b44576040519150601f19603f3d011682016040523d82523d6000602084013e610b49565b606091505b509150915081610b6c5782356000908152603460205260409020805460ff191690555b81151583600001357f31c652130602f3ce96ceaf8a4c2b8b49f049166c6fcf2eb31943a75ec7c936ae83604051610ba3919061115e565b60405180910390a3505050565b6000806120306001600160a01b0316620249f08888888888604051602001610bdc959493929190611191565b60408051601f1981840301815290829052610bf69161114c565b6000604051808303818686fa925050503d8060008114610c32576040519150601f19603f3d011682016040523d82523d6000602084013e610c37565b606091505b5091509150600081806020019051810190610c5291906111ca565b9050828015610c5e5750805b610caa5760405162461bcd60e51b815260206004820152601d60248201527f5349474e41545552455f564552494649434154494f4e5f4641494c45440000006044820152606401610347565b5050505050505050565b6000610cc360028484186111ec565b610ccf90848416610f06565b9392505050565b600060208284031215610ce857600080fd5b5035919050565b60008083601f840112610d0157600080fd5b5081356001600160401b03811115610d1857600080fd5b6020830191508360208260051b8501011115610d3357600080fd5b9250929050565b600080600060408486031215610d4f57600080fd5b83356001600160401b0380821115610d6657600080fd5b610d7287838801610cef565b90955093506020860135915080821115610d8b57600080fd5b50840160808187031215610d9e57600080fd5b809150509250925092565b60008060008060408587031215610dbf57600080fd5b84356001600160401b0380821115610dd657600080fd5b610de288838901610cef565b90965094506020870135915080821115610dfb57600080fd5b50610e0887828801610cef565b95989497509550505050565b60008083601f840112610e2657600080fd5b5081356001600160401b03811115610e3d57600080fd5b602083019150836020828501011115610d3357600080fd5b600080600080600085870360a0811215610e6e57600080fd5b6060811215610e7c57600080fd5b5085945060608601356001600160401b0380821115610e9a57600080fd5b610ea689838a01610e14565b90965094506080880135915080821115610ebf57600080fd5b50610ecc88828901610e14565b969995985093965092949392505050565b634e487b7160e01b600052601160045260246000fd5b8181038181111561035057610350610edd565b8082018082111561035057610350610edd565b80356001600160a01b0381168114610f3057600080fd5b919050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60208152813560208201526000610f7760208401610f19565b60018060a01b03808216604085015280610f9360408701610f19565b16606085015250506060830135601e19843603018112610fb257600080fd5b83016020810190356001600160401b03811115610fce57600080fd5b803603821315610fdd57600080fd5b608080850152610ff160a085018284610f35565b95945050505050565b634e487b7160e01b600052603260045260246000fd5b60008235607e1983360301811261102657600080fd5b9190910192915050565b6000808335601e1984360301811261104757600080fd5b8301803591506001600160401b0382111561106157600080fd5b6020019150600581901b3603821315610d3357600080fd5b60006001820161108b5761108b610edd565b5060010190565b6000602082840312156110a457600080fd5b610ccf82610f19565b6000808335601e198436030181126110c457600080fd5b8301803591506001600160401b038211156110de57600080fd5b602001915036819003821315610d3357600080fd5b8481526001600160a01b038416602082015260606040820181905260009061111e9083018486610f35565b9695505050505050565b60005b8381101561114357818101518382015260200161112b565b50506000910152565b60008251611026818460208701611128565b602081526000825180602084015261117d816040850160208701611128565b601f01601f19169190910160400192915050565b8581526060602082015260006111ab606083018688610f35565b82810360408401526111be818587610f35565b98975050505050505050565b6000602082840312156111dc57600080fd5b81518015158114610ccf57600080fd5b60008261120957634e487b7160e01b600052601260045260246000fd5b50049056fea26469706673582212205e465487d9414dfe77390f61a0c38958de52ee524ceeb4baa7548b12c5998a1564736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101215760003560e01c806355b01e4d116100ad578063ad240c2a11610071578063ad240c2a1461026a578063c59a18f714610273578063c6df461714610286578063e0563ab114610299578063eb70ef44146102a257600080fd5b806355b01e4d1461022d5780635ea5df791461023b5780639017c12714610244578063947287cf1461025757806397e5230d1461026057600080fd5b80633b878c22116100f45780633b878c221461018457806349ce89971461018d57806350d5b95b146101d757806351351d53146101ec578063544c5e0f146101fa57600080fd5b806307b3e25214610126578063196f1b2d1461015157806323e281cf14610172578063284017f51461017b575b600080fd5b6101346004600360981b0181565b6040516001600160a01b0390911681526020015b60405180910390f35b61016461015f366004610cd6565b6102d7565b604051908152602001610148565b61016460325481565b61013461202081565b61013461101081565b6101bc61019b366004610cd6565b60356020526000908152604090208054600182015460029092015490919083565b60408051938452602084019290925290820152606001610148565b6101ea6101e5366004610d3a565b610356565b005b6101346002600160a01b0381565b61021d610208366004610cd6565b60346020526000908152604090205460ff1681565b6040519015158152602001610148565b6101346004600160991b0181565b61016461138881565b6101ea610252366004610da9565b61041d565b61016461520881565b610164620249f081565b61016460335481565b610164610281366004610cd6565b6105bd565b6101ea610294366004610e55565b6105de565b61013461203081565b6102b56102b0366004610cd6565b6107c2565b6040805182518152602080840151908201529181015190820152606001610148565b6000806035816102e8603686610885565b81526020810191909152604001600020600201549050806103505760405162461bcd60e51b815260206004820152601d60248201527f537461746552656365697665723a204e4f5f524f4f545f464f525f494400000060448201526064015b60405180910390fd5b92915050565b600061036282356107c2565b80519091506103d290610376908435610ef3565b825160208401516103879190610ef3565b610392906001610f06565b83604001518787876040516020016103aa9190610f5e565b604051602081830303815290604052805190602001206109329095949392919063ffffffff16565b61040e5760405162461bcd60e51b815260206004820152600d60248201526c24a72b20a624a22fa82927a7a360991b6044820152606401610347565b61041782610995565b50505050565b828181146104805760405162461bcd60e51b815260206004820152602a60248201527f537461746552656365697665723a20554e4d4154434845445f4c454e4754485f604482015269504152414d455445525360b01b6064820152608401610347565b60005b818110156105b55760006104ba8585848181106104a2576104a2610ffa565b90506020028101906104b49190611010565b356107c2565b9050600061056e82600001518787868181106104d8576104d8610ffa565b90506020028101906104ea9190611010565b6104f5919035610ef3565b835160208501516105069190610ef3565b610511906001610f06565b84604001518b8b8881811061052857610528610ffa565b905060200281019061053a9190611030565b8b8b8a81811061054c5761054c610ffa565b905060200281019061055e9190611010565b6040516020016103aa9190610f5e565b90508061057f575050600101610483565b6105ab86868581811061059457610594610ffa565b90506020028101906105a69190611010565b610995565b5050600101610483565b505050505050565b603681815481106105cd57600080fd5b600091825260209091200154905081565b336002600160a01b03146106225760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b6044820152606401610347565b603354610630906001610f06565b8535146106725760405162461bcd60e51b815260206004820152601060248201526f1253959053125117d4d510549517d25160821b6044820152606401610347565b8435602086013510156106b85760405162461bcd60e51b815260206004820152600e60248201526d1253959053125117d1539117d25160921b6044820152606401610347565b604080518635602080830191909152870135818301529086013560608201526106fd906080016040516020818303038152906040528051906020012085858585610bb0565b6032805486916035916000918261071383611079565b90915550815260208082019290925260409081016000208335815591830135600183015582013560028201555050603680546001810182556000919091526020868101357f4a11f94e20a93c79f6ec743a1954ec4fc2c08429ae2122118bf234b2185c81b89092018290556033829055604080519088013581528735917f11efd893530b26afc66d488ff54cb15df117cb6e0e4a08c6dcb166d766c3bf3b910160405180910390a35050505050565b60408051606081018252600080825260208201819052918101829052906107ea603684610885565b603654909150810361084a5760405162461bcd60e51b815260206004820152602360248201527f537461746552656365697665723a204e4f5f434f4d4d49544d454e545f464f5260448201526217d25160ea1b6064820152608401610347565b600090815260356020908152604091829020825160608101845281548152600182015492810192909252600201549181019190915292915050565b8154600090810361089857506000610350565b82546000905b808210156108e55760006108b28383610cb4565b600087815260209020909150859082015411156108d1578091506108df565b6108dc816001610f06565b92505b5061089e565b60008211801561091157508361090e86610900600186610ef3565b600091825260209091200190565b54145b1561092a57610921600183610ef3565b92505050610350565b509392505050565b60008115610971578160051b8301835b8760011660051b8981528135602082185250604060002098508760011c97506020810190508181106109425750505b85158488141660018084031b8611600180851b018710161690509695505050505050565b803560009081526034602052604090205460ff1615610a055760405162461bcd60e51b815260206004820152602660248201527f537461746552656365697665723a2053544154455f53594e435f49535f50524f60448201526510d154d4d15160d21b6064820152608401610347565b610a156060820160408301611092565b6001600160a01b03163b600003610a69576040805160208082526000908201819052918335917f31c652130602f3ce96ceaf8a4c2b8b49f049166c6fcf2eb31943a75ec7c936ae910160405180910390a350565b8035600090815260346020526040808220805460ff191660011790558190610a979060608501908501611092565b6001600160a01b03168335610ab26040860160208701611092565b610abf60608701876110ad565b604051602401610ad294939291906110f3565b60408051601f198184030181529181526020820180516001600160e01b031663eeb4994560e01b17905251610b07919061114c565b6000604051808303816000865af19150503d8060008114610b44576040519150601f19603f3d011682016040523d82523d6000602084013e610b49565b606091505b509150915081610b6c5782356000908152603460205260409020805460ff191690555b81151583600001357f31c652130602f3ce96ceaf8a4c2b8b49f049166c6fcf2eb31943a75ec7c936ae83604051610ba3919061115e565b60405180910390a3505050565b6000806120306001600160a01b0316620249f08888888888604051602001610bdc959493929190611191565b60408051601f1981840301815290829052610bf69161114c565b6000604051808303818686fa925050503d8060008114610c32576040519150601f19603f3d011682016040523d82523d6000602084013e610c37565b606091505b5091509150600081806020019051810190610c5291906111ca565b9050828015610c5e5750805b610caa5760405162461bcd60e51b815260206004820152601d60248201527f5349474e41545552455f564552494649434154494f4e5f4641494c45440000006044820152606401610347565b5050505050505050565b6000610cc360028484186111ec565b610ccf90848416610f06565b9392505050565b600060208284031215610ce857600080fd5b5035919050565b60008083601f840112610d0157600080fd5b5081356001600160401b03811115610d1857600080fd5b6020830191508360208260051b8501011115610d3357600080fd5b9250929050565b600080600060408486031215610d4f57600080fd5b83356001600160401b0380821115610d6657600080fd5b610d7287838801610cef565b90955093506020860135915080821115610d8b57600080fd5b50840160808187031215610d9e57600080fd5b809150509250925092565b60008060008060408587031215610dbf57600080fd5b84356001600160401b0380821115610dd657600080fd5b610de288838901610cef565b90965094506020870135915080821115610dfb57600080fd5b50610e0887828801610cef565b95989497509550505050565b60008083601f840112610e2657600080fd5b5081356001600160401b03811115610e3d57600080fd5b602083019150836020828501011115610d3357600080fd5b600080600080600085870360a0811215610e6e57600080fd5b6060811215610e7c57600080fd5b5085945060608601356001600160401b0380821115610e9a57600080fd5b610ea689838a01610e14565b90965094506080880135915080821115610ebf57600080fd5b50610ecc88828901610e14565b969995985093965092949392505050565b634e487b7160e01b600052601160045260246000fd5b8181038181111561035057610350610edd565b8082018082111561035057610350610edd565b80356001600160a01b0381168114610f3057600080fd5b919050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60208152813560208201526000610f7760208401610f19565b60018060a01b03808216604085015280610f9360408701610f19565b16606085015250506060830135601e19843603018112610fb257600080fd5b83016020810190356001600160401b03811115610fce57600080fd5b803603821315610fdd57600080fd5b608080850152610ff160a085018284610f35565b95945050505050565b634e487b7160e01b600052603260045260246000fd5b60008235607e1983360301811261102657600080fd5b9190910192915050565b6000808335601e1984360301811261104757600080fd5b8301803591506001600160401b0382111561106157600080fd5b6020019150600581901b3603821315610d3357600080fd5b60006001820161108b5761108b610edd565b5060010190565b6000602082840312156110a457600080fd5b610ccf82610f19565b6000808335601e198436030181126110c457600080fd5b8301803591506001600160401b038211156110de57600080fd5b602001915036819003821315610d3357600080fd5b8481526001600160a01b038416602082015260606040820181905260009061111e9083018486610f35565b9695505050505050565b60005b8381101561114357818101518382015260200161112b565b50506000910152565b60008251611026818460208701611128565b602081526000825180602084015261117d816040850160208701611128565b601f01601f19169190910160400192915050565b8581526060602082015260006111ab606083018688610f35565b82810360408401526111be818587610f35565b98975050505050505050565b6000602082840312156111dc57600080fd5b81518015158114610ccf57600080fd5b60008261120957634e487b7160e01b600052601260045260246000fd5b50049056fea26469706673582212205e465487d9414dfe77390f61a0c38958de52ee524ceeb4baa7548b12c5998a1564736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var NativeERC20Artifact string = `{"_format":"hh-sol-artifact-1","contractName":"NativeERC20","sourceName":"contracts/child/NativeERC20.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"predicate_","type":"address"},{"internalType":"address","name":"rootToken_","type":"address"},{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"},{"internalType":"uint8","name":"decimals_","type":"uint8"},{"internalType":"uint256","name":"tokenSupply_","type":"uint256"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"mint","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rootToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b5061121c806100206000396000f3fe608060405234801561001057600080fd5b50600436106101635760003560e01c806355b01e4d116100ce57806397e5230d1161008757806397e5230d146102b85780639dc29fac146102c2578063a457c2d7146102d5578063a9059cbb146102e8578063dd62ed3e146102fb578063e0563ab11461030e578063e61987051461031757600080fd5b806355b01e4d146102605780635ea5df791461026e57806370a0823114610277578063740b08dc14610292578063947287cf146102a757806395d89b41146102b057600080fd5b8063284017f511610120578063284017f514610205578063313ce5671461020e57806339509351146102235780633b878c221461023657806340c10f191461023f57806351351d531461025257600080fd5b806306fdde031461016857806307b3e25214610186578063095ea7b3146101ac57806318160ddd146101cf5780631f2d0065146101e157806323b872dd146101f2575b600080fd5b610170610328565b60405161017d9190610d4d565b60405180910390f35b6101946004600360981b0181565b6040516001600160a01b03909116815260200161017d565b6101bf6101ba366004610d9c565b6103ba565b604051901515815260200161017d565b6034545b60405190815260200161017d565b6036546001600160a01b0316610194565b6101bf610200366004610dc6565b6103d4565b61019461202081565b60395460405160ff909116815260200161017d565b6101bf610231366004610d9c565b6103f8565b61019461101081565b6101bf61024d366004610d9c565b61041a565b6101946002600160a01b0381565b6101946004600160991b0181565b6101d361138881565b6101d3610285366004610e02565b6001600160a01b03163190565b6102a56102a0366004610e6d565b610463565b005b6101d361520881565b610170610618565b6101d3620249f081565b6101bf6102d0366004610d9c565b610627565b6101bf6102e3366004610d9c565b61065e565b6101bf6102f6366004610d9c565b6106d9565b6101d3610309366004610f21565b6106e7565b61019461203081565b6035546001600160a01b0316610194565b60606037805461033790610f54565b80601f016020809104026020016040519081016040528092919081815260200182805461036390610f54565b80156103b05780601f10610385576101008083540402835291602001916103b0565b820191906000526020600020905b81548152906001019060200180831161039357829003601f168201915b5050505050905090565b6000336103c8818585610712565b60019150505b92915050565b6000336103e2858285610836565b6103ed8585856108b0565b506001949350505050565b6000336103c881858561040b83836106e7565b6104159190610fa4565b610712565b6035546000906001600160a01b031633146104505760405162461bcd60e51b815260040161044790610fb7565b60405180910390fd5b61045a8383610a75565b50600192915050565b600054610100900460ff16158080156104835750600054600160ff909116105b8061049d5750303b15801561049d575060005460ff166001145b6105005760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610447565b6000805460ff191660011790558015610523576000805461ff0019166101001790555b336002600160a01b03146105675760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b6044820152606401610447565b603580546001600160a01b03808c166001600160a01b03199283161790925560368054928b169290911691909117905560376105a4878983611060565b5060386105b2858783611060565b506039805460ff191660ff85161790556034829055801561060d576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050505050565b60606038805461033790610f54565b6035546000906001600160a01b031633146106545760405162461bcd60e51b815260040161044790610fb7565b61045a8383610bcf565b6000338161066c82866106e7565b9050838110156106cc5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610447565b6103ed8286868403610712565b6000336103c88185856108b0565b6001600160a01b03918216600090815260336020908152604080832093909416825291909152205490565b6001600160a01b0383166107745760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610447565b6001600160a01b0382166107d55760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610447565b6001600160a01b0383811660008181526033602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b600061084284846106e7565b905060001981146108aa578181101561089d5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610447565b6108aa8484848403610712565b50505050565b6001600160a01b0383166109145760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610447565b6001600160a01b0382166109765760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610447565b6000806120206001600160a01b031685858560405160200161099a93929190611121565b60408051601f19818403018152908290526109b491611145565b6000604051808303816000865af19150503d80600081146109f1576040519150601f19603f3d011682016040523d82523d6000602084013e6109f6565b606091505b5091509150818015610a17575080806020019051810190610a179190611161565b610a335760405162461bcd60e51b815260040161044790611183565b836001600160a01b0316856001600160a01b03166000805160206111c783398151915285604051610a6691815260200190565b60405180910390a35050505050565b6001600160a01b038216610acb5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610447565b8060346000828254610add9190610fa4565b9091555050604051600090819061202090610b0090839087908790602001611121565b60408051601f1981840301815290829052610b1a91611145565b6000604051808303816000865af19150503d8060008114610b57576040519150601f19603f3d011682016040523d82523d6000602084013e610b5c565b606091505b5091509150818015610b7d575080806020019051810190610b7d9190611161565b610b995760405162461bcd60e51b815260040161044790611183565b6040518381526001600160a01b038516906000906000805160206111c7833981519152906020015b60405180910390a350505050565b6001600160a01b038216610c2f5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610447565b8060346000828254610c4191906111b3565b9091555050604051600090819061202090610c6490869084908790602001611121565b60408051601f1981840301815290829052610c7e91611145565b6000604051808303816000865af19150503d8060008114610cbb576040519150601f19603f3d011682016040523d82523d6000602084013e610cc0565b606091505b5091509150818015610ce1575080806020019051810190610ce19190611161565b610cfd5760405162461bcd60e51b815260040161044790611183565b6040518381526000906001600160a01b038616906000805160206111c783398151915290602001610bc1565b60005b83811015610d44578181015183820152602001610d2c565b50506000910152565b6020815260008251806020840152610d6c816040850160208701610d29565b601f01601f19169190910160400192915050565b80356001600160a01b0381168114610d9757600080fd5b919050565b60008060408385031215610daf57600080fd5b610db883610d80565b946020939093013593505050565b600080600060608486031215610ddb57600080fd5b610de484610d80565b9250610df260208501610d80565b9150604084013590509250925092565b600060208284031215610e1457600080fd5b610e1d82610d80565b9392505050565b60008083601f840112610e3657600080fd5b50813567ffffffffffffffff811115610e4e57600080fd5b602083019150836020828501011115610e6657600080fd5b9250929050565b60008060008060008060008060c0898b031215610e8957600080fd5b610e9289610d80565b9750610ea060208a01610d80565b9650604089013567ffffffffffffffff80821115610ebd57600080fd5b610ec98c838d01610e24565b909850965060608b0135915080821115610ee257600080fd5b50610eef8b828c01610e24565b909550935050608089013560ff81168114610f0957600080fd5b8092505060a089013590509295985092959890939650565b60008060408385031215610f3457600080fd5b610f3d83610d80565b9150610f4b60208401610d80565b90509250929050565b600181811c90821680610f6857607f821691505b602082108103610f8857634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b808201808211156103ce576103ce610f8e565b60208082526024908201527f4e617469766545524332303a204f6e6c79207072656469636174652063616e2060408201526318d85b1b60e21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f82111561105b57600081815260208120601f850160051c810160208610156110385750805b601f850160051c820191505b8181101561105757828155600101611044565b5050505b505050565b67ffffffffffffffff83111561107857611078610ffb565b61108c836110868354610f54565b83611011565b6000601f8411600181146110c057600085156110a85750838201355b600019600387901b1c1916600186901b17835561111a565b600083815260209020601f19861690835b828110156110f157868501358255602094850194600190920191016110d1565b508682101561110e5760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b60008251611157818460208701610d29565b9190910192915050565b60006020828403121561117357600080fd5b81518015158114610e1d57600080fd5b60208082526016908201527514149150d3d35412531157d0d0531317d1905253115160521b604082015260600190565b818103818111156103ce576103ce610f8e56feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa26469706673582212203e253e3b3f3175f58563f905e4d35905dc8b894d96a80a43930b6a730edd9a2a64736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101635760003560e01c806355b01e4d116100ce57806397e5230d1161008757806397e5230d146102b85780639dc29fac146102c2578063a457c2d7146102d5578063a9059cbb146102e8578063dd62ed3e146102fb578063e0563ab11461030e578063e61987051461031757600080fd5b806355b01e4d146102605780635ea5df791461026e57806370a0823114610277578063740b08dc14610292578063947287cf146102a757806395d89b41146102b057600080fd5b8063284017f511610120578063284017f514610205578063313ce5671461020e57806339509351146102235780633b878c221461023657806340c10f191461023f57806351351d531461025257600080fd5b806306fdde031461016857806307b3e25214610186578063095ea7b3146101ac57806318160ddd146101cf5780631f2d0065146101e157806323b872dd146101f2575b600080fd5b610170610328565b60405161017d9190610d4d565b60405180910390f35b6101946004600360981b0181565b6040516001600160a01b03909116815260200161017d565b6101bf6101ba366004610d9c565b6103ba565b604051901515815260200161017d565b6034545b60405190815260200161017d565b6036546001600160a01b0316610194565b6101bf610200366004610dc6565b6103d4565b61019461202081565b60395460405160ff909116815260200161017d565b6101bf610231366004610d9c565b6103f8565b61019461101081565b6101bf61024d366004610d9c565b61041a565b6101946002600160a01b0381565b6101946004600160991b0181565b6101d361138881565b6101d3610285366004610e02565b6001600160a01b03163190565b6102a56102a0366004610e6d565b610463565b005b6101d361520881565b610170610618565b6101d3620249f081565b6101bf6102d0366004610d9c565b610627565b6101bf6102e3366004610d9c565b61065e565b6101bf6102f6366004610d9c565b6106d9565b6101d3610309366004610f21565b6106e7565b61019461203081565b6035546001600160a01b0316610194565b60606037805461033790610f54565b80601f016020809104026020016040519081016040528092919081815260200182805461036390610f54565b80156103b05780601f10610385576101008083540402835291602001916103b0565b820191906000526020600020905b81548152906001019060200180831161039357829003601f168201915b5050505050905090565b6000336103c8818585610712565b60019150505b92915050565b6000336103e2858285610836565b6103ed8585856108b0565b506001949350505050565b6000336103c881858561040b83836106e7565b6104159190610fa4565b610712565b6035546000906001600160a01b031633146104505760405162461bcd60e51b815260040161044790610fb7565b60405180910390fd5b61045a8383610a75565b50600192915050565b600054610100900460ff16158080156104835750600054600160ff909116105b8061049d5750303b15801561049d575060005460ff166001145b6105005760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610447565b6000805460ff191660011790558015610523576000805461ff0019166101001790555b336002600160a01b03146105675760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b6044820152606401610447565b603580546001600160a01b03808c166001600160a01b03199283161790925560368054928b169290911691909117905560376105a4878983611060565b5060386105b2858783611060565b506039805460ff191660ff85161790556034829055801561060d576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050505050565b60606038805461033790610f54565b6035546000906001600160a01b031633146106545760405162461bcd60e51b815260040161044790610fb7565b61045a8383610bcf565b6000338161066c82866106e7565b9050838110156106cc5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610447565b6103ed8286868403610712565b6000336103c88185856108b0565b6001600160a01b03918216600090815260336020908152604080832093909416825291909152205490565b6001600160a01b0383166107745760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610447565b6001600160a01b0382166107d55760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610447565b6001600160a01b0383811660008181526033602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b600061084284846106e7565b905060001981146108aa578181101561089d5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610447565b6108aa8484848403610712565b50505050565b6001600160a01b0383166109145760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610447565b6001600160a01b0382166109765760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610447565b6000806120206001600160a01b031685858560405160200161099a93929190611121565b60408051601f19818403018152908290526109b491611145565b6000604051808303816000865af19150503d80600081146109f1576040519150601f19603f3d011682016040523d82523d6000602084013e6109f6565b606091505b5091509150818015610a17575080806020019051810190610a179190611161565b610a335760405162461bcd60e51b815260040161044790611183565b836001600160a01b0316856001600160a01b03166000805160206111c783398151915285604051610a6691815260200190565b60405180910390a35050505050565b6001600160a01b038216610acb5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610447565b8060346000828254610add9190610fa4565b9091555050604051600090819061202090610b0090839087908790602001611121565b60408051601f1981840301815290829052610b1a91611145565b6000604051808303816000865af19150503d8060008114610b57576040519150601f19603f3d011682016040523d82523d6000602084013e610b5c565b606091505b5091509150818015610b7d575080806020019051810190610b7d9190611161565b610b995760405162461bcd60e51b815260040161044790611183565b6040518381526001600160a01b038516906000906000805160206111c7833981519152906020015b60405180910390a350505050565b6001600160a01b038216610c2f5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610447565b8060346000828254610c4191906111b3565b9091555050604051600090819061202090610c6490869084908790602001611121565b60408051601f1981840301815290829052610c7e91611145565b6000604051808303816000865af19150503d8060008114610cbb576040519150601f19603f3d011682016040523d82523d6000602084013e610cc0565b606091505b5091509150818015610ce1575080806020019051810190610ce19190611161565b610cfd5760405162461bcd60e51b815260040161044790611183565b6040518381526000906001600160a01b038616906000805160206111c783398151915290602001610bc1565b60005b83811015610d44578181015183820152602001610d2c565b50506000910152565b6020815260008251806020840152610d6c816040850160208701610d29565b601f01601f19169190910160400192915050565b80356001600160a01b0381168114610d9757600080fd5b919050565b60008060408385031215610daf57600080fd5b610db883610d80565b946020939093013593505050565b600080600060608486031215610ddb57600080fd5b610de484610d80565b9250610df260208501610d80565b9150604084013590509250925092565b600060208284031215610e1457600080fd5b610e1d82610d80565b9392505050565b60008083601f840112610e3657600080fd5b50813567ffffffffffffffff811115610e4e57600080fd5b602083019150836020828501011115610e6657600080fd5b9250929050565b60008060008060008060008060c0898b031215610e8957600080fd5b610e9289610d80565b9750610ea060208a01610d80565b9650604089013567ffffffffffffffff80821115610ebd57600080fd5b610ec98c838d01610e24565b909850965060608b0135915080821115610ee257600080fd5b50610eef8b828c01610e24565b909550935050608089013560ff81168114610f0957600080fd5b8092505060a089013590509295985092959890939650565b60008060408385031215610f3457600080fd5b610f3d83610d80565b9150610f4b60208401610d80565b90509250929050565b600181811c90821680610f6857607f821691505b602082108103610f8857634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b808201808211156103ce576103ce610f8e565b60208082526024908201527f4e617469766545524332303a204f6e6c79207072656469636174652063616e2060408201526318d85b1b60e21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f82111561105b57600081815260208120601f850160051c810160208610156110385750805b601f850160051c820191505b8181101561105757828155600101611044565b5050505b505050565b67ffffffffffffffff83111561107857611078610ffb565b61108c836110868354610f54565b83611011565b6000601f8411600181146110c057600085156110a85750838201355b600019600387901b1c1916600186901b17835561111a565b600083815260209020601f19861690835b828110156110f157868501358255602094850194600190920191016110d1565b508682101561110e5760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b60008251611157818460208701610d29565b9190910192915050565b60006020828403121561117357600080fd5b81518015158114610e1d57600080fd5b60208082526016908201527514149150d3d35412531157d0d0531317d1905253115160521b604082015260600190565b818103818111156103ce576103ce610f8e56feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa26469706673582212203e253e3b3f3175f58563f905e4d35905dc8b894d96a80a43930b6a730edd9a2a64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var NativeERC20MintableArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"NativeERC20Mintable","sourceName":"contracts/child/NativeERC20Mintable.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"predicate_","type":"address"},{"internalType":"address","name":"owner_","type":"address"},{"internalType":"address","name":"rootToken_","type":"address"},{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"},{"internalType":"uint8","name":"decimals_","type":"uint8"},{"internalType":"uint256","name":"tokenSupply_","type":"uint256"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"mint","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b5061001a3361001f565b61008d565b603480546001600160a01b03191690556100388161003b565b50565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b61150a8061009c6000396000f3fe608060405234801561001057600080fd5b506004361061019a5760003560e01c806370a08231116100e45780639dc29fac116100925780639dc29fac1461031a578063a457c2d71461032d578063a9059cbb14610340578063dd62ed3e14610353578063e0563ab114610366578063e30c39781461036f578063e619870514610380578063f2fde38b1461039157600080fd5b806370a08231146102c3578063715018a6146102de57806379ba5097146102e65780638da5cb5b146102ee578063947287cf146102ff57806395d89b411461030857806397e5230d1461031057600080fd5b8063313ce5671161014c578063313ce56714610245578063395093511461025a5780633b878c221461026d57806340c10f191461027657806351351d531461028957806355b01e4d146102975780635ea5df79146102a55780636091636b146102ae57600080fd5b806306fdde031461019f57806307b3e252146101bd578063095ea7b3146101e357806318160ddd146102065780631f2d00651461021857806323b872dd14610229578063284017f51461023c575b600080fd5b6101a76103a4565b6040516101b49190611022565b60405180910390f35b6101cb6004600360981b0181565b6040516001600160a01b0390911681526020016101b4565b6101f66101f1366004611071565b610436565b60405190151581526020016101b4565b6036545b6040519081526020016101b4565b6038546001600160a01b03166101cb565b6101f661023736600461109b565b610450565b6101cb61202081565b603b5460405160ff90911681526020016101b4565b6101f6610268366004611071565b610474565b6101cb61101081565b6101f6610284366004611071565b610496565b6101cb6002600160a01b0381565b6101cb6004600160991b0181565b61020a61138881565b6102c16102bc366004611120565b6104f4565b005b61020a6102d13660046111e4565b6001600160a01b03163190565b6102c1610714565b6102c1610728565b6033546001600160a01b03166101cb565b61020a61520881565b6101a76107a2565b61020a620249f081565b6101f6610328366004611071565b6107b1565b6101f661033b366004611071565b6107fd565b6101f661034e366004611071565b610878565b61020a610361366004611206565b610886565b6101cb61203081565b6034546001600160a01b03166101cb565b6037546001600160a01b03166101cb565b6102c161039f3660046111e4565b6108b1565b6060603980546103b390611239565b80601f01602080910402602001604051908101604052809291908181526020018280546103df90611239565b801561042c5780601f106104015761010080835404028352916020019161042c565b820191906000526020600020905b81548152906001019060200180831161040f57829003601f168201915b5050505050905090565b600033610444818585610922565b60019150505b92915050565b60003361045e858285610a46565b610469858585610ac0565b506001949350505050565b6000336104448185856104878383610886565b6104919190611289565b610922565b6037546000906001600160a01b03163314806104bc57506033546001600160a01b031633145b6104e15760405162461bcd60e51b81526004016104d89061129c565b60405180910390fd5b6104eb8383610c85565b50600192915050565b600054610100900460ff16158080156105145750600054600160ff909116105b8061052e5750303b15801561052e575060005460ff166001145b6105915760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016104d8565b6000805460ff1916600117905580156105b4576000805461ff0019166101001790555b336002600160a01b03146105f85760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016104d8565b6001600160a01b0389166106595760405162461bcd60e51b815260206004820152602260248201527f4e617469766545524332303a20496e76616c6964206f776e6572206164647265604482015261737360f01b60648201526084016104d8565b603780546001600160a01b03808d166001600160a01b03199283161790925560388054928b1692909116919091179055603961069687898361134e565b50603a6106a485878361134e565b50603b805460ff191660ff851617905560368290556106c289610ddf565b8015610708576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050505050565b61071c610df8565b6107266000610ddf565b565b60345433906001600160a01b031681146107965760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084016104d8565b61079f81610ddf565b50565b6060603a80546103b390611239565b6037546000906001600160a01b03163314806107d757506033546001600160a01b031633145b6107f35760405162461bcd60e51b81526004016104d89061129c565b6104eb8383610e52565b6000338161080b8286610886565b90508381101561086b5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084016104d8565b6104698286868403610922565b600033610444818585610ac0565b6001600160a01b03918216600090815260356020908152604080832093909416825291909152205490565b6108b9610df8565b603480546001600160a01b0383166001600160a01b031990911681179091556108ea6033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6001600160a01b0383166109845760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016104d8565b6001600160a01b0382166109e55760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016104d8565b6001600160a01b0383811660008181526035602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b6000610a528484610886565b90506000198114610aba5781811015610aad5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000060448201526064016104d8565b610aba8484848403610922565b50505050565b6001600160a01b038316610b245760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b60648201526084016104d8565b6001600160a01b038216610b865760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016104d8565b6000806120206001600160a01b0316858585604051602001610baa9392919061140f565b60408051601f1981840301815290829052610bc491611433565b6000604051808303816000865af19150503d8060008114610c01576040519150601f19603f3d011682016040523d82523d6000602084013e610c06565b606091505b5091509150818015610c27575080806020019051810190610c27919061144f565b610c435760405162461bcd60e51b81526004016104d890611471565b836001600160a01b0316856001600160a01b03166000805160206114b583398151915285604051610c7691815260200190565b60405180910390a35050505050565b6001600160a01b038216610cdb5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016104d8565b8060366000828254610ced9190611289565b9091555050604051600090819061202090610d109083908790879060200161140f565b60408051601f1981840301815290829052610d2a91611433565b6000604051808303816000865af19150503d8060008114610d67576040519150601f19603f3d011682016040523d82523d6000602084013e610d6c565b606091505b5091509150818015610d8d575080806020019051810190610d8d919061144f565b610da95760405162461bcd60e51b81526004016104d890611471565b6040518381526001600160a01b038516906000906000805160206114b5833981519152906020015b60405180910390a350505050565b603480546001600160a01b031916905561079f81610fac565b6033546001600160a01b031633146107265760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016104d8565b6001600160a01b038216610eb25760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016104d8565b8060366000828254610ec491906114a1565b9091555050604051600090819061202090610ee79086908490879060200161140f565b60408051601f1981840301815290829052610f0191611433565b6000604051808303816000865af19150503d8060008114610f3e576040519150601f19603f3d011682016040523d82523d6000602084013e610f43565b606091505b5091509150818015610f64575080806020019051810190610f64919061144f565b610f805760405162461bcd60e51b81526004016104d890611471565b6040518381526000906001600160a01b038616906000805160206114b583398151915290602001610dd1565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60005b83811015611019578181015183820152602001611001565b50506000910152565b6020815260008251806020840152611041816040850160208701610ffe565b601f01601f19169190910160400192915050565b80356001600160a01b038116811461106c57600080fd5b919050565b6000806040838503121561108457600080fd5b61108d83611055565b946020939093013593505050565b6000806000606084860312156110b057600080fd5b6110b984611055565b92506110c760208501611055565b9150604084013590509250925092565b60008083601f8401126110e957600080fd5b50813567ffffffffffffffff81111561110157600080fd5b60208301915083602082850101111561111957600080fd5b9250929050565b600080600080600080600080600060e08a8c03121561113e57600080fd5b6111478a611055565b985061115560208b01611055565b975061116360408b01611055565b965060608a013567ffffffffffffffff8082111561118057600080fd5b61118c8d838e016110d7565b909850965060808c01359150808211156111a557600080fd5b506111b28c828d016110d7565b90955093505060a08a013560ff811681146111cc57600080fd5b8092505060c08a013590509295985092959850929598565b6000602082840312156111f657600080fd5b6111ff82611055565b9392505050565b6000806040838503121561121957600080fd5b61122283611055565b915061123060208401611055565b90509250929050565b600181811c9082168061124d57607f821691505b60208210810361126d57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b8082018082111561044a5761044a611273565b6020808252602d908201527f4e617469766545524332303a204f6e6c7920707265646963617465206f72206f60408201526c1ddb995c8818d85b8818d85b1b609a1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f82111561134957600081815260208120601f850160051c810160208610156113265750805b601f850160051c820191505b8181101561134557828155600101611332565b5050505b505050565b67ffffffffffffffff831115611366576113666112e9565b61137a836113748354611239565b836112ff565b6000601f8411600181146113ae57600085156113965750838201355b600019600387901b1c1916600186901b178355611408565b600083815260209020601f19861690835b828110156113df57868501358255602094850194600190920191016113bf565b50868210156113fc5760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b60008251611445818460208701610ffe565b9190910192915050565b60006020828403121561146157600080fd5b815180151581146111ff57600080fd5b60208082526016908201527514149150d3d35412531157d0d0531317d1905253115160521b604082015260600190565b8181038181111561044a5761044a61127356feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220c841ea6b2ede0321e38158aa4ac46f255ea0caf34a5429d64b9287ce7df103b364736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b506004361061019a5760003560e01c806370a08231116100e45780639dc29fac116100925780639dc29fac1461031a578063a457c2d71461032d578063a9059cbb14610340578063dd62ed3e14610353578063e0563ab114610366578063e30c39781461036f578063e619870514610380578063f2fde38b1461039157600080fd5b806370a08231146102c3578063715018a6146102de57806379ba5097146102e65780638da5cb5b146102ee578063947287cf146102ff57806395d89b411461030857806397e5230d1461031057600080fd5b8063313ce5671161014c578063313ce56714610245578063395093511461025a5780633b878c221461026d57806340c10f191461027657806351351d531461028957806355b01e4d146102975780635ea5df79146102a55780636091636b146102ae57600080fd5b806306fdde031461019f57806307b3e252146101bd578063095ea7b3146101e357806318160ddd146102065780631f2d00651461021857806323b872dd14610229578063284017f51461023c575b600080fd5b6101a76103a4565b6040516101b49190611022565b60405180910390f35b6101cb6004600360981b0181565b6040516001600160a01b0390911681526020016101b4565b6101f66101f1366004611071565b610436565b60405190151581526020016101b4565b6036545b6040519081526020016101b4565b6038546001600160a01b03166101cb565b6101f661023736600461109b565b610450565b6101cb61202081565b603b5460405160ff90911681526020016101b4565b6101f6610268366004611071565b610474565b6101cb61101081565b6101f6610284366004611071565b610496565b6101cb6002600160a01b0381565b6101cb6004600160991b0181565b61020a61138881565b6102c16102bc366004611120565b6104f4565b005b61020a6102d13660046111e4565b6001600160a01b03163190565b6102c1610714565b6102c1610728565b6033546001600160a01b03166101cb565b61020a61520881565b6101a76107a2565b61020a620249f081565b6101f6610328366004611071565b6107b1565b6101f661033b366004611071565b6107fd565b6101f661034e366004611071565b610878565b61020a610361366004611206565b610886565b6101cb61203081565b6034546001600160a01b03166101cb565b6037546001600160a01b03166101cb565b6102c161039f3660046111e4565b6108b1565b6060603980546103b390611239565b80601f01602080910402602001604051908101604052809291908181526020018280546103df90611239565b801561042c5780601f106104015761010080835404028352916020019161042c565b820191906000526020600020905b81548152906001019060200180831161040f57829003601f168201915b5050505050905090565b600033610444818585610922565b60019150505b92915050565b60003361045e858285610a46565b610469858585610ac0565b506001949350505050565b6000336104448185856104878383610886565b6104919190611289565b610922565b6037546000906001600160a01b03163314806104bc57506033546001600160a01b031633145b6104e15760405162461bcd60e51b81526004016104d89061129c565b60405180910390fd5b6104eb8383610c85565b50600192915050565b600054610100900460ff16158080156105145750600054600160ff909116105b8061052e5750303b15801561052e575060005460ff166001145b6105915760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016104d8565b6000805460ff1916600117905580156105b4576000805461ff0019166101001790555b336002600160a01b03146105f85760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016104d8565b6001600160a01b0389166106595760405162461bcd60e51b815260206004820152602260248201527f4e617469766545524332303a20496e76616c6964206f776e6572206164647265604482015261737360f01b60648201526084016104d8565b603780546001600160a01b03808d166001600160a01b03199283161790925560388054928b1692909116919091179055603961069687898361134e565b50603a6106a485878361134e565b50603b805460ff191660ff851617905560368290556106c289610ddf565b8015610708576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050505050565b61071c610df8565b6107266000610ddf565b565b60345433906001600160a01b031681146107965760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084016104d8565b61079f81610ddf565b50565b6060603a80546103b390611239565b6037546000906001600160a01b03163314806107d757506033546001600160a01b031633145b6107f35760405162461bcd60e51b81526004016104d89061129c565b6104eb8383610e52565b6000338161080b8286610886565b90508381101561086b5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084016104d8565b6104698286868403610922565b600033610444818585610ac0565b6001600160a01b03918216600090815260356020908152604080832093909416825291909152205490565b6108b9610df8565b603480546001600160a01b0383166001600160a01b031990911681179091556108ea6033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6001600160a01b0383166109845760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016104d8565b6001600160a01b0382166109e55760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016104d8565b6001600160a01b0383811660008181526035602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b6000610a528484610886565b90506000198114610aba5781811015610aad5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000060448201526064016104d8565b610aba8484848403610922565b50505050565b6001600160a01b038316610b245760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b60648201526084016104d8565b6001600160a01b038216610b865760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016104d8565b6000806120206001600160a01b0316858585604051602001610baa9392919061140f565b60408051601f1981840301815290829052610bc491611433565b6000604051808303816000865af19150503d8060008114610c01576040519150601f19603f3d011682016040523d82523d6000602084013e610c06565b606091505b5091509150818015610c27575080806020019051810190610c27919061144f565b610c435760405162461bcd60e51b81526004016104d890611471565b836001600160a01b0316856001600160a01b03166000805160206114b583398151915285604051610c7691815260200190565b60405180910390a35050505050565b6001600160a01b038216610cdb5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016104d8565b8060366000828254610ced9190611289565b9091555050604051600090819061202090610d109083908790879060200161140f565b60408051601f1981840301815290829052610d2a91611433565b6000604051808303816000865af19150503d8060008114610d67576040519150601f19603f3d011682016040523d82523d6000602084013e610d6c565b606091505b5091509150818015610d8d575080806020019051810190610d8d919061144f565b610da95760405162461bcd60e51b81526004016104d890611471565b6040518381526001600160a01b038516906000906000805160206114b5833981519152906020015b60405180910390a350505050565b603480546001600160a01b031916905561079f81610fac565b6033546001600160a01b031633146107265760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016104d8565b6001600160a01b038216610eb25760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016104d8565b8060366000828254610ec491906114a1565b9091555050604051600090819061202090610ee79086908490879060200161140f565b60408051601f1981840301815290829052610f0191611433565b6000604051808303816000865af19150503d8060008114610f3e576040519150601f19603f3d011682016040523d82523d6000602084013e610f43565b606091505b5091509150818015610f64575080806020019051810190610f64919061144f565b610f805760405162461bcd60e51b81526004016104d890611471565b6040518381526000906001600160a01b038616906000805160206114b583398151915290602001610dd1565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60005b83811015611019578181015183820152602001611001565b50506000910152565b6020815260008251806020840152611041816040850160208701610ffe565b601f01601f19169190910160400192915050565b80356001600160a01b038116811461106c57600080fd5b919050565b6000806040838503121561108457600080fd5b61108d83611055565b946020939093013593505050565b6000806000606084860312156110b057600080fd5b6110b984611055565b92506110c760208501611055565b9150604084013590509250925092565b60008083601f8401126110e957600080fd5b50813567ffffffffffffffff81111561110157600080fd5b60208301915083602082850101111561111957600080fd5b9250929050565b600080600080600080600080600060e08a8c03121561113e57600080fd5b6111478a611055565b985061115560208b01611055565b975061116360408b01611055565b965060608a013567ffffffffffffffff8082111561118057600080fd5b61118c8d838e016110d7565b909850965060808c01359150808211156111a557600080fd5b506111b28c828d016110d7565b90955093505060a08a013560ff811681146111cc57600080fd5b8092505060c08a013590509295985092959850929598565b6000602082840312156111f657600080fd5b6111ff82611055565b9392505050565b6000806040838503121561121957600080fd5b61122283611055565b915061123060208401611055565b90509250929050565b600181811c9082168061124d57607f821691505b60208210810361126d57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b8082018082111561044a5761044a611273565b6020808252602d908201527f4e617469766545524332303a204f6e6c7920707265646963617465206f72206f60408201526c1ddb995c8818d85b8818d85b1b609a1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f82111561134957600081815260208120601f850160051c810160208610156113265750805b601f850160051c820191505b8181101561134557828155600101611332565b5050505b505050565b67ffffffffffffffff831115611366576113666112e9565b61137a836113748354611239565b836112ff565b6000601f8411600181146113ae57600085156113965750838201355b600019600387901b1c1916600186901b178355611408565b600083815260209020601f19861690835b828110156113df57868501358255602094850194600190920191016113bf565b50868210156113fc5760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b60008251611445818460208701610ffe565b9190910192915050565b60006020828403121561146157600080fd5b815180151581146111ff57600080fd5b60208082526016908201527514149150d3d35412531157d0d0531317d1905253115160521b604082015260600190565b8181038181111561044a5761044a61127356feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220c841ea6b2ede0321e38158aa4ac46f255ea0caf34a5429d64b9287ce7df103b364736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildERC20Artifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildERC20","sourceName":"contracts/child/ChildERC20.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"userAddress","type":"address"},{"indexed":false,"internalType":"address","name":"relayerAddress","type":"address"},{"indexed":false,"internalType":"bytes","name":"functionSignature","type":"bytes"}],"name":"MetaTransactionExecuted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"userAddress","type":"address"},{"internalType":"bytes","name":"functionSignature","type":"bytes"},{"internalType":"bytes32","name":"sigR","type":"bytes32"},{"internalType":"bytes32","name":"sigS","type":"bytes32"},{"internalType":"uint8","name":"sigV","type":"uint8"}],"name":"executeMetaTransaction","outputs":[{"internalType":"bytes","name":"","type":"bytes"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"getNonce","outputs":[{"internalType":"uint256","name":"nonce","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"rootToken_","type":"address"},{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"},{"internalType":"uint8","name":"decimals_","type":"uint8"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"offset","type":"uint256"}],"name":"invalidateNext","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"mint","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rootToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611920806100206000396000f3fe608060405234801561001057600080fd5b50600436106101215760003560e01c806340c10f19116100ad578063a457c2d711610071578063a457c2d71461028b578063a9059cbb1461029e578063dd62ed3e146102b1578063e6198705146102c4578063f6d2ee86146102d557600080fd5b806340c10f191461021f57806370a082311461023257806395d89b411461025b5780639b77ef11146102635780639dc29fac1461027857600080fd5b80631f2d0065116100f45780631f2d00651461018c57806323b872dd146101b15780632d0335ab146101c4578063313ce567146101ed578063395093511461020c57600080fd5b806306fdde0314610126578063095ea7b3146101445780630c53c51c1461016757806318160ddd1461017a575b600080fd5b61012e6102e8565b60405161013b9190611395565b60405180910390f35b6101576101523660046113cb565b61037a565b604051901515815260200161013b565b61012e61017536600461144f565b61039e565b60a0545b60405190815260200161013b565b60d1546001600160a01b03165b6040516001600160a01b03909116815260200161013b565b6101576101bf3660046114c5565b610681565b61017e6101d2366004611501565b6001600160a01b031660009081526038602052604090205490565b60d154600160a01b900460ff1660405160ff909116815260200161013b565b61015761021a3660046113cb565b6106af565b61015761022d3660046113cb565b6106db565b61017e610240366004611501565b6001600160a01b03166000908152609e602052604090205490565b61012e61071b565b61027661027136600461151c565b61072a565b005b6101576102863660046113cb565b610751565b6101576102993660046113cb565b610788565b6101576102ac3660046113cb565b61080e565b61017e6102bf366004611535565b610826565b60d0546001600160a01b0316610199565b6102766102e3366004611568565b610851565b606060a180546102f7906115ec565b80601f0160208091040260200160405190810160405280929190818152602001828054610323906115ec565b80156103705780601f1061034557610100808354040283529160200191610370565b820191906000526020600020905b81548152906001019060200180831161035357829003601f168201915b5050505050905090565b600080610385610ad1565b9050610392818585610ae0565b60019150505b92915050565b606060006103e187878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610c0592505050565b90506001600160e01b031960003581169082160361046c5760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f6400000060648201526084015b60405180910390fd5b604080516060810182526001600160a01b038a16600081815260386020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506104dd8982888888610c20565b6105335760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b6064820152608401610463565b603860008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d60405160200161058893929190611626565b60408051601f19818403018152908290526105a29161164c565b6000604051808303816000865af19150503d80600081146105df576040519150601f19603f3d011682016040523d82523d6000602084013e6105e4565b606091505b5091509150816106365760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c000000006044820152606401610463565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c60405161066b9493929190611668565b60405180910390a19a9950505050505050505050565b60008061068c610ad1565b9050610699858285610cfc565b6106a4858585610d76565b506001949350505050565b6000806106ba610ad1565b90506103928185856106cc8589610826565b6106d691906116b4565b610ae0565b60d0546000906001600160a01b031633146107085760405162461bcd60e51b8152600401610463906116d5565b6107128383610f0f565b50600192915050565b606060a280546102f7906115ec565b33600090815260386020526040812080548392906107499084906116b4565b909155505050565b60d0546000906001600160a01b0316331461077e5760405162461bcd60e51b8152600401610463906116d5565b6107128383610fbf565b600080610793610ad1565b905060006107a18286610826565b9050838110156108015760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610463565b6106a48286868403610ae0565b600080610819610ad1565b9050610392818585610d76565b6001600160a01b039182166000908152609f6020908152604080832093909416825291909152205490565b606b54610100900460ff16158080156108715750606b54600160ff909116105b8061088b5750303b15801561088b5750606b5460ff166001145b6108ee5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610463565b606b805460ff19166001179055801561091157606b805461ff0019166101001790555b6001600160a01b0387161580159061092857508415155b801561093357508215155b61097f5760405162461bcd60e51b815260206004820152601e60248201527f4368696c6445524332303a204241445f494e495449414c495a4154494f4e00006044820152606401610463565b60d1805460ff8416600160a01b026001600160a81b03199091166001600160a01b038a161717905560d080546001600160a01b03191633179055604080516020601f8801819004810282018101909252868152610a2a91889088908190840183828082843760009201919091525050604080516020601f8a0181900481028201810190925288815292508891508790819084018382808284376000920191909152506110de92505050565b610a8286868080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506040805180820190915260018152603160f81b6020820152915061110f9050565b8015610ac857606b805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050565b6000610adb61117b565b905090565b6001600160a01b038316610b425760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610463565b6001600160a01b038216610ba35760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610463565b6001600160a01b038381166000818152609f602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b60008151600003610c1857506000919050565b506020015190565b6000806001610c36610c31886111d7565b611254565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015610c84573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116610cdb5760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b6044820152606401610463565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6000610d088484610826565b90506000198114610d705781811015610d635760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610463565b610d708484848403610ae0565b50505050565b6001600160a01b038316610dda5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610463565b6001600160a01b038216610e3c5760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610463565b6001600160a01b0383166000908152609e602052604090205481811015610eb45760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610463565b6001600160a01b038085166000818152609e602052604080822086860390559286168082529083902080548601905591516000805160206118cb83398151915290610f029086815260200190565b60405180910390a3610d70565b6001600160a01b038216610f655760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610463565b8060a06000828254610f7791906116b4565b90915550506001600160a01b0382166000818152609e60209081526040808320805486019055518481526000805160206118cb833981519152910160405180910390a35b5050565b6001600160a01b03821661101f5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610463565b6001600160a01b0382166000908152609e6020526040902054818110156110935760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610463565b6001600160a01b0383166000818152609e60209081526040808320868603905560a080548790039055518581529192916000805160206118cb8339815191529101610bf8565b505050565b606b54610100900460ff166111055760405162461bcd60e51b815260040161046390611718565b610fbb8282611281565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f61115d8184846112c1565b600055600280546001600160a01b0319163017905560055550505050565b60003033036111d157600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506111d49050565b50335b90565b60006040518060800160405280604381526020016118886043913980516020918201208351848301516040808701518051908601209051611237950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b600061039861126161130a565b8360405161190160f01b8152600281019290925260228201526042902090565b606b54610100900460ff166112a85760405162461bcd60e51b815260040161046390611718565b60a16112b483826117c7565b5060a26110d982826117c7565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b6002546000906001600160a01b031630148015611328575060015446145b15611334575060005490565b610adb6005546003546004546112c1565b60005b83811015611360578181015183820152602001611348565b50506000910152565b60008151808452611381816020860160208601611345565b601f01601f19169290920160200192915050565b6020815260006113a86020830184611369565b9392505050565b80356001600160a01b03811681146113c657600080fd5b919050565b600080604083850312156113de57600080fd5b6113e7836113af565b946020939093013593505050565b60008083601f84011261140757600080fd5b50813567ffffffffffffffff81111561141f57600080fd5b60208301915083602082850101111561143757600080fd5b9250929050565b803560ff811681146113c657600080fd5b60008060008060008060a0878903121561146857600080fd5b611471876113af565b9550602087013567ffffffffffffffff81111561148d57600080fd5b61149989828a016113f5565b90965094505060408701359250606087013591506114b96080880161143e565b90509295509295509295565b6000806000606084860312156114da57600080fd5b6114e3846113af565b92506114f1602085016113af565b9150604084013590509250925092565b60006020828403121561151357600080fd5b6113a8826113af565b60006020828403121561152e57600080fd5b5035919050565b6000806040838503121561154857600080fd5b611551836113af565b915061155f602084016113af565b90509250929050565b6000806000806000806080878903121561158157600080fd5b61158a876113af565b9550602087013567ffffffffffffffff808211156115a757600080fd5b6115b38a838b016113f5565b909750955060408901359150808211156115cc57600080fd5b506115d989828a016113f5565b90945092506114b990506060880161143e565b600181811c9082168061160057607f821691505b60208210810361162057634e487b7160e01b600052602260045260246000fd5b50919050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b6000825161165e818460208701611345565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b8082018082111561039857634e487b7160e01b600052601160045260246000fd5b60208082526023908201527f4368696c6445524332303a204f6e6c79207072656469636174652063616e2063604082015262185b1b60ea1b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f8211156110d957600081815260208120601f850160051c810160208610156117a05750805b601f850160051c820191505b818110156117bf578281556001016117ac565b505050505050565b815167ffffffffffffffff8111156117e1576117e1611763565b6117f5816117ef84546115ec565b84611779565b602080601f83116001811461182a57600084156118125750858301515b600019600386901b1c1916600185901b1785556117bf565b600085815260208120601f198616915b828110156118595788860151825594840194600190910190840161183a565b50858210156118775787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fe4d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220b322ab3a17e671324178982233e8fdd83f1d7487c05f56ee80ebf7cb64b9b2c964736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101215760003560e01c806340c10f19116100ad578063a457c2d711610071578063a457c2d71461028b578063a9059cbb1461029e578063dd62ed3e146102b1578063e6198705146102c4578063f6d2ee86146102d557600080fd5b806340c10f191461021f57806370a082311461023257806395d89b411461025b5780639b77ef11146102635780639dc29fac1461027857600080fd5b80631f2d0065116100f45780631f2d00651461018c57806323b872dd146101b15780632d0335ab146101c4578063313ce567146101ed578063395093511461020c57600080fd5b806306fdde0314610126578063095ea7b3146101445780630c53c51c1461016757806318160ddd1461017a575b600080fd5b61012e6102e8565b60405161013b9190611395565b60405180910390f35b6101576101523660046113cb565b61037a565b604051901515815260200161013b565b61012e61017536600461144f565b61039e565b60a0545b60405190815260200161013b565b60d1546001600160a01b03165b6040516001600160a01b03909116815260200161013b565b6101576101bf3660046114c5565b610681565b61017e6101d2366004611501565b6001600160a01b031660009081526038602052604090205490565b60d154600160a01b900460ff1660405160ff909116815260200161013b565b61015761021a3660046113cb565b6106af565b61015761022d3660046113cb565b6106db565b61017e610240366004611501565b6001600160a01b03166000908152609e602052604090205490565b61012e61071b565b61027661027136600461151c565b61072a565b005b6101576102863660046113cb565b610751565b6101576102993660046113cb565b610788565b6101576102ac3660046113cb565b61080e565b61017e6102bf366004611535565b610826565b60d0546001600160a01b0316610199565b6102766102e3366004611568565b610851565b606060a180546102f7906115ec565b80601f0160208091040260200160405190810160405280929190818152602001828054610323906115ec565b80156103705780601f1061034557610100808354040283529160200191610370565b820191906000526020600020905b81548152906001019060200180831161035357829003601f168201915b5050505050905090565b600080610385610ad1565b9050610392818585610ae0565b60019150505b92915050565b606060006103e187878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610c0592505050565b90506001600160e01b031960003581169082160361046c5760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f6400000060648201526084015b60405180910390fd5b604080516060810182526001600160a01b038a16600081815260386020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506104dd8982888888610c20565b6105335760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b6064820152608401610463565b603860008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d60405160200161058893929190611626565b60408051601f19818403018152908290526105a29161164c565b6000604051808303816000865af19150503d80600081146105df576040519150601f19603f3d011682016040523d82523d6000602084013e6105e4565b606091505b5091509150816106365760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c000000006044820152606401610463565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c60405161066b9493929190611668565b60405180910390a19a9950505050505050505050565b60008061068c610ad1565b9050610699858285610cfc565b6106a4858585610d76565b506001949350505050565b6000806106ba610ad1565b90506103928185856106cc8589610826565b6106d691906116b4565b610ae0565b60d0546000906001600160a01b031633146107085760405162461bcd60e51b8152600401610463906116d5565b6107128383610f0f565b50600192915050565b606060a280546102f7906115ec565b33600090815260386020526040812080548392906107499084906116b4565b909155505050565b60d0546000906001600160a01b0316331461077e5760405162461bcd60e51b8152600401610463906116d5565b6107128383610fbf565b600080610793610ad1565b905060006107a18286610826565b9050838110156108015760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610463565b6106a48286868403610ae0565b600080610819610ad1565b9050610392818585610d76565b6001600160a01b039182166000908152609f6020908152604080832093909416825291909152205490565b606b54610100900460ff16158080156108715750606b54600160ff909116105b8061088b5750303b15801561088b5750606b5460ff166001145b6108ee5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610463565b606b805460ff19166001179055801561091157606b805461ff0019166101001790555b6001600160a01b0387161580159061092857508415155b801561093357508215155b61097f5760405162461bcd60e51b815260206004820152601e60248201527f4368696c6445524332303a204241445f494e495449414c495a4154494f4e00006044820152606401610463565b60d1805460ff8416600160a01b026001600160a81b03199091166001600160a01b038a161717905560d080546001600160a01b03191633179055604080516020601f8801819004810282018101909252868152610a2a91889088908190840183828082843760009201919091525050604080516020601f8a0181900481028201810190925288815292508891508790819084018382808284376000920191909152506110de92505050565b610a8286868080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506040805180820190915260018152603160f81b6020820152915061110f9050565b8015610ac857606b805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050565b6000610adb61117b565b905090565b6001600160a01b038316610b425760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610463565b6001600160a01b038216610ba35760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610463565b6001600160a01b038381166000818152609f602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b60008151600003610c1857506000919050565b506020015190565b6000806001610c36610c31886111d7565b611254565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015610c84573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116610cdb5760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b6044820152606401610463565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6000610d088484610826565b90506000198114610d705781811015610d635760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610463565b610d708484848403610ae0565b50505050565b6001600160a01b038316610dda5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610463565b6001600160a01b038216610e3c5760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610463565b6001600160a01b0383166000908152609e602052604090205481811015610eb45760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610463565b6001600160a01b038085166000818152609e602052604080822086860390559286168082529083902080548601905591516000805160206118cb83398151915290610f029086815260200190565b60405180910390a3610d70565b6001600160a01b038216610f655760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610463565b8060a06000828254610f7791906116b4565b90915550506001600160a01b0382166000818152609e60209081526040808320805486019055518481526000805160206118cb833981519152910160405180910390a35b5050565b6001600160a01b03821661101f5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610463565b6001600160a01b0382166000908152609e6020526040902054818110156110935760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610463565b6001600160a01b0383166000818152609e60209081526040808320868603905560a080548790039055518581529192916000805160206118cb8339815191529101610bf8565b505050565b606b54610100900460ff166111055760405162461bcd60e51b815260040161046390611718565b610fbb8282611281565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f61115d8184846112c1565b600055600280546001600160a01b0319163017905560055550505050565b60003033036111d157600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506111d49050565b50335b90565b60006040518060800160405280604381526020016118886043913980516020918201208351848301516040808701518051908601209051611237950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b600061039861126161130a565b8360405161190160f01b8152600281019290925260228201526042902090565b606b54610100900460ff166112a85760405162461bcd60e51b815260040161046390611718565b60a16112b483826117c7565b5060a26110d982826117c7565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b6002546000906001600160a01b031630148015611328575060015446145b15611334575060005490565b610adb6005546003546004546112c1565b60005b83811015611360578181015183820152602001611348565b50506000910152565b60008151808452611381816020860160208601611345565b601f01601f19169290920160200192915050565b6020815260006113a86020830184611369565b9392505050565b80356001600160a01b03811681146113c657600080fd5b919050565b600080604083850312156113de57600080fd5b6113e7836113af565b946020939093013593505050565b60008083601f84011261140757600080fd5b50813567ffffffffffffffff81111561141f57600080fd5b60208301915083602082850101111561143757600080fd5b9250929050565b803560ff811681146113c657600080fd5b60008060008060008060a0878903121561146857600080fd5b611471876113af565b9550602087013567ffffffffffffffff81111561148d57600080fd5b61149989828a016113f5565b90965094505060408701359250606087013591506114b96080880161143e565b90509295509295509295565b6000806000606084860312156114da57600080fd5b6114e3846113af565b92506114f1602085016113af565b9150604084013590509250925092565b60006020828403121561151357600080fd5b6113a8826113af565b60006020828403121561152e57600080fd5b5035919050565b6000806040838503121561154857600080fd5b611551836113af565b915061155f602084016113af565b90509250929050565b6000806000806000806080878903121561158157600080fd5b61158a876113af565b9550602087013567ffffffffffffffff808211156115a757600080fd5b6115b38a838b016113f5565b909750955060408901359150808211156115cc57600080fd5b506115d989828a016113f5565b90945092506114b990506060880161143e565b600181811c9082168061160057607f821691505b60208210810361162057634e487b7160e01b600052602260045260246000fd5b50919050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b6000825161165e818460208701611345565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b8082018082111561039857634e487b7160e01b600052601160045260246000fd5b60208082526023908201527f4368696c6445524332303a204f6e6c79207072656469636174652063616e2063604082015262185b1b60ea1b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f8211156110d957600081815260208120601f850160051c810160208610156117a05750805b601f850160051c820191505b818110156117bf578281556001016117ac565b505050505050565b815167ffffffffffffffff8111156117e1576117e1611763565b6117f5816117ef84546115ec565b84611779565b602080601f83116001811461182a57600084156118125750858301515b600019600386901b1c1916600185901b1785556117bf565b600085815260208120601f198616915b828110156118595788860151825594840194600190910190840161183a565b50858210156118775787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fe4d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220b322ab3a17e671324178982233e8fdd83f1d7487c05f56ee80ebf7cb64b9b2c964736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildERC20PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildERC20Predicate","sourceName":"contracts/child/ChildERC20Predicate.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2ERC20Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2ERC20Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2TokenMapped","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootERC20Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"},{"internalType":"address","name":"newNativeTokenRootAddress","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootERC20Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IChildERC20","name":"childToken","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC20","name":"childToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b506114ea806100206000396000f3fe608060405234801561001057600080fd5b50600436106101375760003560e01c80637efab4f5116100b8578063c3b35a7e1161007c578063c3b35a7e14610270578063d41f177114610283578063e0563ab1146102aa578063eeb49945146102b3578063f3fef3a3146102c6578063f6451255146102d957600080fd5b80637efab4f5146101fa578063947287cf1461022357806397e5230d1461022c578063b176806514610236578063b68ad1e41461025d57600080fd5b80633b878c22116100ff5780633b878c22146101ab57806351351d53146101b457806355b01e4d146101c25780635ea5df79146101d057806371cf93b7146101e757600080fd5b806305dc2e8f1461013c57806307b3e2521461016c5780631459457a1461017a5780631bc114ba1461018f578063284017f5146101a2575b600080fd5b60345461014f906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b61014f6004600360981b0181565b61018d610188366004610ff2565b610300565b005b60335461014f906001600160a01b031681565b61014f61202081565b61014f61101081565b61014f6002600160a01b0381565b61014f6004600160991b0181565b6101d961138881565b604051908152602001610163565b60355461014f906001600160a01b031681565b61014f610208366004611063565b6037602052600090815260409020546001600160a01b031681565b6101d961520881565b6101d9620249f081565b6101d97f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60365461014f906001600160a01b031681565b61018d61027e366004611087565b610464565b6101d97f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61014f61203081565b61018d6102c13660046110c8565b610474565b61018d6102d4366004611151565b610648565b6101d97f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b336002600160a01b03146103495760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b600054610100900460ff16158080156103695750600054600160ff909116105b806103835750303b158015610383575060005460ff166001145b6103e65760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610340565b6000805460ff191660011790558015610409576000805461ff0019166101001790555b6104168686868686610657565b801561045c576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b61046f8383836107a7565b505050565b6034546001600160a01b031633146104df5760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f53544154455f6044820152672922a1a2a4ab22a960c11b6064820152608401610340565b6035546001600160a01b0384811691161461054d5760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f524f4f545f50604482015267524544494341544560c01b6064820152608401610340565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82161057c60206000848661117d565b610585916111a7565b036105a45761059f61059a826020818661117d565b610b1d565b610642565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6105d360206000848661117d565b6105dc916111a7565b036105eb5761059f8282610dc8565b60405162461bcd60e51b815260206004820152602660248201527f4368696c6445524332305072656469636174653a20494e56414c49445f5349476044820152654e415455524560d01b6064820152608401610340565b50505050565b6106538233836107a7565b5050565b6001600160a01b0385161580159061067757506001600160a01b03841615155b801561068b57506001600160a01b03831615155b801561069f57506001600160a01b03821615155b6106fb5760405162461bcd60e51b815260206004820152602760248201527f4368696c6445524332305072656469636174653a204241445f494e495449414c60448201526624ad20aa24a7a760c91b6064820152608401610340565b603380546001600160a01b03199081166001600160a01b0388811691909117909255603480548216878416179055603580548216868416179055603680549091168483161790558116156107a0576001600160a01b03811660008181526037602052604080822080546001600160a01b03191661101090811790915590519092917f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d91a35b5050505050565b826001600160a01b03163b60000361080b5760405162461bcd60e51b815260206004820152602160248201527f4368696c6445524332305072656469636174653a204e4f545f434f4e545241436044820152601560fa1b6064820152608401610340565b6000836001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561084b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061086f91906111c5565b6001600160a01b038181166000908152603760205260409020549192508581169116146108ae5760405162461bcd60e51b8152600401610340906111e2565b6001600160a01b0381166108c4576108c4611225565b306001600160a01b0316846001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561090c573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061093091906111c5565b6001600160a01b03161461094657610946611225565b604051632770a7eb60e21b81526001600160a01b03851690639dc29fac90610974903390869060040161123b565b6020604051808303816000875af1158015610993573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109b79190611254565b610a035760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204255524e5f4641494c45446044820152606401610340565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610a8e9391169160c4016112bc565b600060405180830381600087803b158015610aa857600080fd5b505af1158015610abc573d6000803e3d6000fd5b50505050826001600160a01b0316846001600160a01b0316826001600160a01b03167fa0923f060a16fc784558d43de424ffde7b01643de5e5d335851b9df94c76bb273386604051610b0f92919061123b565b60405180910390a450505050565b6000808080610b2e858701876112e8565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610b715760405162461bcd60e51b8152600401610340906111e2565b806001600160a01b03163b600003610b8b57610b8b611225565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610bcb573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bef91906111c5565b9050856001600160a01b0316816001600160a01b031614610c1257610c12611225565b6001600160a01b038116610c2857610c28611225565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c70573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c9491906111c5565b6001600160a01b031614610caa57610caa611225565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610cd8908790879060040161123b565b6020604051808303816000875af1158015610cf7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d1b9190611254565b610d675760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204d494e545f4641494c45446044820152606401610340565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fdf34f3a3ed8bedc14a4b284ebaee5374d55b64bac6a84c270dabe8fd6b4cdafd8887604051610db692919061123b565b60405180910390a45050505050505050565b6000808080610dd9858701876113dc565b92975090955093509150506001600160a01b038416610dfa57610dfa611225565b6001600160a01b038481166000908152603760205260409020541615610e2257610e22611225565b6036546040516bffffffffffffffffffffffff19606087901b166020820152600091610e72916001600160a01b039091169060340160405160208183030381529060405280519060200120610f3d565b6001600160a01b038681166000908152603760205260409081902080546001600160a01b031916928416928317905551637b69774360e11b81529192509063f6d2ee8690610eca908890889088908890600401611469565b600060405180830381600087803b158015610ee457600080fd5b505af1158015610ef8573d6000803e3d6000fd5b50506040516001600160a01b038085169350881691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a350505050505050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116610fd45760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b6044820152606401610340565b92915050565b6001600160a01b0381168114610fef57600080fd5b50565b600080600080600060a0868803121561100a57600080fd5b853561101581610fda565b9450602086013561102581610fda565b9350604086013561103581610fda565b9250606086013561104581610fda565b9150608086013561105581610fda565b809150509295509295909350565b60006020828403121561107557600080fd5b813561108081610fda565b9392505050565b60008060006060848603121561109c57600080fd5b83356110a781610fda565b925060208401356110b781610fda565b929592945050506040919091013590565b600080600080606085870312156110de57600080fd5b8435935060208501356110f081610fda565b9250604085013567ffffffffffffffff8082111561110d57600080fd5b818701915087601f83011261112157600080fd5b81358181111561113057600080fd5b88602082850101111561114257600080fd5b95989497505060200194505050565b6000806040838503121561116457600080fd5b823561116f81610fda565b946020939093013593505050565b6000808585111561118d57600080fd5b8386111561119a57600080fd5b5050820193919092039150565b80356020831015610fd457600019602084900360031b1b1692915050565b6000602082840312156111d757600080fd5b815161108081610fda565b60208082526023908201527f4368696c6445524332305072656469636174653a20554e4d41505045445f544f60408201526225a2a760e91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b60006020828403121561126657600080fd5b8151801515811461108057600080fd5b6000815180845260005b8181101561129c57602081850181015186830182015201611280565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b03831681526040602082018190526000906112e090830184611276565b949350505050565b600080600080608085870312156112fe57600080fd5b843561130981610fda565b9350602085013561131981610fda565b9250604085013561132981610fda565b9396929550929360600135925050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261136057600080fd5b813567ffffffffffffffff8082111561137b5761137b611339565b604051601f8301601f19908116603f011681019082821181831017156113a3576113a3611339565b816040528381528660208588010111156113bc57600080fd5b836020870160208301376000602085830101528094505050505092915050565b600080600080600060a086880312156113f457600080fd5b85359450602086013561140681610fda565b9350604086013567ffffffffffffffff8082111561142357600080fd5b61142f89838a0161134f565b9450606088013591508082111561144557600080fd5b506114528882890161134f565b925050608086013560ff8116811461105557600080fd5b6001600160a01b038516815260806020820181905260009061148d90830186611276565b828103604084015261149f8186611276565b91505060ff831660608301529594505050505056fea2646970667358221220e0f44ad7883c5cd2dbd85a60832f6c9874795bf975cefd366724cc91bbc22dcd64736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101375760003560e01c80637efab4f5116100b8578063c3b35a7e1161007c578063c3b35a7e14610270578063d41f177114610283578063e0563ab1146102aa578063eeb49945146102b3578063f3fef3a3146102c6578063f6451255146102d957600080fd5b80637efab4f5146101fa578063947287cf1461022357806397e5230d1461022c578063b176806514610236578063b68ad1e41461025d57600080fd5b80633b878c22116100ff5780633b878c22146101ab57806351351d53146101b457806355b01e4d146101c25780635ea5df79146101d057806371cf93b7146101e757600080fd5b806305dc2e8f1461013c57806307b3e2521461016c5780631459457a1461017a5780631bc114ba1461018f578063284017f5146101a2575b600080fd5b60345461014f906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b61014f6004600360981b0181565b61018d610188366004610ff2565b610300565b005b60335461014f906001600160a01b031681565b61014f61202081565b61014f61101081565b61014f6002600160a01b0381565b61014f6004600160991b0181565b6101d961138881565b604051908152602001610163565b60355461014f906001600160a01b031681565b61014f610208366004611063565b6037602052600090815260409020546001600160a01b031681565b6101d961520881565b6101d9620249f081565b6101d97f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60365461014f906001600160a01b031681565b61018d61027e366004611087565b610464565b6101d97f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61014f61203081565b61018d6102c13660046110c8565b610474565b61018d6102d4366004611151565b610648565b6101d97f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b336002600160a01b03146103495760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b600054610100900460ff16158080156103695750600054600160ff909116105b806103835750303b158015610383575060005460ff166001145b6103e65760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610340565b6000805460ff191660011790558015610409576000805461ff0019166101001790555b6104168686868686610657565b801561045c576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b61046f8383836107a7565b505050565b6034546001600160a01b031633146104df5760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f53544154455f6044820152672922a1a2a4ab22a960c11b6064820152608401610340565b6035546001600160a01b0384811691161461054d5760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f524f4f545f50604482015267524544494341544560c01b6064820152608401610340565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82161057c60206000848661117d565b610585916111a7565b036105a45761059f61059a826020818661117d565b610b1d565b610642565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6105d360206000848661117d565b6105dc916111a7565b036105eb5761059f8282610dc8565b60405162461bcd60e51b815260206004820152602660248201527f4368696c6445524332305072656469636174653a20494e56414c49445f5349476044820152654e415455524560d01b6064820152608401610340565b50505050565b6106538233836107a7565b5050565b6001600160a01b0385161580159061067757506001600160a01b03841615155b801561068b57506001600160a01b03831615155b801561069f57506001600160a01b03821615155b6106fb5760405162461bcd60e51b815260206004820152602760248201527f4368696c6445524332305072656469636174653a204241445f494e495449414c60448201526624ad20aa24a7a760c91b6064820152608401610340565b603380546001600160a01b03199081166001600160a01b0388811691909117909255603480548216878416179055603580548216868416179055603680549091168483161790558116156107a0576001600160a01b03811660008181526037602052604080822080546001600160a01b03191661101090811790915590519092917f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d91a35b5050505050565b826001600160a01b03163b60000361080b5760405162461bcd60e51b815260206004820152602160248201527f4368696c6445524332305072656469636174653a204e4f545f434f4e545241436044820152601560fa1b6064820152608401610340565b6000836001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561084b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061086f91906111c5565b6001600160a01b038181166000908152603760205260409020549192508581169116146108ae5760405162461bcd60e51b8152600401610340906111e2565b6001600160a01b0381166108c4576108c4611225565b306001600160a01b0316846001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561090c573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061093091906111c5565b6001600160a01b03161461094657610946611225565b604051632770a7eb60e21b81526001600160a01b03851690639dc29fac90610974903390869060040161123b565b6020604051808303816000875af1158015610993573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109b79190611254565b610a035760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204255524e5f4641494c45446044820152606401610340565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610a8e9391169160c4016112bc565b600060405180830381600087803b158015610aa857600080fd5b505af1158015610abc573d6000803e3d6000fd5b50505050826001600160a01b0316846001600160a01b0316826001600160a01b03167fa0923f060a16fc784558d43de424ffde7b01643de5e5d335851b9df94c76bb273386604051610b0f92919061123b565b60405180910390a450505050565b6000808080610b2e858701876112e8565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610b715760405162461bcd60e51b8152600401610340906111e2565b806001600160a01b03163b600003610b8b57610b8b611225565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610bcb573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bef91906111c5565b9050856001600160a01b0316816001600160a01b031614610c1257610c12611225565b6001600160a01b038116610c2857610c28611225565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c70573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c9491906111c5565b6001600160a01b031614610caa57610caa611225565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610cd8908790879060040161123b565b6020604051808303816000875af1158015610cf7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d1b9190611254565b610d675760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204d494e545f4641494c45446044820152606401610340565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fdf34f3a3ed8bedc14a4b284ebaee5374d55b64bac6a84c270dabe8fd6b4cdafd8887604051610db692919061123b565b60405180910390a45050505050505050565b6000808080610dd9858701876113dc565b92975090955093509150506001600160a01b038416610dfa57610dfa611225565b6001600160a01b038481166000908152603760205260409020541615610e2257610e22611225565b6036546040516bffffffffffffffffffffffff19606087901b166020820152600091610e72916001600160a01b039091169060340160405160208183030381529060405280519060200120610f3d565b6001600160a01b038681166000908152603760205260409081902080546001600160a01b031916928416928317905551637b69774360e11b81529192509063f6d2ee8690610eca908890889088908890600401611469565b600060405180830381600087803b158015610ee457600080fd5b505af1158015610ef8573d6000803e3d6000fd5b50506040516001600160a01b038085169350881691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a350505050505050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116610fd45760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b6044820152606401610340565b92915050565b6001600160a01b0381168114610fef57600080fd5b50565b600080600080600060a0868803121561100a57600080fd5b853561101581610fda565b9450602086013561102581610fda565b9350604086013561103581610fda565b9250606086013561104581610fda565b9150608086013561105581610fda565b809150509295509295909350565b60006020828403121561107557600080fd5b813561108081610fda565b9392505050565b60008060006060848603121561109c57600080fd5b83356110a781610fda565b925060208401356110b781610fda565b929592945050506040919091013590565b600080600080606085870312156110de57600080fd5b8435935060208501356110f081610fda565b9250604085013567ffffffffffffffff8082111561110d57600080fd5b818701915087601f83011261112157600080fd5b81358181111561113057600080fd5b88602082850101111561114257600080fd5b95989497505060200194505050565b6000806040838503121561116457600080fd5b823561116f81610fda565b946020939093013593505050565b6000808585111561118d57600080fd5b8386111561119a57600080fd5b5050820193919092039150565b80356020831015610fd457600019602084900360031b1b1692915050565b6000602082840312156111d757600080fd5b815161108081610fda565b60208082526023908201527f4368696c6445524332305072656469636174653a20554e4d41505045445f544f60408201526225a2a760e91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b60006020828403121561126657600080fd5b8151801515811461108057600080fd5b6000815180845260005b8181101561129c57602081850181015186830182015201611280565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b03831681526040602082018190526000906112e090830184611276565b949350505050565b600080600080608085870312156112fe57600080fd5b843561130981610fda565b9350602085013561131981610fda565b9250604085013561132981610fda565b9396929550929360600135925050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261136057600080fd5b813567ffffffffffffffff8082111561137b5761137b611339565b604051601f8301601f19908116603f011681019082821181831017156113a3576113a3611339565b816040528381528660208588010111156113bc57600080fd5b836020870160208301376000602085830101528094505050505092915050565b600080600080600060a086880312156113f457600080fd5b85359450602086013561140681610fda565b9350604086013567ffffffffffffffff8082111561142357600080fd5b61142f89838a0161134f565b9450606088013591508082111561144557600080fd5b506114528882890161134f565b925050608086013560ff8116811461105557600080fd5b6001600160a01b038516815260806020820181905260009061148d90830186611276565b828103604084015261149f8186611276565b91505060ff831660608301529594505050505056fea2646970667358221220e0f44ad7883c5cd2dbd85a60832f6c9874795bf975cefd366724cc91bbc22dcd64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildERC20PredicateACLArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildERC20PredicateAccessList","sourceName":"contracts/child/ChildERC20PredicateAccessList.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"AllowListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"BlockListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2ERC20Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2ERC20Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2TokenMapped","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootERC20Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"},{"internalType":"address","name":"newNativeTokenRootAddress","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootERC20Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"},{"internalType":"address","name":"newNativeTokenRootAddress","type":"address"},{"internalType":"bool","name":"newUseAllowList","type":"bool"},{"internalType":"bool","name":"newUseBlockList","type":"bool"},{"internalType":"address","name":"newOwner","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootERC20Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseAllowList","type":"bool"}],"name":"setAllowList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseBlockList","type":"bool"}],"name":"setBlockList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC20","name":"childToken","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC20","name":"childToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611c8e806100206000396000f3fe608060405234801561001057600080fd5b506004361061018f5760003560e01c80638da5cb5b116100e4578063c5e4683a11610092578063c5e4683a14610323578063d41f177114610336578063e0563ab11461035d578063e30c397814610366578063eeb4994514610377578063f2fde38b1461038a578063f3fef3a31461039d578063f6451255146103b057600080fd5b80638da5cb5b1461029f578063947287cf146102b057806397e5230d146102b9578063b1768065146102c3578063b68ad1e4146102ea578063c1225a20146102fd578063c3b35a7e1461031057600080fd5b806354f8abad1161014157806354f8abad1461021a57806355b01e4d1461022d5780635ea5df791461023b578063715018a61461025257806371cf93b71461025a57806379ba50971461026d5780637efab4f51461027557600080fd5b806305dc2e8f1461019457806307b3e252146101c45780631459457a146101d25780631bc114ba146101e7578063284017f5146101fa5780633b878c221461020357806351351d531461020c575b600080fd5b60fd546101a7906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101a76004600360981b0181565b6101e56101e0366004611616565b6103d7565b005b60fc546101a7906001600160a01b031681565b6101a761202081565b6101a761101081565b6101a76002600160a01b0381565b6101e5610228366004611695565b6104db565b6101a76004600160991b0181565b61024461138881565b6040519081526020016101bb565b6101e56105fe565b60fe546101a7906001600160a01b031681565b6101e5610612565b6101a761028336600461173e565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b03166101a7565b61024461520881565b610244620249f081565b6102447f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff546101a7906001600160a01b031681565b6101e561030b366004611762565b61068c565b6101e561031e36600461177f565b6106db565b6101e5610331366004611762565b6106f3565b6102447f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101a761203081565b6065546001600160a01b03166101a7565b6101e56103853660046117c0565b61073a565b6101e561039836600461173e565b61090e565b6101e56103ab366004611849565b61097f565b6102447f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b336002600160a01b03146104075760405163973d02cb60e01b81526004016103fe90611875565b60405180910390fd5b600054610100900460ff16158080156104275750600054600160ff909116105b806104415750303b158015610441575060005460ff166001145b61045d5760405162461bcd60e51b81526004016103fe90611899565b6000805460ff191660011790558015610480576000805461ff0019166101001790555b61048d8686868686610996565b80156104d3576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b336002600160a01b03146105025760405163973d02cb60e01b81526004016103fe90611875565b600054610100900460ff16158080156105225750600054600160ff909116105b8061053c5750303b15801561053c575060005460ff166001145b6105585760405162461bcd60e51b81526004016103fe90611899565b6000805460ff19166001179055801561057b576000805461ff0019166101001790555b6105888989898989610996565b60c9805461ffff191685151561ff00191617610100851515021790556105ad82610ae7565b80156105f3576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050505050565b610606610b00565b6106106000610ae7565b565b60655433906001600160a01b031681146106805760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084016103fe565b61068981610ae7565b50565b610694610b00565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b6106e3610b5a565b6106ee838383610b62565b505050565b6106fb610b00565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b60fd546001600160a01b031633146107a55760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f53544154455f6044820152672922a1a2a4ab22a960c11b60648201526084016103fe565b60fe546001600160a01b038481169116146108135760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f524f4f545f50604482015267524544494341544560c01b60648201526084016103fe565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216108426020600084866118e7565b61084b91611911565b0361086a5761086561086082602081866118e7565b610ed9565b610908565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6108996020600084866118e7565b6108a291611911565b036108b1576108658282611185565b60405162461bcd60e51b815260206004820152602660248201527f4368696c6445524332305072656469636174653a20494e56414c49445f5349476044820152654e415455524560d01b60648201526084016103fe565b50505050565b610916610b00565b606580546001600160a01b0383166001600160a01b031990911681179091556109476033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b610987610b5a565b610992823383610b62565b5050565b6001600160a01b038516158015906109b657506001600160a01b03841615155b80156109ca57506001600160a01b03831615155b80156109de57506001600160a01b03821615155b610a3a5760405162461bcd60e51b815260206004820152602760248201527f4368696c6445524332305072656469636174653a204241445f494e495449414c60448201526624ad20aa24a7a760c91b60648201526084016103fe565b60fc80546001600160a01b03199081166001600160a01b038881169190911790925560fd8054821687841617905560fe8054821686841617905560ff8054909116848316179055811615610ae0576001600160a01b0381166000818152610100602052604080822080546001600160a01b03191661101090811790915590519092917f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d91a35b5050505050565b606580546001600160a01b0319169055610689816112fc565b6033546001600160a01b031633146106105760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016103fe565b61061061134e565b826001600160a01b03163b600003610bc65760405162461bcd60e51b815260206004820152602160248201527f4368696c6445524332305072656469636174653a204e4f545f434f4e545241436044820152601560fa1b60648201526084016103fe565b6000836001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c06573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c2a919061192f565b6001600160a01b0381811660009081526101006020526040902054919250858116911614610c6a5760405162461bcd60e51b81526004016103fe9061194c565b6001600160a01b038116610c8057610c8061198f565b306001600160a01b0316846001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610cc8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610cec919061192f565b6001600160a01b031614610d0257610d0261198f565b604051632770a7eb60e21b81526001600160a01b03851690639dc29fac90610d3090339086906004016119a5565b6020604051808303816000875af1158015610d4f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d7391906119be565b610dbf5760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204255524e5f4641494c454460448201526064016103fe565b60fc5460fe54604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610e4a9391169160c401611a2b565b600060405180830381600087803b158015610e6457600080fd5b505af1158015610e78573d6000803e3d6000fd5b50505050826001600160a01b0316846001600160a01b0316826001600160a01b03167fa0923f060a16fc784558d43de424ffde7b01643de5e5d335851b9df94c76bb273386604051610ecb9291906119a5565b60405180910390a450505050565b6000808080610eea85870187611a57565b6001600160a01b038085166000908152610100602052604090205494985092965090945092501680610f2e5760405162461bcd60e51b81526004016103fe9061194c565b806001600160a01b03163b600003610f4857610f4861198f565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f88573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fac919061192f565b9050856001600160a01b0316816001600160a01b031614610fcf57610fcf61198f565b6001600160a01b038116610fe557610fe561198f565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561102d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611051919061192f565b6001600160a01b0316146110675761106761198f565b6040516340c10f1960e01b81526001600160a01b038316906340c10f199061109590879087906004016119a5565b6020604051808303816000875af11580156110b4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110d891906119be565b6111245760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204d494e545f4641494c454460448201526064016103fe565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fdf34f3a3ed8bedc14a4b284ebaee5374d55b64bac6a84c270dabe8fd6b4cdafd88876040516111739291906119a5565b60405180910390a45050505050505050565b600080808061119685870187611b4b565b92975090955093509150506001600160a01b0384166111b7576111b761198f565b6001600160a01b038481166000908152610100602052604090205416156111e0576111e061198f565b60ff546040516bffffffffffffffffffffffff19606087901b166020820152600091611230916001600160a01b039091169060340160405160208183030381529060405280519060200120611564565b6001600160a01b03868116600090815261010060205260409081902080546001600160a01b031916928416928317905551637b69774360e11b81529192509063f6d2ee8690611289908890889088908890600401611bd8565b600060405180830381600087803b1580156112a357600080fd5b505af11580156112b7573d6000803e3d6000fd5b50506040516001600160a01b038085169350881691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a350505050505050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60c95460ff161561145957604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b0191611388916113b09190611c23565b6000604051808303818686fa925050503d80600081146113ec576040519150601f19603f3d011682016040523d82523d6000602084013e6113f1565b606091505b509150915081801561141657506000818060200190518101906114149190611c3f565b115b6114565760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b60448201526064016103fe565b50505b60c954610100900460ff161561061057604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b0191611388916114c09190611c23565b6000604051808303818686fa925050503d80600081146114fc576040519150601f19603f3d011682016040523d82523d6000602084013e611501565b606091505b50915091508180156115275750808060200190518101906115229190611c3f565b600114155b6109925760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b60448201526064016103fe565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b0381166115fb5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016103fe565b92915050565b6001600160a01b038116811461068957600080fd5b600080600080600060a0868803121561162e57600080fd5b853561163981611601565b9450602086013561164981611601565b9350604086013561165981611601565b9250606086013561166981611601565b9150608086013561167981611601565b809150509295509295909350565b801515811461068957600080fd5b600080600080600080600080610100898b0312156116b257600080fd5b88356116bd81611601565b975060208901356116cd81611601565b965060408901356116dd81611601565b955060608901356116ed81611601565b945060808901356116fd81611601565b935060a089013561170d81611687565b925060c089013561171d81611687565b915060e089013561172d81611601565b809150509295985092959890939650565b60006020828403121561175057600080fd5b813561175b81611601565b9392505050565b60006020828403121561177457600080fd5b813561175b81611687565b60008060006060848603121561179457600080fd5b833561179f81611601565b925060208401356117af81611601565b929592945050506040919091013590565b600080600080606085870312156117d657600080fd5b8435935060208501356117e881611601565b9250604085013567ffffffffffffffff8082111561180557600080fd5b818701915087601f83011261181957600080fd5b81358181111561182857600080fd5b88602082850101111561183a57600080fd5b95989497505060200194505050565b6000806040838503121561185c57600080fd5b823561186781611601565b946020939093013593505050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b600080858511156118f757600080fd5b8386111561190457600080fd5b5050820193919092039150565b803560208310156115fb57600019602084900360031b1b1692915050565b60006020828403121561194157600080fd5b815161175b81611601565b60208082526023908201527f4368696c6445524332305072656469636174653a20554e4d41505045445f544f60408201526225a2a760e91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b6000602082840312156119d057600080fd5b815161175b81611687565b60005b838110156119f65781810151838201526020016119de565b50506000910152565b60008151808452611a178160208601602086016119db565b601f01601f19169290920160200192915050565b6001600160a01b0383168152604060208201819052600090611a4f908301846119ff565b949350505050565b60008060008060808587031215611a6d57600080fd5b8435611a7881611601565b93506020850135611a8881611601565b92506040850135611a9881611601565b9396929550929360600135925050565b634e487b7160e01b600052604160045260246000fd5b600082601f830112611acf57600080fd5b813567ffffffffffffffff80821115611aea57611aea611aa8565b604051601f8301601f19908116603f01168101908282118183101715611b1257611b12611aa8565b81604052838152866020858801011115611b2b57600080fd5b836020870160208301376000602085830101528094505050505092915050565b600080600080600060a08688031215611b6357600080fd5b853594506020860135611b7581611601565b9350604086013567ffffffffffffffff80821115611b9257600080fd5b611b9e89838a01611abe565b94506060880135915080821115611bb457600080fd5b50611bc188828901611abe565b925050608086013560ff8116811461167957600080fd5b6001600160a01b0385168152608060208201819052600090611bfc908301866119ff565b8281036040840152611c0e81866119ff565b91505060ff8316606083015295945050505050565b60008251611c358184602087016119db565b9190910192915050565b600060208284031215611c5157600080fd5b505191905056fea26469706673582212206ea7447ee1c5e059d53f0d5e7f2241d867a55a3968ed1a50039de2f2d55b996664736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b506004361061018f5760003560e01c80638da5cb5b116100e4578063c5e4683a11610092578063c5e4683a14610323578063d41f177114610336578063e0563ab11461035d578063e30c397814610366578063eeb4994514610377578063f2fde38b1461038a578063f3fef3a31461039d578063f6451255146103b057600080fd5b80638da5cb5b1461029f578063947287cf146102b057806397e5230d146102b9578063b1768065146102c3578063b68ad1e4146102ea578063c1225a20146102fd578063c3b35a7e1461031057600080fd5b806354f8abad1161014157806354f8abad1461021a57806355b01e4d1461022d5780635ea5df791461023b578063715018a61461025257806371cf93b71461025a57806379ba50971461026d5780637efab4f51461027557600080fd5b806305dc2e8f1461019457806307b3e252146101c45780631459457a146101d25780631bc114ba146101e7578063284017f5146101fa5780633b878c221461020357806351351d531461020c575b600080fd5b60fd546101a7906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101a76004600360981b0181565b6101e56101e0366004611616565b6103d7565b005b60fc546101a7906001600160a01b031681565b6101a761202081565b6101a761101081565b6101a76002600160a01b0381565b6101e5610228366004611695565b6104db565b6101a76004600160991b0181565b61024461138881565b6040519081526020016101bb565b6101e56105fe565b60fe546101a7906001600160a01b031681565b6101e5610612565b6101a761028336600461173e565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b03166101a7565b61024461520881565b610244620249f081565b6102447f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff546101a7906001600160a01b031681565b6101e561030b366004611762565b61068c565b6101e561031e36600461177f565b6106db565b6101e5610331366004611762565b6106f3565b6102447f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101a761203081565b6065546001600160a01b03166101a7565b6101e56103853660046117c0565b61073a565b6101e561039836600461173e565b61090e565b6101e56103ab366004611849565b61097f565b6102447f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b336002600160a01b03146104075760405163973d02cb60e01b81526004016103fe90611875565b60405180910390fd5b600054610100900460ff16158080156104275750600054600160ff909116105b806104415750303b158015610441575060005460ff166001145b61045d5760405162461bcd60e51b81526004016103fe90611899565b6000805460ff191660011790558015610480576000805461ff0019166101001790555b61048d8686868686610996565b80156104d3576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b336002600160a01b03146105025760405163973d02cb60e01b81526004016103fe90611875565b600054610100900460ff16158080156105225750600054600160ff909116105b8061053c5750303b15801561053c575060005460ff166001145b6105585760405162461bcd60e51b81526004016103fe90611899565b6000805460ff19166001179055801561057b576000805461ff0019166101001790555b6105888989898989610996565b60c9805461ffff191685151561ff00191617610100851515021790556105ad82610ae7565b80156105f3576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050505050565b610606610b00565b6106106000610ae7565b565b60655433906001600160a01b031681146106805760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084016103fe565b61068981610ae7565b50565b610694610b00565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b6106e3610b5a565b6106ee838383610b62565b505050565b6106fb610b00565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b60fd546001600160a01b031633146107a55760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f53544154455f6044820152672922a1a2a4ab22a960c11b60648201526084016103fe565b60fe546001600160a01b038481169116146108135760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f524f4f545f50604482015267524544494341544560c01b60648201526084016103fe565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216108426020600084866118e7565b61084b91611911565b0361086a5761086561086082602081866118e7565b610ed9565b610908565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6108996020600084866118e7565b6108a291611911565b036108b1576108658282611185565b60405162461bcd60e51b815260206004820152602660248201527f4368696c6445524332305072656469636174653a20494e56414c49445f5349476044820152654e415455524560d01b60648201526084016103fe565b50505050565b610916610b00565b606580546001600160a01b0383166001600160a01b031990911681179091556109476033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b610987610b5a565b610992823383610b62565b5050565b6001600160a01b038516158015906109b657506001600160a01b03841615155b80156109ca57506001600160a01b03831615155b80156109de57506001600160a01b03821615155b610a3a5760405162461bcd60e51b815260206004820152602760248201527f4368696c6445524332305072656469636174653a204241445f494e495449414c60448201526624ad20aa24a7a760c91b60648201526084016103fe565b60fc80546001600160a01b03199081166001600160a01b038881169190911790925560fd8054821687841617905560fe8054821686841617905560ff8054909116848316179055811615610ae0576001600160a01b0381166000818152610100602052604080822080546001600160a01b03191661101090811790915590519092917f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d91a35b5050505050565b606580546001600160a01b0319169055610689816112fc565b6033546001600160a01b031633146106105760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016103fe565b61061061134e565b826001600160a01b03163b600003610bc65760405162461bcd60e51b815260206004820152602160248201527f4368696c6445524332305072656469636174653a204e4f545f434f4e545241436044820152601560fa1b60648201526084016103fe565b6000836001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c06573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c2a919061192f565b6001600160a01b0381811660009081526101006020526040902054919250858116911614610c6a5760405162461bcd60e51b81526004016103fe9061194c565b6001600160a01b038116610c8057610c8061198f565b306001600160a01b0316846001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610cc8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610cec919061192f565b6001600160a01b031614610d0257610d0261198f565b604051632770a7eb60e21b81526001600160a01b03851690639dc29fac90610d3090339086906004016119a5565b6020604051808303816000875af1158015610d4f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d7391906119be565b610dbf5760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204255524e5f4641494c454460448201526064016103fe565b60fc5460fe54604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610e4a9391169160c401611a2b565b600060405180830381600087803b158015610e6457600080fd5b505af1158015610e78573d6000803e3d6000fd5b50505050826001600160a01b0316846001600160a01b0316826001600160a01b03167fa0923f060a16fc784558d43de424ffde7b01643de5e5d335851b9df94c76bb273386604051610ecb9291906119a5565b60405180910390a450505050565b6000808080610eea85870187611a57565b6001600160a01b038085166000908152610100602052604090205494985092965090945092501680610f2e5760405162461bcd60e51b81526004016103fe9061194c565b806001600160a01b03163b600003610f4857610f4861198f565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f88573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fac919061192f565b9050856001600160a01b0316816001600160a01b031614610fcf57610fcf61198f565b6001600160a01b038116610fe557610fe561198f565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561102d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611051919061192f565b6001600160a01b0316146110675761106761198f565b6040516340c10f1960e01b81526001600160a01b038316906340c10f199061109590879087906004016119a5565b6020604051808303816000875af11580156110b4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110d891906119be565b6111245760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204d494e545f4641494c454460448201526064016103fe565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fdf34f3a3ed8bedc14a4b284ebaee5374d55b64bac6a84c270dabe8fd6b4cdafd88876040516111739291906119a5565b60405180910390a45050505050505050565b600080808061119685870187611b4b565b92975090955093509150506001600160a01b0384166111b7576111b761198f565b6001600160a01b038481166000908152610100602052604090205416156111e0576111e061198f565b60ff546040516bffffffffffffffffffffffff19606087901b166020820152600091611230916001600160a01b039091169060340160405160208183030381529060405280519060200120611564565b6001600160a01b03868116600090815261010060205260409081902080546001600160a01b031916928416928317905551637b69774360e11b81529192509063f6d2ee8690611289908890889088908890600401611bd8565b600060405180830381600087803b1580156112a357600080fd5b505af11580156112b7573d6000803e3d6000fd5b50506040516001600160a01b038085169350881691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a350505050505050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60c95460ff161561145957604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b0191611388916113b09190611c23565b6000604051808303818686fa925050503d80600081146113ec576040519150601f19603f3d011682016040523d82523d6000602084013e6113f1565b606091505b509150915081801561141657506000818060200190518101906114149190611c3f565b115b6114565760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b60448201526064016103fe565b50505b60c954610100900460ff161561061057604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b0191611388916114c09190611c23565b6000604051808303818686fa925050503d80600081146114fc576040519150601f19603f3d011682016040523d82523d6000602084013e611501565b606091505b50915091508180156115275750808060200190518101906115229190611c3f565b600114155b6109925760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b60448201526064016103fe565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b0381166115fb5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016103fe565b92915050565b6001600160a01b038116811461068957600080fd5b600080600080600060a0868803121561162e57600080fd5b853561163981611601565b9450602086013561164981611601565b9350604086013561165981611601565b9250606086013561166981611601565b9150608086013561167981611601565b809150509295509295909350565b801515811461068957600080fd5b600080600080600080600080610100898b0312156116b257600080fd5b88356116bd81611601565b975060208901356116cd81611601565b965060408901356116dd81611601565b955060608901356116ed81611601565b945060808901356116fd81611601565b935060a089013561170d81611687565b925060c089013561171d81611687565b915060e089013561172d81611601565b809150509295985092959890939650565b60006020828403121561175057600080fd5b813561175b81611601565b9392505050565b60006020828403121561177457600080fd5b813561175b81611687565b60008060006060848603121561179457600080fd5b833561179f81611601565b925060208401356117af81611601565b929592945050506040919091013590565b600080600080606085870312156117d657600080fd5b8435935060208501356117e881611601565b9250604085013567ffffffffffffffff8082111561180557600080fd5b818701915087601f83011261181957600080fd5b81358181111561182857600080fd5b88602082850101111561183a57600080fd5b95989497505060200194505050565b6000806040838503121561185c57600080fd5b823561186781611601565b946020939093013593505050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b600080858511156118f757600080fd5b8386111561190457600080fd5b5050820193919092039150565b803560208310156115fb57600019602084900360031b1b1692915050565b60006020828403121561194157600080fd5b815161175b81611601565b60208082526023908201527f4368696c6445524332305072656469636174653a20554e4d41505045445f544f60408201526225a2a760e91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b6000602082840312156119d057600080fd5b815161175b81611687565b60005b838110156119f65781810151838201526020016119de565b50506000910152565b60008151808452611a178160208601602086016119db565b601f01601f19169290920160200192915050565b6001600160a01b0383168152604060208201819052600090611a4f908301846119ff565b949350505050565b60008060008060808587031215611a6d57600080fd5b8435611a7881611601565b93506020850135611a8881611601565b92506040850135611a9881611601565b9396929550929360600135925050565b634e487b7160e01b600052604160045260246000fd5b600082601f830112611acf57600080fd5b813567ffffffffffffffff80821115611aea57611aea611aa8565b604051601f8301601f19908116603f01168101908282118183101715611b1257611b12611aa8565b81604052838152866020858801011115611b2b57600080fd5b836020870160208301376000602085830101528094505050505092915050565b600080600080600060a08688031215611b6357600080fd5b853594506020860135611b7581611601565b9350604086013567ffffffffffffffff80821115611b9257600080fd5b611b9e89838a01611abe565b94506060880135915080821115611bb457600080fd5b50611bc188828901611abe565b925050608086013560ff8116811461167957600080fd5b6001600160a01b0385168152608060208201819052600090611bfc908301866119ff565b8281036040840152611c0e81866119ff565b91505060ff8316606083015295945050505050565b60008251611c358184602087016119db565b9190910192915050565b600060208284031215611c5157600080fd5b505191905056fea26469706673582212206ea7447ee1c5e059d53f0d5e7f2241d867a55a3968ed1a50039de2f2d55b996664736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RootMintableERC20PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RootMintableERC20Predicate","sourceName":"contracts/child/RootMintableERC20Predicate.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"depositor","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2MintableERC20Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2MintableERC20Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2MintableTokenMapped","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childERC20Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC20Metadata","name":"rootToken","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20Metadata","name":"rootToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"depositTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newChildERC20Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC20Metadata","name":"rootToken","type":"address"}],"name":"mapToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b5061149f806100206000396000f3fe608060405234801561001057600080fd5b50600436106101425760003560e01c806397e5230d116100b8578063e0563ab11161007c578063e0563ab1146102a2578063eeb49945146102ab578063f213159c146102be578063f4a120f7146102d1578063f6451255146102e4578063f8c8765e1461030b57600080fd5b806397e5230d14610224578063b17680651461022e578063b68ad1e414610255578063d41f177114610268578063d57184e41461028f57600080fd5b806347e7ef241161010a57806347e7ef24146101aa57806351351d53146101bf57806355b01e4d146101cd5780635ea5df79146101db5780637efab4f5146101f2578063947287cf1461021b57600080fd5b806305dc2e8f1461014757806307b3e252146101775780631bc114ba14610185578063284017f5146101985780633b878c22146101a1575b600080fd5b60345461015a906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b61015a6004600360981b0181565b60335461015a906001600160a01b031681565b61015a61202081565b61015a61101081565b6101bd6101b8366004611038565b61031e565b005b61015a6002600160a01b0381565b61015a6004600160991b0181565b6101e461138881565b60405190815260200161016e565b61015a610200366004611064565b6037602052600090815260409020546001600160a01b031681565b6101e461520881565b6101e4620249f081565b6101e47f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60365461015a906001600160a01b031681565b6101e47f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b60355461015a906001600160a01b031681565b61015a61203081565b6101bd6102b9366004611088565b61032d565b6101bd6102cc366004611111565b6104d5565b61015a6102df366004611064565b6104e5565b6101e47f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6101bd610319366004611152565b6108b1565b610329823383610a0e565b5050565b6034546001600160a01b031633146103a45760405162461bcd60e51b815260206004820152602f60248201527f526f6f744d696e7461626c6545524332305072656469636174653a204f4e4c5960448201526e2fa9aa20aa22afa922a1a2a4ab22a960891b60648201526084015b60405180910390fd5b6035546001600160a01b0384811691161461041a5760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c6545524332305072656469636174653a204f4e4c5960448201526f5f4348494c445f50524544494341544560801b606482015260840161039b565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e9828696104496020600084866111ae565b610452916111d8565b036104715761046c61046782602081866111ae565b610b7e565b6104cf565b60405162461bcd60e51b815260206004820152602d60248201527f526f6f744d696e7461626c6545524332305072656469636174653a20494e564160448201526c4c49445f5349474e415455524560981b606482015260840161039b565b50505050565b6104e0838383610a0e565b505050565b60006001600160a01b03821661054f5760405162461bcd60e51b815260206004820152602960248201527f526f6f744d696e7461626c6545524332305072656469636174653a20494e56416044820152682624a22faa27a5a2a760b91b606482015260840161039b565b6001600160a01b0382811660009081526037602052604090205416156105ca5760405162461bcd60e51b815260206004820152602a60248201527f526f6f744d696e7461626c6545524332305072656469636174653a20414c524560448201526910511657d3505414115160b21b606482015260840161039b565b6035546036546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b039283169260009261067892911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b0385811660008181526037602052604080822080546001600160a01b03191686861617905560335481516306fdde0360e01b81529151959650909316936316f198319387937f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad938b9391926306fdde0392600480830193928290030181865afa158015610710573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526107389190810190611231565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610776573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261079e9190810190611231565b8a6001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107dc573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061080091906112d3565b604051602001610814959493929190611322565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610840929190611374565b600060405180830381600087803b15801561085a57600080fd5b505af115801561086e573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a39392505050565b336002600160a01b03146108f55760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b604482015260640161039b565b600054610100900460ff16158080156109155750600054600160ff909116105b8061092f5750303b15801561092f575060005460ff166001145b6109925760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161039b565b6000805460ff1916600117905580156109b5576000805461ff0019166101001790555b6109c185858585610c36565b8015610a07576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6001600160a01b038084166000908152603760205260409020541680610a3a57610a37846104e5565b90505b6001600160a01b038116610a5057610a50611398565b610a656001600160a01b038516333085610d31565b603354603554604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b0388811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610af09391169160c401611374565b600060405180830381600087803b158015610b0a57600080fd5b505af1158015610b1e573d6000803e3d6000fd5b50505050826001600160a01b0316816001600160a01b0316856001600160a01b03167f1666a3f7b8a7494f2ebcebe646a5187ae55b1db3a068097377d90cd64a258ce93386604051610b719291906113ae565b60405180910390a46104cf565b6000808080610b8f858701876113c7565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610bc257610bc2611398565b610bd66001600160a01b0386168484610d9c565b826001600160a01b0316816001600160a01b0316866001600160a01b03167fb9f935478aae5b1da868de596dafe0a2b41eeb61311fdd60c6dbbe46a1debee88786604051610c259291906113ae565b60405180910390a450505050505050565b6001600160a01b03841615801590610c5657506001600160a01b03831615155b8015610c6a57506001600160a01b03821615155b8015610c7e57506001600160a01b03811615155b610ce15760405162461bcd60e51b815260206004820152602e60248201527f526f6f744d696e7461626c6545524332305072656469636174653a204241445f60448201526d24a724aa24a0a624ad20aa24a7a760911b606482015260840161039b565b603380546001600160a01b039586166001600160a01b0319918216179091556034805494861694821694909417909355603580549285169284169290921790915560368054919093169116179055565b6040516001600160a01b03808516602483015283166044820152606481018290526104cf9085906323b872dd60e01b906084015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152610dbb565b6104e08363a9059cbb60e01b8484604051602401610d659291906113ae565b6000610e10826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316610e909092919063ffffffff16565b9050805160001480610e31575080806020019051810190610e319190611418565b6104e05760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b606482015260840161039b565b6060610e9f8484600085610ea7565b949350505050565b606082471015610f085760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b606482015260840161039b565b600080866001600160a01b03168587604051610f24919061143a565b60006040518083038185875af1925050503d8060008114610f61576040519150601f19603f3d011682016040523d82523d6000602084013e610f66565b606091505b5091509150610f7787838387610f82565b979650505050505050565b60608315610ff1578251600003610fea576001600160a01b0385163b610fea5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161039b565b5081610e9f565b610e9f83838151156110065781518083602001fd5b8060405162461bcd60e51b815260040161039b9190611456565b6001600160a01b038116811461103557600080fd5b50565b6000806040838503121561104b57600080fd5b823561105681611020565b946020939093013593505050565b60006020828403121561107657600080fd5b813561108181611020565b9392505050565b6000806000806060858703121561109e57600080fd5b8435935060208501356110b081611020565b9250604085013567ffffffffffffffff808211156110cd57600080fd5b818701915087601f8301126110e157600080fd5b8135818111156110f057600080fd5b88602082850101111561110257600080fd5b95989497505060200194505050565b60008060006060848603121561112657600080fd5b833561113181611020565b9250602084013561114181611020565b929592945050506040919091013590565b6000806000806080858703121561116857600080fd5b843561117381611020565b9350602085013561118381611020565b9250604085013561119381611020565b915060608501356111a381611020565b939692955090935050565b600080858511156111be57600080fd5b838611156111cb57600080fd5b5050820193919092039150565b803560208310156111f157600019602084900360031b1b165b92915050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015611228578181015183820152602001611210565b50506000910152565b60006020828403121561124357600080fd5b815167ffffffffffffffff8082111561125b57600080fd5b818401915084601f83011261126f57600080fd5b815181811115611281576112816111f7565b604051601f8201601f19908116603f011681019083821181831017156112a9576112a96111f7565b816040528281528760208487010111156112c257600080fd5b610f7783602083016020880161120d565b6000602082840312156112e557600080fd5b815160ff8116811461108157600080fd5b6000815180845261130e81602086016020860161120d565b601f01601f19169290920160200192915050565b8581526001600160a01b038516602082015260a06040820181905260009061134c908301866112f6565b828103606084015261135e81866112f6565b91505060ff831660808301529695505050505050565b6001600160a01b0383168152604060208201819052600090610e9f908301846112f6565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b600080600080608085870312156113dd57600080fd5b84356113e881611020565b935060208501356113f881611020565b9250604085013561140881611020565b9396929550929360600135925050565b60006020828403121561142a57600080fd5b8151801515811461108157600080fd5b6000825161144c81846020870161120d565b9190910192915050565b60208152600061108160208301846112f656fea264697066735822122084ec8ad36f0d03abcfc5bde4447836ff970764edfea496ff308f22046530682b64736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101425760003560e01c806397e5230d116100b8578063e0563ab11161007c578063e0563ab1146102a2578063eeb49945146102ab578063f213159c146102be578063f4a120f7146102d1578063f6451255146102e4578063f8c8765e1461030b57600080fd5b806397e5230d14610224578063b17680651461022e578063b68ad1e414610255578063d41f177114610268578063d57184e41461028f57600080fd5b806347e7ef241161010a57806347e7ef24146101aa57806351351d53146101bf57806355b01e4d146101cd5780635ea5df79146101db5780637efab4f5146101f2578063947287cf1461021b57600080fd5b806305dc2e8f1461014757806307b3e252146101775780631bc114ba14610185578063284017f5146101985780633b878c22146101a1575b600080fd5b60345461015a906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b61015a6004600360981b0181565b60335461015a906001600160a01b031681565b61015a61202081565b61015a61101081565b6101bd6101b8366004611038565b61031e565b005b61015a6002600160a01b0381565b61015a6004600160991b0181565b6101e461138881565b60405190815260200161016e565b61015a610200366004611064565b6037602052600090815260409020546001600160a01b031681565b6101e461520881565b6101e4620249f081565b6101e47f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60365461015a906001600160a01b031681565b6101e47f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b60355461015a906001600160a01b031681565b61015a61203081565b6101bd6102b9366004611088565b61032d565b6101bd6102cc366004611111565b6104d5565b61015a6102df366004611064565b6104e5565b6101e47f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6101bd610319366004611152565b6108b1565b610329823383610a0e565b5050565b6034546001600160a01b031633146103a45760405162461bcd60e51b815260206004820152602f60248201527f526f6f744d696e7461626c6545524332305072656469636174653a204f4e4c5960448201526e2fa9aa20aa22afa922a1a2a4ab22a960891b60648201526084015b60405180910390fd5b6035546001600160a01b0384811691161461041a5760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c6545524332305072656469636174653a204f4e4c5960448201526f5f4348494c445f50524544494341544560801b606482015260840161039b565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e9828696104496020600084866111ae565b610452916111d8565b036104715761046c61046782602081866111ae565b610b7e565b6104cf565b60405162461bcd60e51b815260206004820152602d60248201527f526f6f744d696e7461626c6545524332305072656469636174653a20494e564160448201526c4c49445f5349474e415455524560981b606482015260840161039b565b50505050565b6104e0838383610a0e565b505050565b60006001600160a01b03821661054f5760405162461bcd60e51b815260206004820152602960248201527f526f6f744d696e7461626c6545524332305072656469636174653a20494e56416044820152682624a22faa27a5a2a760b91b606482015260840161039b565b6001600160a01b0382811660009081526037602052604090205416156105ca5760405162461bcd60e51b815260206004820152602a60248201527f526f6f744d696e7461626c6545524332305072656469636174653a20414c524560448201526910511657d3505414115160b21b606482015260840161039b565b6035546036546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b039283169260009261067892911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b0385811660008181526037602052604080822080546001600160a01b03191686861617905560335481516306fdde0360e01b81529151959650909316936316f198319387937f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad938b9391926306fdde0392600480830193928290030181865afa158015610710573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526107389190810190611231565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610776573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261079e9190810190611231565b8a6001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107dc573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061080091906112d3565b604051602001610814959493929190611322565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610840929190611374565b600060405180830381600087803b15801561085a57600080fd5b505af115801561086e573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a39392505050565b336002600160a01b03146108f55760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b604482015260640161039b565b600054610100900460ff16158080156109155750600054600160ff909116105b8061092f5750303b15801561092f575060005460ff166001145b6109925760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161039b565b6000805460ff1916600117905580156109b5576000805461ff0019166101001790555b6109c185858585610c36565b8015610a07576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6001600160a01b038084166000908152603760205260409020541680610a3a57610a37846104e5565b90505b6001600160a01b038116610a5057610a50611398565b610a656001600160a01b038516333085610d31565b603354603554604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b0388811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610af09391169160c401611374565b600060405180830381600087803b158015610b0a57600080fd5b505af1158015610b1e573d6000803e3d6000fd5b50505050826001600160a01b0316816001600160a01b0316856001600160a01b03167f1666a3f7b8a7494f2ebcebe646a5187ae55b1db3a068097377d90cd64a258ce93386604051610b719291906113ae565b60405180910390a46104cf565b6000808080610b8f858701876113c7565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610bc257610bc2611398565b610bd66001600160a01b0386168484610d9c565b826001600160a01b0316816001600160a01b0316866001600160a01b03167fb9f935478aae5b1da868de596dafe0a2b41eeb61311fdd60c6dbbe46a1debee88786604051610c259291906113ae565b60405180910390a450505050505050565b6001600160a01b03841615801590610c5657506001600160a01b03831615155b8015610c6a57506001600160a01b03821615155b8015610c7e57506001600160a01b03811615155b610ce15760405162461bcd60e51b815260206004820152602e60248201527f526f6f744d696e7461626c6545524332305072656469636174653a204241445f60448201526d24a724aa24a0a624ad20aa24a7a760911b606482015260840161039b565b603380546001600160a01b039586166001600160a01b0319918216179091556034805494861694821694909417909355603580549285169284169290921790915560368054919093169116179055565b6040516001600160a01b03808516602483015283166044820152606481018290526104cf9085906323b872dd60e01b906084015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152610dbb565b6104e08363a9059cbb60e01b8484604051602401610d659291906113ae565b6000610e10826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316610e909092919063ffffffff16565b9050805160001480610e31575080806020019051810190610e319190611418565b6104e05760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b606482015260840161039b565b6060610e9f8484600085610ea7565b949350505050565b606082471015610f085760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b606482015260840161039b565b600080866001600160a01b03168587604051610f24919061143a565b60006040518083038185875af1925050503d8060008114610f61576040519150601f19603f3d011682016040523d82523d6000602084013e610f66565b606091505b5091509150610f7787838387610f82565b979650505050505050565b60608315610ff1578251600003610fea576001600160a01b0385163b610fea5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161039b565b5081610e9f565b610e9f83838151156110065781518083602001fd5b8060405162461bcd60e51b815260040161039b9190611456565b6001600160a01b038116811461103557600080fd5b50565b6000806040838503121561104b57600080fd5b823561105681611020565b946020939093013593505050565b60006020828403121561107657600080fd5b813561108181611020565b9392505050565b6000806000806060858703121561109e57600080fd5b8435935060208501356110b081611020565b9250604085013567ffffffffffffffff808211156110cd57600080fd5b818701915087601f8301126110e157600080fd5b8135818111156110f057600080fd5b88602082850101111561110257600080fd5b95989497505060200194505050565b60008060006060848603121561112657600080fd5b833561113181611020565b9250602084013561114181611020565b929592945050506040919091013590565b6000806000806080858703121561116857600080fd5b843561117381611020565b9350602085013561118381611020565b9250604085013561119381611020565b915060608501356111a381611020565b939692955090935050565b600080858511156111be57600080fd5b838611156111cb57600080fd5b5050820193919092039150565b803560208310156111f157600019602084900360031b1b165b92915050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015611228578181015183820152602001611210565b50506000910152565b60006020828403121561124357600080fd5b815167ffffffffffffffff8082111561125b57600080fd5b818401915084601f83011261126f57600080fd5b815181811115611281576112816111f7565b604051601f8201601f19908116603f011681019083821181831017156112a9576112a96111f7565b816040528281528760208487010111156112c257600080fd5b610f7783602083016020880161120d565b6000602082840312156112e557600080fd5b815160ff8116811461108157600080fd5b6000815180845261130e81602086016020860161120d565b601f01601f19169290920160200192915050565b8581526001600160a01b038516602082015260a06040820181905260009061134c908301866112f6565b828103606084015261135e81866112f6565b91505060ff831660808301529695505050505050565b6001600160a01b0383168152604060208201819052600090610e9f908301846112f6565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b600080600080608085870312156113dd57600080fd5b84356113e881611020565b935060208501356113f881611020565b9250604085013561140881611020565b9396929550929360600135925050565b60006020828403121561142a57600080fd5b8151801515811461108157600080fd5b6000825161144c81846020870161120d565b9190910192915050565b60208152600061108160208301846112f656fea264697066735822122084ec8ad36f0d03abcfc5bde4447836ff970764edfea496ff308f22046530682b64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RootMintableERC20PredicateACLArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RootMintableERC20PredicateAccessList","sourceName":"contracts/child/RootMintableERC20PredicateAccessList.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"AllowListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"BlockListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"depositor","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2MintableERC20Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2MintableERC20Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2MintableTokenMapped","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"childERC20Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC20Metadata","name":"rootToken","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20Metadata","name":"rootToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"depositTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newChildERC20Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"},{"internalType":"bool","name":"newUseAllowList","type":"bool"},{"internalType":"bool","name":"newUseBlockList","type":"bool"},{"internalType":"address","name":"newOwner","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newChildERC20Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC20Metadata","name":"rootToken","type":"address"}],"name":"mapToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseAllowList","type":"bool"}],"name":"setAllowList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseBlockList","type":"bool"}],"name":"setBlockList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611bfb806100206000396000f3fe608060405234801561001057600080fd5b506004361061019a5760003560e01c8063b1768065116100e4578063e0563ab111610092578063e0563ab114610355578063e30c39781461035e578063eeb499451461036f578063f213159c14610382578063f2fde38b14610395578063f4a120f7146103a8578063f6451255146103bb578063f8c8765e146103e257600080fd5b8063b1768065146102a8578063b68ad1e4146102cf578063c1225a20146102e2578063c5e4683a146102f5578063d41f177114610308578063d57184e41461032f578063d8dd17731461034257600080fd5b806355b01e4d1161014c57806355b01e4d146102255780635ea5df7914610233578063715018a61461024a57806379ba5097146102525780637efab4f51461025a5780638da5cb5b14610284578063947287cf1461029557806397e5230d1461029e57600080fd5b806305dc2e8f1461019f57806307b3e252146101cf5780631bc114ba146101dd578063284017f5146101f05780633b878c22146101f957806347e7ef241461020257806351351d5314610217575b600080fd5b60fd546101b2906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101b26004600360981b0181565b60fc546101b2906001600160a01b031681565b6101b261202081565b6101b261101081565b61021561021036600461164d565b6103f5565b005b6101b26002600160a01b0381565b6101b26004600160991b0181565b61023c61138881565b6040519081526020016101c6565b610215610404565b610215610418565b6101b2610268366004611679565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b03166101b2565b61023c61520881565b61023c620249f081565b61023c7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff546101b2906001600160a01b031681565b6102156102f03660046116ab565b610497565b6102156103033660046116ab565b6104e6565b61023c7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b60fe546101b2906001600160a01b031681565b6102156103503660046116c8565b61052d565b6101b261203081565b6065546001600160a01b03166101b2565b61021561037d36600461175e565b61064e565b6102156103903660046117e7565b6107f1565b6102156103a3366004611679565b610801565b6101b26103b6366004611679565b610872565b61023c7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6102156103f0366004611828565b610c40565b610400823383610d39565b5050565b61040c610eb2565b6104166000610f0c565b565b60655433906001600160a01b0316811461048b5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61049481610f0c565b50565b61049f610eb2565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b6104ee610eb2565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b03146105545760405163973d02cb60e01b815260040161048290611884565b600054610100900460ff16158080156105745750600054600160ff909116105b8061058e5750303b15801561058e575060005460ff166001145b6105aa5760405162461bcd60e51b8152600401610482906118a8565b6000805460ff1916600117905580156105cd576000805461ff0019166101001790555b6105d988888888610f25565b60c9805461ffff191685151561ff00191617610100851515021790556105fe82610f0c565b8015610644576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146106c05760405162461bcd60e51b815260206004820152602f60248201527f526f6f744d696e7461626c6545524332305072656469636174653a204f4e4c5960448201526e2fa9aa20aa22afa922a1a2a4ab22a960891b6064820152608401610482565b60fe546001600160a01b038481169116146107365760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c6545524332305072656469636174653a204f4e4c5960448201526f5f4348494c445f50524544494341544560801b6064820152608401610482565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e9828696107656020600084866118f6565b61076e91611920565b0361078d5761078861078382602081866118f6565b611020565b6107eb565b60405162461bcd60e51b815260206004820152602d60248201527f526f6f744d696e7461626c6545524332305072656469636174653a20494e564160448201526c4c49445f5349474e415455524560981b6064820152608401610482565b50505050565b6107fc838383610d39565b505050565b610809610eb2565b606580546001600160a01b0383166001600160a01b0319909116811790915561083a6033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60006001600160a01b0382166108dc5760405162461bcd60e51b815260206004820152602960248201527f526f6f744d696e7461626c6545524332305072656469636174653a20494e56416044820152682624a22faa27a5a2a760b91b6064820152608401610482565b6001600160a01b038281166000908152610100602052604090205416156109585760405162461bcd60e51b815260206004820152602a60248201527f526f6f744d696e7461626c6545524332305072656469636174653a20414c524560448201526910511657d3505414115160b21b6064820152608401610482565b60fe5460ff546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b0392831692600092610a0692911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b038581166000818152610100602052604080822080546001600160a01b03191686861617905560fc5481516306fdde0360e01b81529151959650909316936316f198319387937f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad938b9391926306fdde0392600480830193928290030181865afa158015610a9f573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610ac79190810190611979565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610b05573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610b2d9190810190611979565b8a6001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b6b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b8f9190611a1b565b604051602001610ba3959493929190611a6a565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610bcf929190611abc565b600060405180830381600087803b158015610be957600080fd5b505af1158015610bfd573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a39392505050565b336002600160a01b0314610c675760405163973d02cb60e01b815260040161048290611884565b600054610100900460ff1615808015610c875750600054600160ff909116105b80610ca15750303b158015610ca1575060005460ff166001145b610cbd5760405162461bcd60e51b8152600401610482906118a8565b6000805460ff191660011790558015610ce0576000805461ff0019166101001790555b610cec85858585610f25565b8015610d32576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b610d416110d9565b6001600160a01b03808416600090815261010060205260409020541680610d6e57610d6b84610872565b90505b6001600160a01b038116610d8457610d84611ae0565b610d996001600160a01b0385163330856110e1565b60fc5460fe54604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b0388811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610e249391169160c401611abc565b600060405180830381600087803b158015610e3e57600080fd5b505af1158015610e52573d6000803e3d6000fd5b50505050826001600160a01b0316816001600160a01b0316856001600160a01b03167f1666a3f7b8a7494f2ebcebe646a5187ae55b1db3a068097377d90cd64a258ce93386604051610ea5929190611af6565b60405180910390a46107eb565b6033546001600160a01b031633146104165760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610482565b606580546001600160a01b03191690556104948161114c565b6001600160a01b03841615801590610f4557506001600160a01b03831615155b8015610f5957506001600160a01b03821615155b8015610f6d57506001600160a01b03811615155b610fd05760405162461bcd60e51b815260206004820152602e60248201527f526f6f744d696e7461626c6545524332305072656469636174653a204241445f60448201526d24a724aa24a0a624ad20aa24a7a760911b6064820152608401610482565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b600080808061103185870187611b0f565b6001600160a01b03808516600090815261010060205260409020549498509296509094509250168061106557611065611ae0565b6110796001600160a01b038616848461119e565b826001600160a01b0316816001600160a01b0316866001600160a01b03167fb9f935478aae5b1da868de596dafe0a2b41eeb61311fdd60c6dbbe46a1debee887866040516110c8929190611af6565b60405180910390a450505050505050565b6104166111bd565b6040516001600160a01b03808516602483015283166044820152606481018290526107eb9085906323b872dd60e01b906084015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b0319909316929092179091526113d3565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6107fc8363a9059cbb60e01b8484604051602401611115929190611af6565b60c95460ff16156112c857604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161121f9190611b60565b6000604051808303818686fa925050503d806000811461125b576040519150601f19603f3d011682016040523d82523d6000602084013e611260565b606091505b509150915081801561128557506000818060200190518101906112839190611b7c565b115b6112c55760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b6044820152606401610482565b50505b60c954610100900460ff161561041657604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b01916113889161132f9190611b60565b6000604051808303818686fa925050503d806000811461136b576040519150601f19603f3d011682016040523d82523d6000602084013e611370565b606091505b50915091508180156113965750808060200190518101906113919190611b7c565b600114155b6104005760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b6044820152606401610482565b6000611428826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166114a89092919063ffffffff16565b90508051600014806114495750808060200190518101906114499190611b95565b6107fc5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610482565b60606114b784846000856114bf565b949350505050565b6060824710156115205760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610482565b600080866001600160a01b0316858760405161153c9190611b60565b60006040518083038185875af1925050503d8060008114611579576040519150601f19603f3d011682016040523d82523d6000602084013e61157e565b606091505b509150915061158f8783838761159a565b979650505050505050565b60608315611609578251600003611602576001600160a01b0385163b6116025760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610482565b50816114b7565b6114b7838381511561161e5781518083602001fd5b8060405162461bcd60e51b81526004016104829190611bb2565b6001600160a01b038116811461049457600080fd5b6000806040838503121561166057600080fd5b823561166b81611638565b946020939093013593505050565b60006020828403121561168b57600080fd5b813561169681611638565b9392505050565b801515811461049457600080fd5b6000602082840312156116bd57600080fd5b81356116968161169d565b600080600080600080600060e0888a0312156116e357600080fd5b87356116ee81611638565b965060208801356116fe81611638565b9550604088013561170e81611638565b9450606088013561171e81611638565b9350608088013561172e8161169d565b925060a088013561173e8161169d565b915060c088013561174e81611638565b8091505092959891949750929550565b6000806000806060858703121561177457600080fd5b84359350602085013561178681611638565b9250604085013567ffffffffffffffff808211156117a357600080fd5b818701915087601f8301126117b757600080fd5b8135818111156117c657600080fd5b8860208285010111156117d857600080fd5b95989497505060200194505050565b6000806000606084860312156117fc57600080fd5b833561180781611638565b9250602084013561181781611638565b929592945050506040919091013590565b6000806000806080858703121561183e57600080fd5b843561184981611638565b9350602085013561185981611638565b9250604085013561186981611638565b9150606085013561187981611638565b939692955090935050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b6000808585111561190657600080fd5b8386111561191357600080fd5b5050820193919092039150565b8035602083101561193957600019602084900360031b1b165b92915050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015611970578181015183820152602001611958565b50506000910152565b60006020828403121561198b57600080fd5b815167ffffffffffffffff808211156119a357600080fd5b818401915084601f8301126119b757600080fd5b8151818111156119c9576119c961193f565b604051601f8201601f19908116603f011681019083821181831017156119f1576119f161193f565b81604052828152876020848701011115611a0a57600080fd5b61158f836020830160208801611955565b600060208284031215611a2d57600080fd5b815160ff8116811461169657600080fd5b60008151808452611a56816020860160208601611955565b601f01601f19169290920160200192915050565b8581526001600160a01b038516602082015260a060408201819052600090611a9490830186611a3e565b8281036060840152611aa68186611a3e565b91505060ff831660808301529695505050505050565b6001600160a01b03831681526040602082018190526000906114b790830184611a3e565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b60008060008060808587031215611b2557600080fd5b8435611b3081611638565b93506020850135611b4081611638565b92506040850135611b5081611638565b9396929550929360600135925050565b60008251611b72818460208701611955565b9190910192915050565b600060208284031215611b8e57600080fd5b5051919050565b600060208284031215611ba757600080fd5b81516116968161169d565b6020815260006116966020830184611a3e56fea2646970667358221220176d1307d83cd6036f83b91e4ae24d7832bdefc3a6d526f5cfd719424ef4671864736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b506004361061019a5760003560e01c8063b1768065116100e4578063e0563ab111610092578063e0563ab114610355578063e30c39781461035e578063eeb499451461036f578063f213159c14610382578063f2fde38b14610395578063f4a120f7146103a8578063f6451255146103bb578063f8c8765e146103e257600080fd5b8063b1768065146102a8578063b68ad1e4146102cf578063c1225a20146102e2578063c5e4683a146102f5578063d41f177114610308578063d57184e41461032f578063d8dd17731461034257600080fd5b806355b01e4d1161014c57806355b01e4d146102255780635ea5df7914610233578063715018a61461024a57806379ba5097146102525780637efab4f51461025a5780638da5cb5b14610284578063947287cf1461029557806397e5230d1461029e57600080fd5b806305dc2e8f1461019f57806307b3e252146101cf5780631bc114ba146101dd578063284017f5146101f05780633b878c22146101f957806347e7ef241461020257806351351d5314610217575b600080fd5b60fd546101b2906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101b26004600360981b0181565b60fc546101b2906001600160a01b031681565b6101b261202081565b6101b261101081565b61021561021036600461164d565b6103f5565b005b6101b26002600160a01b0381565b6101b26004600160991b0181565b61023c61138881565b6040519081526020016101c6565b610215610404565b610215610418565b6101b2610268366004611679565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b03166101b2565b61023c61520881565b61023c620249f081565b61023c7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff546101b2906001600160a01b031681565b6102156102f03660046116ab565b610497565b6102156103033660046116ab565b6104e6565b61023c7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b60fe546101b2906001600160a01b031681565b6102156103503660046116c8565b61052d565b6101b261203081565b6065546001600160a01b03166101b2565b61021561037d36600461175e565b61064e565b6102156103903660046117e7565b6107f1565b6102156103a3366004611679565b610801565b6101b26103b6366004611679565b610872565b61023c7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6102156103f0366004611828565b610c40565b610400823383610d39565b5050565b61040c610eb2565b6104166000610f0c565b565b60655433906001600160a01b0316811461048b5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61049481610f0c565b50565b61049f610eb2565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b6104ee610eb2565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b03146105545760405163973d02cb60e01b815260040161048290611884565b600054610100900460ff16158080156105745750600054600160ff909116105b8061058e5750303b15801561058e575060005460ff166001145b6105aa5760405162461bcd60e51b8152600401610482906118a8565b6000805460ff1916600117905580156105cd576000805461ff0019166101001790555b6105d988888888610f25565b60c9805461ffff191685151561ff00191617610100851515021790556105fe82610f0c565b8015610644576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146106c05760405162461bcd60e51b815260206004820152602f60248201527f526f6f744d696e7461626c6545524332305072656469636174653a204f4e4c5960448201526e2fa9aa20aa22afa922a1a2a4ab22a960891b6064820152608401610482565b60fe546001600160a01b038481169116146107365760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c6545524332305072656469636174653a204f4e4c5960448201526f5f4348494c445f50524544494341544560801b6064820152608401610482565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e9828696107656020600084866118f6565b61076e91611920565b0361078d5761078861078382602081866118f6565b611020565b6107eb565b60405162461bcd60e51b815260206004820152602d60248201527f526f6f744d696e7461626c6545524332305072656469636174653a20494e564160448201526c4c49445f5349474e415455524560981b6064820152608401610482565b50505050565b6107fc838383610d39565b505050565b610809610eb2565b606580546001600160a01b0383166001600160a01b0319909116811790915561083a6033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60006001600160a01b0382166108dc5760405162461bcd60e51b815260206004820152602960248201527f526f6f744d696e7461626c6545524332305072656469636174653a20494e56416044820152682624a22faa27a5a2a760b91b6064820152608401610482565b6001600160a01b038281166000908152610100602052604090205416156109585760405162461bcd60e51b815260206004820152602a60248201527f526f6f744d696e7461626c6545524332305072656469636174653a20414c524560448201526910511657d3505414115160b21b6064820152608401610482565b60fe5460ff546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b0392831692600092610a0692911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b038581166000818152610100602052604080822080546001600160a01b03191686861617905560fc5481516306fdde0360e01b81529151959650909316936316f198319387937f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad938b9391926306fdde0392600480830193928290030181865afa158015610a9f573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610ac79190810190611979565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610b05573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610b2d9190810190611979565b8a6001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b6b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b8f9190611a1b565b604051602001610ba3959493929190611a6a565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610bcf929190611abc565b600060405180830381600087803b158015610be957600080fd5b505af1158015610bfd573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a39392505050565b336002600160a01b0314610c675760405163973d02cb60e01b815260040161048290611884565b600054610100900460ff1615808015610c875750600054600160ff909116105b80610ca15750303b158015610ca1575060005460ff166001145b610cbd5760405162461bcd60e51b8152600401610482906118a8565b6000805460ff191660011790558015610ce0576000805461ff0019166101001790555b610cec85858585610f25565b8015610d32576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b610d416110d9565b6001600160a01b03808416600090815261010060205260409020541680610d6e57610d6b84610872565b90505b6001600160a01b038116610d8457610d84611ae0565b610d996001600160a01b0385163330856110e1565b60fc5460fe54604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b0388811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610e249391169160c401611abc565b600060405180830381600087803b158015610e3e57600080fd5b505af1158015610e52573d6000803e3d6000fd5b50505050826001600160a01b0316816001600160a01b0316856001600160a01b03167f1666a3f7b8a7494f2ebcebe646a5187ae55b1db3a068097377d90cd64a258ce93386604051610ea5929190611af6565b60405180910390a46107eb565b6033546001600160a01b031633146104165760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610482565b606580546001600160a01b03191690556104948161114c565b6001600160a01b03841615801590610f4557506001600160a01b03831615155b8015610f5957506001600160a01b03821615155b8015610f6d57506001600160a01b03811615155b610fd05760405162461bcd60e51b815260206004820152602e60248201527f526f6f744d696e7461626c6545524332305072656469636174653a204241445f60448201526d24a724aa24a0a624ad20aa24a7a760911b6064820152608401610482565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b600080808061103185870187611b0f565b6001600160a01b03808516600090815261010060205260409020549498509296509094509250168061106557611065611ae0565b6110796001600160a01b038616848461119e565b826001600160a01b0316816001600160a01b0316866001600160a01b03167fb9f935478aae5b1da868de596dafe0a2b41eeb61311fdd60c6dbbe46a1debee887866040516110c8929190611af6565b60405180910390a450505050505050565b6104166111bd565b6040516001600160a01b03808516602483015283166044820152606481018290526107eb9085906323b872dd60e01b906084015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b0319909316929092179091526113d3565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6107fc8363a9059cbb60e01b8484604051602401611115929190611af6565b60c95460ff16156112c857604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161121f9190611b60565b6000604051808303818686fa925050503d806000811461125b576040519150601f19603f3d011682016040523d82523d6000602084013e611260565b606091505b509150915081801561128557506000818060200190518101906112839190611b7c565b115b6112c55760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b6044820152606401610482565b50505b60c954610100900460ff161561041657604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b01916113889161132f9190611b60565b6000604051808303818686fa925050503d806000811461136b576040519150601f19603f3d011682016040523d82523d6000602084013e611370565b606091505b50915091508180156113965750808060200190518101906113919190611b7c565b600114155b6104005760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b6044820152606401610482565b6000611428826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166114a89092919063ffffffff16565b90508051600014806114495750808060200190518101906114499190611b95565b6107fc5760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610482565b60606114b784846000856114bf565b949350505050565b6060824710156115205760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610482565b600080866001600160a01b0316858760405161153c9190611b60565b60006040518083038185875af1925050503d8060008114611579576040519150601f19603f3d011682016040523d82523d6000602084013e61157e565b606091505b509150915061158f8783838761159a565b979650505050505050565b60608315611609578251600003611602576001600160a01b0385163b6116025760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610482565b50816114b7565b6114b7838381511561161e5781518083602001fd5b8060405162461bcd60e51b81526004016104829190611bb2565b6001600160a01b038116811461049457600080fd5b6000806040838503121561166057600080fd5b823561166b81611638565b946020939093013593505050565b60006020828403121561168b57600080fd5b813561169681611638565b9392505050565b801515811461049457600080fd5b6000602082840312156116bd57600080fd5b81356116968161169d565b600080600080600080600060e0888a0312156116e357600080fd5b87356116ee81611638565b965060208801356116fe81611638565b9550604088013561170e81611638565b9450606088013561171e81611638565b9350608088013561172e8161169d565b925060a088013561173e8161169d565b915060c088013561174e81611638565b8091505092959891949750929550565b6000806000806060858703121561177457600080fd5b84359350602085013561178681611638565b9250604085013567ffffffffffffffff808211156117a357600080fd5b818701915087601f8301126117b757600080fd5b8135818111156117c657600080fd5b8860208285010111156117d857600080fd5b95989497505060200194505050565b6000806000606084860312156117fc57600080fd5b833561180781611638565b9250602084013561181781611638565b929592945050506040919091013590565b6000806000806080858703121561183e57600080fd5b843561184981611638565b9350602085013561185981611638565b9250604085013561186981611638565b9150606085013561187981611638565b939692955090935050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b6000808585111561190657600080fd5b8386111561191357600080fd5b5050820193919092039150565b8035602083101561193957600019602084900360031b1b165b92915050565b634e487b7160e01b600052604160045260246000fd5b60005b83811015611970578181015183820152602001611958565b50506000910152565b60006020828403121561198b57600080fd5b815167ffffffffffffffff808211156119a357600080fd5b818401915084601f8301126119b757600080fd5b8151818111156119c9576119c961193f565b604051601f8201601f19908116603f011681019083821181831017156119f1576119f161193f565b81604052828152876020848701011115611a0a57600080fd5b61158f836020830160208801611955565b600060208284031215611a2d57600080fd5b815160ff8116811461169657600080fd5b60008151808452611a56816020860160208601611955565b601f01601f19169290920160200192915050565b8581526001600160a01b038516602082015260a060408201819052600090611a9490830186611a3e565b8281036060840152611aa68186611a3e565b91505060ff831660808301529695505050505050565b6001600160a01b03831681526040602082018190526000906114b790830184611a3e565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b60008060008060808587031215611b2557600080fd5b8435611b3081611638565b93506020850135611b4081611638565b92506040850135611b5081611638565b9396929550929360600135925050565b60008251611b72818460208701611955565b9190910192915050565b600060208284031215611b8e57600080fd5b5051919050565b600060208284031215611ba757600080fd5b81516116968161169d565b6020815260006116966020830184611a3e56fea2646970667358221220176d1307d83cd6036f83b91e4ae24d7832bdefc3a6d526f5cfd719424ef4671864736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildERC721Artifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildERC721","sourceName":"contracts/child/ChildERC721.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"userAddress","type":"address"},{"indexed":false,"internalType":"address","name":"relayerAddress","type":"address"},{"indexed":false,"internalType":"bytes","name":"functionSignature","type":"bytes"}],"name":"MetaTransactionExecuted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"burnBatch","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"userAddress","type":"address"},{"internalType":"bytes","name":"functionSignature","type":"bytes"},{"internalType":"bytes32","name":"sigR","type":"bytes32"},{"internalType":"bytes32","name":"sigS","type":"bytes32"},{"internalType":"uint8","name":"sigV","type":"uint8"}],"name":"executeMetaTransaction","outputs":[{"internalType":"bytes","name":"","type":"bytes"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"getNonce","outputs":[{"internalType":"uint256","name":"nonce","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"rootToken_","type":"address"},{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"offset","type":"uint256"}],"name":"invalidateNext","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"mint","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"mintBatch","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rootToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50612488806100206000396000f3fe608060405234801561001057600080fd5b506004361061014d5760003560e01c806370a08231116100c3578063a22cb4651161007c578063a22cb465146102de578063b2dc5dc3146102f1578063b88d4fde14610304578063c87b56dd14610317578063e61987051461032a578063e985e9c51461033c57600080fd5b806370a08231146102775780637c88e3d91461028a578063906571471461029d57806395d89b41146102b05780639b77ef11146102b85780639dc29fac146102cb57600080fd5b80631f2d0065116101155780631f2d0065146101e257806323b872dd146101f45780632d0335ab1461020757806340c10f191461023e57806342842e0e146102515780636352211e1461026457600080fd5b806301ffc9a71461015257806306fdde031461017a578063081812fc1461018f578063095ea7b3146101ba5780630c53c51c146101cf575b600080fd5b610165610160366004611a73565b61034f565b60405190151581526020015b60405180910390f35b6101826103a1565b6040516101719190611ae0565b6101a261019d366004611af3565b610433565b6040516001600160a01b039091168152602001610171565b6101cd6101c8366004611b28565b61045a565b005b6101826101dd366004611b9a565b610586565b610103546001600160a01b03166101a2565b6101cd610202366004611c19565b610864565b610230610215366004611c55565b6001600160a01b031660009081526038602052604090205490565b604051908152602001610171565b61016561024c366004611b28565b61089c565b6101cd61025f366004611c19565b6108dd565b6101a2610272366004611af3565b6108f8565b610230610285366004611c55565b61092d565b610165610298366004611cb4565b6109b3565b6101cd6102ab366004611d1f565b610a9b565b610182610d0b565b6101cd6102c6366004611af3565b610d1a565b6101656102d9366004611b28565b610d41565b6101cd6102ec366004611d9f565b610db1565b6101656102ff366004611ddb565b610dc7565b6101cd610312366004611e43565b610e75565b610182610325366004611af3565b610eb4565b610102546001600160a01b03166101a2565b61016561034a366004611f1e565b610f28565b60006001600160e01b031982166380ac58cd60e01b148061038057506001600160e01b03198216635b5e139f60e01b145b8061039b57506301ffc9a760e01b6001600160e01b03198316145b92915050565b606060d080546103b090611f51565b80601f01602080910402602001604051908101604052809291908181526020018280546103dc90611f51565b80156104295780601f106103fe57610100808354040283529160200191610429565b820191906000526020600020905b81548152906001019060200180831161040c57829003601f168201915b5050505050905090565b600061043e82610f56565b50600090815260d460205260409020546001600160a01b031690565b6000610465826108f8565b9050806001600160a01b0316836001600160a01b0316036104d75760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084015b60405180910390fd5b806001600160a01b03166104e9610f7e565b6001600160a01b0316148061050557506105058161034a610f7e565b6105775760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c00000060648201526084016104ce565b6105818383610f8d565b505050565b606060006105c987878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610ffb92505050565b90506001600160e01b031960003581169082160361064f5760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f6400000060648201526084016104ce565b604080516060810182526001600160a01b038a16600081815260386020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506106c08982888888611016565b6107165760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b60648201526084016104ce565b603860008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d60405160200161076b93929190611f8b565b60408051601f198184030181529082905261078591611fb1565b6000604051808303816000865af19150503d80600081146107c2576040519150601f19603f3d011682016040523d82523d6000602084013e6107c7565b606091505b5091509150816108195760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c0000000060448201526064016104ce565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c60405161084e9493929190611fcd565b60405180910390a19a9950505050505050505050565b61087561086f610f7e565b826110f2565b6108915760405162461bcd60e51b81526004016104ce90612019565b610581838383611150565b610102546000906001600160a01b031633146108ca5760405162461bcd60e51b81526004016104ce90612066565b6108d483836112a2565b50600192915050565b61058183838360405180602001604052806000815250610e75565b600081815260d260205260408120546001600160a01b03168061039b5760405162461bcd60e51b81526004016104ce906120aa565b60006001600160a01b0382166109975760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b60648201526084016104ce565b506001600160a01b0316600090815260d3602052604090205490565b610102546000906001600160a01b031633146109e15760405162461bcd60e51b81526004016104ce90612066565b83828114610a315760405162461bcd60e51b815260206004820152601f60248201527f4368696c644552433732313a204172726179206c656e206d69736d617463680060448201526064016104ce565b60005b81811015610a8c57610a84878783818110610a5157610a516120dc565b9050602002016020810190610a669190611c55565b868684818110610a7857610a786120dc565b905060200201356112a2565b600101610a34565b5060019150505b949350505050565b606b54610100900460ff1615808015610abb5750606b54600160ff909116105b80610ad55750303b158015610ad55750606b5460ff166001145b610b385760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016104ce565b606b805460ff191660011790558015610b5b57606b805461ff0019166101001790555b6001600160a01b03861615801590610b7257508315155b8015610b7d57508115155b610bc95760405162461bcd60e51b815260206004820152601f60248201527f4368696c644552433732313a2042616420696e697469616c697a6174696f6e0060448201526064016104ce565b61010380546001600160a01b0388166001600160a01b031991821617909155610102805490911633179055604080516020601f8701819004810282018101909252858152610c6591879087908190840183828082843760009201919091525050604080516020601f890181900481028201810190925287815292508791508690819084018382808284376000920191909152506112bc92505050565b610cbd85858080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506040805180820190915260018152603160f81b602082015291506112ed9050565b8015610d0357606b805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b606060d180546103b090611f51565b3360009081526038602052604081208054839290610d399084906120f2565b909155505050565b610102546000906001600160a01b03163314610d6f5760405162461bcd60e51b81526004016104ce90612066565b610d78826108f8565b6001600160a01b0316836001600160a01b031614610da85760405162461bcd60e51b81526004016104ce90612113565b6108d482611359565b610dc3610dbc610f7e565b83836113dc565b5050565b610102546000906001600160a01b03163314610df55760405162461bcd60e51b81526004016104ce90612066565b8160005b81811015610e69576000858583818110610e1557610e156120dc565b905060200201359050610e27816108f8565b6001600160a01b0316876001600160a01b031614610e575760405162461bcd60e51b81526004016104ce90612113565b610e6081611359565b50600101610df9565b50600195945050505050565b610e86610e80610f7e565b836110f2565b610ea25760405162461bcd60e51b81526004016104ce90612019565b610eae848484846114a6565b50505050565b6060610ebf82610f56565b6000610ed660408051602081019091526000815290565b90506000815111610ef65760405180602001604052806000815250610f21565b80610f00846114d9565b604051602001610f11929190612148565b6040516020818303038152906040525b9392505050565b6001600160a01b03918216600090815260d56020908152604080832093909416825291909152205460ff1690565b610f5f8161156b565b610f7b5760405162461bcd60e51b81526004016104ce906120aa565b50565b6000610f88611588565b905090565b600081815260d46020526040902080546001600160a01b0319166001600160a01b0384169081179091558190610fc2826108f8565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000815160000361100e57506000919050565b506020015190565b600080600161102c611027886115e4565b611661565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa15801561107a573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166110d15760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b60448201526064016104ce565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6000806110fe836108f8565b9050806001600160a01b0316846001600160a01b0316148061112557506111258185610f28565b80610a935750836001600160a01b031661113e84610433565b6001600160a01b031614949350505050565b826001600160a01b0316611163826108f8565b6001600160a01b0316146111895760405162461bcd60e51b81526004016104ce90612177565b6001600160a01b0382166111eb5760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b60648201526084016104ce565b826001600160a01b03166111fe826108f8565b6001600160a01b0316146112245760405162461bcd60e51b81526004016104ce90612177565b600081815260d46020908152604080832080546001600160a01b03199081169091556001600160a01b0387811680865260d3855283862080546000190190559087168086528386208054600101905586865260d2909452828520805490921684179091559051849360008051602061243383398151915291a4505050565b610dc382826040518060200160405280600081525061168e565b606b54610100900460ff166112e35760405162461bcd60e51b81526004016104ce906121bc565b610dc382826116c1565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f61133b818484611701565b600055600280546001600160a01b0319163017905560055550505050565b6000611364826108f8565b905061136f826108f8565b600083815260d46020908152604080832080546001600160a01b03199081169091556001600160a01b03851680855260d38452828520805460001901905587855260d290935281842080549091169055519293508492600080516020612433833981519152908390a45050565b816001600160a01b0316836001600160a01b0316036114395760405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b60448201526064016104ce565b6001600160a01b03838116600081815260d56020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6114b1848484611150565b6114bd8484848461174a565b610eae5760405162461bcd60e51b81526004016104ce90612207565b606060006114e68361184f565b60010190506000816001600160401b0381111561150557611505611e2d565b6040519080825280601f01601f19166020018201604052801561152f576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461153957509392505050565b600090815260d260205260409020546001600160a01b0316151590565b60003033036115de57600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506115e19050565b50335b90565b60006040518060800160405280604381526020016123f06043913980516020918201208351848301516040808701518051908601209051611644950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b600061039b61166e611927565b8360405161190160f01b8152600281019290925260228201526042902090565b6116988383611962565b6116a5600084848461174a565b6105815760405162461bcd60e51b81526004016104ce90612207565b606b54610100900460ff166116e85760405162461bcd60e51b81526004016104ce906121bc565b60d06116f4838261229f565b5060d1610581828261229f565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b60006001600160a01b0384163b1561184757836001600160a01b031663150b7a02611773610f7e565b8786866040518563ffffffff1660e01b8152600401611795949392919061235e565b6020604051808303816000875af19250505080156117d0575060408051601f3d908101601f191682019092526117cd9181019061239b565b60015b61182d573d8080156117fe576040519150601f19603f3d011682016040523d82523d6000602084013e611803565b606091505b5080516000036118255760405162461bcd60e51b81526004016104ce90612207565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050610a93565b506001610a93565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b831061188e5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef810000000083106118ba576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc1000083106118d857662386f26fc10000830492506010015b6305f5e10083106118f0576305f5e100830492506008015b612710831061190457612710830492506004015b60648310611916576064830492506002015b600a831061039b5760010192915050565b6002546000906001600160a01b031630148015611945575060015446145b15611951575060005490565b610f88600554600354600454611701565b6001600160a01b0382166119b85760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f206164647265737360448201526064016104ce565b6119c18161156b565b156119de5760405162461bcd60e51b81526004016104ce906123b8565b6119e78161156b565b15611a045760405162461bcd60e51b81526004016104ce906123b8565b6001600160a01b038216600081815260d3602090815260408083208054600101905584835260d290915280822080546001600160a01b031916841790555183929190600080516020612433833981519152908290a45050565b6001600160e01b031981168114610f7b57600080fd5b600060208284031215611a8557600080fd5b8135610f2181611a5d565b60005b83811015611aab578181015183820152602001611a93565b50506000910152565b60008151808452611acc816020860160208601611a90565b601f01601f19169290920160200192915050565b602081526000610f216020830184611ab4565b600060208284031215611b0557600080fd5b5035919050565b80356001600160a01b0381168114611b2357600080fd5b919050565b60008060408385031215611b3b57600080fd5b611b4483611b0c565b946020939093013593505050565b60008083601f840112611b6457600080fd5b5081356001600160401b03811115611b7b57600080fd5b602083019150836020828501011115611b9357600080fd5b9250929050565b60008060008060008060a08789031215611bb357600080fd5b611bbc87611b0c565b955060208701356001600160401b03811115611bd757600080fd5b611be389828a01611b52565b9096509450506040870135925060608701359150608087013560ff81168114611c0b57600080fd5b809150509295509295509295565b600080600060608486031215611c2e57600080fd5b611c3784611b0c565b9250611c4560208501611b0c565b9150604084013590509250925092565b600060208284031215611c6757600080fd5b610f2182611b0c565b60008083601f840112611c8257600080fd5b5081356001600160401b03811115611c9957600080fd5b6020830191508360208260051b8501011115611b9357600080fd5b60008060008060408587031215611cca57600080fd5b84356001600160401b0380821115611ce157600080fd5b611ced88838901611c70565b90965094506020870135915080821115611d0657600080fd5b50611d1387828801611c70565b95989497509550505050565b600080600080600060608688031215611d3757600080fd5b611d4086611b0c565b945060208601356001600160401b0380821115611d5c57600080fd5b611d6889838a01611b52565b90965094506040880135915080821115611d8157600080fd5b50611d8e88828901611b52565b969995985093965092949392505050565b60008060408385031215611db257600080fd5b611dbb83611b0c565b915060208301358015158114611dd057600080fd5b809150509250929050565b600080600060408486031215611df057600080fd5b611df984611b0c565b925060208401356001600160401b03811115611e1457600080fd5b611e2086828701611c70565b9497909650939450505050565b634e487b7160e01b600052604160045260246000fd5b60008060008060808587031215611e5957600080fd5b611e6285611b0c565b9350611e7060208601611b0c565b92506040850135915060608501356001600160401b0380821115611e9357600080fd5b818701915087601f830112611ea757600080fd5b813581811115611eb957611eb9611e2d565b604051601f8201601f19908116603f01168101908382118183101715611ee157611ee1611e2d565b816040528281528a6020848701011115611efa57600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b60008060408385031215611f3157600080fd5b611f3a83611b0c565b9150611f4860208401611b0c565b90509250929050565b600181811c90821680611f6557607f821691505b602082108103611f8557634e487b7160e01b600052602260045260246000fd5b50919050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b60008251611fc3818460208701611a90565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b6020808252602d908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526c1c881bdc88185c1c1c9bdd9959609a1b606082015260800190565b60208082526024908201527f4368696c644552433732313a204f6e6c79207072656469636174652063616e2060408201526318d85b1b60e21b606082015260800190565b602080825260189082015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604082015260600190565b634e487b7160e01b600052603260045260246000fd5b8082018082111561039b57634e487b7160e01b600052601160045260246000fd5b6020808252818101527f4368696c644552433732313a204f6e6c79206f776e65722063616e206275726e604082015260600190565b6000835161215a818460208801611a90565b83519083019061216e818360208801611a90565b01949350505050565b60208082526025908201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060408201526437bbb732b960d91b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b601f82111561058157600081815260208120601f850160051c810160208610156122805750805b601f850160051c820191505b81811015610d035782815560010161228c565b81516001600160401b038111156122b8576122b8611e2d565b6122cc816122c68454611f51565b84612259565b602080601f83116001811461230157600084156122e95750858301515b600019600386901b1c1916600185901b178555610d03565b600085815260208120601f198616915b8281101561233057888601518255948401946001909101908401612311565b508582101561234e5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b038581168252841660208201526040810183905260806060820181905260009061239190830184611ab4565b9695505050505050565b6000602082840312156123ad57600080fd5b8151610f2181611a5d565b6020808252601c908201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060408201526060019056fe4d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220bd40f4c587cb7d8ae1bc3b96cf69daefceacb0a939f4075b779cabc6e8e56d3964736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b506004361061014d5760003560e01c806370a08231116100c3578063a22cb4651161007c578063a22cb465146102de578063b2dc5dc3146102f1578063b88d4fde14610304578063c87b56dd14610317578063e61987051461032a578063e985e9c51461033c57600080fd5b806370a08231146102775780637c88e3d91461028a578063906571471461029d57806395d89b41146102b05780639b77ef11146102b85780639dc29fac146102cb57600080fd5b80631f2d0065116101155780631f2d0065146101e257806323b872dd146101f45780632d0335ab1461020757806340c10f191461023e57806342842e0e146102515780636352211e1461026457600080fd5b806301ffc9a71461015257806306fdde031461017a578063081812fc1461018f578063095ea7b3146101ba5780630c53c51c146101cf575b600080fd5b610165610160366004611a73565b61034f565b60405190151581526020015b60405180910390f35b6101826103a1565b6040516101719190611ae0565b6101a261019d366004611af3565b610433565b6040516001600160a01b039091168152602001610171565b6101cd6101c8366004611b28565b61045a565b005b6101826101dd366004611b9a565b610586565b610103546001600160a01b03166101a2565b6101cd610202366004611c19565b610864565b610230610215366004611c55565b6001600160a01b031660009081526038602052604090205490565b604051908152602001610171565b61016561024c366004611b28565b61089c565b6101cd61025f366004611c19565b6108dd565b6101a2610272366004611af3565b6108f8565b610230610285366004611c55565b61092d565b610165610298366004611cb4565b6109b3565b6101cd6102ab366004611d1f565b610a9b565b610182610d0b565b6101cd6102c6366004611af3565b610d1a565b6101656102d9366004611b28565b610d41565b6101cd6102ec366004611d9f565b610db1565b6101656102ff366004611ddb565b610dc7565b6101cd610312366004611e43565b610e75565b610182610325366004611af3565b610eb4565b610102546001600160a01b03166101a2565b61016561034a366004611f1e565b610f28565b60006001600160e01b031982166380ac58cd60e01b148061038057506001600160e01b03198216635b5e139f60e01b145b8061039b57506301ffc9a760e01b6001600160e01b03198316145b92915050565b606060d080546103b090611f51565b80601f01602080910402602001604051908101604052809291908181526020018280546103dc90611f51565b80156104295780601f106103fe57610100808354040283529160200191610429565b820191906000526020600020905b81548152906001019060200180831161040c57829003601f168201915b5050505050905090565b600061043e82610f56565b50600090815260d460205260409020546001600160a01b031690565b6000610465826108f8565b9050806001600160a01b0316836001600160a01b0316036104d75760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084015b60405180910390fd5b806001600160a01b03166104e9610f7e565b6001600160a01b0316148061050557506105058161034a610f7e565b6105775760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c00000060648201526084016104ce565b6105818383610f8d565b505050565b606060006105c987878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610ffb92505050565b90506001600160e01b031960003581169082160361064f5760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f6400000060648201526084016104ce565b604080516060810182526001600160a01b038a16600081815260386020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506106c08982888888611016565b6107165760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b60648201526084016104ce565b603860008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d60405160200161076b93929190611f8b565b60408051601f198184030181529082905261078591611fb1565b6000604051808303816000865af19150503d80600081146107c2576040519150601f19603f3d011682016040523d82523d6000602084013e6107c7565b606091505b5091509150816108195760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c0000000060448201526064016104ce565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c60405161084e9493929190611fcd565b60405180910390a19a9950505050505050505050565b61087561086f610f7e565b826110f2565b6108915760405162461bcd60e51b81526004016104ce90612019565b610581838383611150565b610102546000906001600160a01b031633146108ca5760405162461bcd60e51b81526004016104ce90612066565b6108d483836112a2565b50600192915050565b61058183838360405180602001604052806000815250610e75565b600081815260d260205260408120546001600160a01b03168061039b5760405162461bcd60e51b81526004016104ce906120aa565b60006001600160a01b0382166109975760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b60648201526084016104ce565b506001600160a01b0316600090815260d3602052604090205490565b610102546000906001600160a01b031633146109e15760405162461bcd60e51b81526004016104ce90612066565b83828114610a315760405162461bcd60e51b815260206004820152601f60248201527f4368696c644552433732313a204172726179206c656e206d69736d617463680060448201526064016104ce565b60005b81811015610a8c57610a84878783818110610a5157610a516120dc565b9050602002016020810190610a669190611c55565b868684818110610a7857610a786120dc565b905060200201356112a2565b600101610a34565b5060019150505b949350505050565b606b54610100900460ff1615808015610abb5750606b54600160ff909116105b80610ad55750303b158015610ad55750606b5460ff166001145b610b385760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016104ce565b606b805460ff191660011790558015610b5b57606b805461ff0019166101001790555b6001600160a01b03861615801590610b7257508315155b8015610b7d57508115155b610bc95760405162461bcd60e51b815260206004820152601f60248201527f4368696c644552433732313a2042616420696e697469616c697a6174696f6e0060448201526064016104ce565b61010380546001600160a01b0388166001600160a01b031991821617909155610102805490911633179055604080516020601f8701819004810282018101909252858152610c6591879087908190840183828082843760009201919091525050604080516020601f890181900481028201810190925287815292508791508690819084018382808284376000920191909152506112bc92505050565b610cbd85858080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506040805180820190915260018152603160f81b602082015291506112ed9050565b8015610d0357606b805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b606060d180546103b090611f51565b3360009081526038602052604081208054839290610d399084906120f2565b909155505050565b610102546000906001600160a01b03163314610d6f5760405162461bcd60e51b81526004016104ce90612066565b610d78826108f8565b6001600160a01b0316836001600160a01b031614610da85760405162461bcd60e51b81526004016104ce90612113565b6108d482611359565b610dc3610dbc610f7e565b83836113dc565b5050565b610102546000906001600160a01b03163314610df55760405162461bcd60e51b81526004016104ce90612066565b8160005b81811015610e69576000858583818110610e1557610e156120dc565b905060200201359050610e27816108f8565b6001600160a01b0316876001600160a01b031614610e575760405162461bcd60e51b81526004016104ce90612113565b610e6081611359565b50600101610df9565b50600195945050505050565b610e86610e80610f7e565b836110f2565b610ea25760405162461bcd60e51b81526004016104ce90612019565b610eae848484846114a6565b50505050565b6060610ebf82610f56565b6000610ed660408051602081019091526000815290565b90506000815111610ef65760405180602001604052806000815250610f21565b80610f00846114d9565b604051602001610f11929190612148565b6040516020818303038152906040525b9392505050565b6001600160a01b03918216600090815260d56020908152604080832093909416825291909152205460ff1690565b610f5f8161156b565b610f7b5760405162461bcd60e51b81526004016104ce906120aa565b50565b6000610f88611588565b905090565b600081815260d46020526040902080546001600160a01b0319166001600160a01b0384169081179091558190610fc2826108f8565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000815160000361100e57506000919050565b506020015190565b600080600161102c611027886115e4565b611661565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa15801561107a573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166110d15760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b60448201526064016104ce565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6000806110fe836108f8565b9050806001600160a01b0316846001600160a01b0316148061112557506111258185610f28565b80610a935750836001600160a01b031661113e84610433565b6001600160a01b031614949350505050565b826001600160a01b0316611163826108f8565b6001600160a01b0316146111895760405162461bcd60e51b81526004016104ce90612177565b6001600160a01b0382166111eb5760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b60648201526084016104ce565b826001600160a01b03166111fe826108f8565b6001600160a01b0316146112245760405162461bcd60e51b81526004016104ce90612177565b600081815260d46020908152604080832080546001600160a01b03199081169091556001600160a01b0387811680865260d3855283862080546000190190559087168086528386208054600101905586865260d2909452828520805490921684179091559051849360008051602061243383398151915291a4505050565b610dc382826040518060200160405280600081525061168e565b606b54610100900460ff166112e35760405162461bcd60e51b81526004016104ce906121bc565b610dc382826116c1565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f61133b818484611701565b600055600280546001600160a01b0319163017905560055550505050565b6000611364826108f8565b905061136f826108f8565b600083815260d46020908152604080832080546001600160a01b03199081169091556001600160a01b03851680855260d38452828520805460001901905587855260d290935281842080549091169055519293508492600080516020612433833981519152908390a45050565b816001600160a01b0316836001600160a01b0316036114395760405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b60448201526064016104ce565b6001600160a01b03838116600081815260d56020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6114b1848484611150565b6114bd8484848461174a565b610eae5760405162461bcd60e51b81526004016104ce90612207565b606060006114e68361184f565b60010190506000816001600160401b0381111561150557611505611e2d565b6040519080825280601f01601f19166020018201604052801561152f576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461153957509392505050565b600090815260d260205260409020546001600160a01b0316151590565b60003033036115de57600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506115e19050565b50335b90565b60006040518060800160405280604381526020016123f06043913980516020918201208351848301516040808701518051908601209051611644950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b600061039b61166e611927565b8360405161190160f01b8152600281019290925260228201526042902090565b6116988383611962565b6116a5600084848461174a565b6105815760405162461bcd60e51b81526004016104ce90612207565b606b54610100900460ff166116e85760405162461bcd60e51b81526004016104ce906121bc565b60d06116f4838261229f565b5060d1610581828261229f565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b60006001600160a01b0384163b1561184757836001600160a01b031663150b7a02611773610f7e565b8786866040518563ffffffff1660e01b8152600401611795949392919061235e565b6020604051808303816000875af19250505080156117d0575060408051601f3d908101601f191682019092526117cd9181019061239b565b60015b61182d573d8080156117fe576040519150601f19603f3d011682016040523d82523d6000602084013e611803565b606091505b5080516000036118255760405162461bcd60e51b81526004016104ce90612207565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050610a93565b506001610a93565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b831061188e5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef810000000083106118ba576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc1000083106118d857662386f26fc10000830492506010015b6305f5e10083106118f0576305f5e100830492506008015b612710831061190457612710830492506004015b60648310611916576064830492506002015b600a831061039b5760010192915050565b6002546000906001600160a01b031630148015611945575060015446145b15611951575060005490565b610f88600554600354600454611701565b6001600160a01b0382166119b85760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f206164647265737360448201526064016104ce565b6119c18161156b565b156119de5760405162461bcd60e51b81526004016104ce906123b8565b6119e78161156b565b15611a045760405162461bcd60e51b81526004016104ce906123b8565b6001600160a01b038216600081815260d3602090815260408083208054600101905584835260d290915280822080546001600160a01b031916841790555183929190600080516020612433833981519152908290a45050565b6001600160e01b031981168114610f7b57600080fd5b600060208284031215611a8557600080fd5b8135610f2181611a5d565b60005b83811015611aab578181015183820152602001611a93565b50506000910152565b60008151808452611acc816020860160208601611a90565b601f01601f19169290920160200192915050565b602081526000610f216020830184611ab4565b600060208284031215611b0557600080fd5b5035919050565b80356001600160a01b0381168114611b2357600080fd5b919050565b60008060408385031215611b3b57600080fd5b611b4483611b0c565b946020939093013593505050565b60008083601f840112611b6457600080fd5b5081356001600160401b03811115611b7b57600080fd5b602083019150836020828501011115611b9357600080fd5b9250929050565b60008060008060008060a08789031215611bb357600080fd5b611bbc87611b0c565b955060208701356001600160401b03811115611bd757600080fd5b611be389828a01611b52565b9096509450506040870135925060608701359150608087013560ff81168114611c0b57600080fd5b809150509295509295509295565b600080600060608486031215611c2e57600080fd5b611c3784611b0c565b9250611c4560208501611b0c565b9150604084013590509250925092565b600060208284031215611c6757600080fd5b610f2182611b0c565b60008083601f840112611c8257600080fd5b5081356001600160401b03811115611c9957600080fd5b6020830191508360208260051b8501011115611b9357600080fd5b60008060008060408587031215611cca57600080fd5b84356001600160401b0380821115611ce157600080fd5b611ced88838901611c70565b90965094506020870135915080821115611d0657600080fd5b50611d1387828801611c70565b95989497509550505050565b600080600080600060608688031215611d3757600080fd5b611d4086611b0c565b945060208601356001600160401b0380821115611d5c57600080fd5b611d6889838a01611b52565b90965094506040880135915080821115611d8157600080fd5b50611d8e88828901611b52565b969995985093965092949392505050565b60008060408385031215611db257600080fd5b611dbb83611b0c565b915060208301358015158114611dd057600080fd5b809150509250929050565b600080600060408486031215611df057600080fd5b611df984611b0c565b925060208401356001600160401b03811115611e1457600080fd5b611e2086828701611c70565b9497909650939450505050565b634e487b7160e01b600052604160045260246000fd5b60008060008060808587031215611e5957600080fd5b611e6285611b0c565b9350611e7060208601611b0c565b92506040850135915060608501356001600160401b0380821115611e9357600080fd5b818701915087601f830112611ea757600080fd5b813581811115611eb957611eb9611e2d565b604051601f8201601f19908116603f01168101908382118183101715611ee157611ee1611e2d565b816040528281528a6020848701011115611efa57600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b60008060408385031215611f3157600080fd5b611f3a83611b0c565b9150611f4860208401611b0c565b90509250929050565b600181811c90821680611f6557607f821691505b602082108103611f8557634e487b7160e01b600052602260045260246000fd5b50919050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b60008251611fc3818460208701611a90565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b6020808252602d908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526c1c881bdc88185c1c1c9bdd9959609a1b606082015260800190565b60208082526024908201527f4368696c644552433732313a204f6e6c79207072656469636174652063616e2060408201526318d85b1b60e21b606082015260800190565b602080825260189082015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604082015260600190565b634e487b7160e01b600052603260045260246000fd5b8082018082111561039b57634e487b7160e01b600052601160045260246000fd5b6020808252818101527f4368696c644552433732313a204f6e6c79206f776e65722063616e206275726e604082015260600190565b6000835161215a818460208801611a90565b83519083019061216e818360208801611a90565b01949350505050565b60208082526025908201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060408201526437bbb732b960d91b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b601f82111561058157600081815260208120601f850160051c810160208610156122805750805b601f850160051c820191505b81811015610d035782815560010161228c565b81516001600160401b038111156122b8576122b8611e2d565b6122cc816122c68454611f51565b84612259565b602080601f83116001811461230157600084156122e95750858301515b600019600386901b1c1916600185901b178555610d03565b600085815260208120601f198616915b8281101561233057888601518255948401946001909101908401612311565b508582101561234e5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b038581168252841660208201526040810183905260806060820181905260009061239190830184611ab4565b9695505050505050565b6000602082840312156123ad57600080fd5b8151610f2181611a5d565b6020808252601c908201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060408201526060019056fe4d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220bd40f4c587cb7d8ae1bc3b96cf69daefceacb0a939f4075b779cabc6e8e56d3964736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildERC721PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildERC721Predicate","sourceName":"contracts/child/ChildERC721Predicate.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"L2ERC721Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"L2ERC721DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"L2ERC721Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"L2ERC721WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2TokenMapped","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootERC721Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootERC721Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IChildERC721","name":"childToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC721","name":"childToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"withdrawBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC721","name":"childToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611fc4806100206000396000f3fe608060405234801561001057600080fd5b50600436106101585760003560e01c8063b1768065116100c3578063e0563ab11161007c578063e0563ab114610306578063eeb499451461030f578063f3fef3a314610322578063f645125514610335578063f691325c1461035c578063f8c8765e1461036f57600080fd5b8063b176806514610244578063b68ad1e41461026b578063c3b35a7e1461027e578063c5ac2b1c14610291578063d41f1771146102b8578063d7c9e3ec146102df57600080fd5b806355b01e4d1161011557806355b01e4d146101ce5780635ea5df79146101dc5780636f33e695146101f35780637efab4f514610208578063947287cf1461023157806397e5230d1461023a57600080fd5b806305dc2e8f1461015d57806307b3e2521461018d5780631bc114ba1461019b578063284017f5146101ae5780633b878c22146101b757806351351d53146101c0575b600080fd5b603454610170906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101706004600360981b0181565b603354610170906001600160a01b031681565b61017061202081565b61017061101081565b6101706002600160a01b0381565b6101706004600160991b0181565b6101e561138881565b604051908152602001610184565b61020661020136600461166f565b610382565b005b6101706102163660046116f1565b6037602052600090815260409020546001600160a01b031681565b6101e561520881565b6101e5620249f081565b6101e57f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b603654610170906001600160a01b031681565b61020661028c366004611715565b610396565b6101e57faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6101e57f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101e57f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61017061203081565b61020661031d366004611756565b6103a6565b6102066103303660046117de565b6105c9565b6101e57f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b603554610170906001600160a01b031681565b61020661037d36600461180a565b6105d8565b61038f8585858585610734565b5050505050565b6103a1838383610a98565b505050565b6034546001600160a01b031633146104175760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f53544154456044820152682fa922a1a2a4ab22a960b91b60648201526084015b60405180910390fd5b6035546001600160a01b038481169116146104865760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f524f4f545f60448201526850524544494341544560b81b606482015260840161040e565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216104b5602060008486611866565b6104be91611890565b036104dd576104d86104d38260208186611866565b610da1565b6105c3565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1861050c602060008486611866565b61051591611890565b03610524576104d88282611017565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad610553602060008486611866565b61055c91611890565b0361056b576104d8828261127d565b60405162461bcd60e51b815260206004820152602760248201527f4368696c644552433732315072656469636174653a20494e56414c49445f5349604482015266474e415455524560c81b606482015260840161040e565b50505050565b6105d4823383610a98565b5050565b336002600160a01b031461061c5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b604482015260640161040e565b600054610100900460ff161580801561063c5750600054600160ff909116105b806106565750303b158015610656575060005460ff166001145b6106b95760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161040e565b6000805460ff1916600117905580156106dc576000805461ff0019166101001790555b6106e8858585856113eb565b801561038f576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b8461073e816114e0565b61075a5760405162461bcd60e51b815260040161040e906118ae565b6000866001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561079a573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107be91906118f0565b6001600160a01b038181166000908152603760205260409020549192508881169116146107fd5760405162461bcd60e51b815260040161040e9061190d565b6001600160a01b03811661081357610813611951565b306001600160a01b0316876001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561085b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061087f91906118f0565b6001600160a01b03161461089557610895611951565b8483146108f05760405162461bcd60e51b8152602060048201526024808201527f4368696c644552433732315072656469636174653a20494e56414c49445f4c4560448201526309c8ea8960e31b606482015260840161040e565b60405163b2dc5dc360e01b81526001600160a01b0388169063b2dc5dc39061092090339088908890600401611999565b6020604051808303816000875af115801561093f573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061096391906119c7565b61097f5760405162461bcd60e51b815260040161040e906119e9565b6033546035546040516001600160a01b03928316926316f198319216906109d6907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908d908d908d908d90602001611a73565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610a02929190611b0d565b600060405180830381600087803b158015610a1c57600080fd5b505af1158015610a30573d6000803e3d6000fd5b50505050336001600160a01b0316876001600160a01b0316826001600160a01b03167fa80bc76d6e1849a9088a9c00a2aeaa54eeb78f15565a18da3e8873438976f52289898989604051610a879493929190611b39565b60405180910390a450505050505050565b82610aa2816114e0565b610abe5760405162461bcd60e51b815260040161040e906118ae565b6000846001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610afe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b2291906118f0565b6001600160a01b03818116600090815260376020526040902054919250868116911614610b615760405162461bcd60e51b815260040161040e9061190d565b6001600160a01b038116610b7757610b77611951565b306001600160a01b0316856001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610bbf573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610be391906118f0565b6001600160a01b031614610bf957610bf9611951565b604051632770a7eb60e21b81526001600160a01b03861690639dc29fac90610c279033908790600401611b6b565b6020604051808303816000875af1158015610c46573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c6a91906119c7565b610c865760405162461bcd60e51b815260040161040e906119e9565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152888116608083015260a08083018990528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610d119391169160c401611b0d565b600060405180830381600087803b158015610d2b57600080fd5b505af1158015610d3f573d6000803e3d6000fd5b50505050836001600160a01b0316856001600160a01b0316826001600160a01b03167f1e0ef6131232b1090efc3ec1cf7b53aa17f4b7cd8a4f9e033b49ee237379b0133387604051610d92929190611b6b565b60405180910390a45050505050565b6000808080610db285870187611b84565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610df55760405162461bcd60e51b815260040161040e9061190d565b610dfe816114e0565b610e0a57610e0a611951565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610e4a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e6e91906118f0565b9050856001600160a01b0316816001600160a01b031614610e9157610e91611951565b6001600160a01b038116610ea757610ea7611951565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610eef573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f1391906118f0565b6001600160a01b031614610f2957610f29611951565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610f579087908790600401611b6b565b6020604051808303816000875af1158015610f76573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f9a91906119c7565b610fb65760405162461bcd60e51b815260040161040e90611bd5565b836001600160a01b0316826001600160a01b0316876001600160a01b03167f37589fd8c906c19ea68eeb7e6b3e03efc06ff8aa4b1830588eba75f4375b16118887604051611005929190611b6b565b60405180910390a45050505050505050565b600080808061102885870187611cea565b6001600160a01b0380851660009081526037602052604090205494995092975090955093501690508061106d5760405162461bcd60e51b815260040161040e9061190d565b611076816114e0565b61108257611082611951565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156110c2573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110e691906118f0565b9050856001600160a01b0316816001600160a01b03161461110957611109611951565b6001600160a01b03811661111f5761111f611951565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015611167573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061118b91906118f0565b6001600160a01b0316146111a1576111a1611951565b604051637c88e3d960e01b81526001600160a01b03831690637c88e3d9906111cf9087908790600401611ddc565b6020604051808303816000875af11580156111ee573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061121291906119c7565b61122e5760405162461bcd60e51b815260040161040e90611bd5565b846001600160a01b0316826001600160a01b0316876001600160a01b03167fc1b1a5c1b97cc8e5ac82b47496f5ebdadf9c7d119b30a116e2bdafd56f6ed4758787604051611005929190611ddc565b6000808061128d84860186611ecf565b91955093509150506001600160a01b0383166112ab576112ab611951565b6001600160a01b0383811660009081526037602052604090205416156112d3576112d3611951565b6036546040516bffffffffffffffffffffffff19606086901b166020820152600091611323916001600160a01b039091169060340160405160208183030381529060405280519060200120611575565b6001600160a01b038581166000908152603760205260409081902080546001600160a01b031916928416928317905551639065714760e01b81529192509063906571479061137990879087908790600401611f4e565b600060405180830381600087803b15801561139357600080fd5b505af11580156113a7573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a3505050505050565b6001600160a01b0384161580159061140b57506001600160a01b03831615155b801561141f57506001600160a01b03821615155b801561143357506001600160a01b03811615155b6114905760405162461bcd60e51b815260206004820152602860248201527f4368696c644552433732315072656469636174653a204241445f494e495449416044820152672624ad20aa24a7a760c11b606482015260840161040e565b603380546001600160a01b039586166001600160a01b0319918216179091556034805494861694821694909417909355603580549285169284169290921790915560368054919093169116179055565b6000816001600160a01b03163b6000036114fc57506000919050565b6040516301ffc9a760e01b81526380ac58cd60e01b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611563575060408051601f3d908101601f19168201909252611560918101906119c7565b60015b61156f57506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b03811661156f5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b604482015260640161040e565b6001600160a01b038116811461162157600080fd5b50565b60008083601f84011261163657600080fd5b5081356001600160401b0381111561164d57600080fd5b6020830191508360208260051b850101111561166857600080fd5b9250929050565b60008060008060006060868803121561168757600080fd5b85356116928161160c565b945060208601356001600160401b03808211156116ae57600080fd5b6116ba89838a01611624565b909650945060408801359150808211156116d357600080fd5b506116e088828901611624565b969995985093965092949392505050565b60006020828403121561170357600080fd5b813561170e8161160c565b9392505050565b60008060006060848603121561172a57600080fd5b83356117358161160c565b925060208401356117458161160c565b929592945050506040919091013590565b6000806000806060858703121561176c57600080fd5b84359350602085013561177e8161160c565b925060408501356001600160401b038082111561179a57600080fd5b818701915087601f8301126117ae57600080fd5b8135818111156117bd57600080fd5b8860208285010111156117cf57600080fd5b95989497505060200194505050565b600080604083850312156117f157600080fd5b82356117fc8161160c565b946020939093013593505050565b6000806000806080858703121561182057600080fd5b843561182b8161160c565b9350602085013561183b8161160c565b9250604085013561184b8161160c565b9150606085013561185b8161160c565b939692955090935050565b6000808585111561187657600080fd5b8386111561188357600080fd5b5050820193919092039150565b8035602083101561156f57600019602084900360031b1b1692915050565b60208082526022908201527f4368696c644552433732315072656469636174653a204e4f545f434f4e54524160408201526110d560f21b606082015260800190565b60006020828403121561190257600080fd5b815161170e8161160c565b60208082526024908201527f4368696c644552433732315072656469636174653a20554e4d41505045445f5460408201526327a5a2a760e11b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561198057600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b03841681526040602082018190526000906119be9083018486611967565b95945050505050565b6000602082840312156119d957600080fd5b8151801515811461170e57600080fd5b60208082526021908201527f4368696c644552433732315072656469636174653a204255524e5f4641494c456040820152601160fa1b606082015260800190565b8183526000602080850194508260005b85811015611a68578135611a4d8161160c565b6001600160a01b031687529582019590820190600101611a3a565b509495945050505050565b8781526001600160a01b0387811660208301528616604082015260a060608201819052600090611aa69083018688611a2a565b8281036080840152611ab9818587611967565b9a9950505050505050505050565b6000815180845260005b81811015611aed57602081850181015186830182015201611ad1565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611b3190830184611ac7565b949350505050565b604081526000611b4d604083018688611a2a565b8281036020840152611b60818587611967565b979650505050505050565b6001600160a01b03929092168252602082015260400190565b60008060008060808587031215611b9a57600080fd5b8435611ba58161160c565b93506020850135611bb58161160c565b92506040850135611bc58161160c565b9396929550929360600135925050565b60208082526021908201527f4368696c644552433732315072656469636174653a204d494e545f4641494c456040820152601160fa1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611c5457611c54611c16565b604052919050565b60006001600160401b03821115611c7557611c75611c16565b5060051b60200190565b600082601f830112611c9057600080fd5b81356020611ca5611ca083611c5c565b611c2c565b82815260059290921b84018101918181019086841115611cc457600080fd5b8286015b84811015611cdf5780358352918301918301611cc8565b509695505050505050565b600080600080600060a08688031215611d0257600080fd5b85359450602080870135611d158161160c565b94506040870135611d258161160c565b935060608701356001600160401b0380821115611d4157600080fd5b818901915089601f830112611d5557600080fd5b8135611d63611ca082611c5c565b81815260059190911b8301840190848101908c831115611d8257600080fd5b938501935b82851015611da9578435611d9a8161160c565b82529385019390850190611d87565b965050506080890135925080831115611dc157600080fd5b5050611dcf88828901611c7f565b9150509295509295909350565b604080825283519082018190526000906020906060840190828701845b82811015611e1e5781516001600160a01b031684529284019290840190600101611df9565b5050508381038285015284518082528583019183019060005b81811015611e5357835183529284019291840191600101611e37565b5090979650505050505050565b600082601f830112611e7157600080fd5b81356001600160401b03811115611e8a57611e8a611c16565b611e9d601f8201601f1916602001611c2c565b818152846020838601011115611eb257600080fd5b816020850160208301376000918101602001919091529392505050565b60008060008060808587031215611ee557600080fd5b843593506020850135611ef78161160c565b925060408501356001600160401b0380821115611f1357600080fd5b611f1f88838901611e60565b93506060870135915080821115611f3557600080fd5b50611f4287828801611e60565b91505092959194509250565b6001600160a01b0384168152606060208201819052600090611f7290830185611ac7565b8281036040840152611f848185611ac7565b969550505050505056fea264697066735822122081e46b99b49bcb8dea5f01175766e4aca327da04a0662d01672b6f776a5e701164736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101585760003560e01c8063b1768065116100c3578063e0563ab11161007c578063e0563ab114610306578063eeb499451461030f578063f3fef3a314610322578063f645125514610335578063f691325c1461035c578063f8c8765e1461036f57600080fd5b8063b176806514610244578063b68ad1e41461026b578063c3b35a7e1461027e578063c5ac2b1c14610291578063d41f1771146102b8578063d7c9e3ec146102df57600080fd5b806355b01e4d1161011557806355b01e4d146101ce5780635ea5df79146101dc5780636f33e695146101f35780637efab4f514610208578063947287cf1461023157806397e5230d1461023a57600080fd5b806305dc2e8f1461015d57806307b3e2521461018d5780631bc114ba1461019b578063284017f5146101ae5780633b878c22146101b757806351351d53146101c0575b600080fd5b603454610170906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101706004600360981b0181565b603354610170906001600160a01b031681565b61017061202081565b61017061101081565b6101706002600160a01b0381565b6101706004600160991b0181565b6101e561138881565b604051908152602001610184565b61020661020136600461166f565b610382565b005b6101706102163660046116f1565b6037602052600090815260409020546001600160a01b031681565b6101e561520881565b6101e5620249f081565b6101e57f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b603654610170906001600160a01b031681565b61020661028c366004611715565b610396565b6101e57faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6101e57f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101e57f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61017061203081565b61020661031d366004611756565b6103a6565b6102066103303660046117de565b6105c9565b6101e57f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b603554610170906001600160a01b031681565b61020661037d36600461180a565b6105d8565b61038f8585858585610734565b5050505050565b6103a1838383610a98565b505050565b6034546001600160a01b031633146104175760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f53544154456044820152682fa922a1a2a4ab22a960b91b60648201526084015b60405180910390fd5b6035546001600160a01b038481169116146104865760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f524f4f545f60448201526850524544494341544560b81b606482015260840161040e565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216104b5602060008486611866565b6104be91611890565b036104dd576104d86104d38260208186611866565b610da1565b6105c3565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1861050c602060008486611866565b61051591611890565b03610524576104d88282611017565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad610553602060008486611866565b61055c91611890565b0361056b576104d8828261127d565b60405162461bcd60e51b815260206004820152602760248201527f4368696c644552433732315072656469636174653a20494e56414c49445f5349604482015266474e415455524560c81b606482015260840161040e565b50505050565b6105d4823383610a98565b5050565b336002600160a01b031461061c5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b604482015260640161040e565b600054610100900460ff161580801561063c5750600054600160ff909116105b806106565750303b158015610656575060005460ff166001145b6106b95760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161040e565b6000805460ff1916600117905580156106dc576000805461ff0019166101001790555b6106e8858585856113eb565b801561038f576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b8461073e816114e0565b61075a5760405162461bcd60e51b815260040161040e906118ae565b6000866001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561079a573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107be91906118f0565b6001600160a01b038181166000908152603760205260409020549192508881169116146107fd5760405162461bcd60e51b815260040161040e9061190d565b6001600160a01b03811661081357610813611951565b306001600160a01b0316876001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561085b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061087f91906118f0565b6001600160a01b03161461089557610895611951565b8483146108f05760405162461bcd60e51b8152602060048201526024808201527f4368696c644552433732315072656469636174653a20494e56414c49445f4c4560448201526309c8ea8960e31b606482015260840161040e565b60405163b2dc5dc360e01b81526001600160a01b0388169063b2dc5dc39061092090339088908890600401611999565b6020604051808303816000875af115801561093f573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061096391906119c7565b61097f5760405162461bcd60e51b815260040161040e906119e9565b6033546035546040516001600160a01b03928316926316f198319216906109d6907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908d908d908d908d90602001611a73565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610a02929190611b0d565b600060405180830381600087803b158015610a1c57600080fd5b505af1158015610a30573d6000803e3d6000fd5b50505050336001600160a01b0316876001600160a01b0316826001600160a01b03167fa80bc76d6e1849a9088a9c00a2aeaa54eeb78f15565a18da3e8873438976f52289898989604051610a879493929190611b39565b60405180910390a450505050505050565b82610aa2816114e0565b610abe5760405162461bcd60e51b815260040161040e906118ae565b6000846001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610afe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b2291906118f0565b6001600160a01b03818116600090815260376020526040902054919250868116911614610b615760405162461bcd60e51b815260040161040e9061190d565b6001600160a01b038116610b7757610b77611951565b306001600160a01b0316856001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610bbf573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610be391906118f0565b6001600160a01b031614610bf957610bf9611951565b604051632770a7eb60e21b81526001600160a01b03861690639dc29fac90610c279033908790600401611b6b565b6020604051808303816000875af1158015610c46573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c6a91906119c7565b610c865760405162461bcd60e51b815260040161040e906119e9565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152888116608083015260a08083018990528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610d119391169160c401611b0d565b600060405180830381600087803b158015610d2b57600080fd5b505af1158015610d3f573d6000803e3d6000fd5b50505050836001600160a01b0316856001600160a01b0316826001600160a01b03167f1e0ef6131232b1090efc3ec1cf7b53aa17f4b7cd8a4f9e033b49ee237379b0133387604051610d92929190611b6b565b60405180910390a45050505050565b6000808080610db285870187611b84565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610df55760405162461bcd60e51b815260040161040e9061190d565b610dfe816114e0565b610e0a57610e0a611951565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610e4a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e6e91906118f0565b9050856001600160a01b0316816001600160a01b031614610e9157610e91611951565b6001600160a01b038116610ea757610ea7611951565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610eef573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f1391906118f0565b6001600160a01b031614610f2957610f29611951565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610f579087908790600401611b6b565b6020604051808303816000875af1158015610f76573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f9a91906119c7565b610fb65760405162461bcd60e51b815260040161040e90611bd5565b836001600160a01b0316826001600160a01b0316876001600160a01b03167f37589fd8c906c19ea68eeb7e6b3e03efc06ff8aa4b1830588eba75f4375b16118887604051611005929190611b6b565b60405180910390a45050505050505050565b600080808061102885870187611cea565b6001600160a01b0380851660009081526037602052604090205494995092975090955093501690508061106d5760405162461bcd60e51b815260040161040e9061190d565b611076816114e0565b61108257611082611951565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156110c2573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110e691906118f0565b9050856001600160a01b0316816001600160a01b03161461110957611109611951565b6001600160a01b03811661111f5761111f611951565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015611167573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061118b91906118f0565b6001600160a01b0316146111a1576111a1611951565b604051637c88e3d960e01b81526001600160a01b03831690637c88e3d9906111cf9087908790600401611ddc565b6020604051808303816000875af11580156111ee573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061121291906119c7565b61122e5760405162461bcd60e51b815260040161040e90611bd5565b846001600160a01b0316826001600160a01b0316876001600160a01b03167fc1b1a5c1b97cc8e5ac82b47496f5ebdadf9c7d119b30a116e2bdafd56f6ed4758787604051611005929190611ddc565b6000808061128d84860186611ecf565b91955093509150506001600160a01b0383166112ab576112ab611951565b6001600160a01b0383811660009081526037602052604090205416156112d3576112d3611951565b6036546040516bffffffffffffffffffffffff19606086901b166020820152600091611323916001600160a01b039091169060340160405160208183030381529060405280519060200120611575565b6001600160a01b038581166000908152603760205260409081902080546001600160a01b031916928416928317905551639065714760e01b81529192509063906571479061137990879087908790600401611f4e565b600060405180830381600087803b15801561139357600080fd5b505af11580156113a7573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a3505050505050565b6001600160a01b0384161580159061140b57506001600160a01b03831615155b801561141f57506001600160a01b03821615155b801561143357506001600160a01b03811615155b6114905760405162461bcd60e51b815260206004820152602860248201527f4368696c644552433732315072656469636174653a204241445f494e495449416044820152672624ad20aa24a7a760c11b606482015260840161040e565b603380546001600160a01b039586166001600160a01b0319918216179091556034805494861694821694909417909355603580549285169284169290921790915560368054919093169116179055565b6000816001600160a01b03163b6000036114fc57506000919050565b6040516301ffc9a760e01b81526380ac58cd60e01b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611563575060408051601f3d908101601f19168201909252611560918101906119c7565b60015b61156f57506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b03811661156f5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b604482015260640161040e565b6001600160a01b038116811461162157600080fd5b50565b60008083601f84011261163657600080fd5b5081356001600160401b0381111561164d57600080fd5b6020830191508360208260051b850101111561166857600080fd5b9250929050565b60008060008060006060868803121561168757600080fd5b85356116928161160c565b945060208601356001600160401b03808211156116ae57600080fd5b6116ba89838a01611624565b909650945060408801359150808211156116d357600080fd5b506116e088828901611624565b969995985093965092949392505050565b60006020828403121561170357600080fd5b813561170e8161160c565b9392505050565b60008060006060848603121561172a57600080fd5b83356117358161160c565b925060208401356117458161160c565b929592945050506040919091013590565b6000806000806060858703121561176c57600080fd5b84359350602085013561177e8161160c565b925060408501356001600160401b038082111561179a57600080fd5b818701915087601f8301126117ae57600080fd5b8135818111156117bd57600080fd5b8860208285010111156117cf57600080fd5b95989497505060200194505050565b600080604083850312156117f157600080fd5b82356117fc8161160c565b946020939093013593505050565b6000806000806080858703121561182057600080fd5b843561182b8161160c565b9350602085013561183b8161160c565b9250604085013561184b8161160c565b9150606085013561185b8161160c565b939692955090935050565b6000808585111561187657600080fd5b8386111561188357600080fd5b5050820193919092039150565b8035602083101561156f57600019602084900360031b1b1692915050565b60208082526022908201527f4368696c644552433732315072656469636174653a204e4f545f434f4e54524160408201526110d560f21b606082015260800190565b60006020828403121561190257600080fd5b815161170e8161160c565b60208082526024908201527f4368696c644552433732315072656469636174653a20554e4d41505045445f5460408201526327a5a2a760e11b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561198057600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b03841681526040602082018190526000906119be9083018486611967565b95945050505050565b6000602082840312156119d957600080fd5b8151801515811461170e57600080fd5b60208082526021908201527f4368696c644552433732315072656469636174653a204255524e5f4641494c456040820152601160fa1b606082015260800190565b8183526000602080850194508260005b85811015611a68578135611a4d8161160c565b6001600160a01b031687529582019590820190600101611a3a565b509495945050505050565b8781526001600160a01b0387811660208301528616604082015260a060608201819052600090611aa69083018688611a2a565b8281036080840152611ab9818587611967565b9a9950505050505050505050565b6000815180845260005b81811015611aed57602081850181015186830182015201611ad1565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611b3190830184611ac7565b949350505050565b604081526000611b4d604083018688611a2a565b8281036020840152611b60818587611967565b979650505050505050565b6001600160a01b03929092168252602082015260400190565b60008060008060808587031215611b9a57600080fd5b8435611ba58161160c565b93506020850135611bb58161160c565b92506040850135611bc58161160c565b9396929550929360600135925050565b60208082526021908201527f4368696c644552433732315072656469636174653a204d494e545f4641494c456040820152601160fa1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611c5457611c54611c16565b604052919050565b60006001600160401b03821115611c7557611c75611c16565b5060051b60200190565b600082601f830112611c9057600080fd5b81356020611ca5611ca083611c5c565b611c2c565b82815260059290921b84018101918181019086841115611cc457600080fd5b8286015b84811015611cdf5780358352918301918301611cc8565b509695505050505050565b600080600080600060a08688031215611d0257600080fd5b85359450602080870135611d158161160c565b94506040870135611d258161160c565b935060608701356001600160401b0380821115611d4157600080fd5b818901915089601f830112611d5557600080fd5b8135611d63611ca082611c5c565b81815260059190911b8301840190848101908c831115611d8257600080fd5b938501935b82851015611da9578435611d9a8161160c565b82529385019390850190611d87565b965050506080890135925080831115611dc157600080fd5b5050611dcf88828901611c7f565b9150509295509295909350565b604080825283519082018190526000906020906060840190828701845b82811015611e1e5781516001600160a01b031684529284019290840190600101611df9565b5050508381038285015284518082528583019183019060005b81811015611e5357835183529284019291840191600101611e37565b5090979650505050505050565b600082601f830112611e7157600080fd5b81356001600160401b03811115611e8a57611e8a611c16565b611e9d601f8201601f1916602001611c2c565b818152846020838601011115611eb257600080fd5b816020850160208301376000918101602001919091529392505050565b60008060008060808587031215611ee557600080fd5b843593506020850135611ef78161160c565b925060408501356001600160401b0380821115611f1357600080fd5b611f1f88838901611e60565b93506060870135915080821115611f3557600080fd5b50611f4287828801611e60565b91505092959194509250565b6001600160a01b0384168152606060208201819052600090611f7290830185611ac7565b8281036040840152611f848185611ac7565b969550505050505056fea264697066735822122081e46b99b49bcb8dea5f01175766e4aca327da04a0662d01672b6f776a5e701164736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildERC721PredicateACLArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildERC721PredicateAccessList","sourceName":"contracts/child/ChildERC721PredicateAccessList.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"AllowListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"BlockListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"L2ERC721Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"L2ERC721DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"L2ERC721Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"L2ERC721WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2TokenMapped","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootERC721Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"},{"internalType":"bool","name":"newUseAllowList","type":"bool"},{"internalType":"bool","name":"newUseBlockList","type":"bool"},{"internalType":"address","name":"newOwner","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootERC721Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootERC721Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseAllowList","type":"bool"}],"name":"setAllowList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseBlockList","type":"bool"}],"name":"setBlockList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC721","name":"childToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC721","name":"childToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"withdrawBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC721","name":"childToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50612758806100206000396000f3fe608060405234801561001057600080fd5b50600436106101b05760003560e01c8063b68ad1e4116100ef578063e0563ab111610092578063e0563ab1146103b9578063e30c3978146103c2578063eeb49945146103d3578063f2fde38b146103e6578063f3fef3a3146103f9578063f64512551461040c578063f691325c14610433578063f8c8765e1461044657600080fd5b8063b68ad1e4146102e5578063c1225a20146102f8578063c3b35a7e1461030b578063c5ac2b1c1461031e578063c5e4683a14610345578063d41f177114610358578063d7c9e3ec1461037f578063d8dd1773146103a657600080fd5b80636f33e695116101575780636f33e6951461024b578063715018a61461026057806379ba5097146102685780637efab4f5146102705780638da5cb5b1461029a578063947287cf146102ab57806397e5230d146102b4578063b1768065146102be57600080fd5b806305dc2e8f146101b557806307b3e252146101e55780631bc114ba146101f3578063284017f5146102065780633b878c221461020f57806351351d531461021857806355b01e4d146102265780635ea5df7914610234575b600080fd5b60fd546101c8906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101c86004600360981b0181565b60fc546101c8906001600160a01b031681565b6101c861202081565b6101c861101081565b6101c86002600160a01b0381565b6101c86004600160991b0181565b61023d61138881565b6040519081526020016101dc565b61025e610259366004611c96565b610459565b005b61025e610475565b61025e610489565b6101c861027e366004611d18565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b03166101c8565b61023d61520881565b61023d620249f081565b61023d7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff546101c8906001600160a01b031681565b61025e610306366004611d4a565b610508565b61025e610319366004611d67565b610557565b61023d7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b61025e610353366004611d4a565b61056f565b61023d7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61023d7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61025e6103b4366004611da8565b6105b6565b6101c861203081565b6065546001600160a01b03166101c8565b61025e6103e1366004611e3e565b6106d7565b61025e6103f4366004611d18565b6108f5565b61025e610407366004611ec6565b610966565b61023d7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b60fe546101c8906001600160a01b031681565b61025e610454366004611ef2565b61097d565b610461610a75565b61046e8585858585610a7d565b5050505050565b61047d610de2565b6104876000610e3c565b565b60655433906001600160a01b031681146104fc5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61050581610e3c565b50565b610510610de2565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b61055f610a75565b61056a838383610e55565b505050565b610577610de2565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b03146105dd5760405163973d02cb60e01b81526004016104f390611f4e565b600054610100900460ff16158080156105fd5750600054600160ff909116105b806106175750303b158015610617575060005460ff166001145b6106335760405162461bcd60e51b81526004016104f390611f72565b6000805460ff191660011790558015610656576000805461ff0019166101001790555b6106628888888861115f565b60c9805461ffff191685151561ff001916176101008515150217905561068782610e3c565b80156106cd576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146107435760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f53544154456044820152682fa922a1a2a4ab22a960b91b60648201526084016104f3565b60fe546001600160a01b038481169116146107b25760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f524f4f545f60448201526850524544494341544560b81b60648201526084016104f3565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216107e1602060008486611fc0565b6107ea91611fea565b03610809576108046107ff8260208186611fc0565b611254565b6108ef565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18610838602060008486611fc0565b61084191611fea565b036108505761080482826114cb565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61087f602060008486611fc0565b61088891611fea565b03610897576108048282611732565b60405162461bcd60e51b815260206004820152602760248201527f4368696c644552433732315072656469636174653a20494e56414c49445f5349604482015266474e415455524560c81b60648201526084016104f3565b50505050565b6108fd610de2565b606580546001600160a01b0383166001600160a01b0319909116811790915561092e6033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b61096e610a75565b610979823383610e55565b5050565b336002600160a01b03146109a45760405163973d02cb60e01b81526004016104f390611f4e565b600054610100900460ff16158080156109c45750600054600160ff909116105b806109de5750303b1580156109de575060005460ff166001145b6109fa5760405162461bcd60e51b81526004016104f390611f72565b6000805460ff191660011790558015610a1d576000805461ff0019166101001790555b610a298585858561115f565b801561046e576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b6104876118a2565b84610a8781611ab8565b610aa35760405162461bcd60e51b81526004016104f390612008565b6000866001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ae3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b07919061204a565b6001600160a01b0381811660009081526101006020526040902054919250888116911614610b475760405162461bcd60e51b81526004016104f390612067565b6001600160a01b038116610b5d57610b5d6120ab565b306001600160a01b0316876001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ba5573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bc9919061204a565b6001600160a01b031614610bdf57610bdf6120ab565b848314610c3a5760405162461bcd60e51b8152602060048201526024808201527f4368696c644552433732315072656469636174653a20494e56414c49445f4c4560448201526309c8ea8960e31b60648201526084016104f3565b60405163b2dc5dc360e01b81526001600160a01b0388169063b2dc5dc390610c6a903390889088906004016120f3565b6020604051808303816000875af1158015610c89573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610cad9190612121565b610cc95760405162461bcd60e51b81526004016104f39061213e565b60fc5460fe546040516001600160a01b03928316926316f19831921690610d20907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908d908d908d908d906020016121c8565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610d4c92919061226c565b600060405180830381600087803b158015610d6657600080fd5b505af1158015610d7a573d6000803e3d6000fd5b50505050336001600160a01b0316876001600160a01b0316826001600160a01b03167fa80bc76d6e1849a9088a9c00a2aeaa54eeb78f15565a18da3e8873438976f52289898989604051610dd19493929190612298565b60405180910390a450505050505050565b6033546001600160a01b031633146104875760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016104f3565b606580546001600160a01b031916905561050581611b4d565b82610e5f81611ab8565b610e7b5760405162461bcd60e51b81526004016104f390612008565b6000846001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ebb573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610edf919061204a565b6001600160a01b0381811660009081526101006020526040902054919250868116911614610f1f5760405162461bcd60e51b81526004016104f390612067565b6001600160a01b038116610f3557610f356120ab565b306001600160a01b0316856001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f7d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fa1919061204a565b6001600160a01b031614610fb757610fb76120ab565b604051632770a7eb60e21b81526001600160a01b03861690639dc29fac90610fe590339087906004016122ca565b6020604051808303816000875af1158015611004573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110289190612121565b6110445760405162461bcd60e51b81526004016104f39061213e565b60fc5460fe54604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152888116608083015260a08083018990528351808403909101815260c08301938490526316f1983160e01b909352938416936316f19831936110cf9391169160c40161226c565b600060405180830381600087803b1580156110e957600080fd5b505af11580156110fd573d6000803e3d6000fd5b50505050836001600160a01b0316856001600160a01b0316826001600160a01b03167f1e0ef6131232b1090efc3ec1cf7b53aa17f4b7cd8a4f9e033b49ee237379b01333876040516111509291906122ca565b60405180910390a45050505050565b6001600160a01b0384161580159061117f57506001600160a01b03831615155b801561119357506001600160a01b03821615155b80156111a757506001600160a01b03811615155b6112045760405162461bcd60e51b815260206004820152602860248201527f4368696c644552433732315072656469636174653a204241445f494e495449416044820152672624ad20aa24a7a760c11b60648201526084016104f3565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b6000808080611265858701876122e3565b6001600160a01b0380851660009081526101006020526040902054949850929650909450925016806112a95760405162461bcd60e51b81526004016104f390612067565b6112b281611ab8565b6112be576112be6120ab565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156112fe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611322919061204a565b9050856001600160a01b0316816001600160a01b031614611345576113456120ab565b6001600160a01b03811661135b5761135b6120ab565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156113a3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113c7919061204a565b6001600160a01b0316146113dd576113dd6120ab565b6040516340c10f1960e01b81526001600160a01b038316906340c10f199061140b90879087906004016122ca565b6020604051808303816000875af115801561142a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061144e9190612121565b61146a5760405162461bcd60e51b81526004016104f390612334565b836001600160a01b0316826001600160a01b0316876001600160a01b03167f37589fd8c906c19ea68eeb7e6b3e03efc06ff8aa4b1830588eba75f4375b161188876040516114b99291906122ca565b60405180910390a45050505050505050565b60008080806114dc85870187612449565b6001600160a01b03808516600090815261010060205260409020549499509297509095509350169050806115225760405162461bcd60e51b81526004016104f390612067565b61152b81611ab8565b611537576115376120ab565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015611577573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061159b919061204a565b9050856001600160a01b0316816001600160a01b0316146115be576115be6120ab565b6001600160a01b0381166115d4576115d46120ab565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561161c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611640919061204a565b6001600160a01b031614611656576116566120ab565b604051637c88e3d960e01b81526001600160a01b03831690637c88e3d990611684908790879060040161253b565b6020604051808303816000875af11580156116a3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116c79190612121565b6116e35760405162461bcd60e51b81526004016104f390612334565b846001600160a01b0316826001600160a01b0316876001600160a01b03167fc1b1a5c1b97cc8e5ac82b47496f5ebdadf9c7d119b30a116e2bdafd56f6ed47587876040516114b992919061253b565b600080806117428486018661262e565b91955093509150506001600160a01b038316611760576117606120ab565b6001600160a01b03838116600090815261010060205260409020541615611789576117896120ab565b60ff546040516bffffffffffffffffffffffff19606086901b1660208201526000916117d9916001600160a01b039091169060340160405160208183030381529060405280519060200120611b9f565b6001600160a01b03858116600090815261010060205260409081902080546001600160a01b031916928416928317905551639065714760e01b815291925090639065714790611830908790879087906004016126ad565b600060405180830381600087803b15801561184a57600080fd5b505af115801561185e573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a3505050505050565b60c95460ff16156119ad57604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161190491906126ed565b6000604051808303818686fa925050503d8060008114611940576040519150601f19603f3d011682016040523d82523d6000602084013e611945565b606091505b509150915081801561196a57506000818060200190518101906119689190612709565b115b6119aa5760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b60448201526064016104f3565b50505b60c954610100900460ff161561048757604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b019161138891611a1491906126ed565b6000604051808303818686fa925050503d8060008114611a50576040519150601f19603f3d011682016040523d82523d6000602084013e611a55565b606091505b5091509150818015611a7b575080806020019051810190611a769190612709565b600114155b6109795760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b60448201526064016104f3565b6000816001600160a01b03163b600003611ad457506000919050565b6040516301ffc9a760e01b81526380ac58cd60e01b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611b3b575060408051601f3d908101601f19168201909252611b3891810190612121565b60015b611b4757506000919050565b92915050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116611b475760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016104f3565b6001600160a01b038116811461050557600080fd5b60008083601f840112611c5d57600080fd5b5081356001600160401b03811115611c7457600080fd5b6020830191508360208260051b8501011115611c8f57600080fd5b9250929050565b600080600080600060608688031215611cae57600080fd5b8535611cb981611c36565b945060208601356001600160401b0380821115611cd557600080fd5b611ce189838a01611c4b565b90965094506040880135915080821115611cfa57600080fd5b50611d0788828901611c4b565b969995985093965092949392505050565b600060208284031215611d2a57600080fd5b8135611d3581611c36565b9392505050565b801515811461050557600080fd5b600060208284031215611d5c57600080fd5b8135611d3581611d3c565b600080600060608486031215611d7c57600080fd5b8335611d8781611c36565b92506020840135611d9781611c36565b929592945050506040919091013590565b600080600080600080600060e0888a031215611dc357600080fd5b8735611dce81611c36565b96506020880135611dde81611c36565b95506040880135611dee81611c36565b94506060880135611dfe81611c36565b93506080880135611e0e81611d3c565b925060a0880135611e1e81611d3c565b915060c0880135611e2e81611c36565b8091505092959891949750929550565b60008060008060608587031215611e5457600080fd5b843593506020850135611e6681611c36565b925060408501356001600160401b0380821115611e8257600080fd5b818701915087601f830112611e9657600080fd5b813581811115611ea557600080fd5b886020828501011115611eb757600080fd5b95989497505060200194505050565b60008060408385031215611ed957600080fd5b8235611ee481611c36565b946020939093013593505050565b60008060008060808587031215611f0857600080fd5b8435611f1381611c36565b93506020850135611f2381611c36565b92506040850135611f3381611c36565b91506060850135611f4381611c36565b939692955090935050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b60008085851115611fd057600080fd5b83861115611fdd57600080fd5b5050820193919092039150565b80356020831015611b4757600019602084900360031b1b1692915050565b60208082526022908201527f4368696c644552433732315072656469636174653a204e4f545f434f4e54524160408201526110d560f21b606082015260800190565b60006020828403121561205c57600080fd5b8151611d3581611c36565b60208082526024908201527f4368696c644552433732315072656469636174653a20554e4d41505045445f5460408201526327a5a2a760e11b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b038311156120da57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b038416815260406020820181905260009061211890830184866120c1565b95945050505050565b60006020828403121561213357600080fd5b8151611d3581611d3c565b60208082526021908201527f4368696c644552433732315072656469636174653a204255524e5f4641494c456040820152601160fa1b606082015260800190565b8183526000602080850194508260005b858110156121bd5781356121a281611c36565b6001600160a01b03168752958201959082019060010161218f565b509495945050505050565b8781526001600160a01b0387811660208301528616604082015260a0606082018190526000906121fb908301868861217f565b828103608084015261220e8185876120c1565b9a9950505050505050505050565b60005b8381101561223757818101518382015260200161221f565b50506000910152565b6000815180845261225881602086016020860161221c565b601f01601f19169290920160200192915050565b6001600160a01b038316815260406020820181905260009061229090830184612240565b949350505050565b6040815260006122ac60408301868861217f565b82810360208401526122bf8185876120c1565b979650505050505050565b6001600160a01b03929092168252602082015260400190565b600080600080608085870312156122f957600080fd5b843561230481611c36565b9350602085013561231481611c36565b9250604085013561232481611c36565b9396929550929360600135925050565b60208082526021908201527f4368696c644552433732315072656469636174653a204d494e545f4641494c456040820152601160fa1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156123b3576123b3612375565b604052919050565b60006001600160401b038211156123d4576123d4612375565b5060051b60200190565b600082601f8301126123ef57600080fd5b813560206124046123ff836123bb565b61238b565b82815260059290921b8401810191818101908684111561242357600080fd5b8286015b8481101561243e5780358352918301918301612427565b509695505050505050565b600080600080600060a0868803121561246157600080fd5b8535945060208087013561247481611c36565b9450604087013561248481611c36565b935060608701356001600160401b03808211156124a057600080fd5b818901915089601f8301126124b457600080fd5b81356124c26123ff826123bb565b81815260059190911b8301840190848101908c8311156124e157600080fd5b938501935b828510156125085784356124f981611c36565b825293850193908501906124e6565b96505050608089013592508083111561252057600080fd5b505061252e888289016123de565b9150509295509295909350565b604080825283519082018190526000906020906060840190828701845b8281101561257d5781516001600160a01b031684529284019290840190600101612558565b5050508381038285015284518082528583019183019060005b818110156125b257835183529284019291840191600101612596565b5090979650505050505050565b600082601f8301126125d057600080fd5b81356001600160401b038111156125e9576125e9612375565b6125fc601f8201601f191660200161238b565b81815284602083860101111561261157600080fd5b816020850160208301376000918101602001919091529392505050565b6000806000806080858703121561264457600080fd5b84359350602085013561265681611c36565b925060408501356001600160401b038082111561267257600080fd5b61267e888389016125bf565b9350606087013591508082111561269457600080fd5b506126a1878288016125bf565b91505092959194509250565b6001600160a01b03841681526060602082018190526000906126d190830185612240565b82810360408401526126e38185612240565b9695505050505050565b600082516126ff81846020870161221c565b9190910192915050565b60006020828403121561271b57600080fd5b505191905056fea2646970667358221220d293b100fc5adddbb8fd0cb4e134ee7114418d77a3e89fc4f80cf959061a6cfc64736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101b05760003560e01c8063b68ad1e4116100ef578063e0563ab111610092578063e0563ab1146103b9578063e30c3978146103c2578063eeb49945146103d3578063f2fde38b146103e6578063f3fef3a3146103f9578063f64512551461040c578063f691325c14610433578063f8c8765e1461044657600080fd5b8063b68ad1e4146102e5578063c1225a20146102f8578063c3b35a7e1461030b578063c5ac2b1c1461031e578063c5e4683a14610345578063d41f177114610358578063d7c9e3ec1461037f578063d8dd1773146103a657600080fd5b80636f33e695116101575780636f33e6951461024b578063715018a61461026057806379ba5097146102685780637efab4f5146102705780638da5cb5b1461029a578063947287cf146102ab57806397e5230d146102b4578063b1768065146102be57600080fd5b806305dc2e8f146101b557806307b3e252146101e55780631bc114ba146101f3578063284017f5146102065780633b878c221461020f57806351351d531461021857806355b01e4d146102265780635ea5df7914610234575b600080fd5b60fd546101c8906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101c86004600360981b0181565b60fc546101c8906001600160a01b031681565b6101c861202081565b6101c861101081565b6101c86002600160a01b0381565b6101c86004600160991b0181565b61023d61138881565b6040519081526020016101dc565b61025e610259366004611c96565b610459565b005b61025e610475565b61025e610489565b6101c861027e366004611d18565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b03166101c8565b61023d61520881565b61023d620249f081565b61023d7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff546101c8906001600160a01b031681565b61025e610306366004611d4a565b610508565b61025e610319366004611d67565b610557565b61023d7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b61025e610353366004611d4a565b61056f565b61023d7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61023d7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61025e6103b4366004611da8565b6105b6565b6101c861203081565b6065546001600160a01b03166101c8565b61025e6103e1366004611e3e565b6106d7565b61025e6103f4366004611d18565b6108f5565b61025e610407366004611ec6565b610966565b61023d7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b60fe546101c8906001600160a01b031681565b61025e610454366004611ef2565b61097d565b610461610a75565b61046e8585858585610a7d565b5050505050565b61047d610de2565b6104876000610e3c565b565b60655433906001600160a01b031681146104fc5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61050581610e3c565b50565b610510610de2565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b61055f610a75565b61056a838383610e55565b505050565b610577610de2565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b03146105dd5760405163973d02cb60e01b81526004016104f390611f4e565b600054610100900460ff16158080156105fd5750600054600160ff909116105b806106175750303b158015610617575060005460ff166001145b6106335760405162461bcd60e51b81526004016104f390611f72565b6000805460ff191660011790558015610656576000805461ff0019166101001790555b6106628888888861115f565b60c9805461ffff191685151561ff001916176101008515150217905561068782610e3c565b80156106cd576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146107435760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f53544154456044820152682fa922a1a2a4ab22a960b91b60648201526084016104f3565b60fe546001600160a01b038481169116146107b25760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f524f4f545f60448201526850524544494341544560b81b60648201526084016104f3565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216107e1602060008486611fc0565b6107ea91611fea565b03610809576108046107ff8260208186611fc0565b611254565b6108ef565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18610838602060008486611fc0565b61084191611fea565b036108505761080482826114cb565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61087f602060008486611fc0565b61088891611fea565b03610897576108048282611732565b60405162461bcd60e51b815260206004820152602760248201527f4368696c644552433732315072656469636174653a20494e56414c49445f5349604482015266474e415455524560c81b60648201526084016104f3565b50505050565b6108fd610de2565b606580546001600160a01b0383166001600160a01b0319909116811790915561092e6033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b61096e610a75565b610979823383610e55565b5050565b336002600160a01b03146109a45760405163973d02cb60e01b81526004016104f390611f4e565b600054610100900460ff16158080156109c45750600054600160ff909116105b806109de5750303b1580156109de575060005460ff166001145b6109fa5760405162461bcd60e51b81526004016104f390611f72565b6000805460ff191660011790558015610a1d576000805461ff0019166101001790555b610a298585858561115f565b801561046e576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b6104876118a2565b84610a8781611ab8565b610aa35760405162461bcd60e51b81526004016104f390612008565b6000866001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ae3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b07919061204a565b6001600160a01b0381811660009081526101006020526040902054919250888116911614610b475760405162461bcd60e51b81526004016104f390612067565b6001600160a01b038116610b5d57610b5d6120ab565b306001600160a01b0316876001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ba5573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bc9919061204a565b6001600160a01b031614610bdf57610bdf6120ab565b848314610c3a5760405162461bcd60e51b8152602060048201526024808201527f4368696c644552433732315072656469636174653a20494e56414c49445f4c4560448201526309c8ea8960e31b60648201526084016104f3565b60405163b2dc5dc360e01b81526001600160a01b0388169063b2dc5dc390610c6a903390889088906004016120f3565b6020604051808303816000875af1158015610c89573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610cad9190612121565b610cc95760405162461bcd60e51b81526004016104f39061213e565b60fc5460fe546040516001600160a01b03928316926316f19831921690610d20907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908d908d908d908d906020016121c8565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610d4c92919061226c565b600060405180830381600087803b158015610d6657600080fd5b505af1158015610d7a573d6000803e3d6000fd5b50505050336001600160a01b0316876001600160a01b0316826001600160a01b03167fa80bc76d6e1849a9088a9c00a2aeaa54eeb78f15565a18da3e8873438976f52289898989604051610dd19493929190612298565b60405180910390a450505050505050565b6033546001600160a01b031633146104875760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016104f3565b606580546001600160a01b031916905561050581611b4d565b82610e5f81611ab8565b610e7b5760405162461bcd60e51b81526004016104f390612008565b6000846001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ebb573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610edf919061204a565b6001600160a01b0381811660009081526101006020526040902054919250868116911614610f1f5760405162461bcd60e51b81526004016104f390612067565b6001600160a01b038116610f3557610f356120ab565b306001600160a01b0316856001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f7d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fa1919061204a565b6001600160a01b031614610fb757610fb76120ab565b604051632770a7eb60e21b81526001600160a01b03861690639dc29fac90610fe590339087906004016122ca565b6020604051808303816000875af1158015611004573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110289190612121565b6110445760405162461bcd60e51b81526004016104f39061213e565b60fc5460fe54604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152888116608083015260a08083018990528351808403909101815260c08301938490526316f1983160e01b909352938416936316f19831936110cf9391169160c40161226c565b600060405180830381600087803b1580156110e957600080fd5b505af11580156110fd573d6000803e3d6000fd5b50505050836001600160a01b0316856001600160a01b0316826001600160a01b03167f1e0ef6131232b1090efc3ec1cf7b53aa17f4b7cd8a4f9e033b49ee237379b01333876040516111509291906122ca565b60405180910390a45050505050565b6001600160a01b0384161580159061117f57506001600160a01b03831615155b801561119357506001600160a01b03821615155b80156111a757506001600160a01b03811615155b6112045760405162461bcd60e51b815260206004820152602860248201527f4368696c644552433732315072656469636174653a204241445f494e495449416044820152672624ad20aa24a7a760c11b60648201526084016104f3565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b6000808080611265858701876122e3565b6001600160a01b0380851660009081526101006020526040902054949850929650909450925016806112a95760405162461bcd60e51b81526004016104f390612067565b6112b281611ab8565b6112be576112be6120ab565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156112fe573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611322919061204a565b9050856001600160a01b0316816001600160a01b031614611345576113456120ab565b6001600160a01b03811661135b5761135b6120ab565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156113a3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113c7919061204a565b6001600160a01b0316146113dd576113dd6120ab565b6040516340c10f1960e01b81526001600160a01b038316906340c10f199061140b90879087906004016122ca565b6020604051808303816000875af115801561142a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061144e9190612121565b61146a5760405162461bcd60e51b81526004016104f390612334565b836001600160a01b0316826001600160a01b0316876001600160a01b03167f37589fd8c906c19ea68eeb7e6b3e03efc06ff8aa4b1830588eba75f4375b161188876040516114b99291906122ca565b60405180910390a45050505050505050565b60008080806114dc85870187612449565b6001600160a01b03808516600090815261010060205260409020549499509297509095509350169050806115225760405162461bcd60e51b81526004016104f390612067565b61152b81611ab8565b611537576115376120ab565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015611577573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061159b919061204a565b9050856001600160a01b0316816001600160a01b0316146115be576115be6120ab565b6001600160a01b0381166115d4576115d46120ab565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561161c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611640919061204a565b6001600160a01b031614611656576116566120ab565b604051637c88e3d960e01b81526001600160a01b03831690637c88e3d990611684908790879060040161253b565b6020604051808303816000875af11580156116a3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116c79190612121565b6116e35760405162461bcd60e51b81526004016104f390612334565b846001600160a01b0316826001600160a01b0316876001600160a01b03167fc1b1a5c1b97cc8e5ac82b47496f5ebdadf9c7d119b30a116e2bdafd56f6ed47587876040516114b992919061253b565b600080806117428486018661262e565b91955093509150506001600160a01b038316611760576117606120ab565b6001600160a01b03838116600090815261010060205260409020541615611789576117896120ab565b60ff546040516bffffffffffffffffffffffff19606086901b1660208201526000916117d9916001600160a01b039091169060340160405160208183030381529060405280519060200120611b9f565b6001600160a01b03858116600090815261010060205260409081902080546001600160a01b031916928416928317905551639065714760e01b815291925090639065714790611830908790879087906004016126ad565b600060405180830381600087803b15801561184a57600080fd5b505af115801561185e573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a3505050505050565b60c95460ff16156119ad57604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161190491906126ed565b6000604051808303818686fa925050503d8060008114611940576040519150601f19603f3d011682016040523d82523d6000602084013e611945565b606091505b509150915081801561196a57506000818060200190518101906119689190612709565b115b6119aa5760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b60448201526064016104f3565b50505b60c954610100900460ff161561048757604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b019161138891611a1491906126ed565b6000604051808303818686fa925050503d8060008114611a50576040519150601f19603f3d011682016040523d82523d6000602084013e611a55565b606091505b5091509150818015611a7b575080806020019051810190611a769190612709565b600114155b6109795760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b60448201526064016104f3565b6000816001600160a01b03163b600003611ad457506000919050565b6040516301ffc9a760e01b81526380ac58cd60e01b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611b3b575060408051601f3d908101601f19168201909252611b3891810190612121565b60015b611b4757506000919050565b92915050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116611b475760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016104f3565b6001600160a01b038116811461050557600080fd5b60008083601f840112611c5d57600080fd5b5081356001600160401b03811115611c7457600080fd5b6020830191508360208260051b8501011115611c8f57600080fd5b9250929050565b600080600080600060608688031215611cae57600080fd5b8535611cb981611c36565b945060208601356001600160401b0380821115611cd557600080fd5b611ce189838a01611c4b565b90965094506040880135915080821115611cfa57600080fd5b50611d0788828901611c4b565b969995985093965092949392505050565b600060208284031215611d2a57600080fd5b8135611d3581611c36565b9392505050565b801515811461050557600080fd5b600060208284031215611d5c57600080fd5b8135611d3581611d3c565b600080600060608486031215611d7c57600080fd5b8335611d8781611c36565b92506020840135611d9781611c36565b929592945050506040919091013590565b600080600080600080600060e0888a031215611dc357600080fd5b8735611dce81611c36565b96506020880135611dde81611c36565b95506040880135611dee81611c36565b94506060880135611dfe81611c36565b93506080880135611e0e81611d3c565b925060a0880135611e1e81611d3c565b915060c0880135611e2e81611c36565b8091505092959891949750929550565b60008060008060608587031215611e5457600080fd5b843593506020850135611e6681611c36565b925060408501356001600160401b0380821115611e8257600080fd5b818701915087601f830112611e9657600080fd5b813581811115611ea557600080fd5b886020828501011115611eb757600080fd5b95989497505060200194505050565b60008060408385031215611ed957600080fd5b8235611ee481611c36565b946020939093013593505050565b60008060008060808587031215611f0857600080fd5b8435611f1381611c36565b93506020850135611f2381611c36565b92506040850135611f3381611c36565b91506060850135611f4381611c36565b939692955090935050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b60008085851115611fd057600080fd5b83861115611fdd57600080fd5b5050820193919092039150565b80356020831015611b4757600019602084900360031b1b1692915050565b60208082526022908201527f4368696c644552433732315072656469636174653a204e4f545f434f4e54524160408201526110d560f21b606082015260800190565b60006020828403121561205c57600080fd5b8151611d3581611c36565b60208082526024908201527f4368696c644552433732315072656469636174653a20554e4d41505045445f5460408201526327a5a2a760e11b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b038311156120da57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b038416815260406020820181905260009061211890830184866120c1565b95945050505050565b60006020828403121561213357600080fd5b8151611d3581611d3c565b60208082526021908201527f4368696c644552433732315072656469636174653a204255524e5f4641494c456040820152601160fa1b606082015260800190565b8183526000602080850194508260005b858110156121bd5781356121a281611c36565b6001600160a01b03168752958201959082019060010161218f565b509495945050505050565b8781526001600160a01b0387811660208301528616604082015260a0606082018190526000906121fb908301868861217f565b828103608084015261220e8185876120c1565b9a9950505050505050505050565b60005b8381101561223757818101518382015260200161221f565b50506000910152565b6000815180845261225881602086016020860161221c565b601f01601f19169290920160200192915050565b6001600160a01b038316815260406020820181905260009061229090830184612240565b949350505050565b6040815260006122ac60408301868861217f565b82810360208401526122bf8185876120c1565b979650505050505050565b6001600160a01b03929092168252602082015260400190565b600080600080608085870312156122f957600080fd5b843561230481611c36565b9350602085013561231481611c36565b9250604085013561232481611c36565b9396929550929360600135925050565b60208082526021908201527f4368696c644552433732315072656469636174653a204d494e545f4641494c456040820152601160fa1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156123b3576123b3612375565b604052919050565b60006001600160401b038211156123d4576123d4612375565b5060051b60200190565b600082601f8301126123ef57600080fd5b813560206124046123ff836123bb565b61238b565b82815260059290921b8401810191818101908684111561242357600080fd5b8286015b8481101561243e5780358352918301918301612427565b509695505050505050565b600080600080600060a0868803121561246157600080fd5b8535945060208087013561247481611c36565b9450604087013561248481611c36565b935060608701356001600160401b03808211156124a057600080fd5b818901915089601f8301126124b457600080fd5b81356124c26123ff826123bb565b81815260059190911b8301840190848101908c8311156124e157600080fd5b938501935b828510156125085784356124f981611c36565b825293850193908501906124e6565b96505050608089013592508083111561252057600080fd5b505061252e888289016123de565b9150509295509295909350565b604080825283519082018190526000906020906060840190828701845b8281101561257d5781516001600160a01b031684529284019290840190600101612558565b5050508381038285015284518082528583019183019060005b818110156125b257835183529284019291840191600101612596565b5090979650505050505050565b600082601f8301126125d057600080fd5b81356001600160401b038111156125e9576125e9612375565b6125fc601f8201601f191660200161238b565b81815284602083860101111561261157600080fd5b816020850160208301376000918101602001919091529392505050565b6000806000806080858703121561264457600080fd5b84359350602085013561265681611c36565b925060408501356001600160401b038082111561267257600080fd5b61267e888389016125bf565b9350606087013591508082111561269457600080fd5b506126a1878288016125bf565b91505092959194509250565b6001600160a01b03841681526060602082018190526000906126d190830185612240565b82810360408401526126e38185612240565b9695505050505050565b600082516126ff81846020870161221c565b9190910192915050565b60006020828403121561271b57600080fd5b505191905056fea2646970667358221220d293b100fc5adddbb8fd0cb4e134ee7114418d77a3e89fc4f80cf959061a6cfc64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RootMintableERC721PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RootMintableERC721Predicate","sourceName":"contracts/child/RootMintableERC721Predicate.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"depositor","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"L2MintableERC721Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"depositor","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"L2MintableERC721DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"L2MintableERC721Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"L2MintableERC721WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2MintableTokenMapped","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childERC721Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"depositBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"depositTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newChildERC721Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"}],"name":"mapToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC721Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611a8f806100206000396000f3fe608060405234801561001057600080fd5b506004361061016e5760003560e01c806397e5230d116100ce578063e0563ab111610087578063e0563ab114610353578063eeb499451461035c578063f213159c1461036f578063f4a120f714610382578063f645125514610395578063f8c8765e146103bc578063ff6f870c146103cf57600080fd5b806397e5230d1461029a578063b1768065146102a4578063b68ad1e4146102cb578063c5ac2b1c146102de578063d41f177114610305578063d7c9e3ec1461032c57600080fd5b806347e7ef241161012b57806347e7ef241461020d5780634fdca69d1461022257806351351d531461023557806355b01e4d146102435780635ea5df79146102515780637efab4f514610268578063947287cf1461029157600080fd5b806305dc2e8f1461017357806307b3e252146101a3578063150b7a02146101b15780631bc114ba146101e8578063284017f5146101fb5780633b878c2214610204575b600080fd5b603454610186906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101866004600360981b0181565b6101cf6101bf366004611231565b630a85bd0160e11b949350505050565b6040516001600160e01b0319909116815260200161019a565b603354610186906001600160a01b031681565b61018661202081565b61018661101081565b61022061021b3660046112df565b6103e2565b005b603554610186906001600160a01b031681565b6101866002600160a01b0381565b6101866004600160991b0181565b61025a61138881565b60405190815260200161019a565b61018661027636600461130b565b6037602052600090815260409020546001600160a01b031681565b61025a61520881565b61025a620249f081565b61025a7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b603654610186906001600160a01b031681565b61025a7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b61025a7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61025a7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61018661203081565b61022061036a36600461132f565b6103f1565b61022061037d3660046113b7565b6105d1565b61018661039036600461130b565b6105e1565b61025a7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6102206103ca3660046113f8565b61093a565b6102206103dd36600461149f565b610a97565b6103ed823383610af5565b5050565b6034546001600160a01b031633146104695760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c654552433732315072656469636174653a204f4e4c60448201526f2cafa9aa20aa22afa922a1a2a4ab22a960811b60648201526084015b60405180910390fd5b6035546001600160a01b038481169116146104e05760405162461bcd60e51b815260206004820152603160248201527f526f6f744d696e7461626c654552433732315072656469636174653a204f4e4c604482015270595f4348494c445f50524544494341544560781b6064820152608401610460565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286961050f602060008486611521565b6105189161154b565b036105375761053261052d8260208186611521565b610c74565b6105cb565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed2610566602060008486611521565b61056f9161154b565b0361057e576105328282610d72565b60405162461bcd60e51b815260206004820152602e6024820152600080516020611a3a83398151915260448201526d414c49445f5349474e415455524560901b6064820152608401610460565b50505050565b6105dc838383610af5565b505050565b60006001600160a01b03821661063a5760405162461bcd60e51b815260206004820152602a6024820152600080516020611a3a83398151915260448201526920a624a22faa27a5a2a760b11b6064820152608401610460565b6001600160a01b0382811660009081526037602052604090205416156106b65760405162461bcd60e51b815260206004820152602b60248201527f526f6f744d696e7461626c654552433732315072656469636174653a20414c5260448201526a1150511657d3505414115160aa1b6064820152608401610460565b6035546036546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b039283169260009261076492911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b0385811660008181526037602052604080822080546001600160a01b03191686861617905560335481516306fdde0360e01b81529151959650909316936316f198319387937f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad938b9391926306fdde0392600480830193928290030181865afa1580156107fc573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610824919081019061158e565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610862573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261088a919081019061158e565b60405160200161089d9493929190611630565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016108c9929190611677565b600060405180830381600087803b1580156108e357600080fd5b505af11580156108f7573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a39392505050565b336002600160a01b031461097e5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b6044820152606401610460565b600054610100900460ff161580801561099e5750600054600160ff909116105b806109b85750303b1580156109b8575060005460ff166001145b610a1b5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610460565b6000805460ff191660011790558015610a3e576000805461ff0019166101001790555b610a4a85858585610eb3565b8015610a90576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b828114610ae85760405162461bcd60e51b815260206004820152602b6024820152600080516020611a3a83398151915260448201526a082989288be988a9c8ea8960ab1b6064820152608401610460565b610a908585858585610faf565b6000610b0084611165565b604051632142170760e11b81529091506001600160a01b038516906342842e0e90610b33903390309087906004016116a3565b600060405180830381600087803b158015610b4d57600080fd5b505af1158015610b61573d6000803e3d6000fd5b5050603354603554604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038a811682840152336060830152898116608083015260a08083018a90528351808403909101815260c08301938490526316f1983160e01b90935293841695506316f198319450610bf1939092169160c401611677565b600060405180830381600087803b158015610c0b57600080fd5b505af1158015610c1f573d6000803e3d6000fd5b505060408051338152602081018690526001600160a01b03808816945085811693508816917fe3abb9ec195b50242582cc6cb7abc990ac26439b9ed7635ed72f7bd720e7477a910160405180910390a46105cb565b6000808080610c85858701876116c7565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610cb857610cb8611718565b604051632142170760e11b81526001600160a01b038616906342842e0e90610ce8903090879087906004016116a3565b600060405180830381600087803b158015610d0257600080fd5b505af1158015610d16573d6000803e3d6000fd5b5050604080516001600160a01b03888116825260208201879052808816945085811693508916917f80afffd84aa825dd9b3c1ba262eb55eef58f78616634437a367a263f3c48fe3d91015b60405180910390a450505050505050565b6000808080610d83858701876117b7565b6001600160a01b03808516600090815260376020526040902054949950929750909550935016905080610db857610db8611718565b60005b8251811015610e6357856001600160a01b03166342842e0e30868481518110610de657610de66118a9565b6020026020010151868581518110610e0057610e006118a9565b60200260200101516040518463ffffffff1660e01b8152600401610e26939291906116a3565b600060405180830381600087803b158015610e4057600080fd5b505af1158015610e54573d6000803e3d6000fd5b50505050806001019050610dbb565b50836001600160a01b0316816001600160a01b0316866001600160a01b03167ff64537485d843fa8a1f4354cb9937954c64282de0828be9f096355006222186b8686604051610d619291906118bf565b6001600160a01b03841615801590610ed357506001600160a01b03831615155b8015610ee757506001600160a01b03821615155b8015610efb57506001600160a01b03811615155b610f5f5760405162461bcd60e51b815260206004820152602f60248201527f526f6f744d696e7461626c654552433732315072656469636174653a2042414460448201526e2fa4a724aa24a0a624ad20aa24a7a760891b6064820152608401610460565b603380546001600160a01b039586166001600160a01b0319918216179091556034805494861694821694909417909355603580549285169284169290921790915560368054919093169116179055565b6000610fba86611165565b905060005b8281101561104c57866001600160a01b03166342842e0e3330878786818110610fea57610fea6118a9565b905060200201356040518463ffffffff1660e01b815260040161100f939291906116a3565b600060405180830381600087803b15801561102957600080fd5b505af115801561103d573d6000803e3d6000fd5b50505050806001019050610fbf565b506033546035546040516001600160a01b03928316926316f198319216906110a4907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908b9033908c908c908c908c906020016119be565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016110d0929190611677565b600060405180830381600087803b1580156110ea57600080fd5b505af11580156110fe573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316876001600160a01b03167f0ca5d99e0f7e7651c00c76347baa68a333790cbc9fb039a10843d1bd61f578c5888888886040516111559493929190611a12565b60405180910390a4505050505050565b6001600160a01b0380821660009081526037602052604090205416806111915761118e826105e1565b90505b6001600160a01b0381166111a7576111a7611718565b919050565b6001600160a01b03811681146111c157600080fd5b50565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611202576112026111c4565b604052919050565b60006001600160401b03821115611223576112236111c4565b50601f01601f191660200190565b6000806000806080858703121561124757600080fd5b8435611252816111ac565b93506020850135611262816111ac565b92506040850135915060608501356001600160401b0381111561128457600080fd5b8501601f8101871361129557600080fd5b80356112a86112a38261120a565b6111da565b8181528860208385010111156112bd57600080fd5b8160208401602083013760006020838301015280935050505092959194509250565b600080604083850312156112f257600080fd5b82356112fd816111ac565b946020939093013593505050565b60006020828403121561131d57600080fd5b8135611328816111ac565b9392505050565b6000806000806060858703121561134557600080fd5b843593506020850135611357816111ac565b925060408501356001600160401b038082111561137357600080fd5b818701915087601f83011261138757600080fd5b81358181111561139657600080fd5b8860208285010111156113a857600080fd5b95989497505060200194505050565b6000806000606084860312156113cc57600080fd5b83356113d7816111ac565b925060208401356113e7816111ac565b929592945050506040919091013590565b6000806000806080858703121561140e57600080fd5b8435611419816111ac565b93506020850135611429816111ac565b92506040850135611439816111ac565b91506060850135611449816111ac565b939692955090935050565b60008083601f84011261146657600080fd5b5081356001600160401b0381111561147d57600080fd5b6020830191508360208260051b850101111561149857600080fd5b9250929050565b6000806000806000606086880312156114b757600080fd5b85356114c2816111ac565b945060208601356001600160401b03808211156114de57600080fd5b6114ea89838a01611454565b9096509450604088013591508082111561150357600080fd5b5061151088828901611454565b969995985093965092949392505050565b6000808585111561153157600080fd5b8386111561153e57600080fd5b5050820193919092039150565b8035602083101561156457600019602084900360031b1b165b92915050565b60005b8381101561158557818101518382015260200161156d565b50506000910152565b6000602082840312156115a057600080fd5b81516001600160401b038111156115b657600080fd5b8201601f810184136115c757600080fd5b80516115d56112a38261120a565b8181528560208385010111156115ea57600080fd5b6115fb82602083016020860161156a565b95945050505050565b6000815180845261161c81602086016020860161156a565b601f01601f19169290920160200192915050565b8481526001600160a01b038416602082015260806040820181905260009061165a90830185611604565b828103606084015261166c8185611604565b979650505050505050565b6001600160a01b038316815260406020820181905260009061169b90830184611604565b949350505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b600080600080608085870312156116dd57600080fd5b84356116e8816111ac565b935060208501356116f8816111ac565b92506040850135611708816111ac565b9396929550929360600135925050565b634e487b7160e01b600052600160045260246000fd5b60006001600160401b03821115611747576117476111c4565b5060051b60200190565b600082601f83011261176257600080fd5b813560206117726112a38361172e565b82815260059290921b8401810191818101908684111561179157600080fd5b8286015b848110156117ac5780358352918301918301611795565b509695505050505050565b600080600080600060a086880312156117cf57600080fd5b853594506020808701356117e2816111ac565b945060408701356117f2816111ac565b935060608701356001600160401b038082111561180e57600080fd5b818901915089601f83011261182257600080fd5b81356118306112a38261172e565b81815260059190911b8301840190848101908c83111561184f57600080fd5b938501935b82851015611876578435611867816111ac565b82529385019390850190611854565b96505050608089013592508083111561188e57600080fd5b505061189c88828901611751565b9150509295509295909350565b634e487b7160e01b600052603260045260246000fd5b604080825283519082018190526000906020906060840190828701845b828110156119015781516001600160a01b0316845292840192908401906001016118dc565b5050508381038285015284518082528583019183019060005b818110156119365783518352928401929184019160010161191a565b5090979650505050505050565b8183526000602080850194508260005b85811015611981578135611966816111ac565b6001600160a01b031687529582019590820190600101611953565b509495945050505050565b81835260006001600160fb1b038311156119a557600080fd5b8260051b80836020870137939093016020019392505050565b8781526001600160a01b0387811660208301528616604082015260a0606082018190526000906119f19083018688611943565b8281036080840152611a0481858761198c565b9a9950505050505050505050565b604081526000611a26604083018688611943565b828103602084015261166c81858761198c56fe526f6f744d696e7461626c654552433732315072656469636174653a20494e56a2646970667358221220d56687504a65fbdf30d6fa40bc1481712f630a02ef2aa4dc136cf9be78742d2364736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b506004361061016e5760003560e01c806397e5230d116100ce578063e0563ab111610087578063e0563ab114610353578063eeb499451461035c578063f213159c1461036f578063f4a120f714610382578063f645125514610395578063f8c8765e146103bc578063ff6f870c146103cf57600080fd5b806397e5230d1461029a578063b1768065146102a4578063b68ad1e4146102cb578063c5ac2b1c146102de578063d41f177114610305578063d7c9e3ec1461032c57600080fd5b806347e7ef241161012b57806347e7ef241461020d5780634fdca69d1461022257806351351d531461023557806355b01e4d146102435780635ea5df79146102515780637efab4f514610268578063947287cf1461029157600080fd5b806305dc2e8f1461017357806307b3e252146101a3578063150b7a02146101b15780631bc114ba146101e8578063284017f5146101fb5780633b878c2214610204575b600080fd5b603454610186906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101866004600360981b0181565b6101cf6101bf366004611231565b630a85bd0160e11b949350505050565b6040516001600160e01b0319909116815260200161019a565b603354610186906001600160a01b031681565b61018661202081565b61018661101081565b61022061021b3660046112df565b6103e2565b005b603554610186906001600160a01b031681565b6101866002600160a01b0381565b6101866004600160991b0181565b61025a61138881565b60405190815260200161019a565b61018661027636600461130b565b6037602052600090815260409020546001600160a01b031681565b61025a61520881565b61025a620249f081565b61025a7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b603654610186906001600160a01b031681565b61025a7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b61025a7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61025a7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61018661203081565b61022061036a36600461132f565b6103f1565b61022061037d3660046113b7565b6105d1565b61018661039036600461130b565b6105e1565b61025a7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6102206103ca3660046113f8565b61093a565b6102206103dd36600461149f565b610a97565b6103ed823383610af5565b5050565b6034546001600160a01b031633146104695760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c654552433732315072656469636174653a204f4e4c60448201526f2cafa9aa20aa22afa922a1a2a4ab22a960811b60648201526084015b60405180910390fd5b6035546001600160a01b038481169116146104e05760405162461bcd60e51b815260206004820152603160248201527f526f6f744d696e7461626c654552433732315072656469636174653a204f4e4c604482015270595f4348494c445f50524544494341544560781b6064820152608401610460565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286961050f602060008486611521565b6105189161154b565b036105375761053261052d8260208186611521565b610c74565b6105cb565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed2610566602060008486611521565b61056f9161154b565b0361057e576105328282610d72565b60405162461bcd60e51b815260206004820152602e6024820152600080516020611a3a83398151915260448201526d414c49445f5349474e415455524560901b6064820152608401610460565b50505050565b6105dc838383610af5565b505050565b60006001600160a01b03821661063a5760405162461bcd60e51b815260206004820152602a6024820152600080516020611a3a83398151915260448201526920a624a22faa27a5a2a760b11b6064820152608401610460565b6001600160a01b0382811660009081526037602052604090205416156106b65760405162461bcd60e51b815260206004820152602b60248201527f526f6f744d696e7461626c654552433732315072656469636174653a20414c5260448201526a1150511657d3505414115160aa1b6064820152608401610460565b6035546036546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b039283169260009261076492911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b0385811660008181526037602052604080822080546001600160a01b03191686861617905560335481516306fdde0360e01b81529151959650909316936316f198319387937f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad938b9391926306fdde0392600480830193928290030181865afa1580156107fc573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610824919081019061158e565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610862573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261088a919081019061158e565b60405160200161089d9493929190611630565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016108c9929190611677565b600060405180830381600087803b1580156108e357600080fd5b505af11580156108f7573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a39392505050565b336002600160a01b031461097e5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b6044820152606401610460565b600054610100900460ff161580801561099e5750600054600160ff909116105b806109b85750303b1580156109b8575060005460ff166001145b610a1b5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610460565b6000805460ff191660011790558015610a3e576000805461ff0019166101001790555b610a4a85858585610eb3565b8015610a90576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b828114610ae85760405162461bcd60e51b815260206004820152602b6024820152600080516020611a3a83398151915260448201526a082989288be988a9c8ea8960ab1b6064820152608401610460565b610a908585858585610faf565b6000610b0084611165565b604051632142170760e11b81529091506001600160a01b038516906342842e0e90610b33903390309087906004016116a3565b600060405180830381600087803b158015610b4d57600080fd5b505af1158015610b61573d6000803e3d6000fd5b5050603354603554604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038a811682840152336060830152898116608083015260a08083018a90528351808403909101815260c08301938490526316f1983160e01b90935293841695506316f198319450610bf1939092169160c401611677565b600060405180830381600087803b158015610c0b57600080fd5b505af1158015610c1f573d6000803e3d6000fd5b505060408051338152602081018690526001600160a01b03808816945085811693508816917fe3abb9ec195b50242582cc6cb7abc990ac26439b9ed7635ed72f7bd720e7477a910160405180910390a46105cb565b6000808080610c85858701876116c7565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610cb857610cb8611718565b604051632142170760e11b81526001600160a01b038616906342842e0e90610ce8903090879087906004016116a3565b600060405180830381600087803b158015610d0257600080fd5b505af1158015610d16573d6000803e3d6000fd5b5050604080516001600160a01b03888116825260208201879052808816945085811693508916917f80afffd84aa825dd9b3c1ba262eb55eef58f78616634437a367a263f3c48fe3d91015b60405180910390a450505050505050565b6000808080610d83858701876117b7565b6001600160a01b03808516600090815260376020526040902054949950929750909550935016905080610db857610db8611718565b60005b8251811015610e6357856001600160a01b03166342842e0e30868481518110610de657610de66118a9565b6020026020010151868581518110610e0057610e006118a9565b60200260200101516040518463ffffffff1660e01b8152600401610e26939291906116a3565b600060405180830381600087803b158015610e4057600080fd5b505af1158015610e54573d6000803e3d6000fd5b50505050806001019050610dbb565b50836001600160a01b0316816001600160a01b0316866001600160a01b03167ff64537485d843fa8a1f4354cb9937954c64282de0828be9f096355006222186b8686604051610d619291906118bf565b6001600160a01b03841615801590610ed357506001600160a01b03831615155b8015610ee757506001600160a01b03821615155b8015610efb57506001600160a01b03811615155b610f5f5760405162461bcd60e51b815260206004820152602f60248201527f526f6f744d696e7461626c654552433732315072656469636174653a2042414460448201526e2fa4a724aa24a0a624ad20aa24a7a760891b6064820152608401610460565b603380546001600160a01b039586166001600160a01b0319918216179091556034805494861694821694909417909355603580549285169284169290921790915560368054919093169116179055565b6000610fba86611165565b905060005b8281101561104c57866001600160a01b03166342842e0e3330878786818110610fea57610fea6118a9565b905060200201356040518463ffffffff1660e01b815260040161100f939291906116a3565b600060405180830381600087803b15801561102957600080fd5b505af115801561103d573d6000803e3d6000fd5b50505050806001019050610fbf565b506033546035546040516001600160a01b03928316926316f198319216906110a4907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908b9033908c908c908c908c906020016119be565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016110d0929190611677565b600060405180830381600087803b1580156110ea57600080fd5b505af11580156110fe573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316876001600160a01b03167f0ca5d99e0f7e7651c00c76347baa68a333790cbc9fb039a10843d1bd61f578c5888888886040516111559493929190611a12565b60405180910390a4505050505050565b6001600160a01b0380821660009081526037602052604090205416806111915761118e826105e1565b90505b6001600160a01b0381166111a7576111a7611718565b919050565b6001600160a01b03811681146111c157600080fd5b50565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611202576112026111c4565b604052919050565b60006001600160401b03821115611223576112236111c4565b50601f01601f191660200190565b6000806000806080858703121561124757600080fd5b8435611252816111ac565b93506020850135611262816111ac565b92506040850135915060608501356001600160401b0381111561128457600080fd5b8501601f8101871361129557600080fd5b80356112a86112a38261120a565b6111da565b8181528860208385010111156112bd57600080fd5b8160208401602083013760006020838301015280935050505092959194509250565b600080604083850312156112f257600080fd5b82356112fd816111ac565b946020939093013593505050565b60006020828403121561131d57600080fd5b8135611328816111ac565b9392505050565b6000806000806060858703121561134557600080fd5b843593506020850135611357816111ac565b925060408501356001600160401b038082111561137357600080fd5b818701915087601f83011261138757600080fd5b81358181111561139657600080fd5b8860208285010111156113a857600080fd5b95989497505060200194505050565b6000806000606084860312156113cc57600080fd5b83356113d7816111ac565b925060208401356113e7816111ac565b929592945050506040919091013590565b6000806000806080858703121561140e57600080fd5b8435611419816111ac565b93506020850135611429816111ac565b92506040850135611439816111ac565b91506060850135611449816111ac565b939692955090935050565b60008083601f84011261146657600080fd5b5081356001600160401b0381111561147d57600080fd5b6020830191508360208260051b850101111561149857600080fd5b9250929050565b6000806000806000606086880312156114b757600080fd5b85356114c2816111ac565b945060208601356001600160401b03808211156114de57600080fd5b6114ea89838a01611454565b9096509450604088013591508082111561150357600080fd5b5061151088828901611454565b969995985093965092949392505050565b6000808585111561153157600080fd5b8386111561153e57600080fd5b5050820193919092039150565b8035602083101561156457600019602084900360031b1b165b92915050565b60005b8381101561158557818101518382015260200161156d565b50506000910152565b6000602082840312156115a057600080fd5b81516001600160401b038111156115b657600080fd5b8201601f810184136115c757600080fd5b80516115d56112a38261120a565b8181528560208385010111156115ea57600080fd5b6115fb82602083016020860161156a565b95945050505050565b6000815180845261161c81602086016020860161156a565b601f01601f19169290920160200192915050565b8481526001600160a01b038416602082015260806040820181905260009061165a90830185611604565b828103606084015261166c8185611604565b979650505050505050565b6001600160a01b038316815260406020820181905260009061169b90830184611604565b949350505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b600080600080608085870312156116dd57600080fd5b84356116e8816111ac565b935060208501356116f8816111ac565b92506040850135611708816111ac565b9396929550929360600135925050565b634e487b7160e01b600052600160045260246000fd5b60006001600160401b03821115611747576117476111c4565b5060051b60200190565b600082601f83011261176257600080fd5b813560206117726112a38361172e565b82815260059290921b8401810191818101908684111561179157600080fd5b8286015b848110156117ac5780358352918301918301611795565b509695505050505050565b600080600080600060a086880312156117cf57600080fd5b853594506020808701356117e2816111ac565b945060408701356117f2816111ac565b935060608701356001600160401b038082111561180e57600080fd5b818901915089601f83011261182257600080fd5b81356118306112a38261172e565b81815260059190911b8301840190848101908c83111561184f57600080fd5b938501935b82851015611876578435611867816111ac565b82529385019390850190611854565b96505050608089013592508083111561188e57600080fd5b505061189c88828901611751565b9150509295509295909350565b634e487b7160e01b600052603260045260246000fd5b604080825283519082018190526000906020906060840190828701845b828110156119015781516001600160a01b0316845292840192908401906001016118dc565b5050508381038285015284518082528583019183019060005b818110156119365783518352928401929184019160010161191a565b5090979650505050505050565b8183526000602080850194508260005b85811015611981578135611966816111ac565b6001600160a01b031687529582019590820190600101611953565b509495945050505050565b81835260006001600160fb1b038311156119a557600080fd5b8260051b80836020870137939093016020019392505050565b8781526001600160a01b0387811660208301528616604082015260a0606082018190526000906119f19083018688611943565b8281036080840152611a0481858761198c565b9a9950505050505050505050565b604081526000611a26604083018688611943565b828103602084015261166c81858761198c56fe526f6f744d696e7461626c654552433732315072656469636174653a20494e56a2646970667358221220d56687504a65fbdf30d6fa40bc1481712f630a02ef2aa4dc136cf9be78742d2364736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RootMintableERC721PredicateACLArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RootMintableERC721PredicateAccessList","sourceName":"contracts/child/RootMintableERC721PredicateAccessList.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"AllowListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"BlockListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"depositor","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"L2MintableERC721Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"depositor","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"L2MintableERC721DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"L2MintableERC721Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"L2MintableERC721WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2MintableTokenMapped","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"childERC721Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"depositBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"depositTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newChildERC721Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"},{"internalType":"bool","name":"newUseAllowList","type":"bool"},{"internalType":"bool","name":"newUseBlockList","type":"bool"},{"internalType":"address","name":"newOwner","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newChildERC721Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"}],"name":"mapToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC721Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseAllowList","type":"bool"}],"name":"setAllowList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseBlockList","type":"bool"}],"name":"setBlockList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50612231806100206000396000f3fe608060405234801561001057600080fd5b50600436106101e65760003560e01c8063b17680651161010a578063e0563ab1116100ad578063f2fde38b1161007c578063f2fde38b14610466578063f4a120f714610479578063f64512551461048c578063f8c8765e146104b3578063ff6f870c146104c657600080fd5b8063e0563ab114610426578063e30c39781461042f578063eeb4994514610440578063f213159c1461045357600080fd5b8063b17680651461033e578063b68ad1e414610365578063c1225a2014610378578063c5ac2b1c1461038b578063c5e4683a146103b2578063d41f1771146103c5578063d7c9e3ec146103ec578063d8dd17731461041357600080fd5b806351351d531161018d57806379ba50971161015c57806379ba5097146102e85780637efab4f5146102f05780638da5cb5b1461031a578063947287cf1461032b57806397e5230d1461033457600080fd5b806351351d53146102ad57806355b01e4d146102bb5780635ea5df79146102c9578063715018a6146102e057600080fd5b806305dc2e8f146101eb57806307b3e2521461021b578063150b7a02146102295780631bc114ba14610260578063284017f5146102735780633b878c221461027c57806347e7ef24146102855780634fdca69d1461029a575b600080fd5b60fd546101fe906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101fe6004600360981b0181565b61024761023736600461186f565b630a85bd0160e11b949350505050565b6040516001600160e01b03199091168152602001610212565b60fc546101fe906001600160a01b031681565b6101fe61202081565b6101fe61101081565b61029861029336600461191d565b6104d9565b005b60fe546101fe906001600160a01b031681565b6101fe6002600160a01b0381565b6101fe6004600160991b0181565b6102d261138881565b604051908152602001610212565b6102986104e8565b6102986104fc565b6101fe6102fe366004611949565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b03166101fe565b6102d261520881565b6102d2620249f081565b6102d27f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff546101fe906001600160a01b031681565b61029861038636600461197d565b61057b565b6102d27faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6102986103c036600461197d565b6105ca565b6102d27f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102d27f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b610298610421366004611998565b610611565b6101fe61203081565b6065546001600160a01b03166101fe565b61029861044e366004611a2a565b610732565b610298610461366004611ab2565b61090d565b610298610474366004611949565b61091d565b6101fe610487366004611949565b61098e565b6102d27f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6102986104c1366004611af3565b610ce9565b6102986104d4366004611b9a565b610de2565b6104e4823383610e40565b5050565b6104f0610fc7565b6104fa6000611021565b565b60655433906001600160a01b0316811461056f5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61057881611021565b50565b610583610fc7565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b6105d2610fc7565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b03146106385760405163973d02cb60e01b815260040161056690611c1c565b600054610100900460ff16158080156106585750600054600160ff909116105b806106725750303b158015610672575060005460ff166001145b61068e5760405162461bcd60e51b815260040161056690611c40565b6000805460ff1916600117905580156106b1576000805461ff0019166101001790555b6106bd8888888861103a565b60c9805461ffff191685151561ff00191617610100851515021790556106e282611021565b8015610728576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146107a55760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c654552433732315072656469636174653a204f4e4c60448201526f2cafa9aa20aa22afa922a1a2a4ab22a960811b6064820152608401610566565b60fe546001600160a01b0384811691161461081c5760405162461bcd60e51b815260206004820152603160248201527f526f6f744d696e7461626c654552433732315072656469636174653a204f4e4c604482015270595f4348494c445f50524544494341544560781b6064820152608401610566565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286961084b602060008486611c8e565b61085491611cb8565b036108735761086e6108698260208186611c8e565b611136565b610907565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed26108a2602060008486611c8e565b6108ab91611cb8565b036108ba5761086e8282611235565b60405162461bcd60e51b815260206004820152602e60248201526000805160206121dc83398151915260448201526d414c49445f5349474e415455524560901b6064820152608401610566565b50505050565b610918838383610e40565b505050565b610925610fc7565b606580546001600160a01b0383166001600160a01b031990911681179091556109566033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60006001600160a01b0382166109e75760405162461bcd60e51b815260206004820152602a60248201526000805160206121dc83398151915260448201526920a624a22faa27a5a2a760b11b6064820152608401610566565b6001600160a01b03828116600090815261010060205260409020541615610a645760405162461bcd60e51b815260206004820152602b60248201527f526f6f744d696e7461626c654552433732315072656469636174653a20414c5260448201526a1150511657d3505414115160aa1b6064820152608401610566565b60fe5460ff546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b0392831692600092610b1292911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b038581166000818152610100602052604080822080546001600160a01b03191686861617905560fc5481516306fdde0360e01b81529151959650909316936316f198319387937f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad938b9391926306fdde0392600480830193928290030181865afa158015610bab573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610bd39190810190611cfb565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610c11573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610c399190810190611cfb565b604051602001610c4c9493929190611d9d565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610c78929190611de4565b600060405180830381600087803b158015610c9257600080fd5b505af1158015610ca6573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a39392505050565b336002600160a01b0314610d105760405163973d02cb60e01b815260040161056690611c1c565b600054610100900460ff1615808015610d305750600054600160ff909116105b80610d4a5750303b158015610d4a575060005460ff166001145b610d665760405162461bcd60e51b815260040161056690611c40565b6000805460ff191660011790558015610d89576000805461ff0019166101001790555b610d958585858561103a565b8015610ddb576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b828114610e335760405162461bcd60e51b815260206004820152602b60248201526000805160206121dc83398151915260448201526a082989288be988a9c8ea8960ab1b6064820152608401610566565b610ddb8585858585611377565b610e48611535565b6000610e538461153d565b604051632142170760e11b81529091506001600160a01b038516906342842e0e90610e8690339030908790600401611e10565b600060405180830381600087803b158015610ea057600080fd5b505af1158015610eb4573d6000803e3d6000fd5b505060fc5460fe54604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038a811682840152336060830152898116608083015260a08083018a90528351808403909101815260c08301938490526316f1983160e01b90935293841695506316f198319450610f44939092169160c401611de4565b600060405180830381600087803b158015610f5e57600080fd5b505af1158015610f72573d6000803e3d6000fd5b505060408051338152602081018690526001600160a01b03808816945085811693508816917fe3abb9ec195b50242582cc6cb7abc990ac26439b9ed7635ed72f7bd720e7477a910160405180910390a4610907565b6033546001600160a01b031633146104fa5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610566565b606580546001600160a01b031916905561057881611585565b6001600160a01b0384161580159061105a57506001600160a01b03831615155b801561106e57506001600160a01b03821615155b801561108257506001600160a01b03811615155b6110e65760405162461bcd60e51b815260206004820152602f60248201527f526f6f744d696e7461626c654552433732315072656469636174653a2042414460448201526e2fa4a724aa24a0a624ad20aa24a7a760891b6064820152608401610566565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b600080808061114785870187611e34565b6001600160a01b03808516600090815261010060205260409020549498509296509094509250168061117b5761117b611e85565b604051632142170760e11b81526001600160a01b038616906342842e0e906111ab90309087908790600401611e10565b600060405180830381600087803b1580156111c557600080fd5b505af11580156111d9573d6000803e3d6000fd5b5050604080516001600160a01b03888116825260208201879052808816945085811693508916917f80afffd84aa825dd9b3c1ba262eb55eef58f78616634437a367a263f3c48fe3d91015b60405180910390a450505050505050565b600080808061124685870187611f24565b6001600160a01b038085166000908152610100602052604090205494995092975090955093501690508061127c5761127c611e85565b60005b825181101561132757856001600160a01b03166342842e0e308684815181106112aa576112aa612016565b60200260200101518685815181106112c4576112c4612016565b60200260200101516040518463ffffffff1660e01b81526004016112ea93929190611e10565b600060405180830381600087803b15801561130457600080fd5b505af1158015611318573d6000803e3d6000fd5b5050505080600101905061127f565b50836001600160a01b0316816001600160a01b0316866001600160a01b03167ff64537485d843fa8a1f4354cb9937954c64282de0828be9f096355006222186b868660405161122492919061202c565b61137f611535565b600061138a8661153d565b905060005b8281101561141c57866001600160a01b03166342842e0e33308787868181106113ba576113ba612016565b905060200201356040518463ffffffff1660e01b81526004016113df93929190611e10565b600060405180830381600087803b1580156113f957600080fd5b505af115801561140d573d6000803e3d6000fd5b5050505080600101905061138f565b5060fc5460fe546040516001600160a01b03928316926316f19831921690611474907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908b9033908c908c908c908c9060200161212b565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016114a0929190611de4565b600060405180830381600087803b1580156114ba57600080fd5b505af11580156114ce573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316876001600160a01b03167f0ca5d99e0f7e7651c00c76347baa68a333790cbc9fb039a10843d1bd61f578c588888888604051611525949392919061217f565b60405180910390a4505050505050565b6104fa6115d7565b6001600160a01b0380821660009081526101006020526040902054168061156a576115678261098e565b90505b6001600160a01b03811661158057611580611e85565b919050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60c95460ff16156116e257604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161163991906121a6565b6000604051808303818686fa925050503d8060008114611675576040519150601f19603f3d011682016040523d82523d6000602084013e61167a565b606091505b509150915081801561169f575060008180602001905181019061169d91906121c2565b115b6116df5760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b6044820152606401610566565b50505b60c954610100900460ff16156104fa57604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b01916113889161174991906121a6565b6000604051808303818686fa925050503d8060008114611785576040519150601f19603f3d011682016040523d82523d6000602084013e61178a565b606091505b50915091508180156117b05750808060200190518101906117ab91906121c2565b600114155b6104e45760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b6044820152606401610566565b6001600160a01b038116811461057857600080fd5b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561184057611840611802565b604052919050565b60006001600160401b0382111561186157611861611802565b50601f01601f191660200190565b6000806000806080858703121561188557600080fd5b8435611890816117ed565b935060208501356118a0816117ed565b92506040850135915060608501356001600160401b038111156118c257600080fd5b8501601f810187136118d357600080fd5b80356118e66118e182611848565b611818565b8181528860208385010111156118fb57600080fd5b8160208401602083013760006020838301015280935050505092959194509250565b6000806040838503121561193057600080fd5b823561193b816117ed565b946020939093013593505050565b60006020828403121561195b57600080fd5b8135611966816117ed565b9392505050565b8035801515811461158057600080fd5b60006020828403121561198f57600080fd5b6119668261196d565b600080600080600080600060e0888a0312156119b357600080fd5b87356119be816117ed565b965060208801356119ce816117ed565b955060408801356119de816117ed565b945060608801356119ee816117ed565b93506119fc6080890161196d565b9250611a0a60a0890161196d565b915060c0880135611a1a816117ed565b8091505092959891949750929550565b60008060008060608587031215611a4057600080fd5b843593506020850135611a52816117ed565b925060408501356001600160401b0380821115611a6e57600080fd5b818701915087601f830112611a8257600080fd5b813581811115611a9157600080fd5b886020828501011115611aa357600080fd5b95989497505060200194505050565b600080600060608486031215611ac757600080fd5b8335611ad2816117ed565b92506020840135611ae2816117ed565b929592945050506040919091013590565b60008060008060808587031215611b0957600080fd5b8435611b14816117ed565b93506020850135611b24816117ed565b92506040850135611b34816117ed565b91506060850135611b44816117ed565b939692955090935050565b60008083601f840112611b6157600080fd5b5081356001600160401b03811115611b7857600080fd5b6020830191508360208260051b8501011115611b9357600080fd5b9250929050565b600080600080600060608688031215611bb257600080fd5b8535611bbd816117ed565b945060208601356001600160401b0380821115611bd957600080fd5b611be589838a01611b4f565b90965094506040880135915080821115611bfe57600080fd5b50611c0b88828901611b4f565b969995985093965092949392505050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b60008085851115611c9e57600080fd5b83861115611cab57600080fd5b5050820193919092039150565b80356020831015611cd157600019602084900360031b1b165b92915050565b60005b83811015611cf2578181015183820152602001611cda565b50506000910152565b600060208284031215611d0d57600080fd5b81516001600160401b03811115611d2357600080fd5b8201601f81018413611d3457600080fd5b8051611d426118e182611848565b818152856020838501011115611d5757600080fd5b611d68826020830160208601611cd7565b95945050505050565b60008151808452611d89816020860160208601611cd7565b601f01601f19169290920160200192915050565b8481526001600160a01b0384166020820152608060408201819052600090611dc790830185611d71565b8281036060840152611dd98185611d71565b979650505050505050565b6001600160a01b0383168152604060208201819052600090611e0890830184611d71565b949350505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b60008060008060808587031215611e4a57600080fd5b8435611e55816117ed565b93506020850135611e65816117ed565b92506040850135611e75816117ed565b9396929550929360600135925050565b634e487b7160e01b600052600160045260246000fd5b60006001600160401b03821115611eb457611eb4611802565b5060051b60200190565b600082601f830112611ecf57600080fd5b81356020611edf6118e183611e9b565b82815260059290921b84018101918181019086841115611efe57600080fd5b8286015b84811015611f195780358352918301918301611f02565b509695505050505050565b600080600080600060a08688031215611f3c57600080fd5b85359450602080870135611f4f816117ed565b94506040870135611f5f816117ed565b935060608701356001600160401b0380821115611f7b57600080fd5b818901915089601f830112611f8f57600080fd5b8135611f9d6118e182611e9b565b81815260059190911b8301840190848101908c831115611fbc57600080fd5b938501935b82851015611fe3578435611fd4816117ed565b82529385019390850190611fc1565b965050506080890135925080831115611ffb57600080fd5b505061200988828901611ebe565b9150509295509295909350565b634e487b7160e01b600052603260045260246000fd5b604080825283519082018190526000906020906060840190828701845b8281101561206e5781516001600160a01b031684529284019290840190600101612049565b5050508381038285015284518082528583019183019060005b818110156120a357835183529284019291840191600101612087565b5090979650505050505050565b8183526000602080850194508260005b858110156120ee5781356120d3816117ed565b6001600160a01b0316875295820195908201906001016120c0565b509495945050505050565b81835260006001600160fb1b0383111561211257600080fd5b8260051b80836020870137939093016020019392505050565b8781526001600160a01b0387811660208301528616604082015260a06060820181905260009061215e90830186886120b0565b82810360808401526121718185876120f9565b9a9950505050505050505050565b6040815260006121936040830186886120b0565b8281036020840152611dd98185876120f9565b600082516121b8818460208701611cd7565b9190910192915050565b6000602082840312156121d457600080fd5b505191905056fe526f6f744d696e7461626c654552433732315072656469636174653a20494e56a26469706673582212204063e808f9818c931a3cdbf2406d8b4f218ddd313bef99b78b2b8455373be0c864736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101e65760003560e01c8063b17680651161010a578063e0563ab1116100ad578063f2fde38b1161007c578063f2fde38b14610466578063f4a120f714610479578063f64512551461048c578063f8c8765e146104b3578063ff6f870c146104c657600080fd5b8063e0563ab114610426578063e30c39781461042f578063eeb4994514610440578063f213159c1461045357600080fd5b8063b17680651461033e578063b68ad1e414610365578063c1225a2014610378578063c5ac2b1c1461038b578063c5e4683a146103b2578063d41f1771146103c5578063d7c9e3ec146103ec578063d8dd17731461041357600080fd5b806351351d531161018d57806379ba50971161015c57806379ba5097146102e85780637efab4f5146102f05780638da5cb5b1461031a578063947287cf1461032b57806397e5230d1461033457600080fd5b806351351d53146102ad57806355b01e4d146102bb5780635ea5df79146102c9578063715018a6146102e057600080fd5b806305dc2e8f146101eb57806307b3e2521461021b578063150b7a02146102295780631bc114ba14610260578063284017f5146102735780633b878c221461027c57806347e7ef24146102855780634fdca69d1461029a575b600080fd5b60fd546101fe906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6101fe6004600360981b0181565b61024761023736600461186f565b630a85bd0160e11b949350505050565b6040516001600160e01b03199091168152602001610212565b60fc546101fe906001600160a01b031681565b6101fe61202081565b6101fe61101081565b61029861029336600461191d565b6104d9565b005b60fe546101fe906001600160a01b031681565b6101fe6002600160a01b0381565b6101fe6004600160991b0181565b6102d261138881565b604051908152602001610212565b6102986104e8565b6102986104fc565b6101fe6102fe366004611949565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b03166101fe565b6102d261520881565b6102d2620249f081565b6102d27f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff546101fe906001600160a01b031681565b61029861038636600461197d565b61057b565b6102d27faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6102986103c036600461197d565b6105ca565b6102d27f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102d27f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b610298610421366004611998565b610611565b6101fe61203081565b6065546001600160a01b03166101fe565b61029861044e366004611a2a565b610732565b610298610461366004611ab2565b61090d565b610298610474366004611949565b61091d565b6101fe610487366004611949565b61098e565b6102d27f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6102986104c1366004611af3565b610ce9565b6102986104d4366004611b9a565b610de2565b6104e4823383610e40565b5050565b6104f0610fc7565b6104fa6000611021565b565b60655433906001600160a01b0316811461056f5760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b61057881611021565b50565b610583610fc7565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b6105d2610fc7565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b03146106385760405163973d02cb60e01b815260040161056690611c1c565b600054610100900460ff16158080156106585750600054600160ff909116105b806106725750303b158015610672575060005460ff166001145b61068e5760405162461bcd60e51b815260040161056690611c40565b6000805460ff1916600117905580156106b1576000805461ff0019166101001790555b6106bd8888888861103a565b60c9805461ffff191685151561ff00191617610100851515021790556106e282611021565b8015610728576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146107a55760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c654552433732315072656469636174653a204f4e4c60448201526f2cafa9aa20aa22afa922a1a2a4ab22a960811b6064820152608401610566565b60fe546001600160a01b0384811691161461081c5760405162461bcd60e51b815260206004820152603160248201527f526f6f744d696e7461626c654552433732315072656469636174653a204f4e4c604482015270595f4348494c445f50524544494341544560781b6064820152608401610566565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286961084b602060008486611c8e565b61085491611cb8565b036108735761086e6108698260208186611c8e565b611136565b610907565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed26108a2602060008486611c8e565b6108ab91611cb8565b036108ba5761086e8282611235565b60405162461bcd60e51b815260206004820152602e60248201526000805160206121dc83398151915260448201526d414c49445f5349474e415455524560901b6064820152608401610566565b50505050565b610918838383610e40565b505050565b610925610fc7565b606580546001600160a01b0383166001600160a01b031990911681179091556109566033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60006001600160a01b0382166109e75760405162461bcd60e51b815260206004820152602a60248201526000805160206121dc83398151915260448201526920a624a22faa27a5a2a760b11b6064820152608401610566565b6001600160a01b03828116600090815261010060205260409020541615610a645760405162461bcd60e51b815260206004820152602b60248201527f526f6f744d696e7461626c654552433732315072656469636174653a20414c5260448201526a1150511657d3505414115160aa1b6064820152608401610566565b60fe5460ff546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b0392831692600092610b1292911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b038581166000818152610100602052604080822080546001600160a01b03191686861617905560fc5481516306fdde0360e01b81529151959650909316936316f198319387937f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad938b9391926306fdde0392600480830193928290030181865afa158015610bab573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610bd39190810190611cfb565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610c11573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610c399190810190611cfb565b604051602001610c4c9493929190611d9d565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610c78929190611de4565b600060405180830381600087803b158015610c9257600080fd5b505af1158015610ca6573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a39392505050565b336002600160a01b0314610d105760405163973d02cb60e01b815260040161056690611c1c565b600054610100900460ff1615808015610d305750600054600160ff909116105b80610d4a5750303b158015610d4a575060005460ff166001145b610d665760405162461bcd60e51b815260040161056690611c40565b6000805460ff191660011790558015610d89576000805461ff0019166101001790555b610d958585858561103a565b8015610ddb576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b828114610e335760405162461bcd60e51b815260206004820152602b60248201526000805160206121dc83398151915260448201526a082989288be988a9c8ea8960ab1b6064820152608401610566565b610ddb8585858585611377565b610e48611535565b6000610e538461153d565b604051632142170760e11b81529091506001600160a01b038516906342842e0e90610e8690339030908790600401611e10565b600060405180830381600087803b158015610ea057600080fd5b505af1158015610eb4573d6000803e3d6000fd5b505060fc5460fe54604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038a811682840152336060830152898116608083015260a08083018a90528351808403909101815260c08301938490526316f1983160e01b90935293841695506316f198319450610f44939092169160c401611de4565b600060405180830381600087803b158015610f5e57600080fd5b505af1158015610f72573d6000803e3d6000fd5b505060408051338152602081018690526001600160a01b03808816945085811693508816917fe3abb9ec195b50242582cc6cb7abc990ac26439b9ed7635ed72f7bd720e7477a910160405180910390a4610907565b6033546001600160a01b031633146104fa5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152606401610566565b606580546001600160a01b031916905561057881611585565b6001600160a01b0384161580159061105a57506001600160a01b03831615155b801561106e57506001600160a01b03821615155b801561108257506001600160a01b03811615155b6110e65760405162461bcd60e51b815260206004820152602f60248201527f526f6f744d696e7461626c654552433732315072656469636174653a2042414460448201526e2fa4a724aa24a0a624ad20aa24a7a760891b6064820152608401610566565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b600080808061114785870187611e34565b6001600160a01b03808516600090815261010060205260409020549498509296509094509250168061117b5761117b611e85565b604051632142170760e11b81526001600160a01b038616906342842e0e906111ab90309087908790600401611e10565b600060405180830381600087803b1580156111c557600080fd5b505af11580156111d9573d6000803e3d6000fd5b5050604080516001600160a01b03888116825260208201879052808816945085811693508916917f80afffd84aa825dd9b3c1ba262eb55eef58f78616634437a367a263f3c48fe3d91015b60405180910390a450505050505050565b600080808061124685870187611f24565b6001600160a01b038085166000908152610100602052604090205494995092975090955093501690508061127c5761127c611e85565b60005b825181101561132757856001600160a01b03166342842e0e308684815181106112aa576112aa612016565b60200260200101518685815181106112c4576112c4612016565b60200260200101516040518463ffffffff1660e01b81526004016112ea93929190611e10565b600060405180830381600087803b15801561130457600080fd5b505af1158015611318573d6000803e3d6000fd5b5050505080600101905061127f565b50836001600160a01b0316816001600160a01b0316866001600160a01b03167ff64537485d843fa8a1f4354cb9937954c64282de0828be9f096355006222186b868660405161122492919061202c565b61137f611535565b600061138a8661153d565b905060005b8281101561141c57866001600160a01b03166342842e0e33308787868181106113ba576113ba612016565b905060200201356040518463ffffffff1660e01b81526004016113df93929190611e10565b600060405180830381600087803b1580156113f957600080fd5b505af115801561140d573d6000803e3d6000fd5b5050505080600101905061138f565b5060fc5460fe546040516001600160a01b03928316926316f19831921690611474907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908b9033908c908c908c908c9060200161212b565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016114a0929190611de4565b600060405180830381600087803b1580156114ba57600080fd5b505af11580156114ce573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316876001600160a01b03167f0ca5d99e0f7e7651c00c76347baa68a333790cbc9fb039a10843d1bd61f578c588888888604051611525949392919061217f565b60405180910390a4505050505050565b6104fa6115d7565b6001600160a01b0380821660009081526101006020526040902054168061156a576115678261098e565b90505b6001600160a01b03811661158057611580611e85565b919050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60c95460ff16156116e257604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161163991906121a6565b6000604051808303818686fa925050503d8060008114611675576040519150601f19603f3d011682016040523d82523d6000602084013e61167a565b606091505b509150915081801561169f575060008180602001905181019061169d91906121c2565b115b6116df5760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b6044820152606401610566565b50505b60c954610100900460ff16156104fa57604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b01916113889161174991906121a6565b6000604051808303818686fa925050503d8060008114611785576040519150601f19603f3d011682016040523d82523d6000602084013e61178a565b606091505b50915091508180156117b05750808060200190518101906117ab91906121c2565b600114155b6104e45760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b6044820152606401610566565b6001600160a01b038116811461057857600080fd5b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561184057611840611802565b604052919050565b60006001600160401b0382111561186157611861611802565b50601f01601f191660200190565b6000806000806080858703121561188557600080fd5b8435611890816117ed565b935060208501356118a0816117ed565b92506040850135915060608501356001600160401b038111156118c257600080fd5b8501601f810187136118d357600080fd5b80356118e66118e182611848565b611818565b8181528860208385010111156118fb57600080fd5b8160208401602083013760006020838301015280935050505092959194509250565b6000806040838503121561193057600080fd5b823561193b816117ed565b946020939093013593505050565b60006020828403121561195b57600080fd5b8135611966816117ed565b9392505050565b8035801515811461158057600080fd5b60006020828403121561198f57600080fd5b6119668261196d565b600080600080600080600060e0888a0312156119b357600080fd5b87356119be816117ed565b965060208801356119ce816117ed565b955060408801356119de816117ed565b945060608801356119ee816117ed565b93506119fc6080890161196d565b9250611a0a60a0890161196d565b915060c0880135611a1a816117ed565b8091505092959891949750929550565b60008060008060608587031215611a4057600080fd5b843593506020850135611a52816117ed565b925060408501356001600160401b0380821115611a6e57600080fd5b818701915087601f830112611a8257600080fd5b813581811115611a9157600080fd5b886020828501011115611aa357600080fd5b95989497505060200194505050565b600080600060608486031215611ac757600080fd5b8335611ad2816117ed565b92506020840135611ae2816117ed565b929592945050506040919091013590565b60008060008060808587031215611b0957600080fd5b8435611b14816117ed565b93506020850135611b24816117ed565b92506040850135611b34816117ed565b91506060850135611b44816117ed565b939692955090935050565b60008083601f840112611b6157600080fd5b5081356001600160401b03811115611b7857600080fd5b6020830191508360208260051b8501011115611b9357600080fd5b9250929050565b600080600080600060608688031215611bb257600080fd5b8535611bbd816117ed565b945060208601356001600160401b0380821115611bd957600080fd5b611be589838a01611b4f565b90965094506040880135915080821115611bfe57600080fd5b50611c0b88828901611b4f565b969995985093965092949392505050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b60008085851115611c9e57600080fd5b83861115611cab57600080fd5b5050820193919092039150565b80356020831015611cd157600019602084900360031b1b165b92915050565b60005b83811015611cf2578181015183820152602001611cda565b50506000910152565b600060208284031215611d0d57600080fd5b81516001600160401b03811115611d2357600080fd5b8201601f81018413611d3457600080fd5b8051611d426118e182611848565b818152856020838501011115611d5757600080fd5b611d68826020830160208601611cd7565b95945050505050565b60008151808452611d89816020860160208601611cd7565b601f01601f19169290920160200192915050565b8481526001600160a01b0384166020820152608060408201819052600090611dc790830185611d71565b8281036060840152611dd98185611d71565b979650505050505050565b6001600160a01b0383168152604060208201819052600090611e0890830184611d71565b949350505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b60008060008060808587031215611e4a57600080fd5b8435611e55816117ed565b93506020850135611e65816117ed565b92506040850135611e75816117ed565b9396929550929360600135925050565b634e487b7160e01b600052600160045260246000fd5b60006001600160401b03821115611eb457611eb4611802565b5060051b60200190565b600082601f830112611ecf57600080fd5b81356020611edf6118e183611e9b565b82815260059290921b84018101918181019086841115611efe57600080fd5b8286015b84811015611f195780358352918301918301611f02565b509695505050505050565b600080600080600060a08688031215611f3c57600080fd5b85359450602080870135611f4f816117ed565b94506040870135611f5f816117ed565b935060608701356001600160401b0380821115611f7b57600080fd5b818901915089601f830112611f8f57600080fd5b8135611f9d6118e182611e9b565b81815260059190911b8301840190848101908c831115611fbc57600080fd5b938501935b82851015611fe3578435611fd4816117ed565b82529385019390850190611fc1565b965050506080890135925080831115611ffb57600080fd5b505061200988828901611ebe565b9150509295509295909350565b634e487b7160e01b600052603260045260246000fd5b604080825283519082018190526000906020906060840190828701845b8281101561206e5781516001600160a01b031684529284019290840190600101612049565b5050508381038285015284518082528583019183019060005b818110156120a357835183529284019291840191600101612087565b5090979650505050505050565b8183526000602080850194508260005b858110156120ee5781356120d3816117ed565b6001600160a01b0316875295820195908201906001016120c0565b509495945050505050565b81835260006001600160fb1b0383111561211257600080fd5b8260051b80836020870137939093016020019392505050565b8781526001600160a01b0387811660208301528616604082015260a06060820181905260009061215e90830186886120b0565b82810360808401526121718185876120f9565b9a9950505050505050505050565b6040815260006121936040830186886120b0565b8281036020840152611dd98185876120f9565b600082516121b8818460208701611cd7565b9190910192915050565b6000602082840312156121d457600080fd5b505191905056fe526f6f744d696e7461626c654552433732315072656469636174653a20494e56a26469706673582212204063e808f9818c931a3cdbf2406d8b4f218ddd313bef99b78b2b8455373be0c864736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildERC1155Artifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildERC1155","sourceName":"contracts/child/ChildERC1155.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"userAddress","type":"address"},{"indexed":false,"internalType":"address","name":"relayerAddress","type":"address"},{"indexed":false,"internalType":"bytes","name":"functionSignature","type":"bytes"}],"name":"MetaTransactionExecuted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"TransferBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"TransferSingle","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"value","type":"string"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"}],"name":"URI","type":"event"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"}],"name":"balanceOfBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"burnBatch","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"userAddress","type":"address"},{"internalType":"bytes","name":"functionSignature","type":"bytes"},{"internalType":"bytes32","name":"sigR","type":"bytes32"},{"internalType":"bytes32","name":"sigS","type":"bytes32"},{"internalType":"uint8","name":"sigV","type":"uint8"}],"name":"executeMetaTransaction","outputs":[{"internalType":"bytes","name":"","type":"bytes"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"getNonce","outputs":[{"internalType":"uint256","name":"nonce","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"rootToken_","type":"address"},{"internalType":"string","name":"uri_","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"offset","type":"uint256"}],"name":"invalidateNext","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"mint","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"mintBatch","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rootToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeBatchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"uri","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50612b8b806100206000396000f3fe608060405234801561001057600080fd5b50600436106101155760003560e01c806357128683116100a2578063e619870511610071578063e619870514610279578063e985e9c51461028b578063f242432a146102c7578063f399e22e146102da578063f5298aca146102ed57600080fd5b8063571286831461022d5780636b20c454146102405780639b77ef1114610253578063a22cb4651461026657600080fd5b8063156e29f6116100e9578063156e29f6146101965780631f2d0065146101a95780632d0335ab146101cf5780632eb2c2d6146101f85780634e1273f41461020d57600080fd5b8062fdd58e1461011a57806301ffc9a7146101405780630c53c51c146101635780630e89341c14610183575b600080fd5b61012d610128366004611cd5565b610300565b6040519081526020015b60405180910390f35b61015361014e366004611d15565b61039b565b6040519015158152602001610137565b610176610171366004611d7a565b6103eb565b6040516101379190611e49565b610176610191366004611e5c565b6106c9565b6101536101a4366004611e75565b61075d565b610103546001600160a01b03165b6040516001600160a01b039091168152602001610137565b61012d6101dd366004611ea8565b6001600160a01b031660009081526038602052604090205490565b61020b61020636600461200c565b6107b0565b005b61022061021b3660046120b5565b61080e565b60405161013791906121ba565b61015361023b366004612211565b610937565b61015361024e3660046122aa565b610a53565b61020b610261366004611e5c565b610afb565b61020b61027436600461232a565b610b22565b610102546001600160a01b03166101b7565b610153610299366004612366565b6001600160a01b03918216600090815260d16020908152604080832093909416825291909152205460ff1690565b61020b6102d5366004612399565b610b38565b61020b6102e83660046123fd565b610b8f565b6101536102fb366004611e75565b610da5565b60006001600160a01b0383166103705760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b50600081815260d0602090815260408083206001600160a01b03861684529091529020545b92915050565b60006001600160e01b03198216636cdb3d1360e11b14806103cc57506001600160e01b031982166303a24d0760e21b145b8061039557506301ffc9a760e01b6001600160e01b0319831614610395565b6060600061042e87878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610dde92505050565b90506001600160e01b03196000358116908216036104b45760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f640000006064820152608401610367565b604080516060810182526001600160a01b038a16600081815260386020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506105258982888888610df9565b61057b5760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b6064820152608401610367565b603860008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d6040516020016105d09392919061244f565b60408051601f19818403018152908290526105ea91612475565b6000604051808303816000865af19150503d8060008114610627576040519150601f19603f3d011682016040523d82523d6000602084013e61062c565b606091505b50915091508161067e5760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c000000006044820152606401610367565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c6040516106b39493929190612491565b60405180910390a19a9950505050505050505050565b606060d280546106d8906124dd565b80601f0160208091040260200160405190810160405280929190818152602001828054610704906124dd565b80156107515780601f1061072657610100808354040283529160200191610751565b820191906000526020600020905b81548152906001019060200180831161073457829003601f168201915b50505050509050919050565b610102546000906001600160a01b0316331461078b5760405162461bcd60e51b815260040161036790612517565b6107a684848460405180602001604052806000815250610ed5565b5060019392505050565b6107b8610fe4565b6001600160a01b0316856001600160a01b031614806107de57506107de85610299610fe4565b6107fa5760405162461bcd60e51b81526004016103679061255c565b6108078585858585610ff3565b5050505050565b606081518351146108735760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b6064820152608401610367565b600083516001600160401b0381111561088e5761088e611ec3565b6040519080825280602002602001820160405280156108b7578160200160208202803683370190505b50905060005b845181101561092f576109028582815181106108db576108db6125aa565b60200260200101518583815181106108f5576108f56125aa565b6020026020010151610300565b828281518110610914576109146125aa565b6020908102919091010152610928816125d6565b90506108bd565b509392505050565b610102546000906001600160a01b031633146109655760405162461bcd60e51b815260040161036790612517565b85848114801561097457508083145b6109c05760405162461bcd60e51b815260206004820181905260248201527f4368696c64455243313135353a206172726179206c656e206d69736d617463686044820152606401610367565b60005b81811015610a4457610a3c8989838181106109e0576109e06125aa565b90506020020160208101906109f59190611ea8565b888884818110610a0757610a076125aa565b90506020020135878785818110610a2057610a206125aa565b9050602002013560405180602001604052806000815250610ed5565b6001016109c3565b50600198975050505050505050565b610102546000906001600160a01b03163314610a815760405162461bcd60e51b815260040161036790612517565b610aef8686868080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525050604080516020808a0282810182019093528982529093508992508891829185019084908082843760009201919091525061119d92505050565b50600195945050505050565b3360009081526038602052604081208054839290610b1a9084906125ef565b909155505050565b610b34610b2d610fe4565b8383611334565b5050565b610b40610fe4565b6001600160a01b0316856001600160a01b03161480610b665750610b6685610299610fe4565b610b825760405162461bcd60e51b81526004016103679061255c565b6108078585858585611414565b606b54610100900460ff1615808015610baf5750606b54600160ff909116105b80610bc95750303b158015610bc95750606b5460ff166001145b610c2c5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610367565b606b805460ff191660011790558015610c4f57606b805461ff0019166101001790555b6001600160a01b038416610ca55760405162461bcd60e51b815260206004820181905260248201527f4368696c64455243313135353a204241445f494e495449414c495a4154494f4e6044820152606401610367565b61010380546001600160a01b0386166001600160a01b031991821617909155610102805490911633179055604080516020601f8501819004810282018101909252838152610d0d91859085908190840183828082843760009201919091525061153b92505050565b610d59610d22856001600160a01b031661156e565b604051602001610d329190612602565b60408051601f1981840301815282820190915260018252603160f81b602083015290611584565b8015610d9f57606b805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050565b610102546000906001600160a01b03163314610dd35760405162461bcd60e51b815260040161036790612517565b6107a68484846115f0565b60008151600003610df157506000919050565b506020015190565b6000806001610e0f610e0a886116f0565b61176d565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015610e5d573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116610eb45760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b6044820152606401610367565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6001600160a01b038416610f355760405162461bcd60e51b815260206004820152602160248201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736044820152607360f81b6064820152608401610367565b6000610f3f610fe4565b90506000610f4c8561179a565b90506000610f598561179a565b9050600086815260d0602090815260408083206001600160a01b038b16845290915281208054879290610f8d9084906125ef565b909155505060408051878152602081018790526001600160a01b03808a169260009291871691600080516020612af3833981519152910160405180910390a4610fdb836000898989896117e5565b50505050505050565b6000610fee611940565b905090565b81518351146110145760405162461bcd60e51b815260040161036790612637565b6001600160a01b03841661103a5760405162461bcd60e51b81526004016103679061267f565b6000611044610fe4565b905060005b845181101561112f576000858281518110611066576110666125aa565b602002602001015190506000858381518110611084576110846125aa565b602090810291909101810151600084815260d0835260408082206001600160a01b038e1683529093529190912054909150818110156110d55760405162461bcd60e51b8152600401610367906126c4565b600083815260d0602090815260408083206001600160a01b038e8116855292528083208585039055908b168252812080548492906111149084906125ef565b9250508190555050505080611128906125d6565b9050611049565b50846001600160a01b0316866001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb878760405161117f92919061270e565b60405180910390a461119581878787878761199c565b505050505050565b6001600160a01b0383166111c35760405162461bcd60e51b81526004016103679061273c565b80518251146111e45760405162461bcd60e51b815260040161036790612637565b60006111ee610fe4565b604080516020810190915260009052905060005b83518110156112c757600084828151811061121f5761121f6125aa565b60200260200101519050600084838151811061123d5761123d6125aa565b602090810291909101810151600084815260d0835260408082206001600160a01b038c16835290935291909120549091508181101561128e5760405162461bcd60e51b81526004016103679061277f565b600092835260d0602090815260408085206001600160a01b038b16865290915290922091039055806112bf816125d6565b915050611202565b5060006001600160a01b0316846001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb868660405161131892919061270e565b60405180910390a4604080516020810190915260009052610d9f565b816001600160a01b0316836001600160a01b0316036113a75760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b6064820152608401610367565b6001600160a01b03838116600081815260d16020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6001600160a01b03841661143a5760405162461bcd60e51b81526004016103679061267f565b6000611444610fe4565b905060006114518561179a565b9050600061145e8561179a565b9050600086815260d0602090815260408083206001600160a01b038c168452909152902054858110156114a35760405162461bcd60e51b8152600401610367906126c4565b600087815260d0602090815260408083206001600160a01b038d8116855292528083208985039055908a168252812080548892906114e29084906125ef565b909155505060408051888152602081018890526001600160a01b03808b16928c82169291881691600080516020612af3833981519152910160405180910390a4611530848a8a8a8a8a6117e5565b505050505050505050565b606b54610100900460ff166115625760405162461bcd60e51b8152600401610367906127c3565b61156b81611a57565b50565b60606103956001600160a01b0383166014611a87565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f6115d2818484611c29565b600055600280546001600160a01b0319163017905560055550505050565b6001600160a01b0383166116165760405162461bcd60e51b81526004016103679061273c565b6000611620610fe4565b9050600061162d8461179a565b9050600061163a8461179a565b604080516020808201835260009182905288825260d081528282206001600160a01b038b16835290522054909150848110156116885760405162461bcd60e51b81526004016103679061277f565b600086815260d0602090815260408083206001600160a01b038b81168086529184528285208a8703905582518b81529384018a9052909290881691600080516020612af3833981519152910160405180910390a4604080516020810190915260009052610fdb565b6000604051806080016040528060438152602001612b136043913980516020918201208351848301516040808701518051908601209051611750950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b600061039561177a611c72565b8360405161190160f01b8152600281019290925260228201526042902090565b604080516001808252818301909252606091600091906020808301908036833701905050905082816000815181106117d4576117d46125aa565b602090810291909101015292915050565b6001600160a01b0384163b156111955760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e6190611829908990899088908890889060040161280e565b6020604051808303816000875af1925050508015611864575060408051601f3d908101601f1916820190925261186191810190612853565b60015b61191057611870612870565b806308c379a0036118a9575061188461288b565b8061188f57506118ab565b8060405162461bcd60e51b81526004016103679190611e49565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b6064820152608401610367565b6001600160e01b0319811663f23a6e6160e01b14610fdb5760405162461bcd60e51b815260040161036790612914565b600030330361199657600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506119999050565b50335b90565b6001600160a01b0384163b156111955760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906119e0908990899088908890889060040161295c565b6020604051808303816000875af1925050508015611a1b575060408051601f3d908101601f19168201909252611a1891810190612853565b60015b611a2757611870612870565b6001600160e01b0319811663bc197c8160e01b14610fdb5760405162461bcd60e51b815260040161036790612914565b606b54610100900460ff16611a7e5760405162461bcd60e51b8152600401610367906127c3565b61156b81611cad565b60606000611a968360026129ba565b611aa19060026125ef565b6001600160401b03811115611ab857611ab8611ec3565b6040519080825280601f01601f191660200182016040528015611ae2576020820181803683370190505b509050600360fc1b81600081518110611afd57611afd6125aa565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110611b2c57611b2c6125aa565b60200101906001600160f81b031916908160001a9053506000611b508460026129ba565b611b5b9060016125ef565b90505b6001811115611bd3576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110611b8f57611b8f6125aa565b1a60f81b828281518110611ba557611ba56125aa565b60200101906001600160f81b031916908160001a90535060049490941c93611bcc816129d1565b9050611b5e565b508315611c225760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610367565b9392505050565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b6002546000906001600160a01b031630148015611c90575060015446145b15611c9c575060005490565b610fee600554600354600454611c29565b60d2610b348282612a33565b80356001600160a01b0381168114611cd057600080fd5b919050565b60008060408385031215611ce857600080fd5b611cf183611cb9565b946020939093013593505050565b6001600160e01b03198116811461156b57600080fd5b600060208284031215611d2757600080fd5b8135611c2281611cff565b60008083601f840112611d4457600080fd5b5081356001600160401b03811115611d5b57600080fd5b602083019150836020828501011115611d7357600080fd5b9250929050565b60008060008060008060a08789031215611d9357600080fd5b611d9c87611cb9565b955060208701356001600160401b03811115611db757600080fd5b611dc389828a01611d32565b9096509450506040870135925060608701359150608087013560ff81168114611deb57600080fd5b809150509295509295509295565b60005b83811015611e14578181015183820152602001611dfc565b50506000910152565b60008151808452611e35816020860160208601611df9565b601f01601f19169290920160200192915050565b602081526000611c226020830184611e1d565b600060208284031215611e6e57600080fd5b5035919050565b600080600060608486031215611e8a57600080fd5b611e9384611cb9565b95602085013595506040909401359392505050565b600060208284031215611eba57600080fd5b611c2282611cb9565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b0381118282101715611efe57611efe611ec3565b6040525050565b60006001600160401b03821115611f1e57611f1e611ec3565b5060051b60200190565b600082601f830112611f3957600080fd5b81356020611f4682611f05565b604051611f538282611ed9565b83815260059390931b8501820192828101915086841115611f7357600080fd5b8286015b84811015611f8e5780358352918301918301611f77565b509695505050505050565b600082601f830112611faa57600080fd5b81356001600160401b03811115611fc357611fc3611ec3565b604051611fda601f8301601f191660200182611ed9565b818152846020838601011115611fef57600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a0868803121561202457600080fd5b61202d86611cb9565b945061203b60208701611cb9565b935060408601356001600160401b038082111561205757600080fd5b61206389838a01611f28565b9450606088013591508082111561207957600080fd5b61208589838a01611f28565b9350608088013591508082111561209b57600080fd5b506120a888828901611f99565b9150509295509295909350565b600080604083850312156120c857600080fd5b82356001600160401b03808211156120df57600080fd5b818501915085601f8301126120f357600080fd5b8135602061210082611f05565b60405161210d8282611ed9565b83815260059390931b850182019282810191508984111561212d57600080fd5b948201945b838610156121525761214386611cb9565b82529482019490820190612132565b9650508601359250508082111561216857600080fd5b5061217585828601611f28565b9150509250929050565b600081518084526020808501945080840160005b838110156121af57815187529582019590820190600101612193565b509495945050505050565b602081526000611c22602083018461217f565b60008083601f8401126121df57600080fd5b5081356001600160401b038111156121f657600080fd5b6020830191508360208260051b8501011115611d7357600080fd5b6000806000806000806060878903121561222a57600080fd5b86356001600160401b038082111561224157600080fd5b61224d8a838b016121cd565b9098509650602089013591508082111561226657600080fd5b6122728a838b016121cd565b9096509450604089013591508082111561228b57600080fd5b5061229889828a016121cd565b979a9699509497509295939492505050565b6000806000806000606086880312156122c257600080fd5b6122cb86611cb9565b945060208601356001600160401b03808211156122e757600080fd5b6122f389838a016121cd565b9096509450604088013591508082111561230c57600080fd5b50612319888289016121cd565b969995985093965092949392505050565b6000806040838503121561233d57600080fd5b61234683611cb9565b91506020830135801515811461235b57600080fd5b809150509250929050565b6000806040838503121561237957600080fd5b61238283611cb9565b915061239060208401611cb9565b90509250929050565b600080600080600060a086880312156123b157600080fd5b6123ba86611cb9565b94506123c860208701611cb9565b9350604086013592506060860135915060808601356001600160401b038111156123f157600080fd5b6120a888828901611f99565b60008060006040848603121561241257600080fd5b61241b84611cb9565b925060208401356001600160401b0381111561243657600080fd5b61244286828701611d32565b9497909650939450505050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b60008251612487818460208701611df9565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b600181811c908216806124f157607f821691505b60208210810361251157634e487b7160e01b600052602260045260246000fd5b50919050565b60208082526025908201527f4368696c64455243313135353a204f6e6c79207072656469636174652063616e6040820152640818d85b1b60da1b606082015260800190565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b6000600182016125e8576125e86125c0565b5060010190565b80820180821115610395576103956125c0565b6c4368696c64455243313135352d60981b81526000825161262a81600d850160208701611df9565b91909101600d0192915050565b60208082526028908201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206040820152670dad2e6dac2e8c6d60c31b606082015260800190565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b604081526000612721604083018561217f565b8281036020840152612733818561217f565b95945050505050565b60208082526023908201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260408201526265737360e81b606082015260800190565b60208082526024908201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604082015263616e636560e01b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061284890830184611e1d565b979650505050505050565b60006020828403121561286557600080fd5b8151611c2281611cff565b600060033d11156119995760046000803e5060005160e01c90565b600060443d10156128995790565b6040516003193d81016004833e81513d6001600160401b0381602484011181841117156128c857505050505090565b82850191508151818111156128e05750505050505090565b843d87010160208285010111156128fa5750505050505090565b61290960208286010187611ed9565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b6001600160a01b0386811682528516602082015260a0604082018190526000906129889083018661217f565b828103606084015261299a818661217f565b905082810360808401526129ae8185611e1d565b98975050505050505050565b8082028115828204841417610395576103956125c0565b6000816129e0576129e06125c0565b506000190190565b601f821115612a2e57600081815260208120601f850160051c81016020861015612a0f5750805b601f850160051c820191505b8181101561119557828155600101612a1b565b505050565b81516001600160401b03811115612a4c57612a4c611ec3565b612a6081612a5a84546124dd565b846129e8565b602080601f831160018114612a955760008415612a7d5750858301515b600019600386901b1c1916600185901b178555611195565b600085815260208120601f198616915b82811015612ac457888601518255948401946001909101908401612aa5565b5085821015612ae25787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fec3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f624d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529a2646970667358221220d48b6656ae2af8f39607add0ff4fc12029027806b1a7c756a64f97827803920c64736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101155760003560e01c806357128683116100a2578063e619870511610071578063e619870514610279578063e985e9c51461028b578063f242432a146102c7578063f399e22e146102da578063f5298aca146102ed57600080fd5b8063571286831461022d5780636b20c454146102405780639b77ef1114610253578063a22cb4651461026657600080fd5b8063156e29f6116100e9578063156e29f6146101965780631f2d0065146101a95780632d0335ab146101cf5780632eb2c2d6146101f85780634e1273f41461020d57600080fd5b8062fdd58e1461011a57806301ffc9a7146101405780630c53c51c146101635780630e89341c14610183575b600080fd5b61012d610128366004611cd5565b610300565b6040519081526020015b60405180910390f35b61015361014e366004611d15565b61039b565b6040519015158152602001610137565b610176610171366004611d7a565b6103eb565b6040516101379190611e49565b610176610191366004611e5c565b6106c9565b6101536101a4366004611e75565b61075d565b610103546001600160a01b03165b6040516001600160a01b039091168152602001610137565b61012d6101dd366004611ea8565b6001600160a01b031660009081526038602052604090205490565b61020b61020636600461200c565b6107b0565b005b61022061021b3660046120b5565b61080e565b60405161013791906121ba565b61015361023b366004612211565b610937565b61015361024e3660046122aa565b610a53565b61020b610261366004611e5c565b610afb565b61020b61027436600461232a565b610b22565b610102546001600160a01b03166101b7565b610153610299366004612366565b6001600160a01b03918216600090815260d16020908152604080832093909416825291909152205460ff1690565b61020b6102d5366004612399565b610b38565b61020b6102e83660046123fd565b610b8f565b6101536102fb366004611e75565b610da5565b60006001600160a01b0383166103705760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b50600081815260d0602090815260408083206001600160a01b03861684529091529020545b92915050565b60006001600160e01b03198216636cdb3d1360e11b14806103cc57506001600160e01b031982166303a24d0760e21b145b8061039557506301ffc9a760e01b6001600160e01b0319831614610395565b6060600061042e87878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610dde92505050565b90506001600160e01b03196000358116908216036104b45760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f640000006064820152608401610367565b604080516060810182526001600160a01b038a16600081815260386020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506105258982888888610df9565b61057b5760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b6064820152608401610367565b603860008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d6040516020016105d09392919061244f565b60408051601f19818403018152908290526105ea91612475565b6000604051808303816000865af19150503d8060008114610627576040519150601f19603f3d011682016040523d82523d6000602084013e61062c565b606091505b50915091508161067e5760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c000000006044820152606401610367565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c6040516106b39493929190612491565b60405180910390a19a9950505050505050505050565b606060d280546106d8906124dd565b80601f0160208091040260200160405190810160405280929190818152602001828054610704906124dd565b80156107515780601f1061072657610100808354040283529160200191610751565b820191906000526020600020905b81548152906001019060200180831161073457829003601f168201915b50505050509050919050565b610102546000906001600160a01b0316331461078b5760405162461bcd60e51b815260040161036790612517565b6107a684848460405180602001604052806000815250610ed5565b5060019392505050565b6107b8610fe4565b6001600160a01b0316856001600160a01b031614806107de57506107de85610299610fe4565b6107fa5760405162461bcd60e51b81526004016103679061255c565b6108078585858585610ff3565b5050505050565b606081518351146108735760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b6064820152608401610367565b600083516001600160401b0381111561088e5761088e611ec3565b6040519080825280602002602001820160405280156108b7578160200160208202803683370190505b50905060005b845181101561092f576109028582815181106108db576108db6125aa565b60200260200101518583815181106108f5576108f56125aa565b6020026020010151610300565b828281518110610914576109146125aa565b6020908102919091010152610928816125d6565b90506108bd565b509392505050565b610102546000906001600160a01b031633146109655760405162461bcd60e51b815260040161036790612517565b85848114801561097457508083145b6109c05760405162461bcd60e51b815260206004820181905260248201527f4368696c64455243313135353a206172726179206c656e206d69736d617463686044820152606401610367565b60005b81811015610a4457610a3c8989838181106109e0576109e06125aa565b90506020020160208101906109f59190611ea8565b888884818110610a0757610a076125aa565b90506020020135878785818110610a2057610a206125aa565b9050602002013560405180602001604052806000815250610ed5565b6001016109c3565b50600198975050505050505050565b610102546000906001600160a01b03163314610a815760405162461bcd60e51b815260040161036790612517565b610aef8686868080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525050604080516020808a0282810182019093528982529093508992508891829185019084908082843760009201919091525061119d92505050565b50600195945050505050565b3360009081526038602052604081208054839290610b1a9084906125ef565b909155505050565b610b34610b2d610fe4565b8383611334565b5050565b610b40610fe4565b6001600160a01b0316856001600160a01b03161480610b665750610b6685610299610fe4565b610b825760405162461bcd60e51b81526004016103679061255c565b6108078585858585611414565b606b54610100900460ff1615808015610baf5750606b54600160ff909116105b80610bc95750303b158015610bc95750606b5460ff166001145b610c2c5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610367565b606b805460ff191660011790558015610c4f57606b805461ff0019166101001790555b6001600160a01b038416610ca55760405162461bcd60e51b815260206004820181905260248201527f4368696c64455243313135353a204241445f494e495449414c495a4154494f4e6044820152606401610367565b61010380546001600160a01b0386166001600160a01b031991821617909155610102805490911633179055604080516020601f8501819004810282018101909252838152610d0d91859085908190840183828082843760009201919091525061153b92505050565b610d59610d22856001600160a01b031661156e565b604051602001610d329190612602565b60408051601f1981840301815282820190915260018252603160f81b602083015290611584565b8015610d9f57606b805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050565b610102546000906001600160a01b03163314610dd35760405162461bcd60e51b815260040161036790612517565b6107a68484846115f0565b60008151600003610df157506000919050565b506020015190565b6000806001610e0f610e0a886116f0565b61176d565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015610e5d573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116610eb45760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b6044820152606401610367565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6001600160a01b038416610f355760405162461bcd60e51b815260206004820152602160248201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736044820152607360f81b6064820152608401610367565b6000610f3f610fe4565b90506000610f4c8561179a565b90506000610f598561179a565b9050600086815260d0602090815260408083206001600160a01b038b16845290915281208054879290610f8d9084906125ef565b909155505060408051878152602081018790526001600160a01b03808a169260009291871691600080516020612af3833981519152910160405180910390a4610fdb836000898989896117e5565b50505050505050565b6000610fee611940565b905090565b81518351146110145760405162461bcd60e51b815260040161036790612637565b6001600160a01b03841661103a5760405162461bcd60e51b81526004016103679061267f565b6000611044610fe4565b905060005b845181101561112f576000858281518110611066576110666125aa565b602002602001015190506000858381518110611084576110846125aa565b602090810291909101810151600084815260d0835260408082206001600160a01b038e1683529093529190912054909150818110156110d55760405162461bcd60e51b8152600401610367906126c4565b600083815260d0602090815260408083206001600160a01b038e8116855292528083208585039055908b168252812080548492906111149084906125ef565b9250508190555050505080611128906125d6565b9050611049565b50846001600160a01b0316866001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb878760405161117f92919061270e565b60405180910390a461119581878787878761199c565b505050505050565b6001600160a01b0383166111c35760405162461bcd60e51b81526004016103679061273c565b80518251146111e45760405162461bcd60e51b815260040161036790612637565b60006111ee610fe4565b604080516020810190915260009052905060005b83518110156112c757600084828151811061121f5761121f6125aa565b60200260200101519050600084838151811061123d5761123d6125aa565b602090810291909101810151600084815260d0835260408082206001600160a01b038c16835290935291909120549091508181101561128e5760405162461bcd60e51b81526004016103679061277f565b600092835260d0602090815260408085206001600160a01b038b16865290915290922091039055806112bf816125d6565b915050611202565b5060006001600160a01b0316846001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb868660405161131892919061270e565b60405180910390a4604080516020810190915260009052610d9f565b816001600160a01b0316836001600160a01b0316036113a75760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b6064820152608401610367565b6001600160a01b03838116600081815260d16020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6001600160a01b03841661143a5760405162461bcd60e51b81526004016103679061267f565b6000611444610fe4565b905060006114518561179a565b9050600061145e8561179a565b9050600086815260d0602090815260408083206001600160a01b038c168452909152902054858110156114a35760405162461bcd60e51b8152600401610367906126c4565b600087815260d0602090815260408083206001600160a01b038d8116855292528083208985039055908a168252812080548892906114e29084906125ef565b909155505060408051888152602081018890526001600160a01b03808b16928c82169291881691600080516020612af3833981519152910160405180910390a4611530848a8a8a8a8a6117e5565b505050505050505050565b606b54610100900460ff166115625760405162461bcd60e51b8152600401610367906127c3565b61156b81611a57565b50565b60606103956001600160a01b0383166014611a87565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f6115d2818484611c29565b600055600280546001600160a01b0319163017905560055550505050565b6001600160a01b0383166116165760405162461bcd60e51b81526004016103679061273c565b6000611620610fe4565b9050600061162d8461179a565b9050600061163a8461179a565b604080516020808201835260009182905288825260d081528282206001600160a01b038b16835290522054909150848110156116885760405162461bcd60e51b81526004016103679061277f565b600086815260d0602090815260408083206001600160a01b038b81168086529184528285208a8703905582518b81529384018a9052909290881691600080516020612af3833981519152910160405180910390a4604080516020810190915260009052610fdb565b6000604051806080016040528060438152602001612b136043913980516020918201208351848301516040808701518051908601209051611750950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b600061039561177a611c72565b8360405161190160f01b8152600281019290925260228201526042902090565b604080516001808252818301909252606091600091906020808301908036833701905050905082816000815181106117d4576117d46125aa565b602090810291909101015292915050565b6001600160a01b0384163b156111955760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e6190611829908990899088908890889060040161280e565b6020604051808303816000875af1925050508015611864575060408051601f3d908101601f1916820190925261186191810190612853565b60015b61191057611870612870565b806308c379a0036118a9575061188461288b565b8061188f57506118ab565b8060405162461bcd60e51b81526004016103679190611e49565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b6064820152608401610367565b6001600160e01b0319811663f23a6e6160e01b14610fdb5760405162461bcd60e51b815260040161036790612914565b600030330361199657600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506119999050565b50335b90565b6001600160a01b0384163b156111955760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906119e0908990899088908890889060040161295c565b6020604051808303816000875af1925050508015611a1b575060408051601f3d908101601f19168201909252611a1891810190612853565b60015b611a2757611870612870565b6001600160e01b0319811663bc197c8160e01b14610fdb5760405162461bcd60e51b815260040161036790612914565b606b54610100900460ff16611a7e5760405162461bcd60e51b8152600401610367906127c3565b61156b81611cad565b60606000611a968360026129ba565b611aa19060026125ef565b6001600160401b03811115611ab857611ab8611ec3565b6040519080825280601f01601f191660200182016040528015611ae2576020820181803683370190505b509050600360fc1b81600081518110611afd57611afd6125aa565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110611b2c57611b2c6125aa565b60200101906001600160f81b031916908160001a9053506000611b508460026129ba565b611b5b9060016125ef565b90505b6001811115611bd3576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110611b8f57611b8f6125aa565b1a60f81b828281518110611ba557611ba56125aa565b60200101906001600160f81b031916908160001a90535060049490941c93611bcc816129d1565b9050611b5e565b508315611c225760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610367565b9392505050565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b6002546000906001600160a01b031630148015611c90575060015446145b15611c9c575060005490565b610fee600554600354600454611c29565b60d2610b348282612a33565b80356001600160a01b0381168114611cd057600080fd5b919050565b60008060408385031215611ce857600080fd5b611cf183611cb9565b946020939093013593505050565b6001600160e01b03198116811461156b57600080fd5b600060208284031215611d2757600080fd5b8135611c2281611cff565b60008083601f840112611d4457600080fd5b5081356001600160401b03811115611d5b57600080fd5b602083019150836020828501011115611d7357600080fd5b9250929050565b60008060008060008060a08789031215611d9357600080fd5b611d9c87611cb9565b955060208701356001600160401b03811115611db757600080fd5b611dc389828a01611d32565b9096509450506040870135925060608701359150608087013560ff81168114611deb57600080fd5b809150509295509295509295565b60005b83811015611e14578181015183820152602001611dfc565b50506000910152565b60008151808452611e35816020860160208601611df9565b601f01601f19169290920160200192915050565b602081526000611c226020830184611e1d565b600060208284031215611e6e57600080fd5b5035919050565b600080600060608486031215611e8a57600080fd5b611e9384611cb9565b95602085013595506040909401359392505050565b600060208284031215611eba57600080fd5b611c2282611cb9565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b0381118282101715611efe57611efe611ec3565b6040525050565b60006001600160401b03821115611f1e57611f1e611ec3565b5060051b60200190565b600082601f830112611f3957600080fd5b81356020611f4682611f05565b604051611f538282611ed9565b83815260059390931b8501820192828101915086841115611f7357600080fd5b8286015b84811015611f8e5780358352918301918301611f77565b509695505050505050565b600082601f830112611faa57600080fd5b81356001600160401b03811115611fc357611fc3611ec3565b604051611fda601f8301601f191660200182611ed9565b818152846020838601011115611fef57600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a0868803121561202457600080fd5b61202d86611cb9565b945061203b60208701611cb9565b935060408601356001600160401b038082111561205757600080fd5b61206389838a01611f28565b9450606088013591508082111561207957600080fd5b61208589838a01611f28565b9350608088013591508082111561209b57600080fd5b506120a888828901611f99565b9150509295509295909350565b600080604083850312156120c857600080fd5b82356001600160401b03808211156120df57600080fd5b818501915085601f8301126120f357600080fd5b8135602061210082611f05565b60405161210d8282611ed9565b83815260059390931b850182019282810191508984111561212d57600080fd5b948201945b838610156121525761214386611cb9565b82529482019490820190612132565b9650508601359250508082111561216857600080fd5b5061217585828601611f28565b9150509250929050565b600081518084526020808501945080840160005b838110156121af57815187529582019590820190600101612193565b509495945050505050565b602081526000611c22602083018461217f565b60008083601f8401126121df57600080fd5b5081356001600160401b038111156121f657600080fd5b6020830191508360208260051b8501011115611d7357600080fd5b6000806000806000806060878903121561222a57600080fd5b86356001600160401b038082111561224157600080fd5b61224d8a838b016121cd565b9098509650602089013591508082111561226657600080fd5b6122728a838b016121cd565b9096509450604089013591508082111561228b57600080fd5b5061229889828a016121cd565b979a9699509497509295939492505050565b6000806000806000606086880312156122c257600080fd5b6122cb86611cb9565b945060208601356001600160401b03808211156122e757600080fd5b6122f389838a016121cd565b9096509450604088013591508082111561230c57600080fd5b50612319888289016121cd565b969995985093965092949392505050565b6000806040838503121561233d57600080fd5b61234683611cb9565b91506020830135801515811461235b57600080fd5b809150509250929050565b6000806040838503121561237957600080fd5b61238283611cb9565b915061239060208401611cb9565b90509250929050565b600080600080600060a086880312156123b157600080fd5b6123ba86611cb9565b94506123c860208701611cb9565b9350604086013592506060860135915060808601356001600160401b038111156123f157600080fd5b6120a888828901611f99565b60008060006040848603121561241257600080fd5b61241b84611cb9565b925060208401356001600160401b0381111561243657600080fd5b61244286828701611d32565b9497909650939450505050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b60008251612487818460208701611df9565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b600181811c908216806124f157607f821691505b60208210810361251157634e487b7160e01b600052602260045260246000fd5b50919050565b60208082526025908201527f4368696c64455243313135353a204f6e6c79207072656469636174652063616e6040820152640818d85b1b60da1b606082015260800190565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b6000600182016125e8576125e86125c0565b5060010190565b80820180821115610395576103956125c0565b6c4368696c64455243313135352d60981b81526000825161262a81600d850160208701611df9565b91909101600d0192915050565b60208082526028908201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206040820152670dad2e6dac2e8c6d60c31b606082015260800190565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b604081526000612721604083018561217f565b8281036020840152612733818561217f565b95945050505050565b60208082526023908201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260408201526265737360e81b606082015260800190565b60208082526024908201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604082015263616e636560e01b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061284890830184611e1d565b979650505050505050565b60006020828403121561286557600080fd5b8151611c2281611cff565b600060033d11156119995760046000803e5060005160e01c90565b600060443d10156128995790565b6040516003193d81016004833e81513d6001600160401b0381602484011181841117156128c857505050505090565b82850191508151818111156128e05750505050505090565b843d87010160208285010111156128fa5750505050505090565b61290960208286010187611ed9565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b6001600160a01b0386811682528516602082015260a0604082018190526000906129889083018661217f565b828103606084015261299a818661217f565b905082810360808401526129ae8185611e1d565b98975050505050505050565b8082028115828204841417610395576103956125c0565b6000816129e0576129e06125c0565b506000190190565b601f821115612a2e57600081815260208120601f850160051c81016020861015612a0f5750805b601f850160051c820191505b8181101561119557828155600101612a1b565b505050565b81516001600160401b03811115612a4c57612a4c611ec3565b612a6081612a5a84546124dd565b846129e8565b602080601f831160018114612a955760008415612a7d5750858301515b600019600386901b1c1916600185901b178555611195565b600085815260208120601f198616915b82811015612ac457888601518255948401946001909101908401612aa5565b5085821015612ae25787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fec3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f624d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529a2646970667358221220d48b6656ae2af8f39607add0ff4fc12029027806b1a7c756a64f97827803920c64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildERC1155PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildERC1155Predicate","sourceName":"contracts/child/ChildERC1155Predicate.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2ERC1155Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"L2ERC1155DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2ERC1155Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"L2ERC1155WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2TokenMapped","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootERC1155Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootERC1155Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IChildERC1155","name":"childToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC1155","name":"childToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"withdrawBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC1155","name":"childToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50612040806100206000396000f3fe608060405234801561001057600080fd5b50600436106101585760003560e01c806397e5230d116100c3578063d41f17711161007c578063d41f1771146102de578063d7c9e3ec14610305578063e0563ab11461032c578063eeb4994514610335578063f645125514610348578063f8c8765e1461036f57600080fd5b806397e5230d1461024d578063b176806514610257578063b5c5f6721461027e578063b68ad1e414610291578063b8cd3ec0146102a4578063c5ac2b1c146102b757600080fd5b806351351d531161011557806351351d53146101d357806355b01e4d146101e15780635ea5df79146101ef5780637efab4f51461020657806386937eb41461022f578063947287cf1461024457600080fd5b8063051eb2e21461015d57806305dc2e8f1461018d57806307b3e252146101a05780631bc114ba146101ae578063284017f5146101c15780633b878c22146101ca575b600080fd5b603554610170906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b603454610170906001600160a01b031681565b6101706004600360981b0181565b603354610170906001600160a01b031681565b61017061202081565b61017061101081565b6101706002600160a01b0381565b6101706004600160991b0181565b6101f861138881565b604051908152602001610184565b610170610214366004611648565b6037602052600090815260409020546001600160a01b031681565b61024261023d3660046116b7565b610382565b005b6101f861520881565b6101f8620249f081565b6101f87f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b61024261028c366004611763565b61039a565b603654610170906001600160a01b031681565b6102426102b2366004611798565b6103ab565b6101f87faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6101f87f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101f87f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61017061203081565b6102426103433660046117de565b6103bd565b6101f87f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61024261037d366004611866565b6105dd565b6103918787878787878761073a565b50505050505050565b6103a683338484610ab9565b505050565b6103b784848484610ab9565b50505050565b6034546001600160a01b0316331461042f5760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f5354415460448201526922afa922a1a2a4ab22a960b11b60648201526084015b60405180910390fd5b6035546001600160a01b0384811691161461049f5760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f524f4f546044820152695f50524544494341544560b01b6064820152608401610426565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216104ce6020600084866118c2565b6104d7916118ec565b036104f6576104f16104ec82602081866118c2565b610dce565b6103b7565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d186105256020600084866118c2565b61052e916118ec565b0361053d576104f18282611039565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61056c6020600084866118c2565b610575916118ec565b03610584576104f182826112a6565b60405162461bcd60e51b815260206004820152602860248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f5360448201526749474e415455524560c01b6064820152608401610426565b336002600160a01b03146106215760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b6044820152606401610426565b600054610100900460ff16158080156106415750600054600160ff909116105b8061065b5750303b15801561065b575060005460ff166001145b6106be5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610426565b6000805460ff1916600117905580156106e1576000805461ff0019166101001790555b6106ed8585858561140e565b8015610733576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b8661074481611504565b6107605760405162461bcd60e51b81526004016104269061190a565b6000886001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107a0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107c4919061194d565b6001600160a01b038181166000908152603760205260409020549192508a81169116146108035760405162461bcd60e51b81526004016104269061196a565b6001600160a01b038116610819576108196119af565b306001600160a01b0316896001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610861573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610885919061194d565b6001600160a01b03161461089b5761089b6119af565b86851480156108a957508483145b6109035760405162461bcd60e51b815260206004820152602560248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f4c60448201526408a9c8ea8960db1b6064820152608401610426565b604051631ac8311560e21b81526001600160a01b038a1690636b20c454906109379033908a908a908a908a906004016119f7565b6020604051808303816000875af1158015610956573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061097a9190611a3b565b6109965760405162461bcd60e51b815260040161042690611a5d565b6033546035546040516001600160a01b03928316926316f198319216906109f1907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908f908f908f908f908f908f90602001611ae8565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610a1d929190611b99565b600060405180830381600087803b158015610a3757600080fd5b505af1158015610a4b573d6000803e3d6000fd5b50505050336001600160a01b0316896001600160a01b0316826001600160a01b03167f7a10660242ca367951ff3777cdb3c2a761e3ccad204bac118501e24693f3683d8b8b8b8b8b8b604051610aa696959493929190611bc5565b60405180910390a4505050505050505050565b83610ac381611504565b610adf5760405162461bcd60e51b81526004016104269061190a565b6000856001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b1f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b43919061194d565b6001600160a01b03818116600090815260376020526040902054919250878116911614610b825760405162461bcd60e51b81526004016104269061196a565b6001600160a01b038116610b9857610b986119af565b306001600160a01b0316866001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610be0573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c04919061194d565b6001600160a01b031614610c1a57610c1a6119af565b604051637a94c56560e11b81526001600160a01b0387169063f5298aca90610c4a90339088908890600401611c0e565b6020604051808303816000875af1158015610c69573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c8d9190611a3b565b610ca95760405162461bcd60e51b815260040161042690611a5d565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152898116608083015260a0820189905260c08083018990528351808403909101815260e08301938490526316f1983160e01b909352938416936316f1983193610d3b9391169160e401611b99565b600060405180830381600087803b158015610d5557600080fd5b505af1158015610d69573d6000803e3d6000fd5b50505050846001600160a01b0316866001600160a01b0316826001600160a01b03167f2ca9093e8b5356801039806c6a08003e5b7013fb8ae48f720fc90fc1c1a8bec2338888604051610dbe93929190611c0e565b60405180910390a4505050505050565b600080808080610de086880188611c2f565b6001600160a01b03808616600090815260376020526040902054959a50939850919650945092501680610e255760405162461bcd60e51b81526004016104269061196a565b610e2e81611504565b610e3a57610e3a6119af565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610e7a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e9e919061194d565b9050866001600160a01b0316816001600160a01b031614610ec157610ec16119af565b6001600160a01b038116610ed757610ed76119af565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f1f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f43919061194d565b6001600160a01b031614610f5957610f596119af565b604051630ab714fb60e11b81526001600160a01b0383169063156e29f690610f8990889088908890600401611c0e565b6020604051808303816000875af1158015610fa8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fcc9190611a3b565b610fe85760405162461bcd60e51b815260040161042690611c8a565b846001600160a01b0316826001600160a01b0316886001600160a01b03167f2930d932c1cccd6add2e0e2d706ede9015db8a194405f2a3e1783703515e104f898888604051610aa693929190611c0e565b60008080808061104b86880188611da0565b6001600160a01b03808616600090815260376020526040902054959b5093995091975095509350169050806110925760405162461bcd60e51b81526004016104269061196a565b61109b81611504565b6110a7576110a76119af565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156110e7573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061110b919061194d565b9050866001600160a01b0316816001600160a01b03161461112e5761112e6119af565b6001600160a01b038116611144576111446119af565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561118c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111b0919061194d565b6001600160a01b0316146111c6576111c66119af565b604051635712868360e01b81526001600160a01b038316906357128683906111f690889088908890600401611ee5565b6020604051808303816000875af1158015611215573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112399190611a3b565b6112555760405162461bcd60e51b815260040161042690611c8a565b856001600160a01b0316826001600160a01b0316886001600160a01b03167f17304b99f8dfa5a2b8dd5695d82f9947c2abfbc9cb64bab610b9a1a0feadb9a0888888604051610aa693929190611ee5565b6000806112b583850185611f5a565b9093509150506001600160a01b0382166112d1576112d16119af565b6001600160a01b0382811660009081526037602052604090205416156112f9576112f96119af565b6036546040516bffffffffffffffffffffffff19606085901b166020820152600091611349916001600160a01b039091169060340160405160208183030381529060405280519060200120611599565b6001600160a01b038481166000908152603760205260409081902080546001600160a01b0319169284169283179055516379ccf11760e11b81529192509063f399e22e9061139d9086908690600401611b99565b600060405180830381600087803b1580156113b757600080fd5b505af11580156113cb573d6000803e3d6000fd5b50506040516001600160a01b038085169350861691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a35050505050565b6001600160a01b0384161580159061142e57506001600160a01b03831615155b801561144257506001600160a01b03821615155b801561145657506001600160a01b03811615155b6114b45760405162461bcd60e51b815260206004820152602960248201527f4368696c64455243313135355072656469636174653a204241445f494e49544960448201526820a624ad20aa24a7a760b91b6064820152608401610426565b603380546001600160a01b039586166001600160a01b0319918216179091556034805494861694821694909417909355603580549285169284169290921790915560368054919093169116179055565b6000816001600160a01b03163b60000361152057506000919050565b6040516301ffc9a760e01b8152636cdb3d1360e11b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611587575060408051601f3d908101601f1916820190925261158491810190611a3b565b60015b61159357506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b0381166115935760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b6044820152606401610426565b6001600160a01b038116811461164557600080fd5b50565b60006020828403121561165a57600080fd5b813561166581611630565b9392505050565b60008083601f84011261167e57600080fd5b5081356001600160401b0381111561169557600080fd5b6020830191508360208260051b85010111156116b057600080fd5b9250929050565b60008060008060008060006080888a0312156116d257600080fd5b87356116dd81611630565b965060208801356001600160401b03808211156116f957600080fd5b6117058b838c0161166c565b909850965060408a013591508082111561171e57600080fd5b61172a8b838c0161166c565b909650945060608a013591508082111561174357600080fd5b506117508a828b0161166c565b989b979a50959850939692959293505050565b60008060006060848603121561177857600080fd5b833561178381611630565b95602085013595506040909401359392505050565b600080600080608085870312156117ae57600080fd5b84356117b981611630565b935060208501356117c981611630565b93969395505050506040820135916060013590565b600080600080606085870312156117f457600080fd5b84359350602085013561180681611630565b925060408501356001600160401b038082111561182257600080fd5b818701915087601f83011261183657600080fd5b81358181111561184557600080fd5b88602082850101111561185757600080fd5b95989497505060200194505050565b6000806000806080858703121561187c57600080fd5b843561188781611630565b9350602085013561189781611630565b925060408501356118a781611630565b915060608501356118b781611630565b939692955090935050565b600080858511156118d257600080fd5b838611156118df57600080fd5b5050820193919092039150565b8035602083101561159357600019602084900360031b1b1692915050565b60208082526023908201527f4368696c64455243313135355072656469636174653a204e4f545f434f4e54526040820152621050d560ea1b606082015260800190565b60006020828403121561195f57600080fd5b815161166581611630565b60208082526025908201527f4368696c64455243313135355072656469636174653a20554e4d41505045445f6040820152642a27a5a2a760d91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b038311156119de57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b0386168152606060208201819052600090611a1c90830186886119c5565b8281036040840152611a2f8185876119c5565b98975050505050505050565b600060208284031215611a4d57600080fd5b8151801515811461166557600080fd5b60208082526022908201527f4368696c64455243313135355072656469636174653a204255524e5f4641494c604082015261115160f21b606082015260800190565b8183526000602080850194508260005b85811015611add578135611ac281611630565b6001600160a01b031687529582019590820190600101611aaf565b509495945050505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090611b1b908301888a611a9f565b8281036080840152611b2e8187896119c5565b905082810360a0840152611b438185876119c5565b9c9b505050505050505050505050565b6000815180845260005b81811015611b7957602081850181015186830182015201611b5d565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611bbd90830184611b53565b949350505050565b606081526000611bd960608301888a611a9f565b8281036020840152611bec8187896119c5565b90508281036040840152611c018185876119c5565b9998505050505050505050565b6001600160a01b039390931683526020830191909152604082015260600190565b600080600080600060a08688031215611c4757600080fd5b8535611c5281611630565b94506020860135611c6281611630565b93506040860135611c7281611630565b94979396509394606081013594506080013592915050565b60208082526022908201527f4368696c64455243313135355072656469636174653a204d494e545f4641494c604082015261115160f21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611d0a57611d0a611ccc565b604052919050565b60006001600160401b03821115611d2b57611d2b611ccc565b5060051b60200190565b600082601f830112611d4657600080fd5b81356020611d5b611d5683611d12565b611ce2565b82815260059290921b84018101918181019086841115611d7a57600080fd5b8286015b84811015611d955780358352918301918301611d7e565b509695505050505050565b60008060008060008060c08789031215611db957600080fd5b86359550602080880135611dcc81611630565b95506040880135611ddc81611630565b945060608801356001600160401b0380821115611df857600080fd5b818a0191508a601f830112611e0c57600080fd5b8135611e1a611d5682611d12565b81815260059190911b8301840190848101908d831115611e3957600080fd5b938501935b82851015611e60578435611e5181611630565b82529385019390850190611e3e565b9750505060808a0135925080831115611e7857600080fd5b611e848b848c01611d35565b945060a08a0135925080831115611e9a57600080fd5b5050611ea889828a01611d35565b9150509295509295509295565b600081518084526020808501945080840160005b83811015611add57815187529582019590820190600101611ec9565b606080825284519082018190526000906020906080840190828801845b82811015611f275781516001600160a01b031684529284019290840190600101611f02565b50505083810382850152611f3b8187611eb5565b9150508281036040840152611f508185611eb5565b9695505050505050565b600080600060608486031215611f6f57600080fd5b83359250602080850135611f8281611630565b925060408501356001600160401b0380821115611f9e57600080fd5b818701915087601f830112611fb257600080fd5b813581811115611fc457611fc4611ccc565b611fd6601f8201601f19168501611ce2565b91508082528884828501011115611fec57600080fd5b8084840185840137600084828401015250809350505050925092509256fea2646970667358221220144e7d3687aae30c76d4672a727fea0faa7f80324ee0ce29478a172a7808516964736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101585760003560e01c806397e5230d116100c3578063d41f17711161007c578063d41f1771146102de578063d7c9e3ec14610305578063e0563ab11461032c578063eeb4994514610335578063f645125514610348578063f8c8765e1461036f57600080fd5b806397e5230d1461024d578063b176806514610257578063b5c5f6721461027e578063b68ad1e414610291578063b8cd3ec0146102a4578063c5ac2b1c146102b757600080fd5b806351351d531161011557806351351d53146101d357806355b01e4d146101e15780635ea5df79146101ef5780637efab4f51461020657806386937eb41461022f578063947287cf1461024457600080fd5b8063051eb2e21461015d57806305dc2e8f1461018d57806307b3e252146101a05780631bc114ba146101ae578063284017f5146101c15780633b878c22146101ca575b600080fd5b603554610170906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b603454610170906001600160a01b031681565b6101706004600360981b0181565b603354610170906001600160a01b031681565b61017061202081565b61017061101081565b6101706002600160a01b0381565b6101706004600160991b0181565b6101f861138881565b604051908152602001610184565b610170610214366004611648565b6037602052600090815260409020546001600160a01b031681565b61024261023d3660046116b7565b610382565b005b6101f861520881565b6101f8620249f081565b6101f87f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b61024261028c366004611763565b61039a565b603654610170906001600160a01b031681565b6102426102b2366004611798565b6103ab565b6101f87faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6101f87f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101f87f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61017061203081565b6102426103433660046117de565b6103bd565b6101f87f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61024261037d366004611866565b6105dd565b6103918787878787878761073a565b50505050505050565b6103a683338484610ab9565b505050565b6103b784848484610ab9565b50505050565b6034546001600160a01b0316331461042f5760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f5354415460448201526922afa922a1a2a4ab22a960b11b60648201526084015b60405180910390fd5b6035546001600160a01b0384811691161461049f5760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f524f4f546044820152695f50524544494341544560b01b6064820152608401610426565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216104ce6020600084866118c2565b6104d7916118ec565b036104f6576104f16104ec82602081866118c2565b610dce565b6103b7565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d186105256020600084866118c2565b61052e916118ec565b0361053d576104f18282611039565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61056c6020600084866118c2565b610575916118ec565b03610584576104f182826112a6565b60405162461bcd60e51b815260206004820152602860248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f5360448201526749474e415455524560c01b6064820152608401610426565b336002600160a01b03146106215760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b6044820152606401610426565b600054610100900460ff16158080156106415750600054600160ff909116105b8061065b5750303b15801561065b575060005460ff166001145b6106be5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610426565b6000805460ff1916600117905580156106e1576000805461ff0019166101001790555b6106ed8585858561140e565b8015610733576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b8661074481611504565b6107605760405162461bcd60e51b81526004016104269061190a565b6000886001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107a0573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107c4919061194d565b6001600160a01b038181166000908152603760205260409020549192508a81169116146108035760405162461bcd60e51b81526004016104269061196a565b6001600160a01b038116610819576108196119af565b306001600160a01b0316896001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610861573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610885919061194d565b6001600160a01b03161461089b5761089b6119af565b86851480156108a957508483145b6109035760405162461bcd60e51b815260206004820152602560248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f4c60448201526408a9c8ea8960db1b6064820152608401610426565b604051631ac8311560e21b81526001600160a01b038a1690636b20c454906109379033908a908a908a908a906004016119f7565b6020604051808303816000875af1158015610956573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061097a9190611a3b565b6109965760405162461bcd60e51b815260040161042690611a5d565b6033546035546040516001600160a01b03928316926316f198319216906109f1907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908f908f908f908f908f908f90602001611ae8565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610a1d929190611b99565b600060405180830381600087803b158015610a3757600080fd5b505af1158015610a4b573d6000803e3d6000fd5b50505050336001600160a01b0316896001600160a01b0316826001600160a01b03167f7a10660242ca367951ff3777cdb3c2a761e3ccad204bac118501e24693f3683d8b8b8b8b8b8b604051610aa696959493929190611bc5565b60405180910390a4505050505050505050565b83610ac381611504565b610adf5760405162461bcd60e51b81526004016104269061190a565b6000856001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b1f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b43919061194d565b6001600160a01b03818116600090815260376020526040902054919250878116911614610b825760405162461bcd60e51b81526004016104269061196a565b6001600160a01b038116610b9857610b986119af565b306001600160a01b0316866001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610be0573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c04919061194d565b6001600160a01b031614610c1a57610c1a6119af565b604051637a94c56560e11b81526001600160a01b0387169063f5298aca90610c4a90339088908890600401611c0e565b6020604051808303816000875af1158015610c69573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c8d9190611a3b565b610ca95760405162461bcd60e51b815260040161042690611a5d565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152898116608083015260a0820189905260c08083018990528351808403909101815260e08301938490526316f1983160e01b909352938416936316f1983193610d3b9391169160e401611b99565b600060405180830381600087803b158015610d5557600080fd5b505af1158015610d69573d6000803e3d6000fd5b50505050846001600160a01b0316866001600160a01b0316826001600160a01b03167f2ca9093e8b5356801039806c6a08003e5b7013fb8ae48f720fc90fc1c1a8bec2338888604051610dbe93929190611c0e565b60405180910390a4505050505050565b600080808080610de086880188611c2f565b6001600160a01b03808616600090815260376020526040902054959a50939850919650945092501680610e255760405162461bcd60e51b81526004016104269061196a565b610e2e81611504565b610e3a57610e3a6119af565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610e7a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e9e919061194d565b9050866001600160a01b0316816001600160a01b031614610ec157610ec16119af565b6001600160a01b038116610ed757610ed76119af565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f1f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f43919061194d565b6001600160a01b031614610f5957610f596119af565b604051630ab714fb60e11b81526001600160a01b0383169063156e29f690610f8990889088908890600401611c0e565b6020604051808303816000875af1158015610fa8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fcc9190611a3b565b610fe85760405162461bcd60e51b815260040161042690611c8a565b846001600160a01b0316826001600160a01b0316886001600160a01b03167f2930d932c1cccd6add2e0e2d706ede9015db8a194405f2a3e1783703515e104f898888604051610aa693929190611c0e565b60008080808061104b86880188611da0565b6001600160a01b03808616600090815260376020526040902054959b5093995091975095509350169050806110925760405162461bcd60e51b81526004016104269061196a565b61109b81611504565b6110a7576110a76119af565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156110e7573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061110b919061194d565b9050866001600160a01b0316816001600160a01b03161461112e5761112e6119af565b6001600160a01b038116611144576111446119af565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561118c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111b0919061194d565b6001600160a01b0316146111c6576111c66119af565b604051635712868360e01b81526001600160a01b038316906357128683906111f690889088908890600401611ee5565b6020604051808303816000875af1158015611215573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112399190611a3b565b6112555760405162461bcd60e51b815260040161042690611c8a565b856001600160a01b0316826001600160a01b0316886001600160a01b03167f17304b99f8dfa5a2b8dd5695d82f9947c2abfbc9cb64bab610b9a1a0feadb9a0888888604051610aa693929190611ee5565b6000806112b583850185611f5a565b9093509150506001600160a01b0382166112d1576112d16119af565b6001600160a01b0382811660009081526037602052604090205416156112f9576112f96119af565b6036546040516bffffffffffffffffffffffff19606085901b166020820152600091611349916001600160a01b039091169060340160405160208183030381529060405280519060200120611599565b6001600160a01b038481166000908152603760205260409081902080546001600160a01b0319169284169283179055516379ccf11760e11b81529192509063f399e22e9061139d9086908690600401611b99565b600060405180830381600087803b1580156113b757600080fd5b505af11580156113cb573d6000803e3d6000fd5b50506040516001600160a01b038085169350861691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a35050505050565b6001600160a01b0384161580159061142e57506001600160a01b03831615155b801561144257506001600160a01b03821615155b801561145657506001600160a01b03811615155b6114b45760405162461bcd60e51b815260206004820152602960248201527f4368696c64455243313135355072656469636174653a204241445f494e49544960448201526820a624ad20aa24a7a760b91b6064820152608401610426565b603380546001600160a01b039586166001600160a01b0319918216179091556034805494861694821694909417909355603580549285169284169290921790915560368054919093169116179055565b6000816001600160a01b03163b60000361152057506000919050565b6040516301ffc9a760e01b8152636cdb3d1360e11b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611587575060408051601f3d908101601f1916820190925261158491810190611a3b565b60015b61159357506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b0381166115935760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b6044820152606401610426565b6001600160a01b038116811461164557600080fd5b50565b60006020828403121561165a57600080fd5b813561166581611630565b9392505050565b60008083601f84011261167e57600080fd5b5081356001600160401b0381111561169557600080fd5b6020830191508360208260051b85010111156116b057600080fd5b9250929050565b60008060008060008060006080888a0312156116d257600080fd5b87356116dd81611630565b965060208801356001600160401b03808211156116f957600080fd5b6117058b838c0161166c565b909850965060408a013591508082111561171e57600080fd5b61172a8b838c0161166c565b909650945060608a013591508082111561174357600080fd5b506117508a828b0161166c565b989b979a50959850939692959293505050565b60008060006060848603121561177857600080fd5b833561178381611630565b95602085013595506040909401359392505050565b600080600080608085870312156117ae57600080fd5b84356117b981611630565b935060208501356117c981611630565b93969395505050506040820135916060013590565b600080600080606085870312156117f457600080fd5b84359350602085013561180681611630565b925060408501356001600160401b038082111561182257600080fd5b818701915087601f83011261183657600080fd5b81358181111561184557600080fd5b88602082850101111561185757600080fd5b95989497505060200194505050565b6000806000806080858703121561187c57600080fd5b843561188781611630565b9350602085013561189781611630565b925060408501356118a781611630565b915060608501356118b781611630565b939692955090935050565b600080858511156118d257600080fd5b838611156118df57600080fd5b5050820193919092039150565b8035602083101561159357600019602084900360031b1b1692915050565b60208082526023908201527f4368696c64455243313135355072656469636174653a204e4f545f434f4e54526040820152621050d560ea1b606082015260800190565b60006020828403121561195f57600080fd5b815161166581611630565b60208082526025908201527f4368696c64455243313135355072656469636174653a20554e4d41505045445f6040820152642a27a5a2a760d91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b038311156119de57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b0386168152606060208201819052600090611a1c90830186886119c5565b8281036040840152611a2f8185876119c5565b98975050505050505050565b600060208284031215611a4d57600080fd5b8151801515811461166557600080fd5b60208082526022908201527f4368696c64455243313135355072656469636174653a204255524e5f4641494c604082015261115160f21b606082015260800190565b8183526000602080850194508260005b85811015611add578135611ac281611630565b6001600160a01b031687529582019590820190600101611aaf565b509495945050505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090611b1b908301888a611a9f565b8281036080840152611b2e8187896119c5565b905082810360a0840152611b438185876119c5565b9c9b505050505050505050505050565b6000815180845260005b81811015611b7957602081850181015186830182015201611b5d565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611bbd90830184611b53565b949350505050565b606081526000611bd960608301888a611a9f565b8281036020840152611bec8187896119c5565b90508281036040840152611c018185876119c5565b9998505050505050505050565b6001600160a01b039390931683526020830191909152604082015260600190565b600080600080600060a08688031215611c4757600080fd5b8535611c5281611630565b94506020860135611c6281611630565b93506040860135611c7281611630565b94979396509394606081013594506080013592915050565b60208082526022908201527f4368696c64455243313135355072656469636174653a204d494e545f4641494c604082015261115160f21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611d0a57611d0a611ccc565b604052919050565b60006001600160401b03821115611d2b57611d2b611ccc565b5060051b60200190565b600082601f830112611d4657600080fd5b81356020611d5b611d5683611d12565b611ce2565b82815260059290921b84018101918181019086841115611d7a57600080fd5b8286015b84811015611d955780358352918301918301611d7e565b509695505050505050565b60008060008060008060c08789031215611db957600080fd5b86359550602080880135611dcc81611630565b95506040880135611ddc81611630565b945060608801356001600160401b0380821115611df857600080fd5b818a0191508a601f830112611e0c57600080fd5b8135611e1a611d5682611d12565b81815260059190911b8301840190848101908d831115611e3957600080fd5b938501935b82851015611e60578435611e5181611630565b82529385019390850190611e3e565b9750505060808a0135925080831115611e7857600080fd5b611e848b848c01611d35565b945060a08a0135925080831115611e9a57600080fd5b5050611ea889828a01611d35565b9150509295509295509295565b600081518084526020808501945080840160005b83811015611add57815187529582019590820190600101611ec9565b606080825284519082018190526000906020906080840190828801845b82811015611f275781516001600160a01b031684529284019290840190600101611f02565b50505083810382850152611f3b8187611eb5565b9150508281036040840152611f508185611eb5565b9695505050505050565b600080600060608486031215611f6f57600080fd5b83359250602080850135611f8281611630565b925060408501356001600160401b0380821115611f9e57600080fd5b818701915087601f830112611fb257600080fd5b813581811115611fc457611fc4611ccc565b611fd6601f8201601f19168501611ce2565b91508082528884828501011115611fec57600080fd5b8084840185840137600084828401015250809350505050925092509256fea2646970667358221220144e7d3687aae30c76d4672a727fea0faa7f80324ee0ce29478a172a7808516964736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildERC1155PredicateACLArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildERC1155PredicateAccessList","sourceName":"contracts/child/ChildERC1155PredicateAccessList.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"AllowListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"BlockListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2ERC1155Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"L2ERC1155DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2ERC1155Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"L2ERC1155WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2TokenMapped","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootERC1155Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"},{"internalType":"bool","name":"newUseAllowList","type":"bool"},{"internalType":"bool","name":"newUseBlockList","type":"bool"},{"internalType":"address","name":"newOwner","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootERC1155Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootERC1155Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseAllowList","type":"bool"}],"name":"setAllowList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseBlockList","type":"bool"}],"name":"setBlockList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC1155","name":"childToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC1155","name":"childToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"withdrawBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC1155","name":"childToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b506127d8806100206000396000f3fe608060405234801561001057600080fd5b50600436106101b05760003560e01c8063b1768065116100ef578063d7c9e3ec11610092578063d7c9e3ec146103a5578063d8dd1773146103cc578063e0563ab1146103df578063e30c3978146103e8578063eeb49945146103f9578063f2fde38b1461040c578063f64512551461041f578063f8c8765e1461044657600080fd5b8063b1768065146102d1578063b5c5f672146102f8578063b68ad1e41461030b578063b8cd3ec01461031e578063c1225a2014610331578063c5ac2b1c14610344578063c5e4683a1461036b578063d41f17711461037e57600080fd5b80635ea5df79116101575780635ea5df7914610247578063715018a61461025e57806379ba5097146102685780637efab4f51461027057806386937eb41461029a5780638da5cb5b146102ad578063947287cf146102be57806397e5230d146102c757600080fd5b8063051eb2e2146101b557806305dc2e8f146101e557806307b3e252146101f85780631bc114ba14610206578063284017f5146102195780633b878c221461022257806351351d531461022b57806355b01e4d14610239575b600080fd5b60fe546101c8906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b60fd546101c8906001600160a01b031681565b6101c86004600360981b0181565b60fc546101c8906001600160a01b031681565b6101c861202081565b6101c861101081565b6101c86002600160a01b0381565b6101c86004600160991b0181565b61025061138881565b6040519081526020016101dc565b610266610459565b005b61026661046d565b6101c861027e366004611c73565b610100602052600090815260409020546001600160a01b031681565b6102666102a8366004611ce2565b6104ec565b6033546001600160a01b03166101c8565b61025061520881565b610250620249f081565b6102507f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b610266610306366004611d8e565b61050c565b60ff546101c8906001600160a01b031681565b61026661032c366004611dc3565b610525565b61026661033f366004611e17565b61053f565b6102507faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b610266610379366004611e17565b61058e565b6102507f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102507f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b6102666103da366004611e34565b6105d5565b6101c861203081565b6065546001600160a01b03166101c8565b610266610407366004611eca565b6106f6565b61026661041a366004611c73565b610911565b6102507f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b610266610454366004611f52565b610982565b610461610a7b565b61046b6000610ad5565b565b60655433906001600160a01b031681146104e05760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b6104e981610ad5565b50565b6104f4610aee565b61050387878787878787610af6565b50505050505050565b610514610aee565b61052083338484610e76565b505050565b61052d610aee565b61053984848484610e76565b50505050565b610547610a7b565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b610596610a7b565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b03146105fc5760405163973d02cb60e01b81526004016104d790611fae565b600054610100900460ff161580801561061c5750600054600160ff909116105b806106365750303b158015610636575060005460ff166001145b6106525760405162461bcd60e51b81526004016104d790611fd2565b6000805460ff191660011790558015610675576000805461ff0019166101001790555b6106818888888861118c565b60c9805461ffff191685151561ff00191617610100851515021790556106a682610ad5565b80156106ec576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146107635760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f5354415460448201526922afa922a1a2a4ab22a960b11b60648201526084016104d7565b60fe546001600160a01b038481169116146107d35760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f524f4f546044820152695f50524544494341544560b01b60648201526084016104d7565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f821610802602060008486612020565b61080b9161204a565b0361082a576108256108208260208186612020565b611282565b610539565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18610859602060008486612020565b6108629161204a565b036108715761082582826114ee565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6108a0602060008486612020565b6108a99161204a565b036108b857610825828261175c565b60405162461bcd60e51b815260206004820152602860248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f5360448201526749474e415455524560c01b60648201526084016104d7565b610919610a7b565b606580546001600160a01b0383166001600160a01b0319909116811790915561094a6033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b336002600160a01b03146109a95760405163973d02cb60e01b81526004016104d790611fae565b600054610100900460ff16158080156109c95750600054600160ff909116105b806109e35750303b1580156109e3575060005460ff166001145b6109ff5760405162461bcd60e51b81526004016104d790611fd2565b6000805460ff191660011790558015610a22576000805461ff0019166101001790555b610a2e8585858561118c565b8015610a74576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6033546001600160a01b0316331461046b5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016104d7565b606580546001600160a01b03191690556104e9816118c6565b61046b611918565b86610b0081611b32565b610b1c5760405162461bcd60e51b81526004016104d790612068565b6000886001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b5c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b8091906120ab565b6001600160a01b03818116600090815261010060205260409020549192508a8116911614610bc05760405162461bcd60e51b81526004016104d7906120c8565b6001600160a01b038116610bd657610bd661210d565b306001600160a01b0316896001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c1e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c4291906120ab565b6001600160a01b031614610c5857610c5861210d565b8685148015610c6657508483145b610cc05760405162461bcd60e51b815260206004820152602560248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f4c60448201526408a9c8ea8960db1b60648201526084016104d7565b604051631ac8311560e21b81526001600160a01b038a1690636b20c45490610cf49033908a908a908a908a90600401612155565b6020604051808303816000875af1158015610d13573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d379190612199565b610d535760405162461bcd60e51b81526004016104d7906121b6565b60fc5460fe546040516001600160a01b03928316926316f19831921690610dae907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908f908f908f908f908f908f90602001612241565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610dda9291906122fc565b600060405180830381600087803b158015610df457600080fd5b505af1158015610e08573d6000803e3d6000fd5b50505050336001600160a01b0316896001600160a01b0316826001600160a01b03167f7a10660242ca367951ff3777cdb3c2a761e3ccad204bac118501e24693f3683d8b8b8b8b8b8b604051610e6396959493929190612328565b60405180910390a4505050505050505050565b83610e8081611b32565b610e9c5760405162461bcd60e51b81526004016104d790612068565b6000856001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610edc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f0091906120ab565b6001600160a01b0381811660009081526101006020526040902054919250878116911614610f405760405162461bcd60e51b81526004016104d7906120c8565b6001600160a01b038116610f5657610f5661210d565b306001600160a01b0316866001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f9e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fc291906120ab565b6001600160a01b031614610fd857610fd861210d565b604051637a94c56560e11b81526001600160a01b0387169063f5298aca9061100890339088908890600401612371565b6020604051808303816000875af1158015611027573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061104b9190612199565b6110675760405162461bcd60e51b81526004016104d7906121b6565b60fc5460fe54604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152898116608083015260a0820189905260c08083018990528351808403909101815260e08301938490526316f1983160e01b909352938416936316f19831936110f99391169160e4016122fc565b600060405180830381600087803b15801561111357600080fd5b505af1158015611127573d6000803e3d6000fd5b50505050846001600160a01b0316866001600160a01b0316826001600160a01b03167f2ca9093e8b5356801039806c6a08003e5b7013fb8ae48f720fc90fc1c1a8bec233888860405161117c93929190612371565b60405180910390a4505050505050565b6001600160a01b038416158015906111ac57506001600160a01b03831615155b80156111c057506001600160a01b03821615155b80156111d457506001600160a01b03811615155b6112325760405162461bcd60e51b815260206004820152602960248201527f4368696c64455243313135355072656469636174653a204241445f494e49544960448201526820a624ad20aa24a7a760b91b60648201526084016104d7565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b60008080808061129486880188612392565b6001600160a01b0380861660009081526101006020526040902054959a509398509196509450925016806112da5760405162461bcd60e51b81526004016104d7906120c8565b6112e381611b32565b6112ef576112ef61210d565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561132f573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061135391906120ab565b9050866001600160a01b0316816001600160a01b0316146113765761137661210d565b6001600160a01b03811661138c5761138c61210d565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156113d4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113f891906120ab565b6001600160a01b03161461140e5761140e61210d565b604051630ab714fb60e11b81526001600160a01b0383169063156e29f69061143e90889088908890600401612371565b6020604051808303816000875af115801561145d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906114819190612199565b61149d5760405162461bcd60e51b81526004016104d7906123ed565b846001600160a01b0316826001600160a01b0316886001600160a01b03167f2930d932c1cccd6add2e0e2d706ede9015db8a194405f2a3e1783703515e104f898888604051610e6393929190612371565b60008080808061150086880188612503565b6001600160a01b0380861660009081526101006020526040902054959b5093995091975095509350169050806115485760405162461bcd60e51b81526004016104d7906120c8565b61155181611b32565b61155d5761155d61210d565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561159d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906115c191906120ab565b9050866001600160a01b0316816001600160a01b0316146115e4576115e461210d565b6001600160a01b0381166115fa576115fa61210d565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015611642573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061166691906120ab565b6001600160a01b03161461167c5761167c61210d565b604051635712868360e01b81526001600160a01b038316906357128683906116ac90889088908890600401612648565b6020604051808303816000875af11580156116cb573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116ef9190612199565b61170b5760405162461bcd60e51b81526004016104d7906123ed565b856001600160a01b0316826001600160a01b0316886001600160a01b03167f17304b99f8dfa5a2b8dd5695d82f9947c2abfbc9cb64bab610b9a1a0feadb9a0888888604051610e6393929190612648565b60008061176b838501856126bd565b9093509150506001600160a01b0382166117875761178761210d565b6001600160a01b038281166000908152610100602052604090205416156117b0576117b061210d565b60ff546040516bffffffffffffffffffffffff19606085901b166020820152600091611800916001600160a01b039091169060340160405160208183030381529060405280519060200120611bc7565b6001600160a01b03848116600090815261010060205260409081902080546001600160a01b0319169284169283179055516379ccf11760e11b81529192509063f399e22e9061185590869086906004016122fc565b600060405180830381600087803b15801561186f57600080fd5b505af1158015611883573d6000803e3d6000fd5b50506040516001600160a01b038085169350861691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a35050505050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60c95460ff1615611a2357604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161197a919061276d565b6000604051808303818686fa925050503d80600081146119b6576040519150601f19603f3d011682016040523d82523d6000602084013e6119bb565b606091505b50915091508180156119e057506000818060200190518101906119de9190612789565b115b611a205760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b60448201526064016104d7565b50505b60c954610100900460ff161561046b57604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b019161138891611a8a919061276d565b6000604051808303818686fa925050503d8060008114611ac6576040519150601f19603f3d011682016040523d82523d6000602084013e611acb565b606091505b5091509150818015611af1575080806020019051810190611aec9190612789565b600114155b611b2e5760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b60448201526064016104d7565b5050565b6000816001600160a01b03163b600003611b4e57506000919050565b6040516301ffc9a760e01b8152636cdb3d1360e11b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611bb5575060408051601f3d908101601f19168201909252611bb291810190612199565b60015b611bc157506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116611bc15760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016104d7565b6001600160a01b03811681146104e957600080fd5b600060208284031215611c8557600080fd5b8135611c9081611c5e565b9392505050565b60008083601f840112611ca957600080fd5b5081356001600160401b03811115611cc057600080fd5b6020830191508360208260051b8501011115611cdb57600080fd5b9250929050565b60008060008060008060006080888a031215611cfd57600080fd5b8735611d0881611c5e565b965060208801356001600160401b0380821115611d2457600080fd5b611d308b838c01611c97565b909850965060408a0135915080821115611d4957600080fd5b611d558b838c01611c97565b909650945060608a0135915080821115611d6e57600080fd5b50611d7b8a828b01611c97565b989b979a50959850939692959293505050565b600080600060608486031215611da357600080fd5b8335611dae81611c5e565b95602085013595506040909401359392505050565b60008060008060808587031215611dd957600080fd5b8435611de481611c5e565b93506020850135611df481611c5e565b93969395505050506040820135916060013590565b80151581146104e957600080fd5b600060208284031215611e2957600080fd5b8135611c9081611e09565b600080600080600080600060e0888a031215611e4f57600080fd5b8735611e5a81611c5e565b96506020880135611e6a81611c5e565b95506040880135611e7a81611c5e565b94506060880135611e8a81611c5e565b93506080880135611e9a81611e09565b925060a0880135611eaa81611e09565b915060c0880135611eba81611c5e565b8091505092959891949750929550565b60008060008060608587031215611ee057600080fd5b843593506020850135611ef281611c5e565b925060408501356001600160401b0380821115611f0e57600080fd5b818701915087601f830112611f2257600080fd5b813581811115611f3157600080fd5b886020828501011115611f4357600080fd5b95989497505060200194505050565b60008060008060808587031215611f6857600080fd5b8435611f7381611c5e565b93506020850135611f8381611c5e565b92506040850135611f9381611c5e565b91506060850135611fa381611c5e565b939692955090935050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b6000808585111561203057600080fd5b8386111561203d57600080fd5b5050820193919092039150565b80356020831015611bc157600019602084900360031b1b1692915050565b60208082526023908201527f4368696c64455243313135355072656469636174653a204e4f545f434f4e54526040820152621050d560ea1b606082015260800190565b6000602082840312156120bd57600080fd5b8151611c9081611c5e565b60208082526025908201527f4368696c64455243313135355072656469636174653a20554e4d41505045445f6040820152642a27a5a2a760d91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561213c57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b038616815260606020820181905260009061217a9083018688612123565b828103604084015261218d818587612123565b98975050505050505050565b6000602082840312156121ab57600080fd5b8151611c9081611e09565b60208082526022908201527f4368696c64455243313135355072656469636174653a204255524e5f4641494c604082015261115160f21b606082015260800190565b8183526000602080850194508260005b8581101561223657813561221b81611c5e565b6001600160a01b031687529582019590820190600101612208565b509495945050505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090612274908301888a6121f8565b8281036080840152612287818789612123565b905082810360a084015261229c818587612123565b9c9b505050505050505050505050565b60005b838110156122c75781810151838201526020016122af565b50506000910152565b600081518084526122e88160208601602086016122ac565b601f01601f19169290920160200192915050565b6001600160a01b0383168152604060208201819052600090612320908301846122d0565b949350505050565b60608152600061233c60608301888a6121f8565b828103602084015261234f818789612123565b90508281036040840152612364818587612123565b9998505050505050505050565b6001600160a01b039390931683526020830191909152604082015260600190565b600080600080600060a086880312156123aa57600080fd5b85356123b581611c5e565b945060208601356123c581611c5e565b935060408601356123d581611c5e565b94979396509394606081013594506080013592915050565b60208082526022908201527f4368696c64455243313135355072656469636174653a204d494e545f4641494c604082015261115160f21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561246d5761246d61242f565b604052919050565b60006001600160401b0382111561248e5761248e61242f565b5060051b60200190565b600082601f8301126124a957600080fd5b813560206124be6124b983612475565b612445565b82815260059290921b840181019181810190868411156124dd57600080fd5b8286015b848110156124f857803583529183019183016124e1565b509695505050505050565b60008060008060008060c0878903121561251c57600080fd5b8635955060208088013561252f81611c5e565b9550604088013561253f81611c5e565b945060608801356001600160401b038082111561255b57600080fd5b818a0191508a601f83011261256f57600080fd5b813561257d6124b982612475565b81815260059190911b8301840190848101908d83111561259c57600080fd5b938501935b828510156125c35784356125b481611c5e565b825293850193908501906125a1565b9750505060808a01359250808311156125db57600080fd5b6125e78b848c01612498565b945060a08a01359250808311156125fd57600080fd5b505061260b89828a01612498565b9150509295509295509295565b600081518084526020808501945080840160005b838110156122365781518752958201959082019060010161262c565b606080825284519082018190526000906020906080840190828801845b8281101561268a5781516001600160a01b031684529284019290840190600101612665565b5050508381038285015261269e8187612618565b91505082810360408401526126b38185612618565b9695505050505050565b6000806000606084860312156126d257600080fd5b833592506020808501356126e581611c5e565b925060408501356001600160401b038082111561270157600080fd5b818701915087601f83011261271557600080fd5b8135818111156127275761272761242f565b612739601f8201601f19168501612445565b9150808252888482850101111561274f57600080fd5b80848401858401376000848284010152508093505050509250925092565b6000825161277f8184602087016122ac565b9190910192915050565b60006020828403121561279b57600080fd5b505191905056fea26469706673582212205d35ced486c2210da22d8254dca762acf5687ec4e599a9e2dbab26a8777a105964736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101b05760003560e01c8063b1768065116100ef578063d7c9e3ec11610092578063d7c9e3ec146103a5578063d8dd1773146103cc578063e0563ab1146103df578063e30c3978146103e8578063eeb49945146103f9578063f2fde38b1461040c578063f64512551461041f578063f8c8765e1461044657600080fd5b8063b1768065146102d1578063b5c5f672146102f8578063b68ad1e41461030b578063b8cd3ec01461031e578063c1225a2014610331578063c5ac2b1c14610344578063c5e4683a1461036b578063d41f17711461037e57600080fd5b80635ea5df79116101575780635ea5df7914610247578063715018a61461025e57806379ba5097146102685780637efab4f51461027057806386937eb41461029a5780638da5cb5b146102ad578063947287cf146102be57806397e5230d146102c757600080fd5b8063051eb2e2146101b557806305dc2e8f146101e557806307b3e252146101f85780631bc114ba14610206578063284017f5146102195780633b878c221461022257806351351d531461022b57806355b01e4d14610239575b600080fd5b60fe546101c8906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b60fd546101c8906001600160a01b031681565b6101c86004600360981b0181565b60fc546101c8906001600160a01b031681565b6101c861202081565b6101c861101081565b6101c86002600160a01b0381565b6101c86004600160991b0181565b61025061138881565b6040519081526020016101dc565b610266610459565b005b61026661046d565b6101c861027e366004611c73565b610100602052600090815260409020546001600160a01b031681565b6102666102a8366004611ce2565b6104ec565b6033546001600160a01b03166101c8565b61025061520881565b610250620249f081565b6102507f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b610266610306366004611d8e565b61050c565b60ff546101c8906001600160a01b031681565b61026661032c366004611dc3565b610525565b61026661033f366004611e17565b61053f565b6102507faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b610266610379366004611e17565b61058e565b6102507f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102507f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b6102666103da366004611e34565b6105d5565b6101c861203081565b6065546001600160a01b03166101c8565b610266610407366004611eca565b6106f6565b61026661041a366004611c73565b610911565b6102507f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b610266610454366004611f52565b610982565b610461610a7b565b61046b6000610ad5565b565b60655433906001600160a01b031681146104e05760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084015b60405180910390fd5b6104e981610ad5565b50565b6104f4610aee565b61050387878787878787610af6565b50505050505050565b610514610aee565b61052083338484610e76565b505050565b61052d610aee565b61053984848484610e76565b50505050565b610547610a7b565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b610596610a7b565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b03146105fc5760405163973d02cb60e01b81526004016104d790611fae565b600054610100900460ff161580801561061c5750600054600160ff909116105b806106365750303b158015610636575060005460ff166001145b6106525760405162461bcd60e51b81526004016104d790611fd2565b6000805460ff191660011790558015610675576000805461ff0019166101001790555b6106818888888861118c565b60c9805461ffff191685151561ff00191617610100851515021790556106a682610ad5565b80156106ec576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146107635760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f5354415460448201526922afa922a1a2a4ab22a960b11b60648201526084016104d7565b60fe546001600160a01b038481169116146107d35760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f524f4f546044820152695f50524544494341544560b01b60648201526084016104d7565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f821610802602060008486612020565b61080b9161204a565b0361082a576108256108208260208186612020565b611282565b610539565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18610859602060008486612020565b6108629161204a565b036108715761082582826114ee565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6108a0602060008486612020565b6108a99161204a565b036108b857610825828261175c565b60405162461bcd60e51b815260206004820152602860248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f5360448201526749474e415455524560c01b60648201526084016104d7565b610919610a7b565b606580546001600160a01b0383166001600160a01b0319909116811790915561094a6033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b336002600160a01b03146109a95760405163973d02cb60e01b81526004016104d790611fae565b600054610100900460ff16158080156109c95750600054600160ff909116105b806109e35750303b1580156109e3575060005460ff166001145b6109ff5760405162461bcd60e51b81526004016104d790611fd2565b6000805460ff191660011790558015610a22576000805461ff0019166101001790555b610a2e8585858561118c565b8015610a74576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6033546001600160a01b0316331461046b5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016104d7565b606580546001600160a01b03191690556104e9816118c6565b61046b611918565b86610b0081611b32565b610b1c5760405162461bcd60e51b81526004016104d790612068565b6000886001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b5c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b8091906120ab565b6001600160a01b03818116600090815261010060205260409020549192508a8116911614610bc05760405162461bcd60e51b81526004016104d7906120c8565b6001600160a01b038116610bd657610bd661210d565b306001600160a01b0316896001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c1e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c4291906120ab565b6001600160a01b031614610c5857610c5861210d565b8685148015610c6657508483145b610cc05760405162461bcd60e51b815260206004820152602560248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f4c60448201526408a9c8ea8960db1b60648201526084016104d7565b604051631ac8311560e21b81526001600160a01b038a1690636b20c45490610cf49033908a908a908a908a90600401612155565b6020604051808303816000875af1158015610d13573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d379190612199565b610d535760405162461bcd60e51b81526004016104d7906121b6565b60fc5460fe546040516001600160a01b03928316926316f19831921690610dae907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908f908f908f908f908f908f90602001612241565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610dda9291906122fc565b600060405180830381600087803b158015610df457600080fd5b505af1158015610e08573d6000803e3d6000fd5b50505050336001600160a01b0316896001600160a01b0316826001600160a01b03167f7a10660242ca367951ff3777cdb3c2a761e3ccad204bac118501e24693f3683d8b8b8b8b8b8b604051610e6396959493929190612328565b60405180910390a4505050505050505050565b83610e8081611b32565b610e9c5760405162461bcd60e51b81526004016104d790612068565b6000856001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610edc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f0091906120ab565b6001600160a01b0381811660009081526101006020526040902054919250878116911614610f405760405162461bcd60e51b81526004016104d7906120c8565b6001600160a01b038116610f5657610f5661210d565b306001600160a01b0316866001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f9e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fc291906120ab565b6001600160a01b031614610fd857610fd861210d565b604051637a94c56560e11b81526001600160a01b0387169063f5298aca9061100890339088908890600401612371565b6020604051808303816000875af1158015611027573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061104b9190612199565b6110675760405162461bcd60e51b81526004016104d7906121b6565b60fc5460fe54604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152898116608083015260a0820189905260c08083018990528351808403909101815260e08301938490526316f1983160e01b909352938416936316f19831936110f99391169160e4016122fc565b600060405180830381600087803b15801561111357600080fd5b505af1158015611127573d6000803e3d6000fd5b50505050846001600160a01b0316866001600160a01b0316826001600160a01b03167f2ca9093e8b5356801039806c6a08003e5b7013fb8ae48f720fc90fc1c1a8bec233888860405161117c93929190612371565b60405180910390a4505050505050565b6001600160a01b038416158015906111ac57506001600160a01b03831615155b80156111c057506001600160a01b03821615155b80156111d457506001600160a01b03811615155b6112325760405162461bcd60e51b815260206004820152602960248201527f4368696c64455243313135355072656469636174653a204241445f494e49544960448201526820a624ad20aa24a7a760b91b60648201526084016104d7565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b60008080808061129486880188612392565b6001600160a01b0380861660009081526101006020526040902054959a509398509196509450925016806112da5760405162461bcd60e51b81526004016104d7906120c8565b6112e381611b32565b6112ef576112ef61210d565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561132f573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061135391906120ab565b9050866001600160a01b0316816001600160a01b0316146113765761137661210d565b6001600160a01b03811661138c5761138c61210d565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156113d4573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113f891906120ab565b6001600160a01b03161461140e5761140e61210d565b604051630ab714fb60e11b81526001600160a01b0383169063156e29f69061143e90889088908890600401612371565b6020604051808303816000875af115801561145d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906114819190612199565b61149d5760405162461bcd60e51b81526004016104d7906123ed565b846001600160a01b0316826001600160a01b0316886001600160a01b03167f2930d932c1cccd6add2e0e2d706ede9015db8a194405f2a3e1783703515e104f898888604051610e6393929190612371565b60008080808061150086880188612503565b6001600160a01b0380861660009081526101006020526040902054959b5093995091975095509350169050806115485760405162461bcd60e51b81526004016104d7906120c8565b61155181611b32565b61155d5761155d61210d565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561159d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906115c191906120ab565b9050866001600160a01b0316816001600160a01b0316146115e4576115e461210d565b6001600160a01b0381166115fa576115fa61210d565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015611642573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061166691906120ab565b6001600160a01b03161461167c5761167c61210d565b604051635712868360e01b81526001600160a01b038316906357128683906116ac90889088908890600401612648565b6020604051808303816000875af11580156116cb573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116ef9190612199565b61170b5760405162461bcd60e51b81526004016104d7906123ed565b856001600160a01b0316826001600160a01b0316886001600160a01b03167f17304b99f8dfa5a2b8dd5695d82f9947c2abfbc9cb64bab610b9a1a0feadb9a0888888604051610e6393929190612648565b60008061176b838501856126bd565b9093509150506001600160a01b0382166117875761178761210d565b6001600160a01b038281166000908152610100602052604090205416156117b0576117b061210d565b60ff546040516bffffffffffffffffffffffff19606085901b166020820152600091611800916001600160a01b039091169060340160405160208183030381529060405280519060200120611bc7565b6001600160a01b03848116600090815261010060205260409081902080546001600160a01b0319169284169283179055516379ccf11760e11b81529192509063f399e22e9061185590869086906004016122fc565b600060405180830381600087803b15801561186f57600080fd5b505af1158015611883573d6000803e3d6000fd5b50506040516001600160a01b038085169350861691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a35050505050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60c95460ff1615611a2357604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161197a919061276d565b6000604051808303818686fa925050503d80600081146119b6576040519150601f19603f3d011682016040523d82523d6000602084013e6119bb565b606091505b50915091508180156119e057506000818060200190518101906119de9190612789565b115b611a205760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b60448201526064016104d7565b50505b60c954610100900460ff161561046b57604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b019161138891611a8a919061276d565b6000604051808303818686fa925050503d8060008114611ac6576040519150601f19603f3d011682016040523d82523d6000602084013e611acb565b606091505b5091509150818015611af1575080806020019051810190611aec9190612789565b600114155b611b2e5760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b60448201526064016104d7565b5050565b6000816001600160a01b03163b600003611b4e57506000919050565b6040516301ffc9a760e01b8152636cdb3d1360e11b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611bb5575060408051601f3d908101601f19168201909252611bb291810190612199565b60015b611bc157506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116611bc15760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016104d7565b6001600160a01b03811681146104e957600080fd5b600060208284031215611c8557600080fd5b8135611c9081611c5e565b9392505050565b60008083601f840112611ca957600080fd5b5081356001600160401b03811115611cc057600080fd5b6020830191508360208260051b8501011115611cdb57600080fd5b9250929050565b60008060008060008060006080888a031215611cfd57600080fd5b8735611d0881611c5e565b965060208801356001600160401b0380821115611d2457600080fd5b611d308b838c01611c97565b909850965060408a0135915080821115611d4957600080fd5b611d558b838c01611c97565b909650945060608a0135915080821115611d6e57600080fd5b50611d7b8a828b01611c97565b989b979a50959850939692959293505050565b600080600060608486031215611da357600080fd5b8335611dae81611c5e565b95602085013595506040909401359392505050565b60008060008060808587031215611dd957600080fd5b8435611de481611c5e565b93506020850135611df481611c5e565b93969395505050506040820135916060013590565b80151581146104e957600080fd5b600060208284031215611e2957600080fd5b8135611c9081611e09565b600080600080600080600060e0888a031215611e4f57600080fd5b8735611e5a81611c5e565b96506020880135611e6a81611c5e565b95506040880135611e7a81611c5e565b94506060880135611e8a81611c5e565b93506080880135611e9a81611e09565b925060a0880135611eaa81611e09565b915060c0880135611eba81611c5e565b8091505092959891949750929550565b60008060008060608587031215611ee057600080fd5b843593506020850135611ef281611c5e565b925060408501356001600160401b0380821115611f0e57600080fd5b818701915087601f830112611f2257600080fd5b813581811115611f3157600080fd5b886020828501011115611f4357600080fd5b95989497505060200194505050565b60008060008060808587031215611f6857600080fd5b8435611f7381611c5e565b93506020850135611f8381611c5e565b92506040850135611f9381611c5e565b91506060850135611fa381611c5e565b939692955090935050565b6020808252600a908201526914d654d5115350d0531360b21b604082015260600190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b6000808585111561203057600080fd5b8386111561203d57600080fd5b5050820193919092039150565b80356020831015611bc157600019602084900360031b1b1692915050565b60208082526023908201527f4368696c64455243313135355072656469636174653a204e4f545f434f4e54526040820152621050d560ea1b606082015260800190565b6000602082840312156120bd57600080fd5b8151611c9081611c5e565b60208082526025908201527f4368696c64455243313135355072656469636174653a20554e4d41505045445f6040820152642a27a5a2a760d91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561213c57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b038616815260606020820181905260009061217a9083018688612123565b828103604084015261218d818587612123565b98975050505050505050565b6000602082840312156121ab57600080fd5b8151611c9081611e09565b60208082526022908201527f4368696c64455243313135355072656469636174653a204255524e5f4641494c604082015261115160f21b606082015260800190565b8183526000602080850194508260005b8581101561223657813561221b81611c5e565b6001600160a01b031687529582019590820190600101612208565b509495945050505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090612274908301888a6121f8565b8281036080840152612287818789612123565b905082810360a084015261229c818587612123565b9c9b505050505050505050505050565b60005b838110156122c75781810151838201526020016122af565b50506000910152565b600081518084526122e88160208601602086016122ac565b601f01601f19169290920160200192915050565b6001600160a01b0383168152604060208201819052600090612320908301846122d0565b949350505050565b60608152600061233c60608301888a6121f8565b828103602084015261234f818789612123565b90508281036040840152612364818587612123565b9998505050505050505050565b6001600160a01b039390931683526020830191909152604082015260600190565b600080600080600060a086880312156123aa57600080fd5b85356123b581611c5e565b945060208601356123c581611c5e565b935060408601356123d581611c5e565b94979396509394606081013594506080013592915050565b60208082526022908201527f4368696c64455243313135355072656469636174653a204d494e545f4641494c604082015261115160f21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b038111828210171561246d5761246d61242f565b604052919050565b60006001600160401b0382111561248e5761248e61242f565b5060051b60200190565b600082601f8301126124a957600080fd5b813560206124be6124b983612475565b612445565b82815260059290921b840181019181810190868411156124dd57600080fd5b8286015b848110156124f857803583529183019183016124e1565b509695505050505050565b60008060008060008060c0878903121561251c57600080fd5b8635955060208088013561252f81611c5e565b9550604088013561253f81611c5e565b945060608801356001600160401b038082111561255b57600080fd5b818a0191508a601f83011261256f57600080fd5b813561257d6124b982612475565b81815260059190911b8301840190848101908d83111561259c57600080fd5b938501935b828510156125c35784356125b481611c5e565b825293850193908501906125a1565b9750505060808a01359250808311156125db57600080fd5b6125e78b848c01612498565b945060a08a01359250808311156125fd57600080fd5b505061260b89828a01612498565b9150509295509295509295565b600081518084526020808501945080840160005b838110156122365781518752958201959082019060010161262c565b606080825284519082018190526000906020906080840190828801845b8281101561268a5781516001600160a01b031684529284019290840190600101612665565b5050508381038285015261269e8187612618565b91505082810360408401526126b38185612618565b9695505050505050565b6000806000606084860312156126d257600080fd5b833592506020808501356126e581611c5e565b925060408501356001600160401b038082111561270157600080fd5b818701915087601f83011261271557600080fd5b8135818111156127275761272761242f565b612739601f8201601f19168501612445565b9150808252888482850101111561274f57600080fd5b80848401858401376000848284010152508093505050509250925092565b6000825161277f8184602087016122ac565b9190910192915050565b60006020828403121561279b57600080fd5b505191905056fea26469706673582212205d35ced486c2210da22d8254dca762acf5687ec4e599a9e2dbab26a8777a105964736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RootMintableERC1155PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RootMintableERC1155Predicate","sourceName":"contracts/child/RootMintableERC1155Predicate.sol","abi":[{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"depositor","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2MintableERC1155Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"depositor","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"L2MintableERC1155DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2MintableERC1155Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"L2MintableERC1155WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2MintableTokenMapped","type":"event"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childERC1155Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"depositBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"depositTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newChildERC1155Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"}],"name":"mapToken","outputs":[{"internalType":"address","name":"childToken","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256[]","name":"","type":"uint256[]"},{"internalType":"uint256[]","name":"","type":"uint256[]"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC1155BatchReceived","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC1155Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611c01806100206000396000f3fe608060405234801561001057600080fd5b50600436106101215760003560e01c8063b68ad1e4116100ad578063eeb4994511610071578063eeb49945146102fe578063f23a6e6114610311578063f4a120f714610330578063f645125514610343578063f8c8765e1461036a57600080fd5b8063b68ad1e41461023e578063bc197c8114610251578063c5ac2b1c14610289578063d41f1771146102b0578063d7c9e3ec146102d757600080fd5b80634c4c45de116100f45780634c4c45de146101a7578063654715e6146101ba5780637efab4f5146101cd578063a78e111c146101f6578063b17680651461020957600080fd5b806301ffc9a71461012657806305dc2e8f1461014e5780630efe6a8b146101795780631bc114ba1461018e575b600080fd5b610139610134366004611182565b61037d565b60405190151581526020015b60405180910390f35b600154610161906001600160a01b031681565b6040516001600160a01b039091168152602001610145565b61018c6101873660046111cb565b6103b4565b005b600054610161906201000090046001600160a01b031681565b61018c6101b536600461124b565b6103c5565b600254610161906001600160a01b031681565b6101616101db3660046112f7565b6004602052600090815260409020546001600160a01b031681565b61018c610204366004611314565b61043f565b6102307f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b604051908152602001610145565b600354610161906001600160a01b031681565b61027061025f3660046114a6565b63bc197c8160e01b95945050505050565b6040516001600160e01b03199091168152602001610145565b6102307faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6102307f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102307f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61018c61030c366004611553565b610451565b61027061031f3660046115db565b63f23a6e6160e01b95945050505050565b61016161033e3660046112f7565b610629565b6102307f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61018c610378366004611643565b610944565b60006001600160e01b03198216630271189760e51b14806103ae57506301ffc9a760e01b6001600160e01b03198316145b92915050565b6103c083338484610a5d565b505050565b84831480156103d357508481145b6104275760405162461bcd60e51b815260206004820152602c6024820152600080516020611bac83398151915260448201526b0ac82989288be988a9c8ea8960a31b60648201526084015b60405180910390fd5b61043687878787878787610bf3565b50505050505050565b61044b84848484610a5d565b50505050565b6001546001600160a01b031633146104c55760405162461bcd60e51b815260206004820152603160248201527f526f6f744d696e7461626c65455243313135355072656469636174653a204f4e604482015270262cafa9aa20aa22afa922a1a2a4ab22a960791b606482015260840161041e565b6002546001600160a01b0384811691161461053d5760405162461bcd60e51b815260206004820152603260248201527f526f6f744d696e7461626c65455243313135355072656469636174653a204f4e6044820152714c595f4348494c445f50524544494341544560701b606482015260840161041e565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286961056c60206000848661169f565b610575916116c9565b036105945761058f61058a826020818661169f565b610dd3565b61044b565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed26105c360206000848661169f565b6105cc916116c9565b036105db5761058f8282610ed2565b60405162461bcd60e51b815260206004820152602f6024820152600080516020611bac83398151915260448201526e56414c49445f5349474e415455524560881b606482015260840161041e565b60006001600160a01b0382166106835760405162461bcd60e51b815260206004820152602b6024820152600080516020611bac83398151915260448201526a2b20a624a22faa27a5a2a760a91b606482015260840161041e565b6001600160a01b0382811660009081526004602052604090205416156107005760405162461bcd60e51b815260206004820152602c60248201527f526f6f744d696e7461626c65455243313135355072656469636174653a20414c60448201526b149150511657d3505414115160a21b606482015260840161041e565b6002546003546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b03928316926107aa921690603401604051602081830303815290604052805190602001208360405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b03848116600081815260046020818152604080842080546001600160a01b031916968816969096179095558451908101855282815293516303a24d0760e21b8152908101919091529294509091630e89341c90602401600060405180830381865afa92505050801561084557506040513d6000823e601f3d908101601f19168201604052610842919081019061170b565b60015b1561084d5790505b600060029054906101000a90046001600160a01b03166001600160a01b03166316f19831837f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad87856040516020016108a7939291906117ad565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016108d39291906117d7565b600060405180830381600087803b1580156108ed57600080fd5b505af1158015610901573d6000803e3d6000fd5b50506040516001600160a01b038087169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a35050919050565b600054610100900460ff16158080156109645750600054600160ff909116105b8061097e5750303b15801561097e575060005460ff166001145b6109e15760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161041e565b6000805460ff191660011790558015610a04576000805461ff0019166101001790555b610a1085858585611033565b8015610a56576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6000610a688561113b565b604051637921219560e11b81529091506001600160a01b0386169063f242432a90610a9d903390309088908890600401611803565b600060405180830381600087803b158015610ab757600080fd5b505af1158015610acb573d6000803e3d6000fd5b5050600054600254604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038b8116828401523360608301528a8116608083015260a082018a905260c08083018a90528351808403909101815260e08301938490526316f1983160e01b90935262010000909404841695506316f198319450610b68939092169160e4016117d7565b600060405180830381600087803b158015610b8257600080fd5b505af1158015610b96573d6000803e3d6000fd5b505060408051338152602081018790529081018590526001600160a01b03808816935084811692508816907fe6f1fb6bb1930a5d4b997d56e0a4a8cb6f3f941f0d5391f63c1f6914ee01e0b89060600160405180910390a4610a56565b6000610bfe8861113b565b905060005b84811015610caa57886001600160a01b031663f242432a3330898986818110610c2e57610c2e61183b565b90506020020135888887818110610c4757610c4761183b565b905060200201356040518563ffffffff1660e01b8152600401610c6d9493929190611803565b600060405180830381600087803b158015610c8757600080fd5b505af1158015610c9b573d6000803e3d6000fd5b50505050806001019050610c03565b506000546002546040516001600160a01b03620100009093048316926316f19831921690610d0c907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908d9033908e908e908e908e908e908e906020016118cc565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610d389291906117d7565b600060405180830381600087803b158015610d5257600080fd5b505af1158015610d66573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316896001600160a01b03167fa7d9cd27143f817fe006011faf3c04351f70f75cd30e7b21405817f2f670041e8a8a8a8a8a8a604051610dc196959493929190611937565b60405180910390a45050505050505050565b600080808080610de586880188611980565b6001600160a01b03808616600090815260046020526040902054959a50939850919650945092501680610e1a57610e1a6119db565b604051637921219560e11b81526001600160a01b0387169063f242432a90610e4c903090889088908890600401611803565b600060405180830381600087803b158015610e6657600080fd5b505af1158015610e7a573d6000803e3d6000fd5b5050604080516001600160a01b0389811682526020820188905291810186905281881693508482169250908916907f52cdfbe452878311d3237a4c20a951600d8e3a4fe6691d967d33788dc12d19c690606001610dc1565b600080808080610ee4868801886119f1565b6001600160a01b03808616600090815260046020526040902054959b509399509197509550935016905080610f1b57610f1b6119db565b60005b8351811015610fe157866001600160a01b031663f242432a30878481518110610f4957610f4961183b565b6020026020010151878581518110610f6357610f6361183b565b6020026020010151878681518110610f7d57610f7d61183b565b60200260200101516040518563ffffffff1660e01b8152600401610fa49493929190611803565b600060405180830381600087803b158015610fbe57600080fd5b505af1158015610fd2573d6000803e3d6000fd5b50505050806001019050610f1e565b50846001600160a01b0316816001600160a01b0316876001600160a01b03167f52733a40a0466155541c2fc4044165dd37a3db116bc834bab2f020665e90fd20878787604051610dc193929190611b36565b6001600160a01b0384161580159061105357506001600160a01b03831615155b801561106757506001600160a01b03821615155b801561107b57506001600160a01b03811615155b6110e05760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c65455243313135355072656469636174653a20424160448201526f222fa4a724aa24a0a624ad20aa24a7a760811b606482015260840161041e565b600080546001600160a01b03958616620100000262010000600160b01b0319909116179055600180549385166001600160a01b0319948516179055600280549285169284169290921790915560038054919093169116179055565b6001600160a01b0380821660009081526004602052604090205416806111675761116482610629565b90505b6001600160a01b03811661117d5761117d6119db565b919050565b60006020828403121561119457600080fd5b81356001600160e01b0319811681146111ac57600080fd5b9392505050565b6001600160a01b03811681146111c857600080fd5b50565b6000806000606084860312156111e057600080fd5b83356111eb816111b3565b95602085013595506040909401359392505050565b60008083601f84011261121257600080fd5b5081356001600160401b0381111561122957600080fd5b6020830191508360208260051b850101111561124457600080fd5b9250929050565b60008060008060008060006080888a03121561126657600080fd5b8735611271816111b3565b965060208801356001600160401b038082111561128d57600080fd5b6112998b838c01611200565b909850965060408a01359150808211156112b257600080fd5b6112be8b838c01611200565b909650945060608a01359150808211156112d757600080fd5b506112e48a828b01611200565b989b979a50959850939692959293505050565b60006020828403121561130957600080fd5b81356111ac816111b3565b6000806000806080858703121561132a57600080fd5b8435611335816111b3565b93506020850135611345816111b3565b93969395505050506040820135916060013590565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156113985761139861135a565b604052919050565b60006001600160401b038211156113b9576113b961135a565b5060051b60200190565b600082601f8301126113d457600080fd5b813560206113e96113e4836113a0565b611370565b82815260059290921b8401810191818101908684111561140857600080fd5b8286015b84811015611423578035835291830191830161140c565b509695505050505050565b60006001600160401b038211156114475761144761135a565b50601f01601f191660200190565b600082601f83011261146657600080fd5b81356114746113e48261142e565b81815284602083860101111561148957600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a086880312156114be57600080fd5b85356114c9816111b3565b945060208601356114d9816111b3565b935060408601356001600160401b03808211156114f557600080fd5b61150189838a016113c3565b9450606088013591508082111561151757600080fd5b61152389838a016113c3565b9350608088013591508082111561153957600080fd5b5061154688828901611455565b9150509295509295909350565b6000806000806060858703121561156957600080fd5b84359350602085013561157b816111b3565b925060408501356001600160401b038082111561159757600080fd5b818701915087601f8301126115ab57600080fd5b8135818111156115ba57600080fd5b8860208285010111156115cc57600080fd5b95989497505060200194505050565b600080600080600060a086880312156115f357600080fd5b85356115fe816111b3565b9450602086013561160e816111b3565b9350604086013592506060860135915060808601356001600160401b0381111561163757600080fd5b61154688828901611455565b6000806000806080858703121561165957600080fd5b8435611664816111b3565b93506020850135611674816111b3565b92506040850135611684816111b3565b91506060850135611694816111b3565b939692955090935050565b600080858511156116af57600080fd5b838611156116bc57600080fd5b5050820193919092039150565b803560208310156103ae57600019602084900360031b1b1692915050565b60005b838110156117025781810151838201526020016116ea565b50506000910152565b60006020828403121561171d57600080fd5b81516001600160401b0381111561173357600080fd5b8201601f8101841361174457600080fd5b80516117526113e48261142e565b81815285602083850101111561176757600080fd5b6117788260208301602086016116e7565b95945050505050565b600081518084526117998160208601602086016116e7565b601f01601f19169290920160200192915050565b8381526001600160a01b038316602082015260606040820181905260009061177890830184611781565b6001600160a01b03831681526040602082018190526000906117fb90830184611781565b949350505050565b6001600160a01b0394851681529290931660208301526040820152606081019190915260a06080820181905260009082015260c00190565b634e487b7160e01b600052603260045260246000fd5b8183526000602080850194508260005b8581101561188f578135611874816111b3565b6001600160a01b031687529582019590820190600101611861565b509495945050505050565b81835260006001600160fb1b038311156118b357600080fd5b8260051b80836020870137939093016020019392505050565b8981526001600160a01b0389811660208301528816604082015260c0606082018190526000906118ff908301888a611851565b828103608084015261191281878961189a565b905082810360a084015261192781858761189a565b9c9b505050505050505050505050565b60608152600061194b60608301888a611851565b828103602084015261195e81878961189a565b9050828103604084015261197381858761189a565b9998505050505050505050565b600080600080600060a0868803121561199857600080fd5b85356119a3816111b3565b945060208601356119b3816111b3565b935060408601356119c3816111b3565b94979396509394606081013594506080013592915050565b634e487b7160e01b600052600160045260246000fd5b60008060008060008060c08789031215611a0a57600080fd5b86359550602080880135611a1d816111b3565b95506040880135611a2d816111b3565b945060608801356001600160401b0380821115611a4957600080fd5b818a0191508a601f830112611a5d57600080fd5b8135611a6b6113e4826113a0565b81815260059190911b8301840190848101908d831115611a8a57600080fd5b938501935b82851015611ab1578435611aa2816111b3565b82529385019390850190611a8f565b9750505060808a0135925080831115611ac957600080fd5b611ad58b848c016113c3565b945060a08a0135925080831115611aeb57600080fd5b5050611af989828a016113c3565b9150509295509295509295565b600081518084526020808501945080840160005b8381101561188f57815187529582019590820190600101611b1a565b606080825284519082018190526000906020906080840190828801845b82811015611b785781516001600160a01b031684529284019290840190600101611b53565b50505083810382850152611b8c8187611b06565b9150508281036040840152611ba18185611b06565b969550505050505056fe526f6f744d696e7461626c65455243313135355072656469636174653a20494ea2646970667358221220bac4157c867ef25ba423441a6f4177226bff4063bb665be9fb147719e7b08cc664736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101215760003560e01c8063b68ad1e4116100ad578063eeb4994511610071578063eeb49945146102fe578063f23a6e6114610311578063f4a120f714610330578063f645125514610343578063f8c8765e1461036a57600080fd5b8063b68ad1e41461023e578063bc197c8114610251578063c5ac2b1c14610289578063d41f1771146102b0578063d7c9e3ec146102d757600080fd5b80634c4c45de116100f45780634c4c45de146101a7578063654715e6146101ba5780637efab4f5146101cd578063a78e111c146101f6578063b17680651461020957600080fd5b806301ffc9a71461012657806305dc2e8f1461014e5780630efe6a8b146101795780631bc114ba1461018e575b600080fd5b610139610134366004611182565b61037d565b60405190151581526020015b60405180910390f35b600154610161906001600160a01b031681565b6040516001600160a01b039091168152602001610145565b61018c6101873660046111cb565b6103b4565b005b600054610161906201000090046001600160a01b031681565b61018c6101b536600461124b565b6103c5565b600254610161906001600160a01b031681565b6101616101db3660046112f7565b6004602052600090815260409020546001600160a01b031681565b61018c610204366004611314565b61043f565b6102307f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b604051908152602001610145565b600354610161906001600160a01b031681565b61027061025f3660046114a6565b63bc197c8160e01b95945050505050565b6040516001600160e01b03199091168152602001610145565b6102307faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6102307f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102307f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61018c61030c366004611553565b610451565b61027061031f3660046115db565b63f23a6e6160e01b95945050505050565b61016161033e3660046112f7565b610629565b6102307f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61018c610378366004611643565b610944565b60006001600160e01b03198216630271189760e51b14806103ae57506301ffc9a760e01b6001600160e01b03198316145b92915050565b6103c083338484610a5d565b505050565b84831480156103d357508481145b6104275760405162461bcd60e51b815260206004820152602c6024820152600080516020611bac83398151915260448201526b0ac82989288be988a9c8ea8960a31b60648201526084015b60405180910390fd5b61043687878787878787610bf3565b50505050505050565b61044b84848484610a5d565b50505050565b6001546001600160a01b031633146104c55760405162461bcd60e51b815260206004820152603160248201527f526f6f744d696e7461626c65455243313135355072656469636174653a204f4e604482015270262cafa9aa20aa22afa922a1a2a4ab22a960791b606482015260840161041e565b6002546001600160a01b0384811691161461053d5760405162461bcd60e51b815260206004820152603260248201527f526f6f744d696e7461626c65455243313135355072656469636174653a204f4e6044820152714c595f4348494c445f50524544494341544560701b606482015260840161041e565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286961056c60206000848661169f565b610575916116c9565b036105945761058f61058a826020818661169f565b610dd3565b61044b565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed26105c360206000848661169f565b6105cc916116c9565b036105db5761058f8282610ed2565b60405162461bcd60e51b815260206004820152602f6024820152600080516020611bac83398151915260448201526e56414c49445f5349474e415455524560881b606482015260840161041e565b60006001600160a01b0382166106835760405162461bcd60e51b815260206004820152602b6024820152600080516020611bac83398151915260448201526a2b20a624a22faa27a5a2a760a91b606482015260840161041e565b6001600160a01b0382811660009081526004602052604090205416156107005760405162461bcd60e51b815260206004820152602c60248201527f526f6f744d696e7461626c65455243313135355072656469636174653a20414c60448201526b149150511657d3505414115160a21b606482015260840161041e565b6002546003546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b03928316926107aa921690603401604051602081830303815290604052805190602001208360405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b03848116600081815260046020818152604080842080546001600160a01b031916968816969096179095558451908101855282815293516303a24d0760e21b8152908101919091529294509091630e89341c90602401600060405180830381865afa92505050801561084557506040513d6000823e601f3d908101601f19168201604052610842919081019061170b565b60015b1561084d5790505b600060029054906101000a90046001600160a01b03166001600160a01b03166316f19831837f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad87856040516020016108a7939291906117ad565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016108d39291906117d7565b600060405180830381600087803b1580156108ed57600080fd5b505af1158015610901573d6000803e3d6000fd5b50506040516001600160a01b038087169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a35050919050565b600054610100900460ff16158080156109645750600054600160ff909116105b8061097e5750303b15801561097e575060005460ff166001145b6109e15760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161041e565b6000805460ff191660011790558015610a04576000805461ff0019166101001790555b610a1085858585611033565b8015610a56576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6000610a688561113b565b604051637921219560e11b81529091506001600160a01b0386169063f242432a90610a9d903390309088908890600401611803565b600060405180830381600087803b158015610ab757600080fd5b505af1158015610acb573d6000803e3d6000fd5b5050600054600254604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038b8116828401523360608301528a8116608083015260a082018a905260c08083018a90528351808403909101815260e08301938490526316f1983160e01b90935262010000909404841695506316f198319450610b68939092169160e4016117d7565b600060405180830381600087803b158015610b8257600080fd5b505af1158015610b96573d6000803e3d6000fd5b505060408051338152602081018790529081018590526001600160a01b03808816935084811692508816907fe6f1fb6bb1930a5d4b997d56e0a4a8cb6f3f941f0d5391f63c1f6914ee01e0b89060600160405180910390a4610a56565b6000610bfe8861113b565b905060005b84811015610caa57886001600160a01b031663f242432a3330898986818110610c2e57610c2e61183b565b90506020020135888887818110610c4757610c4761183b565b905060200201356040518563ffffffff1660e01b8152600401610c6d9493929190611803565b600060405180830381600087803b158015610c8757600080fd5b505af1158015610c9b573d6000803e3d6000fd5b50505050806001019050610c03565b506000546002546040516001600160a01b03620100009093048316926316f19831921690610d0c907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908d9033908e908e908e908e908e908e906020016118cc565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610d389291906117d7565b600060405180830381600087803b158015610d5257600080fd5b505af1158015610d66573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316896001600160a01b03167fa7d9cd27143f817fe006011faf3c04351f70f75cd30e7b21405817f2f670041e8a8a8a8a8a8a604051610dc196959493929190611937565b60405180910390a45050505050505050565b600080808080610de586880188611980565b6001600160a01b03808616600090815260046020526040902054959a50939850919650945092501680610e1a57610e1a6119db565b604051637921219560e11b81526001600160a01b0387169063f242432a90610e4c903090889088908890600401611803565b600060405180830381600087803b158015610e6657600080fd5b505af1158015610e7a573d6000803e3d6000fd5b5050604080516001600160a01b0389811682526020820188905291810186905281881693508482169250908916907f52cdfbe452878311d3237a4c20a951600d8e3a4fe6691d967d33788dc12d19c690606001610dc1565b600080808080610ee4868801886119f1565b6001600160a01b03808616600090815260046020526040902054959b509399509197509550935016905080610f1b57610f1b6119db565b60005b8351811015610fe157866001600160a01b031663f242432a30878481518110610f4957610f4961183b565b6020026020010151878581518110610f6357610f6361183b565b6020026020010151878681518110610f7d57610f7d61183b565b60200260200101516040518563ffffffff1660e01b8152600401610fa49493929190611803565b600060405180830381600087803b158015610fbe57600080fd5b505af1158015610fd2573d6000803e3d6000fd5b50505050806001019050610f1e565b50846001600160a01b0316816001600160a01b0316876001600160a01b03167f52733a40a0466155541c2fc4044165dd37a3db116bc834bab2f020665e90fd20878787604051610dc193929190611b36565b6001600160a01b0384161580159061105357506001600160a01b03831615155b801561106757506001600160a01b03821615155b801561107b57506001600160a01b03811615155b6110e05760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c65455243313135355072656469636174653a20424160448201526f222fa4a724aa24a0a624ad20aa24a7a760811b606482015260840161041e565b600080546001600160a01b03958616620100000262010000600160b01b0319909116179055600180549385166001600160a01b0319948516179055600280549285169284169290921790915560038054919093169116179055565b6001600160a01b0380821660009081526004602052604090205416806111675761116482610629565b90505b6001600160a01b03811661117d5761117d6119db565b919050565b60006020828403121561119457600080fd5b81356001600160e01b0319811681146111ac57600080fd5b9392505050565b6001600160a01b03811681146111c857600080fd5b50565b6000806000606084860312156111e057600080fd5b83356111eb816111b3565b95602085013595506040909401359392505050565b60008083601f84011261121257600080fd5b5081356001600160401b0381111561122957600080fd5b6020830191508360208260051b850101111561124457600080fd5b9250929050565b60008060008060008060006080888a03121561126657600080fd5b8735611271816111b3565b965060208801356001600160401b038082111561128d57600080fd5b6112998b838c01611200565b909850965060408a01359150808211156112b257600080fd5b6112be8b838c01611200565b909650945060608a01359150808211156112d757600080fd5b506112e48a828b01611200565b989b979a50959850939692959293505050565b60006020828403121561130957600080fd5b81356111ac816111b3565b6000806000806080858703121561132a57600080fd5b8435611335816111b3565b93506020850135611345816111b3565b93969395505050506040820135916060013590565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156113985761139861135a565b604052919050565b60006001600160401b038211156113b9576113b961135a565b5060051b60200190565b600082601f8301126113d457600080fd5b813560206113e96113e4836113a0565b611370565b82815260059290921b8401810191818101908684111561140857600080fd5b8286015b84811015611423578035835291830191830161140c565b509695505050505050565b60006001600160401b038211156114475761144761135a565b50601f01601f191660200190565b600082601f83011261146657600080fd5b81356114746113e48261142e565b81815284602083860101111561148957600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a086880312156114be57600080fd5b85356114c9816111b3565b945060208601356114d9816111b3565b935060408601356001600160401b03808211156114f557600080fd5b61150189838a016113c3565b9450606088013591508082111561151757600080fd5b61152389838a016113c3565b9350608088013591508082111561153957600080fd5b5061154688828901611455565b9150509295509295909350565b6000806000806060858703121561156957600080fd5b84359350602085013561157b816111b3565b925060408501356001600160401b038082111561159757600080fd5b818701915087601f8301126115ab57600080fd5b8135818111156115ba57600080fd5b8860208285010111156115cc57600080fd5b95989497505060200194505050565b600080600080600060a086880312156115f357600080fd5b85356115fe816111b3565b9450602086013561160e816111b3565b9350604086013592506060860135915060808601356001600160401b0381111561163757600080fd5b61154688828901611455565b6000806000806080858703121561165957600080fd5b8435611664816111b3565b93506020850135611674816111b3565b92506040850135611684816111b3565b91506060850135611694816111b3565b939692955090935050565b600080858511156116af57600080fd5b838611156116bc57600080fd5b5050820193919092039150565b803560208310156103ae57600019602084900360031b1b1692915050565b60005b838110156117025781810151838201526020016116ea565b50506000910152565b60006020828403121561171d57600080fd5b81516001600160401b0381111561173357600080fd5b8201601f8101841361174457600080fd5b80516117526113e48261142e565b81815285602083850101111561176757600080fd5b6117788260208301602086016116e7565b95945050505050565b600081518084526117998160208601602086016116e7565b601f01601f19169290920160200192915050565b8381526001600160a01b038316602082015260606040820181905260009061177890830184611781565b6001600160a01b03831681526040602082018190526000906117fb90830184611781565b949350505050565b6001600160a01b0394851681529290931660208301526040820152606081019190915260a06080820181905260009082015260c00190565b634e487b7160e01b600052603260045260246000fd5b8183526000602080850194508260005b8581101561188f578135611874816111b3565b6001600160a01b031687529582019590820190600101611861565b509495945050505050565b81835260006001600160fb1b038311156118b357600080fd5b8260051b80836020870137939093016020019392505050565b8981526001600160a01b0389811660208301528816604082015260c0606082018190526000906118ff908301888a611851565b828103608084015261191281878961189a565b905082810360a084015261192781858761189a565b9c9b505050505050505050505050565b60608152600061194b60608301888a611851565b828103602084015261195e81878961189a565b9050828103604084015261197381858761189a565b9998505050505050505050565b600080600080600060a0868803121561199857600080fd5b85356119a3816111b3565b945060208601356119b3816111b3565b935060408601356119c3816111b3565b94979396509394606081013594506080013592915050565b634e487b7160e01b600052600160045260246000fd5b60008060008060008060c08789031215611a0a57600080fd5b86359550602080880135611a1d816111b3565b95506040880135611a2d816111b3565b945060608801356001600160401b0380821115611a4957600080fd5b818a0191508a601f830112611a5d57600080fd5b8135611a6b6113e4826113a0565b81815260059190911b8301840190848101908d831115611a8a57600080fd5b938501935b82851015611ab1578435611aa2816111b3565b82529385019390850190611a8f565b9750505060808a0135925080831115611ac957600080fd5b611ad58b848c016113c3565b945060a08a0135925080831115611aeb57600080fd5b5050611af989828a016113c3565b9150509295509295509295565b600081518084526020808501945080840160005b8381101561188f57815187529582019590820190600101611b1a565b606080825284519082018190526000906020906080840190828801845b82811015611b785781516001600160a01b031684529284019290840190600101611b53565b50505083810382850152611b8c8187611b06565b9150508281036040840152611ba18185611b06565b969550505050505056fe526f6f744d696e7461626c65455243313135355072656469636174653a20494ea2646970667358221220bac4157c867ef25ba423441a6f4177226bff4063bb665be9fb147719e7b08cc664736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RootMintableERC1155PredicateACLArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RootMintableERC1155PredicateAccessList","sourceName":"contracts/child/RootMintableERC1155PredicateAccessList.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"AllowListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"block","type":"uint256"},{"indexed":true,"internalType":"bool","name":"status","type":"bool"}],"name":"BlockListUsageSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"depositor","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2MintableERC1155Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"depositor","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"L2MintableERC1155DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"L2MintableERC1155Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"L2MintableERC1155WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"L2MintableTokenMapped","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"childERC1155Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"depositBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"depositTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newChildERC1155Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"},{"internalType":"bool","name":"newUseAllowList","type":"bool"},{"internalType":"bool","name":"newUseBlockList","type":"bool"},{"internalType":"address","name":"newOwner","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newL2StateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newChildERC1155Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"l2StateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"}],"name":"mapToken","outputs":[{"internalType":"address","name":"childToken","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256[]","name":"","type":"uint256[]"},{"internalType":"uint256[]","name":"","type":"uint256[]"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC1155BatchReceived","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC1155Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseAllowList","type":"bool"}],"name":"setAllowList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"newUseBlockList","type":"bool"}],"name":"setBlockList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"stateReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50612480806100206000396000f3fe608060405234801561001057600080fd5b506004361061021c5760003560e01c8063a78e111c11610125578063d8dd1773116100ad578063f23a6e611161007c578063f23a6e61146104d3578063f2fde38b146104f2578063f4a120f714610505578063f645125514610518578063f8c8765e1461053f57600080fd5b8063d8dd177314610493578063e0563ab1146104a6578063e30c3978146104af578063eeb49945146104c057600080fd5b8063c1225a20116100f4578063c1225a20146103f8578063c5ac2b1c1461040b578063c5e4683a14610432578063d41f177114610445578063d7c9e3ec1461046c57600080fd5b8063a78e111c14610373578063b176806514610386578063b68ad1e4146103ad578063bc197c81146103c057600080fd5b806355b01e4d116101a857806379ba50971161017757806379ba50971461031d5780637efab4f5146103255780638da5cb5b1461034f578063947287cf1461036057806397e5230d1461036957600080fd5b806355b01e4d146102dd5780635ea5df79146102eb578063654715e614610302578063715018a61461031557600080fd5b80631bc114ba116101ef5780631bc114ba14610297578063284017f5146102aa5780633b878c22146102b35780634c4c45de146102bc57806351351d53146102cf57600080fd5b806301ffc9a71461022157806305dc2e8f1461024957806307b3e252146102745780630efe6a8b14610282575b600080fd5b61023461022f3660046118c4565b610552565b60405190151581526020015b60405180910390f35b60fd5461025c906001600160a01b031681565b6040516001600160a01b039091168152602001610240565b61025c6004600360981b0181565b61029561029036600461190a565b610589565b005b60fc5461025c906001600160a01b031681565b61025c61202081565b61025c61101081565b6102956102ca36600461198a565b61059a565b61025c6002600160a01b0381565b61025c6004600160991b0181565b6102f461138881565b604051908152602001610240565b60fe5461025c906001600160a01b031681565b610295610614565b610295610628565b61025c610333366004611a36565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b031661025c565b6102f461520881565b6102f4620249f081565b610295610381366004611a53565b6106a2565b6102f47f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff5461025c906001600160a01b031681565b6103df6103ce366004611be5565b63bc197c8160e01b95945050505050565b6040516001600160e01b03199091168152602001610240565b610295610406366004611ca2565b6106b4565b6102f47faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b610295610440366004611ca2565b610703565b6102f47f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102f47f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b6102956104a1366004611cbd565b61074a565b61025c61203081565b6065546001600160a01b031661025c565b6102956104ce366004611d4f565b610888565b6103df6104e1366004611dd7565b63f23a6e6160e01b95945050505050565b610295610500366004611a36565b610a60565b61025c610513366004611a36565b610ad1565b6102f47f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61029561054d366004611e3f565b610de1565b60006001600160e01b03198216630271189760e51b148061058357506301ffc9a760e01b6001600160e01b03198316145b92915050565b61059583338484610eb3565b505050565b84831480156105a857508481145b6105fc5760405162461bcd60e51b815260206004820152602c602482015260008051602061242b83398151915260448201526b0ac82989288be988a9c8ea8960a31b60648201526084015b60405180910390fd5b61060b8787878787878761104b565b50505050505050565b61061c611228565b6106266000611282565b565b60655433906001600160a01b031681146106965760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084016105f3565b61069f81611282565b50565b6106ae84848484610eb3565b50505050565b6106bc611228565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b61070b611228565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b031461078e5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016105f3565b600054610100900460ff16158080156107ae5750600054600160ff909116105b806107c85750303b1580156107c8575060005460ff166001145b6107e45760405162461bcd60e51b81526004016105f390611e9b565b6000805460ff191660011790558015610807576000805461ff0019166101001790555b6108138888888861129b565b60c9805461ffff191685151561ff001916176101008515150217905561083882611282565b801561087e576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146108fc5760405162461bcd60e51b815260206004820152603160248201527f526f6f744d696e7461626c65455243313135355072656469636174653a204f4e604482015270262cafa9aa20aa22afa922a1a2a4ab22a960791b60648201526084016105f3565b60fe546001600160a01b038481169116146109745760405162461bcd60e51b815260206004820152603260248201527f526f6f744d696e7461626c65455243313135355072656469636174653a204f4e6044820152714c595f4348494c445f50524544494341544560701b60648201526084016105f3565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e9828696109a3602060008486611ee9565b6109ac91611f13565b036109cb576109c66109c18260208186611ee9565b611398565b6106ae565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed26109fa602060008486611ee9565b610a0391611f13565b03610a12576109c682826114a6565b60405162461bcd60e51b815260206004820152602f602482015260008051602061242b83398151915260448201526e56414c49445f5349474e415455524560881b60648201526084016105f3565b610a68611228565b606580546001600160a01b0383166001600160a01b03199091168117909155610a996033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60006001600160a01b038216610b2b5760405162461bcd60e51b815260206004820152602b602482015260008051602061242b83398151915260448201526a2b20a624a22faa27a5a2a760a91b60648201526084016105f3565b6001600160a01b03828116600090815261010060205260409020541615610ba95760405162461bcd60e51b815260206004820152602c60248201527f526f6f744d696e7461626c65455243313135355072656469636174653a20414c60448201526b149150511657d3505414115160a21b60648201526084016105f3565b60fe5460ff546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b0392831692610c53921690603401604051602081830303815290604052805190602001208360405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b0384811660008181526101006020908152604080832080546001600160a01b031916958716959095179094558351908101845281815292516303a24d0760e21b815260048101919091529294509091630e89341c90602401600060405180830381865afa925050508015610cf057506040513d6000823e601f3d908101601f19168201604052610ced9190810190611f55565b60015b15610cf85790505b60fc546040516001600160a01b03909116906316f19831908490610d44907f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad9089908790602001611ff7565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610d70929190612021565b600060405180830381600087803b158015610d8a57600080fd5b505af1158015610d9e573d6000803e3d6000fd5b50506040516001600160a01b038087169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a35050919050565b600054610100900460ff1615808015610e015750600054600160ff909116105b80610e1b5750303b158015610e1b575060005460ff166001145b610e375760405162461bcd60e51b81526004016105f390611e9b565b6000805460ff191660011790558015610e5a576000805461ff0019166101001790555b610e668585858561129b565b8015610eac576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b610ebb611608565b6000610ec685611610565b604051637921219560e11b81529091506001600160a01b0386169063f242432a90610efb90339030908890889060040161204d565b600060405180830381600087803b158015610f1557600080fd5b505af1158015610f29573d6000803e3d6000fd5b505060fc5460fe54604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038b8116828401523360608301528a8116608083015260a082018a905260c08083018a90528351808403909101815260e08301938490526316f1983160e01b90935293841695506316f198319450610fc0939092169160e401612021565b600060405180830381600087803b158015610fda57600080fd5b505af1158015610fee573d6000803e3d6000fd5b505060408051338152602081018790529081018590526001600160a01b03808816935084811692508816907fe6f1fb6bb1930a5d4b997d56e0a4a8cb6f3f941f0d5391f63c1f6914ee01e0b89060600160405180910390a4610eac565b611053611608565b600061105e88611610565b905060005b8481101561110a57886001600160a01b031663f242432a333089898681811061108e5761108e612085565b905060200201358888878181106110a7576110a7612085565b905060200201356040518563ffffffff1660e01b81526004016110cd949392919061204d565b600060405180830381600087803b1580156110e757600080fd5b505af11580156110fb573d6000803e3d6000fd5b50505050806001019050611063565b5060fc5460fe546040516001600160a01b03928316926316f19831921690611166907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908d9033908e908e908e908e908e908e90602001612116565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401611192929190612021565b600060405180830381600087803b1580156111ac57600080fd5b505af11580156111c0573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316896001600160a01b03167fa7d9cd27143f817fe006011faf3c04351f70f75cd30e7b21405817f2f670041e8a8a8a8a8a8a60405161121b96959493929190612181565b60405180910390a461087e565b6033546001600160a01b031633146106265760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016105f3565b606580546001600160a01b031916905561069f81611658565b6001600160a01b038416158015906112bb57506001600160a01b03831615155b80156112cf57506001600160a01b03821615155b80156112e357506001600160a01b03811615155b6113485760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c65455243313135355072656469636174653a20424160448201526f222fa4a724aa24a0a624ad20aa24a7a760811b60648201526084016105f3565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b6000808080806113aa868801886121ca565b6001600160a01b0380861660009081526101006020526040902054959a509398509196509450925016806113e0576113e0612225565b604051637921219560e11b81526001600160a01b0387169063f242432a9061141290309088908890889060040161204d565b600060405180830381600087803b15801561142c57600080fd5b505af1158015611440573d6000803e3d6000fd5b5050604080516001600160a01b0389811682526020820188905291810186905281881693508482169250908916907f52cdfbe452878311d3237a4c20a951600d8e3a4fe6691d967d33788dc12d19c6906060015b60405180910390a45050505050505050565b6000808080806114b88688018861223b565b6001600160a01b0380861660009081526101006020526040902054959b5093995091975095509350169050806114f0576114f0612225565b60005b83518110156115b657866001600160a01b031663f242432a3087848151811061151e5761151e612085565b602002602001015187858151811061153857611538612085565b602002602001015187868151811061155257611552612085565b60200260200101516040518563ffffffff1660e01b8152600401611579949392919061204d565b600060405180830381600087803b15801561159357600080fd5b505af11580156115a7573d6000803e3d6000fd5b505050508060010190506114f3565b50846001600160a01b0316816001600160a01b0316876001600160a01b03167f52733a40a0466155541c2fc4044165dd37a3db116bc834bab2f020665e90fd2087878760405161149493929190612380565b6106266116aa565b6001600160a01b0380821660009081526101006020526040902054168061163d5761163a82610ad1565b90505b6001600160a01b03811661165357611653612225565b919050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60c95460ff16156117b557604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161170c91906123f5565b6000604051808303818686fa925050503d8060008114611748576040519150601f19603f3d011682016040523d82523d6000602084013e61174d565b606091505b509150915081801561177257506000818060200190518101906117709190612411565b115b6117b25760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b60448201526064016105f3565b50505b60c954610100900460ff161561062657604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b01916113889161181c91906123f5565b6000604051808303818686fa925050503d8060008114611858576040519150601f19603f3d011682016040523d82523d6000602084013e61185d565b606091505b509150915081801561188357508080602001905181019061187e9190612411565b600114155b6118c05760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b60448201526064016105f3565b5050565b6000602082840312156118d657600080fd5b81356001600160e01b0319811681146118ee57600080fd5b9392505050565b6001600160a01b038116811461069f57600080fd5b60008060006060848603121561191f57600080fd5b833561192a816118f5565b95602085013595506040909401359392505050565b60008083601f84011261195157600080fd5b5081356001600160401b0381111561196857600080fd5b6020830191508360208260051b850101111561198357600080fd5b9250929050565b60008060008060008060006080888a0312156119a557600080fd5b87356119b0816118f5565b965060208801356001600160401b03808211156119cc57600080fd5b6119d88b838c0161193f565b909850965060408a01359150808211156119f157600080fd5b6119fd8b838c0161193f565b909650945060608a0135915080821115611a1657600080fd5b50611a238a828b0161193f565b989b979a50959850939692959293505050565b600060208284031215611a4857600080fd5b81356118ee816118f5565b60008060008060808587031215611a6957600080fd5b8435611a74816118f5565b93506020850135611a84816118f5565b93969395505050506040820135916060013590565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611ad757611ad7611a99565b604052919050565b60006001600160401b03821115611af857611af8611a99565b5060051b60200190565b600082601f830112611b1357600080fd5b81356020611b28611b2383611adf565b611aaf565b82815260059290921b84018101918181019086841115611b4757600080fd5b8286015b84811015611b625780358352918301918301611b4b565b509695505050505050565b60006001600160401b03821115611b8657611b86611a99565b50601f01601f191660200190565b600082601f830112611ba557600080fd5b8135611bb3611b2382611b6d565b818152846020838601011115611bc857600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a08688031215611bfd57600080fd5b8535611c08816118f5565b94506020860135611c18816118f5565b935060408601356001600160401b0380821115611c3457600080fd5b611c4089838a01611b02565b94506060880135915080821115611c5657600080fd5b611c6289838a01611b02565b93506080880135915080821115611c7857600080fd5b50611c8588828901611b94565b9150509295509295909350565b8035801515811461165357600080fd5b600060208284031215611cb457600080fd5b6118ee82611c92565b600080600080600080600060e0888a031215611cd857600080fd5b8735611ce3816118f5565b96506020880135611cf3816118f5565b95506040880135611d03816118f5565b94506060880135611d13816118f5565b9350611d2160808901611c92565b9250611d2f60a08901611c92565b915060c0880135611d3f816118f5565b8091505092959891949750929550565b60008060008060608587031215611d6557600080fd5b843593506020850135611d77816118f5565b925060408501356001600160401b0380821115611d9357600080fd5b818701915087601f830112611da757600080fd5b813581811115611db657600080fd5b886020828501011115611dc857600080fd5b95989497505060200194505050565b600080600080600060a08688031215611def57600080fd5b8535611dfa816118f5565b94506020860135611e0a816118f5565b9350604086013592506060860135915060808601356001600160401b03811115611e3357600080fd5b611c8588828901611b94565b60008060008060808587031215611e5557600080fd5b8435611e60816118f5565b93506020850135611e70816118f5565b92506040850135611e80816118f5565b91506060850135611e90816118f5565b939692955090935050565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b60008085851115611ef957600080fd5b83861115611f0657600080fd5b5050820193919092039150565b8035602083101561058357600019602084900360031b1b1692915050565b60005b83811015611f4c578181015183820152602001611f34565b50506000910152565b600060208284031215611f6757600080fd5b81516001600160401b03811115611f7d57600080fd5b8201601f81018413611f8e57600080fd5b8051611f9c611b2382611b6d565b818152856020838501011115611fb157600080fd5b611fc2826020830160208601611f31565b95945050505050565b60008151808452611fe3816020860160208601611f31565b601f01601f19169290920160200192915050565b8381526001600160a01b0383166020820152606060408201819052600090611fc290830184611fcb565b6001600160a01b038316815260406020820181905260009061204590830184611fcb565b949350505050565b6001600160a01b0394851681529290931660208301526040820152606081019190915260a06080820181905260009082015260c00190565b634e487b7160e01b600052603260045260246000fd5b8183526000602080850194508260005b858110156120d95781356120be816118f5565b6001600160a01b0316875295820195908201906001016120ab565b509495945050505050565b81835260006001600160fb1b038311156120fd57600080fd5b8260051b80836020870137939093016020019392505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090612149908301888a61209b565b828103608084015261215c8187896120e4565b905082810360a08401526121718185876120e4565b9c9b505050505050505050505050565b60608152600061219560608301888a61209b565b82810360208401526121a88187896120e4565b905082810360408401526121bd8185876120e4565b9998505050505050505050565b600080600080600060a086880312156121e257600080fd5b85356121ed816118f5565b945060208601356121fd816118f5565b9350604086013561220d816118f5565b94979396509394606081013594506080013592915050565b634e487b7160e01b600052600160045260246000fd5b60008060008060008060c0878903121561225457600080fd5b86359550602080880135612267816118f5565b95506040880135612277816118f5565b945060608801356001600160401b038082111561229357600080fd5b818a0191508a601f8301126122a757600080fd5b81356122b5611b2382611adf565b81815260059190911b8301840190848101908d8311156122d457600080fd5b938501935b828510156122fb5784356122ec816118f5565b825293850193908501906122d9565b9750505060808a013592508083111561231357600080fd5b61231f8b848c01611b02565b945060a08a013592508083111561233557600080fd5b505061234389828a01611b02565b9150509295509295509295565b600081518084526020808501945080840160005b838110156120d957815187529582019590820190600101612364565b606080825284519082018190526000906020906080840190828801845b828110156123c25781516001600160a01b03168452928401929084019060010161239d565b505050838103828501526123d68187612350565b91505082810360408401526123eb8185612350565b9695505050505050565b60008251612407818460208701611f31565b9190910192915050565b60006020828403121561242357600080fd5b505191905056fe526f6f744d696e7461626c65455243313135355072656469636174653a20494ea26469706673582212207cc4d2e1fa811483449e50a585f2819503c945760fb6c93dc493fe7ad5264ad364736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b506004361061021c5760003560e01c8063a78e111c11610125578063d8dd1773116100ad578063f23a6e611161007c578063f23a6e61146104d3578063f2fde38b146104f2578063f4a120f714610505578063f645125514610518578063f8c8765e1461053f57600080fd5b8063d8dd177314610493578063e0563ab1146104a6578063e30c3978146104af578063eeb49945146104c057600080fd5b8063c1225a20116100f4578063c1225a20146103f8578063c5ac2b1c1461040b578063c5e4683a14610432578063d41f177114610445578063d7c9e3ec1461046c57600080fd5b8063a78e111c14610373578063b176806514610386578063b68ad1e4146103ad578063bc197c81146103c057600080fd5b806355b01e4d116101a857806379ba50971161017757806379ba50971461031d5780637efab4f5146103255780638da5cb5b1461034f578063947287cf1461036057806397e5230d1461036957600080fd5b806355b01e4d146102dd5780635ea5df79146102eb578063654715e614610302578063715018a61461031557600080fd5b80631bc114ba116101ef5780631bc114ba14610297578063284017f5146102aa5780633b878c22146102b35780634c4c45de146102bc57806351351d53146102cf57600080fd5b806301ffc9a71461022157806305dc2e8f1461024957806307b3e252146102745780630efe6a8b14610282575b600080fd5b61023461022f3660046118c4565b610552565b60405190151581526020015b60405180910390f35b60fd5461025c906001600160a01b031681565b6040516001600160a01b039091168152602001610240565b61025c6004600360981b0181565b61029561029036600461190a565b610589565b005b60fc5461025c906001600160a01b031681565b61025c61202081565b61025c61101081565b6102956102ca36600461198a565b61059a565b61025c6002600160a01b0381565b61025c6004600160991b0181565b6102f461138881565b604051908152602001610240565b60fe5461025c906001600160a01b031681565b610295610614565b610295610628565b61025c610333366004611a36565b610100602052600090815260409020546001600160a01b031681565b6033546001600160a01b031661025c565b6102f461520881565b6102f4620249f081565b610295610381366004611a53565b6106a2565b6102f47f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60ff5461025c906001600160a01b031681565b6103df6103ce366004611be5565b63bc197c8160e01b95945050505050565b6040516001600160e01b03199091168152602001610240565b610295610406366004611ca2565b6106b4565b6102f47faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b610295610440366004611ca2565b610703565b6102f47f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102f47f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b6102956104a1366004611cbd565b61074a565b61025c61203081565b6065546001600160a01b031661025c565b6102956104ce366004611d4f565b610888565b6103df6104e1366004611dd7565b63f23a6e6160e01b95945050505050565b610295610500366004611a36565b610a60565b61025c610513366004611a36565b610ad1565b6102f47f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61029561054d366004611e3f565b610de1565b60006001600160e01b03198216630271189760e51b148061058357506301ffc9a760e01b6001600160e01b03198316145b92915050565b61059583338484610eb3565b505050565b84831480156105a857508481145b6105fc5760405162461bcd60e51b815260206004820152602c602482015260008051602061242b83398151915260448201526b0ac82989288be988a9c8ea8960a31b60648201526084015b60405180910390fd5b61060b8787878787878761104b565b50505050505050565b61061c611228565b6106266000611282565b565b60655433906001600160a01b031681146106965760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084016105f3565b61069f81611282565b50565b6106ae84848484610eb3565b50505050565b6106bc611228565b60c9805461ff0019166101008315159081029190911790915560405143907f61d574757cde41a357d030b39b2705796ccd699578037ab9a1cfd8117d82bf8690600090a350565b61070b611228565b60c9805460ff191682151590811790915560405143907fe0a0f0fa52db091cb71c202d80420311430ce1ae2e7794149877b6720ce8bf0b90600090a350565b336002600160a01b031461078e5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016105f3565b600054610100900460ff16158080156107ae5750600054600160ff909116105b806107c85750303b1580156107c8575060005460ff166001145b6107e45760405162461bcd60e51b81526004016105f390611e9b565b6000805460ff191660011790558015610807576000805461ff0019166101001790555b6108138888888861129b565b60c9805461ffff191685151561ff001916176101008515150217905561083882611282565b801561087e576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b60fd546001600160a01b031633146108fc5760405162461bcd60e51b815260206004820152603160248201527f526f6f744d696e7461626c65455243313135355072656469636174653a204f4e604482015270262cafa9aa20aa22afa922a1a2a4ab22a960791b60648201526084016105f3565b60fe546001600160a01b038481169116146109745760405162461bcd60e51b815260206004820152603260248201527f526f6f744d696e7461626c65455243313135355072656469636174653a204f4e6044820152714c595f4348494c445f50524544494341544560701b60648201526084016105f3565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e9828696109a3602060008486611ee9565b6109ac91611f13565b036109cb576109c66109c18260208186611ee9565b611398565b6106ae565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed26109fa602060008486611ee9565b610a0391611f13565b03610a12576109c682826114a6565b60405162461bcd60e51b815260206004820152602f602482015260008051602061242b83398151915260448201526e56414c49445f5349474e415455524560881b60648201526084016105f3565b610a68611228565b606580546001600160a01b0383166001600160a01b03199091168117909155610a996033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60006001600160a01b038216610b2b5760405162461bcd60e51b815260206004820152602b602482015260008051602061242b83398151915260448201526a2b20a624a22faa27a5a2a760a91b60648201526084016105f3565b6001600160a01b03828116600090815261010060205260409020541615610ba95760405162461bcd60e51b815260206004820152602c60248201527f526f6f744d696e7461626c65455243313135355072656469636174653a20414c60448201526b149150511657d3505414115160a21b60648201526084016105f3565b60fe5460ff546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b0392831692610c53921690603401604051602081830303815290604052805190602001208360405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b0384811660008181526101006020908152604080832080546001600160a01b031916958716959095179094558351908101845281815292516303a24d0760e21b815260048101919091529294509091630e89341c90602401600060405180830381865afa925050508015610cf057506040513d6000823e601f3d908101601f19168201604052610ced9190810190611f55565b60015b15610cf85790505b60fc546040516001600160a01b03909116906316f19831908490610d44907f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad9089908790602001611ff7565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610d70929190612021565b600060405180830381600087803b158015610d8a57600080fd5b505af1158015610d9e573d6000803e3d6000fd5b50506040516001600160a01b038087169350871691507fb96a191bae4e25ffdff7f4136994eb0dec75d263750a07c035202c348c9515f090600090a35050919050565b600054610100900460ff1615808015610e015750600054600160ff909116105b80610e1b5750303b158015610e1b575060005460ff166001145b610e375760405162461bcd60e51b81526004016105f390611e9b565b6000805460ff191660011790558015610e5a576000805461ff0019166101001790555b610e668585858561129b565b8015610eac576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b610ebb611608565b6000610ec685611610565b604051637921219560e11b81529091506001600160a01b0386169063f242432a90610efb90339030908890889060040161204d565b600060405180830381600087803b158015610f1557600080fd5b505af1158015610f29573d6000803e3d6000fd5b505060fc5460fe54604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038b8116828401523360608301528a8116608083015260a082018a905260c08083018a90528351808403909101815260e08301938490526316f1983160e01b90935293841695506316f198319450610fc0939092169160e401612021565b600060405180830381600087803b158015610fda57600080fd5b505af1158015610fee573d6000803e3d6000fd5b505060408051338152602081018790529081018590526001600160a01b03808816935084811692508816907fe6f1fb6bb1930a5d4b997d56e0a4a8cb6f3f941f0d5391f63c1f6914ee01e0b89060600160405180910390a4610eac565b611053611608565b600061105e88611610565b905060005b8481101561110a57886001600160a01b031663f242432a333089898681811061108e5761108e612085565b905060200201358888878181106110a7576110a7612085565b905060200201356040518563ffffffff1660e01b81526004016110cd949392919061204d565b600060405180830381600087803b1580156110e757600080fd5b505af11580156110fb573d6000803e3d6000fd5b50505050806001019050611063565b5060fc5460fe546040516001600160a01b03928316926316f19831921690611166907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908d9033908e908e908e908e908e908e90602001612116565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401611192929190612021565b600060405180830381600087803b1580156111ac57600080fd5b505af11580156111c0573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316896001600160a01b03167fa7d9cd27143f817fe006011faf3c04351f70f75cd30e7b21405817f2f670041e8a8a8a8a8a8a60405161121b96959493929190612181565b60405180910390a461087e565b6033546001600160a01b031633146106265760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016105f3565b606580546001600160a01b031916905561069f81611658565b6001600160a01b038416158015906112bb57506001600160a01b03831615155b80156112cf57506001600160a01b03821615155b80156112e357506001600160a01b03811615155b6113485760405162461bcd60e51b815260206004820152603060248201527f526f6f744d696e7461626c65455243313135355072656469636174653a20424160448201526f222fa4a724aa24a0a624ad20aa24a7a760811b60648201526084016105f3565b60fc80546001600160a01b039586166001600160a01b03199182161790915560fd80549486169482169490941790935560fe80549285169284169290921790915560ff8054919093169116179055565b6000808080806113aa868801886121ca565b6001600160a01b0380861660009081526101006020526040902054959a509398509196509450925016806113e0576113e0612225565b604051637921219560e11b81526001600160a01b0387169063f242432a9061141290309088908890889060040161204d565b600060405180830381600087803b15801561142c57600080fd5b505af1158015611440573d6000803e3d6000fd5b5050604080516001600160a01b0389811682526020820188905291810186905281881693508482169250908916907f52cdfbe452878311d3237a4c20a951600d8e3a4fe6691d967d33788dc12d19c6906060015b60405180910390a45050505050505050565b6000808080806114b88688018861223b565b6001600160a01b0380861660009081526101006020526040902054959b5093995091975095509350169050806114f0576114f0612225565b60005b83518110156115b657866001600160a01b031663f242432a3087848151811061151e5761151e612085565b602002602001015187858151811061153857611538612085565b602002602001015187868151811061155257611552612085565b60200260200101516040518563ffffffff1660e01b8152600401611579949392919061204d565b600060405180830381600087803b15801561159357600080fd5b505af11580156115a7573d6000803e3d6000fd5b505050508060010190506114f3565b50846001600160a01b0316816001600160a01b0316876001600160a01b03167f52733a40a0466155541c2fc4044165dd37a3db116bc834bab2f020665e90fd2087878760405161149493929190612380565b6106266116aa565b6001600160a01b0380821660009081526101006020526040902054168061163d5761163a82610ad1565b90505b6001600160a01b03811661165357611653612225565b919050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60c95460ff16156117b557604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600160991b01916113889161170c91906123f5565b6000604051808303818686fa925050503d8060008114611748576040519150601f19603f3d011682016040523d82523d6000602084013e61174d565b606091505b509150915081801561177257506000818060200190518101906117709190612411565b115b6117b25760405162461bcd60e51b81526020600482015260116024820152702224a9a0a62627aba2a22fa9a2a72222a960791b60448201526064016105f3565b50505b60c954610100900460ff161561062657604080513360248083019190915282518083039091018152604490910182526020810180516001600160e01b031663d78bca6960e01b179052905160009182916004600360981b01916113889161181c91906123f5565b6000604051808303818686fa925050503d8060008114611858576040519150601f19603f3d011682016040523d82523d6000602084013e61185d565b606091505b509150915081801561188357508080602001905181019061187e9190612411565b600114155b6118c05760405162461bcd60e51b815260206004820152600e60248201526d212627a1a5a2a22fa9a2a72222a960911b60448201526064016105f3565b5050565b6000602082840312156118d657600080fd5b81356001600160e01b0319811681146118ee57600080fd5b9392505050565b6001600160a01b038116811461069f57600080fd5b60008060006060848603121561191f57600080fd5b833561192a816118f5565b95602085013595506040909401359392505050565b60008083601f84011261195157600080fd5b5081356001600160401b0381111561196857600080fd5b6020830191508360208260051b850101111561198357600080fd5b9250929050565b60008060008060008060006080888a0312156119a557600080fd5b87356119b0816118f5565b965060208801356001600160401b03808211156119cc57600080fd5b6119d88b838c0161193f565b909850965060408a01359150808211156119f157600080fd5b6119fd8b838c0161193f565b909650945060608a0135915080821115611a1657600080fd5b50611a238a828b0161193f565b989b979a50959850939692959293505050565b600060208284031215611a4857600080fd5b81356118ee816118f5565b60008060008060808587031215611a6957600080fd5b8435611a74816118f5565b93506020850135611a84816118f5565b93969395505050506040820135916060013590565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611ad757611ad7611a99565b604052919050565b60006001600160401b03821115611af857611af8611a99565b5060051b60200190565b600082601f830112611b1357600080fd5b81356020611b28611b2383611adf565b611aaf565b82815260059290921b84018101918181019086841115611b4757600080fd5b8286015b84811015611b625780358352918301918301611b4b565b509695505050505050565b60006001600160401b03821115611b8657611b86611a99565b50601f01601f191660200190565b600082601f830112611ba557600080fd5b8135611bb3611b2382611b6d565b818152846020838601011115611bc857600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a08688031215611bfd57600080fd5b8535611c08816118f5565b94506020860135611c18816118f5565b935060408601356001600160401b0380821115611c3457600080fd5b611c4089838a01611b02565b94506060880135915080821115611c5657600080fd5b611c6289838a01611b02565b93506080880135915080821115611c7857600080fd5b50611c8588828901611b94565b9150509295509295909350565b8035801515811461165357600080fd5b600060208284031215611cb457600080fd5b6118ee82611c92565b600080600080600080600060e0888a031215611cd857600080fd5b8735611ce3816118f5565b96506020880135611cf3816118f5565b95506040880135611d03816118f5565b94506060880135611d13816118f5565b9350611d2160808901611c92565b9250611d2f60a08901611c92565b915060c0880135611d3f816118f5565b8091505092959891949750929550565b60008060008060608587031215611d6557600080fd5b843593506020850135611d77816118f5565b925060408501356001600160401b0380821115611d9357600080fd5b818701915087601f830112611da757600080fd5b813581811115611db657600080fd5b886020828501011115611dc857600080fd5b95989497505060200194505050565b600080600080600060a08688031215611def57600080fd5b8535611dfa816118f5565b94506020860135611e0a816118f5565b9350604086013592506060860135915060808601356001600160401b03811115611e3357600080fd5b611c8588828901611b94565b60008060008060808587031215611e5557600080fd5b8435611e60816118f5565b93506020850135611e70816118f5565b92506040850135611e80816118f5565b91506060850135611e90816118f5565b939692955090935050565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b60008085851115611ef957600080fd5b83861115611f0657600080fd5b5050820193919092039150565b8035602083101561058357600019602084900360031b1b1692915050565b60005b83811015611f4c578181015183820152602001611f34565b50506000910152565b600060208284031215611f6757600080fd5b81516001600160401b03811115611f7d57600080fd5b8201601f81018413611f8e57600080fd5b8051611f9c611b2382611b6d565b818152856020838501011115611fb157600080fd5b611fc2826020830160208601611f31565b95945050505050565b60008151808452611fe3816020860160208601611f31565b601f01601f19169290920160200192915050565b8381526001600160a01b0383166020820152606060408201819052600090611fc290830184611fcb565b6001600160a01b038316815260406020820181905260009061204590830184611fcb565b949350505050565b6001600160a01b0394851681529290931660208301526040820152606081019190915260a06080820181905260009082015260c00190565b634e487b7160e01b600052603260045260246000fd5b8183526000602080850194508260005b858110156120d95781356120be816118f5565b6001600160a01b0316875295820195908201906001016120ab565b509495945050505050565b81835260006001600160fb1b038311156120fd57600080fd5b8260051b80836020870137939093016020019392505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090612149908301888a61209b565b828103608084015261215c8187896120e4565b905082810360a08401526121718185876120e4565b9c9b505050505050505050505050565b60608152600061219560608301888a61209b565b82810360208401526121a88187896120e4565b905082810360408401526121bd8185876120e4565b9998505050505050505050565b600080600080600060a086880312156121e257600080fd5b85356121ed816118f5565b945060208601356121fd816118f5565b9350604086013561220d816118f5565b94979396509394606081013594506080013592915050565b634e487b7160e01b600052600160045260246000fd5b60008060008060008060c0878903121561225457600080fd5b86359550602080880135612267816118f5565b95506040880135612277816118f5565b945060608801356001600160401b038082111561229357600080fd5b818a0191508a601f8301126122a757600080fd5b81356122b5611b2382611adf565b81815260059190911b8301840190848101908d8311156122d457600080fd5b938501935b828510156122fb5784356122ec816118f5565b825293850193908501906122d9565b9750505060808a013592508083111561231357600080fd5b61231f8b848c01611b02565b945060a08a013592508083111561233557600080fd5b505061234389828a01611b02565b9150509295509295509295565b600081518084526020808501945080840160005b838110156120d957815187529582019590820190600101612364565b606080825284519082018190526000906020906080840190828801845b828110156123c25781516001600160a01b03168452928401929084019060010161239d565b505050838103828501526123d68187612350565b91505082810360408401526123eb8185612350565b9695505050505050565b60008251612407818460208701611f31565b9190910192915050565b60006020828403121561242357600080fd5b505191905056fe526f6f744d696e7461626c65455243313135355072656469636174653a20494ea26469706673582212207cc4d2e1fa811483449e50a585f2819503c945760fb6c93dc493fe7ad5264ad364736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var SystemArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"System","sourceName":"contracts/child/System.sol","abi":[{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b5061015a806100206000396000f3fe608060405234801561001057600080fd5b50600436106100935760003560e01c806355b01e4d1161006657806355b01e4d146100e35780635ea5df79146100f1578063947287cf1461010857806397e5230d14610111578063e0563ab11461011b57600080fd5b806307b3e25214610098578063284017f5146100c35780633b878c22146100cc57806351351d53146100d5575b600080fd5b6100a66004600360981b0181565b6040516001600160a01b0390911681526020015b60405180910390f35b6100a661202081565b6100a661101081565b6100a66002600160a01b0381565b6100a66004600160991b0181565b6100fa61138881565b6040519081526020016100ba565b6100fa61520881565b6100fa620249f081565b6100a66120308156fea2646970667358221220cdc81f82626224fb8a04246ca1d1898f8b03c160e9b2f63cd0bc4b5d0b55c3f964736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100935760003560e01c806355b01e4d1161006657806355b01e4d146100e35780635ea5df79146100f1578063947287cf1461010857806397e5230d14610111578063e0563ab11461011b57600080fd5b806307b3e25214610098578063284017f5146100c35780633b878c22146100cc57806351351d53146100d5575b600080fd5b6100a66004600360981b0181565b6040516001600160a01b0390911681526020015b60405180910390f35b6100a661202081565b6100a661101081565b6100a66002600160a01b0381565b6100a66004600160991b0181565b6100fa61138881565b6040519081526020016100ba565b6100fa61520881565b6100fa620249f081565b6100a66120308156fea2646970667358221220cdc81f82626224fb8a04246ca1d1898f8b03c160e9b2f63cd0bc4b5d0b55c3f964736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var BLSArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"BLS","sourceName":"contracts/common/BLS.sol","abi":[{"inputs":[{"internalType":"bytes32","name":"domain","type":"bytes32"},{"internalType":"bytes","name":"message","type":"bytes"}],"name":"expandMsgTo96","outputs":[{"internalType":"bytes","name":"","type":"bytes"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"bytes32","name":"domain","type":"bytes32"},{"internalType":"bytes","name":"messages","type":"bytes"}],"name":"hashToField","outputs":[{"internalType":"uint256[2]","name":"","type":"uint256[2]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"domain","type":"bytes32"},{"internalType":"bytes","name":"message","type":"bytes"}],"name":"hashToPoint","outputs":[{"internalType":"uint256[2]","name":"","type":"uint256[2]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[2]","name":"point","type":"uint256[2]"}],"name":"isOnCurveG1","outputs":[{"internalType":"bool","name":"_isOnCurve","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"uint256[4]","name":"point","type":"uint256[4]"}],"name":"isOnCurveG2","outputs":[{"internalType":"bool","name":"_isOnCurve","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"uint256[2]","name":"signature","type":"uint256[2]"}],"name":"isValidSignature","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_x","type":"uint256"}],"name":"mapToPoint","outputs":[{"internalType":"uint256[2]","name":"p","type":"uint256[2]"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"uint256[2]","name":"signature","type":"uint256[2]"},{"internalType":"uint256[4][]","name":"pubkeys","type":"uint256[4][]"},{"internalType":"uint256[2][]","name":"messages","type":"uint256[2][]"}],"name":"verifyMultiple","outputs":[{"internalType":"bool","name":"checkResult","type":"bool"},{"internalType":"bool","name":"callSuccess","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[2]","name":"signature","type":"uint256[2]"},{"internalType":"uint256[4][]","name":"pubkeys","type":"uint256[4][]"},{"internalType":"uint256[2]","name":"message","type":"uint256[2]"}],"name":"verifyMultipleSameMsg","outputs":[{"internalType":"bool","name":"checkResult","type":"bool"},{"internalType":"bool","name":"callSuccess","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[2]","name":"signature","type":"uint256[2]"},{"internalType":"uint256[4]","name":"pubkey","type":"uint256[4]"},{"internalType":"uint256[2]","name":"message","type":"uint256[2]"}],"name":"verifySingle","outputs":[{"internalType":"bool","name":"","type":"bool"},{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50612df8806100206000396000f3fe608060405234801561001057600080fd5b506004361061009e5760003560e01c806391ec2d2b1161006657806391ec2d2b1461013b578063a850a9091461015b578063d58e77331461016e578063e242cce914610181578063ebbdac911461019457600080fd5b8063115000fe146100a3578063247dd9fb146100cb5780633e5476ce146100de5780638669026f146101085780639141376314610128575b600080fd5b6100b66100b1366004612708565b6101a7565b60405190151581526020015b60405180910390f35b6100b66100d9366004612785565b61030e565b6100f16100ec366004612841565b6103b8565b6040805192151583529015156020830152016100c2565b61011b6101163660046128ce565b61079f565b6040516100c29190612957565b6100f1610136366004612988565b6108bb565b61014e6101493660046128ce565b610d5c565b6040516100c29190612a86565b61011b6101693660046128ce565b610ff8565b61011b61017c366004612aa0565b6111d4565b6100b661018f366004612785565b6115aa565b6100f16101a2366004612ab9565b611609565b600081516020830151600080516020612d63833981519152828309600080516020612d638339815191528283098182830101600080516020612d638339815191528283840108600080516020612d638339815191528682600080516020612d6383398151915203860109935050600080516020612d638339815191528483600080516020612d63833981519152038301099150600080516020612d638339815191527f2b149d40ceb8aaae81be18991be06ac3b5b4c5e559dbefa33267e6dc24a138e584089450600080516020612d638339815191527e9713b03af0fed4cd2cafadeed8fdf4a74fa084e52d1852e4a2bd0685c315d2830893506040870151925060608701519150600080516020612d638339815191528083600080516020612d63833981519152038508600080516020612d63833981519152848608099050600080516020612d63833981519152828460011b0994149290931491909116949350505050565b8051600090600080516020612d6383398151915211158061034157506020820151600080516020612d6383398151915211155b1561034e57506000919050565b60405163e242cce960e01b8152309063e242cce990610371908590600401612957565b602060405180830381865afa15801561038e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103b29190612b1c565b92915050565b60008083806103e25760405162461bcd60e51b81526004016103d990612b3e565b60405180910390fd5b60006103ef826001612b95565b6103fa906006612ba8565b90506000816001600160401b038111156104165761041661269a565b60405190808252806020026020018201604052801561043f578160200160208202803683370190505b50905088600060200201358160008151811061045d5761045d612b06565b602090810291909101015288600160200201358160018151811061048357610483612b06565b602002602001018181525050600080516020612d43833981519152816002815181106104b1576104b1612b06565b602002602001018181525050600080516020612d23833981519152816003815181106104df576104df612b06565b602002602001018181525050600080516020612d838339815191528160048151811061050d5761050d612b06565b602002602001018181525050600080516020612da38339815191528160058151811061053b5761053b612b06565b60200260200101818152505060005b8381101561075a57863582610560836006612ba8565b61056b906006612b95565b8151811061057b5761057b612b06565b602090810291909101015286600160200201358261059a836006612ba8565b6105a5906007612b95565b815181106105b5576105b5612b06565b6020026020010181815250508888828181106105d3576105d3612b06565b9050608002016001600481106105eb576105eb612b06565b6020020135826105fc836006612ba8565b610607906008612b95565b8151811061061757610617612b06565b60200260200101818152505088888281811061063557610635612b06565b90506080020160006004811061064d5761064d612b06565b60200201358261065e836006612ba8565b610669906009612b95565b8151811061067957610679612b06565b60200260200101818152505088888281811061069757610697612b06565b9050608002016003600481106106af576106af612b06565b6020020135826106c0836006612ba8565b6106cb90600a612b95565b815181106106db576106db612b06565b6020026020010181815250508888828181106106f9576106f9612b06565b90506080020160026004811061071157610711612b06565b602002013582610722836006612ba8565b61072d90600b612b95565b8151811061073d5761073d612b06565b60209081029190910101528061075281612bbf565b91505061054a565b50610763612640565b602081602085026020850160085afa945084610789576000809550955050505050610796565b5115159450600193505050505b94509492505050565b6107a761265e565b6040516391ec2d2b60e01b815260009030906391ec2d2b906107cf9087908790600401612bd8565b600060405180830381865afa1580156107ec573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526108149190810190612bf9565b9050600080600080601885016001600160c01b0381511693506030860190506001600160c01b038151169450600080516020612d6383398151915285600080516020612d63833981519152600160c01b870908604887015160608801516001600160c01b0390811697501694509250600080516020612d6383398151915290508481600160c01b860908604080518082019091529283526020830152509695505050505050565b60008084806108dc5760405162461bcd60e51b81526004016103d990612b3e565b8084146109495760405162461bcd60e51b815260206004820152603560248201527f424c533a206e756d626572206f66207075626c6963206b65797320616e64206d604482015274195cdcd859d95cc81b5d5cdd08189948195c5d585b605a1b60648201526084016103d9565b6000610956826001612b95565b610961906006612ba8565b90506000816001600160401b0381111561097d5761097d61269a565b6040519080825280602002602001820160405280156109a6578160200160208202803683370190505b5090508960006020020135816000815181106109c4576109c4612b06565b60209081029190910101528960016020020135816001815181106109ea576109ea612b06565b602002602001018181525050600080516020612d4383398151915281600281518110610a1857610a18612b06565b602002602001018181525050600080516020612d2383398151915281600381518110610a4657610a46612b06565b602002602001018181525050600080516020612d8383398151915281600481518110610a7457610a74612b06565b602002602001018181525050600080516020612da383398151915281600581518110610aa257610aa2612b06565b60200260200101818152505060005b83811015610d1657878782818110610acb57610acb612b06565b905060400201600060028110610ae357610ae3612b06565b602002013582610af4836006612ba8565b610aff906006612b95565b81518110610b0f57610b0f612b06565b602002602001018181525050878782818110610b2d57610b2d612b06565b905060400201600160028110610b4557610b45612b06565b602002013582610b56836006612ba8565b610b61906007612b95565b81518110610b7157610b71612b06565b602002602001018181525050898982818110610b8f57610b8f612b06565b905060800201600160048110610ba757610ba7612b06565b602002013582610bb8836006612ba8565b610bc3906008612b95565b81518110610bd357610bd3612b06565b602002602001018181525050898982818110610bf157610bf1612b06565b905060800201600060048110610c0957610c09612b06565b602002013582610c1a836006612ba8565b610c25906009612b95565b81518110610c3557610c35612b06565b602002602001018181525050898982818110610c5357610c53612b06565b905060800201600360048110610c6b57610c6b612b06565b602002013582610c7c836006612ba8565b610c8790600a612b95565b81518110610c9757610c97612b06565b602002602001018181525050898982818110610cb557610cb5612b06565b905060800201600260048110610ccd57610ccd612b06565b602002013582610cde836006612ba8565b610ce990600b612b95565b81518110610cf957610cf9612b06565b602090810291909101015280610d0e81612bbf565b915050610ab1565b50610d1f612640565b602081602085026020850160085afa945084610d45576000809550955050505050610d52565b5115159450600193505050505b9550959350505050565b80516060906000610d6e826020612b95565b610d79906040612b95565b610d84906004612b95565b6001600160401b03811115610d9b57610d9b61269a565b6040519080825280601f01601f191660200182016040528015610dc5576020820181803683370190505b5060408051606080825260808201909252919250600091906020820181803683370190505090506060820160005b84811015610e0d5760208188018101518383015201610df3565b5083016000815360010160608153600101600081536001810187905260210160208153506000600283604051610e439190612c6f565b602060405180830381855afa158015610e60573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610e839190612c8b565b9050600060429450848452816020850152600160408501536041840188905260206061850153600284604051610eb99190612c6f565b602060405180830381855afa158015610ed6573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610ef99190612c8b565b905080602084015280821880602086015250600260408501536041840188905260206061850153600284604051610f309190612c6f565b602060405180830381855afa158015610f4d573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610f709190612c8b565b905080604084015280821880602086015250600360408501536041840188905260206061850153600284604051610fa79190612c6f565b602060405180830381855afa158015610fc4573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610fe79190612c8b565b606084015250909695505050505050565b61100061265e565b604051638669026f60e01b81526000903090638669026f906110289087908790600401612bd8565b6040805180830381865afa158015611044573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110689190612ca4565b805160405163d58e773360e01b81526004810191909152909150600090309063d58e7733906024016040805180830381865afa1580156110ac573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110d09190612ca4565b602083015160405163d58e773360e01b81526004810191909152909150600090309063d58e7733906024016040805180830381865afa158015611117573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061113b9190612ca4565b905061114561267c565b825181526020808401518282015282516040808401919091529083015160608301526000908460808460066107d05a03fa9050808061118057fe5b50806111c85760405162461bcd60e51b8152602060048201526017602482015276109314ce88189b881859190818d85b1b0819985a5b1959604a1b60448201526064016103d9565b50919695505050505050565b6111dc61265e565b600080516020612d6383398151915282106112455760405162461bcd60e51b815260206004820152602360248201527f6d6170546f506f696e7446543a20696e76616c6964206669656c6420656c656d604482015262195b9d60ea1b60648201526084016103d9565b81600061125182611790565b9150506000600080516020612d638339815191528061127257611272612cf9565b8384099050600080516020612d638339815191526004820890506000600080516020612d6383398151915277b3c4d79d41a91759a9e4c7e359b6b89eaec68e62effffffd850990506000600080516020612d6383398151915283830990506112d9816117b9565b9050600080516020612d638339815191528283099150600080516020612d638339815191528183099150600080516020612d638339815191528286099150600080516020612d6383398151915261133e83600080516020612d63833981519152612d0f565b7759e26bcea0d48bacd4f263f1acdb5c4f5763473177fffffe089450600080516020612d638339815191528586099150600080516020612d638339815191528583099150600080516020612d6383398151915260038308915060006113a283611790565b909350905080156113ea57846113cd576113ca83600080516020612d63833981519152612d0f565b92505b505060408051808201909152938452602084015250909392505050565b600080516020612d638339815191526001870861141590600080516020612d63833981519152612d0f565b9550600080516020612d638339815191528687099250600080516020612d638339815191528684099250600080516020612d6383398151915260038408925061145d83611790565b9093509050801561148557846113cd576113ca83600080516020612d63833981519152612d0f565b600080516020612d638339815191528485099550600080516020612d638339815191528687099550600080516020612d638339815191528287099550600080516020612d638339815191528287099550600080516020612d63833981519152600187089550600080516020612d638339815191528687099250600080516020612d638339815191528684099250600080516020612d6383398151915260038408925061153083611790565b90935090508061158d5760405162461bcd60e51b815260206004820152602260248201527f424c533a20626164206674206d617070696e6720696d706c656d656e7461746960448201526137b760f11b60648201526084016103d9565b846113cd576113ca83600080516020612d63833981519152612d0f565b600081516020830151600080516020612d63833981519152828309600080516020612d638339815191528382099050600080516020612d63833981519152600382089050600080516020612d6383398151915282830914949350505050565b60008060006040518061018001604052808760006002811061162d5761162d612b06565b602002013581526020018760016002811061164a5761164a612b06565b60200201358152602001600080516020612d438339815191528152602001600080516020612d238339815191528152602001600080516020612d838339815191528152602001600080516020612da38339815191528152602001856000600281106116b7576116b7612b06565b60200201358152602001856001600281106116d4576116d4612b06565b60200201358152602001866001600481106116f1576116f1612b06565b602002013581526020018660006004811061170e5761170e612b06565b602002013581526020018660036004811061172b5761172b612b06565b602002013581526020018660026004811061174857611748612b06565b602002013590529050611759612640565b60006020826101808560085afa90508061177c5760008094509450505050611788565b50511515925060019150505b935093915050565b60008061179c836117c4565b915082600080516020612d63833981519152838409149050915091565b60006103b282611ef9565b6000600080516020612d638339815191528083840991508083830981838209828283098385830984848309858484098684850997508684840987858409945087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087838a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985050868889099750868889099750868889099750868889099750868889099750868889099750868489099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868689099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868189099750508587880996508587880996508587880996508585880996508587880996508587880996508587880996508585880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508587880996508581880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508584880996508587880996508587880996508587880996508587880996508587880996508581880996505050505050808283099392505050565b6000600080516020612d638339815191528083840991508083830981838209828283098385830984848309858484098684850997508684840987858409945087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087838a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985050868889099750868889099750868889099750868889099750868889099750868889099750868489099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868689099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868189099750508587880996508587880996508587880996508585880996508587880996508587880996508587880996508585880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508587880996508581880996505050838586099450838586099450838586099450838586099450838186099450508284850993508284850993508284850993508281850993508284850993508284850993508285850993508284850993508284850993508284850993508284850993508284850993508284850993508281850995945050505050565b60405180602001604052806001906020820280368337509192915050565b60405180604001604052806002906020820280368337509192915050565b60405180608001604052806004906020820280368337509192915050565b634e487b7160e01b600052604160045260246000fd5b604080519081016001600160401b03811182821017156126d2576126d261269a565b60405290565b604051601f8201601f191681016001600160401b03811182821017156127005761270061269a565b604052919050565b60006080828403121561271a57600080fd5b82601f83011261272957600080fd5b604051608081018181106001600160401b038211171561274b5761274b61269a565b60405280608084018581111561276057600080fd5b845b8181101561277a578035835260209283019201612762565b509195945050505050565b60006040828403121561279757600080fd5b82601f8301126127a657600080fd5b6127ae6126b0565b8060408401858111156127c057600080fd5b845b818110156127da5780358452602093840193016127c2565b509095945050505050565b80604081018310156103b257600080fd5b60008083601f84011261280857600080fd5b5081356001600160401b0381111561281f57600080fd5b6020830191508360208260071b850101111561283a57600080fd5b9250929050565b60008060008060a0858703121561285757600080fd5b61286186866127e5565b935060408501356001600160401b0381111561287c57600080fd5b612888878288016127f6565b909450925061289c905086606087016127e5565b905092959194509250565b60006001600160401b038211156128c0576128c061269a565b50601f01601f191660200190565b600080604083850312156128e157600080fd5b8235915060208301356001600160401b038111156128fe57600080fd5b8301601f8101851361290f57600080fd5b803561292261291d826128a7565b6126d8565b81815286602083850101111561293757600080fd5b816020840160208301376000602083830101528093505050509250929050565b60408101818360005b600281101561297f578151835260209283019290910190600101612960565b50505092915050565b6000806000806000608086880312156129a057600080fd5b6129aa87876127e5565b945060408601356001600160401b03808211156129c657600080fd5b6129d289838a016127f6565b909650945060608801359150808211156129eb57600080fd5b818801915088601f8301126129ff57600080fd5b813581811115612a0e57600080fd5b8960208260061b8501011115612a2357600080fd5b9699959850939650602001949392505050565b60005b83811015612a51578181015183820152602001612a39565b50506000910152565b60008151808452612a72816020860160208601612a36565b601f01601f19169290920160200192915050565b602081526000612a996020830184612a5a565b9392505050565b600060208284031215612ab257600080fd5b5035919050565b60008060006101008486031215612acf57600080fd5b612ad985856127e5565b925060c0840185811115612aec57600080fd5b604085019250612afc86826127e5565b9150509250925092565b634e487b7160e01b600052603260045260246000fd5b600060208284031215612b2e57600080fd5b81518015158114612a9957600080fd5b60208082526021908201527f424c533a206e756d626572206f66207075626c6963206b6579206973207a65726040820152606f60f81b606082015260800190565b634e487b7160e01b600052601160045260246000fd5b808201808211156103b2576103b2612b7f565b80820281158282048414176103b2576103b2612b7f565b600060018201612bd157612bd1612b7f565b5060010190565b828152604060208201526000612bf16040830184612a5a565b949350505050565b600060208284031215612c0b57600080fd5b81516001600160401b03811115612c2157600080fd5b8201601f81018413612c3257600080fd5b8051612c4061291d826128a7565b818152856020838501011115612c5557600080fd5b612c66826020830160208601612a36565b95945050505050565b60008251612c81818460208701612a36565b9190910192915050565b600060208284031215612c9d57600080fd5b5051919050565b600060408284031215612cb657600080fd5b82601f830112612cc557600080fd5b612ccd6126b0565b806040840185811115612cdf57600080fd5b845b818110156127da578051845260209384019301612ce1565b634e487b7160e01b600052601260045260246000fd5b818103818111156103b2576103b2612b7f56fe1800deef121f1e76426a00665e5c4479674322d4f75edadd46debd5cd992f6ed198e9393920d483a7260bfb731fb5d25f1aa493335a9e71297e485b7aef312c230644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47275dc4a288d1afb3cbb1ac09187524c7db36395df7be3b99e673b13a075a65ec1d9befcd05a5323e6da4d435f3b617cdb3af83285c2df711ef39c01571827f9da26469706673582212204742dc9bfec89e0e4850b0f02ca1922cc3c73b8db4ec85457e11b7fd8d117c1264736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b506004361061009e5760003560e01c806391ec2d2b1161006657806391ec2d2b1461013b578063a850a9091461015b578063d58e77331461016e578063e242cce914610181578063ebbdac911461019457600080fd5b8063115000fe146100a3578063247dd9fb146100cb5780633e5476ce146100de5780638669026f146101085780639141376314610128575b600080fd5b6100b66100b1366004612708565b6101a7565b60405190151581526020015b60405180910390f35b6100b66100d9366004612785565b61030e565b6100f16100ec366004612841565b6103b8565b6040805192151583529015156020830152016100c2565b61011b6101163660046128ce565b61079f565b6040516100c29190612957565b6100f1610136366004612988565b6108bb565b61014e6101493660046128ce565b610d5c565b6040516100c29190612a86565b61011b6101693660046128ce565b610ff8565b61011b61017c366004612aa0565b6111d4565b6100b661018f366004612785565b6115aa565b6100f16101a2366004612ab9565b611609565b600081516020830151600080516020612d63833981519152828309600080516020612d638339815191528283098182830101600080516020612d638339815191528283840108600080516020612d638339815191528682600080516020612d6383398151915203860109935050600080516020612d638339815191528483600080516020612d63833981519152038301099150600080516020612d638339815191527f2b149d40ceb8aaae81be18991be06ac3b5b4c5e559dbefa33267e6dc24a138e584089450600080516020612d638339815191527e9713b03af0fed4cd2cafadeed8fdf4a74fa084e52d1852e4a2bd0685c315d2830893506040870151925060608701519150600080516020612d638339815191528083600080516020612d63833981519152038508600080516020612d63833981519152848608099050600080516020612d63833981519152828460011b0994149290931491909116949350505050565b8051600090600080516020612d6383398151915211158061034157506020820151600080516020612d6383398151915211155b1561034e57506000919050565b60405163e242cce960e01b8152309063e242cce990610371908590600401612957565b602060405180830381865afa15801561038e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103b29190612b1c565b92915050565b60008083806103e25760405162461bcd60e51b81526004016103d990612b3e565b60405180910390fd5b60006103ef826001612b95565b6103fa906006612ba8565b90506000816001600160401b038111156104165761041661269a565b60405190808252806020026020018201604052801561043f578160200160208202803683370190505b50905088600060200201358160008151811061045d5761045d612b06565b602090810291909101015288600160200201358160018151811061048357610483612b06565b602002602001018181525050600080516020612d43833981519152816002815181106104b1576104b1612b06565b602002602001018181525050600080516020612d23833981519152816003815181106104df576104df612b06565b602002602001018181525050600080516020612d838339815191528160048151811061050d5761050d612b06565b602002602001018181525050600080516020612da38339815191528160058151811061053b5761053b612b06565b60200260200101818152505060005b8381101561075a57863582610560836006612ba8565b61056b906006612b95565b8151811061057b5761057b612b06565b602090810291909101015286600160200201358261059a836006612ba8565b6105a5906007612b95565b815181106105b5576105b5612b06565b6020026020010181815250508888828181106105d3576105d3612b06565b9050608002016001600481106105eb576105eb612b06565b6020020135826105fc836006612ba8565b610607906008612b95565b8151811061061757610617612b06565b60200260200101818152505088888281811061063557610635612b06565b90506080020160006004811061064d5761064d612b06565b60200201358261065e836006612ba8565b610669906009612b95565b8151811061067957610679612b06565b60200260200101818152505088888281811061069757610697612b06565b9050608002016003600481106106af576106af612b06565b6020020135826106c0836006612ba8565b6106cb90600a612b95565b815181106106db576106db612b06565b6020026020010181815250508888828181106106f9576106f9612b06565b90506080020160026004811061071157610711612b06565b602002013582610722836006612ba8565b61072d90600b612b95565b8151811061073d5761073d612b06565b60209081029190910101528061075281612bbf565b91505061054a565b50610763612640565b602081602085026020850160085afa945084610789576000809550955050505050610796565b5115159450600193505050505b94509492505050565b6107a761265e565b6040516391ec2d2b60e01b815260009030906391ec2d2b906107cf9087908790600401612bd8565b600060405180830381865afa1580156107ec573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526108149190810190612bf9565b9050600080600080601885016001600160c01b0381511693506030860190506001600160c01b038151169450600080516020612d6383398151915285600080516020612d63833981519152600160c01b870908604887015160608801516001600160c01b0390811697501694509250600080516020612d6383398151915290508481600160c01b860908604080518082019091529283526020830152509695505050505050565b60008084806108dc5760405162461bcd60e51b81526004016103d990612b3e565b8084146109495760405162461bcd60e51b815260206004820152603560248201527f424c533a206e756d626572206f66207075626c6963206b65797320616e64206d604482015274195cdcd859d95cc81b5d5cdd08189948195c5d585b605a1b60648201526084016103d9565b6000610956826001612b95565b610961906006612ba8565b90506000816001600160401b0381111561097d5761097d61269a565b6040519080825280602002602001820160405280156109a6578160200160208202803683370190505b5090508960006020020135816000815181106109c4576109c4612b06565b60209081029190910101528960016020020135816001815181106109ea576109ea612b06565b602002602001018181525050600080516020612d4383398151915281600281518110610a1857610a18612b06565b602002602001018181525050600080516020612d2383398151915281600381518110610a4657610a46612b06565b602002602001018181525050600080516020612d8383398151915281600481518110610a7457610a74612b06565b602002602001018181525050600080516020612da383398151915281600581518110610aa257610aa2612b06565b60200260200101818152505060005b83811015610d1657878782818110610acb57610acb612b06565b905060400201600060028110610ae357610ae3612b06565b602002013582610af4836006612ba8565b610aff906006612b95565b81518110610b0f57610b0f612b06565b602002602001018181525050878782818110610b2d57610b2d612b06565b905060400201600160028110610b4557610b45612b06565b602002013582610b56836006612ba8565b610b61906007612b95565b81518110610b7157610b71612b06565b602002602001018181525050898982818110610b8f57610b8f612b06565b905060800201600160048110610ba757610ba7612b06565b602002013582610bb8836006612ba8565b610bc3906008612b95565b81518110610bd357610bd3612b06565b602002602001018181525050898982818110610bf157610bf1612b06565b905060800201600060048110610c0957610c09612b06565b602002013582610c1a836006612ba8565b610c25906009612b95565b81518110610c3557610c35612b06565b602002602001018181525050898982818110610c5357610c53612b06565b905060800201600360048110610c6b57610c6b612b06565b602002013582610c7c836006612ba8565b610c8790600a612b95565b81518110610c9757610c97612b06565b602002602001018181525050898982818110610cb557610cb5612b06565b905060800201600260048110610ccd57610ccd612b06565b602002013582610cde836006612ba8565b610ce990600b612b95565b81518110610cf957610cf9612b06565b602090810291909101015280610d0e81612bbf565b915050610ab1565b50610d1f612640565b602081602085026020850160085afa945084610d45576000809550955050505050610d52565b5115159450600193505050505b9550959350505050565b80516060906000610d6e826020612b95565b610d79906040612b95565b610d84906004612b95565b6001600160401b03811115610d9b57610d9b61269a565b6040519080825280601f01601f191660200182016040528015610dc5576020820181803683370190505b5060408051606080825260808201909252919250600091906020820181803683370190505090506060820160005b84811015610e0d5760208188018101518383015201610df3565b5083016000815360010160608153600101600081536001810187905260210160208153506000600283604051610e439190612c6f565b602060405180830381855afa158015610e60573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610e839190612c8b565b9050600060429450848452816020850152600160408501536041840188905260206061850153600284604051610eb99190612c6f565b602060405180830381855afa158015610ed6573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610ef99190612c8b565b905080602084015280821880602086015250600260408501536041840188905260206061850153600284604051610f309190612c6f565b602060405180830381855afa158015610f4d573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610f709190612c8b565b905080604084015280821880602086015250600360408501536041840188905260206061850153600284604051610fa79190612c6f565b602060405180830381855afa158015610fc4573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610fe79190612c8b565b606084015250909695505050505050565b61100061265e565b604051638669026f60e01b81526000903090638669026f906110289087908790600401612bd8565b6040805180830381865afa158015611044573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110689190612ca4565b805160405163d58e773360e01b81526004810191909152909150600090309063d58e7733906024016040805180830381865afa1580156110ac573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110d09190612ca4565b602083015160405163d58e773360e01b81526004810191909152909150600090309063d58e7733906024016040805180830381865afa158015611117573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061113b9190612ca4565b905061114561267c565b825181526020808401518282015282516040808401919091529083015160608301526000908460808460066107d05a03fa9050808061118057fe5b50806111c85760405162461bcd60e51b8152602060048201526017602482015276109314ce88189b881859190818d85b1b0819985a5b1959604a1b60448201526064016103d9565b50919695505050505050565b6111dc61265e565b600080516020612d6383398151915282106112455760405162461bcd60e51b815260206004820152602360248201527f6d6170546f506f696e7446543a20696e76616c6964206669656c6420656c656d604482015262195b9d60ea1b60648201526084016103d9565b81600061125182611790565b9150506000600080516020612d638339815191528061127257611272612cf9565b8384099050600080516020612d638339815191526004820890506000600080516020612d6383398151915277b3c4d79d41a91759a9e4c7e359b6b89eaec68e62effffffd850990506000600080516020612d6383398151915283830990506112d9816117b9565b9050600080516020612d638339815191528283099150600080516020612d638339815191528183099150600080516020612d638339815191528286099150600080516020612d6383398151915261133e83600080516020612d63833981519152612d0f565b7759e26bcea0d48bacd4f263f1acdb5c4f5763473177fffffe089450600080516020612d638339815191528586099150600080516020612d638339815191528583099150600080516020612d6383398151915260038308915060006113a283611790565b909350905080156113ea57846113cd576113ca83600080516020612d63833981519152612d0f565b92505b505060408051808201909152938452602084015250909392505050565b600080516020612d638339815191526001870861141590600080516020612d63833981519152612d0f565b9550600080516020612d638339815191528687099250600080516020612d638339815191528684099250600080516020612d6383398151915260038408925061145d83611790565b9093509050801561148557846113cd576113ca83600080516020612d63833981519152612d0f565b600080516020612d638339815191528485099550600080516020612d638339815191528687099550600080516020612d638339815191528287099550600080516020612d638339815191528287099550600080516020612d63833981519152600187089550600080516020612d638339815191528687099250600080516020612d638339815191528684099250600080516020612d6383398151915260038408925061153083611790565b90935090508061158d5760405162461bcd60e51b815260206004820152602260248201527f424c533a20626164206674206d617070696e6720696d706c656d656e7461746960448201526137b760f11b60648201526084016103d9565b846113cd576113ca83600080516020612d63833981519152612d0f565b600081516020830151600080516020612d63833981519152828309600080516020612d638339815191528382099050600080516020612d63833981519152600382089050600080516020612d6383398151915282830914949350505050565b60008060006040518061018001604052808760006002811061162d5761162d612b06565b602002013581526020018760016002811061164a5761164a612b06565b60200201358152602001600080516020612d438339815191528152602001600080516020612d238339815191528152602001600080516020612d838339815191528152602001600080516020612da38339815191528152602001856000600281106116b7576116b7612b06565b60200201358152602001856001600281106116d4576116d4612b06565b60200201358152602001866001600481106116f1576116f1612b06565b602002013581526020018660006004811061170e5761170e612b06565b602002013581526020018660036004811061172b5761172b612b06565b602002013581526020018660026004811061174857611748612b06565b602002013590529050611759612640565b60006020826101808560085afa90508061177c5760008094509450505050611788565b50511515925060019150505b935093915050565b60008061179c836117c4565b915082600080516020612d63833981519152838409149050915091565b60006103b282611ef9565b6000600080516020612d638339815191528083840991508083830981838209828283098385830984848309858484098684850997508684840987858409945087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087838a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985050868889099750868889099750868889099750868889099750868889099750868889099750868489099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868689099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868189099750508587880996508587880996508587880996508585880996508587880996508587880996508587880996508585880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508587880996508581880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508584880996508587880996508587880996508587880996508587880996508587880996508581880996505050505050808283099392505050565b6000600080516020612d638339815191528083840991508083830981838209828283098385830984848309858484098684850997508684840987858409945087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087838a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985050868889099750868889099750868889099750868889099750868889099750868889099750868489099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868689099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868189099750508587880996508587880996508587880996508585880996508587880996508587880996508587880996508585880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508587880996508581880996505050838586099450838586099450838586099450838586099450838186099450508284850993508284850993508284850993508281850993508284850993508284850993508285850993508284850993508284850993508284850993508284850993508284850993508284850993508281850995945050505050565b60405180602001604052806001906020820280368337509192915050565b60405180604001604052806002906020820280368337509192915050565b60405180608001604052806004906020820280368337509192915050565b634e487b7160e01b600052604160045260246000fd5b604080519081016001600160401b03811182821017156126d2576126d261269a565b60405290565b604051601f8201601f191681016001600160401b03811182821017156127005761270061269a565b604052919050565b60006080828403121561271a57600080fd5b82601f83011261272957600080fd5b604051608081018181106001600160401b038211171561274b5761274b61269a565b60405280608084018581111561276057600080fd5b845b8181101561277a578035835260209283019201612762565b509195945050505050565b60006040828403121561279757600080fd5b82601f8301126127a657600080fd5b6127ae6126b0565b8060408401858111156127c057600080fd5b845b818110156127da5780358452602093840193016127c2565b509095945050505050565b80604081018310156103b257600080fd5b60008083601f84011261280857600080fd5b5081356001600160401b0381111561281f57600080fd5b6020830191508360208260071b850101111561283a57600080fd5b9250929050565b60008060008060a0858703121561285757600080fd5b61286186866127e5565b935060408501356001600160401b0381111561287c57600080fd5b612888878288016127f6565b909450925061289c905086606087016127e5565b905092959194509250565b60006001600160401b038211156128c0576128c061269a565b50601f01601f191660200190565b600080604083850312156128e157600080fd5b8235915060208301356001600160401b038111156128fe57600080fd5b8301601f8101851361290f57600080fd5b803561292261291d826128a7565b6126d8565b81815286602083850101111561293757600080fd5b816020840160208301376000602083830101528093505050509250929050565b60408101818360005b600281101561297f578151835260209283019290910190600101612960565b50505092915050565b6000806000806000608086880312156129a057600080fd5b6129aa87876127e5565b945060408601356001600160401b03808211156129c657600080fd5b6129d289838a016127f6565b909650945060608801359150808211156129eb57600080fd5b818801915088601f8301126129ff57600080fd5b813581811115612a0e57600080fd5b8960208260061b8501011115612a2357600080fd5b9699959850939650602001949392505050565b60005b83811015612a51578181015183820152602001612a39565b50506000910152565b60008151808452612a72816020860160208601612a36565b601f01601f19169290920160200192915050565b602081526000612a996020830184612a5a565b9392505050565b600060208284031215612ab257600080fd5b5035919050565b60008060006101008486031215612acf57600080fd5b612ad985856127e5565b925060c0840185811115612aec57600080fd5b604085019250612afc86826127e5565b9150509250925092565b634e487b7160e01b600052603260045260246000fd5b600060208284031215612b2e57600080fd5b81518015158114612a9957600080fd5b60208082526021908201527f424c533a206e756d626572206f66207075626c6963206b6579206973207a65726040820152606f60f81b606082015260800190565b634e487b7160e01b600052601160045260246000fd5b808201808211156103b2576103b2612b7f565b80820281158282048414176103b2576103b2612b7f565b600060018201612bd157612bd1612b7f565b5060010190565b828152604060208201526000612bf16040830184612a5a565b949350505050565b600060208284031215612c0b57600080fd5b81516001600160401b03811115612c2157600080fd5b8201601f81018413612c3257600080fd5b8051612c4061291d826128a7565b818152856020838501011115612c5557600080fd5b612c66826020830160208601612a36565b95945050505050565b60008251612c81818460208701612a36565b9190910192915050565b600060208284031215612c9d57600080fd5b5051919050565b600060408284031215612cb657600080fd5b82601f830112612cc557600080fd5b612ccd6126b0565b806040840185811115612cdf57600080fd5b845b818110156127da578051845260209384019301612ce1565b634e487b7160e01b600052601260045260246000fd5b818103818111156103b2576103b2612b7f56fe1800deef121f1e76426a00665e5c4479674322d4f75edadd46debd5cd992f6ed198e9393920d483a7260bfb731fb5d25f1aa493335a9e71297e485b7aef312c230644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47275dc4a288d1afb3cbb1ac09187524c7db36395df7be3b99e673b13a075a65ec1d9befcd05a5323e6da4d435f3b617cdb3af83285c2df711ef39c01571827f9da26469706673582212204742dc9bfec89e0e4850b0f02ca1922cc3c73b8db4ec85457e11b7fd8d117c1264736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var BN256G2Artifact string = `{"_format":"hh-sol-artifact-1","contractName":"BN256G2","sourceName":"contracts/common/BN256G2.sol","abi":[{"inputs":[],"name":"G2_NEG_X_IM","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"G2_NEG_X_RE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"G2_NEG_Y_IM","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"G2_NEG_Y_RE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"pt1xx","type":"uint256"},{"internalType":"uint256","name":"pt1xy","type":"uint256"},{"internalType":"uint256","name":"pt1yx","type":"uint256"},{"internalType":"uint256","name":"pt1yy","type":"uint256"},{"internalType":"uint256","name":"pt2xx","type":"uint256"},{"internalType":"uint256","name":"pt2xy","type":"uint256"},{"internalType":"uint256","name":"pt2yx","type":"uint256"},{"internalType":"uint256","name":"pt2yy","type":"uint256"}],"name":"ecTwistAdd","outputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"s","type":"uint256"},{"internalType":"uint256","name":"pt1xx","type":"uint256"},{"internalType":"uint256","name":"pt1xy","type":"uint256"},{"internalType":"uint256","name":"pt1yx","type":"uint256"},{"internalType":"uint256","name":"pt1yy","type":"uint256"}],"name":"ecTwistMul","outputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getFieldModulus","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"pure","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50610dfd806100206000396000f3fe608060405234801561001057600080fd5b506004361061006d5760003560e01c80635120675214610072578063779d890d146100ac578063783bde80146100c05780639b0c399a146100e7578063ad50f9c11461010e578063cbe96a5014610135578063defbcdee14610168575b600080fd5b6100997f1d9befcd05a5323e6da4d435f3b617cdb3af83285c2df711ef39c01571827f9d81565b6040519081526020015b60405180910390f35b600080516020610da8833981519152610099565b6100997f198e9393920d483a7260bfb731fb5d25f1aa493335a9e71297e485b7aef312c281565b6100997f1800deef121f1e76426a00665e5c4479674322d4f75edadd46debd5cd992f6ed81565b6100997f275dc4a288d1afb3cbb1ac09187524c7db36395df7be3b99e673b13a075a65ec81565b610148610143366004610c8c565b61017b565b6040805194855260208501939093529183015260608201526080016100a3565b610148610176366004610ce1565b61031a565b60008080808b15801561018c57508a155b8015610196575089155b80156101a0575088155b1561020a57871580156101b1575086155b80156101bb575085155b80156101c5575084155b6101fa576101d5888888886103b1565b6101fa5760405162461bcd60e51b81526004016101f190610d1c565b60405180910390fd5b508692508591508490508361030b565b87158015610216575086155b8015610220575085155b801561022a575084155b156102675761023b8c8c8c8c6103b1565b6102575760405162461bcd60e51b81526004016101f190610d1c565b508a92508991508890508761030b565b6102738c8c8c8c6103b1565b61028f5760405162461bcd60e51b81526004016101f190610d1c565b61029b888888886103b1565b6102b75760405162461bcd60e51b81526004016101f190610d1c565b60006102d18d8d8d8d600160008f8f8f8f60016000610466565b90506103018160005b602090810291909101519083015160408401516060850151608086015160a08701516106f1565b9450945094509450505b98509850985098945050505050565b600080808060018815801561032d575087155b8015610337575086155b8015610341575085155b15610355575060019750879550600061037d565b610361898989896103b1565b61037d5760405162461bcd60e51b81526004016101f190610d1c565b600061038f8b8b8b8b8b87600061075c565b905061039c8160006102da565b929e919d509b50909950975050505050505050565b60008060008060006103c5878789896107df565b90945092506103d6898981816107df565b90925090506103e782828b8b6107df565b90925090506103f884848484610850565b909450925061044884847f2b149d40ceb8aaae81be18991be06ac3b5b4c5e559dbefa33267e6dc24a138e57e9713b03af0fed4cd2cafadeed8fdf4a74fa084e52d1852e4a2bd0685c315d2610850565b909450925083158015610459575082155b9998505050505050505050565b61046e610c50565b8815801561047a575087155b156104bc578686868686868660005b60a089019290925260808801929092526060870192909252604086019290925260208581019390935290910201526106e1565b821580156104c8575081155b156104db578c8c8c8c8c8c866000610489565b6104e785858b8b6107df565b90955093506104f88b8b85856107df565b6060830152604082015261050e87878b8b6107df565b909750955061051f8d8d85856107df565b60a0830152608082018190528714801561053c575060a081015186145b15610581576040810151851480156105575750606081015184145b156105725761056a8d8d8d8d8d8d610892565b866000610489565b60016000818180808681610489565b61058d898985856107df565b90935091506105ad858583600260200201518460035b6020020151610850565b909d509b506105c887878360045b60200201518460056105a3565b909b5099506105d98b8b81816107df565b90995097506105fa89898360045b60200201518460055b60200201516107df565b909550935061060b89898d8d6107df565b909950975061061c898985856107df565b60a083015260808201526106328d8d81816107df565b9097509550610643878785856107df565b909750955061065487878b8b610850565b909750955061066585856002610ada565b909350915061067687878585610850565b90975095506106878b8b89896107df565b6020830152815261069a85858989610850565b909b5099506106ab8d8d8d8d6107df565b909b5099506106c5898983600260200201518460036105f0565b909d509b506106d68b8b8f8f610850565b606083015260408201525b9c9b505050505050505050505050565b600080600080600080610702610c6e565b61070c8989610b0d565b909350915061071d8d8d85856107df565b602083015281526107308b8b85856107df565b60608301819052604083018290528251602090930151929f929e50909c509a5098505050505050505050565b610764610c50565b87156107d45760018816156107a5578051602082015160408301516060840151608085015160a08601516107a29594939291908d8d8d8d8d8d610466565b90505b6107b3878787878787610892565b949b509299509097509550935091506107cd600289610d5e565b9750610764565b979650505050505050565b60008061081d600080516020610da8833981519152858809600080516020610da8833981519152858809600080516020610da8833981519152610b98565b600080516020610da883398151915280868809600080516020610da8833981519152868a09089150915094509492505050565b60008061086c8685600080516020610da8833981519152610b98565b6108858685600080516020610da8833981519152610b98565b9150915094509492505050565b6000806000806000806108a3610c50565b6108af8d8d6003610ada565b602083018190528183526108c591908f8f6107df565b602083015281526108d88b8b8b8b6107df565b90995097506108e98d8d8d8d6107df565b606083015260408201819052610909908260035b60200201518b8b6107df565b60608301526040820152805161092c908260015b602002015183518460016105f0565b6040830151919e509c5061094a908260035b60200201516008610ada565b60a083015260808201526109618d8d8360046105bb565b909d509b50610972898981816107df565b60a083015260808201526040810151606082015161099291906004610ada565b60608301819052604083018290526109ac91908f8f610850565b6060830152604082018190526109c49082600361091d565b606083015260408201526109da8b8b6008610ada565b602083018190528183526109f091908d8d6107df565b60208301819052818352610a0791908360046105e7565b602083015280825260408201516060830151610a25928460016105a3565b60608301526040820152610a3b8d8d6002610ada565b6020830152808252610a4f908260016108fd565b60208301528152610a6389898360046105e7565b60a083015260808201819052610a7b9082600561093e565b826004602002018360056020020191909152528060006020020151816001602002015182600260200201518360036020020151846004602002015185600560200201519650965096509650965096505096509650965096509650969050565b600080600080516020610da8833981519152838609600080516020610da883398151915284860991509150935093915050565b60008080610b4e600080516020610da883398151915280878809600080516020610da883398151915287880908600080516020610da8833981519152610bbc565b9050600080516020610da8833981519152818609600080516020610da8833981519152828609610b8c90600080516020610da8833981519152610d80565b92509250509250929050565b60008180610ba857610ba8610d48565b610bb28484610d80565b8508949350505050565b60008060405160208152602080820152602060408201528460608201526002840360808201528360a082015260208160c08360056107d05a03fa90519250905080610c495760405162461bcd60e51b815260206004820152601a60248201527f6572726f722077697468206d6f64756c617220696e766572736500000000000060448201526064016101f1565b5092915050565b6040518060c001604052806006906020820280368337509192915050565b60405180608001604052806004906020820280368337509192915050565b600080600080600080600080610100898b031215610ca957600080fd5b505086359860208801359850604088013597606081013597506080810135965060a0810135955060c0810135945060e0013592509050565b600080600080600060a08688031215610cf957600080fd5b505083359560208501359550604085013594606081013594506080013592509050565b602080825260129082015271706f696e74206e6f7420696e20637572766560701b604082015260600190565b634e487b7160e01b600052601260045260246000fd5b600082610d7b57634e487b7160e01b600052601260045260246000fd5b500490565b81810381811115610da157634e487b7160e01b600052601160045260246000fd5b9291505056fe30644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47a2646970667358221220bbba255b0b3e97590748f6a15256dba836d9ad9b81608a97cbf4954595465a8664736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b506004361061006d5760003560e01c80635120675214610072578063779d890d146100ac578063783bde80146100c05780639b0c399a146100e7578063ad50f9c11461010e578063cbe96a5014610135578063defbcdee14610168575b600080fd5b6100997f1d9befcd05a5323e6da4d435f3b617cdb3af83285c2df711ef39c01571827f9d81565b6040519081526020015b60405180910390f35b600080516020610da8833981519152610099565b6100997f198e9393920d483a7260bfb731fb5d25f1aa493335a9e71297e485b7aef312c281565b6100997f1800deef121f1e76426a00665e5c4479674322d4f75edadd46debd5cd992f6ed81565b6100997f275dc4a288d1afb3cbb1ac09187524c7db36395df7be3b99e673b13a075a65ec81565b610148610143366004610c8c565b61017b565b6040805194855260208501939093529183015260608201526080016100a3565b610148610176366004610ce1565b61031a565b60008080808b15801561018c57508a155b8015610196575089155b80156101a0575088155b1561020a57871580156101b1575086155b80156101bb575085155b80156101c5575084155b6101fa576101d5888888886103b1565b6101fa5760405162461bcd60e51b81526004016101f190610d1c565b60405180910390fd5b508692508591508490508361030b565b87158015610216575086155b8015610220575085155b801561022a575084155b156102675761023b8c8c8c8c6103b1565b6102575760405162461bcd60e51b81526004016101f190610d1c565b508a92508991508890508761030b565b6102738c8c8c8c6103b1565b61028f5760405162461bcd60e51b81526004016101f190610d1c565b61029b888888886103b1565b6102b75760405162461bcd60e51b81526004016101f190610d1c565b60006102d18d8d8d8d600160008f8f8f8f60016000610466565b90506103018160005b602090810291909101519083015160408401516060850151608086015160a08701516106f1565b9450945094509450505b98509850985098945050505050565b600080808060018815801561032d575087155b8015610337575086155b8015610341575085155b15610355575060019750879550600061037d565b610361898989896103b1565b61037d5760405162461bcd60e51b81526004016101f190610d1c565b600061038f8b8b8b8b8b87600061075c565b905061039c8160006102da565b929e919d509b50909950975050505050505050565b60008060008060006103c5878789896107df565b90945092506103d6898981816107df565b90925090506103e782828b8b6107df565b90925090506103f884848484610850565b909450925061044884847f2b149d40ceb8aaae81be18991be06ac3b5b4c5e559dbefa33267e6dc24a138e57e9713b03af0fed4cd2cafadeed8fdf4a74fa084e52d1852e4a2bd0685c315d2610850565b909450925083158015610459575082155b9998505050505050505050565b61046e610c50565b8815801561047a575087155b156104bc578686868686868660005b60a089019290925260808801929092526060870192909252604086019290925260208581019390935290910201526106e1565b821580156104c8575081155b156104db578c8c8c8c8c8c866000610489565b6104e785858b8b6107df565b90955093506104f88b8b85856107df565b6060830152604082015261050e87878b8b6107df565b909750955061051f8d8d85856107df565b60a0830152608082018190528714801561053c575060a081015186145b15610581576040810151851480156105575750606081015184145b156105725761056a8d8d8d8d8d8d610892565b866000610489565b60016000818180808681610489565b61058d898985856107df565b90935091506105ad858583600260200201518460035b6020020151610850565b909d509b506105c887878360045b60200201518460056105a3565b909b5099506105d98b8b81816107df565b90995097506105fa89898360045b60200201518460055b60200201516107df565b909550935061060b89898d8d6107df565b909950975061061c898985856107df565b60a083015260808201526106328d8d81816107df565b9097509550610643878785856107df565b909750955061065487878b8b610850565b909750955061066585856002610ada565b909350915061067687878585610850565b90975095506106878b8b89896107df565b6020830152815261069a85858989610850565b909b5099506106ab8d8d8d8d6107df565b909b5099506106c5898983600260200201518460036105f0565b909d509b506106d68b8b8f8f610850565b606083015260408201525b9c9b505050505050505050505050565b600080600080600080610702610c6e565b61070c8989610b0d565b909350915061071d8d8d85856107df565b602083015281526107308b8b85856107df565b60608301819052604083018290528251602090930151929f929e50909c509a5098505050505050505050565b610764610c50565b87156107d45760018816156107a5578051602082015160408301516060840151608085015160a08601516107a29594939291908d8d8d8d8d8d610466565b90505b6107b3878787878787610892565b949b509299509097509550935091506107cd600289610d5e565b9750610764565b979650505050505050565b60008061081d600080516020610da8833981519152858809600080516020610da8833981519152858809600080516020610da8833981519152610b98565b600080516020610da883398151915280868809600080516020610da8833981519152868a09089150915094509492505050565b60008061086c8685600080516020610da8833981519152610b98565b6108858685600080516020610da8833981519152610b98565b9150915094509492505050565b6000806000806000806108a3610c50565b6108af8d8d6003610ada565b602083018190528183526108c591908f8f6107df565b602083015281526108d88b8b8b8b6107df565b90995097506108e98d8d8d8d6107df565b606083015260408201819052610909908260035b60200201518b8b6107df565b60608301526040820152805161092c908260015b602002015183518460016105f0565b6040830151919e509c5061094a908260035b60200201516008610ada565b60a083015260808201526109618d8d8360046105bb565b909d509b50610972898981816107df565b60a083015260808201526040810151606082015161099291906004610ada565b60608301819052604083018290526109ac91908f8f610850565b6060830152604082018190526109c49082600361091d565b606083015260408201526109da8b8b6008610ada565b602083018190528183526109f091908d8d6107df565b60208301819052818352610a0791908360046105e7565b602083015280825260408201516060830151610a25928460016105a3565b60608301526040820152610a3b8d8d6002610ada565b6020830152808252610a4f908260016108fd565b60208301528152610a6389898360046105e7565b60a083015260808201819052610a7b9082600561093e565b826004602002018360056020020191909152528060006020020151816001602002015182600260200201518360036020020151846004602002015185600560200201519650965096509650965096505096509650965096509650969050565b600080600080516020610da8833981519152838609600080516020610da883398151915284860991509150935093915050565b60008080610b4e600080516020610da883398151915280878809600080516020610da883398151915287880908600080516020610da8833981519152610bbc565b9050600080516020610da8833981519152818609600080516020610da8833981519152828609610b8c90600080516020610da8833981519152610d80565b92509250509250929050565b60008180610ba857610ba8610d48565b610bb28484610d80565b8508949350505050565b60008060405160208152602080820152602060408201528460608201526002840360808201528360a082015260208160c08360056107d05a03fa90519250905080610c495760405162461bcd60e51b815260206004820152601a60248201527f6572726f722077697468206d6f64756c617220696e766572736500000000000060448201526064016101f1565b5092915050565b6040518060c001604052806006906020820280368337509192915050565b60405180608001604052806004906020820280368337509192915050565b600080600080600080600080610100898b031215610ca957600080fd5b505086359860208801359850604088013597606081013597506080810135965060a0810135955060c0810135945060e0013592509050565b600080600080600060a08688031215610cf957600080fd5b505083359560208501359550604085013594606081013594506080013592509050565b602080825260129082015271706f696e74206e6f7420696e20637572766560701b604082015260600190565b634e487b7160e01b600052601260045260246000fd5b600082610d7b57634e487b7160e01b600052601260045260246000fd5b500490565b81810381811115610da157634e487b7160e01b600052601160045260246000fd5b9291505056fe30644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47a2646970667358221220bbba255b0b3e97590748f6a15256dba836d9ad9b81608a97cbf4954595465a8664736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var MerkleArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"Merkle","sourceName":"contracts/common/Merkle.sol","abi":[],"bytecode":"0x60566037600b82828239805160001a607314602a57634e487b7160e01b600052600060045260246000fd5b30600052607381538281f3fe73000000000000000000000000000000000000000030146080604052600080fdfea26469706673582212202db2509119c8628b728a484ebc6ba9b1e5898ea19639476f14228eb88863575864736f6c63430008130033","deployedBytecode":"0x73000000000000000000000000000000000000000030146080604052600080fdfea26469706673582212202db2509119c8628b728a484ebc6ba9b1e5898ea19639476f14228eb88863575864736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var CheckpointManagerArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"CheckpointManager","sourceName":"contracts/root/CheckpointManager.sol","abi":[{"inputs":[{"internalType":"address","name":"initiator","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"inputs":[],"name":"DOMAIN","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"bls","outputs":[{"internalType":"contract IBLS","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"bn256G2","outputs":[{"internalType":"contract IBN256G2","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"chainId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"checkpointBlockNumbers","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"checkpoints","outputs":[{"internalType":"uint256","name":"epoch","type":"uint256"},{"internalType":"uint256","name":"blockNumber","type":"uint256"},{"internalType":"bytes32","name":"eventRoot","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentCheckpointBlockNumber","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentEpoch","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"currentValidatorSet","outputs":[{"internalType":"address","name":"_address","type":"address"},{"internalType":"uint256","name":"votingPower","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentValidatorSetHash","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"currentValidatorSetLength","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"blockNumber","type":"uint256"}],"name":"getCheckpointBlock","outputs":[{"internalType":"bool","name":"","type":"bool"},{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"blockNumber","type":"uint256"},{"internalType":"bytes32","name":"leaf","type":"bytes32"},{"internalType":"uint256","name":"leafIndex","type":"uint256"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"name":"getEventMembershipByBlockNumber","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"epoch","type":"uint256"},{"internalType":"bytes32","name":"leaf","type":"bytes32"},{"internalType":"uint256","name":"leafIndex","type":"uint256"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"name":"getEventMembershipByEpoch","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"blockNumber","type":"uint256"}],"name":"getEventRootByBlock","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IBLS","name":"newBls","type":"address"},{"internalType":"contract IBN256G2","name":"newBn256G2","type":"address"},{"internalType":"uint256","name":"chainId_","type":"uint256"},{"components":[{"internalType":"address","name":"_address","type":"address"},{"internalType":"uint256[4]","name":"blsKey","type":"uint256[4]"},{"internalType":"uint256","name":"votingPower","type":"uint256"}],"internalType":"struct ICheckpointManager.Validator[]","name":"newValidatorSet","type":"tuple[]"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32","name":"blockHash","type":"bytes32"},{"internalType":"uint256","name":"blockRound","type":"uint256"},{"internalType":"bytes32","name":"currentValidatorSetHash","type":"bytes32"}],"internalType":"struct ICheckpointManager.CheckpointMetadata","name":"checkpointMetadata","type":"tuple"},{"components":[{"internalType":"uint256","name":"epoch","type":"uint256"},{"internalType":"uint256","name":"blockNumber","type":"uint256"},{"internalType":"bytes32","name":"eventRoot","type":"bytes32"}],"internalType":"struct ICheckpointManager.Checkpoint","name":"checkpoint","type":"tuple"},{"internalType":"uint256[2]","name":"signature","type":"uint256[2]"},{"components":[{"internalType":"address","name":"_address","type":"address"},{"internalType":"uint256[4]","name":"blsKey","type":"uint256[4]"},{"internalType":"uint256","name":"votingPower","type":"uint256"}],"internalType":"struct ICheckpointManager.Validator[]","name":"newValidatorSet","type":"tuple[]"},{"internalType":"bytes","name":"bitmap","type":"bytes"}],"name":"submit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"totalVotingPower","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"}],"bytecode":"0x60a060405234801561001057600080fd5b506040516115ed3803806115ed83398101604081905261002f91610040565b6001600160a01b0316608052610070565b60006020828403121561005257600080fd5b81516001600160a01b038116811461006957600080fd5b9392505050565b60805161155b6100926000396000818161052b0152610563015261155b6000f3fe608060405234801561001057600080fd5b50600436106101165760003560e01c806376671808116100a2578063babd4ee411610071578063babd4ee4146102c8578063d4c8e3e8146102db578063e416d677146102ee578063e9193d2b146102f7578063f896f1a51461030a57600080fd5b8063766718081461024157806395b0b0271461024a5780639a8a059214610275578063b8a242521461027e57600080fd5b806361a02208116100e957806361a022081461019b578063671b3793146101be5780636969a25c146101c7578063729e7c6e1461021957806373cb1a111461022c57600080fd5b80631d1d4f261461011b57806322fd1818146101375780633569ed931461016157806352a9674b14610174575b600080fd5b61012460035481565b6040519081526020015b60405180910390f35b61014a610145366004610f34565b610313565b60408051921515835260208301919091520161012e565b61012461016f366004610f34565b610364565b6101247fbee7fa562a38908559e4a988e62d6c08b84ef05f2ebd5d2bb2b855dc19d19fe281565b6101ae6101a9366004610f4d565b610398565b604051901515815260200161012e565b61012460055481565b6101fa6101d5366004610f34565b600960205260009081526040902080546005909101546001600160a01b039091169082565b604080516001600160a01b03909316835260208301919091520161012e565b6101ae610227366004610f4d565b610410565b61023f61023a366004611041565b610469565b005b61012460025481565b60065461025d906001600160a01b031681565b6040516001600160a01b03909116815260200161012e565b61012460015481565b6102ad61028c366004610f34565b60086020526000908152604090208054600182015460029092015490919083565b6040805193845260208401929092529082015260600161012e565b61023f6102d63660046110cc565b61061f565b60075461025d906001600160a01b031681565b61012460045481565b610124610305366004610f34565b610884565b610124600b5481565b60008080610322600a856108a5565b600a54909150810361033a5750600093849350915050565b6001600a828154811061034f5761034f6111a5565b90600052602060002001549250925050915091565b6000600881610374600a856108a5565b61037f9060016111d1565b8152602001908152602001600020600201549050919050565b6000806103a487610364565b9050806103f85760405162461bcd60e51b815260206004820152601e60248201527f4e4f5f4556454e545f524f4f545f464f525f424c4f434b5f4e554d424552000060448201526064015b60405180910390fd5b6104058686838787610954565b979650505050505050565b600085815260086020526040812060020154806103f85760405162461bcd60e51b815260206004820152601760248201527609c9ebe8aac8a9ca8bea49e9ea8be8c9ea4be8aa09e869604b1b60448201526064016103ef565b600054610100900460ff16158080156104895750600054600160ff909116105b806104a35750303b1580156104a3575060005460ff166001145b6105065760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103ef565b6000805460ff191660011790558015610529576000805461ff0019166101001790555b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03161561058d57336001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000161461058d57600080fd5b6001849055600680546001600160a01b038089166001600160a01b031992831617909255600780549288169290911691909117905560038290556105d1838361099e565b8015610617576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b8660400135600b54146106745760405162461bcd60e51b815260206004820152601a60248201527f494e56414c49445f56414c494441544f525f5345545f4841534800000000000060448201526064016103ef565b6000600154876020013589600001358a602001358a600001358b604001358d604001358b8b6040516020016106aa9291906111e4565b604051602081830303815290604052805190602001206040516020016106d7989796959493929190611247565b60408051601f198184030181528282528051602091820120908301520160408051601f198184030181529082905260065463a850a90960e01b83529092506107a3916001600160a01b039091169063a850a9099061075b907fbee7fa562a38908559e4a988e62d6c08b84ef05f2ebd5d2bb2b855dc19d19fe290869060040161127d565b6040805180830381865afa158015610777573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061079b91906112d3565b878585610aa4565b6002546107b08189610dae565b8735600081815260086020908152604091829020838155908b01356001820155908a013560029091015581101561083357600a8054600181018255600091825260208a01357fc65a7bb8d6351c1cf70c95a316cc6a92839c986682d98bc35f958f4883f9d2a8909101556002805490919061082a90611361565b90915550610867565b600a805460208a0135919061084a9060019061137a565b8154811061085a5761085a6111a5565b6000918252602090912001555b6020880135600455610879868661099e565b505050505050505050565b600a818154811061089457600080fd5b600091825260209091200154905081565b815460009081036108b85750600061094e565b82546000905b808210156109055760006108d28383610e8b565b600087815260209020909150859082015411156108f1578091506108ff565b6108fc8160016111d1565b92505b506108be565b60008211801561093157508361092e8661092060018661137a565b600091825260209091200190565b54145b1561094a5761094160018361137a565b9250505061094e565b5090505b92915050565b60008115610993578160051b8301835b8660011660051b8881528135602082185250604060002097508660011c96506020810190508181106109645750505b505050901591141690565b600381905560405181906109b890849083906020016111e4565b60408051601f198184030181529190528051602090910120600b556000805b82811015610a9b5760008585838181106109f3576109f36111a5565b905060c0020160a00135905060008111610a435760405162461bcd60e51b8152602060048201526011602482015270564f54494e475f504f5745525f5a45524f60781b60448201526064016103ef565b610a4d81846111d1565b9250858583818110610a6157610a616111a5565b905060c00201600960008481526020019081526020016000208181610a8691906113a4565b9050505080610a9490611361565b90506109d7565b50600555505050565b600354610aaf610f16565b6000805b83811015610c3357610ac6868683610ead565b15610c2b5781600003610b1a576000818152600960205260409081902081516080810190925260010160048282826020028201915b815481526020019060010190808311610afb5750505050509250610c0c565b60008181526009602052604080822081516080810190925260010160048282826020028201915b815481526020019060010190808311610b4157505060075488516020808b01516040808d01516060808f01518b51958c0151848d0151928d01519451630cbe96a560e41b81529c9d506001600160a01b039098169b63cbe96a509b50610bb89a509698509396919593949391929091600401611247565b608060405180830381865afa158015610bd5573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bf99190611403565b6060880152604087015260208601528452505b600081815260096020526040902060050154610c2890836111d1565b91505b600101610ab3565b5080600003610c765760405162461bcd60e51b815260206004820152600f60248201526e4249544d41505f49535f454d50545960881b60448201526064016103ef565b60036005546002610c87919061138d565b610c91919061144f565b8111610cdb5760405162461bcd60e51b815260206004820152601960248201527824a729aaa32324a1a4a2a72a2fab27aa24a723afa827aba2a960391b60448201526064016103ef565b60065460405163ebbdac9160e01b815260009182916001600160a01b039091169063ebbdac9190610d14908b9088908e90600401611463565b6040805180830381865afa158015610d30573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d5491906114de565b91509150818015610d625750805b6108795760405162461bcd60e51b815260206004820152601d60248201527f5349474e41545552455f564552494649434154494f4e5f4641494c454400000060448201526064016103ef565b600082815260086020908152604091829020825160608101845281548082526001830154938201939093526002909101549281019290925282351480610e0057508051610dfc9060016111d1565b8235145b610e3c5760405162461bcd60e51b815260206004820152600d60248201526c0929cac82989288be8aa09e869609b1b60448201526064016103ef565b8060200151826020013511610e865760405162461bcd60e51b815260206004820152601060248201526f115354151657d0d21150d2d413d2539560821b60448201526064016103ef565b505050565b6000610e9a600284841861144f565b610ea6908484166111d1565b9392505050565b600080610ebb60088461144f565b90506000610eca600885611511565b9050848210610ede57600092505050610ea6565b6000600160ff83161b878785818110610ef957610ef96111a5565b9050013560f81c60f81b60f81c60ff161611925050509392505050565b60405180608001604052806004906020820280368337509192915050565b600060208284031215610f4657600080fd5b5035919050565b600080600080600060808688031215610f6557600080fd5b853594506020860135935060408601359250606086013567ffffffffffffffff80821115610f9257600080fd5b818801915088601f830112610fa657600080fd5b813581811115610fb557600080fd5b8960208260051b8501011115610fca57600080fd5b9699959850939650602001949392505050565b6001600160a01b0381168114610ff257600080fd5b50565b60008083601f84011261100757600080fd5b50813567ffffffffffffffff81111561101f57600080fd5b60208301915083602060c08302850101111561103a57600080fd5b9250929050565b60008060008060006080868803121561105957600080fd5b853561106481610fdd565b9450602086013561107481610fdd565b935060408601359250606086013567ffffffffffffffff81111561109757600080fd5b6110a388828901610ff5565b969995985093965092949392505050565b6000606082840312156110c657600080fd5b50919050565b6000806000806000806000610140888a0312156110e857600080fd5b6110f289896110b4565b96506111018960608a016110b4565b955061010088018981111561111557600080fd5b60c0890195503567ffffffffffffffff8082111561113257600080fd5b61113e8b838c01610ff5565b90965094506101208a013591508082111561115857600080fd5b818a0191508a601f83011261116c57600080fd5b81358181111561117b57600080fd5b8b602082850101111561118d57600080fd5b60208301945080935050505092959891949750929550565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b8082018082111561094e5761094e6111bb565b60208082528181018390526000908460408401835b8681101561123c57823561120c81610fdd565b6001600160a01b0316825260808385018584013760a0838101359083015260c092830192909101906001016111f9565b509695505050505050565b978852602088019690965260408701949094526060860192909252608085015260a084015260c083015260e08201526101000190565b82815260006020604081840152835180604085015260005b818110156112b157858101830151858201606001528201611295565b506000606082860101526060601f19601f830116850101925050509392505050565b6000604082840312156112e557600080fd5b82601f8301126112f457600080fd5b6040516040810181811067ffffffffffffffff8211171561132557634e487b7160e01b600052604160045260246000fd5b806040525080604084018581111561133c57600080fd5b845b8181101561135657805183526020928301920161133e565b509195945050505050565b600060018201611373576113736111bb565b5060010190565b8181038181111561094e5761094e6111bb565b808202811582820484141761094e5761094e6111bb565b81356113af81610fdd565b81546001600160a01b0319166001600160a01b0391909116178155602082810160005b60048110156113f2578135600182860181019190915591830191016113d2565b50505060a082013560058201555050565b6000806000806080858703121561141957600080fd5b505082516020840151604085015160609095015191969095509092509050565b634e487b7160e01b600052601260045260246000fd5b60008261145e5761145e611439565b500490565b61010081016040858337604082018460005b6004811015611494578151835260209283019290910190600101611475565b50505060c082018360005b60028110156114be57815183526020928301929091019060010161149f565b505050949350505050565b805180151581146114d957600080fd5b919050565b600080604083850312156114f157600080fd5b6114fa836114c9565b9150611508602084016114c9565b90509250929050565b60008261152057611520611439565b50069056fea2646970667358221220333371ed350c4bed32fb9f706b6c8919ed167439ab6905122b177e698bce48e964736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101165760003560e01c806376671808116100a2578063babd4ee411610071578063babd4ee4146102c8578063d4c8e3e8146102db578063e416d677146102ee578063e9193d2b146102f7578063f896f1a51461030a57600080fd5b8063766718081461024157806395b0b0271461024a5780639a8a059214610275578063b8a242521461027e57600080fd5b806361a02208116100e957806361a022081461019b578063671b3793146101be5780636969a25c146101c7578063729e7c6e1461021957806373cb1a111461022c57600080fd5b80631d1d4f261461011b57806322fd1818146101375780633569ed931461016157806352a9674b14610174575b600080fd5b61012460035481565b6040519081526020015b60405180910390f35b61014a610145366004610f34565b610313565b60408051921515835260208301919091520161012e565b61012461016f366004610f34565b610364565b6101247fbee7fa562a38908559e4a988e62d6c08b84ef05f2ebd5d2bb2b855dc19d19fe281565b6101ae6101a9366004610f4d565b610398565b604051901515815260200161012e565b61012460055481565b6101fa6101d5366004610f34565b600960205260009081526040902080546005909101546001600160a01b039091169082565b604080516001600160a01b03909316835260208301919091520161012e565b6101ae610227366004610f4d565b610410565b61023f61023a366004611041565b610469565b005b61012460025481565b60065461025d906001600160a01b031681565b6040516001600160a01b03909116815260200161012e565b61012460015481565b6102ad61028c366004610f34565b60086020526000908152604090208054600182015460029092015490919083565b6040805193845260208401929092529082015260600161012e565b61023f6102d63660046110cc565b61061f565b60075461025d906001600160a01b031681565b61012460045481565b610124610305366004610f34565b610884565b610124600b5481565b60008080610322600a856108a5565b600a54909150810361033a5750600093849350915050565b6001600a828154811061034f5761034f6111a5565b90600052602060002001549250925050915091565b6000600881610374600a856108a5565b61037f9060016111d1565b8152602001908152602001600020600201549050919050565b6000806103a487610364565b9050806103f85760405162461bcd60e51b815260206004820152601e60248201527f4e4f5f4556454e545f524f4f545f464f525f424c4f434b5f4e554d424552000060448201526064015b60405180910390fd5b6104058686838787610954565b979650505050505050565b600085815260086020526040812060020154806103f85760405162461bcd60e51b815260206004820152601760248201527609c9ebe8aac8a9ca8bea49e9ea8be8c9ea4be8aa09e869604b1b60448201526064016103ef565b600054610100900460ff16158080156104895750600054600160ff909116105b806104a35750303b1580156104a3575060005460ff166001145b6105065760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103ef565b6000805460ff191660011790558015610529576000805461ff0019166101001790555b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03161561058d57336001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000161461058d57600080fd5b6001849055600680546001600160a01b038089166001600160a01b031992831617909255600780549288169290911691909117905560038290556105d1838361099e565b8015610617576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b8660400135600b54146106745760405162461bcd60e51b815260206004820152601a60248201527f494e56414c49445f56414c494441544f525f5345545f4841534800000000000060448201526064016103ef565b6000600154876020013589600001358a602001358a600001358b604001358d604001358b8b6040516020016106aa9291906111e4565b604051602081830303815290604052805190602001206040516020016106d7989796959493929190611247565b60408051601f198184030181528282528051602091820120908301520160408051601f198184030181529082905260065463a850a90960e01b83529092506107a3916001600160a01b039091169063a850a9099061075b907fbee7fa562a38908559e4a988e62d6c08b84ef05f2ebd5d2bb2b855dc19d19fe290869060040161127d565b6040805180830381865afa158015610777573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061079b91906112d3565b878585610aa4565b6002546107b08189610dae565b8735600081815260086020908152604091829020838155908b01356001820155908a013560029091015581101561083357600a8054600181018255600091825260208a01357fc65a7bb8d6351c1cf70c95a316cc6a92839c986682d98bc35f958f4883f9d2a8909101556002805490919061082a90611361565b90915550610867565b600a805460208a0135919061084a9060019061137a565b8154811061085a5761085a6111a5565b6000918252602090912001555b6020880135600455610879868661099e565b505050505050505050565b600a818154811061089457600080fd5b600091825260209091200154905081565b815460009081036108b85750600061094e565b82546000905b808210156109055760006108d28383610e8b565b600087815260209020909150859082015411156108f1578091506108ff565b6108fc8160016111d1565b92505b506108be565b60008211801561093157508361092e8661092060018661137a565b600091825260209091200190565b54145b1561094a5761094160018361137a565b9250505061094e565b5090505b92915050565b60008115610993578160051b8301835b8660011660051b8881528135602082185250604060002097508660011c96506020810190508181106109645750505b505050901591141690565b600381905560405181906109b890849083906020016111e4565b60408051601f198184030181529190528051602090910120600b556000805b82811015610a9b5760008585838181106109f3576109f36111a5565b905060c0020160a00135905060008111610a435760405162461bcd60e51b8152602060048201526011602482015270564f54494e475f504f5745525f5a45524f60781b60448201526064016103ef565b610a4d81846111d1565b9250858583818110610a6157610a616111a5565b905060c00201600960008481526020019081526020016000208181610a8691906113a4565b9050505080610a9490611361565b90506109d7565b50600555505050565b600354610aaf610f16565b6000805b83811015610c3357610ac6868683610ead565b15610c2b5781600003610b1a576000818152600960205260409081902081516080810190925260010160048282826020028201915b815481526020019060010190808311610afb5750505050509250610c0c565b60008181526009602052604080822081516080810190925260010160048282826020028201915b815481526020019060010190808311610b4157505060075488516020808b01516040808d01516060808f01518b51958c0151848d0151928d01519451630cbe96a560e41b81529c9d506001600160a01b039098169b63cbe96a509b50610bb89a509698509396919593949391929091600401611247565b608060405180830381865afa158015610bd5573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bf99190611403565b6060880152604087015260208601528452505b600081815260096020526040902060050154610c2890836111d1565b91505b600101610ab3565b5080600003610c765760405162461bcd60e51b815260206004820152600f60248201526e4249544d41505f49535f454d50545960881b60448201526064016103ef565b60036005546002610c87919061138d565b610c91919061144f565b8111610cdb5760405162461bcd60e51b815260206004820152601960248201527824a729aaa32324a1a4a2a72a2fab27aa24a723afa827aba2a960391b60448201526064016103ef565b60065460405163ebbdac9160e01b815260009182916001600160a01b039091169063ebbdac9190610d14908b9088908e90600401611463565b6040805180830381865afa158015610d30573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d5491906114de565b91509150818015610d625750805b6108795760405162461bcd60e51b815260206004820152601d60248201527f5349474e41545552455f564552494649434154494f4e5f4641494c454400000060448201526064016103ef565b600082815260086020908152604091829020825160608101845281548082526001830154938201939093526002909101549281019290925282351480610e0057508051610dfc9060016111d1565b8235145b610e3c5760405162461bcd60e51b815260206004820152600d60248201526c0929cac82989288be8aa09e869609b1b60448201526064016103ef565b8060200151826020013511610e865760405162461bcd60e51b815260206004820152601060248201526f115354151657d0d21150d2d413d2539560821b60448201526064016103ef565b505050565b6000610e9a600284841861144f565b610ea6908484166111d1565b9392505050565b600080610ebb60088461144f565b90506000610eca600885611511565b9050848210610ede57600092505050610ea6565b6000600160ff83161b878785818110610ef957610ef96111a5565b9050013560f81c60f81b60f81c60ff161611925050509392505050565b60405180608001604052806004906020820280368337509192915050565b600060208284031215610f4657600080fd5b5035919050565b600080600080600060808688031215610f6557600080fd5b853594506020860135935060408601359250606086013567ffffffffffffffff80821115610f9257600080fd5b818801915088601f830112610fa657600080fd5b813581811115610fb557600080fd5b8960208260051b8501011115610fca57600080fd5b9699959850939650602001949392505050565b6001600160a01b0381168114610ff257600080fd5b50565b60008083601f84011261100757600080fd5b50813567ffffffffffffffff81111561101f57600080fd5b60208301915083602060c08302850101111561103a57600080fd5b9250929050565b60008060008060006080868803121561105957600080fd5b853561106481610fdd565b9450602086013561107481610fdd565b935060408601359250606086013567ffffffffffffffff81111561109757600080fd5b6110a388828901610ff5565b969995985093965092949392505050565b6000606082840312156110c657600080fd5b50919050565b6000806000806000806000610140888a0312156110e857600080fd5b6110f289896110b4565b96506111018960608a016110b4565b955061010088018981111561111557600080fd5b60c0890195503567ffffffffffffffff8082111561113257600080fd5b61113e8b838c01610ff5565b90965094506101208a013591508082111561115857600080fd5b818a0191508a601f83011261116c57600080fd5b81358181111561117b57600080fd5b8b602082850101111561118d57600080fd5b60208301945080935050505092959891949750929550565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b8082018082111561094e5761094e6111bb565b60208082528181018390526000908460408401835b8681101561123c57823561120c81610fdd565b6001600160a01b0316825260808385018584013760a0838101359083015260c092830192909101906001016111f9565b509695505050505050565b978852602088019690965260408701949094526060860192909252608085015260a084015260c083015260e08201526101000190565b82815260006020604081840152835180604085015260005b818110156112b157858101830151858201606001528201611295565b506000606082860101526060601f19601f830116850101925050509392505050565b6000604082840312156112e557600080fd5b82601f8301126112f457600080fd5b6040516040810181811067ffffffffffffffff8211171561132557634e487b7160e01b600052604160045260246000fd5b806040525080604084018581111561133c57600080fd5b845b8181101561135657805183526020928301920161133e565b509195945050505050565b600060018201611373576113736111bb565b5060010190565b8181038181111561094e5761094e6111bb565b808202811582820484141761094e5761094e6111bb565b81356113af81610fdd565b81546001600160a01b0319166001600160a01b0391909116178155602082810160005b60048110156113f2578135600182860181019190915591830191016113d2565b50505060a082013560058201555050565b6000806000806080858703121561141957600080fd5b505082516020840151604085015160609095015191969095509092509050565b634e487b7160e01b600052601260045260246000fd5b60008261145e5761145e611439565b500490565b61010081016040858337604082018460005b6004811015611494578151835260209283019290910190600101611475565b50505060c082018360005b60028110156114be57815183526020928301929091019060010161149f565b505050949350505050565b805180151581146114d957600080fd5b919050565b600080604083850312156114f157600080fd5b6114fa836114c9565b9150611508602084016114c9565b90509250929050565b60008261152057611520611439565b50069056fea2646970667358221220333371ed350c4bed32fb9f706b6c8919ed167439ab6905122b177e698bce48e964736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ExitHelperArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ExitHelper","sourceName":"contracts/root/ExitHelper.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"bool","name":"success","type":"bool"},{"indexed":false,"internalType":"bytes","name":"returnData","type":"bytes"}],"name":"ExitProcessed","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"inputs":[{"components":[{"internalType":"uint256","name":"blockNumber","type":"uint256"},{"internalType":"uint256","name":"leafIndex","type":"uint256"},{"internalType":"bytes","name":"unhashedLeaf","type":"bytes"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"internalType":"struct IExitHelper.BatchExitInput[]","name":"inputs","type":"tuple[]"}],"name":"batchExit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"checkpointManager","outputs":[{"internalType":"contract ICheckpointManager","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"blockNumber","type":"uint256"},{"internalType":"uint256","name":"leafIndex","type":"uint256"},{"internalType":"bytes","name":"unhashedLeaf","type":"bytes"},{"internalType":"bytes32[]","name":"proof","type":"bytes32[]"}],"name":"exit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract ICheckpointManager","name":"newCheckpointManager","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"processedExits","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50610b62806100206000396000f3fe608060405234801561001057600080fd5b50600436106100575760003560e01c806350607b351461005c578063aa209cc314610071578063bd88ea7914610084578063c0857ba0146100bc578063c4d66de8146100e7575b600080fd5b61006f61006a3660046106c9565b6100fa565b005b61006f61007f36600461070b565b610200565b6100a76100923660046107bc565b60016020526000908152604090205460ff1681565b60405190151581526020015b60405180910390f35b6002546100cf906001600160a01b031681565b6040516001600160a01b0390911681526020016100b3565b61006f6100f53660046107ed565b610240565b6002546001600160a01b031661012b5760405162461bcd60e51b815260040161012290610811565b60405180910390fd5b8060005b818110156101fa576101f284848381811061014c5761014c610848565b905060200281019061015e919061085e565b3585858481811061017157610171610848565b9050602002810190610183919061085e565b6020013586868581811061019957610199610848565b90506020028101906101ab919061085e565b6101b990604081019061087e565b8888878181106101cb576101cb610848565b90506020028101906101dd919061085e565b6101eb9060608101906108c5565b60016103d2565b60010161012f565b50505050565b6002546001600160a01b03166102285760405162461bcd60e51b815260040161012290610811565b61023886868686868660006103d2565b505050505050565b600054610100900460ff16158080156102605750600054600160ff909116105b8061027a5750303b15801561027a575060005460ff166001145b6102dd5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610122565b6000805460ff191660011790558015610300576000805461ff0019166101001790555b6001600160a01b0382161580159061032157506001600160a01b0382163b15155b61036d5760405162461bcd60e51b815260206004820152601b60248201527f4578697448656c7065723a20494e56414c49445f4144445245535300000000006044820152606401610122565b600280546001600160a01b0319166001600160a01b03841617905580156103ce576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050565b60008080806103e3888a018a610925565b935093509350935084156104165760008481526001602052604090205460ff16156104115750505050610674565b610480565b60008481526001602052604090205460ff16156104805760405162461bcd60e51b815260206004820152602260248201527f4578697448656c7065723a20455849545f414c52454144595f50524f43455353604482015261115160f21b6064820152608401610122565b6002546040516001600160a01b03909116906361a02208908d906104a7908d908d90610a05565b6040519081900381206001600160e01b031960e085901b1682526104d492918f908d908d90600401610a15565b602060405180830381865afa1580156104f1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105159190610a62565b61055d5760405162461bcd60e51b815260206004820152601960248201527822bc34ba2432b63832b91d1024a72b20a624a22fa82927a7a360391b6044820152606401610122565b6000848152600160208190526040808320805460ff19169092179091555181906001600160a01b0385169061059a90889088908790602401610ad4565b60408051601f198184030181529181526020820180516001600160e01b031663f43cda8b60e01b179052516105cf9190610b07565b6000604051808303816000865af19150503d806000811461060c576040519150601f19603f3d011682016040523d82523d6000602084013e610611565b606091505b509150915081610632576000868152600160205260409020805460ff191690555b811515867f8bbfa0c9bee3785c03700d2a909592286efb83fc7e7002be5764424b9842f7ec836040516106659190610b19565b60405180910390a35050505050505b50505050505050565b60008083601f84011261068f57600080fd5b50813567ffffffffffffffff8111156106a757600080fd5b6020830191508360208260051b85010111156106c257600080fd5b9250929050565b600080602083850312156106dc57600080fd5b823567ffffffffffffffff8111156106f357600080fd5b6106ff8582860161067d565b90969095509350505050565b6000806000806000806080878903121561072457600080fd5b8635955060208701359450604087013567ffffffffffffffff8082111561074a57600080fd5b818901915089601f83011261075e57600080fd5b81358181111561076d57600080fd5b8a602082850101111561077f57600080fd5b60208301965080955050606089013591508082111561079d57600080fd5b506107aa89828a0161067d565b979a9699509497509295939492505050565b6000602082840312156107ce57600080fd5b5035919050565b6001600160a01b03811681146107ea57600080fd5b50565b6000602082840312156107ff57600080fd5b813561080a816107d5565b9392505050565b6020808252601b908201527f4578697448656c7065723a204e4f545f494e495449414c495a45440000000000604082015260600190565b634e487b7160e01b600052603260045260246000fd5b60008235607e1983360301811261087457600080fd5b9190910192915050565b6000808335601e1984360301811261089557600080fd5b83018035915067ffffffffffffffff8211156108b057600080fd5b6020019150368190038213156106c257600080fd5b6000808335601e198436030181126108dc57600080fd5b83018035915067ffffffffffffffff8211156108f757600080fd5b6020019150600581901b36038213156106c257600080fd5b634e487b7160e01b600052604160045260246000fd5b6000806000806080858703121561093b57600080fd5b84359350602085013561094d816107d5565b9250604085013561095d816107d5565b9150606085013567ffffffffffffffff8082111561097a57600080fd5b818701915087601f83011261098e57600080fd5b8135818111156109a0576109a061090f565b604051601f8201601f19908116603f011681019083821181831017156109c8576109c861090f565b816040528281528a60208487010111156109e157600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b8183823760009101908152919050565b85815284602082015283604082015260806060820152816080820152600060018060fb1b03831115610a4657600080fd5b8260051b808560a08501379190910160a0019695505050505050565b600060208284031215610a7457600080fd5b8151801515811461080a57600080fd5b60005b83811015610a9f578181015183820152602001610a87565b50506000910152565b60008151808452610ac0816020860160208601610a84565b601f01601f19169290920160200192915050565b8381526001600160a01b0383166020820152606060408201819052600090610afe90830184610aa8565b95945050505050565b60008251610874818460208701610a84565b60208152600061080a6020830184610aa856fea264697066735822122062ac4b08903d6279500a6ee30957a69454dadfc7f8af07bc8702efa271a1f6f364736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100575760003560e01c806350607b351461005c578063aa209cc314610071578063bd88ea7914610084578063c0857ba0146100bc578063c4d66de8146100e7575b600080fd5b61006f61006a3660046106c9565b6100fa565b005b61006f61007f36600461070b565b610200565b6100a76100923660046107bc565b60016020526000908152604090205460ff1681565b60405190151581526020015b60405180910390f35b6002546100cf906001600160a01b031681565b6040516001600160a01b0390911681526020016100b3565b61006f6100f53660046107ed565b610240565b6002546001600160a01b031661012b5760405162461bcd60e51b815260040161012290610811565b60405180910390fd5b8060005b818110156101fa576101f284848381811061014c5761014c610848565b905060200281019061015e919061085e565b3585858481811061017157610171610848565b9050602002810190610183919061085e565b6020013586868581811061019957610199610848565b90506020028101906101ab919061085e565b6101b990604081019061087e565b8888878181106101cb576101cb610848565b90506020028101906101dd919061085e565b6101eb9060608101906108c5565b60016103d2565b60010161012f565b50505050565b6002546001600160a01b03166102285760405162461bcd60e51b815260040161012290610811565b61023886868686868660006103d2565b505050505050565b600054610100900460ff16158080156102605750600054600160ff909116105b8061027a5750303b15801561027a575060005460ff166001145b6102dd5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610122565b6000805460ff191660011790558015610300576000805461ff0019166101001790555b6001600160a01b0382161580159061032157506001600160a01b0382163b15155b61036d5760405162461bcd60e51b815260206004820152601b60248201527f4578697448656c7065723a20494e56414c49445f4144445245535300000000006044820152606401610122565b600280546001600160a01b0319166001600160a01b03841617905580156103ce576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050565b60008080806103e3888a018a610925565b935093509350935084156104165760008481526001602052604090205460ff16156104115750505050610674565b610480565b60008481526001602052604090205460ff16156104805760405162461bcd60e51b815260206004820152602260248201527f4578697448656c7065723a20455849545f414c52454144595f50524f43455353604482015261115160f21b6064820152608401610122565b6002546040516001600160a01b03909116906361a02208908d906104a7908d908d90610a05565b6040519081900381206001600160e01b031960e085901b1682526104d492918f908d908d90600401610a15565b602060405180830381865afa1580156104f1573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105159190610a62565b61055d5760405162461bcd60e51b815260206004820152601960248201527822bc34ba2432b63832b91d1024a72b20a624a22fa82927a7a360391b6044820152606401610122565b6000848152600160208190526040808320805460ff19169092179091555181906001600160a01b0385169061059a90889088908790602401610ad4565b60408051601f198184030181529181526020820180516001600160e01b031663f43cda8b60e01b179052516105cf9190610b07565b6000604051808303816000865af19150503d806000811461060c576040519150601f19603f3d011682016040523d82523d6000602084013e610611565b606091505b509150915081610632576000868152600160205260409020805460ff191690555b811515867f8bbfa0c9bee3785c03700d2a909592286efb83fc7e7002be5764424b9842f7ec836040516106659190610b19565b60405180910390a35050505050505b50505050505050565b60008083601f84011261068f57600080fd5b50813567ffffffffffffffff8111156106a757600080fd5b6020830191508360208260051b85010111156106c257600080fd5b9250929050565b600080602083850312156106dc57600080fd5b823567ffffffffffffffff8111156106f357600080fd5b6106ff8582860161067d565b90969095509350505050565b6000806000806000806080878903121561072457600080fd5b8635955060208701359450604087013567ffffffffffffffff8082111561074a57600080fd5b818901915089601f83011261075e57600080fd5b81358181111561076d57600080fd5b8a602082850101111561077f57600080fd5b60208301965080955050606089013591508082111561079d57600080fd5b506107aa89828a0161067d565b979a9699509497509295939492505050565b6000602082840312156107ce57600080fd5b5035919050565b6001600160a01b03811681146107ea57600080fd5b50565b6000602082840312156107ff57600080fd5b813561080a816107d5565b9392505050565b6020808252601b908201527f4578697448656c7065723a204e4f545f494e495449414c495a45440000000000604082015260600190565b634e487b7160e01b600052603260045260246000fd5b60008235607e1983360301811261087457600080fd5b9190910192915050565b6000808335601e1984360301811261089557600080fd5b83018035915067ffffffffffffffff8211156108b057600080fd5b6020019150368190038213156106c257600080fd5b6000808335601e198436030181126108dc57600080fd5b83018035915067ffffffffffffffff8211156108f757600080fd5b6020019150600581901b36038213156106c257600080fd5b634e487b7160e01b600052604160045260246000fd5b6000806000806080858703121561093b57600080fd5b84359350602085013561094d816107d5565b9250604085013561095d816107d5565b9150606085013567ffffffffffffffff8082111561097a57600080fd5b818701915087601f83011261098e57600080fd5b8135818111156109a0576109a061090f565b604051601f8201601f19908116603f011681019083821181831017156109c8576109c861090f565b816040528281528a60208487010111156109e157600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b8183823760009101908152919050565b85815284602082015283604082015260806060820152816080820152600060018060fb1b03831115610a4657600080fd5b8260051b808560a08501379190910160a0019695505050505050565b600060208284031215610a7457600080fd5b8151801515811461080a57600080fd5b60005b83811015610a9f578181015183820152602001610a87565b50506000910152565b60008151808452610ac0816020860160208601610a84565b601f01601f19169290920160200192915050565b8381526001600160a01b0383166020820152606060408201819052600090610afe90830184610aa8565b95945050505050565b60008251610874818460208701610a84565b60208152600061080a6020830184610aa856fea264697066735822122062ac4b08903d6279500a6ee30957a69454dadfc7f8af07bc8702efa271a1f6f364736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var StateSenderArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"StateSender","sourceName":"contracts/root/StateSender.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"bytes","name":"data","type":"bytes"}],"name":"StateSynced","type":"event"},{"inputs":[],"name":"MAX_LENGTH","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"counter","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"syncState","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50610297806100206000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c806316f198311461004657806361bc221a1461005b578063a6f9885c14610076575b600080fd5b61005961005436600461017a565b61007f565b005b61006460005481565b60405190815260200160405180910390f35b61006461080081565b6001600160a01b0383166100cd5760405162461bcd60e51b815260206004820152601060248201526f24a72b20a624a22fa922a1a2a4ab22a960811b60448201526064015b60405180910390fd5b6108008111156101145760405162461bcd60e51b815260206004820152601260248201527108ab0868a8a88a6be9a82b0be988a9c8ea8960731b60448201526064016100c4565b826001600160a01b0316336001600160a01b031660008081546101369061020b565b9190508190557fd1d7f6609674cc5871fdb4b0bcd4f0a214118411de9e38983866514f22659165858560405161016d929190610232565b60405180910390a4505050565b60008060006040848603121561018f57600080fd5b83356001600160a01b03811681146101a657600080fd5b9250602084013567ffffffffffffffff808211156101c357600080fd5b818601915086601f8301126101d757600080fd5b8135818111156101e657600080fd5b8760208285010111156101f857600080fd5b6020830194508093505050509250925092565b60006001820161022b57634e487b7160e01b600052601160045260246000fd5b5060010190565b60208152816020820152818360408301376000818301604090810191909152601f909201601f1916010191905056fea264697066735822122031b7ec2bc87f0234fe89e0f741bc18f51baa2be5cc844033ea10f35e4b86094c64736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100415760003560e01c806316f198311461004657806361bc221a1461005b578063a6f9885c14610076575b600080fd5b61005961005436600461017a565b61007f565b005b61006460005481565b60405190815260200160405180910390f35b61006461080081565b6001600160a01b0383166100cd5760405162461bcd60e51b815260206004820152601060248201526f24a72b20a624a22fa922a1a2a4ab22a960811b60448201526064015b60405180910390fd5b6108008111156101145760405162461bcd60e51b815260206004820152601260248201527108ab0868a8a88a6be9a82b0be988a9c8ea8960731b60448201526064016100c4565b826001600160a01b0316336001600160a01b031660008081546101369061020b565b9190508190557fd1d7f6609674cc5871fdb4b0bcd4f0a214118411de9e38983866514f22659165858560405161016d929190610232565b60405180910390a4505050565b60008060006040848603121561018f57600080fd5b83356001600160a01b03811681146101a657600080fd5b9250602084013567ffffffffffffffff808211156101c357600080fd5b818601915086601f8301126101d757600080fd5b8135818111156101e657600080fd5b8760208285010111156101f857600080fd5b6020830194508093505050509250925092565b60006001820161022b57634e487b7160e01b600052601160045260246000fd5b5060010190565b60208152816020820152818360408301376000818301604090810191909152601f909201601f1916010191905056fea264697066735822122031b7ec2bc87f0234fe89e0f741bc18f51baa2be5cc844033ea10f35e4b86094c64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var MockERC20Artifact string = `{"_format":"hh-sol-artifact-1","contractName":"MockERC20","sourceName":"contracts/mocks/MockERC20.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MINTER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"PAUSER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burnFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x60806040523480156200001157600080fd5b50604080518082018252600480825263151154d560e21b60208084018290528451808601909552918452908301529081816005620000508382620002ca565b5060066200005f8282620002ca565b50506007805460ff191690555062000079600033620000d9565b620000a57f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a633620000d9565b620000d17f65d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440d862a33620000d9565b505062000396565b620000e58282620000e9565b5050565b620000f5828262000114565b60008281526001602052604090206200010f9082620001b4565b505050565b6000828152602081815260408083206001600160a01b038516845290915290205460ff16620000e5576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055620001703390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000620001cb836001600160a01b038416620001d4565b90505b92915050565b60008181526001830160205260408120546200021d57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155620001ce565b506000620001ce565b634e487b7160e01b600052604160045260246000fd5b600181811c908216806200025157607f821691505b6020821081036200027257634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156200010f57600081815260208120601f850160051c81016020861015620002a15750805b601f850160051c820191505b81811015620002c257828155600101620002ad565b505050505050565b81516001600160401b03811115620002e657620002e662000226565b620002fe81620002f784546200023c565b8462000278565b602080601f8311600181146200033657600084156200031d5750858301515b600019600386901b1c1916600185901b178555620002c2565b600085815260208120601f198616915b82811015620003675788860151825594840194600190910190840162000346565b5085821015620003865787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6117fa80620003a66000396000f3fe608060405234801561001057600080fd5b50600436106101845760003560e01c806370a08231116100d9578063a457c2d711610087578063a457c2d714610336578063a9059cbb14610349578063ca15c8731461035c578063d53913931461036f578063d547741f14610396578063dd62ed3e146103a9578063e63ab1e9146103bc57600080fd5b806370a08231146102a457806379cc6790146102cd5780638456cb59146102e05780639010d07c146102e857806391d148541461031357806395d89b4114610326578063a217fddf1461032e57600080fd5b8063313ce56711610136578063313ce5671461023657806336568abe1461024557806339509351146102585780633f4ba83a1461026b57806340c10f191461027357806342966c68146102865780635c975abb1461029957600080fd5b806301ffc9a71461018957806306fdde03146101b1578063095ea7b3146101c657806318160ddd146101d957806323b872dd146101eb578063248a9ca3146101fe5780632f2ff15d14610221575b600080fd5b61019c610197366004611460565b6103d1565b60405190151581526020015b60405180910390f35b6101b96103fc565b6040516101a891906114ae565b61019c6101d43660046114fd565b61048e565b6004545b6040519081526020016101a8565b61019c6101f9366004611527565b6104a6565b6101dd61020c366004611563565b60009081526020819052604090206001015490565b61023461022f36600461157c565b6104ca565b005b604051601281526020016101a8565b61023461025336600461157c565b6104f4565b61019c6102663660046114fd565b610577565b610234610599565b6102346102813660046114fd565b610617565b610234610294366004611563565b6106a4565b60075460ff1661019c565b6101dd6102b23660046115a8565b6001600160a01b031660009081526002602052604090205490565b6102346102db3660046114fd565b6106b1565b6102346106c6565b6102fb6102f63660046115c3565b610740565b6040516001600160a01b0390911681526020016101a8565b61019c61032136600461157c565b61075f565b6101b9610788565b6101dd600081565b61019c6103443660046114fd565b610797565b61019c6103573660046114fd565b610812565b6101dd61036a366004611563565b610820565b6101dd7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a681565b6102346103a436600461157c565b610837565b6101dd6103b73660046115e5565b61085c565b6101dd60008051602061178583398151915281565b60006001600160e01b03198216635a05180f60e01b14806103f657506103f682610887565b92915050565b60606005805461040b9061160f565b80601f01602080910402602001604051908101604052809291908181526020018280546104379061160f565b80156104845780601f1061045957610100808354040283529160200191610484565b820191906000526020600020905b81548152906001019060200180831161046757829003601f168201915b5050505050905090565b60003361049c8185856108bc565b5060019392505050565b6000336104b48582856109e0565b6104bf858585610a5a565b506001949350505050565b6000828152602081905260409020600101546104e581610bfe565b6104ef8383610c08565b505050565b6001600160a01b03811633146105695760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b6105738282610c2a565b5050565b60003361049c81858561058a838361085c565b610594919061165f565b6108bc565b6105b16000805160206117858339815191523361075f565b61060d5760405162461bcd60e51b8152602060048201526039602482015260008051602061176583398151915260448201527876652070617573657220726f6c6520746f20756e706175736560381b6064820152608401610560565b610615610c4c565b565b6106417f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a63361075f565b61069a5760405162461bcd60e51b815260206004820152603660248201526000805160206117658339815191526044820152751d99481b5a5b9d195c881c9bdb19481d1bc81b5a5b9d60521b6064820152608401610560565b6105738282610c9e565b6106ae3382610d59565b50565b6106bc8233836109e0565b6105738282610d59565b6106de6000805160206117858339815191523361075f565b6107385760405162461bcd60e51b8152602060048201526037602482015260008051602061176583398151915260448201527676652070617573657220726f6c6520746f20706175736560481b6064820152608401610560565b610615610e87565b60008281526001602052604081206107589083610ec4565b9392505050565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b60606006805461040b9061160f565b600033816107a5828661085c565b9050838110156108055760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610560565b6104bf82868684036108bc565b60003361049c818585610a5a565b60008181526001602052604081206103f690610ed0565b60008281526020819052604090206001015461085281610bfe565b6104ef8383610c2a565b6001600160a01b03918216600090815260036020908152604080832093909416825291909152205490565b60006001600160e01b03198216637965db0b60e01b14806103f657506301ffc9a760e01b6001600160e01b03198316146103f6565b6001600160a01b03831661091e5760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610560565b6001600160a01b03821661097f5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610560565b6001600160a01b0383811660008181526003602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b60006109ec848461085c565b90506000198114610a545781811015610a475760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610560565b610a5484848484036108bc565b50505050565b6001600160a01b038316610abe5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610560565b6001600160a01b038216610b205760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610560565b610b2b838383610eda565b6001600160a01b03831660009081526002602052604090205481811015610ba35760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610560565b6001600160a01b0380851660008181526002602052604080822086860390559286168082529083902080548601905591516000805160206117a583398151915290610bf19086815260200190565b60405180910390a3610a54565b6106ae8133610ee5565b610c128282610f3e565b60008281526001602052604090206104ef9082610fc2565b610c348282610fd7565b60008281526001602052604090206104ef908261103c565b610c54611051565b6007805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6001600160a01b038216610cf45760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610560565b610d0060008383610eda565b8060046000828254610d12919061165f565b90915550506001600160a01b0382166000818152600260209081526040808320805486019055518481526000805160206117a5833981519152910160405180910390a35050565b6001600160a01b038216610db95760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610560565b610dc582600083610eda565b6001600160a01b03821660009081526002602052604090205481811015610e395760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610560565b6001600160a01b03831660008181526002602090815260408083208686039055600480548790039055518581529192916000805160206117a5833981519152910160405180910390a3505050565b610e8f61109a565b6007805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610c813390565b600061075883836110e0565b60006103f6825490565b6104ef83838361110a565b610eef828261075f565b61057357610efc81611170565b610f07836020611182565b604051602001610f18929190611672565b60408051601f198184030181529082905262461bcd60e51b8252610560916004016114ae565b610f48828261075f565b610573576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055610f7e3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000610758836001600160a01b03841661131e565b610fe1828261075f565b15610573576000828152602081815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000610758836001600160a01b03841661136d565b60075460ff166106155760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610560565b60075460ff16156106155760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610560565b60008260000182815481106110f7576110f76116e1565b9060005260206000200154905092915050565b60075460ff16156104ef5760405162461bcd60e51b815260206004820152602a60248201527f45524332305061757361626c653a20746f6b656e207472616e736665722077686044820152691a5b19481c185d5cd95960b21b6064820152608401610560565b60606103f66001600160a01b03831660145b606060006111918360026116f7565b61119c90600261165f565b67ffffffffffffffff8111156111b4576111b461170e565b6040519080825280601f01601f1916602001820160405280156111de576020820181803683370190505b509050600360fc1b816000815181106111f9576111f96116e1565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110611228576112286116e1565b60200101906001600160f81b031916908160001a905350600061124c8460026116f7565b61125790600161165f565b90505b60018111156112cf576f181899199a1a9b1b9c1cb0b131b232b360811b85600f166010811061128b5761128b6116e1565b1a60f81b8282815181106112a1576112a16116e1565b60200101906001600160f81b031916908160001a90535060049490941c936112c881611724565b905061125a565b5083156107585760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610560565b6000818152600183016020526040812054611365575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556103f6565b5060006103f6565b6000818152600183016020526040812054801561145657600061139160018361173b565b85549091506000906113a59060019061173b565b905081811461140a5760008660000182815481106113c5576113c56116e1565b90600052602060002001549050808760000184815481106113e8576113e86116e1565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061141b5761141b61174e565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506103f6565b60009150506103f6565b60006020828403121561147257600080fd5b81356001600160e01b03198116811461075857600080fd5b60005b838110156114a557818101518382015260200161148d565b50506000910152565b60208152600082518060208401526114cd81604085016020870161148a565b601f01601f19169190910160400192915050565b80356001600160a01b03811681146114f857600080fd5b919050565b6000806040838503121561151057600080fd5b611519836114e1565b946020939093013593505050565b60008060006060848603121561153c57600080fd5b611545846114e1565b9250611553602085016114e1565b9150604084013590509250925092565b60006020828403121561157557600080fd5b5035919050565b6000806040838503121561158f57600080fd5b8235915061159f602084016114e1565b90509250929050565b6000602082840312156115ba57600080fd5b610758826114e1565b600080604083850312156115d657600080fd5b50508035926020909101359150565b600080604083850312156115f857600080fd5b611601836114e1565b915061159f602084016114e1565b600181811c9082168061162357607f821691505b60208210810361164357634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b808201808211156103f6576103f6611649565b76020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b8152600083516116a481601785016020880161148a565b7001034b99036b4b9b9b4b733903937b6329607d1b60179184019182015283516116d581602884016020880161148a565b01602801949350505050565b634e487b7160e01b600052603260045260246000fd5b80820281158282048414176103f6576103f6611649565b634e487b7160e01b600052604160045260246000fd5b60008161173357611733611649565b506000190190565b818103818111156103f6576103f6611649565b634e487b7160e01b600052603160045260246000fdfe45524332305072657365744d696e7465725061757365723a206d75737420686165d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440d862addf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220d5a22b9391b8f37e5b49e43cc1eabfcea8be6d7b5aa0a84dc5daa1b7a05730f364736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101845760003560e01c806370a08231116100d9578063a457c2d711610087578063a457c2d714610336578063a9059cbb14610349578063ca15c8731461035c578063d53913931461036f578063d547741f14610396578063dd62ed3e146103a9578063e63ab1e9146103bc57600080fd5b806370a08231146102a457806379cc6790146102cd5780638456cb59146102e05780639010d07c146102e857806391d148541461031357806395d89b4114610326578063a217fddf1461032e57600080fd5b8063313ce56711610136578063313ce5671461023657806336568abe1461024557806339509351146102585780633f4ba83a1461026b57806340c10f191461027357806342966c68146102865780635c975abb1461029957600080fd5b806301ffc9a71461018957806306fdde03146101b1578063095ea7b3146101c657806318160ddd146101d957806323b872dd146101eb578063248a9ca3146101fe5780632f2ff15d14610221575b600080fd5b61019c610197366004611460565b6103d1565b60405190151581526020015b60405180910390f35b6101b96103fc565b6040516101a891906114ae565b61019c6101d43660046114fd565b61048e565b6004545b6040519081526020016101a8565b61019c6101f9366004611527565b6104a6565b6101dd61020c366004611563565b60009081526020819052604090206001015490565b61023461022f36600461157c565b6104ca565b005b604051601281526020016101a8565b61023461025336600461157c565b6104f4565b61019c6102663660046114fd565b610577565b610234610599565b6102346102813660046114fd565b610617565b610234610294366004611563565b6106a4565b60075460ff1661019c565b6101dd6102b23660046115a8565b6001600160a01b031660009081526002602052604090205490565b6102346102db3660046114fd565b6106b1565b6102346106c6565b6102fb6102f63660046115c3565b610740565b6040516001600160a01b0390911681526020016101a8565b61019c61032136600461157c565b61075f565b6101b9610788565b6101dd600081565b61019c6103443660046114fd565b610797565b61019c6103573660046114fd565b610812565b6101dd61036a366004611563565b610820565b6101dd7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a681565b6102346103a436600461157c565b610837565b6101dd6103b73660046115e5565b61085c565b6101dd60008051602061178583398151915281565b60006001600160e01b03198216635a05180f60e01b14806103f657506103f682610887565b92915050565b60606005805461040b9061160f565b80601f01602080910402602001604051908101604052809291908181526020018280546104379061160f565b80156104845780601f1061045957610100808354040283529160200191610484565b820191906000526020600020905b81548152906001019060200180831161046757829003601f168201915b5050505050905090565b60003361049c8185856108bc565b5060019392505050565b6000336104b48582856109e0565b6104bf858585610a5a565b506001949350505050565b6000828152602081905260409020600101546104e581610bfe565b6104ef8383610c08565b505050565b6001600160a01b03811633146105695760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b6105738282610c2a565b5050565b60003361049c81858561058a838361085c565b610594919061165f565b6108bc565b6105b16000805160206117858339815191523361075f565b61060d5760405162461bcd60e51b8152602060048201526039602482015260008051602061176583398151915260448201527876652070617573657220726f6c6520746f20756e706175736560381b6064820152608401610560565b610615610c4c565b565b6106417f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a63361075f565b61069a5760405162461bcd60e51b815260206004820152603660248201526000805160206117658339815191526044820152751d99481b5a5b9d195c881c9bdb19481d1bc81b5a5b9d60521b6064820152608401610560565b6105738282610c9e565b6106ae3382610d59565b50565b6106bc8233836109e0565b6105738282610d59565b6106de6000805160206117858339815191523361075f565b6107385760405162461bcd60e51b8152602060048201526037602482015260008051602061176583398151915260448201527676652070617573657220726f6c6520746f20706175736560481b6064820152608401610560565b610615610e87565b60008281526001602052604081206107589083610ec4565b9392505050565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b60606006805461040b9061160f565b600033816107a5828661085c565b9050838110156108055760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610560565b6104bf82868684036108bc565b60003361049c818585610a5a565b60008181526001602052604081206103f690610ed0565b60008281526020819052604090206001015461085281610bfe565b6104ef8383610c2a565b6001600160a01b03918216600090815260036020908152604080832093909416825291909152205490565b60006001600160e01b03198216637965db0b60e01b14806103f657506301ffc9a760e01b6001600160e01b03198316146103f6565b6001600160a01b03831661091e5760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610560565b6001600160a01b03821661097f5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610560565b6001600160a01b0383811660008181526003602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b60006109ec848461085c565b90506000198114610a545781811015610a475760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610560565b610a5484848484036108bc565b50505050565b6001600160a01b038316610abe5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610560565b6001600160a01b038216610b205760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610560565b610b2b838383610eda565b6001600160a01b03831660009081526002602052604090205481811015610ba35760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610560565b6001600160a01b0380851660008181526002602052604080822086860390559286168082529083902080548601905591516000805160206117a583398151915290610bf19086815260200190565b60405180910390a3610a54565b6106ae8133610ee5565b610c128282610f3e565b60008281526001602052604090206104ef9082610fc2565b610c348282610fd7565b60008281526001602052604090206104ef908261103c565b610c54611051565b6007805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6001600160a01b038216610cf45760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610560565b610d0060008383610eda565b8060046000828254610d12919061165f565b90915550506001600160a01b0382166000818152600260209081526040808320805486019055518481526000805160206117a5833981519152910160405180910390a35050565b6001600160a01b038216610db95760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610560565b610dc582600083610eda565b6001600160a01b03821660009081526002602052604090205481811015610e395760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610560565b6001600160a01b03831660008181526002602090815260408083208686039055600480548790039055518581529192916000805160206117a5833981519152910160405180910390a3505050565b610e8f61109a565b6007805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610c813390565b600061075883836110e0565b60006103f6825490565b6104ef83838361110a565b610eef828261075f565b61057357610efc81611170565b610f07836020611182565b604051602001610f18929190611672565b60408051601f198184030181529082905262461bcd60e51b8252610560916004016114ae565b610f48828261075f565b610573576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055610f7e3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000610758836001600160a01b03841661131e565b610fe1828261075f565b15610573576000828152602081815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000610758836001600160a01b03841661136d565b60075460ff166106155760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610560565b60075460ff16156106155760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610560565b60008260000182815481106110f7576110f76116e1565b9060005260206000200154905092915050565b60075460ff16156104ef5760405162461bcd60e51b815260206004820152602a60248201527f45524332305061757361626c653a20746f6b656e207472616e736665722077686044820152691a5b19481c185d5cd95960b21b6064820152608401610560565b60606103f66001600160a01b03831660145b606060006111918360026116f7565b61119c90600261165f565b67ffffffffffffffff8111156111b4576111b461170e565b6040519080825280601f01601f1916602001820160405280156111de576020820181803683370190505b509050600360fc1b816000815181106111f9576111f96116e1565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110611228576112286116e1565b60200101906001600160f81b031916908160001a905350600061124c8460026116f7565b61125790600161165f565b90505b60018111156112cf576f181899199a1a9b1b9c1cb0b131b232b360811b85600f166010811061128b5761128b6116e1565b1a60f81b8282815181106112a1576112a16116e1565b60200101906001600160f81b031916908160001a90535060049490941c936112c881611724565b905061125a565b5083156107585760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610560565b6000818152600183016020526040812054611365575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556103f6565b5060006103f6565b6000818152600183016020526040812054801561145657600061139160018361173b565b85549091506000906113a59060019061173b565b905081811461140a5760008660000182815481106113c5576113c56116e1565b90600052602060002001549050808760000184815481106113e8576113e86116e1565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061141b5761141b61174e565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506103f6565b60009150506103f6565b60006020828403121561147257600080fd5b81356001600160e01b03198116811461075857600080fd5b60005b838110156114a557818101518382015260200161148d565b50506000910152565b60208152600082518060208401526114cd81604085016020870161148a565b601f01601f19169190910160400192915050565b80356001600160a01b03811681146114f857600080fd5b919050565b6000806040838503121561151057600080fd5b611519836114e1565b946020939093013593505050565b60008060006060848603121561153c57600080fd5b611545846114e1565b9250611553602085016114e1565b9150604084013590509250925092565b60006020828403121561157557600080fd5b5035919050565b6000806040838503121561158f57600080fd5b8235915061159f602084016114e1565b90509250929050565b6000602082840312156115ba57600080fd5b610758826114e1565b600080604083850312156115d657600080fd5b50508035926020909101359150565b600080604083850312156115f857600080fd5b611601836114e1565b915061159f602084016114e1565b600181811c9082168061162357607f821691505b60208210810361164357634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b808201808211156103f6576103f6611649565b76020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b8152600083516116a481601785016020880161148a565b7001034b99036b4b9b9b4b733903937b6329607d1b60179184019182015283516116d581602884016020880161148a565b01602801949350505050565b634e487b7160e01b600052603260045260246000fd5b80820281158282048414176103f6576103f6611649565b634e487b7160e01b600052604160045260246000fd5b60008161173357611733611649565b506000190190565b818103818111156103f6576103f6611649565b634e487b7160e01b600052603160045260246000fdfe45524332305072657365744d696e7465725061757365723a206d75737420686165d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440d862addf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220d5a22b9391b8f37e5b49e43cc1eabfcea8be6d7b5aa0a84dc5daa1b7a05730f364736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RootERC20PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RootERC20Predicate","sourceName":"contracts/root/RootERC20Predicate.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"depositor","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"ERC20Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"ERC20Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"TokenMapped","type":"event"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childERC20Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC20Metadata","name":"rootToken","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20Metadata","name":"rootToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"depositTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"exitHelper","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newStateSender","type":"address"},{"internalType":"address","name":"newExitHelper","type":"address"},{"internalType":"address","name":"newChildERC20Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"},{"internalType":"address","name":"newNativeTokenRoot","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20Metadata","name":"rootToken","type":"address"}],"name":"mapToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"nativeTokenRoot","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onL2StateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b506113f5806100206000396000f3fe608060405234801561001057600080fd5b50600436106100ca5760003560e01c8063cb10f94c1161007c578063cb10f94c146101ab578063d41f1771146101c4578063d57184e4146101eb578063f213159c146101fe578063f43cda8b14610211578063f4a120f714610224578063f64512551461023757600080fd5b80631459457a146100cf57806347e7ef24146100e45780636a00c1d7146100f75780637efab4f51461012757806395c7041c14610150578063b176806514610163578063b68ad1e414610198575b600080fd5b6100e26100dd366004610f79565b61025e565b005b6100e26100f2366004610fea565b6104dc565b60055461010a906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b61010a610135366004611016565b6004602052600090815260409020546001600160a01b031681565b60015461010a906001600160a01b031681565b61018a7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60405190815260200161011e565b60035461010a906001600160a01b031681565b60005461010a906201000090046001600160a01b031681565b61018a7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b60025461010a906001600160a01b031681565b6100e261020c36600461103a565b6104eb565b6100e261021f36600461107b565b6104fb565b61010a610232366004611016565b610682565b61018a7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b600054610100900460ff161580801561027e5750600054600160ff909116105b806102985750303b158015610298575060005460ff166001145b6103005760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084015b60405180910390fd5b6000805460ff191660011790558015610323576000805461ff0019166101001790555b6001600160a01b0386161580159061034357506001600160a01b03851615155b801561035757506001600160a01b03841615155b801561036b57506001600160a01b03831615155b6103c65760405162461bcd60e51b815260206004820152602660248201527f526f6f7445524332305072656469636174653a204241445f494e495449414c496044820152652d20aa24a7a760d11b60648201526084016102f7565b6000805462010000600160b01b031916620100006001600160a01b038981169190910291909117909155600180546001600160a01b0319908116888416179091556002805482168784161790556003805490911685831617905582161561048e57600580546001600160a01b03199081166001600160a01b038581169182178455600091825260046020526040808320805461101095168517905593549351929316917f85920d35e6c72f6b2affffa04298b0cecfeba86e4a9f407df661f1cb8ab5e6179190a35b80156104d4576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b6104e7823383610a43565b5050565b6104f6838383610a43565b505050565b6001546001600160a01b031633146105615760405162461bcd60e51b8152602060048201526024808201527f526f6f7445524332305072656469636174653a204f4e4c595f455849545f4845604482015263262822a960e11b60648201526084016102f7565b6002546001600160a01b038481169116146105cf5760405162461bcd60e51b815260206004820152602860248201527f526f6f7445524332305072656469636174653a204f4e4c595f4348494c445f50604482015267524544494341544560c01b60648201526084016102f7565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e9828696105fe602060008486611104565b6106079161112e565b036106265761062161061c8260208186611104565b610bba565b61067c565b60405162461bcd60e51b815260206004820152602560248201527f526f6f7445524332305072656469636174653a20494e56414c49445f5349474e604482015264415455524560d81b60648201526084016102f7565b50505050565b60006001600160a01b0382166106e45760405162461bcd60e51b815260206004820152602160248201527f526f6f7445524332305072656469636174653a20494e56414c49445f544f4b456044820152602760f91b60648201526084016102f7565b6001600160a01b0382811660009081526004602052604090205416156107575760405162461bcd60e51b815260206004820152602260248201527f526f6f7445524332305072656469636174653a20414c52454144595f4d415050604482015261115160f21b60648201526084016102f7565b6002546003546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b039283169260009261080592911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b03858116600081815260046020819052604080832080546001600160a01b031916878716179055825481516306fdde0360e01b81529151969750620100009004909416946316f198319488947f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad948c9491936306fdde039380840193908290030181865afa1580156108a2573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526108ca9190810190611187565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610908573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526109309190810190611187565b8a6001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa15801561096e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109929190611229565b6040516020016109a6959493929190611278565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016109d29291906112ca565b600060405180830381600087803b1580156109ec57600080fd5b505af1158015610a00573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f85920d35e6c72f6b2affffa04298b0cecfeba86e4a9f407df661f1cb8ab5e61790600090a39392505050565b6001600160a01b038084166000908152600460205260409020541680610a6f57610a6c84610682565b90505b6001600160a01b038116610a8557610a856112ee565b610a9a6001600160a01b038516333085610c72565b600054600254604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b0388811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352620100009094048416936316f1983193610b2b9391169160c4016112ca565b600060405180830381600087803b158015610b4557600080fd5b505af1158015610b59573d6000803e3d6000fd5b50505050826001600160a01b0316816001600160a01b0316856001600160a01b03167f8be9001bb612c7123a1861dc0d9d94e683261f6cbbd7c7438b708975bc4908a33386604051610bac929190611304565b60405180910390a450505050565b6000808080610bcb8587018761131d565b6001600160a01b0380851660009081526004602052604090205494985092965090945092501680610bfe57610bfe6112ee565b610c126001600160a01b0386168484610cdd565b826001600160a01b0316816001600160a01b0316866001600160a01b03167f9c4f744b2e971d7058a9d8f43977e0e17bf7d57a48659f0e18541b7ee3d022e48786604051610c61929190611304565b60405180910390a450505050505050565b6040516001600160a01b038085166024830152831660448201526064810182905261067c9085906323b872dd60e01b906084015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152610cfc565b6104f68363a9059cbb60e01b8484604051602401610ca6929190611304565b6000610d51826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316610dd19092919063ffffffff16565b9050805160001480610d72575080806020019051810190610d72919061136e565b6104f65760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b60648201526084016102f7565b6060610de08484600085610de8565b949350505050565b606082471015610e495760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b60648201526084016102f7565b600080866001600160a01b03168587604051610e659190611390565b60006040518083038185875af1925050503d8060008114610ea2576040519150601f19603f3d011682016040523d82523d6000602084013e610ea7565b606091505b5091509150610eb887838387610ec3565b979650505050505050565b60608315610f32578251600003610f2b576001600160a01b0385163b610f2b5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016102f7565b5081610de0565b610de08383815115610f475781518083602001fd5b8060405162461bcd60e51b81526004016102f791906113ac565b6001600160a01b0381168114610f7657600080fd5b50565b600080600080600060a08688031215610f9157600080fd5b8535610f9c81610f61565b94506020860135610fac81610f61565b93506040860135610fbc81610f61565b92506060860135610fcc81610f61565b91506080860135610fdc81610f61565b809150509295509295909350565b60008060408385031215610ffd57600080fd5b823561100881610f61565b946020939093013593505050565b60006020828403121561102857600080fd5b813561103381610f61565b9392505050565b60008060006060848603121561104f57600080fd5b833561105a81610f61565b9250602084013561106a81610f61565b929592945050506040919091013590565b6000806000806060858703121561109157600080fd5b8435935060208501356110a381610f61565b9250604085013567ffffffffffffffff808211156110c057600080fd5b818701915087601f8301126110d457600080fd5b8135818111156110e357600080fd5b8860208285010111156110f557600080fd5b95989497505060200194505050565b6000808585111561111457600080fd5b8386111561112157600080fd5b5050820193919092039150565b8035602083101561114757600019602084900360031b1b165b92915050565b634e487b7160e01b600052604160045260246000fd5b60005b8381101561117e578181015183820152602001611166565b50506000910152565b60006020828403121561119957600080fd5b815167ffffffffffffffff808211156111b157600080fd5b818401915084601f8301126111c557600080fd5b8151818111156111d7576111d761114d565b604051601f8201601f19908116603f011681019083821181831017156111ff576111ff61114d565b8160405282815287602084870101111561121857600080fd5b610eb8836020830160208801611163565b60006020828403121561123b57600080fd5b815160ff8116811461103357600080fd5b60008151808452611264816020860160208601611163565b601f01601f19169290920160200192915050565b8581526001600160a01b038516602082015260a0604082018190526000906112a29083018661124c565b82810360608401526112b4818661124c565b91505060ff831660808301529695505050505050565b6001600160a01b0383168152604060208201819052600090610de09083018461124c565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b6000806000806080858703121561133357600080fd5b843561133e81610f61565b9350602085013561134e81610f61565b9250604085013561135e81610f61565b9396929550929360600135925050565b60006020828403121561138057600080fd5b8151801515811461103357600080fd5b600082516113a2818460208701611163565b9190910192915050565b602081526000611033602083018461124c56fea2646970667358221220b638ab862c775779ca46f64f41fce11a25a259733849faf11ead45e4637ff9b964736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100ca5760003560e01c8063cb10f94c1161007c578063cb10f94c146101ab578063d41f1771146101c4578063d57184e4146101eb578063f213159c146101fe578063f43cda8b14610211578063f4a120f714610224578063f64512551461023757600080fd5b80631459457a146100cf57806347e7ef24146100e45780636a00c1d7146100f75780637efab4f51461012757806395c7041c14610150578063b176806514610163578063b68ad1e414610198575b600080fd5b6100e26100dd366004610f79565b61025e565b005b6100e26100f2366004610fea565b6104dc565b60055461010a906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b61010a610135366004611016565b6004602052600090815260409020546001600160a01b031681565b60015461010a906001600160a01b031681565b61018a7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60405190815260200161011e565b60035461010a906001600160a01b031681565b60005461010a906201000090046001600160a01b031681565b61018a7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b60025461010a906001600160a01b031681565b6100e261020c36600461103a565b6104eb565b6100e261021f36600461107b565b6104fb565b61010a610232366004611016565b610682565b61018a7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b600054610100900460ff161580801561027e5750600054600160ff909116105b806102985750303b158015610298575060005460ff166001145b6103005760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084015b60405180910390fd5b6000805460ff191660011790558015610323576000805461ff0019166101001790555b6001600160a01b0386161580159061034357506001600160a01b03851615155b801561035757506001600160a01b03841615155b801561036b57506001600160a01b03831615155b6103c65760405162461bcd60e51b815260206004820152602660248201527f526f6f7445524332305072656469636174653a204241445f494e495449414c496044820152652d20aa24a7a760d11b60648201526084016102f7565b6000805462010000600160b01b031916620100006001600160a01b038981169190910291909117909155600180546001600160a01b0319908116888416179091556002805482168784161790556003805490911685831617905582161561048e57600580546001600160a01b03199081166001600160a01b038581169182178455600091825260046020526040808320805461101095168517905593549351929316917f85920d35e6c72f6b2affffa04298b0cecfeba86e4a9f407df661f1cb8ab5e6179190a35b80156104d4576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b6104e7823383610a43565b5050565b6104f6838383610a43565b505050565b6001546001600160a01b031633146105615760405162461bcd60e51b8152602060048201526024808201527f526f6f7445524332305072656469636174653a204f4e4c595f455849545f4845604482015263262822a960e11b60648201526084016102f7565b6002546001600160a01b038481169116146105cf5760405162461bcd60e51b815260206004820152602860248201527f526f6f7445524332305072656469636174653a204f4e4c595f4348494c445f50604482015267524544494341544560c01b60648201526084016102f7565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e9828696105fe602060008486611104565b6106079161112e565b036106265761062161061c8260208186611104565b610bba565b61067c565b60405162461bcd60e51b815260206004820152602560248201527f526f6f7445524332305072656469636174653a20494e56414c49445f5349474e604482015264415455524560d81b60648201526084016102f7565b50505050565b60006001600160a01b0382166106e45760405162461bcd60e51b815260206004820152602160248201527f526f6f7445524332305072656469636174653a20494e56414c49445f544f4b456044820152602760f91b60648201526084016102f7565b6001600160a01b0382811660009081526004602052604090205416156107575760405162461bcd60e51b815260206004820152602260248201527f526f6f7445524332305072656469636174653a20414c52454144595f4d415050604482015261115160f21b60648201526084016102f7565b6002546003546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b039283169260009261080592911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b03858116600081815260046020819052604080832080546001600160a01b031916878716179055825481516306fdde0360e01b81529151969750620100009004909416946316f198319488947f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad948c9491936306fdde039380840193908290030181865afa1580156108a2573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526108ca9190810190611187565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610908573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526109309190810190611187565b8a6001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa15801561096e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109929190611229565b6040516020016109a6959493929190611278565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016109d29291906112ca565b600060405180830381600087803b1580156109ec57600080fd5b505af1158015610a00573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f85920d35e6c72f6b2affffa04298b0cecfeba86e4a9f407df661f1cb8ab5e61790600090a39392505050565b6001600160a01b038084166000908152600460205260409020541680610a6f57610a6c84610682565b90505b6001600160a01b038116610a8557610a856112ee565b610a9a6001600160a01b038516333085610c72565b600054600254604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b0388811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352620100009094048416936316f1983193610b2b9391169160c4016112ca565b600060405180830381600087803b158015610b4557600080fd5b505af1158015610b59573d6000803e3d6000fd5b50505050826001600160a01b0316816001600160a01b0316856001600160a01b03167f8be9001bb612c7123a1861dc0d9d94e683261f6cbbd7c7438b708975bc4908a33386604051610bac929190611304565b60405180910390a450505050565b6000808080610bcb8587018761131d565b6001600160a01b0380851660009081526004602052604090205494985092965090945092501680610bfe57610bfe6112ee565b610c126001600160a01b0386168484610cdd565b826001600160a01b0316816001600160a01b0316866001600160a01b03167f9c4f744b2e971d7058a9d8f43977e0e17bf7d57a48659f0e18541b7ee3d022e48786604051610c61929190611304565b60405180910390a450505050505050565b6040516001600160a01b038085166024830152831660448201526064810182905261067c9085906323b872dd60e01b906084015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152610cfc565b6104f68363a9059cbb60e01b8484604051602401610ca6929190611304565b6000610d51826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316610dd19092919063ffffffff16565b9050805160001480610d72575080806020019051810190610d72919061136e565b6104f65760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b60648201526084016102f7565b6060610de08484600085610de8565b949350505050565b606082471015610e495760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b60648201526084016102f7565b600080866001600160a01b03168587604051610e659190611390565b60006040518083038185875af1925050503d8060008114610ea2576040519150601f19603f3d011682016040523d82523d6000602084013e610ea7565b606091505b5091509150610eb887838387610ec3565b979650505050505050565b60608315610f32578251600003610f2b576001600160a01b0385163b610f2b5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016102f7565b5081610de0565b610de08383815115610f475781518083602001fd5b8060405162461bcd60e51b81526004016102f791906113ac565b6001600160a01b0381168114610f7657600080fd5b50565b600080600080600060a08688031215610f9157600080fd5b8535610f9c81610f61565b94506020860135610fac81610f61565b93506040860135610fbc81610f61565b92506060860135610fcc81610f61565b91506080860135610fdc81610f61565b809150509295509295909350565b60008060408385031215610ffd57600080fd5b823561100881610f61565b946020939093013593505050565b60006020828403121561102857600080fd5b813561103381610f61565b9392505050565b60008060006060848603121561104f57600080fd5b833561105a81610f61565b9250602084013561106a81610f61565b929592945050506040919091013590565b6000806000806060858703121561109157600080fd5b8435935060208501356110a381610f61565b9250604085013567ffffffffffffffff808211156110c057600080fd5b818701915087601f8301126110d457600080fd5b8135818111156110e357600080fd5b8860208285010111156110f557600080fd5b95989497505060200194505050565b6000808585111561111457600080fd5b8386111561112157600080fd5b5050820193919092039150565b8035602083101561114757600019602084900360031b1b165b92915050565b634e487b7160e01b600052604160045260246000fd5b60005b8381101561117e578181015183820152602001611166565b50506000910152565b60006020828403121561119957600080fd5b815167ffffffffffffffff808211156111b157600080fd5b818401915084601f8301126111c557600080fd5b8151818111156111d7576111d761114d565b604051601f8201601f19908116603f011681019083821181831017156111ff576111ff61114d565b8160405282815287602084870101111561121857600080fd5b610eb8836020830160208801611163565b60006020828403121561123b57600080fd5b815160ff8116811461103357600080fd5b60008151808452611264816020860160208601611163565b601f01601f19169290920160200192915050565b8581526001600160a01b038516602082015260a0604082018190526000906112a29083018661124c565b82810360608401526112b4818661124c565b91505060ff831660808301529695505050505050565b6001600160a01b0383168152604060208201819052600090610de09083018461124c565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b6000806000806080858703121561133357600080fd5b843561133e81610f61565b9350602085013561134e81610f61565b9250604085013561135e81610f61565b9396929550929360600135925050565b60006020828403121561138057600080fd5b8151801515811461103357600080fd5b600082516113a2818460208701611163565b9190910192915050565b602081526000611033602083018461124c56fea2646970667358221220b638ab862c775779ca46f64f41fce11a25a259733849faf11ead45e4637ff9b964736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildMintableERC20PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildMintableERC20Predicate","sourceName":"contracts/root/ChildMintableERC20Predicate.sol","abi":[{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"MintableERC20Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"MintableERC20Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"MintableTokenMapped","type":"event"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"exitHelper","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newStateSender","type":"address"},{"internalType":"address","name":"newExitHelper","type":"address"},{"internalType":"address","name":"newRootERC20Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onL2StateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootERC20Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IChildERC20","name":"childToken","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC20","name":"childToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b506113c8806100206000396000f3fe608060405234801561001057600080fd5b50600436106100b45760003560e01c8063cb10f94c11610071578063cb10f94c14610182578063d41f17711461019b578063f3fef3a3146101c2578063f43cda8b146101d5578063f6451255146101e8578063f8c8765e1461020f57600080fd5b806371cf93b7146100b95780637efab4f5146100e957806395c7041c14610112578063b176806514610125578063b68ad1e41461015a578063c3b35a7e1461016d575b600080fd5b6002546100cc906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6100cc6100f7366004610ecf565b6004602052600090815260409020546001600160a01b031681565b6001546100cc906001600160a01b031681565b61014c7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b6040519081526020016100e0565b6003546100cc906001600160a01b031681565b61018061017b366004610ef3565b610222565b005b6000546100cc906201000090046001600160a01b031681565b61014c7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101806101d0366004610f34565b610232565b6101806101e3366004610f60565b610241565b61014c7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61018061021d366004610fe9565b610432565b61022d83838361054b565b505050565b61023d82338361054b565b5050565b6001546001600160a01b031633146102b95760405162461bcd60e51b815260206004820152603060248201527f4368696c644d696e7461626c6545524332305072656469636174653a204f4e4c60448201526f2cafa9aa20aa22afa922a1a2a4ab22a960811b60648201526084015b60405180910390fd5b6002546001600160a01b0384811691161461032f5760405162461bcd60e51b815260206004820152603060248201527f4368696c644d696e7461626c6545524332305072656469636174653a204f4e4c60448201526f595f524f4f545f50524544494341544560801b60648201526084016102b0565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82161035e602060008486611045565b6103679161106f565b036103865761038161037c8260208186611045565b6108e0565b61042c565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6103b5602060008486611045565b6103be9161106f565b036103cd576103818282610b9c565b60405162461bcd60e51b815260206004820152602e60248201527f4368696c644d696e7461626c6545524332305072656469636174653a20494e5660448201526d414c49445f5349474e415455524560901b60648201526084016102b0565b50505050565b600054610100900460ff16158080156104525750600054600160ff909116105b8061046c5750303b15801561046c575060005460ff166001145b6104cf5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016102b0565b6000805460ff1916600117905580156104f2576000805461ff0019166101001790555b6104fe85858585610d13565b8015610544576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b826001600160a01b03163b6000036105b75760405162461bcd60e51b815260206004820152602960248201527f4368696c644d696e7461626c6545524332305072656469636174653a204e4f5460448201526817d0d3d395149050d560ba1b60648201526084016102b0565b6000836001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156105f7573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061061b919061108d565b6001600160a01b0381811660009081526004602052604090205491925085811691161461065a5760405162461bcd60e51b81526004016102b0906110aa565b6001600160a01b038116610670576106706110f5565b306001600160a01b0316846001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156106b8573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906106dc919061108d565b6001600160a01b0316146106f2576106f26110f5565b604051632770a7eb60e21b81526001600160a01b03851690639dc29fac90610720903390869060040161110b565b6020604051808303816000875af115801561073f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107639190611124565b6107c05760405162461bcd60e51b815260206004820152602860248201527f4368696c644d696e7461626c6545524332305072656469636174653a204255526044820152671397d1905253115160c21b60648201526084016102b0565b600054600254604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352620100009094048416936316f19831936108519391169160c40161118c565b600060405180830381600087803b15801561086b57600080fd5b505af115801561087f573d6000803e3d6000fd5b50505050826001600160a01b0316846001600160a01b0316826001600160a01b03167f1da92ba31d15f9af529a2efe7acebc6c0a4ac8e9cd86a84f199a474e505d77a633866040516108d292919061110b565b60405180910390a450505050565b60008080806108f1858701876111b8565b6001600160a01b03808516600090815260046020526040902054949850929650909450925016806109345760405162461bcd60e51b81526004016102b0906110aa565b806001600160a01b03163b60000361094e5761094e6110f5565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561098e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109b2919061108d565b9050856001600160a01b0316816001600160a01b0316146109d5576109d56110f5565b6001600160a01b0381166109eb576109eb6110f5565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a33573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a57919061108d565b6001600160a01b031614610a6d57610a6d6110f5565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610a9b908790879060040161110b565b6020604051808303816000875af1158015610aba573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ade9190611124565b610b3b5760405162461bcd60e51b815260206004820152602860248201527f4368696c644d696e7461626c6545524332305072656469636174653a204d494e6044820152671517d1905253115160c21b60648201526084016102b0565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fcf47ccd68b2113d6309d8d504a67c10963dc0bfbf2416e4726a316511cca27b58887604051610b8a92919061110b565b60405180910390a45050505050505050565b6000808080610bad858701876112ac565b92975090955093509150506001600160a01b038416610bce57610bce6110f5565b6001600160a01b038481166000908152600460205260409020541615610bf657610bf66110f5565b6003546040516bffffffffffffffffffffffff19606087901b166020820152600091610c46916001600160a01b039091169060340160405160208183030381529060405280519060200120610e1a565b6001600160a01b0386811660009081526004602081905260409182902080546001600160a01b03191693851693841790559051637b69774360e11b8152929350909163f6d2ee8691610ca091899189918991899101611347565b600060405180830381600087803b158015610cba57600080fd5b505af1158015610cce573d6000803e3d6000fd5b50506040516001600160a01b038085169350881691507f0a1eaf9aa124c3f84c9dd77f7016af0f16f67639abb913af1697387db01f5ca590600090a350505050505050565b6001600160a01b03841615801590610d3357506001600160a01b03831615155b8015610d4757506001600160a01b03821615155b8015610d5b57506001600160a01b03811615155b610dbf5760405162461bcd60e51b815260206004820152602f60248201527f4368696c644d696e7461626c6545524332305072656469636174653a2042414460448201526e2fa4a724aa24a0a624ad20aa24a7a760891b60648201526084016102b0565b600080546001600160a01b03958616620100000262010000600160b01b0319909116179055600180549385166001600160a01b0319948516179055600280549285169284169290921790915560038054919093169116179055565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116610eb15760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016102b0565b92915050565b6001600160a01b0381168114610ecc57600080fd5b50565b600060208284031215610ee157600080fd5b8135610eec81610eb7565b9392505050565b600080600060608486031215610f0857600080fd5b8335610f1381610eb7565b92506020840135610f2381610eb7565b929592945050506040919091013590565b60008060408385031215610f4757600080fd5b8235610f5281610eb7565b946020939093013593505050565b60008060008060608587031215610f7657600080fd5b843593506020850135610f8881610eb7565b9250604085013567ffffffffffffffff80821115610fa557600080fd5b818701915087601f830112610fb957600080fd5b813581811115610fc857600080fd5b886020828501011115610fda57600080fd5b95989497505060200194505050565b60008060008060808587031215610fff57600080fd5b843561100a81610eb7565b9350602085013561101a81610eb7565b9250604085013561102a81610eb7565b9150606085013561103a81610eb7565b939692955090935050565b6000808585111561105557600080fd5b8386111561106257600080fd5b5050820193919092039150565b80356020831015610eb157600019602084900360031b1b1692915050565b60006020828403121561109f57600080fd5b8151610eec81610eb7565b6020808252602b908201527f4368696c644d696e7461626c6545524332305072656469636174653a20554e4d60408201526a20a82822a22faa27a5a2a760a91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b60006020828403121561113657600080fd5b81518015158114610eec57600080fd5b6000815180845260005b8181101561116c57602081850181015186830182015201611150565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b03831681526040602082018190526000906111b090830184611146565b949350505050565b600080600080608085870312156111ce57600080fd5b84356111d981610eb7565b935060208501356111e981610eb7565b925060408501356111f981610eb7565b9396929550929360600135925050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261123057600080fd5b813567ffffffffffffffff8082111561124b5761124b611209565b604051601f8301601f19908116603f0116810190828211818310171561127357611273611209565b8160405283815286602085880101111561128c57600080fd5b836020870160208301376000602085830101528094505050505092915050565b600080600080600060a086880312156112c457600080fd5b8535945060208601356112d681610eb7565b9350604086013567ffffffffffffffff808211156112f357600080fd5b6112ff89838a0161121f565b9450606088013591508082111561131557600080fd5b506113228882890161121f565b925050608086013560ff8116811461133957600080fd5b809150509295509295909350565b6001600160a01b038516815260806020820181905260009061136b90830186611146565b828103604084015261137d8186611146565b91505060ff831660608301529594505050505056fea264697066735822122087775fa0c83774cca5f812d4bf60fa4ef351e7b816104e4edbe586babc84517664736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100b45760003560e01c8063cb10f94c11610071578063cb10f94c14610182578063d41f17711461019b578063f3fef3a3146101c2578063f43cda8b146101d5578063f6451255146101e8578063f8c8765e1461020f57600080fd5b806371cf93b7146100b95780637efab4f5146100e957806395c7041c14610112578063b176806514610125578063b68ad1e41461015a578063c3b35a7e1461016d575b600080fd5b6002546100cc906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6100cc6100f7366004610ecf565b6004602052600090815260409020546001600160a01b031681565b6001546100cc906001600160a01b031681565b61014c7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b6040519081526020016100e0565b6003546100cc906001600160a01b031681565b61018061017b366004610ef3565b610222565b005b6000546100cc906201000090046001600160a01b031681565b61014c7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101806101d0366004610f34565b610232565b6101806101e3366004610f60565b610241565b61014c7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61018061021d366004610fe9565b610432565b61022d83838361054b565b505050565b61023d82338361054b565b5050565b6001546001600160a01b031633146102b95760405162461bcd60e51b815260206004820152603060248201527f4368696c644d696e7461626c6545524332305072656469636174653a204f4e4c60448201526f2cafa9aa20aa22afa922a1a2a4ab22a960811b60648201526084015b60405180910390fd5b6002546001600160a01b0384811691161461032f5760405162461bcd60e51b815260206004820152603060248201527f4368696c644d696e7461626c6545524332305072656469636174653a204f4e4c60448201526f595f524f4f545f50524544494341544560801b60648201526084016102b0565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82161035e602060008486611045565b6103679161106f565b036103865761038161037c8260208186611045565b6108e0565b61042c565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6103b5602060008486611045565b6103be9161106f565b036103cd576103818282610b9c565b60405162461bcd60e51b815260206004820152602e60248201527f4368696c644d696e7461626c6545524332305072656469636174653a20494e5660448201526d414c49445f5349474e415455524560901b60648201526084016102b0565b50505050565b600054610100900460ff16158080156104525750600054600160ff909116105b8061046c5750303b15801561046c575060005460ff166001145b6104cf5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016102b0565b6000805460ff1916600117905580156104f2576000805461ff0019166101001790555b6104fe85858585610d13565b8015610544576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b826001600160a01b03163b6000036105b75760405162461bcd60e51b815260206004820152602960248201527f4368696c644d696e7461626c6545524332305072656469636174653a204e4f5460448201526817d0d3d395149050d560ba1b60648201526084016102b0565b6000836001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156105f7573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061061b919061108d565b6001600160a01b0381811660009081526004602052604090205491925085811691161461065a5760405162461bcd60e51b81526004016102b0906110aa565b6001600160a01b038116610670576106706110f5565b306001600160a01b0316846001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156106b8573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906106dc919061108d565b6001600160a01b0316146106f2576106f26110f5565b604051632770a7eb60e21b81526001600160a01b03851690639dc29fac90610720903390869060040161110b565b6020604051808303816000875af115801561073f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107639190611124565b6107c05760405162461bcd60e51b815260206004820152602860248201527f4368696c644d696e7461626c6545524332305072656469636174653a204255526044820152671397d1905253115160c21b60648201526084016102b0565b600054600254604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352620100009094048416936316f19831936108519391169160c40161118c565b600060405180830381600087803b15801561086b57600080fd5b505af115801561087f573d6000803e3d6000fd5b50505050826001600160a01b0316846001600160a01b0316826001600160a01b03167f1da92ba31d15f9af529a2efe7acebc6c0a4ac8e9cd86a84f199a474e505d77a633866040516108d292919061110b565b60405180910390a450505050565b60008080806108f1858701876111b8565b6001600160a01b03808516600090815260046020526040902054949850929650909450925016806109345760405162461bcd60e51b81526004016102b0906110aa565b806001600160a01b03163b60000361094e5761094e6110f5565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561098e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109b2919061108d565b9050856001600160a01b0316816001600160a01b0316146109d5576109d56110f5565b6001600160a01b0381166109eb576109eb6110f5565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a33573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a57919061108d565b6001600160a01b031614610a6d57610a6d6110f5565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610a9b908790879060040161110b565b6020604051808303816000875af1158015610aba573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ade9190611124565b610b3b5760405162461bcd60e51b815260206004820152602860248201527f4368696c644d696e7461626c6545524332305072656469636174653a204d494e6044820152671517d1905253115160c21b60648201526084016102b0565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fcf47ccd68b2113d6309d8d504a67c10963dc0bfbf2416e4726a316511cca27b58887604051610b8a92919061110b565b60405180910390a45050505050505050565b6000808080610bad858701876112ac565b92975090955093509150506001600160a01b038416610bce57610bce6110f5565b6001600160a01b038481166000908152600460205260409020541615610bf657610bf66110f5565b6003546040516bffffffffffffffffffffffff19606087901b166020820152600091610c46916001600160a01b039091169060340160405160208183030381529060405280519060200120610e1a565b6001600160a01b0386811660009081526004602081905260409182902080546001600160a01b03191693851693841790559051637b69774360e11b8152929350909163f6d2ee8691610ca091899189918991899101611347565b600060405180830381600087803b158015610cba57600080fd5b505af1158015610cce573d6000803e3d6000fd5b50506040516001600160a01b038085169350881691507f0a1eaf9aa124c3f84c9dd77f7016af0f16f67639abb913af1697387db01f5ca590600090a350505050505050565b6001600160a01b03841615801590610d3357506001600160a01b03831615155b8015610d4757506001600160a01b03821615155b8015610d5b57506001600160a01b03811615155b610dbf5760405162461bcd60e51b815260206004820152602f60248201527f4368696c644d696e7461626c6545524332305072656469636174653a2042414460448201526e2fa4a724aa24a0a624ad20aa24a7a760891b60648201526084016102b0565b600080546001600160a01b03958616620100000262010000600160b01b0319909116179055600180549385166001600160a01b0319948516179055600280549285169284169290921790915560038054919093169116179055565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116610eb15760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016102b0565b92915050565b6001600160a01b0381168114610ecc57600080fd5b50565b600060208284031215610ee157600080fd5b8135610eec81610eb7565b9392505050565b600080600060608486031215610f0857600080fd5b8335610f1381610eb7565b92506020840135610f2381610eb7565b929592945050506040919091013590565b60008060408385031215610f4757600080fd5b8235610f5281610eb7565b946020939093013593505050565b60008060008060608587031215610f7657600080fd5b843593506020850135610f8881610eb7565b9250604085013567ffffffffffffffff80821115610fa557600080fd5b818701915087601f830112610fb957600080fd5b813581811115610fc857600080fd5b886020828501011115610fda57600080fd5b95989497505060200194505050565b60008060008060808587031215610fff57600080fd5b843561100a81610eb7565b9350602085013561101a81610eb7565b9250604085013561102a81610eb7565b9150606085013561103a81610eb7565b939692955090935050565b6000808585111561105557600080fd5b8386111561106257600080fd5b5050820193919092039150565b80356020831015610eb157600019602084900360031b1b1692915050565b60006020828403121561109f57600080fd5b8151610eec81610eb7565b6020808252602b908201527f4368696c644d696e7461626c6545524332305072656469636174653a20554e4d60408201526a20a82822a22faa27a5a2a760a91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b60006020828403121561113657600080fd5b81518015158114610eec57600080fd5b6000815180845260005b8181101561116c57602081850181015186830182015201611150565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b03831681526040602082018190526000906111b090830184611146565b949350505050565b600080600080608085870312156111ce57600080fd5b84356111d981610eb7565b935060208501356111e981610eb7565b925060408501356111f981610eb7565b9396929550929360600135925050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261123057600080fd5b813567ffffffffffffffff8082111561124b5761124b611209565b604051601f8301601f19908116603f0116810190828211818310171561127357611273611209565b8160405283815286602085880101111561128c57600080fd5b836020870160208301376000602085830101528094505050505092915050565b600080600080600060a086880312156112c457600080fd5b8535945060208601356112d681610eb7565b9350604086013567ffffffffffffffff808211156112f357600080fd5b6112ff89838a0161121f565b9450606088013591508082111561131557600080fd5b506113228882890161121f565b925050608086013560ff8116811461133957600080fd5b809150509295509295909350565b6001600160a01b038516815260806020820181905260009061136b90830186611146565b828103604084015261137d8186611146565b91505060ff831660608301529594505050505056fea264697066735822122087775fa0c83774cca5f812d4bf60fa4ef351e7b816104e4edbe586babc84517664736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var MockERC721Artifact string = `{"_format":"hh-sol-artifact-1","contractName":"MockERC721","sourceName":"contracts/mocks/MockERC721.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MINTER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"PAUSER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"index","type":"uint256"}],"name":"tokenByIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"tokenOfOwnerByIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x60806040523480156200001157600080fd5b5060405180604001604052806004815260200163151154d560e21b81525060405180604001604052806004815260200163151154d560e21b815250604051806040016040528060058152602001646c6f72656d60d81b815250828281600290816200007d919062000307565b5060036200008c828262000307565b5050600c805460ff1916905550600e620000a7828262000307565b50620000b560003362000116565b620000e17f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a63362000116565b6200010d7f65d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440d862a3362000116565b505050620003d3565b62000122828262000126565b5050565b62000132828262000151565b60008281526001602052604090206200014c9082620001f1565b505050565b6000828152602081815260408083206001600160a01b038516845290915290205460ff1662000122576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055620001ad3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b600062000208836001600160a01b03841662000211565b90505b92915050565b60008181526001830160205260408120546200025a575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556200020b565b5060006200020b565b634e487b7160e01b600052604160045260246000fd5b600181811c908216806200028e57607f821691505b602082108103620002af57634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156200014c57600081815260208120601f850160051c81016020861015620002de5750805b601f850160051c820191505b81811015620002ff57828155600101620002ea565b505050505050565b81516001600160401b0381111562000323576200032362000263565b6200033b8162000334845462000279565b84620002b5565b602080601f8311600181146200037357600084156200035a5750858301515b600019600386901b1c1916600185901b178555620002ff565b600085815260208120601f198616915b82811015620003a45788860151825594840194600190910190840162000383565b5085821015620003c35787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b61244180620003e36000396000f3fe608060405234801561001057600080fd5b50600436106101a55760003560e01c80636352211e116100ef578063a22cb46511610092578063a22cb4651461036b578063b88d4fde1461037e578063c87b56dd14610391578063ca15c873146103a4578063d5391393146103b7578063d547741f146103de578063e63ab1e9146103f1578063e985e9c51461040657600080fd5b80636352211e146102f45780636a6278421461030757806370a082311461031a5780638456cb591461032d5780639010d07c1461033557806391d148541461034857806395d89b411461035b578063a217fddf1461036357600080fd5b80632f2ff15d116101575780632f2ff15d1461026f5780632f745c591461028257806336568abe146102955780633f4ba83a146102a857806342842e0e146102b057806342966c68146102c35780634f6ccce7146102d65780635c975abb146102e957600080fd5b806301ffc9a7146101aa57806306fdde03146101d2578063081812fc146101e7578063095ea7b31461021257806318160ddd1461022757806323b872dd14610239578063248a9ca31461024c575b600080fd5b6101bd6101b8366004611dba565b610419565b60405190151581526020015b60405180910390f35b6101da61042a565b6040516101c99190611e27565b6101fa6101f5366004611e3a565b6104bc565b6040516001600160a01b0390911681526020016101c9565b610225610220366004611e6f565b6104e3565b005b600a545b6040519081526020016101c9565b610225610247366004611e99565b6105fd565b61022b61025a366004611e3a565b60009081526020819052604090206001015490565b61022561027d366004611ed5565b61062f565b61022b610290366004611e6f565b610654565b6102256102a3366004611ed5565b6106ea565b610225610768565b6102256102be366004611e99565b6107ec565b6102256102d1366004611e3a565b610807565b61022b6102e4366004611e3a565b610838565b600c5460ff166101bd565b6101fa610302366004611e3a565b6108cb565b610225610315366004611f01565b610900565b61022b610328366004611f01565b6109aa565b610225610a30565b6101fa610343366004611f1c565b610ab0565b6101bd610356366004611ed5565b610acf565b6101da610af8565b61022b600081565b610225610379366004611f3e565b610b07565b61022561038c366004611f90565b610b12565b6101da61039f366004611e3a565b610b4a565b61022b6103b2366004611e3a565b610bb0565b61022b7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a681565b6102256103ec366004611ed5565b610bc7565b61022b6000805160206123ac83398151915281565b6101bd61041436600461206c565b610bec565b600061042482610c1a565b92915050565b60606002805461043990612096565b80601f016020809104026020016040519081016040528092919081815260200182805461046590612096565b80156104b25780601f10610487576101008083540402835291602001916104b2565b820191906000526020600020905b81548152906001019060200180831161049557829003601f168201915b5050505050905090565b60006104c782610c3f565b506000908152600660205260409020546001600160a01b031690565b60006104ee826108cb565b9050806001600160a01b0316836001600160a01b0316036105605760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084015b60405180910390fd5b336001600160a01b038216148061057c575061057c8133610bec565b6105ee5760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000006064820152608401610557565b6105f88383610c64565b505050565b610608335b82610cd2565b6106245760405162461bcd60e51b8152600401610557906120d0565b6105f8838383610d31565b60008281526020819052604090206001015461064a81610e90565b6105f88383610e9a565b600061065f836109aa565b82106106c15760405162461bcd60e51b815260206004820152602b60248201527f455243373231456e756d657261626c653a206f776e657220696e646578206f7560448201526a74206f6620626f756e647360a81b6064820152608401610557565b506001600160a01b03919091166000908152600860209081526040808320938352929052205490565b6001600160a01b038116331461075a5760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608401610557565b6107648282610ebc565b5050565b6107806000805160206123ac83398151915233610acf565b6107e2576040805162461bcd60e51b81526020600482015260248101919091526000805160206123ec83398151915260448201527f6d75737420686176652070617573657220726f6c6520746f20756e70617573656064820152608401610557565b6107ea610ede565b565b6105f883838360405180602001604052806000815250610b12565b61081033610602565b61082c5760405162461bcd60e51b8152600401610557906120d0565b61083581610f30565b50565b6000610843600a5490565b82106108a65760405162461bcd60e51b815260206004820152602c60248201527f455243373231456e756d657261626c653a20676c6f62616c20696e646578206f60448201526b7574206f6620626f756e647360a01b6064820152608401610557565b600a82815481106108b9576108b961211d565b90600052602060002001549050919050565b6000818152600460205260408120546001600160a01b0316806104245760405162461bcd60e51b815260040161055790612133565b61092a7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a633610acf565b61098a5760405162461bcd60e51b815260206004820152603d60248201526000805160206123ec83398151915260448201527f6d7573742068617665206d696e74657220726f6c6520746f206d696e740000006064820152608401610557565b61099c81610997600d5490565b610fc1565b610835600d80546001019055565b60006001600160a01b038216610a145760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b6064820152608401610557565b506001600160a01b031660009081526005602052604090205490565b610a486000805160206123ac83398151915233610acf565b610aa85760405162461bcd60e51b815260206004820152603e60248201526000805160206123ec83398151915260448201527f6d75737420686176652070617573657220726f6c6520746f20706175736500006064820152608401610557565b6107ea6110ca565b6000828152600160205260408120610ac89083611107565b9392505050565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b60606003805461043990612096565b610764338383611113565b610b1c3383610cd2565b610b385760405162461bcd60e51b8152600401610557906120d0565b610b44848484846111dd565b50505050565b6060610b5582610c3f565b6000610b5f611210565b90506000815111610b7f5760405180602001604052806000815250610ac8565b80610b898461121f565b604051602001610b9a929190612165565b6040516020818303038152906040529392505050565b6000818152600160205260408120610424906112b2565b600082815260208190526040902060010154610be281610e90565b6105f88383610ebc565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b60006001600160e01b0319821663780e9d6360e01b14806104245750610424826112bc565b610c48816112fc565b6108355760405162461bcd60e51b815260040161055790612133565b600081815260066020526040902080546001600160a01b0319166001600160a01b0384169081179091558190610c99826108cb565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b600080610cde836108cb565b9050806001600160a01b0316846001600160a01b03161480610d055750610d058185610bec565b80610d295750836001600160a01b0316610d1e846104bc565b6001600160a01b0316145b949350505050565b826001600160a01b0316610d44826108cb565b6001600160a01b031614610d6a5760405162461bcd60e51b815260040161055790612194565b6001600160a01b038216610dcc5760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b6064820152608401610557565b610dd98383836001611319565b826001600160a01b0316610dec826108cb565b6001600160a01b031614610e125760405162461bcd60e51b815260040161055790612194565b600081815260066020908152604080832080546001600160a01b03199081169091556001600160a01b0387811680865260058552838620805460001901905590871680865283862080546001019055868652600490945282852080549092168417909155905184936000805160206123cc83398151915291a4505050565b6108358133611325565b610ea4828261137e565b60008281526001602052604090206105f89082611402565b610ec68282611417565b60008281526001602052604090206105f8908261147c565b610ee6611491565b600c805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6000610f3b826108cb565b9050610f4b816000846001611319565b610f54826108cb565b600083815260066020908152604080832080546001600160a01b03199081169091556001600160a01b0385168085526005845282852080546000190190558785526004909352818420805490911690555192935084926000805160206123cc833981519152908390a45050565b6001600160a01b0382166110175760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f20616464726573736044820152606401610557565b611020816112fc565b1561103d5760405162461bcd60e51b8152600401610557906121d9565b61104b600083836001611319565b611054816112fc565b156110715760405162461bcd60e51b8152600401610557906121d9565b6001600160a01b038216600081815260056020908152604080832080546001019055848352600490915280822080546001600160a01b0319168417905551839291906000805160206123cc833981519152908290a45050565b6110d26114da565b600c805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610f133390565b6000610ac88383611520565b816001600160a01b0316836001600160a01b0316036111705760405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b6044820152606401610557565b6001600160a01b03838116600081815260076020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6111e8848484610d31565b6111f48484848461154a565b610b445760405162461bcd60e51b815260040161055790612210565b6060600e805461043990612096565b6060600061122c8361164b565b600101905060008167ffffffffffffffff81111561124c5761124c611f7a565b6040519080825280601f01601f191660200182016040528015611276576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461128057509392505050565b6000610424825490565b60006001600160e01b031982166380ac58cd60e01b14806112ed57506001600160e01b03198216635b5e139f60e01b145b80610424575061042482611723565b6000908152600460205260409020546001600160a01b0316151590565b610b4484848484611748565b61132f8282610acf565b6107645761133c816117bb565b6113478360206117cd565b604051602001611358929190612262565b60408051601f198184030181529082905262461bcd60e51b825261055791600401611e27565b6113888282610acf565b610764576000828152602081815260408083206001600160a01b03851684529091529020805460ff191660011790556113be3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000610ac8836001600160a01b038416611969565b6114218282610acf565b15610764576000828152602081815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000610ac8836001600160a01b0384166119b8565b600c5460ff166107ea5760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610557565b600c5460ff16156107ea5760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610557565b60008260000182815481106115375761153761211d565b9060005260206000200154905092915050565b60006001600160a01b0384163b1561164057604051630a85bd0160e11b81526001600160a01b0385169063150b7a029061158e9033908990889088906004016122d1565b6020604051808303816000875af19250505080156115c9575060408051601f3d908101601f191682019092526115c69181019061230e565b60015b611626573d8080156115f7576040519150601f19603f3d011682016040523d82523d6000602084013e6115fc565b606091505b50805160000361161e5760405162461bcd60e51b815260040161055790612210565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050610d29565b506001949350505050565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b831061168a5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef810000000083106116b6576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc1000083106116d457662386f26fc10000830492506010015b6305f5e10083106116ec576305f5e100830492506008015b612710831061170057612710830492506004015b60648310611712576064830492506002015b600a83106104245760010192915050565b60006001600160e01b03198216635a05180f60e01b1480610424575061042482611aab565b61175484848484611ae0565b600c5460ff1615610b445760405162461bcd60e51b815260206004820152602b60248201527f4552433732315061757361626c653a20746f6b656e207472616e73666572207760448201526a1a1a5b19481c185d5cd95960aa1b6064820152608401610557565b60606104246001600160a01b03831660145b606060006117dc836002612341565b6117e7906002612358565b67ffffffffffffffff8111156117ff576117ff611f7a565b6040519080825280601f01601f191660200182016040528015611829576020820181803683370190505b509050600360fc1b816000815181106118445761184461211d565b60200101906001600160f81b031916908160001a905350600f60fb1b816001815181106118735761187361211d565b60200101906001600160f81b031916908160001a9053506000611897846002612341565b6118a2906001612358565b90505b600181111561191a576f181899199a1a9b1b9c1cb0b131b232b360811b85600f16601081106118d6576118d661211d565b1a60f81b8282815181106118ec576118ec61211d565b60200101906001600160f81b031916908160001a90535060049490941c936119138161236b565b90506118a5565b508315610ac85760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610557565b60008181526001830160205260408120546119b057508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610424565b506000610424565b60008181526001830160205260408120548015611aa15760006119dc600183612382565b85549091506000906119f090600190612382565b9050818114611a55576000866000018281548110611a1057611a1061211d565b9060005260206000200154905080876000018481548110611a3357611a3361211d565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080611a6657611a66612395565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610424565b6000915050610424565b60006001600160e01b03198216637965db0b60e01b148061042457506301ffc9a760e01b6001600160e01b0319831614610424565b6001811115611b4f5760405162461bcd60e51b815260206004820152603560248201527f455243373231456e756d657261626c653a20636f6e7365637574697665207472604482015274185b9cd9995c9cc81b9bdd081cdd5c1c1bdc9d1959605a1b6064820152608401610557565b816001600160a01b038516611bab57611ba681600a80546000838152600b60205260408120829055600182018355919091527fc65a7bb8d6351c1cf70c95a316cc6a92839c986682d98bc35f958f4883f9d2a80155565b611bce565b836001600160a01b0316856001600160a01b031614611bce57611bce8582611c14565b6001600160a01b038416611bea57611be581611cb1565b611c0d565b846001600160a01b0316846001600160a01b031614611c0d57611c0d8482611d60565b5050505050565b60006001611c21846109aa565b611c2b9190612382565b600083815260096020526040902054909150808214611c7e576001600160a01b03841660009081526008602090815260408083208584528252808320548484528184208190558352600990915290208190555b5060009182526009602090815260408084208490556001600160a01b039094168352600881528383209183525290812055565b600a54600090611cc390600190612382565b6000838152600b6020526040812054600a8054939450909284908110611ceb57611ceb61211d565b9060005260206000200154905080600a8381548110611d0c57611d0c61211d565b6000918252602080832090910192909255828152600b9091526040808220849055858252812055600a805480611d4457611d44612395565b6001900381819060005260206000200160009055905550505050565b6000611d6b836109aa565b6001600160a01b039093166000908152600860209081526040808320868452825280832085905593825260099052919091209190915550565b6001600160e01b03198116811461083557600080fd5b600060208284031215611dcc57600080fd5b8135610ac881611da4565b60005b83811015611df2578181015183820152602001611dda565b50506000910152565b60008151808452611e13816020860160208601611dd7565b601f01601f19169290920160200192915050565b602081526000610ac86020830184611dfb565b600060208284031215611e4c57600080fd5b5035919050565b80356001600160a01b0381168114611e6a57600080fd5b919050565b60008060408385031215611e8257600080fd5b611e8b83611e53565b946020939093013593505050565b600080600060608486031215611eae57600080fd5b611eb784611e53565b9250611ec560208501611e53565b9150604084013590509250925092565b60008060408385031215611ee857600080fd5b82359150611ef860208401611e53565b90509250929050565b600060208284031215611f1357600080fd5b610ac882611e53565b60008060408385031215611f2f57600080fd5b50508035926020909101359150565b60008060408385031215611f5157600080fd5b611f5a83611e53565b915060208301358015158114611f6f57600080fd5b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b60008060008060808587031215611fa657600080fd5b611faf85611e53565b9350611fbd60208601611e53565b925060408501359150606085013567ffffffffffffffff80821115611fe157600080fd5b818701915087601f830112611ff557600080fd5b81358181111561200757612007611f7a565b604051601f8201601f19908116603f0116810190838211818310171561202f5761202f611f7a565b816040528281528a602084870101111561204857600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b6000806040838503121561207f57600080fd5b61208883611e53565b9150611ef860208401611e53565b600181811c908216806120aa57607f821691505b6020821081036120ca57634e487b7160e01b600052602260045260246000fd5b50919050565b6020808252602d908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526c1c881bdc88185c1c1c9bdd9959609a1b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b602080825260189082015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604082015260600190565b60008351612177818460208801611dd7565b83519083019061218b818360208801611dd7565b01949350505050565b60208082526025908201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060408201526437bbb732b960d91b606082015260800190565b6020808252601c908201527f4552433732313a20746f6b656e20616c7265616479206d696e74656400000000604082015260600190565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b76020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b815260008351612294816017850160208801611dd7565b7001034b99036b4b9b9b4b733903937b6329607d1b60179184019182015283516122c5816028840160208801611dd7565b01602801949350505050565b6001600160a01b038581168252841660208201526040810183905260806060820181905260009061230490830184611dfb565b9695505050505050565b60006020828403121561232057600080fd5b8151610ac881611da4565b634e487b7160e01b600052601160045260246000fd5b80820281158282048414176104245761042461232b565b808201808211156104245761042461232b565b60008161237a5761237a61232b565b506000190190565b818103818111156104245761042461232b565b634e487b7160e01b600052603160045260246000fdfe65d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440d862addf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef4552433732315072657365744d696e7465725061757365724175746f49643a20a2646970667358221220f586c29d0cbd3e2cee9bd99a648a34864226f46f9a05471902f3728b4f230c2864736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101a55760003560e01c80636352211e116100ef578063a22cb46511610092578063a22cb4651461036b578063b88d4fde1461037e578063c87b56dd14610391578063ca15c873146103a4578063d5391393146103b7578063d547741f146103de578063e63ab1e9146103f1578063e985e9c51461040657600080fd5b80636352211e146102f45780636a6278421461030757806370a082311461031a5780638456cb591461032d5780639010d07c1461033557806391d148541461034857806395d89b411461035b578063a217fddf1461036357600080fd5b80632f2ff15d116101575780632f2ff15d1461026f5780632f745c591461028257806336568abe146102955780633f4ba83a146102a857806342842e0e146102b057806342966c68146102c35780634f6ccce7146102d65780635c975abb146102e957600080fd5b806301ffc9a7146101aa57806306fdde03146101d2578063081812fc146101e7578063095ea7b31461021257806318160ddd1461022757806323b872dd14610239578063248a9ca31461024c575b600080fd5b6101bd6101b8366004611dba565b610419565b60405190151581526020015b60405180910390f35b6101da61042a565b6040516101c99190611e27565b6101fa6101f5366004611e3a565b6104bc565b6040516001600160a01b0390911681526020016101c9565b610225610220366004611e6f565b6104e3565b005b600a545b6040519081526020016101c9565b610225610247366004611e99565b6105fd565b61022b61025a366004611e3a565b60009081526020819052604090206001015490565b61022561027d366004611ed5565b61062f565b61022b610290366004611e6f565b610654565b6102256102a3366004611ed5565b6106ea565b610225610768565b6102256102be366004611e99565b6107ec565b6102256102d1366004611e3a565b610807565b61022b6102e4366004611e3a565b610838565b600c5460ff166101bd565b6101fa610302366004611e3a565b6108cb565b610225610315366004611f01565b610900565b61022b610328366004611f01565b6109aa565b610225610a30565b6101fa610343366004611f1c565b610ab0565b6101bd610356366004611ed5565b610acf565b6101da610af8565b61022b600081565b610225610379366004611f3e565b610b07565b61022561038c366004611f90565b610b12565b6101da61039f366004611e3a565b610b4a565b61022b6103b2366004611e3a565b610bb0565b61022b7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a681565b6102256103ec366004611ed5565b610bc7565b61022b6000805160206123ac83398151915281565b6101bd61041436600461206c565b610bec565b600061042482610c1a565b92915050565b60606002805461043990612096565b80601f016020809104026020016040519081016040528092919081815260200182805461046590612096565b80156104b25780601f10610487576101008083540402835291602001916104b2565b820191906000526020600020905b81548152906001019060200180831161049557829003601f168201915b5050505050905090565b60006104c782610c3f565b506000908152600660205260409020546001600160a01b031690565b60006104ee826108cb565b9050806001600160a01b0316836001600160a01b0316036105605760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084015b60405180910390fd5b336001600160a01b038216148061057c575061057c8133610bec565b6105ee5760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000006064820152608401610557565b6105f88383610c64565b505050565b610608335b82610cd2565b6106245760405162461bcd60e51b8152600401610557906120d0565b6105f8838383610d31565b60008281526020819052604090206001015461064a81610e90565b6105f88383610e9a565b600061065f836109aa565b82106106c15760405162461bcd60e51b815260206004820152602b60248201527f455243373231456e756d657261626c653a206f776e657220696e646578206f7560448201526a74206f6620626f756e647360a81b6064820152608401610557565b506001600160a01b03919091166000908152600860209081526040808320938352929052205490565b6001600160a01b038116331461075a5760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608401610557565b6107648282610ebc565b5050565b6107806000805160206123ac83398151915233610acf565b6107e2576040805162461bcd60e51b81526020600482015260248101919091526000805160206123ec83398151915260448201527f6d75737420686176652070617573657220726f6c6520746f20756e70617573656064820152608401610557565b6107ea610ede565b565b6105f883838360405180602001604052806000815250610b12565b61081033610602565b61082c5760405162461bcd60e51b8152600401610557906120d0565b61083581610f30565b50565b6000610843600a5490565b82106108a65760405162461bcd60e51b815260206004820152602c60248201527f455243373231456e756d657261626c653a20676c6f62616c20696e646578206f60448201526b7574206f6620626f756e647360a01b6064820152608401610557565b600a82815481106108b9576108b961211d565b90600052602060002001549050919050565b6000818152600460205260408120546001600160a01b0316806104245760405162461bcd60e51b815260040161055790612133565b61092a7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a633610acf565b61098a5760405162461bcd60e51b815260206004820152603d60248201526000805160206123ec83398151915260448201527f6d7573742068617665206d696e74657220726f6c6520746f206d696e740000006064820152608401610557565b61099c81610997600d5490565b610fc1565b610835600d80546001019055565b60006001600160a01b038216610a145760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b6064820152608401610557565b506001600160a01b031660009081526005602052604090205490565b610a486000805160206123ac83398151915233610acf565b610aa85760405162461bcd60e51b815260206004820152603e60248201526000805160206123ec83398151915260448201527f6d75737420686176652070617573657220726f6c6520746f20706175736500006064820152608401610557565b6107ea6110ca565b6000828152600160205260408120610ac89083611107565b9392505050565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b60606003805461043990612096565b610764338383611113565b610b1c3383610cd2565b610b385760405162461bcd60e51b8152600401610557906120d0565b610b44848484846111dd565b50505050565b6060610b5582610c3f565b6000610b5f611210565b90506000815111610b7f5760405180602001604052806000815250610ac8565b80610b898461121f565b604051602001610b9a929190612165565b6040516020818303038152906040529392505050565b6000818152600160205260408120610424906112b2565b600082815260208190526040902060010154610be281610e90565b6105f88383610ebc565b6001600160a01b03918216600090815260076020908152604080832093909416825291909152205460ff1690565b60006001600160e01b0319821663780e9d6360e01b14806104245750610424826112bc565b610c48816112fc565b6108355760405162461bcd60e51b815260040161055790612133565b600081815260066020526040902080546001600160a01b0319166001600160a01b0384169081179091558190610c99826108cb565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b600080610cde836108cb565b9050806001600160a01b0316846001600160a01b03161480610d055750610d058185610bec565b80610d295750836001600160a01b0316610d1e846104bc565b6001600160a01b0316145b949350505050565b826001600160a01b0316610d44826108cb565b6001600160a01b031614610d6a5760405162461bcd60e51b815260040161055790612194565b6001600160a01b038216610dcc5760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b6064820152608401610557565b610dd98383836001611319565b826001600160a01b0316610dec826108cb565b6001600160a01b031614610e125760405162461bcd60e51b815260040161055790612194565b600081815260066020908152604080832080546001600160a01b03199081169091556001600160a01b0387811680865260058552838620805460001901905590871680865283862080546001019055868652600490945282852080549092168417909155905184936000805160206123cc83398151915291a4505050565b6108358133611325565b610ea4828261137e565b60008281526001602052604090206105f89082611402565b610ec68282611417565b60008281526001602052604090206105f8908261147c565b610ee6611491565b600c805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6000610f3b826108cb565b9050610f4b816000846001611319565b610f54826108cb565b600083815260066020908152604080832080546001600160a01b03199081169091556001600160a01b0385168085526005845282852080546000190190558785526004909352818420805490911690555192935084926000805160206123cc833981519152908390a45050565b6001600160a01b0382166110175760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f20616464726573736044820152606401610557565b611020816112fc565b1561103d5760405162461bcd60e51b8152600401610557906121d9565b61104b600083836001611319565b611054816112fc565b156110715760405162461bcd60e51b8152600401610557906121d9565b6001600160a01b038216600081815260056020908152604080832080546001019055848352600490915280822080546001600160a01b0319168417905551839291906000805160206123cc833981519152908290a45050565b6110d26114da565b600c805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610f133390565b6000610ac88383611520565b816001600160a01b0316836001600160a01b0316036111705760405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b6044820152606401610557565b6001600160a01b03838116600081815260076020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6111e8848484610d31565b6111f48484848461154a565b610b445760405162461bcd60e51b815260040161055790612210565b6060600e805461043990612096565b6060600061122c8361164b565b600101905060008167ffffffffffffffff81111561124c5761124c611f7a565b6040519080825280601f01601f191660200182016040528015611276576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461128057509392505050565b6000610424825490565b60006001600160e01b031982166380ac58cd60e01b14806112ed57506001600160e01b03198216635b5e139f60e01b145b80610424575061042482611723565b6000908152600460205260409020546001600160a01b0316151590565b610b4484848484611748565b61132f8282610acf565b6107645761133c816117bb565b6113478360206117cd565b604051602001611358929190612262565b60408051601f198184030181529082905262461bcd60e51b825261055791600401611e27565b6113888282610acf565b610764576000828152602081815260408083206001600160a01b03851684529091529020805460ff191660011790556113be3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000610ac8836001600160a01b038416611969565b6114218282610acf565b15610764576000828152602081815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000610ac8836001600160a01b0384166119b8565b600c5460ff166107ea5760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610557565b600c5460ff16156107ea5760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610557565b60008260000182815481106115375761153761211d565b9060005260206000200154905092915050565b60006001600160a01b0384163b1561164057604051630a85bd0160e11b81526001600160a01b0385169063150b7a029061158e9033908990889088906004016122d1565b6020604051808303816000875af19250505080156115c9575060408051601f3d908101601f191682019092526115c69181019061230e565b60015b611626573d8080156115f7576040519150601f19603f3d011682016040523d82523d6000602084013e6115fc565b606091505b50805160000361161e5760405162461bcd60e51b815260040161055790612210565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050610d29565b506001949350505050565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b831061168a5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef810000000083106116b6576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc1000083106116d457662386f26fc10000830492506010015b6305f5e10083106116ec576305f5e100830492506008015b612710831061170057612710830492506004015b60648310611712576064830492506002015b600a83106104245760010192915050565b60006001600160e01b03198216635a05180f60e01b1480610424575061042482611aab565b61175484848484611ae0565b600c5460ff1615610b445760405162461bcd60e51b815260206004820152602b60248201527f4552433732315061757361626c653a20746f6b656e207472616e73666572207760448201526a1a1a5b19481c185d5cd95960aa1b6064820152608401610557565b60606104246001600160a01b03831660145b606060006117dc836002612341565b6117e7906002612358565b67ffffffffffffffff8111156117ff576117ff611f7a565b6040519080825280601f01601f191660200182016040528015611829576020820181803683370190505b509050600360fc1b816000815181106118445761184461211d565b60200101906001600160f81b031916908160001a905350600f60fb1b816001815181106118735761187361211d565b60200101906001600160f81b031916908160001a9053506000611897846002612341565b6118a2906001612358565b90505b600181111561191a576f181899199a1a9b1b9c1cb0b131b232b360811b85600f16601081106118d6576118d661211d565b1a60f81b8282815181106118ec576118ec61211d565b60200101906001600160f81b031916908160001a90535060049490941c936119138161236b565b90506118a5565b508315610ac85760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610557565b60008181526001830160205260408120546119b057508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610424565b506000610424565b60008181526001830160205260408120548015611aa15760006119dc600183612382565b85549091506000906119f090600190612382565b9050818114611a55576000866000018281548110611a1057611a1061211d565b9060005260206000200154905080876000018481548110611a3357611a3361211d565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080611a6657611a66612395565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610424565b6000915050610424565b60006001600160e01b03198216637965db0b60e01b148061042457506301ffc9a760e01b6001600160e01b0319831614610424565b6001811115611b4f5760405162461bcd60e51b815260206004820152603560248201527f455243373231456e756d657261626c653a20636f6e7365637574697665207472604482015274185b9cd9995c9cc81b9bdd081cdd5c1c1bdc9d1959605a1b6064820152608401610557565b816001600160a01b038516611bab57611ba681600a80546000838152600b60205260408120829055600182018355919091527fc65a7bb8d6351c1cf70c95a316cc6a92839c986682d98bc35f958f4883f9d2a80155565b611bce565b836001600160a01b0316856001600160a01b031614611bce57611bce8582611c14565b6001600160a01b038416611bea57611be581611cb1565b611c0d565b846001600160a01b0316846001600160a01b031614611c0d57611c0d8482611d60565b5050505050565b60006001611c21846109aa565b611c2b9190612382565b600083815260096020526040902054909150808214611c7e576001600160a01b03841660009081526008602090815260408083208584528252808320548484528184208190558352600990915290208190555b5060009182526009602090815260408084208490556001600160a01b039094168352600881528383209183525290812055565b600a54600090611cc390600190612382565b6000838152600b6020526040812054600a8054939450909284908110611ceb57611ceb61211d565b9060005260206000200154905080600a8381548110611d0c57611d0c61211d565b6000918252602080832090910192909255828152600b9091526040808220849055858252812055600a805480611d4457611d44612395565b6001900381819060005260206000200160009055905550505050565b6000611d6b836109aa565b6001600160a01b039093166000908152600860209081526040808320868452825280832085905593825260099052919091209190915550565b6001600160e01b03198116811461083557600080fd5b600060208284031215611dcc57600080fd5b8135610ac881611da4565b60005b83811015611df2578181015183820152602001611dda565b50506000910152565b60008151808452611e13816020860160208601611dd7565b601f01601f19169290920160200192915050565b602081526000610ac86020830184611dfb565b600060208284031215611e4c57600080fd5b5035919050565b80356001600160a01b0381168114611e6a57600080fd5b919050565b60008060408385031215611e8257600080fd5b611e8b83611e53565b946020939093013593505050565b600080600060608486031215611eae57600080fd5b611eb784611e53565b9250611ec560208501611e53565b9150604084013590509250925092565b60008060408385031215611ee857600080fd5b82359150611ef860208401611e53565b90509250929050565b600060208284031215611f1357600080fd5b610ac882611e53565b60008060408385031215611f2f57600080fd5b50508035926020909101359150565b60008060408385031215611f5157600080fd5b611f5a83611e53565b915060208301358015158114611f6f57600080fd5b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b60008060008060808587031215611fa657600080fd5b611faf85611e53565b9350611fbd60208601611e53565b925060408501359150606085013567ffffffffffffffff80821115611fe157600080fd5b818701915087601f830112611ff557600080fd5b81358181111561200757612007611f7a565b604051601f8201601f19908116603f0116810190838211818310171561202f5761202f611f7a565b816040528281528a602084870101111561204857600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b6000806040838503121561207f57600080fd5b61208883611e53565b9150611ef860208401611e53565b600181811c908216806120aa57607f821691505b6020821081036120ca57634e487b7160e01b600052602260045260246000fd5b50919050565b6020808252602d908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526c1c881bdc88185c1c1c9bdd9959609a1b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b602080825260189082015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604082015260600190565b60008351612177818460208801611dd7565b83519083019061218b818360208801611dd7565b01949350505050565b60208082526025908201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060408201526437bbb732b960d91b606082015260800190565b6020808252601c908201527f4552433732313a20746f6b656e20616c7265616479206d696e74656400000000604082015260600190565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b76020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b815260008351612294816017850160208801611dd7565b7001034b99036b4b9b9b4b733903937b6329607d1b60179184019182015283516122c5816028840160208801611dd7565b01602801949350505050565b6001600160a01b038581168252841660208201526040810183905260806060820181905260009061230490830184611dfb565b9695505050505050565b60006020828403121561232057600080fd5b8151610ac881611da4565b634e487b7160e01b600052601160045260246000fd5b80820281158282048414176104245761042461232b565b808201808211156104245761042461232b565b60008161237a5761237a61232b565b506000190190565b818103818111156104245761042461232b565b634e487b7160e01b600052603160045260246000fdfe65d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440d862addf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef4552433732315072657365744d696e7465725061757365724175746f49643a20a2646970667358221220f586c29d0cbd3e2cee9bd99a648a34864226f46f9a05471902f3728b4f230c2864736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RootERC721PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RootERC721Predicate","sourceName":"contracts/root/RootERC721Predicate.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"depositor","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ERC721Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"depositor","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"ERC721DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ERC721Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"ERC721WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"TokenMapped","type":"event"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childERC721Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"depositBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"depositTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"exitHelper","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newStateSender","type":"address"},{"internalType":"address","name":"newExitHelper","type":"address"},{"internalType":"address","name":"newChildERC721Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC721Metadata","name":"rootToken","type":"address"}],"name":"mapToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC721Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onL2StateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b5061196b806100206000396000f3fe608060405234801561001057600080fd5b50600436106100fb5760003560e01c8063cb10f94c116100a2578063f43cda8b11610071578063f43cda8b146102a1578063f4a120f7146102b4578063f6451255146102c7578063f8c8765e146102ee578063ff6f870c1461030157600080fd5b8063cb10f94c14610227578063d41f177114610240578063d7c9e3ec14610267578063f213159c1461028e57600080fd5b8063150b7a021461010057806347e7ef241461013c5780634fdca69d146101515780637efab4f51461017c57806395c7041c146101a5578063b1768065146101b8578063b68ad1e4146101ed578063c5ac2b1c14610200575b600080fd5b61011e61010e36600461112d565b630a85bd0160e11b949350505050565b6040516001600160e01b031990911681526020015b60405180910390f35b61014f61014a3660046111db565b610314565b005b600254610164906001600160a01b031681565b6040516001600160a01b039091168152602001610133565b61016461018a366004611207565b6004602052600090815260409020546001600160a01b031681565b600154610164906001600160a01b031681565b6101df7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b604051908152602001610133565b600354610164906001600160a01b031681565b6101df7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b600054610164906201000090046001600160a01b031681565b6101df7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101df7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61014f61029c36600461122b565b610323565b61014f6102af36600461126c565b610333565b6101646102c2366004611207565b61050a565b6101df7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61014f6102fc3660046112f4565b61086a565b61014f61030f36600461139b565b610a78565b61031f823383610ae0565b5050565b61032e838383610ae0565b505050565b6001546001600160a01b031633146103a05760405162461bcd60e51b815260206004820152602560248201527f526f6f744552433732315072656469636174653a204f4e4c595f455849545f4860448201526422a62822a960d91b60648201526084015b60405180910390fd5b6002546001600160a01b0384811691161461040f5760405162461bcd60e51b815260206004820152602960248201527f526f6f744552433732315072656469636174653a204f4e4c595f4348494c445f60448201526850524544494341544560b81b6064820152608401610397565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286961043e60206000848661141d565b61044791611447565b036104665761046161045c826020818661141d565b610c66565b610504565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed261049560206000848661141d565b61049e91611447565b036104ad576104618282610d64565b60405162461bcd60e51b815260206004820152602660248201527f526f6f744552433732315072656469636174653a20494e56414c49445f5349476044820152654e415455524560d01b6064820152608401610397565b50505050565b60006001600160a01b03821661056d5760405162461bcd60e51b815260206004820152602260248201527f526f6f744552433732315072656469636174653a20494e56414c49445f544f4b60448201526122a760f11b6064820152608401610397565b6001600160a01b0382811660009081526004602052604090205416156105e15760405162461bcd60e51b815260206004820152602360248201527f526f6f744552433732315072656469636174653a20414c52454144595f4d415060448201526214115160ea1b6064820152608401610397565b6002546003546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b039283169260009261068f92911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b03858116600081815260046020819052604080832080546001600160a01b031916878716179055825481516306fdde0360e01b81529151969750620100009004909416946316f198319488947f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad948c9491936306fdde039380840193908290030181865afa15801561072c573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610754919081019061148a565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610792573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526107ba919081019061148a565b6040516020016107cd949392919061152c565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016107f9929190611573565b600060405180830381600087803b15801561081357600080fd5b505af1158015610827573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f85920d35e6c72f6b2affffa04298b0cecfeba86e4a9f407df661f1cb8ab5e61790600090a39392505050565b600054610100900460ff161580801561088a5750600054600160ff909116105b806108a45750303b1580156108a4575060005460ff166001145b6109075760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610397565b6000805460ff19166001179055801561092a576000805461ff0019166101001790555b6001600160a01b0385161580159061094a57506001600160a01b03841615155b801561095e57506001600160a01b03831615155b801561097257506001600160a01b03821615155b6109ce5760405162461bcd60e51b815260206004820152602760248201527f526f6f744552433732315072656469636174653a204241445f494e495449414c60448201526624ad20aa24a7a760c91b6064820152608401610397565b6000805462010000600160b01b031916620100006001600160a01b038881169190910291909117909155600180546001600160a01b031990811687841617909155600280548216868416179055600380549091169184169190911790558015610a71576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b828114610ad35760405162461bcd60e51b815260206004820152602360248201527f526f6f744552433732315072656469636174653a20494e56414c49445f4c454e60448201526208ea8960eb1b6064820152608401610397565b610a718585858585610ea5565b6000610aeb84611061565b604051632142170760e11b81529091506001600160a01b038516906342842e0e90610b1e9033903090879060040161159f565b600060405180830381600087803b158015610b3857600080fd5b505af1158015610b4c573d6000803e3d6000fd5b5050600054600254604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038a811682840152336060830152898116608083015260a08083018a90528351808403909101815260c08301938490526316f1983160e01b90935262010000909404841695506316f198319450610be2939092169160c401611573565b600060405180830381600087803b158015610bfc57600080fd5b505af1158015610c10573d6000803e3d6000fd5b505060408051338152602081018690526001600160a01b03808816945085811693508816917f40e242710be14b7d61d3b93e9d56b40df89cc4dbad8bb88da38c8e0c23809ba7910160405180910390a450505050565b6000808080610c77858701876115c3565b6001600160a01b0380851660009081526004602052604090205494985092965090945092501680610caa57610caa611614565b604051632142170760e11b81526001600160a01b038616906342842e0e90610cda9030908790879060040161159f565b600060405180830381600087803b158015610cf457600080fd5b505af1158015610d08573d6000803e3d6000fd5b5050604080516001600160a01b03888116825260208201879052808816945085811693508916917f8194f168e6e9e449d05a46936e071a710c0f22634eaadeb5b85a86540123931991015b60405180910390a450505050505050565b6000808080610d75858701876116b3565b6001600160a01b03808516600090815260046020526040902054949950929750909550935016905080610daa57610daa611614565b60005b8251811015610e5557856001600160a01b03166342842e0e30868481518110610dd857610dd86117a5565b6020026020010151868581518110610df257610df26117a5565b60200260200101516040518463ffffffff1660e01b8152600401610e189392919061159f565b600060405180830381600087803b158015610e3257600080fd5b505af1158015610e46573d6000803e3d6000fd5b50505050806001019050610dad565b50836001600160a01b0316816001600160a01b0316866001600160a01b03167f1b7b9713fdef5dfadf92f6d6e998eb1fc4763cee62a194a095d76349f7dce20c8686604051610d539291906117bb565b6000610eb086611061565b905060005b82811015610f4257866001600160a01b03166342842e0e3330878786818110610ee057610ee06117a5565b905060200201356040518463ffffffff1660e01b8152600401610f059392919061159f565b600060405180830381600087803b158015610f1f57600080fd5b505af1158015610f33573d6000803e3d6000fd5b50505050806001019050610eb5565b506000546002546040516001600160a01b03620100009093048316926316f19831921690610fa0907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908b9033908c908c908c908c906020016118ba565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610fcc929190611573565b600060405180830381600087803b158015610fe657600080fd5b505af1158015610ffa573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316876001600160a01b03167f02c575a943105cda454293b7ac636c87c94ff1bfcfac968aa5423e6b9b312ee988888888604051611051949392919061190e565b60405180910390a4505050505050565b6001600160a01b03808216600090815260046020526040902054168061108d5761108a8261050a565b90505b6001600160a01b0381166110a3576110a3611614565b919050565b6001600160a01b03811681146110bd57600080fd5b50565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156110fe576110fe6110c0565b604052919050565b60006001600160401b0382111561111f5761111f6110c0565b50601f01601f191660200190565b6000806000806080858703121561114357600080fd5b843561114e816110a8565b9350602085013561115e816110a8565b92506040850135915060608501356001600160401b0381111561118057600080fd5b8501601f8101871361119157600080fd5b80356111a461119f82611106565b6110d6565b8181528860208385010111156111b957600080fd5b8160208401602083013760006020838301015280935050505092959194509250565b600080604083850312156111ee57600080fd5b82356111f9816110a8565b946020939093013593505050565b60006020828403121561121957600080fd5b8135611224816110a8565b9392505050565b60008060006060848603121561124057600080fd5b833561124b816110a8565b9250602084013561125b816110a8565b929592945050506040919091013590565b6000806000806060858703121561128257600080fd5b843593506020850135611294816110a8565b925060408501356001600160401b03808211156112b057600080fd5b818701915087601f8301126112c457600080fd5b8135818111156112d357600080fd5b8860208285010111156112e557600080fd5b95989497505060200194505050565b6000806000806080858703121561130a57600080fd5b8435611315816110a8565b93506020850135611325816110a8565b92506040850135611335816110a8565b91506060850135611345816110a8565b939692955090935050565b60008083601f84011261136257600080fd5b5081356001600160401b0381111561137957600080fd5b6020830191508360208260051b850101111561139457600080fd5b9250929050565b6000806000806000606086880312156113b357600080fd5b85356113be816110a8565b945060208601356001600160401b03808211156113da57600080fd5b6113e689838a01611350565b909650945060408801359150808211156113ff57600080fd5b5061140c88828901611350565b969995985093965092949392505050565b6000808585111561142d57600080fd5b8386111561143a57600080fd5b5050820193919092039150565b8035602083101561146057600019602084900360031b1b165b92915050565b60005b83811015611481578181015183820152602001611469565b50506000910152565b60006020828403121561149c57600080fd5b81516001600160401b038111156114b257600080fd5b8201601f810184136114c357600080fd5b80516114d161119f82611106565b8181528560208385010111156114e657600080fd5b6114f7826020830160208601611466565b95945050505050565b60008151808452611518816020860160208601611466565b601f01601f19169290920160200192915050565b8481526001600160a01b038416602082015260806040820181905260009061155690830185611500565b82810360608401526115688185611500565b979650505050505050565b6001600160a01b038316815260406020820181905260009061159790830184611500565b949350505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b600080600080608085870312156115d957600080fd5b84356115e4816110a8565b935060208501356115f4816110a8565b92506040850135611604816110a8565b9396929550929360600135925050565b634e487b7160e01b600052600160045260246000fd5b60006001600160401b03821115611643576116436110c0565b5060051b60200190565b600082601f83011261165e57600080fd5b8135602061166e61119f8361162a565b82815260059290921b8401810191818101908684111561168d57600080fd5b8286015b848110156116a85780358352918301918301611691565b509695505050505050565b600080600080600060a086880312156116cb57600080fd5b853594506020808701356116de816110a8565b945060408701356116ee816110a8565b935060608701356001600160401b038082111561170a57600080fd5b818901915089601f83011261171e57600080fd5b813561172c61119f8261162a565b81815260059190911b8301840190848101908c83111561174b57600080fd5b938501935b82851015611772578435611763816110a8565b82529385019390850190611750565b96505050608089013592508083111561178a57600080fd5b50506117988882890161164d565b9150509295509295909350565b634e487b7160e01b600052603260045260246000fd5b604080825283519082018190526000906020906060840190828701845b828110156117fd5781516001600160a01b0316845292840192908401906001016117d8565b5050508381038285015284518082528583019183019060005b8181101561183257835183529284019291840191600101611816565b5090979650505050505050565b8183526000602080850194508260005b8581101561187d578135611862816110a8565b6001600160a01b03168752958201959082019060010161184f565b509495945050505050565b81835260006001600160fb1b038311156118a157600080fd5b8260051b80836020870137939093016020019392505050565b8781526001600160a01b0387811660208301528616604082015260a0606082018190526000906118ed908301868861183f565b8281036080840152611900818587611888565b9a9950505050505050505050565b60408152600061192260408301868861183f565b828103602084015261156881858761188856fea26469706673582212203621718a3c2b1847a958c6d88f320b8bf9fde1113c6a705bddbeec4f2127ab7364736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100fb5760003560e01c8063cb10f94c116100a2578063f43cda8b11610071578063f43cda8b146102a1578063f4a120f7146102b4578063f6451255146102c7578063f8c8765e146102ee578063ff6f870c1461030157600080fd5b8063cb10f94c14610227578063d41f177114610240578063d7c9e3ec14610267578063f213159c1461028e57600080fd5b8063150b7a021461010057806347e7ef241461013c5780634fdca69d146101515780637efab4f51461017c57806395c7041c146101a5578063b1768065146101b8578063b68ad1e4146101ed578063c5ac2b1c14610200575b600080fd5b61011e61010e36600461112d565b630a85bd0160e11b949350505050565b6040516001600160e01b031990911681526020015b60405180910390f35b61014f61014a3660046111db565b610314565b005b600254610164906001600160a01b031681565b6040516001600160a01b039091168152602001610133565b61016461018a366004611207565b6004602052600090815260409020546001600160a01b031681565b600154610164906001600160a01b031681565b6101df7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b604051908152602001610133565b600354610164906001600160a01b031681565b6101df7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b600054610164906201000090046001600160a01b031681565b6101df7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101df7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61014f61029c36600461122b565b610323565b61014f6102af36600461126c565b610333565b6101646102c2366004611207565b61050a565b6101df7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61014f6102fc3660046112f4565b61086a565b61014f61030f36600461139b565b610a78565b61031f823383610ae0565b5050565b61032e838383610ae0565b505050565b6001546001600160a01b031633146103a05760405162461bcd60e51b815260206004820152602560248201527f526f6f744552433732315072656469636174653a204f4e4c595f455849545f4860448201526422a62822a960d91b60648201526084015b60405180910390fd5b6002546001600160a01b0384811691161461040f5760405162461bcd60e51b815260206004820152602960248201527f526f6f744552433732315072656469636174653a204f4e4c595f4348494c445f60448201526850524544494341544560b81b6064820152608401610397565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286961043e60206000848661141d565b61044791611447565b036104665761046161045c826020818661141d565b610c66565b610504565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed261049560206000848661141d565b61049e91611447565b036104ad576104618282610d64565b60405162461bcd60e51b815260206004820152602660248201527f526f6f744552433732315072656469636174653a20494e56414c49445f5349476044820152654e415455524560d01b6064820152608401610397565b50505050565b60006001600160a01b03821661056d5760405162461bcd60e51b815260206004820152602260248201527f526f6f744552433732315072656469636174653a20494e56414c49445f544f4b60448201526122a760f11b6064820152608401610397565b6001600160a01b0382811660009081526004602052604090205416156105e15760405162461bcd60e51b815260206004820152602360248201527f526f6f744552433732315072656469636174653a20414c52454144595f4d415060448201526214115160ea1b6064820152608401610397565b6002546003546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b039283169260009261068f92911690603401604051602081830303815290604052805190602001208460405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b03858116600081815260046020819052604080832080546001600160a01b031916878716179055825481516306fdde0360e01b81529151969750620100009004909416946316f198319488947f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad948c9491936306fdde039380840193908290030181865afa15801561072c573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610754919081019061148a565b896001600160a01b03166395d89b416040518163ffffffff1660e01b8152600401600060405180830381865afa158015610792573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526107ba919081019061148a565b6040516020016107cd949392919061152c565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016107f9929190611573565b600060405180830381600087803b15801561081357600080fd5b505af1158015610827573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f85920d35e6c72f6b2affffa04298b0cecfeba86e4a9f407df661f1cb8ab5e61790600090a39392505050565b600054610100900460ff161580801561088a5750600054600160ff909116105b806108a45750303b1580156108a4575060005460ff166001145b6109075760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610397565b6000805460ff19166001179055801561092a576000805461ff0019166101001790555b6001600160a01b0385161580159061094a57506001600160a01b03841615155b801561095e57506001600160a01b03831615155b801561097257506001600160a01b03821615155b6109ce5760405162461bcd60e51b815260206004820152602760248201527f526f6f744552433732315072656469636174653a204241445f494e495449414c60448201526624ad20aa24a7a760c91b6064820152608401610397565b6000805462010000600160b01b031916620100006001600160a01b038881169190910291909117909155600180546001600160a01b031990811687841617909155600280548216868416179055600380549091169184169190911790558015610a71576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b828114610ad35760405162461bcd60e51b815260206004820152602360248201527f526f6f744552433732315072656469636174653a20494e56414c49445f4c454e60448201526208ea8960eb1b6064820152608401610397565b610a718585858585610ea5565b6000610aeb84611061565b604051632142170760e11b81529091506001600160a01b038516906342842e0e90610b1e9033903090879060040161159f565b600060405180830381600087803b158015610b3857600080fd5b505af1158015610b4c573d6000803e3d6000fd5b5050600054600254604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038a811682840152336060830152898116608083015260a08083018a90528351808403909101815260c08301938490526316f1983160e01b90935262010000909404841695506316f198319450610be2939092169160c401611573565b600060405180830381600087803b158015610bfc57600080fd5b505af1158015610c10573d6000803e3d6000fd5b505060408051338152602081018690526001600160a01b03808816945085811693508816917f40e242710be14b7d61d3b93e9d56b40df89cc4dbad8bb88da38c8e0c23809ba7910160405180910390a450505050565b6000808080610c77858701876115c3565b6001600160a01b0380851660009081526004602052604090205494985092965090945092501680610caa57610caa611614565b604051632142170760e11b81526001600160a01b038616906342842e0e90610cda9030908790879060040161159f565b600060405180830381600087803b158015610cf457600080fd5b505af1158015610d08573d6000803e3d6000fd5b5050604080516001600160a01b03888116825260208201879052808816945085811693508916917f8194f168e6e9e449d05a46936e071a710c0f22634eaadeb5b85a86540123931991015b60405180910390a450505050505050565b6000808080610d75858701876116b3565b6001600160a01b03808516600090815260046020526040902054949950929750909550935016905080610daa57610daa611614565b60005b8251811015610e5557856001600160a01b03166342842e0e30868481518110610dd857610dd86117a5565b6020026020010151868581518110610df257610df26117a5565b60200260200101516040518463ffffffff1660e01b8152600401610e189392919061159f565b600060405180830381600087803b158015610e3257600080fd5b505af1158015610e46573d6000803e3d6000fd5b50505050806001019050610dad565b50836001600160a01b0316816001600160a01b0316866001600160a01b03167f1b7b9713fdef5dfadf92f6d6e998eb1fc4763cee62a194a095d76349f7dce20c8686604051610d539291906117bb565b6000610eb086611061565b905060005b82811015610f4257866001600160a01b03166342842e0e3330878786818110610ee057610ee06117a5565b905060200201356040518463ffffffff1660e01b8152600401610f059392919061159f565b600060405180830381600087803b158015610f1f57600080fd5b505af1158015610f33573d6000803e3d6000fd5b50505050806001019050610eb5565b506000546002546040516001600160a01b03620100009093048316926316f19831921690610fa0907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908b9033908c908c908c908c906020016118ba565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610fcc929190611573565b600060405180830381600087803b158015610fe657600080fd5b505af1158015610ffa573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316876001600160a01b03167f02c575a943105cda454293b7ac636c87c94ff1bfcfac968aa5423e6b9b312ee988888888604051611051949392919061190e565b60405180910390a4505050505050565b6001600160a01b03808216600090815260046020526040902054168061108d5761108a8261050a565b90505b6001600160a01b0381166110a3576110a3611614565b919050565b6001600160a01b03811681146110bd57600080fd5b50565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156110fe576110fe6110c0565b604052919050565b60006001600160401b0382111561111f5761111f6110c0565b50601f01601f191660200190565b6000806000806080858703121561114357600080fd5b843561114e816110a8565b9350602085013561115e816110a8565b92506040850135915060608501356001600160401b0381111561118057600080fd5b8501601f8101871361119157600080fd5b80356111a461119f82611106565b6110d6565b8181528860208385010111156111b957600080fd5b8160208401602083013760006020838301015280935050505092959194509250565b600080604083850312156111ee57600080fd5b82356111f9816110a8565b946020939093013593505050565b60006020828403121561121957600080fd5b8135611224816110a8565b9392505050565b60008060006060848603121561124057600080fd5b833561124b816110a8565b9250602084013561125b816110a8565b929592945050506040919091013590565b6000806000806060858703121561128257600080fd5b843593506020850135611294816110a8565b925060408501356001600160401b03808211156112b057600080fd5b818701915087601f8301126112c457600080fd5b8135818111156112d357600080fd5b8860208285010111156112e557600080fd5b95989497505060200194505050565b6000806000806080858703121561130a57600080fd5b8435611315816110a8565b93506020850135611325816110a8565b92506040850135611335816110a8565b91506060850135611345816110a8565b939692955090935050565b60008083601f84011261136257600080fd5b5081356001600160401b0381111561137957600080fd5b6020830191508360208260051b850101111561139457600080fd5b9250929050565b6000806000806000606086880312156113b357600080fd5b85356113be816110a8565b945060208601356001600160401b03808211156113da57600080fd5b6113e689838a01611350565b909650945060408801359150808211156113ff57600080fd5b5061140c88828901611350565b969995985093965092949392505050565b6000808585111561142d57600080fd5b8386111561143a57600080fd5b5050820193919092039150565b8035602083101561146057600019602084900360031b1b165b92915050565b60005b83811015611481578181015183820152602001611469565b50506000910152565b60006020828403121561149c57600080fd5b81516001600160401b038111156114b257600080fd5b8201601f810184136114c357600080fd5b80516114d161119f82611106565b8181528560208385010111156114e657600080fd5b6114f7826020830160208601611466565b95945050505050565b60008151808452611518816020860160208601611466565b601f01601f19169290920160200192915050565b8481526001600160a01b038416602082015260806040820181905260009061155690830185611500565b82810360608401526115688185611500565b979650505050505050565b6001600160a01b038316815260406020820181905260009061159790830184611500565b949350505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b600080600080608085870312156115d957600080fd5b84356115e4816110a8565b935060208501356115f4816110a8565b92506040850135611604816110a8565b9396929550929360600135925050565b634e487b7160e01b600052600160045260246000fd5b60006001600160401b03821115611643576116436110c0565b5060051b60200190565b600082601f83011261165e57600080fd5b8135602061166e61119f8361162a565b82815260059290921b8401810191818101908684111561168d57600080fd5b8286015b848110156116a85780358352918301918301611691565b509695505050505050565b600080600080600060a086880312156116cb57600080fd5b853594506020808701356116de816110a8565b945060408701356116ee816110a8565b935060608701356001600160401b038082111561170a57600080fd5b818901915089601f83011261171e57600080fd5b813561172c61119f8261162a565b81815260059190911b8301840190848101908c83111561174b57600080fd5b938501935b82851015611772578435611763816110a8565b82529385019390850190611750565b96505050608089013592508083111561178a57600080fd5b50506117988882890161164d565b9150509295509295909350565b634e487b7160e01b600052603260045260246000fd5b604080825283519082018190526000906020906060840190828701845b828110156117fd5781516001600160a01b0316845292840192908401906001016117d8565b5050508381038285015284518082528583019183019060005b8181101561183257835183529284019291840191600101611816565b5090979650505050505050565b8183526000602080850194508260005b8581101561187d578135611862816110a8565b6001600160a01b03168752958201959082019060010161184f565b509495945050505050565b81835260006001600160fb1b038311156118a157600080fd5b8260051b80836020870137939093016020019392505050565b8781526001600160a01b0387811660208301528616604082015260a0606082018190526000906118ed908301868861183f565b8281036080840152611900818587611888565b9a9950505050505050505050565b60408152600061192260408301868861183f565b828103602084015261156881858761188856fea26469706673582212203621718a3c2b1847a958c6d88f320b8bf9fde1113c6a705bddbeec4f2127ab7364736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildMintableERC721PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildMintableERC721Predicate","sourceName":"contracts/root/ChildMintableERC721Predicate.sol","abi":[{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"MintableERC721Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"MintableERC721DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"MintableERC721Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"MintableERC721WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"MintableTokenMapped","type":"event"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"exitHelper","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newStateSender","type":"address"},{"internalType":"address","name":"newExitHelper","type":"address"},{"internalType":"address","name":"newRootERC721Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onL2StateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootERC721Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IChildERC721","name":"childToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC721","name":"childToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"}],"name":"withdrawBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC721","name":"childToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611f01806100206000396000f3fe608060405234801561001057600080fd5b50600436106100d55760003560e01c8063cb10f94c11610087578063cb10f94c146101ca578063d41f1771146101e3578063d7c9e3ec1461020a578063f3fef3a314610231578063f43cda8b14610244578063f645125514610257578063f691325c1461027e578063f8c8765e1461029157600080fd5b80636f33e695146100da5780637efab4f5146100ef57806395c7041c14610135578063b176806514610148578063b68ad1e41461017d578063c3b35a7e14610190578063c5ac2b1c146101a3575b600080fd5b6100ed6100e836600461158c565b6102a4565b005b6101186100fd36600461160e565b6004602052600090815260409020546001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b600154610118906001600160a01b031681565b61016f7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60405190815260200161012c565b600354610118906001600160a01b031681565b6100ed61019e366004611632565b6102b8565b61016f7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b600054610118906201000090046001600160a01b031681565b61016f7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61016f7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b6100ed61023f366004611673565b6102c8565b6100ed61025236600461169f565b6102d7565b61016f7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b600254610118906001600160a01b031681565b6100ed61029f366004611727565b61050f565b6102b18585858585610627565b5050505050565b6102c383838361099a565b505050565b6102d382338361099a565b5050565b6001546001600160a01b0316331461034d5760405162461bcd60e51b815260206004820152602e60248201527f4368696c644d696e7461626c654552433732315072656469636174653a204f4e60448201526d262cafa2ac24aa2fa422a62822a960911b60648201526084015b60405180910390fd5b6002546001600160a01b038481169116146103c45760405162461bcd60e51b815260206004820152603160248201527f4368696c644d696e7461626c654552433732315072656469636174653a204f4e6044820152704c595f524f4f545f50524544494341544560781b6064820152608401610344565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216103f3602060008486611783565b6103fc916117ad565b0361041b576104166104118260208186611783565b610ca9565b610509565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1861044a602060008486611783565b610453916117ad565b03610462576104168282610f1f565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad610491602060008486611783565b61049a916117ad565b036104a9576104168282611185565b60405162461bcd60e51b815260206004820152602f60248201527f4368696c644d696e7461626c654552433732315072656469636174653a20494e60448201526e56414c49445f5349474e415455524560881b6064820152608401610344565b50505050565b600054610100900460ff161580801561052f5750600054600160ff909116105b806105495750303b158015610549575060005460ff166001145b6105ac5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610344565b6000805460ff1916600117905580156105cf576000805461ff0019166101001790555b6105db858585856112f5565b80156102b1576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b84610631816113fd565b61064d5760405162461bcd60e51b8152600401610344906117cb565b6000866001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561068d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906106b19190611815565b6001600160a01b038181166000908152600460205260409020549192508881169116146106f05760405162461bcd60e51b815260040161034490611832565b6001600160a01b0381166107065761070661187e565b306001600160a01b0316876001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561074e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107729190611815565b6001600160a01b0316146107885761078861187e565b8483146107ec5760405162461bcd60e51b815260206004820152602c60248201527f4368696c644d696e7461626c654552433732315072656469636174653a20494e60448201526b0ac82989288be988a9c8ea8960a31b6064820152608401610344565b60405163b2dc5dc360e01b81526001600160a01b0388169063b2dc5dc39061081c903390889088906004016118c6565b6020604051808303816000875af115801561083b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061085f91906118f4565b61087b5760405162461bcd60e51b815260040161034490611916565b6000546002546040516001600160a01b03620100009093048316926316f198319216906108d8907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908d908d908d908d906020016119a8565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610904929190611a42565b600060405180830381600087803b15801561091e57600080fd5b505af1158015610932573d6000803e3d6000fd5b50505050336001600160a01b0316876001600160a01b0316826001600160a01b03167f5faed28924bb6c5b0d3eea1cc028b4814f49c39eac622b81ef17035d794ac774898989896040516109899493929190611a6e565b60405180910390a450505050505050565b826109a4816113fd565b6109c05760405162461bcd60e51b8152600401610344906117cb565b6000846001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a00573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a249190611815565b6001600160a01b03818116600090815260046020526040902054919250868116911614610a635760405162461bcd60e51b815260040161034490611832565b6001600160a01b038116610a7957610a7961187e565b306001600160a01b0316856001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ac1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ae59190611815565b6001600160a01b031614610afb57610afb61187e565b604051632770a7eb60e21b81526001600160a01b03861690639dc29fac90610b299033908790600401611aa0565b6020604051808303816000875af1158015610b48573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b6c91906118f4565b610b885760405162461bcd60e51b815260040161034490611916565b600054600254604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152888116608083015260a08083018990528351808403909101815260c08301938490526316f1983160e01b909352620100009094048416936316f1983193610c199391169160c401611a42565b600060405180830381600087803b158015610c3357600080fd5b505af1158015610c47573d6000803e3d6000fd5b50505050836001600160a01b0316856001600160a01b0316826001600160a01b03167f85b3d9b3b871daf1d10c7ba1016854e371ab931adef5569172f0289515a9a6de3387604051610c9a929190611aa0565b60405180910390a45050505050565b6000808080610cba85870187611ab9565b6001600160a01b0380851660009081526004602052604090205494985092965090945092501680610cfd5760405162461bcd60e51b815260040161034490611832565b610d06816113fd565b610d1257610d1261187e565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610d52573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d769190611815565b9050856001600160a01b0316816001600160a01b031614610d9957610d9961187e565b6001600160a01b038116610daf57610daf61187e565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610df7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e1b9190611815565b6001600160a01b031614610e3157610e3161187e565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610e5f9087908790600401611aa0565b6020604051808303816000875af1158015610e7e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ea291906118f4565b610ebe5760405162461bcd60e51b815260040161034490611b0a565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fb26f02b79335e4b2c506d9e5ae02e042b464a7556419bbc42522fc92833aff528887604051610f0d929190611aa0565b60405180910390a45050505050505050565b6000808080610f3085870187611c27565b6001600160a01b03808516600090815260046020526040902054949950929750909550935016905080610f755760405162461bcd60e51b815260040161034490611832565b610f7e816113fd565b610f8a57610f8a61187e565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610fca573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fee9190611815565b9050856001600160a01b0316816001600160a01b0316146110115761101161187e565b6001600160a01b0381166110275761102761187e565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561106f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110939190611815565b6001600160a01b0316146110a9576110a961187e565b604051637c88e3d960e01b81526001600160a01b03831690637c88e3d9906110d79087908790600401611d19565b6020604051808303816000875af11580156110f6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061111a91906118f4565b6111365760405162461bcd60e51b815260040161034490611b0a565b846001600160a01b0316826001600160a01b0316876001600160a01b03167f7f51e520a281df2deae2754a9232b5a78c8cfeae79568668a0a97a116e1401b88787604051610f0d929190611d19565b6000808061119584860186611e0c565b91955093509150506001600160a01b0383166111b3576111b361187e565b6001600160a01b0383811660009081526004602052604090205416156111db576111db61187e565b6003546040516bffffffffffffffffffffffff19606086901b16602082015260009161122b916001600160a01b039091169060340160405160208183030381529060405280519060200120611492565b6001600160a01b0385811660009081526004602081905260409182902080546001600160a01b03191693851693841790559051639065714760e01b815292935090916390657147916112839188918891889101611e8b565b600060405180830381600087803b15801561129d57600080fd5b505af11580156112b1573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f0a1eaf9aa124c3f84c9dd77f7016af0f16f67639abb913af1697387db01f5ca590600090a3505050505050565b6001600160a01b0384161580159061131557506001600160a01b03831615155b801561132957506001600160a01b03821615155b801561133d57506001600160a01b03811615155b6113a25760405162461bcd60e51b815260206004820152603060248201527f4368696c644d696e7461626c654552433732315072656469636174653a20424160448201526f222fa4a724aa24a0a624ad20aa24a7a760811b6064820152608401610344565b600080546001600160a01b03958616620100000262010000600160b01b0319909116179055600180549385166001600160a01b0319948516179055600280549285169284169290921790915560038054919093169116179055565b6000816001600160a01b03163b60000361141957506000919050565b6040516301ffc9a760e01b81526380ac58cd60e01b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611480575060408051601f3d908101601f1916820190925261147d918101906118f4565b60015b61148c57506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b03811661148c5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b6044820152606401610344565b6001600160a01b038116811461153e57600080fd5b50565b60008083601f84011261155357600080fd5b5081356001600160401b0381111561156a57600080fd5b6020830191508360208260051b850101111561158557600080fd5b9250929050565b6000806000806000606086880312156115a457600080fd5b85356115af81611529565b945060208601356001600160401b03808211156115cb57600080fd5b6115d789838a01611541565b909650945060408801359150808211156115f057600080fd5b506115fd88828901611541565b969995985093965092949392505050565b60006020828403121561162057600080fd5b813561162b81611529565b9392505050565b60008060006060848603121561164757600080fd5b833561165281611529565b9250602084013561166281611529565b929592945050506040919091013590565b6000806040838503121561168657600080fd5b823561169181611529565b946020939093013593505050565b600080600080606085870312156116b557600080fd5b8435935060208501356116c781611529565b925060408501356001600160401b03808211156116e357600080fd5b818701915087601f8301126116f757600080fd5b81358181111561170657600080fd5b88602082850101111561171857600080fd5b95989497505060200194505050565b6000806000806080858703121561173d57600080fd5b843561174881611529565b9350602085013561175881611529565b9250604085013561176881611529565b9150606085013561177881611529565b939692955090935050565b6000808585111561179357600080fd5b838611156117a057600080fd5b5050820193919092039150565b8035602083101561148c57600019602084900360031b1b1692915050565b6020808252602a908201527f4368696c644d696e7461626c654552433732315072656469636174653a204e4f6040820152691517d0d3d395149050d560b21b606082015260800190565b60006020828403121561182757600080fd5b815161162b81611529565b6020808252602c908201527f4368696c644d696e7461626c654552433732315072656469636174653a20554e60408201526b26a0a82822a22faa27a5a2a760a11b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b038311156118ad57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b03841681526040602082018190526000906118eb9083018486611894565b95945050505050565b60006020828403121561190657600080fd5b8151801515811461162b57600080fd5b60208082526029908201527f4368696c644d696e7461626c654552433732315072656469636174653a204255604082015268149397d1905253115160ba1b606082015260800190565b8183526000602080850194508260005b8581101561199d57813561198281611529565b6001600160a01b03168752958201959082019060010161196f565b509495945050505050565b8781526001600160a01b0387811660208301528616604082015260a0606082018190526000906119db908301868861195f565b82810360808401526119ee818587611894565b9a9950505050505050505050565b6000815180845260005b81811015611a2257602081850181015186830182015201611a06565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611a66908301846119fc565b949350505050565b604081526000611a8260408301868861195f565b8281036020840152611a95818587611894565b979650505050505050565b6001600160a01b03929092168252602082015260400190565b60008060008060808587031215611acf57600080fd5b8435611ada81611529565b93506020850135611aea81611529565b92506040850135611afa81611529565b9396929550929360600135925050565b60208082526029908201527f4368696c644d696e7461626c654552433732315072656469636174653a204d49604082015268139517d1905253115160ba1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611b9157611b91611b53565b604052919050565b60006001600160401b03821115611bb257611bb2611b53565b5060051b60200190565b600082601f830112611bcd57600080fd5b81356020611be2611bdd83611b99565b611b69565b82815260059290921b84018101918181019086841115611c0157600080fd5b8286015b84811015611c1c5780358352918301918301611c05565b509695505050505050565b600080600080600060a08688031215611c3f57600080fd5b85359450602080870135611c5281611529565b94506040870135611c6281611529565b935060608701356001600160401b0380821115611c7e57600080fd5b818901915089601f830112611c9257600080fd5b8135611ca0611bdd82611b99565b81815260059190911b8301840190848101908c831115611cbf57600080fd5b938501935b82851015611ce6578435611cd781611529565b82529385019390850190611cc4565b965050506080890135925080831115611cfe57600080fd5b5050611d0c88828901611bbc565b9150509295509295909350565b604080825283519082018190526000906020906060840190828701845b82811015611d5b5781516001600160a01b031684529284019290840190600101611d36565b5050508381038285015284518082528583019183019060005b81811015611d9057835183529284019291840191600101611d74565b5090979650505050505050565b600082601f830112611dae57600080fd5b81356001600160401b03811115611dc757611dc7611b53565b611dda601f8201601f1916602001611b69565b818152846020838601011115611def57600080fd5b816020850160208301376000918101602001919091529392505050565b60008060008060808587031215611e2257600080fd5b843593506020850135611e3481611529565b925060408501356001600160401b0380821115611e5057600080fd5b611e5c88838901611d9d565b93506060870135915080821115611e7257600080fd5b50611e7f87828801611d9d565b91505092959194509250565b6001600160a01b0384168152606060208201819052600090611eaf908301856119fc565b8281036040840152611ec181856119fc565b969550505050505056fea264697066735822122033e4a7fc99de8d907b46e0e352c2feaea0b43d47f4a2303e6d491ab60c6afeed64736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100d55760003560e01c8063cb10f94c11610087578063cb10f94c146101ca578063d41f1771146101e3578063d7c9e3ec1461020a578063f3fef3a314610231578063f43cda8b14610244578063f645125514610257578063f691325c1461027e578063f8c8765e1461029157600080fd5b80636f33e695146100da5780637efab4f5146100ef57806395c7041c14610135578063b176806514610148578063b68ad1e41461017d578063c3b35a7e14610190578063c5ac2b1c146101a3575b600080fd5b6100ed6100e836600461158c565b6102a4565b005b6101186100fd36600461160e565b6004602052600090815260409020546001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b600154610118906001600160a01b031681565b61016f7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60405190815260200161012c565b600354610118906001600160a01b031681565b6100ed61019e366004611632565b6102b8565b61016f7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b600054610118906201000090046001600160a01b031681565b61016f7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61016f7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b6100ed61023f366004611673565b6102c8565b6100ed61025236600461169f565b6102d7565b61016f7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b600254610118906001600160a01b031681565b6100ed61029f366004611727565b61050f565b6102b18585858585610627565b5050505050565b6102c383838361099a565b505050565b6102d382338361099a565b5050565b6001546001600160a01b0316331461034d5760405162461bcd60e51b815260206004820152602e60248201527f4368696c644d696e7461626c654552433732315072656469636174653a204f4e60448201526d262cafa2ac24aa2fa422a62822a960911b60648201526084015b60405180910390fd5b6002546001600160a01b038481169116146103c45760405162461bcd60e51b815260206004820152603160248201527f4368696c644d696e7461626c654552433732315072656469636174653a204f4e6044820152704c595f524f4f545f50524544494341544560781b6064820152608401610344565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216103f3602060008486611783565b6103fc916117ad565b0361041b576104166104118260208186611783565b610ca9565b610509565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1861044a602060008486611783565b610453916117ad565b03610462576104168282610f1f565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad610491602060008486611783565b61049a916117ad565b036104a9576104168282611185565b60405162461bcd60e51b815260206004820152602f60248201527f4368696c644d696e7461626c654552433732315072656469636174653a20494e60448201526e56414c49445f5349474e415455524560881b6064820152608401610344565b50505050565b600054610100900460ff161580801561052f5750600054600160ff909116105b806105495750303b158015610549575060005460ff166001145b6105ac5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610344565b6000805460ff1916600117905580156105cf576000805461ff0019166101001790555b6105db858585856112f5565b80156102b1576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b84610631816113fd565b61064d5760405162461bcd60e51b8152600401610344906117cb565b6000866001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561068d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906106b19190611815565b6001600160a01b038181166000908152600460205260409020549192508881169116146106f05760405162461bcd60e51b815260040161034490611832565b6001600160a01b0381166107065761070661187e565b306001600160a01b0316876001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561074e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107729190611815565b6001600160a01b0316146107885761078861187e565b8483146107ec5760405162461bcd60e51b815260206004820152602c60248201527f4368696c644d696e7461626c654552433732315072656469636174653a20494e60448201526b0ac82989288be988a9c8ea8960a31b6064820152608401610344565b60405163b2dc5dc360e01b81526001600160a01b0388169063b2dc5dc39061081c903390889088906004016118c6565b6020604051808303816000875af115801561083b573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061085f91906118f4565b61087b5760405162461bcd60e51b815260040161034490611916565b6000546002546040516001600160a01b03620100009093048316926316f198319216906108d8907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908d908d908d908d906020016119a8565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610904929190611a42565b600060405180830381600087803b15801561091e57600080fd5b505af1158015610932573d6000803e3d6000fd5b50505050336001600160a01b0316876001600160a01b0316826001600160a01b03167f5faed28924bb6c5b0d3eea1cc028b4814f49c39eac622b81ef17035d794ac774898989896040516109899493929190611a6e565b60405180910390a450505050505050565b826109a4816113fd565b6109c05760405162461bcd60e51b8152600401610344906117cb565b6000846001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a00573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a249190611815565b6001600160a01b03818116600090815260046020526040902054919250868116911614610a635760405162461bcd60e51b815260040161034490611832565b6001600160a01b038116610a7957610a7961187e565b306001600160a01b0316856001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ac1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ae59190611815565b6001600160a01b031614610afb57610afb61187e565b604051632770a7eb60e21b81526001600160a01b03861690639dc29fac90610b299033908790600401611aa0565b6020604051808303816000875af1158015610b48573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b6c91906118f4565b610b885760405162461bcd60e51b815260040161034490611916565b600054600254604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152888116608083015260a08083018990528351808403909101815260c08301938490526316f1983160e01b909352620100009094048416936316f1983193610c199391169160c401611a42565b600060405180830381600087803b158015610c3357600080fd5b505af1158015610c47573d6000803e3d6000fd5b50505050836001600160a01b0316856001600160a01b0316826001600160a01b03167f85b3d9b3b871daf1d10c7ba1016854e371ab931adef5569172f0289515a9a6de3387604051610c9a929190611aa0565b60405180910390a45050505050565b6000808080610cba85870187611ab9565b6001600160a01b0380851660009081526004602052604090205494985092965090945092501680610cfd5760405162461bcd60e51b815260040161034490611832565b610d06816113fd565b610d1257610d1261187e565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610d52573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d769190611815565b9050856001600160a01b0316816001600160a01b031614610d9957610d9961187e565b6001600160a01b038116610daf57610daf61187e565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610df7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e1b9190611815565b6001600160a01b031614610e3157610e3161187e565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610e5f9087908790600401611aa0565b6020604051808303816000875af1158015610e7e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ea291906118f4565b610ebe5760405162461bcd60e51b815260040161034490611b0a565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fb26f02b79335e4b2c506d9e5ae02e042b464a7556419bbc42522fc92833aff528887604051610f0d929190611aa0565b60405180910390a45050505050505050565b6000808080610f3085870187611c27565b6001600160a01b03808516600090815260046020526040902054949950929750909550935016905080610f755760405162461bcd60e51b815260040161034490611832565b610f7e816113fd565b610f8a57610f8a61187e565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610fca573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fee9190611815565b9050856001600160a01b0316816001600160a01b0316146110115761101161187e565b6001600160a01b0381166110275761102761187e565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561106f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110939190611815565b6001600160a01b0316146110a9576110a961187e565b604051637c88e3d960e01b81526001600160a01b03831690637c88e3d9906110d79087908790600401611d19565b6020604051808303816000875af11580156110f6573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061111a91906118f4565b6111365760405162461bcd60e51b815260040161034490611b0a565b846001600160a01b0316826001600160a01b0316876001600160a01b03167f7f51e520a281df2deae2754a9232b5a78c8cfeae79568668a0a97a116e1401b88787604051610f0d929190611d19565b6000808061119584860186611e0c565b91955093509150506001600160a01b0383166111b3576111b361187e565b6001600160a01b0383811660009081526004602052604090205416156111db576111db61187e565b6003546040516bffffffffffffffffffffffff19606086901b16602082015260009161122b916001600160a01b039091169060340160405160208183030381529060405280519060200120611492565b6001600160a01b0385811660009081526004602081905260409182902080546001600160a01b03191693851693841790559051639065714760e01b815292935090916390657147916112839188918891889101611e8b565b600060405180830381600087803b15801561129d57600080fd5b505af11580156112b1573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f0a1eaf9aa124c3f84c9dd77f7016af0f16f67639abb913af1697387db01f5ca590600090a3505050505050565b6001600160a01b0384161580159061131557506001600160a01b03831615155b801561132957506001600160a01b03821615155b801561133d57506001600160a01b03811615155b6113a25760405162461bcd60e51b815260206004820152603060248201527f4368696c644d696e7461626c654552433732315072656469636174653a20424160448201526f222fa4a724aa24a0a624ad20aa24a7a760811b6064820152608401610344565b600080546001600160a01b03958616620100000262010000600160b01b0319909116179055600180549385166001600160a01b0319948516179055600280549285169284169290921790915560038054919093169116179055565b6000816001600160a01b03163b60000361141957506000919050565b6040516301ffc9a760e01b81526380ac58cd60e01b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa925050508015611480575060408051601f3d908101601f1916820190925261147d918101906118f4565b60015b61148c57506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b03811661148c5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b6044820152606401610344565b6001600160a01b038116811461153e57600080fd5b50565b60008083601f84011261155357600080fd5b5081356001600160401b0381111561156a57600080fd5b6020830191508360208260051b850101111561158557600080fd5b9250929050565b6000806000806000606086880312156115a457600080fd5b85356115af81611529565b945060208601356001600160401b03808211156115cb57600080fd5b6115d789838a01611541565b909650945060408801359150808211156115f057600080fd5b506115fd88828901611541565b969995985093965092949392505050565b60006020828403121561162057600080fd5b813561162b81611529565b9392505050565b60008060006060848603121561164757600080fd5b833561165281611529565b9250602084013561166281611529565b929592945050506040919091013590565b6000806040838503121561168657600080fd5b823561169181611529565b946020939093013593505050565b600080600080606085870312156116b557600080fd5b8435935060208501356116c781611529565b925060408501356001600160401b03808211156116e357600080fd5b818701915087601f8301126116f757600080fd5b81358181111561170657600080fd5b88602082850101111561171857600080fd5b95989497505060200194505050565b6000806000806080858703121561173d57600080fd5b843561174881611529565b9350602085013561175881611529565b9250604085013561176881611529565b9150606085013561177881611529565b939692955090935050565b6000808585111561179357600080fd5b838611156117a057600080fd5b5050820193919092039150565b8035602083101561148c57600019602084900360031b1b1692915050565b6020808252602a908201527f4368696c644d696e7461626c654552433732315072656469636174653a204e4f6040820152691517d0d3d395149050d560b21b606082015260800190565b60006020828403121561182757600080fd5b815161162b81611529565b6020808252602c908201527f4368696c644d696e7461626c654552433732315072656469636174653a20554e60408201526b26a0a82822a22faa27a5a2a760a11b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b038311156118ad57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b03841681526040602082018190526000906118eb9083018486611894565b95945050505050565b60006020828403121561190657600080fd5b8151801515811461162b57600080fd5b60208082526029908201527f4368696c644d696e7461626c654552433732315072656469636174653a204255604082015268149397d1905253115160ba1b606082015260800190565b8183526000602080850194508260005b8581101561199d57813561198281611529565b6001600160a01b03168752958201959082019060010161196f565b509495945050505050565b8781526001600160a01b0387811660208301528616604082015260a0606082018190526000906119db908301868861195f565b82810360808401526119ee818587611894565b9a9950505050505050505050565b6000815180845260005b81811015611a2257602081850181015186830182015201611a06565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611a66908301846119fc565b949350505050565b604081526000611a8260408301868861195f565b8281036020840152611a95818587611894565b979650505050505050565b6001600160a01b03929092168252602082015260400190565b60008060008060808587031215611acf57600080fd5b8435611ada81611529565b93506020850135611aea81611529565b92506040850135611afa81611529565b9396929550929360600135925050565b60208082526029908201527f4368696c644d696e7461626c654552433732315072656469636174653a204d49604082015268139517d1905253115160ba1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611b9157611b91611b53565b604052919050565b60006001600160401b03821115611bb257611bb2611b53565b5060051b60200190565b600082601f830112611bcd57600080fd5b81356020611be2611bdd83611b99565b611b69565b82815260059290921b84018101918181019086841115611c0157600080fd5b8286015b84811015611c1c5780358352918301918301611c05565b509695505050505050565b600080600080600060a08688031215611c3f57600080fd5b85359450602080870135611c5281611529565b94506040870135611c6281611529565b935060608701356001600160401b0380821115611c7e57600080fd5b818901915089601f830112611c9257600080fd5b8135611ca0611bdd82611b99565b81815260059190911b8301840190848101908c831115611cbf57600080fd5b938501935b82851015611ce6578435611cd781611529565b82529385019390850190611cc4565b965050506080890135925080831115611cfe57600080fd5b5050611d0c88828901611bbc565b9150509295509295909350565b604080825283519082018190526000906020906060840190828701845b82811015611d5b5781516001600160a01b031684529284019290840190600101611d36565b5050508381038285015284518082528583019183019060005b81811015611d9057835183529284019291840191600101611d74565b5090979650505050505050565b600082601f830112611dae57600080fd5b81356001600160401b03811115611dc757611dc7611b53565b611dda601f8201601f1916602001611b69565b818152846020838601011115611def57600080fd5b816020850160208301376000918101602001919091529392505050565b60008060008060808587031215611e2257600080fd5b843593506020850135611e3481611529565b925060408501356001600160401b0380821115611e5057600080fd5b611e5c88838901611d9d565b93506060870135915080821115611e7257600080fd5b50611e7f87828801611d9d565b91505092959194509250565b6001600160a01b0384168152606060208201819052600090611eaf908301856119fc565b8281036040840152611ec181856119fc565b969550505050505056fea264697066735822122033e4a7fc99de8d907b46e0e352c2feaea0b43d47f4a2303e6d491ab60c6afeed64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var MockERC1155Artifact string = `{"_format":"hh-sol-artifact-1","contractName":"MockERC1155","sourceName":"contracts/mocks/MockERC1155.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"TransferBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"TransferSingle","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"value","type":"string"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"}],"name":"URI","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MINTER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"PAUSER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"}],"name":"balanceOfBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"burnBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"mintBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeBatchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"uri","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"}],"bytecode":"0x60806040523480156200001157600080fd5b506040805180820190915260058152646c6f72656d60d81b6020820152806200003a81620000b1565b506005805460ff1916905562000052600033620000c3565b6200007e7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a633620000c3565b620000aa7f65d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440d862a33620000c3565b5062000376565b6004620000bf8282620002aa565b5050565b620000bf8282620000d58282620000f4565b6000828152600160205260409020620000ef908262000194565b505050565b6000828152602081815260408083206001600160a01b038516845290915290205460ff16620000bf576000828152602081815260408083206001600160a01b03851684529091529020805460ff19166001179055620001503390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000620001ab836001600160a01b038416620001b4565b90505b92915050565b6000818152600183016020526040812054620001fd57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155620001ae565b506000620001ae565b634e487b7160e01b600052604160045260246000fd5b600181811c908216806200023157607f821691505b6020821081036200025257634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115620000ef57600081815260208120601f850160051c81016020861015620002815750805b601f850160051c820191505b81811015620002a2578281556001016200028d565b505050505050565b81516001600160401b03811115620002c657620002c662000206565b620002de81620002d784546200021c565b8462000258565b602080601f831160018114620003165760008415620002fd5750858301515b600019600386901b1c1916600185901b178555620002a2565b600085815260208120601f198616915b82811015620003475788860151825594840194600190910190840162000326565b5085821015620003665787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6128a080620003866000396000f3fe608060405234801561001057600080fd5b50600436106101625760003560e01c8063731133e9116100ce578063ca15c87311610087578063ca15c873146102fb578063d53913931461030e578063d547741f14610323578063e63ab1e914610336578063e985e9c51461034b578063f242432a14610387578063f5298aca1461039a57600080fd5b8063731133e9146102875780638456cb591461029a5780639010d07c146102a257806391d14854146102cd578063a217fddf146102e0578063a22cb465146102e857600080fd5b80632f2ff15d116101205780632f2ff15d1461021b57806336568abe1461022e5780633f4ba83a146102415780634e1273f4146102495780635c975abb146102695780636b20c4541461027457600080fd5b8062fdd58e1461016757806301ffc9a71461018d5780630e89341c146101b05780631f7fdffa146101d0578063248a9ca3146101e55780632eb2c2d614610208575b600080fd5b61017a610175366004611bd7565b6103ad565b6040519081526020015b60405180910390f35b6101a061019b366004611c17565b610448565b6040519015158152602001610184565b6101c36101be366004611c34565b610453565b6040516101849190611c9d565b6101e36101de366004611df9565b6104e7565b005b61017a6101f3366004611c34565b60009081526020819052604090206001015490565b6101e3610216366004611e91565b61052d565b6101e3610229366004611f3a565b610579565b6101e361023c366004611f3a565b6105a3565b6101e3610621565b61025c610257366004611f66565b6106a3565b604051610184919061206b565b60055460ff166101a0565b6101e361028236600461207e565b6107cc565b6101e36102953660046120f1565b61080f565b6101e361084f565b6102b56102b0366004612145565b6108cb565b6040516001600160a01b039091168152602001610184565b6101a06102db366004611f3a565b6108ea565b61017a600081565b6101e36102f6366004612167565b610913565b61017a610309366004611c34565b61091e565b61017a60008051602061284b83398151915281565b6101e3610331366004611f3a565b610935565b61017a60008051602061282b83398151915281565b6101a06103593660046121a3565b6001600160a01b03918216600090815260036020908152604080832093909416825291909152205460ff1690565b6101e36103953660046121cd565b61095a565b6101e36103a8366004612231565b61099f565b60006001600160a01b03831661041d5760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b5060008181526002602090815260408083206001600160a01b03861684529091529020545b92915050565b6000610442826109e2565b60606004805461046290612264565b80601f016020809104026020016040519081016040528092919081815260200182805461048e90612264565b80156104db5780601f106104b0576101008083540402835291602001916104db565b820191906000526020600020905b8154815290600101906020018083116104be57829003601f168201915b50505050509050919050565b6104ff60008051602061284b833981519152336108ea565b61051b5760405162461bcd60e51b81526004016104149061229e565b61052784848484610a22565b50505050565b6001600160a01b03851633148061054957506105498533610359565b6105655760405162461bcd60e51b8152600401610414906122e4565b6105728585858585610b6b565b5050505050565b60008281526020819052604090206001015461059481610d06565b61059e8383610d13565b505050565b6001600160a01b03811633146106135760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608401610414565b61061d8282610d35565b5050565b61063960008051602061282b833981519152336108ea565b6106995760405162461bcd60e51b815260206004820152603b60248201526000805160206127eb83398151915260448201527f686176652070617573657220726f6c6520746f20756e706175736500000000006064820152608401610414565b6106a1610d57565b565b606081518351146107085760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b6064820152608401610414565b600083516001600160401b0381111561072357610723611cb0565b60405190808252806020026020018201604052801561074c578160200160208202803683370190505b50905060005b84518110156107c45761079785828151811061077057610770612332565b602002602001015185838151811061078a5761078a612332565b60200260200101516103ad565b8282815181106107a9576107a9612332565b60209081029190910101526107bd8161235e565b9050610752565b509392505050565b6001600160a01b0383163314806107e857506107e88333610359565b6108045760405162461bcd60e51b8152600401610414906122e4565b61059e838383610da9565b61082760008051602061284b833981519152336108ea565b6108435760405162461bcd60e51b81526004016104149061229e565b61052784848484610f36565b61086760008051602061282b833981519152336108ea565b6108c35760405162461bcd60e51b815260206004820152603960248201526000805160206127eb833981519152604482015278686176652070617573657220726f6c6520746f20706175736560381b6064820152608401610414565b6106a161100f565b60008281526001602052604081206108e3908361104c565b9392505050565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b61061d338383611058565b600081815260016020526040812061044290611138565b60008281526020819052604090206001015461095081610d06565b61059e8383610d35565b6001600160a01b03851633148061097657506109768533610359565b6109925760405162461bcd60e51b8152600401610414906122e4565b6105728585858585611142565b6001600160a01b0383163314806109bb57506109bb8333610359565b6109d75760405162461bcd60e51b8152600401610414906122e4565b61059e83838361126c565b60006001600160e01b03198216636cdb3d1360e11b1480610a1357506001600160e01b031982166303a24d0760e21b145b80610442575061044282611376565b6001600160a01b038416610a485760405162461bcd60e51b815260040161041490612377565b8151835114610a695760405162461bcd60e51b8152600401610414906123b8565b33610a798160008787878761139b565b60005b8451811015610b1557838181518110610a9757610a97612332565b602002602001015160026000878481518110610ab557610ab5612332565b602002602001015181526020019081526020016000206000886001600160a01b03166001600160a01b031681526020019081526020016000206000828254610afd9190612400565b90915550819050610b0d8161235e565b915050610a7c565b50846001600160a01b031660006001600160a01b0316826001600160a01b03166000805160206127cb8339815191528787604051610b54929190612413565b60405180910390a4610572816000878787876113a9565b8151835114610b8c5760405162461bcd60e51b8152600401610414906123b8565b6001600160a01b038416610bb25760405162461bcd60e51b815260040161041490612441565b33610bc181878787878761139b565b60005b8451811015610caa576000858281518110610be157610be1612332565b602002602001015190506000858381518110610bff57610bff612332565b60209081029190910181015160008481526002835260408082206001600160a01b038e168352909352919091205490915081811015610c505760405162461bcd60e51b815260040161041490612486565b60008381526002602090815260408083206001600160a01b038e8116855292528083208585039055908b16825281208054849290610c8f908490612400565b9250508190555050505080610ca39061235e565b9050610bc4565b50846001600160a01b0316866001600160a01b0316826001600160a01b03166000805160206127cb8339815191528787604051610ce8929190612413565b60405180910390a4610cfe8187878787876113a9565b505050505050565b610d108133611504565b50565b610d1d828261155d565b600082815260016020526040902061059e90826115e1565b610d3f82826115f6565b600082815260016020526040902061059e908261165b565b610d5f611670565b6005805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6001600160a01b038316610dcf5760405162461bcd60e51b8152600401610414906124d0565b8051825114610df05760405162461bcd60e51b8152600401610414906123b8565b6000339050610e138185600086866040518060200160405280600081525061139b565b60005b8351811015610edb576000848281518110610e3357610e33612332565b602002602001015190506000848381518110610e5157610e51612332565b60209081029190910181015160008481526002835260408082206001600160a01b038c168352909352919091205490915081811015610ea25760405162461bcd60e51b815260040161041490612513565b60009283526002602090815260408085206001600160a01b038b1686529091529092209103905580610ed38161235e565b915050610e16565b5060006001600160a01b0316846001600160a01b0316826001600160a01b03166000805160206127cb8339815191528686604051610f1a929190612413565b60405180910390a4604080516020810190915260009052610527565b6001600160a01b038416610f5c5760405162461bcd60e51b815260040161041490612377565b336000610f68856116b9565b90506000610f75856116b9565b9050610f868360008985858961139b565b60008681526002602090815260408083206001600160a01b038b16845290915281208054879290610fb8908490612400565b909155505060408051878152602081018790526001600160a01b03808a16926000929187169160008051602061280b833981519152910160405180910390a461100683600089898989611704565b50505050505050565b6110176117bf565b6005805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610d8c3390565b60006108e38383611805565b816001600160a01b0316836001600160a01b0316036110cb5760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b6064820152608401610414565b6001600160a01b03838116600081815260036020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6000610442825490565b6001600160a01b0384166111685760405162461bcd60e51b815260040161041490612441565b336000611174856116b9565b90506000611181856116b9565b905061119183898985858961139b565b60008681526002602090815260408083206001600160a01b038c168452909152902054858110156111d45760405162461bcd60e51b815260040161041490612486565b60008781526002602090815260408083206001600160a01b038d8116855292528083208985039055908a16825281208054889290611213908490612400565b909155505060408051888152602081018890526001600160a01b03808b16928c8216929188169160008051602061280b833981519152910160405180910390a4611261848a8a8a8a8a611704565b505050505050505050565b6001600160a01b0383166112925760405162461bcd60e51b8152600401610414906124d0565b33600061129e846116b9565b905060006112ab846116b9565b90506112cb8387600085856040518060200160405280600081525061139b565b60008581526002602090815260408083206001600160a01b038a1684529091529020548481101561130e5760405162461bcd60e51b815260040161041490612513565b60008681526002602090815260408083206001600160a01b038b81168086529184528285208a8703905582518b81529384018a905290929088169160008051602061280b833981519152910160405180910390a4604080516020810190915260009052611006565b60006001600160e01b03198216635a05180f60e01b148061044257506104428261182f565b610cfe868686868686611864565b6001600160a01b0384163b15610cfe5760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906113ed9089908990889088908890600401612557565b6020604051808303816000875af1925050508015611428575060408051601f3d908101601f19168201909252611425918101906125b5565b60015b6114d4576114346125d2565b806308c379a00361146d57506114486125ee565b80611453575061146f565b8060405162461bcd60e51b81526004016104149190611c9d565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b6064820152608401610414565b6001600160e01b0319811663bc197c8160e01b146110065760405162461bcd60e51b815260040161041490612677565b61150e82826108ea565b61061d5761151b816118cc565b6115268360206118de565b6040516020016115379291906126bf565b60408051601f198184030181529082905262461bcd60e51b825261041491600401611c9d565b61156782826108ea565b61061d576000828152602081815260408083206001600160a01b03851684529091529020805460ff1916600117905561159d3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b60006108e3836001600160a01b038416611a79565b61160082826108ea565b1561061d576000828152602081815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b60006108e3836001600160a01b038416611ac8565b60055460ff166106a15760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610414565b604080516001808252818301909252606091600091906020808301908036833701905050905082816000815181106116f3576116f3612332565b602090810291909101015292915050565b6001600160a01b0384163b15610cfe5760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e6190611748908990899088908890889060040161272e565b6020604051808303816000875af1925050508015611783575060408051601f3d908101601f19168201909252611780918101906125b5565b60015b61178f576114346125d2565b6001600160e01b0319811663f23a6e6160e01b146110065760405162461bcd60e51b815260040161041490612677565b60055460ff16156106a15760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610414565b600082600001828154811061181c5761181c612332565b9060005260206000200154905092915050565b60006001600160e01b03198216637965db0b60e01b148061044257506301ffc9a760e01b6001600160e01b0319831614610442565b60055460ff1615610cfe5760405162461bcd60e51b815260206004820152602c60248201527f455243313135355061757361626c653a20746f6b656e207472616e736665722060448201526b1dda1a5b19481c185d5cd95960a21b6064820152608401610414565b60606104426001600160a01b03831660145b606060006118ed836002612773565b6118f8906002612400565b6001600160401b0381111561190f5761190f611cb0565b6040519080825280601f01601f191660200182016040528015611939576020820181803683370190505b509050600360fc1b8160008151811061195457611954612332565b60200101906001600160f81b031916908160001a905350600f60fb1b8160018151811061198357611983612332565b60200101906001600160f81b031916908160001a90535060006119a7846002612773565b6119b2906001612400565b90505b6001811115611a2a576f181899199a1a9b1b9c1cb0b131b232b360811b85600f16601081106119e6576119e6612332565b1a60f81b8282815181106119fc576119fc612332565b60200101906001600160f81b031916908160001a90535060049490941c93611a238161278a565b90506119b5565b5083156108e35760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610414565b6000818152600183016020526040812054611ac057508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610442565b506000610442565b60008181526001830160205260408120548015611bb1576000611aec6001836127a1565b8554909150600090611b00906001906127a1565b9050818114611b65576000866000018281548110611b2057611b20612332565b9060005260206000200154905080876000018481548110611b4357611b43612332565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080611b7657611b766127b4565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610442565b6000915050610442565b80356001600160a01b0381168114611bd257600080fd5b919050565b60008060408385031215611bea57600080fd5b611bf383611bbb565b946020939093013593505050565b6001600160e01b031981168114610d1057600080fd5b600060208284031215611c2957600080fd5b81356108e381611c01565b600060208284031215611c4657600080fd5b5035919050565b60005b83811015611c68578181015183820152602001611c50565b50506000910152565b60008151808452611c89816020860160208601611c4d565b601f01601f19169290920160200192915050565b6020815260006108e36020830184611c71565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b0381118282101715611ceb57611ceb611cb0565b6040525050565b60006001600160401b03821115611d0b57611d0b611cb0565b5060051b60200190565b600082601f830112611d2657600080fd5b81356020611d3382611cf2565b604051611d408282611cc6565b83815260059390931b8501820192828101915086841115611d6057600080fd5b8286015b84811015611d7b5780358352918301918301611d64565b509695505050505050565b600082601f830112611d9757600080fd5b81356001600160401b03811115611db057611db0611cb0565b604051611dc7601f8301601f191660200182611cc6565b818152846020838601011115611ddc57600080fd5b816020850160208301376000918101602001919091529392505050565b60008060008060808587031215611e0f57600080fd5b611e1885611bbb565b935060208501356001600160401b0380821115611e3457600080fd5b611e4088838901611d15565b94506040870135915080821115611e5657600080fd5b611e6288838901611d15565b93506060870135915080821115611e7857600080fd5b50611e8587828801611d86565b91505092959194509250565b600080600080600060a08688031215611ea957600080fd5b611eb286611bbb565b9450611ec060208701611bbb565b935060408601356001600160401b0380821115611edc57600080fd5b611ee889838a01611d15565b94506060880135915080821115611efe57600080fd5b611f0a89838a01611d15565b93506080880135915080821115611f2057600080fd5b50611f2d88828901611d86565b9150509295509295909350565b60008060408385031215611f4d57600080fd5b82359150611f5d60208401611bbb565b90509250929050565b60008060408385031215611f7957600080fd5b82356001600160401b0380821115611f9057600080fd5b818501915085601f830112611fa457600080fd5b81356020611fb182611cf2565b604051611fbe8282611cc6565b83815260059390931b8501820192828101915089841115611fde57600080fd5b948201945b8386101561200357611ff486611bbb565b82529482019490820190611fe3565b9650508601359250508082111561201957600080fd5b5061202685828601611d15565b9150509250929050565b600081518084526020808501945080840160005b8381101561206057815187529582019590820190600101612044565b509495945050505050565b6020815260006108e36020830184612030565b60008060006060848603121561209357600080fd5b61209c84611bbb565b925060208401356001600160401b03808211156120b857600080fd5b6120c487838801611d15565b935060408601359150808211156120da57600080fd5b506120e786828701611d15565b9150509250925092565b6000806000806080858703121561210757600080fd5b61211085611bbb565b9350602085013592506040850135915060608501356001600160401b0381111561213957600080fd5b611e8587828801611d86565b6000806040838503121561215857600080fd5b50508035926020909101359150565b6000806040838503121561217a57600080fd5b61218383611bbb565b91506020830135801515811461219857600080fd5b809150509250929050565b600080604083850312156121b657600080fd5b6121bf83611bbb565b9150611f5d60208401611bbb565b600080600080600060a086880312156121e557600080fd5b6121ee86611bbb565b94506121fc60208701611bbb565b9350604086013592506060860135915060808601356001600160401b0381111561222557600080fd5b611f2d88828901611d86565b60008060006060848603121561224657600080fd5b61224f84611bbb565b95602085013595506040909401359392505050565b600181811c9082168061227857607f821691505b60208210810361229857634e487b7160e01b600052602260045260246000fd5b50919050565b60208082526038908201526000805160206127eb8339815191526040820152771a185d99481b5a5b9d195c881c9bdb19481d1bc81b5a5b9d60421b606082015260800190565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60006001820161237057612370612348565b5060010190565b60208082526021908201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736040820152607360f81b606082015260800190565b60208082526028908201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206040820152670dad2e6dac2e8c6d60c31b606082015260800190565b8082018082111561044257610442612348565b6040815260006124266040830185612030565b82810360208401526124388185612030565b95945050505050565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b60208082526023908201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260408201526265737360e81b606082015260800190565b60208082526024908201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604082015263616e636560e01b606082015260800190565b6001600160a01b0386811682528516602082015260a06040820181905260009061258390830186612030565b82810360608401526125958186612030565b905082810360808401526125a98185611c71565b98975050505050505050565b6000602082840312156125c757600080fd5b81516108e381611c01565b600060033d11156125eb5760046000803e5060005160e01c5b90565b600060443d10156125fc5790565b6040516003193d81016004833e81513d6001600160401b03816024840111818411171561262b57505050505090565b82850191508151818111156126435750505050505090565b843d870101602082850101111561265d5750505050505090565b61266c60208286010187611cc6565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b76020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b8152600083516126f1816017850160208801611c4d565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351612722816028840160208801611c4d565b01602801949350505050565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061276890830184611c71565b979650505050505050565b808202811582820484141761044257610442612348565b60008161279957612799612348565b506000190190565b8181038181111561044257610442612348565b634e487b7160e01b600052603160045260246000fdfe4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb455243313135355072657365744d696e7465725061757365723a206d75737420c3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f6265d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440d862a9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6a2646970667358221220294efe154e549198ff0c6b7ab7e9846223d9e8fe7ae7de1938f6eb7d0f5e66a664736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101625760003560e01c8063731133e9116100ce578063ca15c87311610087578063ca15c873146102fb578063d53913931461030e578063d547741f14610323578063e63ab1e914610336578063e985e9c51461034b578063f242432a14610387578063f5298aca1461039a57600080fd5b8063731133e9146102875780638456cb591461029a5780639010d07c146102a257806391d14854146102cd578063a217fddf146102e0578063a22cb465146102e857600080fd5b80632f2ff15d116101205780632f2ff15d1461021b57806336568abe1461022e5780633f4ba83a146102415780634e1273f4146102495780635c975abb146102695780636b20c4541461027457600080fd5b8062fdd58e1461016757806301ffc9a71461018d5780630e89341c146101b05780631f7fdffa146101d0578063248a9ca3146101e55780632eb2c2d614610208575b600080fd5b61017a610175366004611bd7565b6103ad565b6040519081526020015b60405180910390f35b6101a061019b366004611c17565b610448565b6040519015158152602001610184565b6101c36101be366004611c34565b610453565b6040516101849190611c9d565b6101e36101de366004611df9565b6104e7565b005b61017a6101f3366004611c34565b60009081526020819052604090206001015490565b6101e3610216366004611e91565b61052d565b6101e3610229366004611f3a565b610579565b6101e361023c366004611f3a565b6105a3565b6101e3610621565b61025c610257366004611f66565b6106a3565b604051610184919061206b565b60055460ff166101a0565b6101e361028236600461207e565b6107cc565b6101e36102953660046120f1565b61080f565b6101e361084f565b6102b56102b0366004612145565b6108cb565b6040516001600160a01b039091168152602001610184565b6101a06102db366004611f3a565b6108ea565b61017a600081565b6101e36102f6366004612167565b610913565b61017a610309366004611c34565b61091e565b61017a60008051602061284b83398151915281565b6101e3610331366004611f3a565b610935565b61017a60008051602061282b83398151915281565b6101a06103593660046121a3565b6001600160a01b03918216600090815260036020908152604080832093909416825291909152205460ff1690565b6101e36103953660046121cd565b61095a565b6101e36103a8366004612231565b61099f565b60006001600160a01b03831661041d5760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b5060008181526002602090815260408083206001600160a01b03861684529091529020545b92915050565b6000610442826109e2565b60606004805461046290612264565b80601f016020809104026020016040519081016040528092919081815260200182805461048e90612264565b80156104db5780601f106104b0576101008083540402835291602001916104db565b820191906000526020600020905b8154815290600101906020018083116104be57829003601f168201915b50505050509050919050565b6104ff60008051602061284b833981519152336108ea565b61051b5760405162461bcd60e51b81526004016104149061229e565b61052784848484610a22565b50505050565b6001600160a01b03851633148061054957506105498533610359565b6105655760405162461bcd60e51b8152600401610414906122e4565b6105728585858585610b6b565b5050505050565b60008281526020819052604090206001015461059481610d06565b61059e8383610d13565b505050565b6001600160a01b03811633146106135760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608401610414565b61061d8282610d35565b5050565b61063960008051602061282b833981519152336108ea565b6106995760405162461bcd60e51b815260206004820152603b60248201526000805160206127eb83398151915260448201527f686176652070617573657220726f6c6520746f20756e706175736500000000006064820152608401610414565b6106a1610d57565b565b606081518351146107085760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b6064820152608401610414565b600083516001600160401b0381111561072357610723611cb0565b60405190808252806020026020018201604052801561074c578160200160208202803683370190505b50905060005b84518110156107c45761079785828151811061077057610770612332565b602002602001015185838151811061078a5761078a612332565b60200260200101516103ad565b8282815181106107a9576107a9612332565b60209081029190910101526107bd8161235e565b9050610752565b509392505050565b6001600160a01b0383163314806107e857506107e88333610359565b6108045760405162461bcd60e51b8152600401610414906122e4565b61059e838383610da9565b61082760008051602061284b833981519152336108ea565b6108435760405162461bcd60e51b81526004016104149061229e565b61052784848484610f36565b61086760008051602061282b833981519152336108ea565b6108c35760405162461bcd60e51b815260206004820152603960248201526000805160206127eb833981519152604482015278686176652070617573657220726f6c6520746f20706175736560381b6064820152608401610414565b6106a161100f565b60008281526001602052604081206108e3908361104c565b9392505050565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b61061d338383611058565b600081815260016020526040812061044290611138565b60008281526020819052604090206001015461095081610d06565b61059e8383610d35565b6001600160a01b03851633148061097657506109768533610359565b6109925760405162461bcd60e51b8152600401610414906122e4565b6105728585858585611142565b6001600160a01b0383163314806109bb57506109bb8333610359565b6109d75760405162461bcd60e51b8152600401610414906122e4565b61059e83838361126c565b60006001600160e01b03198216636cdb3d1360e11b1480610a1357506001600160e01b031982166303a24d0760e21b145b80610442575061044282611376565b6001600160a01b038416610a485760405162461bcd60e51b815260040161041490612377565b8151835114610a695760405162461bcd60e51b8152600401610414906123b8565b33610a798160008787878761139b565b60005b8451811015610b1557838181518110610a9757610a97612332565b602002602001015160026000878481518110610ab557610ab5612332565b602002602001015181526020019081526020016000206000886001600160a01b03166001600160a01b031681526020019081526020016000206000828254610afd9190612400565b90915550819050610b0d8161235e565b915050610a7c565b50846001600160a01b031660006001600160a01b0316826001600160a01b03166000805160206127cb8339815191528787604051610b54929190612413565b60405180910390a4610572816000878787876113a9565b8151835114610b8c5760405162461bcd60e51b8152600401610414906123b8565b6001600160a01b038416610bb25760405162461bcd60e51b815260040161041490612441565b33610bc181878787878761139b565b60005b8451811015610caa576000858281518110610be157610be1612332565b602002602001015190506000858381518110610bff57610bff612332565b60209081029190910181015160008481526002835260408082206001600160a01b038e168352909352919091205490915081811015610c505760405162461bcd60e51b815260040161041490612486565b60008381526002602090815260408083206001600160a01b038e8116855292528083208585039055908b16825281208054849290610c8f908490612400565b9250508190555050505080610ca39061235e565b9050610bc4565b50846001600160a01b0316866001600160a01b0316826001600160a01b03166000805160206127cb8339815191528787604051610ce8929190612413565b60405180910390a4610cfe8187878787876113a9565b505050505050565b610d108133611504565b50565b610d1d828261155d565b600082815260016020526040902061059e90826115e1565b610d3f82826115f6565b600082815260016020526040902061059e908261165b565b610d5f611670565b6005805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b6001600160a01b038316610dcf5760405162461bcd60e51b8152600401610414906124d0565b8051825114610df05760405162461bcd60e51b8152600401610414906123b8565b6000339050610e138185600086866040518060200160405280600081525061139b565b60005b8351811015610edb576000848281518110610e3357610e33612332565b602002602001015190506000848381518110610e5157610e51612332565b60209081029190910181015160008481526002835260408082206001600160a01b038c168352909352919091205490915081811015610ea25760405162461bcd60e51b815260040161041490612513565b60009283526002602090815260408085206001600160a01b038b1686529091529092209103905580610ed38161235e565b915050610e16565b5060006001600160a01b0316846001600160a01b0316826001600160a01b03166000805160206127cb8339815191528686604051610f1a929190612413565b60405180910390a4604080516020810190915260009052610527565b6001600160a01b038416610f5c5760405162461bcd60e51b815260040161041490612377565b336000610f68856116b9565b90506000610f75856116b9565b9050610f868360008985858961139b565b60008681526002602090815260408083206001600160a01b038b16845290915281208054879290610fb8908490612400565b909155505060408051878152602081018790526001600160a01b03808a16926000929187169160008051602061280b833981519152910160405180910390a461100683600089898989611704565b50505050505050565b6110176117bf565b6005805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610d8c3390565b60006108e38383611805565b816001600160a01b0316836001600160a01b0316036110cb5760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b6064820152608401610414565b6001600160a01b03838116600081815260036020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6000610442825490565b6001600160a01b0384166111685760405162461bcd60e51b815260040161041490612441565b336000611174856116b9565b90506000611181856116b9565b905061119183898985858961139b565b60008681526002602090815260408083206001600160a01b038c168452909152902054858110156111d45760405162461bcd60e51b815260040161041490612486565b60008781526002602090815260408083206001600160a01b038d8116855292528083208985039055908a16825281208054889290611213908490612400565b909155505060408051888152602081018890526001600160a01b03808b16928c8216929188169160008051602061280b833981519152910160405180910390a4611261848a8a8a8a8a611704565b505050505050505050565b6001600160a01b0383166112925760405162461bcd60e51b8152600401610414906124d0565b33600061129e846116b9565b905060006112ab846116b9565b90506112cb8387600085856040518060200160405280600081525061139b565b60008581526002602090815260408083206001600160a01b038a1684529091529020548481101561130e5760405162461bcd60e51b815260040161041490612513565b60008681526002602090815260408083206001600160a01b038b81168086529184528285208a8703905582518b81529384018a905290929088169160008051602061280b833981519152910160405180910390a4604080516020810190915260009052611006565b60006001600160e01b03198216635a05180f60e01b148061044257506104428261182f565b610cfe868686868686611864565b6001600160a01b0384163b15610cfe5760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906113ed9089908990889088908890600401612557565b6020604051808303816000875af1925050508015611428575060408051601f3d908101601f19168201909252611425918101906125b5565b60015b6114d4576114346125d2565b806308c379a00361146d57506114486125ee565b80611453575061146f565b8060405162461bcd60e51b81526004016104149190611c9d565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b6064820152608401610414565b6001600160e01b0319811663bc197c8160e01b146110065760405162461bcd60e51b815260040161041490612677565b61150e82826108ea565b61061d5761151b816118cc565b6115268360206118de565b6040516020016115379291906126bf565b60408051601f198184030181529082905262461bcd60e51b825261041491600401611c9d565b61156782826108ea565b61061d576000828152602081815260408083206001600160a01b03851684529091529020805460ff1916600117905561159d3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b60006108e3836001600160a01b038416611a79565b61160082826108ea565b1561061d576000828152602081815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b60006108e3836001600160a01b038416611ac8565b60055460ff166106a15760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610414565b604080516001808252818301909252606091600091906020808301908036833701905050905082816000815181106116f3576116f3612332565b602090810291909101015292915050565b6001600160a01b0384163b15610cfe5760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e6190611748908990899088908890889060040161272e565b6020604051808303816000875af1925050508015611783575060408051601f3d908101601f19168201909252611780918101906125b5565b60015b61178f576114346125d2565b6001600160e01b0319811663f23a6e6160e01b146110065760405162461bcd60e51b815260040161041490612677565b60055460ff16156106a15760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610414565b600082600001828154811061181c5761181c612332565b9060005260206000200154905092915050565b60006001600160e01b03198216637965db0b60e01b148061044257506301ffc9a760e01b6001600160e01b0319831614610442565b60055460ff1615610cfe5760405162461bcd60e51b815260206004820152602c60248201527f455243313135355061757361626c653a20746f6b656e207472616e736665722060448201526b1dda1a5b19481c185d5cd95960a21b6064820152608401610414565b60606104426001600160a01b03831660145b606060006118ed836002612773565b6118f8906002612400565b6001600160401b0381111561190f5761190f611cb0565b6040519080825280601f01601f191660200182016040528015611939576020820181803683370190505b509050600360fc1b8160008151811061195457611954612332565b60200101906001600160f81b031916908160001a905350600f60fb1b8160018151811061198357611983612332565b60200101906001600160f81b031916908160001a90535060006119a7846002612773565b6119b2906001612400565b90505b6001811115611a2a576f181899199a1a9b1b9c1cb0b131b232b360811b85600f16601081106119e6576119e6612332565b1a60f81b8282815181106119fc576119fc612332565b60200101906001600160f81b031916908160001a90535060049490941c93611a238161278a565b90506119b5565b5083156108e35760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610414565b6000818152600183016020526040812054611ac057508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610442565b506000610442565b60008181526001830160205260408120548015611bb1576000611aec6001836127a1565b8554909150600090611b00906001906127a1565b9050818114611b65576000866000018281548110611b2057611b20612332565b9060005260206000200154905080876000018481548110611b4357611b43612332565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080611b7657611b766127b4565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610442565b6000915050610442565b80356001600160a01b0381168114611bd257600080fd5b919050565b60008060408385031215611bea57600080fd5b611bf383611bbb565b946020939093013593505050565b6001600160e01b031981168114610d1057600080fd5b600060208284031215611c2957600080fd5b81356108e381611c01565b600060208284031215611c4657600080fd5b5035919050565b60005b83811015611c68578181015183820152602001611c50565b50506000910152565b60008151808452611c89816020860160208601611c4d565b601f01601f19169290920160200192915050565b6020815260006108e36020830184611c71565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b0381118282101715611ceb57611ceb611cb0565b6040525050565b60006001600160401b03821115611d0b57611d0b611cb0565b5060051b60200190565b600082601f830112611d2657600080fd5b81356020611d3382611cf2565b604051611d408282611cc6565b83815260059390931b8501820192828101915086841115611d6057600080fd5b8286015b84811015611d7b5780358352918301918301611d64565b509695505050505050565b600082601f830112611d9757600080fd5b81356001600160401b03811115611db057611db0611cb0565b604051611dc7601f8301601f191660200182611cc6565b818152846020838601011115611ddc57600080fd5b816020850160208301376000918101602001919091529392505050565b60008060008060808587031215611e0f57600080fd5b611e1885611bbb565b935060208501356001600160401b0380821115611e3457600080fd5b611e4088838901611d15565b94506040870135915080821115611e5657600080fd5b611e6288838901611d15565b93506060870135915080821115611e7857600080fd5b50611e8587828801611d86565b91505092959194509250565b600080600080600060a08688031215611ea957600080fd5b611eb286611bbb565b9450611ec060208701611bbb565b935060408601356001600160401b0380821115611edc57600080fd5b611ee889838a01611d15565b94506060880135915080821115611efe57600080fd5b611f0a89838a01611d15565b93506080880135915080821115611f2057600080fd5b50611f2d88828901611d86565b9150509295509295909350565b60008060408385031215611f4d57600080fd5b82359150611f5d60208401611bbb565b90509250929050565b60008060408385031215611f7957600080fd5b82356001600160401b0380821115611f9057600080fd5b818501915085601f830112611fa457600080fd5b81356020611fb182611cf2565b604051611fbe8282611cc6565b83815260059390931b8501820192828101915089841115611fde57600080fd5b948201945b8386101561200357611ff486611bbb565b82529482019490820190611fe3565b9650508601359250508082111561201957600080fd5b5061202685828601611d15565b9150509250929050565b600081518084526020808501945080840160005b8381101561206057815187529582019590820190600101612044565b509495945050505050565b6020815260006108e36020830184612030565b60008060006060848603121561209357600080fd5b61209c84611bbb565b925060208401356001600160401b03808211156120b857600080fd5b6120c487838801611d15565b935060408601359150808211156120da57600080fd5b506120e786828701611d15565b9150509250925092565b6000806000806080858703121561210757600080fd5b61211085611bbb565b9350602085013592506040850135915060608501356001600160401b0381111561213957600080fd5b611e8587828801611d86565b6000806040838503121561215857600080fd5b50508035926020909101359150565b6000806040838503121561217a57600080fd5b61218383611bbb565b91506020830135801515811461219857600080fd5b809150509250929050565b600080604083850312156121b657600080fd5b6121bf83611bbb565b9150611f5d60208401611bbb565b600080600080600060a086880312156121e557600080fd5b6121ee86611bbb565b94506121fc60208701611bbb565b9350604086013592506060860135915060808601356001600160401b0381111561222557600080fd5b611f2d88828901611d86565b60008060006060848603121561224657600080fd5b61224f84611bbb565b95602085013595506040909401359392505050565b600181811c9082168061227857607f821691505b60208210810361229857634e487b7160e01b600052602260045260246000fd5b50919050565b60208082526038908201526000805160206127eb8339815191526040820152771a185d99481b5a5b9d195c881c9bdb19481d1bc81b5a5b9d60421b606082015260800190565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60006001820161237057612370612348565b5060010190565b60208082526021908201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736040820152607360f81b606082015260800190565b60208082526028908201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206040820152670dad2e6dac2e8c6d60c31b606082015260800190565b8082018082111561044257610442612348565b6040815260006124266040830185612030565b82810360208401526124388185612030565b95945050505050565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b60208082526023908201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260408201526265737360e81b606082015260800190565b60208082526024908201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604082015263616e636560e01b606082015260800190565b6001600160a01b0386811682528516602082015260a06040820181905260009061258390830186612030565b82810360608401526125958186612030565b905082810360808401526125a98185611c71565b98975050505050505050565b6000602082840312156125c757600080fd5b81516108e381611c01565b600060033d11156125eb5760046000803e5060005160e01c5b90565b600060443d10156125fc5790565b6040516003193d81016004833e81513d6001600160401b03816024840111818411171561262b57505050505090565b82850191508151818111156126435750505050505090565b843d870101602082850101111561265d5750505050505090565b61266c60208286010187611cc6565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b76020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b8152600083516126f1816017850160208801611c4d565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351612722816028840160208801611c4d565b01602801949350505050565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061276890830184611c71565b979650505050505050565b808202811582820484141761044257610442612348565b60008161279957612799612348565b506000190190565b8181038181111561044257610442612348565b634e487b7160e01b600052603160045260246000fdfe4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb455243313135355072657365744d696e7465725061757365723a206d75737420c3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f6265d7a28e3265b37a6474929f336521b332c1681b933f6cb9f3376673440d862a9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6a2646970667358221220294efe154e549198ff0c6b7ab7e9846223d9e8fe7ae7de1938f6eb7d0f5e66a664736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RootERC1155PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RootERC1155Predicate","sourceName":"contracts/root/RootERC1155Predicate.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"depositor","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"ERC1155Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"depositor","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"ERC1155DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"ERC1155Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"withdrawer","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"ERC1155WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"TokenMapped","type":"event"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childERC1155Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"depositBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"depositTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"exitHelper","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newStateSender","type":"address"},{"internalType":"address","name":"newExitHelper","type":"address"},{"internalType":"address","name":"newChildERC1155Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC1155MetadataURI","name":"rootToken","type":"address"}],"name":"mapToken","outputs":[{"internalType":"address","name":"childToken","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256[]","name":"","type":"uint256[]"},{"internalType":"uint256[]","name":"","type":"uint256[]"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC1155BatchReceived","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"bytes","name":"","type":"bytes"}],"name":"onERC1155Received","outputs":[{"internalType":"bytes4","name":"","type":"bytes4"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onL2StateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611bd2806100206000396000f3fe608060405234801561001057600080fd5b50600436106101215760003560e01c8063bc197c81116100ad578063f23a6e6111610071578063f23a6e61146102fe578063f43cda8b1461031d578063f4a120f714610330578063f645125514610343578063f8c8765e1461036a57600080fd5b8063bc197c8114610238578063c5ac2b1c14610270578063cb10f94c14610297578063d41f1771146102b0578063d7c9e3ec146102d757600080fd5b80637efab4f5116100f45780637efab4f5146101a157806395c7041c146101ca578063a78e111c146101dd578063b1768065146101f0578063b68ad1e41461022557600080fd5b806301ffc9a7146101265780630efe6a8b1461014e5780634c4c45de14610163578063654715e614610176575b600080fd5b610139610134366004611173565b61037d565b60405190151581526020015b60405180910390f35b61016161015c3660046111bc565b6103b4565b005b61016161017136600461123c565b6103c5565b600254610189906001600160a01b031681565b6040516001600160a01b039091168152602001610145565b6101896101af3660046112e8565b6004602052600090815260409020546001600160a01b031681565b600154610189906001600160a01b031681565b6101616101eb366004611305565b610448565b6102177f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b604051908152602001610145565b600354610189906001600160a01b031681565b610257610246366004611497565b63bc197c8160e01b95945050505050565b6040516001600160e01b03199091168152602001610145565b6102177faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b600054610189906201000090046001600160a01b031681565b6102177f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102177f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61025761030c366004611544565b63f23a6e6160e01b95945050505050565b61016161032b3660046115ac565b61045a565b61018961033e3660046112e8565b610629565b6102177f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b610161610378366004611634565b610945565b60006001600160e01b03198216630271189760e51b14806103ae57506301ffc9a760e01b6001600160e01b03198316145b92915050565b6103c083338484610b54565b505050565b84831480156103d357508481145b6104305760405162461bcd60e51b8152602060048201526024808201527f526f6f74455243313135355072656469636174653a20494e56414c49445f4c4560448201526309c8ea8960e31b60648201526084015b60405180910390fd5b61043f87878787878787610cec565b50505050505050565b61045484848484610b54565b50505050565b6001546001600160a01b031633146104c35760405162461bcd60e51b815260206004820152602660248201527f526f6f74455243313135355072656469636174653a204f4e4c595f455849545f6044820152652422a62822a960d11b6064820152608401610427565b6002546001600160a01b038481169116146105335760405162461bcd60e51b815260206004820152602a60248201527f526f6f74455243313135355072656469636174653a204f4e4c595f4348494c446044820152695f50524544494341544560b01b6064820152608401610427565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e982869610562602060008486611690565b61056b916116ba565b0361058a576105856105808260208186611690565b610ecc565b610454565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed26105b9602060008486611690565b6105c2916116ba565b036105d1576105858282610fcb565b60405162461bcd60e51b815260206004820152602760248201527f526f6f74455243313135355072656469636174653a20494e56414c49445f5349604482015266474e415455524560c81b6064820152608401610427565b60006001600160a01b03821661068d5760405162461bcd60e51b815260206004820152602360248201527f526f6f74455243313135355072656469636174653a20494e56414c49445f544f60448201526225a2a760e91b6064820152608401610427565b6001600160a01b0382811660009081526004602052604090205416156107015760405162461bcd60e51b8152602060048201526024808201527f526f6f74455243313135355072656469636174653a20414c52454144595f4d416044820152631414115160e21b6064820152608401610427565b6002546003546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b03928316926107ab921690603401604051602081830303815290604052805190602001208360405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b03848116600081815260046020818152604080842080546001600160a01b031916968816969096179095558451908101855282815293516303a24d0760e21b8152908101919091529294509091630e89341c90602401600060405180830381865afa92505050801561084657506040513d6000823e601f3d908101601f1916820160405261084391908101906116fc565b60015b1561084e5790505b600060029054906101000a90046001600160a01b03166001600160a01b03166316f19831837f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad87856040516020016108a89392919061179e565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016108d49291906117c8565b600060405180830381600087803b1580156108ee57600080fd5b505af1158015610902573d6000803e3d6000fd5b50506040516001600160a01b038087169350871691507f85920d35e6c72f6b2affffa04298b0cecfeba86e4a9f407df661f1cb8ab5e61790600090a35050919050565b600054610100900460ff16158080156109655750600054600160ff909116105b8061097f5750303b15801561097f575060005460ff166001145b6109e25760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610427565b6000805460ff191660011790558015610a05576000805461ff0019166101001790555b6001600160a01b03851615801590610a2557506001600160a01b03841615155b8015610a3957506001600160a01b03831615155b8015610a4d57506001600160a01b03821615155b610aaa5760405162461bcd60e51b815260206004820152602860248201527f526f6f74455243313135355072656469636174653a204241445f494e495449416044820152672624ad20aa24a7a760c11b6064820152608401610427565b6000805462010000600160b01b031916620100006001600160a01b038881169190910291909117909155600180546001600160a01b031990811687841617909155600280548216868416179055600380549091169184169190911790558015610b4d576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6000610b5f8561112c565b604051637921219560e11b81529091506001600160a01b0386169063f242432a90610b949033903090889088906004016117f4565b600060405180830381600087803b158015610bae57600080fd5b505af1158015610bc2573d6000803e3d6000fd5b5050600054600254604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038b8116828401523360608301528a8116608083015260a082018a905260c08083018a90528351808403909101815260e08301938490526316f1983160e01b90935262010000909404841695506316f198319450610c5f939092169160e4016117c8565b600060405180830381600087803b158015610c7957600080fd5b505af1158015610c8d573d6000803e3d6000fd5b505060408051338152602081018790529081018590526001600160a01b03808816935084811692508816907fbcbdf0c69f975f2a4085544938b054f02e77e87cbd055146d388c0be7120e04f9060600160405180910390a45050505050565b6000610cf78861112c565b905060005b84811015610da357886001600160a01b031663f242432a3330898986818110610d2757610d2761182c565b90506020020135888887818110610d4057610d4061182c565b905060200201356040518563ffffffff1660e01b8152600401610d6694939291906117f4565b600060405180830381600087803b158015610d8057600080fd5b505af1158015610d94573d6000803e3d6000fd5b50505050806001019050610cfc565b506000546002546040516001600160a01b03620100009093048316926316f19831921690610e05907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908d9033908e908e908e908e908e908e906020016118bd565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610e319291906117c8565b600060405180830381600087803b158015610e4b57600080fd5b505af1158015610e5f573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316896001600160a01b03167f7e8ab6f25cb177d65db49b7a2197bb2a7df5757434857d411e2523b332a913e68a8a8a8a8a8a604051610eba96959493929190611928565b60405180910390a45050505050505050565b600080808080610ede86880188611971565b6001600160a01b03808616600090815260046020526040902054959a50939850919650945092501680610f1357610f136119cc565b604051637921219560e11b81526001600160a01b0387169063f242432a90610f459030908890889088906004016117f4565b600060405180830381600087803b158015610f5f57600080fd5b505af1158015610f73573d6000803e3d6000fd5b5050604080516001600160a01b0389811682526020820188905291810186905281881693508482169250908916907fc42752949ca07109e6f25adcde4a9407be23e084b1d32ca2bce8aa55bf3dd62590606001610eba565b600080808080610fdd868801886119e2565b6001600160a01b03808616600090815260046020526040902054959b509399509197509550935016905080611014576110146119cc565b60005b83518110156110da57866001600160a01b031663f242432a308784815181106110425761104261182c565b602002602001015187858151811061105c5761105c61182c565b60200260200101518786815181106110765761107661182c565b60200260200101516040518563ffffffff1660e01b815260040161109d94939291906117f4565b600060405180830381600087803b1580156110b757600080fd5b505af11580156110cb573d6000803e3d6000fd5b50505050806001019050611017565b50846001600160a01b0316816001600160a01b0316876001600160a01b03167fce612e98b81c726375e7c2395409e74ee0a29b22f7641ea5a8ce8508616448c0878787604051610eba93929190611b27565b6001600160a01b0380821660009081526004602052604090205416806111585761115582610629565b90505b6001600160a01b03811661116e5761116e6119cc565b919050565b60006020828403121561118557600080fd5b81356001600160e01b03198116811461119d57600080fd5b9392505050565b6001600160a01b03811681146111b957600080fd5b50565b6000806000606084860312156111d157600080fd5b83356111dc816111a4565b95602085013595506040909401359392505050565b60008083601f84011261120357600080fd5b5081356001600160401b0381111561121a57600080fd5b6020830191508360208260051b850101111561123557600080fd5b9250929050565b60008060008060008060006080888a03121561125757600080fd5b8735611262816111a4565b965060208801356001600160401b038082111561127e57600080fd5b61128a8b838c016111f1565b909850965060408a01359150808211156112a357600080fd5b6112af8b838c016111f1565b909650945060608a01359150808211156112c857600080fd5b506112d58a828b016111f1565b989b979a50959850939692959293505050565b6000602082840312156112fa57600080fd5b813561119d816111a4565b6000806000806080858703121561131b57600080fd5b8435611326816111a4565b93506020850135611336816111a4565b93969395505050506040820135916060013590565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156113895761138961134b565b604052919050565b60006001600160401b038211156113aa576113aa61134b565b5060051b60200190565b600082601f8301126113c557600080fd5b813560206113da6113d583611391565b611361565b82815260059290921b840181019181810190868411156113f957600080fd5b8286015b8481101561141457803583529183019183016113fd565b509695505050505050565b60006001600160401b038211156114385761143861134b565b50601f01601f191660200190565b600082601f83011261145757600080fd5b81356114656113d58261141f565b81815284602083860101111561147a57600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a086880312156114af57600080fd5b85356114ba816111a4565b945060208601356114ca816111a4565b935060408601356001600160401b03808211156114e657600080fd5b6114f289838a016113b4565b9450606088013591508082111561150857600080fd5b61151489838a016113b4565b9350608088013591508082111561152a57600080fd5b5061153788828901611446565b9150509295509295909350565b600080600080600060a0868803121561155c57600080fd5b8535611567816111a4565b94506020860135611577816111a4565b9350604086013592506060860135915060808601356001600160401b038111156115a057600080fd5b61153788828901611446565b600080600080606085870312156115c257600080fd5b8435935060208501356115d4816111a4565b925060408501356001600160401b03808211156115f057600080fd5b818701915087601f83011261160457600080fd5b81358181111561161357600080fd5b88602082850101111561162557600080fd5b95989497505060200194505050565b6000806000806080858703121561164a57600080fd5b8435611655816111a4565b93506020850135611665816111a4565b92506040850135611675816111a4565b91506060850135611685816111a4565b939692955090935050565b600080858511156116a057600080fd5b838611156116ad57600080fd5b5050820193919092039150565b803560208310156103ae57600019602084900360031b1b1692915050565b60005b838110156116f35781810151838201526020016116db565b50506000910152565b60006020828403121561170e57600080fd5b81516001600160401b0381111561172457600080fd5b8201601f8101841361173557600080fd5b80516117436113d58261141f565b81815285602083850101111561175857600080fd5b6117698260208301602086016116d8565b95945050505050565b6000815180845261178a8160208601602086016116d8565b601f01601f19169290920160200192915050565b8381526001600160a01b038316602082015260606040820181905260009061176990830184611772565b6001600160a01b03831681526040602082018190526000906117ec90830184611772565b949350505050565b6001600160a01b0394851681529290931660208301526040820152606081019190915260a06080820181905260009082015260c00190565b634e487b7160e01b600052603260045260246000fd5b8183526000602080850194508260005b85811015611880578135611865816111a4565b6001600160a01b031687529582019590820190600101611852565b509495945050505050565b81835260006001600160fb1b038311156118a457600080fd5b8260051b80836020870137939093016020019392505050565b8981526001600160a01b0389811660208301528816604082015260c0606082018190526000906118f0908301888a611842565b828103608084015261190381878961188b565b905082810360a084015261191881858761188b565b9c9b505050505050505050505050565b60608152600061193c60608301888a611842565b828103602084015261194f81878961188b565b9050828103604084015261196481858761188b565b9998505050505050505050565b600080600080600060a0868803121561198957600080fd5b8535611994816111a4565b945060208601356119a4816111a4565b935060408601356119b4816111a4565b94979396509394606081013594506080013592915050565b634e487b7160e01b600052600160045260246000fd5b60008060008060008060c087890312156119fb57600080fd5b86359550602080880135611a0e816111a4565b95506040880135611a1e816111a4565b945060608801356001600160401b0380821115611a3a57600080fd5b818a0191508a601f830112611a4e57600080fd5b8135611a5c6113d582611391565b81815260059190911b8301840190848101908d831115611a7b57600080fd5b938501935b82851015611aa2578435611a93816111a4565b82529385019390850190611a80565b9750505060808a0135925080831115611aba57600080fd5b611ac68b848c016113b4565b945060a08a0135925080831115611adc57600080fd5b5050611aea89828a016113b4565b9150509295509295509295565b600081518084526020808501945080840160005b8381101561188057815187529582019590820190600101611b0b565b606080825284519082018190526000906020906080840190828801845b82811015611b695781516001600160a01b031684529284019290840190600101611b44565b50505083810382850152611b7d8187611af7565b9150508281036040840152611b928185611af7565b969550505050505056fea2646970667358221220fca09c260114445d76ac4a1ec1efcbdba6ac7f99d1bccd257e90ed39dcea400d64736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101215760003560e01c8063bc197c81116100ad578063f23a6e6111610071578063f23a6e61146102fe578063f43cda8b1461031d578063f4a120f714610330578063f645125514610343578063f8c8765e1461036a57600080fd5b8063bc197c8114610238578063c5ac2b1c14610270578063cb10f94c14610297578063d41f1771146102b0578063d7c9e3ec146102d757600080fd5b80637efab4f5116100f45780637efab4f5146101a157806395c7041c146101ca578063a78e111c146101dd578063b1768065146101f0578063b68ad1e41461022557600080fd5b806301ffc9a7146101265780630efe6a8b1461014e5780634c4c45de14610163578063654715e614610176575b600080fd5b610139610134366004611173565b61037d565b60405190151581526020015b60405180910390f35b61016161015c3660046111bc565b6103b4565b005b61016161017136600461123c565b6103c5565b600254610189906001600160a01b031681565b6040516001600160a01b039091168152602001610145565b6101896101af3660046112e8565b6004602052600090815260409020546001600160a01b031681565b600154610189906001600160a01b031681565b6101616101eb366004611305565b610448565b6102177f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b604051908152602001610145565b600354610189906001600160a01b031681565b610257610246366004611497565b63bc197c8160e01b95945050505050565b6040516001600160e01b03199091168152602001610145565b6102177faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b600054610189906201000090046001600160a01b031681565b6102177f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6102177f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61025761030c366004611544565b63f23a6e6160e01b95945050505050565b61016161032b3660046115ac565b61045a565b61018961033e3660046112e8565b610629565b6102177f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b610161610378366004611634565b610945565b60006001600160e01b03198216630271189760e51b14806103ae57506301ffc9a760e01b6001600160e01b03198316145b92915050565b6103c083338484610b54565b505050565b84831480156103d357508481145b6104305760405162461bcd60e51b8152602060048201526024808201527f526f6f74455243313135355072656469636174653a20494e56414c49445f4c4560448201526309c8ea8960e31b60648201526084015b60405180910390fd5b61043f87878787878787610cec565b50505050505050565b61045484848484610b54565b50505050565b6001546001600160a01b031633146104c35760405162461bcd60e51b815260206004820152602660248201527f526f6f74455243313135355072656469636174653a204f4e4c595f455849545f6044820152652422a62822a960d11b6064820152608401610427565b6002546001600160a01b038481169116146105335760405162461bcd60e51b815260206004820152602a60248201527f526f6f74455243313135355072656469636174653a204f4e4c595f4348494c446044820152695f50524544494341544560b01b6064820152608401610427565b7f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e982869610562602060008486611690565b61056b916116ba565b0361058a576105856105808260208186611690565b610ecc565b610454565b7f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed26105b9602060008486611690565b6105c2916116ba565b036105d1576105858282610fcb565b60405162461bcd60e51b815260206004820152602760248201527f526f6f74455243313135355072656469636174653a20494e56414c49445f5349604482015266474e415455524560c81b6064820152608401610427565b60006001600160a01b03821661068d5760405162461bcd60e51b815260206004820152602360248201527f526f6f74455243313135355072656469636174653a20494e56414c49445f544f60448201526225a2a760e91b6064820152608401610427565b6001600160a01b0382811660009081526004602052604090205416156107015760405162461bcd60e51b8152602060048201526024808201527f526f6f74455243313135355072656469636174653a20414c52454144595f4d416044820152631414115160e21b6064820152608401610427565b6002546003546040516bffffffffffffffffffffffff19606086901b1660208201526001600160a01b03928316926107ab921690603401604051602081830303815290604052805190602001208360405160388101919091526f5af43d82803e903d91602b57fd5bf3ff60248201526014810192909252733d602d80600a3d3981f3363d3d373d3d3d363d73825260588201526037600c8201206078820152605560439091012090565b6001600160a01b03848116600081815260046020818152604080842080546001600160a01b031916968816969096179095558451908101855282815293516303a24d0760e21b8152908101919091529294509091630e89341c90602401600060405180830381865afa92505050801561084657506040513d6000823e601f3d908101601f1916820160405261084391908101906116fc565b60015b1561084e5790505b600060029054906101000a90046001600160a01b03166001600160a01b03166316f19831837f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad87856040516020016108a89392919061179e565b6040516020818303038152906040526040518363ffffffff1660e01b81526004016108d49291906117c8565b600060405180830381600087803b1580156108ee57600080fd5b505af1158015610902573d6000803e3d6000fd5b50506040516001600160a01b038087169350871691507f85920d35e6c72f6b2affffa04298b0cecfeba86e4a9f407df661f1cb8ab5e61790600090a35050919050565b600054610100900460ff16158080156109655750600054600160ff909116105b8061097f5750303b15801561097f575060005460ff166001145b6109e25760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610427565b6000805460ff191660011790558015610a05576000805461ff0019166101001790555b6001600160a01b03851615801590610a2557506001600160a01b03841615155b8015610a3957506001600160a01b03831615155b8015610a4d57506001600160a01b03821615155b610aaa5760405162461bcd60e51b815260206004820152602860248201527f526f6f74455243313135355072656469636174653a204241445f494e495449416044820152672624ad20aa24a7a760c11b6064820152608401610427565b6000805462010000600160b01b031916620100006001600160a01b038881169190910291909117909155600180546001600160a01b031990811687841617909155600280548216868416179055600380549091169184169190911790558015610b4d576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6000610b5f8561112c565b604051637921219560e11b81529091506001600160a01b0386169063f242432a90610b949033903090889088906004016117f4565b600060405180830381600087803b158015610bae57600080fd5b505af1158015610bc2573d6000803e3d6000fd5b5050600054600254604080517f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82160208201526001600160a01b038b8116828401523360608301528a8116608083015260a082018a905260c08083018a90528351808403909101815260e08301938490526316f1983160e01b90935262010000909404841695506316f198319450610c5f939092169160e4016117c8565b600060405180830381600087803b158015610c7957600080fd5b505af1158015610c8d573d6000803e3d6000fd5b505060408051338152602081018790529081018590526001600160a01b03808816935084811692508816907fbcbdf0c69f975f2a4085544938b054f02e77e87cbd055146d388c0be7120e04f9060600160405180910390a45050505050565b6000610cf78861112c565b905060005b84811015610da357886001600160a01b031663f242432a3330898986818110610d2757610d2761182c565b90506020020135888887818110610d4057610d4061182c565b905060200201356040518563ffffffff1660e01b8152600401610d6694939291906117f4565b600060405180830381600087803b158015610d8057600080fd5b505af1158015610d94573d6000803e3d6000fd5b50505050806001019050610cfc565b506000546002546040516001600160a01b03620100009093048316926316f19831921690610e05907faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d18908d9033908e908e908e908e908e908e906020016118bd565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610e319291906117c8565b600060405180830381600087803b158015610e4b57600080fd5b505af1158015610e5f573d6000803e3d6000fd5b50505050336001600160a01b0316816001600160a01b0316896001600160a01b03167f7e8ab6f25cb177d65db49b7a2197bb2a7df5757434857d411e2523b332a913e68a8a8a8a8a8a604051610eba96959493929190611928565b60405180910390a45050505050505050565b600080808080610ede86880188611971565b6001600160a01b03808616600090815260046020526040902054959a50939850919650945092501680610f1357610f136119cc565b604051637921219560e11b81526001600160a01b0387169063f242432a90610f459030908890889088906004016117f4565b600060405180830381600087803b158015610f5f57600080fd5b505af1158015610f73573d6000803e3d6000fd5b5050604080516001600160a01b0389811682526020820188905291810186905281881693508482169250908916907fc42752949ca07109e6f25adcde4a9407be23e084b1d32ca2bce8aa55bf3dd62590606001610eba565b600080808080610fdd868801886119e2565b6001600160a01b03808616600090815260046020526040902054959b509399509197509550935016905080611014576110146119cc565b60005b83518110156110da57866001600160a01b031663f242432a308784815181106110425761104261182c565b602002602001015187858151811061105c5761105c61182c565b60200260200101518786815181106110765761107661182c565b60200260200101516040518563ffffffff1660e01b815260040161109d94939291906117f4565b600060405180830381600087803b1580156110b757600080fd5b505af11580156110cb573d6000803e3d6000fd5b50505050806001019050611017565b50846001600160a01b0316816001600160a01b0316876001600160a01b03167fce612e98b81c726375e7c2395409e74ee0a29b22f7641ea5a8ce8508616448c0878787604051610eba93929190611b27565b6001600160a01b0380821660009081526004602052604090205416806111585761115582610629565b90505b6001600160a01b03811661116e5761116e6119cc565b919050565b60006020828403121561118557600080fd5b81356001600160e01b03198116811461119d57600080fd5b9392505050565b6001600160a01b03811681146111b957600080fd5b50565b6000806000606084860312156111d157600080fd5b83356111dc816111a4565b95602085013595506040909401359392505050565b60008083601f84011261120357600080fd5b5081356001600160401b0381111561121a57600080fd5b6020830191508360208260051b850101111561123557600080fd5b9250929050565b60008060008060008060006080888a03121561125757600080fd5b8735611262816111a4565b965060208801356001600160401b038082111561127e57600080fd5b61128a8b838c016111f1565b909850965060408a01359150808211156112a357600080fd5b6112af8b838c016111f1565b909650945060608a01359150808211156112c857600080fd5b506112d58a828b016111f1565b989b979a50959850939692959293505050565b6000602082840312156112fa57600080fd5b813561119d816111a4565b6000806000806080858703121561131b57600080fd5b8435611326816111a4565b93506020850135611336816111a4565b93969395505050506040820135916060013590565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156113895761138961134b565b604052919050565b60006001600160401b038211156113aa576113aa61134b565b5060051b60200190565b600082601f8301126113c557600080fd5b813560206113da6113d583611391565b611361565b82815260059290921b840181019181810190868411156113f957600080fd5b8286015b8481101561141457803583529183019183016113fd565b509695505050505050565b60006001600160401b038211156114385761143861134b565b50601f01601f191660200190565b600082601f83011261145757600080fd5b81356114656113d58261141f565b81815284602083860101111561147a57600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a086880312156114af57600080fd5b85356114ba816111a4565b945060208601356114ca816111a4565b935060408601356001600160401b03808211156114e657600080fd5b6114f289838a016113b4565b9450606088013591508082111561150857600080fd5b61151489838a016113b4565b9350608088013591508082111561152a57600080fd5b5061153788828901611446565b9150509295509295909350565b600080600080600060a0868803121561155c57600080fd5b8535611567816111a4565b94506020860135611577816111a4565b9350604086013592506060860135915060808601356001600160401b038111156115a057600080fd5b61153788828901611446565b600080600080606085870312156115c257600080fd5b8435935060208501356115d4816111a4565b925060408501356001600160401b03808211156115f057600080fd5b818701915087601f83011261160457600080fd5b81358181111561161357600080fd5b88602082850101111561162557600080fd5b95989497505060200194505050565b6000806000806080858703121561164a57600080fd5b8435611655816111a4565b93506020850135611665816111a4565b92506040850135611675816111a4565b91506060850135611685816111a4565b939692955090935050565b600080858511156116a057600080fd5b838611156116ad57600080fd5b5050820193919092039150565b803560208310156103ae57600019602084900360031b1b1692915050565b60005b838110156116f35781810151838201526020016116db565b50506000910152565b60006020828403121561170e57600080fd5b81516001600160401b0381111561172457600080fd5b8201601f8101841361173557600080fd5b80516117436113d58261141f565b81815285602083850101111561175857600080fd5b6117698260208301602086016116d8565b95945050505050565b6000815180845261178a8160208601602086016116d8565b601f01601f19169290920160200192915050565b8381526001600160a01b038316602082015260606040820181905260009061176990830184611772565b6001600160a01b03831681526040602082018190526000906117ec90830184611772565b949350505050565b6001600160a01b0394851681529290931660208301526040820152606081019190915260a06080820181905260009082015260c00190565b634e487b7160e01b600052603260045260246000fd5b8183526000602080850194508260005b85811015611880578135611865816111a4565b6001600160a01b031687529582019590820190600101611852565b509495945050505050565b81835260006001600160fb1b038311156118a457600080fd5b8260051b80836020870137939093016020019392505050565b8981526001600160a01b0389811660208301528816604082015260c0606082018190526000906118f0908301888a611842565b828103608084015261190381878961188b565b905082810360a084015261191881858761188b565b9c9b505050505050505050505050565b60608152600061193c60608301888a611842565b828103602084015261194f81878961188b565b9050828103604084015261196481858761188b565b9998505050505050505050565b600080600080600060a0868803121561198957600080fd5b8535611994816111a4565b945060208601356119a4816111a4565b935060408601356119b4816111a4565b94979396509394606081013594506080013592915050565b634e487b7160e01b600052600160045260246000fd5b60008060008060008060c087890312156119fb57600080fd5b86359550602080880135611a0e816111a4565b95506040880135611a1e816111a4565b945060608801356001600160401b0380821115611a3a57600080fd5b818a0191508a601f830112611a4e57600080fd5b8135611a5c6113d582611391565b81815260059190911b8301840190848101908d831115611a7b57600080fd5b938501935b82851015611aa2578435611a93816111a4565b82529385019390850190611a80565b9750505060808a0135925080831115611aba57600080fd5b611ac68b848c016113b4565b945060a08a0135925080831115611adc57600080fd5b5050611aea89828a016113b4565b9150509295509295509295565b600081518084526020808501945080840160005b8381101561188057815187529582019590820190600101611b0b565b606080825284519082018190526000906020906080840190828801845b82811015611b695781516001600160a01b031684529284019290840190600101611b44565b50505083810382850152611b7d8187611af7565b9150508281036040840152611b928185611af7565b969550505050505056fea2646970667358221220fca09c260114445d76ac4a1ec1efcbdba6ac7f99d1bccd257e90ed39dcea400d64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ChildMintableERC1155PredicateArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ChildMintableERC1155Predicate","sourceName":"contracts/root/ChildMintableERC1155Predicate.sol","abi":[{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"MintableERC1155Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"MintableERC1155DepositBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":false,"internalType":"address","name":"sender","type":"address"},{"indexed":true,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"MintableERC1155Withdraw","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"},{"indexed":false,"internalType":"address[]","name":"receivers","type":"address[]"},{"indexed":false,"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"MintableERC1155WithdrawBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"rootToken","type":"address"},{"indexed":true,"internalType":"address","name":"childToken","type":"address"}],"name":"MintableTokenMapped","type":"event"},{"inputs":[],"name":"DEPOSIT_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEPOSIT_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAP_TOKEN_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_BATCH_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAW_SIG","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childTokenTemplate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"exitHelper","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newStateSender","type":"address"},{"internalType":"address","name":"newExitHelper","type":"address"},{"internalType":"address","name":"newRootERC1155Predicate","type":"address"},{"internalType":"address","name":"newChildTokenTemplate","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onL2StateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rootERC1155Predicate","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"rootTokenToChildToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"stateSender","outputs":[{"internalType":"contract IStateSender","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IChildERC1155","name":"childToken","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC1155","name":"childToken","type":"address"},{"internalType":"address[]","name":"receivers","type":"address[]"},{"internalType":"uint256[]","name":"tokenIds","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"withdrawBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IChildERC1155","name":"childToken","type":"address"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawTo","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50611f7c806100206000396000f3fe608060405234801561001057600080fd5b50600436106100d55760003560e01c8063b8cd3ec011610087578063b8cd3ec0146101b6578063c5ac2b1c146101c9578063cb10f94c146101f0578063d41f177114610209578063d7c9e3ec14610230578063f43cda8b14610257578063f64512551461026a578063f8c8765e1461029157600080fd5b8063051eb2e2146100da5780637efab4f51461010a57806386937eb41461013357806395c7041c14610148578063b17680651461015b578063b5c5f67214610190578063b68ad1e4146101a3575b600080fd5b6002546100ed906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6100ed610118366004611564565b6004602052600090815260409020546001600160a01b031681565b6101466101413660046115d3565b6102a4565b005b6001546100ed906001600160a01b031681565b6101827f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b604051908152602001610101565b61014661019e36600461167f565b6102bc565b6003546100ed906001600160a01b031681565b6101466101c43660046116b4565b6102cd565b6101827faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6000546100ed906201000090046001600160a01b031681565b6101827f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101827f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b6101466102653660046116fa565b6102df565b6101827f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61014661029f366004611782565b610514565b6102b38787878787878761062d565b50505050505050565b6102c8833384846109ba565b505050565b6102d9848484846109ba565b50505050565b6001546001600160a01b031633146103565760405162461bcd60e51b815260206004820152602f60248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204f60448201526e27262cafa2ac24aa2fa422a62822a960891b60648201526084015b60405180910390fd5b6002546001600160a01b038481169116146103ce5760405162461bcd60e51b815260206004820152603260248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204f6044820152714e4c595f524f4f545f50524544494341544560701b606482015260840161034d565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216103fd6020600084866117de565b61040691611808565b036104255761042061041b82602081866117de565b610cd5565b6102d9565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d186104546020600084866117de565b61045d91611808565b0361046c576104208282610f40565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61049b6020600084866117de565b6104a491611808565b036104b35761042082826111ad565b60405162461bcd60e51b815260206004820152603060248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204960448201526f4e56414c49445f5349474e415455524560801b606482015260840161034d565b600054610100900460ff16158080156105345750600054600160ff909116105b8061054e5750303b15801561054e575060005460ff166001145b6105b15760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161034d565b6000805460ff1916600117905580156105d4576000805461ff0019166101001790555b6105e085858585611317565b8015610626576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b8661063781611420565b6106535760405162461bcd60e51b815260040161034d90611826565b6000886001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610693573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906106b79190611871565b6001600160a01b038181166000908152600460205260409020549192508a81169116146106f65760405162461bcd60e51b815260040161034d9061188e565b6001600160a01b03811661070c5761070c6118db565b306001600160a01b0316896001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610754573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107789190611871565b6001600160a01b03161461078e5761078e6118db565b868514801561079c57508483145b6107fe5760405162461bcd60e51b815260206004820152602d60248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204960448201526c09cac82989288be988a9c8ea89609b1b606482015260840161034d565b604051631ac8311560e21b81526001600160a01b038a1690636b20c454906108329033908a908a908a908a90600401611923565b6020604051808303816000875af1158015610851573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906108759190611967565b6108915760405162461bcd60e51b815260040161034d90611989565b6000546002546040516001600160a01b03620100009093048316926316f198319216906108f2907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908f908f908f908f908f908f90602001611a1c565b6040516020818303038152906040526040518363ffffffff1660e01b815260040161091e929190611acd565b600060405180830381600087803b15801561093857600080fd5b505af115801561094c573d6000803e3d6000fd5b50505050336001600160a01b0316896001600160a01b0316826001600160a01b03167fdd47868997765508c515e1f8ca079846dafbdfd8f98f6e76bca0891810b9f9d18b8b8b8b8b8b6040516109a796959493929190611af9565b60405180910390a4505050505050505050565b836109c481611420565b6109e05760405162461bcd60e51b815260040161034d90611826565b6000856001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a20573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a449190611871565b6001600160a01b03818116600090815260046020526040902054919250878116911614610a835760405162461bcd60e51b815260040161034d9061188e565b6001600160a01b038116610a9957610a996118db565b306001600160a01b0316866001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ae1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b059190611871565b6001600160a01b031614610b1b57610b1b6118db565b604051637a94c56560e11b81526001600160a01b0387169063f5298aca90610b4b90339088908890600401611b42565b6020604051808303816000875af1158015610b6a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b8e9190611967565b610baa5760405162461bcd60e51b815260040161034d90611989565b600054600254604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152898116608083015260a0820189905260c08083018990528351808403909101815260e08301938490526316f1983160e01b909352620100009094048416936316f1983193610c429391169160e401611acd565b600060405180830381600087803b158015610c5c57600080fd5b505af1158015610c70573d6000803e3d6000fd5b50505050846001600160a01b0316866001600160a01b0316826001600160a01b03167fda58d73e08ba3c7767de904e68d208be8291494a9faaf70a6d4f736d24ec1f0f338888604051610cc593929190611b42565b60405180910390a4505050505050565b600080808080610ce786880188611b63565b6001600160a01b03808616600090815260046020526040902054959a50939850919650945092501680610d2c5760405162461bcd60e51b815260040161034d9061188e565b610d3581611420565b610d4157610d416118db565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610d81573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610da59190611871565b9050866001600160a01b0316816001600160a01b031614610dc857610dc86118db565b6001600160a01b038116610dde57610dde6118db565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610e26573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e4a9190611871565b6001600160a01b031614610e6057610e606118db565b604051630ab714fb60e11b81526001600160a01b0383169063156e29f690610e9090889088908890600401611b42565b6020604051808303816000875af1158015610eaf573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ed39190611967565b610eef5760405162461bcd60e51b815260040161034d90611bbe565b846001600160a01b0316826001600160a01b0316886001600160a01b03167f76a4cd47013e7e58abe817eedbb692d1614d71080b527412ebfb3f91a085a6de8988886040516109a793929190611b42565b600080808080610f5286880188611cdc565b6001600160a01b03808616600090815260046020526040902054959b509399509197509550935016905080610f995760405162461bcd60e51b815260040161034d9061188e565b610fa281611420565b610fae57610fae6118db565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610fee573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110129190611871565b9050866001600160a01b0316816001600160a01b031614611035576110356118db565b6001600160a01b03811661104b5761104b6118db565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015611093573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110b79190611871565b6001600160a01b0316146110cd576110cd6118db565b604051635712868360e01b81526001600160a01b038316906357128683906110fd90889088908890600401611e21565b6020604051808303816000875af115801561111c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111409190611967565b61115c5760405162461bcd60e51b815260040161034d90611bbe565b856001600160a01b0316826001600160a01b0316886001600160a01b03167fc244cac13e0edc863dc5a2c3bd2b935f605b2ed225fb052eaef869bc24b76fde8888886040516109a793929190611e21565b6000806111bc83850185611e96565b9093509150506001600160a01b0382166111d8576111d86118db565b6001600160a01b038281166000908152600460205260409020541615611200576112006118db565b6003546040516bffffffffffffffffffffffff19606085901b166020820152600091611250916001600160a01b0390911690603401604051602081830303815290604052805190602001206114b5565b6001600160a01b0384811660009081526004602081905260409182902080546001600160a01b031916938516938417905590516379ccf11760e11b8152929350909163f399e22e916112a6918791879101611acd565b600060405180830381600087803b1580156112c057600080fd5b505af11580156112d4573d6000803e3d6000fd5b50506040516001600160a01b038085169350861691507f0a1eaf9aa124c3f84c9dd77f7016af0f16f67639abb913af1697387db01f5ca590600090a35050505050565b6001600160a01b0384161580159061133757506001600160a01b03831615155b801561134b57506001600160a01b03821615155b801561135f57506001600160a01b03811615155b6113c55760405162461bcd60e51b815260206004820152603160248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204260448201527020a22fa4a724aa24a0a624ad20aa24a7a760791b606482015260840161034d565b600080546001600160a01b03958616620100000262010000600160b01b0319909116179055600180549385166001600160a01b0319948516179055600280549285169284169290921790915560038054919093169116179055565b6000816001600160a01b03163b60000361143c57506000919050565b6040516301ffc9a760e01b8152636cdb3d1360e11b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa9250505080156114a3575060408051601f3d908101601f191682019092526114a091810190611967565b60015b6114af57506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b0381166114af5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b604482015260640161034d565b6001600160a01b038116811461156157600080fd5b50565b60006020828403121561157657600080fd5b81356115818161154c565b9392505050565b60008083601f84011261159a57600080fd5b5081356001600160401b038111156115b157600080fd5b6020830191508360208260051b85010111156115cc57600080fd5b9250929050565b60008060008060008060006080888a0312156115ee57600080fd5b87356115f98161154c565b965060208801356001600160401b038082111561161557600080fd5b6116218b838c01611588565b909850965060408a013591508082111561163a57600080fd5b6116468b838c01611588565b909650945060608a013591508082111561165f57600080fd5b5061166c8a828b01611588565b989b979a50959850939692959293505050565b60008060006060848603121561169457600080fd5b833561169f8161154c565b95602085013595506040909401359392505050565b600080600080608085870312156116ca57600080fd5b84356116d58161154c565b935060208501356116e58161154c565b93969395505050506040820135916060013590565b6000806000806060858703121561171057600080fd5b8435935060208501356117228161154c565b925060408501356001600160401b038082111561173e57600080fd5b818701915087601f83011261175257600080fd5b81358181111561176157600080fd5b88602082850101111561177357600080fd5b95989497505060200194505050565b6000806000806080858703121561179857600080fd5b84356117a38161154c565b935060208501356117b38161154c565b925060408501356117c38161154c565b915060608501356117d38161154c565b939692955090935050565b600080858511156117ee57600080fd5b838611156117fb57600080fd5b5050820193919092039150565b803560208310156114af57600019602084900360031b1b1692915050565b6020808252602b908201527f4368696c644d696e7461626c65455243313135355072656469636174653a204e60408201526a13d517d0d3d395149050d560aa1b606082015260800190565b60006020828403121561188357600080fd5b81516115818161154c565b6020808252602d908201527f4368696c644d696e7461626c65455243313135355072656469636174653a205560408201526c2726a0a82822a22faa27a5a2a760991b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561190a57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b038616815260606020820181905260009061194890830186886118f1565b828103604084015261195b8185876118f1565b98975050505050505050565b60006020828403121561197957600080fd5b8151801515811461158157600080fd5b6020808252602a908201527f4368696c644d696e7461626c65455243313135355072656469636174653a204260408201526915549397d1905253115160b21b606082015260800190565b8183526000602080850194508260005b85811015611a115781356119f68161154c565b6001600160a01b0316875295820195908201906001016119e3565b509495945050505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090611a4f908301888a6119d3565b8281036080840152611a628187896118f1565b905082810360a0840152611a778185876118f1565b9c9b505050505050505050505050565b6000815180845260005b81811015611aad57602081850181015186830182015201611a91565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611af190830184611a87565b949350505050565b606081526000611b0d60608301888a6119d3565b8281036020840152611b208187896118f1565b90508281036040840152611b358185876118f1565b9998505050505050505050565b6001600160a01b039390931683526020830191909152604082015260600190565b600080600080600060a08688031215611b7b57600080fd5b8535611b868161154c565b94506020860135611b968161154c565b93506040860135611ba68161154c565b94979396509394606081013594506080013592915050565b6020808252602a908201527f4368696c644d696e7461626c65455243313135355072656469636174653a204d60408201526912539517d1905253115160b21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611c4657611c46611c08565b604052919050565b60006001600160401b03821115611c6757611c67611c08565b5060051b60200190565b600082601f830112611c8257600080fd5b81356020611c97611c9283611c4e565b611c1e565b82815260059290921b84018101918181019086841115611cb657600080fd5b8286015b84811015611cd15780358352918301918301611cba565b509695505050505050565b60008060008060008060c08789031215611cf557600080fd5b86359550602080880135611d088161154c565b95506040880135611d188161154c565b945060608801356001600160401b0380821115611d3457600080fd5b818a0191508a601f830112611d4857600080fd5b8135611d56611c9282611c4e565b81815260059190911b8301840190848101908d831115611d7557600080fd5b938501935b82851015611d9c578435611d8d8161154c565b82529385019390850190611d7a565b9750505060808a0135925080831115611db457600080fd5b611dc08b848c01611c71565b945060a08a0135925080831115611dd657600080fd5b5050611de489828a01611c71565b9150509295509295509295565b600081518084526020808501945080840160005b83811015611a1157815187529582019590820190600101611e05565b606080825284519082018190526000906020906080840190828801845b82811015611e635781516001600160a01b031684529284019290840190600101611e3e565b50505083810382850152611e778187611df1565b9150508281036040840152611e8c8185611df1565b9695505050505050565b600080600060608486031215611eab57600080fd5b83359250602080850135611ebe8161154c565b925060408501356001600160401b0380821115611eda57600080fd5b818701915087601f830112611eee57600080fd5b813581811115611f0057611f00611c08565b611f12601f8201601f19168501611c1e565b91508082528884828501011115611f2857600080fd5b8084840185840137600084828401015250809350505050925092509256fea26469706673582212202548c33121341dfe54a3591ddfb48a0522912106419666b488c71144be4fd23264736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100d55760003560e01c8063b8cd3ec011610087578063b8cd3ec0146101b6578063c5ac2b1c146101c9578063cb10f94c146101f0578063d41f177114610209578063d7c9e3ec14610230578063f43cda8b14610257578063f64512551461026a578063f8c8765e1461029157600080fd5b8063051eb2e2146100da5780637efab4f51461010a57806386937eb41461013357806395c7041c14610148578063b17680651461015b578063b5c5f67214610190578063b68ad1e4146101a3575b600080fd5b6002546100ed906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6100ed610118366004611564565b6004602052600090815260409020546001600160a01b031681565b6101466101413660046115d3565b6102a4565b005b6001546100ed906001600160a01b031681565b6101827f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b604051908152602001610101565b61014661019e36600461167f565b6102bc565b6003546100ed906001600160a01b031681565b6101466101c43660046116b4565b6102cd565b6101827faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6000546100ed906201000090046001600160a01b031681565b6101827f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101827f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b6101466102653660046116fa565b6102df565b6101827f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b61014661029f366004611782565b610514565b6102b38787878787878761062d565b50505050505050565b6102c8833384846109ba565b505050565b6102d9848484846109ba565b50505050565b6001546001600160a01b031633146103565760405162461bcd60e51b815260206004820152602f60248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204f60448201526e27262cafa2ac24aa2fa422a62822a960891b60648201526084015b60405180910390fd5b6002546001600160a01b038481169116146103ce5760405162461bcd60e51b815260206004820152603260248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204f6044820152714e4c595f524f4f545f50524544494341544560701b606482015260840161034d565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f8216103fd6020600084866117de565b61040691611808565b036104255761042061041b82602081866117de565b610cd5565b6102d9565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d186104546020600084866117de565b61045d91611808565b0361046c576104208282610f40565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61049b6020600084866117de565b6104a491611808565b036104b35761042082826111ad565b60405162461bcd60e51b815260206004820152603060248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204960448201526f4e56414c49445f5349474e415455524560801b606482015260840161034d565b600054610100900460ff16158080156105345750600054600160ff909116105b8061054e5750303b15801561054e575060005460ff166001145b6105b15760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161034d565b6000805460ff1916600117905580156105d4576000805461ff0019166101001790555b6105e085858585611317565b8015610626576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b8661063781611420565b6106535760405162461bcd60e51b815260040161034d90611826565b6000886001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610693573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906106b79190611871565b6001600160a01b038181166000908152600460205260409020549192508a81169116146106f65760405162461bcd60e51b815260040161034d9061188e565b6001600160a01b03811661070c5761070c6118db565b306001600160a01b0316896001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610754573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107789190611871565b6001600160a01b03161461078e5761078e6118db565b868514801561079c57508483145b6107fe5760405162461bcd60e51b815260206004820152602d60248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204960448201526c09cac82989288be988a9c8ea89609b1b606482015260840161034d565b604051631ac8311560e21b81526001600160a01b038a1690636b20c454906108329033908a908a908a908a90600401611923565b6020604051808303816000875af1158015610851573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906108759190611967565b6108915760405162461bcd60e51b815260040161034d90611989565b6000546002546040516001600160a01b03620100009093048316926316f198319216906108f2907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908f908f908f908f908f908f90602001611a1c565b6040516020818303038152906040526040518363ffffffff1660e01b815260040161091e929190611acd565b600060405180830381600087803b15801561093857600080fd5b505af115801561094c573d6000803e3d6000fd5b50505050336001600160a01b0316896001600160a01b0316826001600160a01b03167fdd47868997765508c515e1f8ca079846dafbdfd8f98f6e76bca0891810b9f9d18b8b8b8b8b8b6040516109a796959493929190611af9565b60405180910390a4505050505050505050565b836109c481611420565b6109e05760405162461bcd60e51b815260040161034d90611826565b6000856001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610a20573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a449190611871565b6001600160a01b03818116600090815260046020526040902054919250878116911614610a835760405162461bcd60e51b815260040161034d9061188e565b6001600160a01b038116610a9957610a996118db565b306001600160a01b0316866001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ae1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b059190611871565b6001600160a01b031614610b1b57610b1b6118db565b604051637a94c56560e11b81526001600160a01b0387169063f5298aca90610b4b90339088908890600401611b42565b6020604051808303816000875af1158015610b6a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b8e9190611967565b610baa5760405162461bcd60e51b815260040161034d90611989565b600054600254604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152898116608083015260a0820189905260c08083018990528351808403909101815260e08301938490526316f1983160e01b909352620100009094048416936316f1983193610c429391169160e401611acd565b600060405180830381600087803b158015610c5c57600080fd5b505af1158015610c70573d6000803e3d6000fd5b50505050846001600160a01b0316866001600160a01b0316826001600160a01b03167fda58d73e08ba3c7767de904e68d208be8291494a9faaf70a6d4f736d24ec1f0f338888604051610cc593929190611b42565b60405180910390a4505050505050565b600080808080610ce786880188611b63565b6001600160a01b03808616600090815260046020526040902054959a50939850919650945092501680610d2c5760405162461bcd60e51b815260040161034d9061188e565b610d3581611420565b610d4157610d416118db565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610d81573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610da59190611871565b9050866001600160a01b0316816001600160a01b031614610dc857610dc86118db565b6001600160a01b038116610dde57610dde6118db565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610e26573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e4a9190611871565b6001600160a01b031614610e6057610e606118db565b604051630ab714fb60e11b81526001600160a01b0383169063156e29f690610e9090889088908890600401611b42565b6020604051808303816000875af1158015610eaf573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ed39190611967565b610eef5760405162461bcd60e51b815260040161034d90611bbe565b846001600160a01b0316826001600160a01b0316886001600160a01b03167f76a4cd47013e7e58abe817eedbb692d1614d71080b527412ebfb3f91a085a6de8988886040516109a793929190611b42565b600080808080610f5286880188611cdc565b6001600160a01b03808616600090815260046020526040902054959b509399509197509550935016905080610f995760405162461bcd60e51b815260040161034d9061188e565b610fa281611420565b610fae57610fae6118db565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610fee573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110129190611871565b9050866001600160a01b0316816001600160a01b031614611035576110356118db565b6001600160a01b03811661104b5761104b6118db565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015611093573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110b79190611871565b6001600160a01b0316146110cd576110cd6118db565b604051635712868360e01b81526001600160a01b038316906357128683906110fd90889088908890600401611e21565b6020604051808303816000875af115801561111c573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111409190611967565b61115c5760405162461bcd60e51b815260040161034d90611bbe565b856001600160a01b0316826001600160a01b0316886001600160a01b03167fc244cac13e0edc863dc5a2c3bd2b935f605b2ed225fb052eaef869bc24b76fde8888886040516109a793929190611e21565b6000806111bc83850185611e96565b9093509150506001600160a01b0382166111d8576111d86118db565b6001600160a01b038281166000908152600460205260409020541615611200576112006118db565b6003546040516bffffffffffffffffffffffff19606085901b166020820152600091611250916001600160a01b0390911690603401604051602081830303815290604052805190602001206114b5565b6001600160a01b0384811660009081526004602081905260409182902080546001600160a01b031916938516938417905590516379ccf11760e11b8152929350909163f399e22e916112a6918791879101611acd565b600060405180830381600087803b1580156112c057600080fd5b505af11580156112d4573d6000803e3d6000fd5b50506040516001600160a01b038085169350861691507f0a1eaf9aa124c3f84c9dd77f7016af0f16f67639abb913af1697387db01f5ca590600090a35050505050565b6001600160a01b0384161580159061133757506001600160a01b03831615155b801561134b57506001600160a01b03821615155b801561135f57506001600160a01b03811615155b6113c55760405162461bcd60e51b815260206004820152603160248201527f4368696c644d696e7461626c65455243313135355072656469636174653a204260448201527020a22fa4a724aa24a0a624ad20aa24a7a760791b606482015260840161034d565b600080546001600160a01b03958616620100000262010000600160b01b0319909116179055600180549385166001600160a01b0319948516179055600280549285169284169290921790915560038054919093169116179055565b6000816001600160a01b03163b60000361143c57506000919050565b6040516301ffc9a760e01b8152636cdb3d1360e11b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa9250505080156114a3575060408051601f3d908101601f191682019092526114a091810190611967565b60015b6114af57506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b0381166114af5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b604482015260640161034d565b6001600160a01b038116811461156157600080fd5b50565b60006020828403121561157657600080fd5b81356115818161154c565b9392505050565b60008083601f84011261159a57600080fd5b5081356001600160401b038111156115b157600080fd5b6020830191508360208260051b85010111156115cc57600080fd5b9250929050565b60008060008060008060006080888a0312156115ee57600080fd5b87356115f98161154c565b965060208801356001600160401b038082111561161557600080fd5b6116218b838c01611588565b909850965060408a013591508082111561163a57600080fd5b6116468b838c01611588565b909650945060608a013591508082111561165f57600080fd5b5061166c8a828b01611588565b989b979a50959850939692959293505050565b60008060006060848603121561169457600080fd5b833561169f8161154c565b95602085013595506040909401359392505050565b600080600080608085870312156116ca57600080fd5b84356116d58161154c565b935060208501356116e58161154c565b93969395505050506040820135916060013590565b6000806000806060858703121561171057600080fd5b8435935060208501356117228161154c565b925060408501356001600160401b038082111561173e57600080fd5b818701915087601f83011261175257600080fd5b81358181111561176157600080fd5b88602082850101111561177357600080fd5b95989497505060200194505050565b6000806000806080858703121561179857600080fd5b84356117a38161154c565b935060208501356117b38161154c565b925060408501356117c38161154c565b915060608501356117d38161154c565b939692955090935050565b600080858511156117ee57600080fd5b838611156117fb57600080fd5b5050820193919092039150565b803560208310156114af57600019602084900360031b1b1692915050565b6020808252602b908201527f4368696c644d696e7461626c65455243313135355072656469636174653a204e60408201526a13d517d0d3d395149050d560aa1b606082015260800190565b60006020828403121561188357600080fd5b81516115818161154c565b6020808252602d908201527f4368696c644d696e7461626c65455243313135355072656469636174653a205560408201526c2726a0a82822a22faa27a5a2a760991b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561190a57600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b038616815260606020820181905260009061194890830186886118f1565b828103604084015261195b8185876118f1565b98975050505050505050565b60006020828403121561197957600080fd5b8151801515811461158157600080fd5b6020808252602a908201527f4368696c644d696e7461626c65455243313135355072656469636174653a204260408201526915549397d1905253115160b21b606082015260800190565b8183526000602080850194508260005b85811015611a115781356119f68161154c565b6001600160a01b0316875295820195908201906001016119e3565b509495945050505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090611a4f908301888a6119d3565b8281036080840152611a628187896118f1565b905082810360a0840152611a778185876118f1565b9c9b505050505050505050505050565b6000815180845260005b81811015611aad57602081850181015186830182015201611a91565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611af190830184611a87565b949350505050565b606081526000611b0d60608301888a6119d3565b8281036020840152611b208187896118f1565b90508281036040840152611b358185876118f1565b9998505050505050505050565b6001600160a01b039390931683526020830191909152604082015260600190565b600080600080600060a08688031215611b7b57600080fd5b8535611b868161154c565b94506020860135611b968161154c565b93506040860135611ba68161154c565b94979396509394606081013594506080013592915050565b6020808252602a908201527f4368696c644d696e7461626c65455243313135355072656469636174653a204d60408201526912539517d1905253115160b21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611c4657611c46611c08565b604052919050565b60006001600160401b03821115611c6757611c67611c08565b5060051b60200190565b600082601f830112611c8257600080fd5b81356020611c97611c9283611c4e565b611c1e565b82815260059290921b84018101918181019086841115611cb657600080fd5b8286015b84811015611cd15780358352918301918301611cba565b509695505050505050565b60008060008060008060c08789031215611cf557600080fd5b86359550602080880135611d088161154c565b95506040880135611d188161154c565b945060608801356001600160401b0380821115611d3457600080fd5b818a0191508a601f830112611d4857600080fd5b8135611d56611c9282611c4e565b81815260059190911b8301840190848101908d831115611d7557600080fd5b938501935b82851015611d9c578435611d8d8161154c565b82529385019390850190611d7a565b9750505060808a0135925080831115611db457600080fd5b611dc08b848c01611c71565b945060a08a0135925080831115611dd657600080fd5b5050611de489828a01611c71565b9150509295509295509295565b600081518084526020808501945080840160005b83811015611a1157815187529582019590820190600101611e05565b606080825284519082018190526000906020906080840190828801845b82811015611e635781516001600160a01b031684529284019290840190600101611e3e565b50505083810382850152611e778187611df1565b9150508281036040840152611e8c8185611df1565b9695505050505050565b600080600060608486031215611eab57600080fd5b83359250602080850135611ebe8161154c565b925060408501356001600160401b0380821115611eda57600080fd5b818701915087601f830112611eee57600080fd5b813581811115611f0057611f00611c08565b611f12601f8201601f19168501611c1e565b91508082528884828501011115611f2857600080fd5b8084840185840137600084828401015250809350505050925092509256fea26469706673582212202548c33121341dfe54a3591ddfb48a0522912106419666b488c71144be4fd23264736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var CustomSupernetManagerArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"CustomSupernetManager","sourceName":"contracts/root/staking/CustomSupernetManager.sol","abi":[{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"InvalidSignature","type":"error"},{"inputs":[{"internalType":"string","name":"message","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"}],"name":"AddedToWhitelist","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"GenesisBalanceAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"amountValidators","type":"uint256"}],"name":"GenesisFinalized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"}],"name":"RemovedFromWhitelist","type":"event"},{"anonymous":false,"inputs":[],"name":"StakingEnabled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"}],"name":"ValidatorDeactivated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"},{"indexed":false,"internalType":"uint256[4]","name":"blsKey","type":"uint256[4]"}],"name":"ValidatorRegistered","type":"event"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"addGenesisBalance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"domain","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"enableStaking","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"finalizeGenesis","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"genesisBalances","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"genesisSet","outputs":[{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint256","name":"initialStake","type":"uint256"}],"internalType":"struct GenesisValidator[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validator_","type":"address"}],"name":"getValidator","outputs":[{"components":[{"internalType":"uint256[4]","name":"blsKey","type":"uint256[4]"},{"internalType":"uint256","name":"stake","type":"uint256"},{"internalType":"bool","name":"isWhitelisted","type":"bool"},{"internalType":"bool","name":"isActive","type":"bool"}],"internalType":"struct Validator","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"id","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newStakeManager","type":"address"},{"internalType":"address","name":"newBls","type":"address"},{"internalType":"address","name":"newStateSender","type":"address"},{"internalType":"address","name":"newMatic","type":"address"},{"internalType":"address","name":"newChildValidatorSet","type":"address"},{"internalType":"address","name":"newExitHelper","type":"address"},{"internalType":"address","name":"newRootERC20Predicate","type":"address"},{"internalType":"string","name":"newDomain","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id_","type":"uint256"}],"name":"onInit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onL2StateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"onStake","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[2]","name":"signature","type":"uint256[2]"},{"internalType":"uint256[4]","name":"pubkey","type":"uint256[4]"}],"name":"register","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"validators","outputs":[{"internalType":"uint256","name":"stake","type":"uint256"},{"internalType":"bool","name":"isWhitelisted","type":"bool"},{"internalType":"bool","name":"isActive","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"validators_","type":"address[]"}],"name":"whitelistValidators","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b506121a0806100206000396000f3fe608060405234801561001057600080fd5b506004361061012c5760003560e01c80638da5cb5b116100ad578063e30c397811610071578063e30c397814610248578063e53b87a814610259578063f2fde38b14610279578063f43cda8b1461028c578063fa52c7d81461029f57600080fd5b80638da5cb5b146101e65780639e19e9c11461020b578063af640d0f14610220578063c2fb26a614610237578063d11aca621461024057600080fd5b806379ba5097116100f457806379ba50971461019d578063819dc9fb146101a557806385758cc7146101b857806386202194146101c05780638c087b1c146101d357600080fd5b80631904bb2e146101315780631f6590b81461015a578063344a5e641461016f578063542c85f214610182578063715018a614610195575b600080fd5b61014461013f366004611a3d565b6102f2565b6040516101519190611a5a565b60405180910390f35b61016d610168366004611aae565b61037c565b005b61016d61017d366004611af0565b610449565b61016d610190366004611b09565b6104c8565b61016d610523565b61016d610537565b61016d6101b3366004611b94565b6105b1565b61016d610819565b61016d6101ce366004611af0565b61086a565b61016d6101e1366004611cc8565b610b17565b6033546001600160a01b03165b6040516001600160a01b039091168152602001610151565b610213610b4f565b6040516101519190611cf4565b61022960985481565b604051908152602001610151565b61022960d05481565b61016d610b60565b6065546001600160a01b03166101f3565b610229610267366004611a3d565b60d66020526000908152604090205481565b61016d610287366004611a3d565b610b9d565b61016d61029a366004611d4c565b610c0e565b6102d56102ad366004611a3d565b60d4602052600090815260409020600481015460059091015460ff8082169161010090041683565b604080519384529115156020840152151590820152606001610151565b6102fa61196b565b6001600160a01b038216600090815260d46020526040908190208151610100810190925281608081018260048282826020028201915b8154815260200190600101908083116103305750505091835250506004820154602082015260059091015460ff8082161515604084015261010090910416151560609091015292915050565b33600090815260d460205260409020600581015460ff166103d15760405163973d02cb60e01b815260206004820152600960248201526815d2125511531254d560ba1b60448201526064015b60405180910390fd5b6103dc338484610ce2565b6103e881836004611999565b5060058101805461ff00191661010017905561040333610dda565b336001600160a01b03167f110ae3ae039a4632f836a35dc9b1282df88780883fb28779f22c2f7ccde8dd0a8360405161043c9190611dd5565b60405180910390a2505050565b6097546001600160a01b031633146104735760405162461bcd60e51b81526004016103c890611de4565b609854156104c35760405162461bcd60e51b815260206004820152601f60248201527f53757065726e65744d616e616765723a2049445f414c52454144595f5345540060448201526064016103c8565b609855565b6104d0610e26565b8060005b8181101561051d5761050b8484838181106104f1576104f1611e27565b90506020020160208101906105069190611a3d565b610e80565b8061051581611e53565b9150506104d4565b50505050565b61052b610e26565b6105356000610ecf565b565b60655433906001600160a01b031681146105a55760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084016103c8565b6105ae81610ecf565b50565b600054610100900460ff16158080156105d15750600054600160ff909116105b806105eb5750303b1580156105eb575060005460ff166001145b61064e5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103c8565b6000805460ff191660011790558015610671576000805461ff0019166101001790555b6001600160a01b0389161580159061069157506001600160a01b03881615155b80156106a557506001600160a01b03871615155b80156106b957506001600160a01b03861615155b80156106cd57506001600160a01b03851615155b80156106e157506001600160a01b03841615155b80156106ed5750815115155b6107295760405162461bcd60e51b815260206004820152600d60248201526c1253959053125117d253941555609a1b60448201526064016103c8565b61073289610ee8565b60cb80546001600160a01b03199081166001600160a01b038b81169190911790925560cc805482168a841617905560cd8054821689841617905560ce8054821688841617905560cf8054821687841617905560d580549091169185169190911790556040516107a5908390602001611e90565b60408051601f19818403018152919052805160209091012060d0556107c8610f31565b801561080e576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050505050565b610821610e26565b61082b60d1610f60565b7f87f41ee3facb6317b1c2811e539539ac1693525b4460699b4245e8aac9f590cb61085660d1610fda565b5160405190815260200160405180910390a1565b600081116108c85760405162461bcd60e51b815260206004820152602560248201527f437573746f6d53757065726e65744d616e616765723a20494e56414c49445f416044820152641353d5539560da1b60648201526084016103c8565b60d5546001600160a01b031661093f5760405163973d02cb60e01b815260206004820152603560248201527f437573746f6d53757065726e65744d616e616765723a20554e444546494e45446044820152745f524f4f545f45524332305f50524544494341544560581b60648201526084016103c8565b60d55460408051636a00c1d760e01b815290516000926001600160a01b031691636a00c1d7916004808301926020929190829003018187875af115801561098a573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109ae9190611eac565b90506001600160a01b038116610a225760405163973d02cb60e01b815260206004820152603260248201527f437573746f6d53757065726e65744d616e616765723a20554e444546494e454460448201527117d3905512559157d513d2d15397d493d3d560721b60648201526084016103c8565b610a2c60d1611053565b15610a995760405162461bcd60e51b815260206004820152603760248201527f437573746f6d53757065726e65744d616e616765723a2047454e455349535f53604482015276115517d254d7d053149150511657d19253905312569151604a1b60648201526084016103c8565b610aa660d1336000611078565b33600090815260d6602052604081208054849290610ac5908490611ec9565b909155505060d554610ae6906001600160a01b038381169133911685611193565b604051829033907f1706c887e0f7786a7e97fed7b6f19bd6b31854c47c2012b072b44fdbd652623990600090a35050565b6097546001600160a01b03163314610b415760405162461bcd60e51b81526004016103c890611de4565b610b4b82826111ed565b5050565b6060610b5b60d1610fda565b905090565b610b68610e26565b610b7260d161136b565b6040517fda917aeab736a19e4ba54207413dbe4f8c7d558fde2c14d7e66fc8f7186ea8a390600090a1565b610ba5610e26565b606580546001600160a01b0383166001600160a01b03199091168117909155610bd66033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60cf546001600160a01b031633141580610c36575060ce546001600160a01b03848116911614155b15610c725760405163973d02cb60e01b815260206004820152600b60248201526a2fb2bc34ba2432b63832b960a91b60448201526064016103c8565b7f8ca9a95e41b5eece253c93f5b31eed1253aed6b145d8a6e14d913fdf8e732293610ca1602060008486611edc565b610caa91611f06565b0361051d57600080610cbf8360208187611edc565b810190610ccc9190611cc8565b91509150610cda8282611442565b505050505050565b8135158015610cf357506020820135155b15610d1c57604051633615713d60e21b81526001600160a01b03841660048201526024016103c8565b60cb5460009081906001600160a01b031663ebbdac918585610d3d896114b1565b6040518463ffffffff1660e01b8152600401610d5b93929190611f24565b6040805180830381865afa158015610d77573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d9b9190611f7d565b91509150801580610daa575081155b15610dd357604051633615713d60e21b81526001600160a01b03861660048201526024016103c8565b5050505050565b6001600160a01b038116600081815260d46020526040808220600501805460ff19169055517fcdd2e9b91a56913d370075169cefa1602ba36be5301664f752192bb1709df7579190a250565b6033546001600160a01b031633146105355760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016103c8565b6001600160a01b038116600081815260d46020526040808220600501805460ff19166001179055517fa850ae9193f515cbae8d35e8925bd2be26627fc91bce650b8652ed254e9cab039190a250565b606580546001600160a01b03191690556105ae81611573565b600054610100900460ff16610f0f5760405162461bcd60e51b81526004016103c890611fb0565b609780546001600160a01b0319166001600160a01b0392909216919091179055565b600054610100900460ff16610f585760405162461bcd60e51b81526004016103c890611fb0565b6105356115c5565b6000600182015460ff166002811115610f7b57610f7b611ffb565b14610fc85760405162461bcd60e51b815260206004820152601d60248201527f47656e657369734c69623a20616c72656164792066696e616c697a656400000060448201526064016103c8565b6001908101805460ff19169091179055565b606081600001805480602002602001604051908101604052809291908181526020016000905b82821015611048576000848152602090819020604080518082019091526002850290910180546001600160a01b03168252600190810154828401529083529092019101611000565b505050509050919050565b600060025b600183015460ff16600281111561107157611071611ffb565b1492915050565b6000600184015460ff16600281111561109357611093611ffb565b146110a0576110a0612011565b6001600160a01b03821660009081526002840160205260408120549081900361113d5783546110d0906001611ec9565b6001600160a01b03848116600081815260028881016020908152604080842087905580518082019091529384528381018881528a5460018082018d558c86529290942094519390920290930180546001600160a01b0319169290941691909117835551910155905061051d565b600061114985856115f5565b9050600085600001828154811061116257611162611e27565b90600052602060002090600202019050838160010160008282546111869190611ec9565b9091555050505050505050565b604080516001600160a01b0385811660248301528416604482015260648082018490528251808303909101815260849091019091526020810180516001600160e01b03166323b872dd60e01b17905261051d908590611632565b6001600160a01b038216600090815260d460205260409020600501548290610100900460ff1661124c5760405163973d02cb60e01b81526020600482015260096024820152682b20a624a220aa27a960b91b60448201526064016103c8565b61125660d1611707565b1561126c5761126760d18484611078565b505050565b61127660d1611053565b1561132f5760cc5460ce54604080517f1bcc0f4c3fad314e585165815f94ecca9b96690a26d6417d7876448a9a867a6960208201526001600160a01b038781168284015260608083018890528351808403909101815260808301938490526316f1983160e01b909352938416936316f19831936112f893911691608401612053565b600060405180830381600087803b15801561131257600080fd5b505af1158015611326573d6000803e3d6000fd5b50505050505050565b60405163973d02cb60e01b815260206004820152601060248201526f5761697420666f722067656e6573697360801b60448201526064016103c8565b600181015460ff16600081600281111561138757611387611ffb565b036113d05760405162461bcd60e51b815260206004820152601960248201527811d95b995cda5cd31a588e881b9bdd08199a5b985b1a5e9959603a1b60448201526064016103c8565b60028160028111156113e4576113e4611ffb565b036114315760405162461bcd60e51b815260206004820152601b60248201527f47656e657369734c69623a20616c726561647920656e61626c6564000000000060448201526064016103c8565b50600101805460ff19166002179055565b609754604051633651bb1d60e01b81526001600160a01b0384811660048301526024820184905290911690633651bb1d90604401600060405180830381600087803b15801561149057600080fd5b505af11580156114a4573d6000803e3d6000fd5b50505050610b4b8261170f565b6114b96119d7565b60cb5460d0546040516bffffffffffffffffffffffff19606086811b8216602084015230901b1660348201524660488201526001600160a01b039092169163a850a90991906068016040516020818303038152906040526040518363ffffffff1660e01b815260040161152d929190612077565b6040805180830381865afa158015611549573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061156d9190612090565b92915050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166115ec5760405162461bcd60e51b81526004016103c890611fb0565b61053533610ecf565b6001600160a01b03811660009081526002830160205260408120549081900361162057611620612011565b61162b600182612110565b9392505050565b6000611687826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166117db9092919063ffffffff16565b90508051600014806116a85750808060200190518101906116a89190612123565b6112675760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b60648201526084016103c8565b600080611058565b609754609854604051633b61c5a760e21b81526001600160a01b038481166004830152602482019290925291169063ed87169c90604401602060405180830381865afa158015611763573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611787919061213e565b6000036105ae576001600160a01b038116600081815260d46020526040808220600501805461ff0019169055517f23d934bfe7f1275bc6fd70432159c9cc1c0075d069f89da6a40f43bfe7a94ed39190a250565b60606117ea84846000856117f2565b949350505050565b6060824710156118535760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b60648201526084016103c8565b600080866001600160a01b0316858760405161186f9190611e90565b60006040518083038185875af1925050503d80600081146118ac576040519150601f19603f3d011682016040523d82523d6000602084013e6118b1565b606091505b50915091506118c2878383876118cd565b979650505050505050565b6060831561193c578251600003611935576001600160a01b0385163b6119355760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016103c8565b50816117ea565b6117ea83838151156119515781518083602001fd5b8060405162461bcd60e51b81526004016103c89190612157565b604051806080016040528061197e6119f5565b81526000602082018190526040820181905260609091015290565b82600481019282156119c7579160200282015b828111156119c75782358255916020019190600101906119ac565b506119d3929150611a13565b5090565b60405180604001604052806002906020820280368337509192915050565b60405180608001604052806004906020820280368337509192915050565b5b808211156119d35760008155600101611a14565b6001600160a01b03811681146105ae57600080fd5b600060208284031215611a4f57600080fd5b813561162b81611a28565b815160e08201908260005b6004811015611a84578251825260209283019290910190600101611a65565b505050602083015160808301526040830151151560a0830152606090920151151560c09091015290565b60008060c08385031215611ac157600080fd5b6040830184811115611ad257600080fd5b8392508460c085011115611ae557600080fd5b809150509250929050565b600060208284031215611b0257600080fd5b5035919050565b60008060208385031215611b1c57600080fd5b823567ffffffffffffffff80821115611b3457600080fd5b818501915085601f830112611b4857600080fd5b813581811115611b5757600080fd5b8660208260051b8501011115611b6c57600080fd5b60209290920196919550909350505050565b634e487b7160e01b600052604160045260246000fd5b600080600080600080600080610100898b031215611bb157600080fd5b8835611bbc81611a28565b97506020890135611bcc81611a28565b96506040890135611bdc81611a28565b95506060890135611bec81611a28565b94506080890135611bfc81611a28565b935060a0890135611c0c81611a28565b925060c0890135611c1c81611a28565b915060e089013567ffffffffffffffff80821115611c3957600080fd5b818b0191508b601f830112611c4d57600080fd5b813581811115611c5f57611c5f611b7e565b604051601f8201601f19908116603f01168101908382118183101715611c8757611c87611b7e565b816040528281528e6020848701011115611ca057600080fd5b8260208601602083013760006020848301015280955050505050509295985092959890939650565b60008060408385031215611cdb57600080fd5b8235611ce681611a28565b946020939093013593505050565b602080825282518282018190526000919060409081850190868401855b82811015611d3f57815180516001600160a01b03168552860151868501529284019290850190600101611d11565b5091979650505050505050565b60008060008060608587031215611d6257600080fd5b843593506020850135611d7481611a28565b9250604085013567ffffffffffffffff80821115611d9157600080fd5b818701915087601f830112611da557600080fd5b813581811115611db457600080fd5b886020828501011115611dc657600080fd5b95989497505060200194505050565b60808181019083833792915050565b60208082526023908201527f53757065726e65744d616e616765723a204f4e4c595f5354414b455f4d414e4160408201526223a2a960e91b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b600060018201611e6557611e65611e3d565b5060010190565b60005b83811015611e87578181015183820152602001611e6f565b50506000910152565b60008251611ea2818460208701611e6c565b9190910192915050565b600060208284031215611ebe57600080fd5b815161162b81611a28565b8082018082111561156d5761156d611e3d565b60008085851115611eec57600080fd5b83861115611ef957600080fd5b5050820193919092039150565b8035602083101561156d57600019602084900360031b1b1692915050565b61010081016040858337608084604084013760c082018360005b6002811015611f5d578151835260209283019290910190600101611f3e565b505050949350505050565b80518015158114611f7857600080fd5b919050565b60008060408385031215611f9057600080fd5b611f9983611f68565b9150611fa760208401611f68565b90509250929050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052600160045260246000fd5b6000815180845261203f816020860160208601611e6c565b601f01601f19169290920160200192915050565b6001600160a01b03831681526040602082018190526000906117ea90830184612027565b8281526040602082015260006117ea6040830184612027565b6000604082840312156120a257600080fd5b82601f8301126120b157600080fd5b6040516040810181811067ffffffffffffffff821117156120d4576120d4611b7e565b80604052508060408401858111156120eb57600080fd5b845b818110156121055780518352602092830192016120ed565b509195945050505050565b8181038181111561156d5761156d611e3d565b60006020828403121561213557600080fd5b61162b82611f68565b60006020828403121561215057600080fd5b5051919050565b60208152600061162b602083018461202756fea2646970667358221220c854c4bd92b5e40db8e0e9b90d5bc01c31cbec4f50c64ece828835f89a96927664736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b506004361061012c5760003560e01c80638da5cb5b116100ad578063e30c397811610071578063e30c397814610248578063e53b87a814610259578063f2fde38b14610279578063f43cda8b1461028c578063fa52c7d81461029f57600080fd5b80638da5cb5b146101e65780639e19e9c11461020b578063af640d0f14610220578063c2fb26a614610237578063d11aca621461024057600080fd5b806379ba5097116100f457806379ba50971461019d578063819dc9fb146101a557806385758cc7146101b857806386202194146101c05780638c087b1c146101d357600080fd5b80631904bb2e146101315780631f6590b81461015a578063344a5e641461016f578063542c85f214610182578063715018a614610195575b600080fd5b61014461013f366004611a3d565b6102f2565b6040516101519190611a5a565b60405180910390f35b61016d610168366004611aae565b61037c565b005b61016d61017d366004611af0565b610449565b61016d610190366004611b09565b6104c8565b61016d610523565b61016d610537565b61016d6101b3366004611b94565b6105b1565b61016d610819565b61016d6101ce366004611af0565b61086a565b61016d6101e1366004611cc8565b610b17565b6033546001600160a01b03165b6040516001600160a01b039091168152602001610151565b610213610b4f565b6040516101519190611cf4565b61022960985481565b604051908152602001610151565b61022960d05481565b61016d610b60565b6065546001600160a01b03166101f3565b610229610267366004611a3d565b60d66020526000908152604090205481565b61016d610287366004611a3d565b610b9d565b61016d61029a366004611d4c565b610c0e565b6102d56102ad366004611a3d565b60d4602052600090815260409020600481015460059091015460ff8082169161010090041683565b604080519384529115156020840152151590820152606001610151565b6102fa61196b565b6001600160a01b038216600090815260d46020526040908190208151610100810190925281608081018260048282826020028201915b8154815260200190600101908083116103305750505091835250506004820154602082015260059091015460ff8082161515604084015261010090910416151560609091015292915050565b33600090815260d460205260409020600581015460ff166103d15760405163973d02cb60e01b815260206004820152600960248201526815d2125511531254d560ba1b60448201526064015b60405180910390fd5b6103dc338484610ce2565b6103e881836004611999565b5060058101805461ff00191661010017905561040333610dda565b336001600160a01b03167f110ae3ae039a4632f836a35dc9b1282df88780883fb28779f22c2f7ccde8dd0a8360405161043c9190611dd5565b60405180910390a2505050565b6097546001600160a01b031633146104735760405162461bcd60e51b81526004016103c890611de4565b609854156104c35760405162461bcd60e51b815260206004820152601f60248201527f53757065726e65744d616e616765723a2049445f414c52454144595f5345540060448201526064016103c8565b609855565b6104d0610e26565b8060005b8181101561051d5761050b8484838181106104f1576104f1611e27565b90506020020160208101906105069190611a3d565b610e80565b8061051581611e53565b9150506104d4565b50505050565b61052b610e26565b6105356000610ecf565b565b60655433906001600160a01b031681146105a55760405162461bcd60e51b815260206004820152602960248201527f4f776e61626c6532537465703a2063616c6c6572206973206e6f7420746865206044820152683732bb9037bbb732b960b91b60648201526084016103c8565b6105ae81610ecf565b50565b600054610100900460ff16158080156105d15750600054600160ff909116105b806105eb5750303b1580156105eb575060005460ff166001145b61064e5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103c8565b6000805460ff191660011790558015610671576000805461ff0019166101001790555b6001600160a01b0389161580159061069157506001600160a01b03881615155b80156106a557506001600160a01b03871615155b80156106b957506001600160a01b03861615155b80156106cd57506001600160a01b03851615155b80156106e157506001600160a01b03841615155b80156106ed5750815115155b6107295760405162461bcd60e51b815260206004820152600d60248201526c1253959053125117d253941555609a1b60448201526064016103c8565b61073289610ee8565b60cb80546001600160a01b03199081166001600160a01b038b81169190911790925560cc805482168a841617905560cd8054821689841617905560ce8054821688841617905560cf8054821687841617905560d580549091169185169190911790556040516107a5908390602001611e90565b60408051601f19818403018152919052805160209091012060d0556107c8610f31565b801561080e576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050505050565b610821610e26565b61082b60d1610f60565b7f87f41ee3facb6317b1c2811e539539ac1693525b4460699b4245e8aac9f590cb61085660d1610fda565b5160405190815260200160405180910390a1565b600081116108c85760405162461bcd60e51b815260206004820152602560248201527f437573746f6d53757065726e65744d616e616765723a20494e56414c49445f416044820152641353d5539560da1b60648201526084016103c8565b60d5546001600160a01b031661093f5760405163973d02cb60e01b815260206004820152603560248201527f437573746f6d53757065726e65744d616e616765723a20554e444546494e45446044820152745f524f4f545f45524332305f50524544494341544560581b60648201526084016103c8565b60d55460408051636a00c1d760e01b815290516000926001600160a01b031691636a00c1d7916004808301926020929190829003018187875af115801561098a573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109ae9190611eac565b90506001600160a01b038116610a225760405163973d02cb60e01b815260206004820152603260248201527f437573746f6d53757065726e65744d616e616765723a20554e444546494e454460448201527117d3905512559157d513d2d15397d493d3d560721b60648201526084016103c8565b610a2c60d1611053565b15610a995760405162461bcd60e51b815260206004820152603760248201527f437573746f6d53757065726e65744d616e616765723a2047454e455349535f53604482015276115517d254d7d053149150511657d19253905312569151604a1b60648201526084016103c8565b610aa660d1336000611078565b33600090815260d6602052604081208054849290610ac5908490611ec9565b909155505060d554610ae6906001600160a01b038381169133911685611193565b604051829033907f1706c887e0f7786a7e97fed7b6f19bd6b31854c47c2012b072b44fdbd652623990600090a35050565b6097546001600160a01b03163314610b415760405162461bcd60e51b81526004016103c890611de4565b610b4b82826111ed565b5050565b6060610b5b60d1610fda565b905090565b610b68610e26565b610b7260d161136b565b6040517fda917aeab736a19e4ba54207413dbe4f8c7d558fde2c14d7e66fc8f7186ea8a390600090a1565b610ba5610e26565b606580546001600160a01b0383166001600160a01b03199091168117909155610bd66033546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b60cf546001600160a01b031633141580610c36575060ce546001600160a01b03848116911614155b15610c725760405163973d02cb60e01b815260206004820152600b60248201526a2fb2bc34ba2432b63832b960a91b60448201526064016103c8565b7f8ca9a95e41b5eece253c93f5b31eed1253aed6b145d8a6e14d913fdf8e732293610ca1602060008486611edc565b610caa91611f06565b0361051d57600080610cbf8360208187611edc565b810190610ccc9190611cc8565b91509150610cda8282611442565b505050505050565b8135158015610cf357506020820135155b15610d1c57604051633615713d60e21b81526001600160a01b03841660048201526024016103c8565b60cb5460009081906001600160a01b031663ebbdac918585610d3d896114b1565b6040518463ffffffff1660e01b8152600401610d5b93929190611f24565b6040805180830381865afa158015610d77573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d9b9190611f7d565b91509150801580610daa575081155b15610dd357604051633615713d60e21b81526001600160a01b03861660048201526024016103c8565b5050505050565b6001600160a01b038116600081815260d46020526040808220600501805460ff19169055517fcdd2e9b91a56913d370075169cefa1602ba36be5301664f752192bb1709df7579190a250565b6033546001600160a01b031633146105355760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016103c8565b6001600160a01b038116600081815260d46020526040808220600501805460ff19166001179055517fa850ae9193f515cbae8d35e8925bd2be26627fc91bce650b8652ed254e9cab039190a250565b606580546001600160a01b03191690556105ae81611573565b600054610100900460ff16610f0f5760405162461bcd60e51b81526004016103c890611fb0565b609780546001600160a01b0319166001600160a01b0392909216919091179055565b600054610100900460ff16610f585760405162461bcd60e51b81526004016103c890611fb0565b6105356115c5565b6000600182015460ff166002811115610f7b57610f7b611ffb565b14610fc85760405162461bcd60e51b815260206004820152601d60248201527f47656e657369734c69623a20616c72656164792066696e616c697a656400000060448201526064016103c8565b6001908101805460ff19169091179055565b606081600001805480602002602001604051908101604052809291908181526020016000905b82821015611048576000848152602090819020604080518082019091526002850290910180546001600160a01b03168252600190810154828401529083529092019101611000565b505050509050919050565b600060025b600183015460ff16600281111561107157611071611ffb565b1492915050565b6000600184015460ff16600281111561109357611093611ffb565b146110a0576110a0612011565b6001600160a01b03821660009081526002840160205260408120549081900361113d5783546110d0906001611ec9565b6001600160a01b03848116600081815260028881016020908152604080842087905580518082019091529384528381018881528a5460018082018d558c86529290942094519390920290930180546001600160a01b0319169290941691909117835551910155905061051d565b600061114985856115f5565b9050600085600001828154811061116257611162611e27565b90600052602060002090600202019050838160010160008282546111869190611ec9565b9091555050505050505050565b604080516001600160a01b0385811660248301528416604482015260648082018490528251808303909101815260849091019091526020810180516001600160e01b03166323b872dd60e01b17905261051d908590611632565b6001600160a01b038216600090815260d460205260409020600501548290610100900460ff1661124c5760405163973d02cb60e01b81526020600482015260096024820152682b20a624a220aa27a960b91b60448201526064016103c8565b61125660d1611707565b1561126c5761126760d18484611078565b505050565b61127660d1611053565b1561132f5760cc5460ce54604080517f1bcc0f4c3fad314e585165815f94ecca9b96690a26d6417d7876448a9a867a6960208201526001600160a01b038781168284015260608083018890528351808403909101815260808301938490526316f1983160e01b909352938416936316f19831936112f893911691608401612053565b600060405180830381600087803b15801561131257600080fd5b505af1158015611326573d6000803e3d6000fd5b50505050505050565b60405163973d02cb60e01b815260206004820152601060248201526f5761697420666f722067656e6573697360801b60448201526064016103c8565b600181015460ff16600081600281111561138757611387611ffb565b036113d05760405162461bcd60e51b815260206004820152601960248201527811d95b995cda5cd31a588e881b9bdd08199a5b985b1a5e9959603a1b60448201526064016103c8565b60028160028111156113e4576113e4611ffb565b036114315760405162461bcd60e51b815260206004820152601b60248201527f47656e657369734c69623a20616c726561647920656e61626c6564000000000060448201526064016103c8565b50600101805460ff19166002179055565b609754604051633651bb1d60e01b81526001600160a01b0384811660048301526024820184905290911690633651bb1d90604401600060405180830381600087803b15801561149057600080fd5b505af11580156114a4573d6000803e3d6000fd5b50505050610b4b8261170f565b6114b96119d7565b60cb5460d0546040516bffffffffffffffffffffffff19606086811b8216602084015230901b1660348201524660488201526001600160a01b039092169163a850a90991906068016040516020818303038152906040526040518363ffffffff1660e01b815260040161152d929190612077565b6040805180830381865afa158015611549573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061156d9190612090565b92915050565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b600054610100900460ff166115ec5760405162461bcd60e51b81526004016103c890611fb0565b61053533610ecf565b6001600160a01b03811660009081526002830160205260408120549081900361162057611620612011565b61162b600182612110565b9392505050565b6000611687826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166117db9092919063ffffffff16565b90508051600014806116a85750808060200190518101906116a89190612123565b6112675760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b60648201526084016103c8565b600080611058565b609754609854604051633b61c5a760e21b81526001600160a01b038481166004830152602482019290925291169063ed87169c90604401602060405180830381865afa158015611763573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611787919061213e565b6000036105ae576001600160a01b038116600081815260d46020526040808220600501805461ff0019169055517f23d934bfe7f1275bc6fd70432159c9cc1c0075d069f89da6a40f43bfe7a94ed39190a250565b60606117ea84846000856117f2565b949350505050565b6060824710156118535760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b60648201526084016103c8565b600080866001600160a01b0316858760405161186f9190611e90565b60006040518083038185875af1925050503d80600081146118ac576040519150601f19603f3d011682016040523d82523d6000602084013e6118b1565b606091505b50915091506118c2878383876118cd565b979650505050505050565b6060831561193c578251600003611935576001600160a01b0385163b6119355760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016103c8565b50816117ea565b6117ea83838151156119515781518083602001fd5b8060405162461bcd60e51b81526004016103c89190612157565b604051806080016040528061197e6119f5565b81526000602082018190526040820181905260609091015290565b82600481019282156119c7579160200282015b828111156119c75782358255916020019190600101906119ac565b506119d3929150611a13565b5090565b60405180604001604052806002906020820280368337509192915050565b60405180608001604052806004906020820280368337509192915050565b5b808211156119d35760008155600101611a14565b6001600160a01b03811681146105ae57600080fd5b600060208284031215611a4f57600080fd5b813561162b81611a28565b815160e08201908260005b6004811015611a84578251825260209283019290910190600101611a65565b505050602083015160808301526040830151151560a0830152606090920151151560c09091015290565b60008060c08385031215611ac157600080fd5b6040830184811115611ad257600080fd5b8392508460c085011115611ae557600080fd5b809150509250929050565b600060208284031215611b0257600080fd5b5035919050565b60008060208385031215611b1c57600080fd5b823567ffffffffffffffff80821115611b3457600080fd5b818501915085601f830112611b4857600080fd5b813581811115611b5757600080fd5b8660208260051b8501011115611b6c57600080fd5b60209290920196919550909350505050565b634e487b7160e01b600052604160045260246000fd5b600080600080600080600080610100898b031215611bb157600080fd5b8835611bbc81611a28565b97506020890135611bcc81611a28565b96506040890135611bdc81611a28565b95506060890135611bec81611a28565b94506080890135611bfc81611a28565b935060a0890135611c0c81611a28565b925060c0890135611c1c81611a28565b915060e089013567ffffffffffffffff80821115611c3957600080fd5b818b0191508b601f830112611c4d57600080fd5b813581811115611c5f57611c5f611b7e565b604051601f8201601f19908116603f01168101908382118183101715611c8757611c87611b7e565b816040528281528e6020848701011115611ca057600080fd5b8260208601602083013760006020848301015280955050505050509295985092959890939650565b60008060408385031215611cdb57600080fd5b8235611ce681611a28565b946020939093013593505050565b602080825282518282018190526000919060409081850190868401855b82811015611d3f57815180516001600160a01b03168552860151868501529284019290850190600101611d11565b5091979650505050505050565b60008060008060608587031215611d6257600080fd5b843593506020850135611d7481611a28565b9250604085013567ffffffffffffffff80821115611d9157600080fd5b818701915087601f830112611da557600080fd5b813581811115611db457600080fd5b886020828501011115611dc657600080fd5b95989497505060200194505050565b60808181019083833792915050565b60208082526023908201527f53757065726e65744d616e616765723a204f4e4c595f5354414b455f4d414e4160408201526223a2a960e91b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b600060018201611e6557611e65611e3d565b5060010190565b60005b83811015611e87578181015183820152602001611e6f565b50506000910152565b60008251611ea2818460208701611e6c565b9190910192915050565b600060208284031215611ebe57600080fd5b815161162b81611a28565b8082018082111561156d5761156d611e3d565b60008085851115611eec57600080fd5b83861115611ef957600080fd5b5050820193919092039150565b8035602083101561156d57600019602084900360031b1b1692915050565b61010081016040858337608084604084013760c082018360005b6002811015611f5d578151835260209283019290910190600101611f3e565b505050949350505050565b80518015158114611f7857600080fd5b919050565b60008060408385031215611f9057600080fd5b611f9983611f68565b9150611fa760208401611f68565b90509250929050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052602160045260246000fd5b634e487b7160e01b600052600160045260246000fd5b6000815180845261203f816020860160208601611e6c565b601f01601f19169290920160200192915050565b6001600160a01b03831681526040602082018190526000906117ea90830184612027565b8281526040602082015260006117ea6040830184612027565b6000604082840312156120a257600080fd5b82601f8301126120b157600080fd5b6040516040810181811067ffffffffffffffff821117156120d4576120d4611b7e565b80604052508060408401858111156120eb57600080fd5b845b818110156121055780518352602092830192016120ed565b509195945050505050565b8181038181111561156d5761156d611e3d565b60006020828403121561213557600080fd5b61162b82611f68565b60006020828403121561215057600080fd5b5051919050565b60208152600061162b602083018461202756fea2646970667358221220c854c4bd92b5e40db8e0e9b90d5bc01c31cbec4f50c64ece828835f89a96927664736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var StakeManagerArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"StakeManager","sourceName":"contracts/root/staking/StakeManager.sol","abi":[{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"manager","type":"address"}],"name":"ChildManagerRegistered","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"validator","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"StakeAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"validator","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"StakeRemoved","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"validator","type":"address"},{"indexed":true,"internalType":"address","name":"recipient","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"StakeWithdrawn","type":"event"},{"inputs":[{"internalType":"address","name":"manager","type":"address"}],"name":"idFor","outputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newStakingToken","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"managerOf","outputs":[{"internalType":"contract ISupernetManager","name":"manager","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"manager","type":"address"}],"name":"registerChildChain","outputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"releaseStakeOf","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"stakeFor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"stakeOf","outputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalStake","outputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"totalStakeOf","outputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"totalStakeOfChild","outputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"withdrawStake","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator","type":"address"}],"name":"withdrawableStake","outputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50610e59806100206000396000f3fe608060405234801561001057600080fd5b50600436106100b45760003560e01c8063c73a7a1f11610071578063c73a7a1f14610135578063d5364bbf14610148578063d7fbee3d1461015b578063e3f56eaa14610186578063ed87169c14610199578063f90423fe146101ac57600080fd5b80633651bb1d146100b957806339ed8c90146100ce5780638b0e9f3f146100f4578063b64ddbf6146100fc578063c4d66de81461010f578063c606627214610122575b600080fd5b6100cc6100c7366004610cd2565b6101bf565b005b6100e16100dc366004610cfc565b610220565b6040519081526020015b60405180910390f35b6036546100e1565b6100e161010a366004610d15565b610236565b6100cc61011d366004610d15565b610342565b6100cc610130366004610cd2565b610467565b6100cc610143366004610d30565b610472565b6100e1610156366004610d15565b61058f565b61016e610169366004610cfc565b6105ad565b6040516001600160a01b0390911681526020016100eb565b6100e1610194366004610d15565b6105b8565b6100e16101a7366004610cd2565b6105d6565b6100e16101ba366004610d15565b610602565b60006101ca33610602565b90506101d783828461060d565b826001600160a01b0316817fcbc2141407acdf7a77731afda2c1369f3c46e04194b90a9d527385c17608eb0d8460405161021391815260200190565b60405180910390a3505050565b6000818152603860205260408120545b92915050565b6001600160a01b038116600090815260036020526040812054156102a15760405162461bcd60e51b815260206004820152601c60248201527f5374616b654d616e616765723a2049445f414c52454144595f5345540000000060448201526064015b60405180910390fd5b6102aa826106e0565b604051630d12979960e21b8152600481018290529091506001600160a01b0383169063344a5e6490602401600060405180830381600087803b1580156102ef57600080fd5b505af1158015610303573d6000803e3d6000fd5b50506040516001600160a01b03851692508391507f64566eaf28160aee8cce7464dbf8eb54939f81ac929a8ebeea66865ff57963c490600090a3919050565b600054610100900460ff16158080156103625750600054600160ff909116105b8061037c5750303b15801561037c575060005460ff166001145b6103df5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610298565b6000805460ff191660011790558015610402576000805461ff0019166101001790555b606d80546001600160a01b0319166001600160a01b0384161790558015610463576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050565b610463338383610791565b811580159061048357506001548211155b6104ca5760405162461bcd60e51b815260206004820152601860248201527714dd185ad953585b9859d95c8e881253959053125117d25160421b6044820152606401610298565b606d546104e2906001600160a01b03163330846107f7565b6104ed338383610868565b60006104f8836105ad565b6040516323021ec760e21b8152336004820152602481018490529091506001600160a01b03821690638c087b1c90604401600060405180830381600087803b15801561054357600080fd5b505af1158015610557573d6000803e3d6000fd5b50506040518481523392508591507fc1d3c31619aec7561f6fa519052617aed252a25edaddc5d7428681180516837a90602001610213565b6001600160a01b0381166000908152603a6020526040812054610230565b600061023082610904565b6001600160a01b038116600090815260396020526040812054610230565b6001600160a01b03821660009081526037602090815260408083208484529091528120545b9392505050565b600061023082610978565b6001600160a01b038316600090815260376020908152604080832085845290915281208054839290610640908490610d68565b909155505060008281526038602052604081208054839290610663908490610d68565b90915550506001600160a01b03831660009081526039602052604081208054839290610690908490610d68565b9250508190555080603660008282546106a99190610d68565b90915550506001600160a01b0383166000908152603a6020526040812080548392906106d6908490610d7b565b9091555050505050565b60006001600160a01b0382166107475760405162461bcd60e51b815260206004820152602660248201527f5374616b654d616e616765724368696c64446174613a20494e56414c49445f4160448201526544445245535360d01b6064820152608401610298565b5060018054810190819055600081815260026020908152604080832080546001600160a01b039096166001600160a01b031990961686179055938252600390529190912081905590565b61079b83826109f0565b606d546107b2906001600160a01b03168383610a21565b816001600160a01b0316836001600160a01b03167fb7c918e0e249f999e965cafeb6c664271b3f4317d296461500e71da39f0cbda38360405161021391815260200190565b6040516001600160a01b03808516602483015283166044820152606481018290526108629085906323b872dd60e01b906084015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152610a56565b50505050565b6001600160a01b03831660009081526037602090815260408083208584529091528120805483929061089b908490610d7b565b9091555050600082815260386020526040812080548392906108be908490610d7b565b90915550506001600160a01b038316600090815260396020526040812080548392906108eb908490610d7b565b9250508190555080603660008282546106d69190610d7b565b6000818152600260205260409020546001600160a01b0316806109735760405162461bcd60e51b815260206004820152602160248201527f5374616b654d616e616765724368696c64446174613a20494e56414c49445f496044820152601160fa1b6064820152608401610298565b919050565b6001600160a01b038116600090815260036020526040812054908190036109735760405162461bcd60e51b815260206004820152602660248201527f5374616b654d616e616765724368696c64446174613a20494e56414c49445f4d60448201526520a720a3a2a960d11b6064820152608401610298565b6001600160a01b0382166000908152603a602052604081208054839290610a18908490610d68565b90915550505050565b6040516001600160a01b038316602482015260448101829052610a5190849063a9059cbb60e01b9060640161082b565b505050565b6000610aab826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316610b2b9092919063ffffffff16565b9050805160001480610acc575080806020019051810190610acc9190610d8e565b610a515760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610298565b6060610b3a8484600085610b42565b949350505050565b606082471015610ba35760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610298565b600080866001600160a01b03168587604051610bbf9190610dd4565b60006040518083038185875af1925050503d8060008114610bfc576040519150601f19603f3d011682016040523d82523d6000602084013e610c01565b606091505b5091509150610c1287838387610c1d565b979650505050505050565b60608315610c8c578251600003610c85576001600160a01b0385163b610c855760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610298565b5081610b3a565b610b3a8383815115610ca15781518083602001fd5b8060405162461bcd60e51b81526004016102989190610df0565b80356001600160a01b038116811461097357600080fd5b60008060408385031215610ce557600080fd5b610cee83610cbb565b946020939093013593505050565b600060208284031215610d0e57600080fd5b5035919050565b600060208284031215610d2757600080fd5b6105fb82610cbb565b60008060408385031215610d4357600080fd5b50508035926020909101359150565b634e487b7160e01b600052601160045260246000fd5b8181038181111561023057610230610d52565b8082018082111561023057610230610d52565b600060208284031215610da057600080fd5b815180151581146105fb57600080fd5b60005b83811015610dcb578181015183820152602001610db3565b50506000910152565b60008251610de6818460208701610db0565b9190910192915050565b6020815260008251806020840152610e0f816040850160208701610db0565b601f01601f1916919091016040019291505056fea26469706673582212207f5dfe1cb46bc115076fa23b9ffb2421ed989feee340cc0546c7e357469d57e864736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106100b45760003560e01c8063c73a7a1f11610071578063c73a7a1f14610135578063d5364bbf14610148578063d7fbee3d1461015b578063e3f56eaa14610186578063ed87169c14610199578063f90423fe146101ac57600080fd5b80633651bb1d146100b957806339ed8c90146100ce5780638b0e9f3f146100f4578063b64ddbf6146100fc578063c4d66de81461010f578063c606627214610122575b600080fd5b6100cc6100c7366004610cd2565b6101bf565b005b6100e16100dc366004610cfc565b610220565b6040519081526020015b60405180910390f35b6036546100e1565b6100e161010a366004610d15565b610236565b6100cc61011d366004610d15565b610342565b6100cc610130366004610cd2565b610467565b6100cc610143366004610d30565b610472565b6100e1610156366004610d15565b61058f565b61016e610169366004610cfc565b6105ad565b6040516001600160a01b0390911681526020016100eb565b6100e1610194366004610d15565b6105b8565b6100e16101a7366004610cd2565b6105d6565b6100e16101ba366004610d15565b610602565b60006101ca33610602565b90506101d783828461060d565b826001600160a01b0316817fcbc2141407acdf7a77731afda2c1369f3c46e04194b90a9d527385c17608eb0d8460405161021391815260200190565b60405180910390a3505050565b6000818152603860205260408120545b92915050565b6001600160a01b038116600090815260036020526040812054156102a15760405162461bcd60e51b815260206004820152601c60248201527f5374616b654d616e616765723a2049445f414c52454144595f5345540000000060448201526064015b60405180910390fd5b6102aa826106e0565b604051630d12979960e21b8152600481018290529091506001600160a01b0383169063344a5e6490602401600060405180830381600087803b1580156102ef57600080fd5b505af1158015610303573d6000803e3d6000fd5b50506040516001600160a01b03851692508391507f64566eaf28160aee8cce7464dbf8eb54939f81ac929a8ebeea66865ff57963c490600090a3919050565b600054610100900460ff16158080156103625750600054600160ff909116105b8061037c5750303b15801561037c575060005460ff166001145b6103df5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610298565b6000805460ff191660011790558015610402576000805461ff0019166101001790555b606d80546001600160a01b0319166001600160a01b0384161790558015610463576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050565b610463338383610791565b811580159061048357506001548211155b6104ca5760405162461bcd60e51b815260206004820152601860248201527714dd185ad953585b9859d95c8e881253959053125117d25160421b6044820152606401610298565b606d546104e2906001600160a01b03163330846107f7565b6104ed338383610868565b60006104f8836105ad565b6040516323021ec760e21b8152336004820152602481018490529091506001600160a01b03821690638c087b1c90604401600060405180830381600087803b15801561054357600080fd5b505af1158015610557573d6000803e3d6000fd5b50506040518481523392508591507fc1d3c31619aec7561f6fa519052617aed252a25edaddc5d7428681180516837a90602001610213565b6001600160a01b0381166000908152603a6020526040812054610230565b600061023082610904565b6001600160a01b038116600090815260396020526040812054610230565b6001600160a01b03821660009081526037602090815260408083208484529091528120545b9392505050565b600061023082610978565b6001600160a01b038316600090815260376020908152604080832085845290915281208054839290610640908490610d68565b909155505060008281526038602052604081208054839290610663908490610d68565b90915550506001600160a01b03831660009081526039602052604081208054839290610690908490610d68565b9250508190555080603660008282546106a99190610d68565b90915550506001600160a01b0383166000908152603a6020526040812080548392906106d6908490610d7b565b9091555050505050565b60006001600160a01b0382166107475760405162461bcd60e51b815260206004820152602660248201527f5374616b654d616e616765724368696c64446174613a20494e56414c49445f4160448201526544445245535360d01b6064820152608401610298565b5060018054810190819055600081815260026020908152604080832080546001600160a01b039096166001600160a01b031990961686179055938252600390529190912081905590565b61079b83826109f0565b606d546107b2906001600160a01b03168383610a21565b816001600160a01b0316836001600160a01b03167fb7c918e0e249f999e965cafeb6c664271b3f4317d296461500e71da39f0cbda38360405161021391815260200190565b6040516001600160a01b03808516602483015283166044820152606481018290526108629085906323b872dd60e01b906084015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b031990931692909217909152610a56565b50505050565b6001600160a01b03831660009081526037602090815260408083208584529091528120805483929061089b908490610d7b565b9091555050600082815260386020526040812080548392906108be908490610d7b565b90915550506001600160a01b038316600090815260396020526040812080548392906108eb908490610d7b565b9250508190555080603660008282546106d69190610d7b565b6000818152600260205260409020546001600160a01b0316806109735760405162461bcd60e51b815260206004820152602160248201527f5374616b654d616e616765724368696c64446174613a20494e56414c49445f496044820152601160fa1b6064820152608401610298565b919050565b6001600160a01b038116600090815260036020526040812054908190036109735760405162461bcd60e51b815260206004820152602660248201527f5374616b654d616e616765724368696c64446174613a20494e56414c49445f4d60448201526520a720a3a2a960d11b6064820152608401610298565b6001600160a01b0382166000908152603a602052604081208054839290610a18908490610d68565b90915550505050565b6040516001600160a01b038316602482015260448101829052610a5190849063a9059cbb60e01b9060640161082b565b505050565b6000610aab826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316610b2b9092919063ffffffff16565b9050805160001480610acc575080806020019051810190610acc9190610d8e565b610a515760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610298565b6060610b3a8484600085610b42565b949350505050565b606082471015610ba35760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610298565b600080866001600160a01b03168587604051610bbf9190610dd4565b60006040518083038185875af1925050503d8060008114610bfc576040519150601f19603f3d011682016040523d82523d6000602084013e610c01565b606091505b5091509150610c1287838387610c1d565b979650505050505050565b60608315610c8c578251600003610c85576001600160a01b0385163b610c855760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610298565b5081610b3a565b610b3a8383815115610ca15781518083602001fd5b8060405162461bcd60e51b81526004016102989190610df0565b80356001600160a01b038116811461097357600080fd5b60008060408385031215610ce557600080fd5b610cee83610cbb565b946020939093013593505050565b600060208284031215610d0e57600080fd5b5035919050565b600060208284031215610d2757600080fd5b6105fb82610cbb565b60008060408385031215610d4357600080fd5b50508035926020909101359150565b634e487b7160e01b600052601160045260246000fd5b8181038181111561023057610230610d52565b8082018082111561023057610230610d52565b600060208284031215610da057600080fd5b815180151581146105fb57600080fd5b60005b83811015610dcb578181015183820152602001610db3565b50506000910152565b60008251610de6818460208701610db0565b9190910192915050565b6020815260008251806020840152610e0f816040850160208701610db0565b601f01601f1916919091016040019291505056fea26469706673582212207f5dfe1cb46bc115076fa23b9ffb2421ed989feee340cc0546c7e357469d57e864736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var RewardPoolArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"RewardPool","sourceName":"contracts/child/validator/RewardPool.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"epochId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"totalReward","type":"uint256"}],"name":"RewardDistributed","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseReward","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"epochId","type":"uint256"},{"components":[{"internalType":"address","name":"validator","type":"address"},{"internalType":"uint256","name":"signedBlocks","type":"uint256"}],"internalType":"struct Uptime[]","name":"uptime","type":"tuple[]"}],"name":"distributeRewardFor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newRewardToken","type":"address"},{"internalType":"address","name":"newRewardWallet","type":"address"},{"internalType":"address","name":"newValidatorSet","type":"address"},{"internalType":"uint256","name":"newBaseReward","type":"uint256"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"paidRewardPerEpoch","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"pendingRewards","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rewardToken","outputs":[{"internalType":"contract IERC20Upgradeable","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"rewardWallet","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"validatorSet","outputs":[{"internalType":"contract IValidatorSet","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"withdrawReward","outputs":[],"stateMutability":"nonpayable","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b50610ee1806100206000396000f3fe608060405234801561001057600080fd5b50600436106101165760003560e01c80638a9cd82d116100a2578063c885bc5811610071578063c885bc581461020f578063cf756fdf14610217578063e0563ab11461022a578063f7c618c114610233578063fb75b2c71461024c57600080fd5b80638a9cd82d146101d45780639426e226146101e9578063947287cf146101fc57806397e5230d1461020557600080fd5b80633b878c22116100e95780633b878c221461019d57806351351d53146101a657806355b01e4d146101b45780635ea5df79146101c257806376ad03bc146101cb57600080fd5b806307358b991461011b57806307b3e2521461014e578063284017f51461017457806331d7a2621461017d575b600080fd5b61013b610129366004610be0565b60366020526000908152604090205481565b6040519081526020015b60405180910390f35b61015c6004600360981b0181565b6040516001600160a01b039091168152602001610145565b61015c61202081565b61013b61018b366004610c15565b60376020526000908152604090205481565b61015c61101081565b61015c6002600160a01b0381565b61015c6004600160991b0181565b61013b61138881565b61013b60355481565b6101e76101e2366004610c37565b61025f565b005b60345461015c906001600160a01b031681565b61013b61520881565b61013b620249f081565b6101e76106a9565b6101e7610225366004610cb6565b6106df565b61015c61203081565b60325461015c906201000090046001600160a01b031681565b60335461015c906001600160a01b031681565b336002600160a01b03146102a85760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b600083815260366020526040902054156103045760405162461bcd60e51b815260206004820152601a60248201527f5245574152445f414c52454144595f4449535452494255544544000000000000604482015260640161029f565b603454604051633f490b0560e21b8152600481018590526000916001600160a01b03169063fd242c1490602401602060405180830381865afa15801561034e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103729190610d01565b9050806000036103ba5760405162461bcd60e51b8152602060048201526013602482015272115413d0d217d393d517d0d3d3535255151151606a1b604482015260640161029f565b60345460408051636265600360e01b815290516000926001600160a01b03169163626560039160048083019260209291908290030181865afa158015610404573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104289190610d01565b90506000818360355461043b9190610d30565b6104459190610d4d565b603454604051630981b24d60e41b8152600481018990529192506000916001600160a01b039091169063981b24d090602401602060405180830381865afa158015610494573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104b89190610d01565b9050846000805b828110156106495760008989838181106104db576104db610d6f565b9050604002018036038101906104f19190610d85565b905087816020015111156105475760405162461bcd60e51b815260206004820152601b60248201527f5349474e45445f424c4f434b535f455843454544535f544f54414c0000000000604482015260640161029f565b603454815160405163277166bf60e11b81526001600160a01b039182166004820152602481018e90526000929190911690634ee2cd7e90604401602060405180830381865afa15801561059e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105c29190610d01565b905060006105d08a88610d30565b60208401516105df848b610d30565b6105e99190610d30565b6105f39190610d4d565b83516001600160a01b0316600090815260376020526040812080549293508392909190610621908490610dea565b9091555061063190508186610dea565b9450505050808061064190610dfd565b9150506104bf565b506000898152603660205260409020819055610664816108b1565b887feaf3d57629d9b1ce95715ccd98d6f5bf48023be1d5a06e09f64ab7f6d8be01d58260405161069691815260200190565b60405180910390a2505050505050505050565b336000818152603760205260408120805491905560325490916106dc916201000090046001600160a01b031690836108d5565b50565b603254610100900460ff16158080156106ff5750603254600160ff909116105b806107195750303b158015610719575060325460ff166001145b61077c5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161029f565b6032805460ff19166001179055801561079f576032805461ff0019166101001790555b6001600160a01b038516158015906107bf57506001600160a01b03841615155b80156107d357506001600160a01b03831615155b61080e5760405162461bcd60e51b815260206004820152600c60248201526b5a45524f5f4144445245535360a01b604482015260640161029f565b603280546001600160a01b03808816620100000262010000600160b01b031990921691909117909155603380548683166001600160a01b0319918216179091556034805492861692909116919091179055603582905580156108aa576032805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6033546032546106dc916001600160a01b036201000090920482169116308461093d565b6040516001600160a01b03831660248201526044810182905261093890849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261097b565b505050565b6040516001600160a01b03808516602483015283166044820152606481018290526109759085906323b872dd60e01b90608401610901565b50505050565b60006109d0826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316610a509092919063ffffffff16565b90508051600014806109f15750808060200190518101906109f19190610e16565b6109385760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b606482015260840161029f565b6060610a5f8484600085610a67565b949350505050565b606082471015610ac85760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b606482015260840161029f565b600080866001600160a01b03168587604051610ae49190610e5c565b60006040518083038185875af1925050503d8060008114610b21576040519150601f19603f3d011682016040523d82523d6000602084013e610b26565b606091505b5091509150610b3787838387610b42565b979650505050505050565b60608315610bb1578251600003610baa576001600160a01b0385163b610baa5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161029f565b5081610a5f565b610a5f8383815115610bc65781518083602001fd5b8060405162461bcd60e51b815260040161029f9190610e78565b600060208284031215610bf257600080fd5b5035919050565b80356001600160a01b0381168114610c1057600080fd5b919050565b600060208284031215610c2757600080fd5b610c3082610bf9565b9392505050565b600080600060408486031215610c4c57600080fd5b83359250602084013567ffffffffffffffff80821115610c6b57600080fd5b818601915086601f830112610c7f57600080fd5b813581811115610c8e57600080fd5b8760208260061b8501011115610ca357600080fd5b6020830194508093505050509250925092565b60008060008060808587031215610ccc57600080fd5b610cd585610bf9565b9350610ce360208601610bf9565b9250610cf160408601610bf9565b9396929550929360600135925050565b600060208284031215610d1357600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b8082028115828204841417610d4757610d47610d1a565b92915050565b600082610d6a57634e487b7160e01b600052601260045260246000fd5b500490565b634e487b7160e01b600052603260045260246000fd5b600060408284031215610d9757600080fd5b6040516040810181811067ffffffffffffffff82111715610dc857634e487b7160e01b600052604160045260246000fd5b604052610dd483610bf9565b8152602083013560208201528091505092915050565b80820180821115610d4757610d47610d1a565b600060018201610e0f57610e0f610d1a565b5060010190565b600060208284031215610e2857600080fd5b81518015158114610c3057600080fd5b60005b83811015610e53578181015183820152602001610e3b565b50506000910152565b60008251610e6e818460208701610e38565b9190910192915050565b6020815260008251806020840152610e97816040850160208701610e38565b601f01601f1916919091016040019291505056fea26469706673582212200c9fa9211b5f5937d8516e90589d94c68470826588820f396136e3f3ed465c6c64736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106101165760003560e01c80638a9cd82d116100a2578063c885bc5811610071578063c885bc581461020f578063cf756fdf14610217578063e0563ab11461022a578063f7c618c114610233578063fb75b2c71461024c57600080fd5b80638a9cd82d146101d45780639426e226146101e9578063947287cf146101fc57806397e5230d1461020557600080fd5b80633b878c22116100e95780633b878c221461019d57806351351d53146101a657806355b01e4d146101b45780635ea5df79146101c257806376ad03bc146101cb57600080fd5b806307358b991461011b57806307b3e2521461014e578063284017f51461017457806331d7a2621461017d575b600080fd5b61013b610129366004610be0565b60366020526000908152604090205481565b6040519081526020015b60405180910390f35b61015c6004600360981b0181565b6040516001600160a01b039091168152602001610145565b61015c61202081565b61013b61018b366004610c15565b60376020526000908152604090205481565b61015c61101081565b61015c6002600160a01b0381565b61015c6004600160991b0181565b61013b61138881565b61013b60355481565b6101e76101e2366004610c37565b61025f565b005b60345461015c906001600160a01b031681565b61013b61520881565b61013b620249f081565b6101e76106a9565b6101e7610225366004610cb6565b6106df565b61015c61203081565b60325461015c906201000090046001600160a01b031681565b60335461015c906001600160a01b031681565b336002600160a01b03146102a85760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b600083815260366020526040902054156103045760405162461bcd60e51b815260206004820152601a60248201527f5245574152445f414c52454144595f4449535452494255544544000000000000604482015260640161029f565b603454604051633f490b0560e21b8152600481018590526000916001600160a01b03169063fd242c1490602401602060405180830381865afa15801561034e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103729190610d01565b9050806000036103ba5760405162461bcd60e51b8152602060048201526013602482015272115413d0d217d393d517d0d3d3535255151151606a1b604482015260640161029f565b60345460408051636265600360e01b815290516000926001600160a01b03169163626560039160048083019260209291908290030181865afa158015610404573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104289190610d01565b90506000818360355461043b9190610d30565b6104459190610d4d565b603454604051630981b24d60e41b8152600481018990529192506000916001600160a01b039091169063981b24d090602401602060405180830381865afa158015610494573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104b89190610d01565b9050846000805b828110156106495760008989838181106104db576104db610d6f565b9050604002018036038101906104f19190610d85565b905087816020015111156105475760405162461bcd60e51b815260206004820152601b60248201527f5349474e45445f424c4f434b535f455843454544535f544f54414c0000000000604482015260640161029f565b603454815160405163277166bf60e11b81526001600160a01b039182166004820152602481018e90526000929190911690634ee2cd7e90604401602060405180830381865afa15801561059e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105c29190610d01565b905060006105d08a88610d30565b60208401516105df848b610d30565b6105e99190610d30565b6105f39190610d4d565b83516001600160a01b0316600090815260376020526040812080549293508392909190610621908490610dea565b9091555061063190508186610dea565b9450505050808061064190610dfd565b9150506104bf565b506000898152603660205260409020819055610664816108b1565b887feaf3d57629d9b1ce95715ccd98d6f5bf48023be1d5a06e09f64ab7f6d8be01d58260405161069691815260200190565b60405180910390a2505050505050505050565b336000818152603760205260408120805491905560325490916106dc916201000090046001600160a01b031690836108d5565b50565b603254610100900460ff16158080156106ff5750603254600160ff909116105b806107195750303b158015610719575060325460ff166001145b61077c5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161029f565b6032805460ff19166001179055801561079f576032805461ff0019166101001790555b6001600160a01b038516158015906107bf57506001600160a01b03841615155b80156107d357506001600160a01b03831615155b61080e5760405162461bcd60e51b815260206004820152600c60248201526b5a45524f5f4144445245535360a01b604482015260640161029f565b603280546001600160a01b03808816620100000262010000600160b01b031990921691909117909155603380548683166001600160a01b0319918216179091556034805492861692909116919091179055603582905580156108aa576032805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b6033546032546106dc916001600160a01b036201000090920482169116308461093d565b6040516001600160a01b03831660248201526044810182905261093890849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261097b565b505050565b6040516001600160a01b03808516602483015283166044820152606481018290526109759085906323b872dd60e01b90608401610901565b50505050565b60006109d0826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b0316610a509092919063ffffffff16565b90508051600014806109f15750808060200190518101906109f19190610e16565b6109385760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b606482015260840161029f565b6060610a5f8484600085610a67565b949350505050565b606082471015610ac85760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b606482015260840161029f565b600080866001600160a01b03168587604051610ae49190610e5c565b60006040518083038185875af1925050503d8060008114610b21576040519150601f19603f3d011682016040523d82523d6000602084013e610b26565b606091505b5091509150610b3787838387610b42565b979650505050505050565b60608315610bb1578251600003610baa576001600160a01b0385163b610baa5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161029f565b5081610a5f565b610a5f8383815115610bc65781518083602001fd5b8060405162461bcd60e51b815260040161029f9190610e78565b600060208284031215610bf257600080fd5b5035919050565b80356001600160a01b0381168114610c1057600080fd5b919050565b600060208284031215610c2757600080fd5b610c3082610bf9565b9392505050565b600080600060408486031215610c4c57600080fd5b83359250602084013567ffffffffffffffff80821115610c6b57600080fd5b818601915086601f830112610c7f57600080fd5b813581811115610c8e57600080fd5b8760208260061b8501011115610ca357600080fd5b6020830194508093505050509250925092565b60008060008060808587031215610ccc57600080fd5b610cd585610bf9565b9350610ce360208601610bf9565b9250610cf160408601610bf9565b9396929550929360600135925050565b600060208284031215610d1357600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b8082028115828204841417610d4757610d47610d1a565b92915050565b600082610d6a57634e487b7160e01b600052601260045260246000fd5b500490565b634e487b7160e01b600052603260045260246000fd5b600060408284031215610d9757600080fd5b6040516040810181811067ffffffffffffffff82111715610dc857634e487b7160e01b600052604160045260246000fd5b604052610dd483610bf9565b8152602083013560208201528091505092915050565b80820180821115610d4757610d47610d1a565b600060018201610e0f57610e0f610d1a565b5060010190565b600060208284031215610e2857600080fd5b81518015158114610c3057600080fd5b60005b83811015610e53578181015183820152602001610e3b565b50506000910152565b60008251610e6e818460208701610e38565b9190910192915050565b6020815260008251806020840152610e97816040850160208701610e38565b601f01601f1916919091016040019291505056fea26469706673582212200c9fa9211b5f5937d8516e90589d94c68470826588820f396136e3f3ed465c6c64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var ValidatorSetArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"ValidatorSet","sourceName":"contracts/child/validator/ValidatorSet.sol","abi":[{"inputs":[{"internalType":"string","name":"only","type":"string"}],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"startBlock","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"endBlock","type":"uint256"},{"indexed":false,"internalType":"bytes32","name":"epochRoot","type":"bytes32"}],"name":"NewEpoch","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"}],"name":"Snapshot","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Withdrawal","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"WithdrawalRegistered","type":"event"},{"inputs":[],"name":"ALLOWLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLOCKLIST_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"EPOCH_SIZE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN_CONTRACT","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TRANSFER_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"READ_ADDRESSLIST_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SYSTEM","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"VALIDATOR_PKCHECK_PRECOMPILE_GAS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WITHDRAWAL_WAIT_PERIOD","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"epochNumber","type":"uint256"}],"name":"balanceOfAt","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"},{"components":[{"internalType":"uint256","name":"startBlock","type":"uint256"},{"internalType":"uint256","name":"endBlock","type":"uint256"},{"internalType":"bytes32","name":"epochRoot","type":"bytes32"}],"internalType":"struct Epoch","name":"epoch","type":"tuple"}],"name":"commitEpoch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"currentEpochId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"subtractedValue","type":"uint256"}],"name":"decreaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"epochEndBlocks","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"epochs","outputs":[{"internalType":"uint256","name":"startBlock","type":"uint256"},{"internalType":"uint256","name":"endBlock","type":"uint256"},{"internalType":"bytes32","name":"epochRoot","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"addedValue","type":"uint256"}],"name":"increaseAllowance","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newStateSender","type":"address"},{"internalType":"address","name":"newStateReceiver","type":"address"},{"internalType":"address","name":"newRootChainManager","type":"address"},{"internalType":"uint256","name":"newEpochSize","type":"uint256"},{"components":[{"internalType":"address","name":"addr","type":"address"},{"internalType":"uint256","name":"stake","type":"uint256"}],"internalType":"struct ValidatorInit[]","name":"initialValidators","type":"tuple[]"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"sender","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"onStateReceive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"pendingWithdrawals","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"epochId","type":"uint256"}],"name":"totalBlocks","outputs":[{"internalType":"uint256","name":"length","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"epochNumber","type":"uint256"}],"name":"totalSupplyAt","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"unstake","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"withdrawable","outputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"}],"bytecode":"0x608060405234801561001057600080fd5b5061215c806100206000396000f3fe608060405234801561001057600080fd5b50600436106102015760003560e01c806361cc276311610125578063c6b61e4c116100ad578063ea0fee4f1161007c578063ea0fee4f1461043d578063eacdc5ff14610445578063eeb499451461044e578063f3f4370314610461578063fd242c141461047457600080fd5b8063c6b61e4c146103c4578063ce513b6f1461040e578063dd62ed3e14610421578063e0563ab11461043457600080fd5b806395d89b41116100f457806395d89b411461037957806397e5230d14610381578063981b24d01461038b578063a457c2d71461039e578063a9059cbb146103b157600080fd5b806361cc276314610341578063626560031461035457806370a082311461035d578063947287cf1461037057600080fd5b8063313ce567116101a85780633fd50001116101775780633fd50001146102f65780634ee2cd7e1461030957806351351d531461031c57806355b01e4d1461032a5780635ea5df791461033857600080fd5b8063313ce567146102c357806339509351146102d25780633b878c22146102e55780633ccfd60b146102ee57600080fd5b806306fdde031461020657806307b3e25214610224578063095ea7b31461024a5780630f50287c1461026d57806318160ddd1461028257806323b872dd14610294578063284017f5146102a75780632e17de78146102b0575b600080fd5b61020e610487565b60405161021b9190611aeb565b60405180910390f35b6102326004600360981b0181565b6040516001600160a01b03909116815260200161021b565b61025d610258366004611b13565b610519565b604051901515815260200161021b565b61028061027b366004611b3f565b610533565b005b6035545b60405190815260200161021b565b61025d6102a2366004611b77565b6107c5565b61023261202081565b6102806102be366004611bb8565b6107e9565b6040516012815260200161021b565b61025d6102e0366004611b13565b610800565b61023261101081565b610280610822565b610286610304366004611bb8565b610933565b610286610317366004611b13565b610954565b6102326002600160a01b0381565b6102326004600160991b0181565b61028661138881565b61028061034f366004611c41565b610967565b61028660cc5481565b61028661036b366004611d5a565b610c05565b61028661520881565b61020e610c20565b610286620249f081565b610286610399366004611bb8565b610c2f565b61025d6103ac366004611b13565b610c3a565b61025d6103bf366004611b13565b610cb5565b6103f36103d2366004611bb8565b60ce6020526000908152604090208054600182015460029092015490919083565b6040805193845260208401929092529082015260600161021b565b61028661041c366004611d5a565b610cc3565b61028661042f366004611d77565b610cf1565b61023261203081565b610286600181565b61028660cd5481565b61028061045c366004611db0565b610d1c565b61028661046f366004611d5a565b610dee565b610286610482366004611bb8565b610e15565b60606036805461049690611e39565b80601f01602080910402602001604051908101604052809291908181526020018280546104c290611e39565b801561050f5780601f106104e45761010080835404028352916020019161050f565b820191906000526020600020905b8154815290600101906020018083116104f257829003601f168201915b5050505050905090565b600033610527818585610e5f565b60019150505b92915050565b336002600160a01b031461057c5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b60cd80546000918261058d83611e89565b9190505590508083146105d85760405162461bcd60e51b815260206004820152601360248201527215539156141150d5115117d15413d0d217d251606a1b6044820152606401610573565b81356020830135116106225760405162461bcd60e51b81526020600482015260136024820152721393d7d09313d0d2d4d7d0d3d3535255151151606a1b6044820152606401610573565b60cc5461063483356020850135611ea2565b61063f906001611eb5565b6106499190611ede565b156106a45760405162461bcd60e51b815260206004820152602560248201527f45504f43485f4d5553545f42455f444956495349424c455f42595f45504f43486044820152645f53495a4560d81b6064820152608401610573565b813560ce60006106b5600185611ea2565b81526020019081526020016000206001015460016106d39190611eb5565b146107165760405162461bcd60e51b8152602060048201526013602482015272494e56414c49445f53544152545f424c4f434b60681b6044820152606401610573565b600081815260ce60205260409020829061074782828135815560208201356001820155604082013560028201555050565b505060cf80546001810182556000919091526020838101357facb8d954e2cfef495862221e91bd7523613cf8808827cb33edfe4904cc51bf299092018290556040805190850135815284359186917f0ce8712c4dee4bd5a691f0bc1c39594671591e77395f8ebf6a3fb5f63fbea66a910160405180910390a4505050565b6000336107d3858285610f84565b6107de858585610ff8565b506001949350505050565b6107f3338261119c565b6107fd33826112c7565b50565b6000336105278185856108138383610cf1565b61081d9190611eb5565b610e5f565b33600090815260d06020526040812060cd549091908190610844908490611340565b808555604051828152919350915033907f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b659060200160405180910390a260c95460cb54604080517f8ca9a95e41b5eece253c93f5b31eed1253aed6b145d8a6e14d913fdf8e7322936020820152338183015260608082018790528251808303909101815260808201928390526316f1983160e01b9092526001600160a01b03938416936316f19831936108fc93911691608401611ef2565b600060405180830381600087803b15801561091657600080fd5b505af115801561092a573d6000803e3d6000fd5b50505050505050565b60cf818154811061094357600080fd5b600091825260209091200154905081565b600061096083836113b2565b9392505050565b600054610100900460ff16158080156109875750600054600160ff909116105b806109a15750303b1580156109a1575060005460ff166001145b610a045760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610573565b6000805460ff191660011790558015610a27576000805461ff0019166101001790555b6001600160a01b03861615801590610a4757506001600160a01b03851615155b8015610a5b57506001600160a01b03841615155b610a975760405162461bcd60e51b815260206004820152600d60248201526c1253959053125117d253941555609a1b6044820152606401610573565b610ae16040518060400160405280600c81526020016b15985b1a59185d1bdc94d95d60a21b815250604051806040016040528060048152602001631594d15560e21b8152506113fb565b60c980546001600160a01b038089166001600160a01b03199283161790925560ca805488841690831617905560cb80549287169290911691909117905560cc83905560005b8251811015610b7b57610b73838281518110610b4457610b44611f16565b602002602001015160000151848381518110610b6257610b62611f16565b602002602001015160200151611430565b600101610b26565b5060cf80546001818101835560009283527facb8d954e2cfef495862221e91bd7523613cf8808827cb33edfe4904cc51bf299091019190915560cd558015610bfd576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b6001600160a01b031660009081526033602052604090205490565b60606037805461049690611e39565b600061052d8261143a565b60003381610c488286610cf1565b905083811015610ca85760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610573565b6107de8286868403610e5f565b600033610527818585610ff8565b60cd546001600160a01b038216600090815260d0602052604081209091610cea9190611340565b5092915050565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b60ca546001600160a01b031633148015610d43575060cb546001600160a01b038481169116145b610d805760405162461bcd60e51b815260206004820152600e60248201526d24a72b20a624a22fa9a2a72222a960911b6044820152606401610573565b7f1bcc0f4c3fad314e585165815f94ecca9b96690a26d6417d7876448a9a867a69610daf602060008486611f2c565b610db891611f56565b03610de857600080610dcd8360208187611f2c565b810190610dda9190611b13565b91509150610bfd8282611430565b50505050565b60cd546001600160a01b038216600090815260d060205260408120909161052d9190611465565b600081815260ce60205260408120600101548015610e5657600083815260ce6020526040902054610e469082611ea2565b610e51906001611eb5565b610960565b60009392505050565b6001600160a01b038316610ec15760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610573565b6001600160a01b038216610f225760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610573565b6001600160a01b0383811660008181526034602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6000610f908484610cf1565b90506000198114610de85781811015610feb5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610573565b610de88484848403610e5f565b6001600160a01b03831661105c5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610573565b6001600160a01b0382166110be5760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610573565b6110c9838383611503565b6001600160a01b038316600090815260336020526040902054818110156111415760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610573565b6001600160a01b0380851660008181526033602052604080822086860390559286168082529083902080548601905591516000805160206121078339815191529061118f9086815260200190565b60405180910390a3610de8565b6001600160a01b0382166111fc5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610573565b61120882600083611503565b6001600160a01b0382166000908152603360205260409020548181101561127c5760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610573565b6001600160a01b03831660008181526033602090815260408083208686039055603580548790039055518581529192916000805160206121078339815191529101610f77565b505050565b6112f981600160cd546112da9190611eb5565b6001600160a01b038516600090815260d060205260409020919061156c565b816001600160a01b03167f655c1cd0236fb6dc4916f34c8ff10e3b18fcaea5b344dfc16c36fbb1bdfc5df28260405161133491815260200190565b60405180910390a25050565b81546000905b83600101548110156113ab5760008181526002850160209081526040918290208251808401909352805483526001015490820181905284101561138957506113ab565b80516113959084611eb5565b92505080806113a390611e89565b915050611346565b9250929050565b6001600160a01b0382166000908152606560205260408120819081906113d99085906116e2565b91509150816113f0576113eb85610c05565b6113f2565b805b95945050505050565b600054610100900460ff166114225760405162461bcd60e51b815260040161057390611f74565b61142c82826117d0565b5050565b61142c8282611810565b600080600061144a8460666116e2565b915091508161145b5760355461145d565b805b949350505050565b600182015460009080820361147e57600091505061052d565b600061148b600183611ea2565b90505b845481106114fb5760008181526002860160209081526040918290208251808401909352805483526001015490820181905285106114cc57506114fb565b80516114d89085611eb5565b9350816000036114e857506114fb565b50806114f381611fbf565b91505061148e565b505092915050565b6001600160a01b038316158061152057506001600160a01b038216155b6115615760405162461bcd60e51b81526020600482015260126024820152712a2920a729a322a92fa327a92124a22222a760711b6044820152606401610573565b6112c28383836118cb565b816000036115c75760405162461bcd60e51b815260206004820152602260248201527f5769746864726177616c51756575654c69623a20494e56414c49445f414d4f55604482015261139560f21b6064820152608401610573565b8254600184015481810361161e576040805180820182528581526020808201868152600085815260028a01909252928120915182559151600191820155860180549161161283611e89565b91905055505050505050565b60006002860181611630600185611ea2565b81526020019081526020016000206001015490508084101561165457611654611fd6565b838110156116a3576040805180820182528681526020808201878152600086815260028b01909252928120915182559151600191820155870180549161169983611e89565b9190505550610bfd565b846002870160006116b5600186611ea2565b815260200190815260200160002060000160008282546116d59190611eb5565b9091555050505050505050565b6000806000841161172e5760405162461bcd60e51b815260206004820152601660248201527504552433230536e617073686f743a20696420697320360541b6044820152606401610573565b60cd548411156117805760405162461bcd60e51b815260206004820152601d60248201527f4552433230536e617073686f743a206e6f6e6578697374656e742069640000006044820152606401610573565b600061178c8486611913565b845490915081036117a45760008092509250506113ab565b60018460010182815481106117bb576117bb611f16565b906000526020600020015492509250506113ab565b600054610100900460ff166117f75760405162461bcd60e51b815260040161057390611f74565b60366118038382612032565b5060376112c28282612032565b6001600160a01b0382166118665760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610573565b61187260008383611503565b80603560008282546118849190611eb5565b90915550506001600160a01b038216600081815260336020908152604080832080548601905551848152600080516020612107833981519152910160405180910390a35050565b6001600160a01b0383166118ea576118e2826119c0565b6112c26119ea565b6001600160a01b038216611901576118e2836119c0565b61190a836119c0565b6112c2826119c0565b815460009081036119265750600061052d565b82546000905b8082101561197357600061194083836119fa565b6000878152602090209091508590820154111561195f5780915061196d565b61196a816001611eb5565b92505b5061192c565b60008211801561199f57508361199c8661198e600186611ea2565b600091825260209091200190565b54145b156119b8576119af600183611ea2565b9250505061052d565b50905061052d565b6001600160a01b03811660009081526065602052604090206107fd906119e583610c05565b611a15565b6119f860666119e560355490565b565b6000611a0960028484186120f2565b61096090848416611eb5565b6000611a2060cd5490565b905080611a2c84611a60565b10156112c2578254600180820185556000858152602080822090930193909355938401805494850181558252902090910155565b80546000908103611a7357506000919050565b81548290611a8390600190611ea2565b81548110611a9357611a93611f16565b90600052602060002001549050919050565b6000815180845260005b81811015611acb57602081850181015186830182015201611aaf565b506000602082860101526020601f19601f83011685010191505092915050565b6020815260006109606020830184611aa5565b6001600160a01b03811681146107fd57600080fd5b60008060408385031215611b2657600080fd5b8235611b3181611afe565b946020939093013593505050565b6000808284036080811215611b5357600080fd5b833592506060601f1982011215611b6957600080fd5b506020830190509250929050565b600080600060608486031215611b8c57600080fd5b8335611b9781611afe565b92506020840135611ba781611afe565b929592945050506040919091013590565b600060208284031215611bca57600080fd5b5035919050565b634e487b7160e01b600052604160045260246000fd5b6040805190810167ffffffffffffffff81118282101715611c0a57611c0a611bd1565b60405290565b604051601f8201601f1916810167ffffffffffffffff81118282101715611c3957611c39611bd1565b604052919050565b600080600080600060a08688031215611c5957600080fd5b8535611c6481611afe565b9450602086810135611c7581611afe565b9450604087810135611c8681611afe565b945060608801359350608088013567ffffffffffffffff80821115611caa57600080fd5b818a0191508a601f830112611cbe57600080fd5b813581811115611cd057611cd0611bd1565b611cde858260051b01611c10565b818152858101925060069190911b83018501908c821115611cfe57600080fd5b928501925b81841015611d475784848e031215611d1b5760008081fd5b611d23611be7565b8435611d2e81611afe565b8152848701358782015283529284019291850191611d03565b8096505050505050509295509295909350565b600060208284031215611d6c57600080fd5b813561096081611afe565b60008060408385031215611d8a57600080fd5b8235611d9581611afe565b91506020830135611da581611afe565b809150509250929050565b60008060008060608587031215611dc657600080fd5b843593506020850135611dd881611afe565b9250604085013567ffffffffffffffff80821115611df557600080fd5b818701915087601f830112611e0957600080fd5b813581811115611e1857600080fd5b886020828501011115611e2a57600080fd5b95989497505060200194505050565b600181811c90821680611e4d57607f821691505b602082108103611e6d57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b600060018201611e9b57611e9b611e73565b5060010190565b8181038181111561052d5761052d611e73565b8082018082111561052d5761052d611e73565b634e487b7160e01b600052601260045260246000fd5b600082611eed57611eed611ec8565b500690565b6001600160a01b038316815260406020820181905260009061145d90830184611aa5565b634e487b7160e01b600052603260045260246000fd5b60008085851115611f3c57600080fd5b83861115611f4957600080fd5b5050820193919092039150565b8035602083101561052d57600019602084900360031b1b1692915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b600081611fce57611fce611e73565b506000190190565b634e487b7160e01b600052600160045260246000fd5b601f8211156112c257600081815260208120601f850160051c810160208610156120135750805b601f850160051c820191505b81811015610bfd5782815560010161201f565b815167ffffffffffffffff81111561204c5761204c611bd1565b6120608161205a8454611e39565b84611fec565b602080601f831160018114612095576000841561207d5750858301515b600019600386901b1c1916600185901b178555610bfd565b600085815260208120601f198616915b828110156120c4578886015182559484019460019091019084016120a5565b50858210156120e25787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b60008261210157612101611ec8565b50049056feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220a7f49f3b74e4ac0e9fc814278d95b8601a69f04a86da95d921d3e639218e2b7264736f6c63430008130033","deployedBytecode":"0x608060405234801561001057600080fd5b50600436106102015760003560e01c806361cc276311610125578063c6b61e4c116100ad578063ea0fee4f1161007c578063ea0fee4f1461043d578063eacdc5ff14610445578063eeb499451461044e578063f3f4370314610461578063fd242c141461047457600080fd5b8063c6b61e4c146103c4578063ce513b6f1461040e578063dd62ed3e14610421578063e0563ab11461043457600080fd5b806395d89b41116100f457806395d89b411461037957806397e5230d14610381578063981b24d01461038b578063a457c2d71461039e578063a9059cbb146103b157600080fd5b806361cc276314610341578063626560031461035457806370a082311461035d578063947287cf1461037057600080fd5b8063313ce567116101a85780633fd50001116101775780633fd50001146102f65780634ee2cd7e1461030957806351351d531461031c57806355b01e4d1461032a5780635ea5df791461033857600080fd5b8063313ce567146102c357806339509351146102d25780633b878c22146102e55780633ccfd60b146102ee57600080fd5b806306fdde031461020657806307b3e25214610224578063095ea7b31461024a5780630f50287c1461026d57806318160ddd1461028257806323b872dd14610294578063284017f5146102a75780632e17de78146102b0575b600080fd5b61020e610487565b60405161021b9190611aeb565b60405180910390f35b6102326004600360981b0181565b6040516001600160a01b03909116815260200161021b565b61025d610258366004611b13565b610519565b604051901515815260200161021b565b61028061027b366004611b3f565b610533565b005b6035545b60405190815260200161021b565b61025d6102a2366004611b77565b6107c5565b61023261202081565b6102806102be366004611bb8565b6107e9565b6040516012815260200161021b565b61025d6102e0366004611b13565b610800565b61023261101081565b610280610822565b610286610304366004611bb8565b610933565b610286610317366004611b13565b610954565b6102326002600160a01b0381565b6102326004600160991b0181565b61028661138881565b61028061034f366004611c41565b610967565b61028660cc5481565b61028661036b366004611d5a565b610c05565b61028661520881565b61020e610c20565b610286620249f081565b610286610399366004611bb8565b610c2f565b61025d6103ac366004611b13565b610c3a565b61025d6103bf366004611b13565b610cb5565b6103f36103d2366004611bb8565b60ce6020526000908152604090208054600182015460029092015490919083565b6040805193845260208401929092529082015260600161021b565b61028661041c366004611d5a565b610cc3565b61028661042f366004611d77565b610cf1565b61023261203081565b610286600181565b61028660cd5481565b61028061045c366004611db0565b610d1c565b61028661046f366004611d5a565b610dee565b610286610482366004611bb8565b610e15565b60606036805461049690611e39565b80601f01602080910402602001604051908101604052809291908181526020018280546104c290611e39565b801561050f5780601f106104e45761010080835404028352916020019161050f565b820191906000526020600020905b8154815290600101906020018083116104f257829003601f168201915b5050505050905090565b600033610527818585610e5f565b60019150505b92915050565b336002600160a01b031461057c5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b60cd80546000918261058d83611e89565b9190505590508083146105d85760405162461bcd60e51b815260206004820152601360248201527215539156141150d5115117d15413d0d217d251606a1b6044820152606401610573565b81356020830135116106225760405162461bcd60e51b81526020600482015260136024820152721393d7d09313d0d2d4d7d0d3d3535255151151606a1b6044820152606401610573565b60cc5461063483356020850135611ea2565b61063f906001611eb5565b6106499190611ede565b156106a45760405162461bcd60e51b815260206004820152602560248201527f45504f43485f4d5553545f42455f444956495349424c455f42595f45504f43486044820152645f53495a4560d81b6064820152608401610573565b813560ce60006106b5600185611ea2565b81526020019081526020016000206001015460016106d39190611eb5565b146107165760405162461bcd60e51b8152602060048201526013602482015272494e56414c49445f53544152545f424c4f434b60681b6044820152606401610573565b600081815260ce60205260409020829061074782828135815560208201356001820155604082013560028201555050565b505060cf80546001810182556000919091526020838101357facb8d954e2cfef495862221e91bd7523613cf8808827cb33edfe4904cc51bf299092018290556040805190850135815284359186917f0ce8712c4dee4bd5a691f0bc1c39594671591e77395f8ebf6a3fb5f63fbea66a910160405180910390a4505050565b6000336107d3858285610f84565b6107de858585610ff8565b506001949350505050565b6107f3338261119c565b6107fd33826112c7565b50565b6000336105278185856108138383610cf1565b61081d9190611eb5565b610e5f565b33600090815260d06020526040812060cd549091908190610844908490611340565b808555604051828152919350915033907f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b659060200160405180910390a260c95460cb54604080517f8ca9a95e41b5eece253c93f5b31eed1253aed6b145d8a6e14d913fdf8e7322936020820152338183015260608082018790528251808303909101815260808201928390526316f1983160e01b9092526001600160a01b03938416936316f19831936108fc93911691608401611ef2565b600060405180830381600087803b15801561091657600080fd5b505af115801561092a573d6000803e3d6000fd5b50505050505050565b60cf818154811061094357600080fd5b600091825260209091200154905081565b600061096083836113b2565b9392505050565b600054610100900460ff16158080156109875750600054600160ff909116105b806109a15750303b1580156109a1575060005460ff166001145b610a045760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610573565b6000805460ff191660011790558015610a27576000805461ff0019166101001790555b6001600160a01b03861615801590610a4757506001600160a01b03851615155b8015610a5b57506001600160a01b03841615155b610a975760405162461bcd60e51b815260206004820152600d60248201526c1253959053125117d253941555609a1b6044820152606401610573565b610ae16040518060400160405280600c81526020016b15985b1a59185d1bdc94d95d60a21b815250604051806040016040528060048152602001631594d15560e21b8152506113fb565b60c980546001600160a01b038089166001600160a01b03199283161790925560ca805488841690831617905560cb80549287169290911691909117905560cc83905560005b8251811015610b7b57610b73838281518110610b4457610b44611f16565b602002602001015160000151848381518110610b6257610b62611f16565b602002602001015160200151611430565b600101610b26565b5060cf80546001818101835560009283527facb8d954e2cfef495862221e91bd7523613cf8808827cb33edfe4904cc51bf299091019190915560cd558015610bfd576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b6001600160a01b031660009081526033602052604090205490565b60606037805461049690611e39565b600061052d8261143a565b60003381610c488286610cf1565b905083811015610ca85760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610573565b6107de8286868403610e5f565b600033610527818585610ff8565b60cd546001600160a01b038216600090815260d0602052604081209091610cea9190611340565b5092915050565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b60ca546001600160a01b031633148015610d43575060cb546001600160a01b038481169116145b610d805760405162461bcd60e51b815260206004820152600e60248201526d24a72b20a624a22fa9a2a72222a960911b6044820152606401610573565b7f1bcc0f4c3fad314e585165815f94ecca9b96690a26d6417d7876448a9a867a69610daf602060008486611f2c565b610db891611f56565b03610de857600080610dcd8360208187611f2c565b810190610dda9190611b13565b91509150610bfd8282611430565b50505050565b60cd546001600160a01b038216600090815260d060205260408120909161052d9190611465565b600081815260ce60205260408120600101548015610e5657600083815260ce6020526040902054610e469082611ea2565b610e51906001611eb5565b610960565b60009392505050565b6001600160a01b038316610ec15760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610573565b6001600160a01b038216610f225760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610573565b6001600160a01b0383811660008181526034602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6000610f908484610cf1565b90506000198114610de85781811015610feb5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610573565b610de88484848403610e5f565b6001600160a01b03831661105c5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610573565b6001600160a01b0382166110be5760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610573565b6110c9838383611503565b6001600160a01b038316600090815260336020526040902054818110156111415760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610573565b6001600160a01b0380851660008181526033602052604080822086860390559286168082529083902080548601905591516000805160206121078339815191529061118f9086815260200190565b60405180910390a3610de8565b6001600160a01b0382166111fc5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610573565b61120882600083611503565b6001600160a01b0382166000908152603360205260409020548181101561127c5760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610573565b6001600160a01b03831660008181526033602090815260408083208686039055603580548790039055518581529192916000805160206121078339815191529101610f77565b505050565b6112f981600160cd546112da9190611eb5565b6001600160a01b038516600090815260d060205260409020919061156c565b816001600160a01b03167f655c1cd0236fb6dc4916f34c8ff10e3b18fcaea5b344dfc16c36fbb1bdfc5df28260405161133491815260200190565b60405180910390a25050565b81546000905b83600101548110156113ab5760008181526002850160209081526040918290208251808401909352805483526001015490820181905284101561138957506113ab565b80516113959084611eb5565b92505080806113a390611e89565b915050611346565b9250929050565b6001600160a01b0382166000908152606560205260408120819081906113d99085906116e2565b91509150816113f0576113eb85610c05565b6113f2565b805b95945050505050565b600054610100900460ff166114225760405162461bcd60e51b815260040161057390611f74565b61142c82826117d0565b5050565b61142c8282611810565b600080600061144a8460666116e2565b915091508161145b5760355461145d565b805b949350505050565b600182015460009080820361147e57600091505061052d565b600061148b600183611ea2565b90505b845481106114fb5760008181526002860160209081526040918290208251808401909352805483526001015490820181905285106114cc57506114fb565b80516114d89085611eb5565b9350816000036114e857506114fb565b50806114f381611fbf565b91505061148e565b505092915050565b6001600160a01b038316158061152057506001600160a01b038216155b6115615760405162461bcd60e51b81526020600482015260126024820152712a2920a729a322a92fa327a92124a22222a760711b6044820152606401610573565b6112c28383836118cb565b816000036115c75760405162461bcd60e51b815260206004820152602260248201527f5769746864726177616c51756575654c69623a20494e56414c49445f414d4f55604482015261139560f21b6064820152608401610573565b8254600184015481810361161e576040805180820182528581526020808201868152600085815260028a01909252928120915182559151600191820155860180549161161283611e89565b91905055505050505050565b60006002860181611630600185611ea2565b81526020019081526020016000206001015490508084101561165457611654611fd6565b838110156116a3576040805180820182528681526020808201878152600086815260028b01909252928120915182559151600191820155870180549161169983611e89565b9190505550610bfd565b846002870160006116b5600186611ea2565b815260200190815260200160002060000160008282546116d59190611eb5565b9091555050505050505050565b6000806000841161172e5760405162461bcd60e51b815260206004820152601660248201527504552433230536e617073686f743a20696420697320360541b6044820152606401610573565b60cd548411156117805760405162461bcd60e51b815260206004820152601d60248201527f4552433230536e617073686f743a206e6f6e6578697374656e742069640000006044820152606401610573565b600061178c8486611913565b845490915081036117a45760008092509250506113ab565b60018460010182815481106117bb576117bb611f16565b906000526020600020015492509250506113ab565b600054610100900460ff166117f75760405162461bcd60e51b815260040161057390611f74565b60366118038382612032565b5060376112c28282612032565b6001600160a01b0382166118665760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610573565b61187260008383611503565b80603560008282546118849190611eb5565b90915550506001600160a01b038216600081815260336020908152604080832080548601905551848152600080516020612107833981519152910160405180910390a35050565b6001600160a01b0383166118ea576118e2826119c0565b6112c26119ea565b6001600160a01b038216611901576118e2836119c0565b61190a836119c0565b6112c2826119c0565b815460009081036119265750600061052d565b82546000905b8082101561197357600061194083836119fa565b6000878152602090209091508590820154111561195f5780915061196d565b61196a816001611eb5565b92505b5061192c565b60008211801561199f57508361199c8661198e600186611ea2565b600091825260209091200190565b54145b156119b8576119af600183611ea2565b9250505061052d565b50905061052d565b6001600160a01b03811660009081526065602052604090206107fd906119e583610c05565b611a15565b6119f860666119e560355490565b565b6000611a0960028484186120f2565b61096090848416611eb5565b6000611a2060cd5490565b905080611a2c84611a60565b10156112c2578254600180820185556000858152602080822090930193909355938401805494850181558252902090910155565b80546000908103611a7357506000919050565b81548290611a8390600190611ea2565b81548110611a9357611a93611f16565b90600052602060002001549050919050565b6000815180845260005b81811015611acb57602081850181015186830182015201611aaf565b506000602082860101526020601f19601f83011685010191505092915050565b6020815260006109606020830184611aa5565b6001600160a01b03811681146107fd57600080fd5b60008060408385031215611b2657600080fd5b8235611b3181611afe565b946020939093013593505050565b6000808284036080811215611b5357600080fd5b833592506060601f1982011215611b6957600080fd5b506020830190509250929050565b600080600060608486031215611b8c57600080fd5b8335611b9781611afe565b92506020840135611ba781611afe565b929592945050506040919091013590565b600060208284031215611bca57600080fd5b5035919050565b634e487b7160e01b600052604160045260246000fd5b6040805190810167ffffffffffffffff81118282101715611c0a57611c0a611bd1565b60405290565b604051601f8201601f1916810167ffffffffffffffff81118282101715611c3957611c39611bd1565b604052919050565b600080600080600060a08688031215611c5957600080fd5b8535611c6481611afe565b9450602086810135611c7581611afe565b9450604087810135611c8681611afe565b945060608801359350608088013567ffffffffffffffff80821115611caa57600080fd5b818a0191508a601f830112611cbe57600080fd5b813581811115611cd057611cd0611bd1565b611cde858260051b01611c10565b818152858101925060069190911b83018501908c821115611cfe57600080fd5b928501925b81841015611d475784848e031215611d1b5760008081fd5b611d23611be7565b8435611d2e81611afe565b8152848701358782015283529284019291850191611d03565b8096505050505050509295509295909350565b600060208284031215611d6c57600080fd5b813561096081611afe565b60008060408385031215611d8a57600080fd5b8235611d9581611afe565b91506020830135611da581611afe565b809150509250929050565b60008060008060608587031215611dc657600080fd5b843593506020850135611dd881611afe565b9250604085013567ffffffffffffffff80821115611df557600080fd5b818701915087601f830112611e0957600080fd5b813581811115611e1857600080fd5b886020828501011115611e2a57600080fd5b95989497505060200194505050565b600181811c90821680611e4d57607f821691505b602082108103611e6d57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b600060018201611e9b57611e9b611e73565b5060010190565b8181038181111561052d5761052d611e73565b8082018082111561052d5761052d611e73565b634e487b7160e01b600052601260045260246000fd5b600082611eed57611eed611ec8565b500690565b6001600160a01b038316815260406020820181905260009061145d90830184611aa5565b634e487b7160e01b600052603260045260246000fd5b60008085851115611f3c57600080fd5b83861115611f4957600080fd5b5050820193919092039150565b8035602083101561052d57600019602084900360031b1b1692915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b600081611fce57611fce611e73565b506000190190565b634e487b7160e01b600052600160045260246000fd5b601f8211156112c257600081815260208120601f850160051c810160208610156120135750805b601f850160051c820191505b81811015610bfd5782815560010161201f565b815167ffffffffffffffff81111561204c5761204c611bd1565b6120608161205a8454611e39565b84611fec565b602080601f831160018114612095576000841561207d5750858301515b600019600386901b1c1916600185901b178555610bfd565b600085815260208120601f198616915b828110156120c4578886015182559484019460019091019084016120a5565b50858210156120e25787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b60008261210157612101611ec8565b50049056feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220a7f49f3b74e4ac0e9fc814278d95b8601a69f04a86da95d921d3e639218e2b7264736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var EIP1559BurnArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"EIP1559Burn","sourceName":"contracts/child/EIP1559Burn.sol","abi":[{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"burner","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"NativeTokenBurnt","type":"event"},{"inputs":[],"name":"burnDestination","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"childERC20Predicate","outputs":[{"internalType":"contract IChildERC20Predicate","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"contract IChildERC20Predicate","name":"newChildERC20Predicate","type":"address"},{"internalType":"address","name":"newBurnDestination","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"stateMutability":"payable","type":"receive"}],"bytecode":"0x608060405234801561001057600080fd5b50610425806100206000396000f3fe6080604052600436106100435760003560e01c80630fca96871461004f5780633ccfd60b1461008b578063485cc955146100a2578063d57184e4146100c257600080fd5b3661004a57005b600080fd5b34801561005b57600080fd5b5060015461006f906001600160a01b031681565b6040516001600160a01b03909116815260200160405180910390f35b34801561009757600080fd5b506100a06100e8565b005b3480156100ae57600080fd5b506100a06100bd3660046103b6565b6101fc565b3480156100ce57600080fd5b5060005461006f906201000090046001600160a01b031681565b6000546201000090046001600160a01b031661014b5760405162461bcd60e51b815260206004820152601a60248201527f454950313535394275726e3a20554e494e495449414c495a454400000000000060448201526064015b60405180910390fd5b6000546001546040516361d9ad3f60e11b815261101060048201526001600160a01b0391821660248201524760448201819052926201000090049091169063c3b35a7e90606401600060405180830381600087803b1580156101ac57600080fd5b505af11580156101c0573d6000803e3d6000fd5b50506040518381523392507feb347a9a474ae97b7b32a903d84decf8fc80dc9cd6129085f5097de5cd3b3256915060200160405180910390a250565b600054610100900460ff161580801561021c5750600054600160ff909116105b806102365750303b158015610236575060005460ff166001145b6102995760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610142565b6000805460ff1916600117905580156102bc576000805461ff0019166101001790555b6001600160a01b0383166103125760405162461bcd60e51b815260206004820152601f60248201527f454950313535394275726e3a204241445f494e495449414c495a4154494f4e006044820152606401610142565b6000805462010000600160b01b031916620100006001600160a01b038681169190910291909117909155600180546001600160a01b0319169184169190911790558015610399576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050565b6001600160a01b03811681146103b357600080fd5b50565b600080604083850312156103c957600080fd5b82356103d48161039e565b915060208301356103e48161039e565b80915050925092905056fea26469706673582212204ef36b0d6b6d4a5e32117ffe6009ea0f1d44da93380a511f1e364bb3e312af6b64736f6c63430008130033","deployedBytecode":"0x6080604052600436106100435760003560e01c80630fca96871461004f5780633ccfd60b1461008b578063485cc955146100a2578063d57184e4146100c257600080fd5b3661004a57005b600080fd5b34801561005b57600080fd5b5060015461006f906001600160a01b031681565b6040516001600160a01b03909116815260200160405180910390f35b34801561009757600080fd5b506100a06100e8565b005b3480156100ae57600080fd5b506100a06100bd3660046103b6565b6101fc565b3480156100ce57600080fd5b5060005461006f906201000090046001600160a01b031681565b6000546201000090046001600160a01b031661014b5760405162461bcd60e51b815260206004820152601a60248201527f454950313535394275726e3a20554e494e495449414c495a454400000000000060448201526064015b60405180910390fd5b6000546001546040516361d9ad3f60e11b815261101060048201526001600160a01b0391821660248201524760448201819052926201000090049091169063c3b35a7e90606401600060405180830381600087803b1580156101ac57600080fd5b505af11580156101c0573d6000803e3d6000fd5b50506040518381523392507feb347a9a474ae97b7b32a903d84decf8fc80dc9cd6129085f5097de5cd3b3256915060200160405180910390a250565b600054610100900460ff161580801561021c5750600054600160ff909116105b806102365750303b158015610236575060005460ff166001145b6102995760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610142565b6000805460ff1916600117905580156102bc576000805461ff0019166101001790555b6001600160a01b0383166103125760405162461bcd60e51b815260206004820152601f60248201527f454950313535394275726e3a204241445f494e495449414c495a4154494f4e006044820152606401610142565b6000805462010000600160b01b031916620100006001600160a01b038681169190910291909117909155600180546001600160a01b0319169184169190911790558015610399576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050565b6001600160a01b03811681146103b357600080fd5b50565b600080604083850312156103c957600080fd5b82356103d48161039e565b915060208301356103e48161039e565b80915050925092905056fea26469706673582212204ef36b0d6b6d4a5e32117ffe6009ea0f1d44da93380a511f1e364bb3e312af6b64736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var GenesisProxyArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"GenesisProxy","sourceName":"contracts/lib/GenesisProxy.sol","abi":[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"previousAdmin","type":"address"},{"indexed":false,"internalType":"address","name":"newAdmin","type":"address"}],"name":"AdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"beacon","type":"address"}],"name":"BeaconUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"stateMutability":"payable","type":"fallback"},{"inputs":[{"internalType":"address","name":"initiator","type":"address"}],"name":"protectSetUpProxy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"logic","type":"address"},{"internalType":"address","name":"admin","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"setUpProxy","outputs":[],"stateMutability":"nonpayable","type":"function"},{"stateMutability":"payable","type":"receive"}],"bytecode":"0x60806040523480156200001157600080fd5b506000806040518060200160405280600081525082816200003b828260006200004e60201b60201c565b506200004990508262000080565b600080fd5b6200005983620000f2565b600082511180620000675750805b156200007b5762000079838362000134565b505b505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f620000c260008051602062000446833981519152546001600160a01b031690565b604080516001600160a01b03928316815291841660208301520160405180910390a1620000ef8162000163565b50565b620000fd8162000201565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606200015c8383604051806060016040528060278152602001620004666027913962000298565b9392505050565b6001600160a01b038116620001ce5760405162461bcd60e51b815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201526564647265737360d01b60648201526084015b60405180910390fd5b80600080516020620004468339815191525b80546001600160a01b0319166001600160a01b039290921691909117905550565b6001600160a01b0381163b620002705760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b6064820152608401620001c5565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc620001e0565b6060600080856001600160a01b031685604051620002b79190620003f2565b600060405180830381855af49150503d8060008114620002f4576040519150601f19603f3d011682016040523d82523d6000602084013e620002f9565b606091505b5090925090506200030d8683838762000317565b9695505050505050565b606083156200038b57825160000362000383576001600160a01b0385163b620003835760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401620001c5565b508162000397565b6200039783836200039f565b949350505050565b815115620003b05781518083602001fd5b8060405162461bcd60e51b8152600401620001c5919062000410565b60005b83811015620003e9578181015183820152602001620003cf565b50506000910152565b6000825162000406818460208701620003cc565b9190910192915050565b602081526000825180602084015262000431816040850160208701620003cc565b601f01601f1916919091016040019291505056feb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564","deployedBytecode":"0x60806040526004361061002d5760003560e01c806317cf3e3414610044578063da2655db146100645761003c565b3661003c5761003a610084565b005b61003a610084565b34801561005057600080fd5b5061003a61005f3660046108d2565b6101d6565b34801561007057600080fd5b5061003a61007f366004610934565b6102a5565b61008c610300565b6001600160a01b031633036101cc5760606001600160e01b0319600035166364d3180d60e11b81016100c7576100c0610333565b91506101c4565b63587086bd60e11b6001600160e01b03198216016100e7576100c061038a565b63070d7c6960e41b6001600160e01b0319821601610107576100c06103d0565b621eb96f60e61b6001600160e01b0319821601610126576100c0610401565b63a39f25e560e01b6001600160e01b0319821601610146576100c0610441565b60405162461bcd60e51b815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f78792074617267606482015261195d60f21b608482015260a4015b60405180910390fd5b815160208301f35b6101d4610455565b565b600080516020610a3f833981519152546000196001600160a01b038216016102315760405162461bcd60e51b815260206004820152600e60248201526d0416c7265616479207365742d75760941b60448201526064016101bb565b336001600160a01b038216146102785760405162461bcd60e51b815260206004820152600c60248201526b155b985d5d1a1bdc9a5e995960a21b60448201526064016101bb565b61028183610465565b61028d848360006104bc565b6001600080516020610a3f8339815191525550505050565b600080516020610a3f83398151915280549082905580156102fc5760405162461bcd60e51b8152602060048201526011602482015270105b1c9958591e481c1c9bdd1958dd1959607a1b60448201526064016101bb565b5050565b60007fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b546001600160a01b0316919050565b606061033d6104e8565b600061034c3660048184610951565b8101906103599190610934565b9050610376816040518060200160405280600081525060006104bc565b505060408051602081019091526000815290565b606060008061039c3660048184610951565b8101906103a9919061097b565b915091506103b9828260016104bc565b604051806020016040528060008152509250505090565b60606103da6104e8565b60006103e93660048184610951565b8101906103f69190610934565b905061037681610465565b606061040b6104e8565b6000610415610300565b604080516001600160a01b03831660208201529192500160405160208183030381529060405291505090565b606061044b6104e8565b60006104156104f3565b6101d46104606104f3565b610502565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f61048e610300565b604080516001600160a01b03928316815291841660208301520160405180910390a16104b981610526565b50565b6104c5836105cf565b6000825111806104d25750805b156104e3576104e1838361060f565b505b505050565b34156101d457600080fd5b60006104fd61063b565b905090565b3660008037600080366000845af43d6000803e808015610521573d6000f35b3d6000fd5b6001600160a01b03811661058b5760405162461bcd60e51b815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201526564647265737360d01b60648201526084016101bb565b807fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b80546001600160a01b0319166001600160a01b039290921691909117905550565b6105d881610663565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606106348383604051806060016040528060278152602001610a5f602791396106f7565b9392505050565b60007f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610324565b6001600160a01b0381163b6106d05760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b60648201526084016101bb565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc6105ae565b6060600080856001600160a01b03168560405161071491906109ef565b600060405180830381855af49150503d806000811461074f576040519150601f19603f3d011682016040523d82523d6000602084013e610754565b606091505b50915091506107658683838761076f565b9695505050505050565b606083156107de5782516000036107d7576001600160a01b0385163b6107d75760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016101bb565b50816107e8565b6107e883836107f0565b949350505050565b8151156108005781518083602001fd5b8060405162461bcd60e51b81526004016101bb9190610a0b565b6001600160a01b03811681146104b957600080fd5b634e487b7160e01b600052604160045260246000fd5b600082601f83011261085657600080fd5b813567ffffffffffffffff808211156108715761087161082f565b604051601f8301601f19908116603f011681019082821181831017156108995761089961082f565b816040528381528660208588010111156108b257600080fd5b836020870160208301376000602085830101528094505050505092915050565b6000806000606084860312156108e757600080fd5b83356108f28161081a565b925060208401356109028161081a565b9150604084013567ffffffffffffffff81111561091e57600080fd5b61092a86828701610845565b9150509250925092565b60006020828403121561094657600080fd5b81356106348161081a565b6000808585111561096157600080fd5b8386111561096e57600080fd5b5050820193919092039150565b6000806040838503121561098e57600080fd5b82356109998161081a565b9150602083013567ffffffffffffffff8111156109b557600080fd5b6109c185828601610845565b9150509250929050565b60005b838110156109e65781810151838201526020016109ce565b50506000910152565b60008251610a018184602087016109cb565b9190910192915050565b6020815260008251806020840152610a2a8160408501602087016109cb565b601f01601f1916919091016040019291505056fe16561015e0650c143c10fb1907c52a56b654e2f0922ca3245bde5beff81a333d416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220abb148ad739bda14bfde881802dab93d2ab651041781eed877949635c7179ba364736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` -var TransparentUpgradeableProxyArtifact string = `{"_format":"hh-sol-artifact-1","contractName":"TransparentUpgradeableProxy","sourceName":"@openzeppelin/contracts/proxy/transparent/TransparentUpgradeableProxy.sol","abi":[{"inputs":[{"internalType":"address","name":"_logic","type":"address"},{"internalType":"address","name":"admin_","type":"address"},{"internalType":"bytes","name":"_data","type":"bytes"}],"stateMutability":"payable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"previousAdmin","type":"address"},{"indexed":false,"internalType":"address","name":"newAdmin","type":"address"}],"name":"AdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"beacon","type":"address"}],"name":"BeaconUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"stateMutability":"payable","type":"fallback"},{"stateMutability":"payable","type":"receive"}],"bytecode":"0x608060405260405162000e3a38038062000e3a833981016040819052620000269162000424565b828162000036828260006200004d565b50620000449050826200007f565b50505062000557565b6200005883620000f1565b600082511180620000665750805b156200007a5762000078838362000133565b505b505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f620000c160008051602062000df3833981519152546001600160a01b031690565b604080516001600160a01b03928316815291841660208301520160405180910390a1620000ee8162000162565b50565b620000fc8162000200565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606200015b838360405180606001604052806027815260200162000e136027913962000297565b9392505050565b6001600160a01b038116620001cd5760405162461bcd60e51b815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201526564647265737360d01b60648201526084015b60405180910390fd5b8060008051602062000df38339815191525b80546001600160a01b0319166001600160a01b039290921691909117905550565b6001600160a01b0381163b6200026f5760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b6064820152608401620001c4565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc620001df565b6060600080856001600160a01b031685604051620002b6919062000504565b600060405180830381855af49150503d8060008114620002f3576040519150601f19603f3d011682016040523d82523d6000602084013e620002f8565b606091505b5090925090506200030c8683838762000316565b9695505050505050565b606083156200038a57825160000362000382576001600160a01b0385163b620003825760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401620001c4565b508162000396565b6200039683836200039e565b949350505050565b815115620003af5781518083602001fd5b8060405162461bcd60e51b8152600401620001c4919062000522565b80516001600160a01b0381168114620003e357600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b60005b838110156200041b57818101518382015260200162000401565b50506000910152565b6000806000606084860312156200043a57600080fd5b6200044584620003cb565b92506200045560208501620003cb565b60408501519092506001600160401b03808211156200047357600080fd5b818601915086601f8301126200048857600080fd5b8151818111156200049d576200049d620003e8565b604051601f8201601f19908116603f01168101908382118183101715620004c857620004c8620003e8565b81604052828152896020848701011115620004e257600080fd5b620004f5836020830160208801620003fe565b80955050505050509250925092565b6000825162000518818460208701620003fe565b9190910192915050565b602081526000825180602084015262000543816040850160208701620003fe565b601f01601f19169190910160400192915050565b61088c80620005676000396000f3fe60806040523661001357610011610017565b005b6100115b61001f610169565b6001600160a01b0316330361015f5760606001600160e01b0319600035166364d3180d60e11b810161005a5761005361019c565b9150610157565b63587086bd60e11b6001600160e01b031982160161007a576100536101f3565b63070d7c6960e41b6001600160e01b031982160161009a57610053610239565b621eb96f60e61b6001600160e01b03198216016100b95761005361026a565b63a39f25e560e01b6001600160e01b03198216016100d9576100536102aa565b60405162461bcd60e51b815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f78792074617267606482015261195d60f21b608482015260a4015b60405180910390fd5b815160208301f35b6101676102be565b565b60007fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b546001600160a01b0316919050565b60606101a66102ce565b60006101b53660048184610683565b8101906101c291906106c9565b90506101df816040518060200160405280600081525060006102d9565b505060408051602081019091526000815290565b60606000806102053660048184610683565b81019061021291906106fa565b91509150610222828260016102d9565b604051806020016040528060008152509250505090565b60606102436102ce565b60006102523660048184610683565b81019061025f91906106c9565b90506101df81610305565b60606102746102ce565b600061027e610169565b604080516001600160a01b03831660208201529192500160405160208183030381529060405291505090565b60606102b46102ce565b600061027e61035c565b6101676102c961035c565b61036b565b341561016757600080fd5b6102e28361038f565b6000825111806102ef5750805b15610300576102fe83836103cf565b505b505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f61032e610169565b604080516001600160a01b03928316815291841660208301520160405180910390a1610359816103fb565b50565b60006103666104a4565b905090565b3660008037600080366000845af43d6000803e80801561038a573d6000f35b3d6000fd5b610398816104cc565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606103f4838360405180606001604052806027815260200161083060279139610560565b9392505050565b6001600160a01b0381166104605760405162461bcd60e51b815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201526564647265737360d01b606482015260840161014e565b807fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b80546001600160a01b0319166001600160a01b039290921691909117905550565b60007f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc61018d565b6001600160a01b0381163b6105395760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b606482015260840161014e565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610483565b6060600080856001600160a01b03168560405161057d91906107e0565b600060405180830381855af49150503d80600081146105b8576040519150601f19603f3d011682016040523d82523d6000602084013e6105bd565b606091505b50915091506105ce868383876105d8565b9695505050505050565b60608315610647578251600003610640576001600160a01b0385163b6106405760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161014e565b5081610651565b6106518383610659565b949350505050565b8151156106695781518083602001fd5b8060405162461bcd60e51b815260040161014e91906107fc565b6000808585111561069357600080fd5b838611156106a057600080fd5b5050820193919092039150565b80356001600160a01b03811681146106c457600080fd5b919050565b6000602082840312156106db57600080fd5b6103f4826106ad565b634e487b7160e01b600052604160045260246000fd5b6000806040838503121561070d57600080fd5b610716836106ad565b9150602083013567ffffffffffffffff8082111561073357600080fd5b818501915085601f83011261074757600080fd5b813581811115610759576107596106e4565b604051601f8201601f19908116603f01168101908382118183101715610781576107816106e4565b8160405282815288602084870101111561079a57600080fd5b8260208601602083013760006020848301015280955050505050509250929050565b60005b838110156107d75781810151838201526020016107bf565b50506000910152565b600082516107f28184602087016107bc565b9190910192915050565b602081526000825180602084015261081b8160408501602087016107bc565b601f01601f1916919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220e47bdad79754770e5755a6f8224b03af73f674035cf42b93fa6fc0731c0dbb6864736f6c63430008130033b53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564","deployedBytecode":"0x60806040523661001357610011610017565b005b6100115b61001f610169565b6001600160a01b0316330361015f5760606001600160e01b0319600035166364d3180d60e11b810161005a5761005361019c565b9150610157565b63587086bd60e11b6001600160e01b031982160161007a576100536101f3565b63070d7c6960e41b6001600160e01b031982160161009a57610053610239565b621eb96f60e61b6001600160e01b03198216016100b95761005361026a565b63a39f25e560e01b6001600160e01b03198216016100d9576100536102aa565b60405162461bcd60e51b815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f78792074617267606482015261195d60f21b608482015260a4015b60405180910390fd5b815160208301f35b6101676102be565b565b60007fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b546001600160a01b0316919050565b60606101a66102ce565b60006101b53660048184610683565b8101906101c291906106c9565b90506101df816040518060200160405280600081525060006102d9565b505060408051602081019091526000815290565b60606000806102053660048184610683565b81019061021291906106fa565b91509150610222828260016102d9565b604051806020016040528060008152509250505090565b60606102436102ce565b60006102523660048184610683565b81019061025f91906106c9565b90506101df81610305565b60606102746102ce565b600061027e610169565b604080516001600160a01b03831660208201529192500160405160208183030381529060405291505090565b60606102b46102ce565b600061027e61035c565b6101676102c961035c565b61036b565b341561016757600080fd5b6102e28361038f565b6000825111806102ef5750805b15610300576102fe83836103cf565b505b505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f61032e610169565b604080516001600160a01b03928316815291841660208301520160405180910390a1610359816103fb565b50565b60006103666104a4565b905090565b3660008037600080366000845af43d6000803e80801561038a573d6000f35b3d6000fd5b610398816104cc565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606103f4838360405180606001604052806027815260200161083060279139610560565b9392505050565b6001600160a01b0381166104605760405162461bcd60e51b815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201526564647265737360d01b606482015260840161014e565b807fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b80546001600160a01b0319166001600160a01b039290921691909117905550565b60007f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc61018d565b6001600160a01b0381163b6105395760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b606482015260840161014e565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610483565b6060600080856001600160a01b03168560405161057d91906107e0565b600060405180830381855af49150503d80600081146105b8576040519150601f19603f3d011682016040523d82523d6000602084013e6105bd565b606091505b50915091506105ce868383876105d8565b9695505050505050565b60608315610647578251600003610640576001600160a01b0385163b6106405760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e7472616374000000604482015260640161014e565b5081610651565b6106518383610659565b949350505050565b8151156106695781518083602001fd5b8060405162461bcd60e51b815260040161014e91906107fc565b6000808585111561069357600080fd5b838611156106a057600080fd5b5050820193919092039150565b80356001600160a01b03811681146106c457600080fd5b919050565b6000602082840312156106db57600080fd5b6103f4826106ad565b634e487b7160e01b600052604160045260246000fd5b6000806040838503121561070d57600080fd5b610716836106ad565b9150602083013567ffffffffffffffff8082111561073357600080fd5b818501915085601f83011261074757600080fd5b813581811115610759576107596106e4565b604051601f8201601f19908116603f01168101908382118183101715610781576107816106e4565b8160405282815288602084870101111561079a57600080fd5b8260208601602083013760006020848301015280955050505050509250929050565b60005b838110156107d75781810151838201526020016107bf565b50506000910152565b600082516107f28184602087016107bc565b9190910192915050565b602081526000825180602084015261081b8160408501602087016107bc565b601f01601f1916919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220e47bdad79754770e5755a6f8224b03af73f674035cf42b93fa6fc0731c0dbb6864736f6c63430008130033","linkReferences":{},"deployedLinkReferences":{}}` diff --git a/consensus/polybft/contractsapi/helper.go b/consensus/polybft/contractsapi/helper.go deleted file mode 100644 index 49a8d05..0000000 --- a/consensus/polybft/contractsapi/helper.go +++ /dev/null @@ -1,55 +0,0 @@ -package contractsapi - -import ( - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/xgr-network/xgr-node/types" -) - -// StateTransactionInput is an abstraction for different state transaction inputs -type StateTransactionInput interface { - // EncodeAbi contains logic for encoding arbitrary data into ABI format - EncodeAbi() ([]byte, error) - // DecodeAbi contains logic for decoding given ABI data - DecodeAbi(b []byte) error -} - -// EventAbi is an interface representing an event generated in contractsapi -type EventAbi interface { - // Sig returns the event ABI signature or ID (which is unique for all event types) - Sig() ethgo.Hash - // Encode does abi encoding of given event - Encode() ([]byte, error) - // ParseLog parses the provided receipt log to given event type - ParseLog(log *ethgo.Log) (bool, error) -} - -var ( - // stateSyncABIType is a specific case where we need to encode state sync event as a tuple of tuple - stateSyncABIType = abi.MustNewType( - "tuple(tuple(uint256 id, address sender, address receiver, bytes data))") - - // GetCheckpointBlockABIResponse is the ABI type for getCheckpointBlock function return value - GetCheckpointBlockABIResponse = abi.MustNewType("tuple(bool isFound, uint256 checkpointBlock)") -) - -// ToABI converts StateSyncEvent to ABI -func (sse *StateSyncedEvent) EncodeAbi() ([]byte, error) { - return stateSyncABIType.Encode([]interface{}{sse}) -} - -var ( - _ StateTransactionInput = &CommitEpochValidatorSetFn{} - _ StateTransactionInput = &DistributeRewardForRewardPoolFn{} -) - -// IsStake indicates if transfer event (from ERC20 implementation) mints tokens to a non zero address -func (t *TransferEvent) IsStake() bool { - return t.To != types.ZeroAddress && t.From == types.ZeroAddress -} - -// IsUnstake indicates if transfer event (from ERC20 implementation) burns tokens from a non zero address -// meaning, it transfers them to zero address -func (t *TransferEvent) IsUnstake() bool { - return t.To == types.ZeroAddress && t.From != types.ZeroAddress -} diff --git a/consensus/polybft/contractsapi/init.go b/consensus/polybft/contractsapi/init.go deleted file mode 100644 index 6de3b23..0000000 --- a/consensus/polybft/contractsapi/init.go +++ /dev/null @@ -1,305 +0,0 @@ -package contractsapi - -import ( - "embed" - "log" - "path" - - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi/artifact" -) - -const ( - testContractsDir = "test-contracts" -) - -var ( - // core-contracts smart contracts - CheckpointManager *artifact.Artifact - ExitHelper *artifact.Artifact - StateSender *artifact.Artifact - RootERC20Predicate *artifact.Artifact - RootERC721Predicate *artifact.Artifact - RootERC1155Predicate *artifact.Artifact - ChildMintableERC20Predicate *artifact.Artifact - ChildMintableERC721Predicate *artifact.Artifact - ChildMintableERC1155Predicate *artifact.Artifact - BLS *artifact.Artifact - BLS256 *artifact.Artifact - System *artifact.Artifact - Merkle *artifact.Artifact - ChildValidatorSet *artifact.Artifact - NativeERC20 *artifact.Artifact - NativeERC20Mintable *artifact.Artifact - StateReceiver *artifact.Artifact - ChildERC20 *artifact.Artifact - ChildERC20Predicate *artifact.Artifact - ChildERC20PredicateACL *artifact.Artifact - RootMintableERC20Predicate *artifact.Artifact - RootMintableERC20PredicateACL *artifact.Artifact - ChildERC721 *artifact.Artifact - ChildERC721Predicate *artifact.Artifact - ChildERC721PredicateACL *artifact.Artifact - RootMintableERC721Predicate *artifact.Artifact - RootMintableERC721PredicateACL *artifact.Artifact - ChildERC1155 *artifact.Artifact - ChildERC1155Predicate *artifact.Artifact - ChildERC1155PredicateACL *artifact.Artifact - RootMintableERC1155Predicate *artifact.Artifact - RootMintableERC1155PredicateACL *artifact.Artifact - L2StateSender *artifact.Artifact - CustomSupernetManager *artifact.Artifact - StakeManager *artifact.Artifact - RewardPool *artifact.Artifact - ValidatorSet *artifact.Artifact - RootERC721 *artifact.Artifact - RootERC1155 *artifact.Artifact - EIP1559Burn *artifact.Artifact - GenesisProxy *artifact.Artifact - TransparentUpgradeableProxy *artifact.Artifact - - // test smart contracts - //go:embed test-contracts/* - testContracts embed.FS - TestWriteBlockMetadata *artifact.Artifact - RootERC20 *artifact.Artifact - TestSimple *artifact.Artifact - TestRewardToken *artifact.Artifact -) - -func init() { - var err error - - CheckpointManager, err = artifact.DecodeArtifact([]byte(CheckpointManagerArtifact)) - if err != nil { - log.Fatal(err) - } - - ExitHelper, err = artifact.DecodeArtifact([]byte(ExitHelperArtifact)) - if err != nil { - log.Fatal(err) - } - - L2StateSender, err = artifact.DecodeArtifact([]byte(L2StateSenderArtifact)) - if err != nil { - log.Fatal(err) - } - - BLS, err = artifact.DecodeArtifact([]byte(BLSArtifact)) - if err != nil { - log.Fatal(err) - } - - BLS256, err = artifact.DecodeArtifact([]byte(BN256G2Artifact)) - if err != nil { - log.Fatal(err) - } - - Merkle, err = artifact.DecodeArtifact([]byte(MerkleArtifact)) - if err != nil { - log.Fatal(err) - } - - StateSender, err = artifact.DecodeArtifact([]byte(StateSenderArtifact)) - if err != nil { - log.Fatal(err) - } - - RootERC20Predicate, err = artifact.DecodeArtifact([]byte(RootERC20PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - RootERC721Predicate, err = artifact.DecodeArtifact([]byte(RootERC721PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - RootERC1155Predicate, err = artifact.DecodeArtifact([]byte(RootERC1155PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - ChildMintableERC20Predicate, err = artifact.DecodeArtifact([]byte(ChildMintableERC20PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - ChildMintableERC721Predicate, err = artifact.DecodeArtifact([]byte(ChildMintableERC721PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - ChildMintableERC1155Predicate, err = artifact.DecodeArtifact([]byte(ChildMintableERC1155PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - StateReceiver, err = artifact.DecodeArtifact([]byte(StateReceiverArtifact)) - if err != nil { - log.Fatal(err) - } - - System, err = artifact.DecodeArtifact([]byte(SystemArtifact)) - if err != nil { - log.Fatal(err) - } - - ChildERC20, err = artifact.DecodeArtifact([]byte(ChildERC20Artifact)) - if err != nil { - log.Fatal(err) - } - - ChildERC20Predicate, err = artifact.DecodeArtifact([]byte(ChildERC20PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - ChildERC20PredicateACL, err = artifact.DecodeArtifact([]byte(ChildERC20PredicateACLArtifact)) - if err != nil { - log.Fatal(err) - } - - RootMintableERC20Predicate, err = artifact.DecodeArtifact([]byte(RootMintableERC20PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - RootMintableERC20PredicateACL, err = artifact.DecodeArtifact([]byte(RootMintableERC20PredicateACLArtifact)) - if err != nil { - log.Fatal(err) - } - - ChildERC721, err = artifact.DecodeArtifact([]byte(ChildERC721Artifact)) - if err != nil { - log.Fatal(err) - } - - ChildERC721Predicate, err = artifact.DecodeArtifact([]byte(ChildERC721PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - ChildERC721PredicateACL, err = artifact.DecodeArtifact([]byte(ChildERC721PredicateACLArtifact)) - if err != nil { - log.Fatal(err) - } - - RootMintableERC721Predicate, err = artifact.DecodeArtifact([]byte(RootMintableERC721PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - RootMintableERC721PredicateACL, err = artifact.DecodeArtifact([]byte(RootMintableERC721PredicateACLArtifact)) - if err != nil { - log.Fatal(err) - } - - ChildERC1155, err = artifact.DecodeArtifact([]byte(ChildERC1155Artifact)) - if err != nil { - log.Fatal(err) - } - - ChildERC1155Predicate, err = artifact.DecodeArtifact([]byte(ChildERC1155PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - ChildERC1155PredicateACL, err = artifact.DecodeArtifact([]byte(ChildERC1155PredicateACLArtifact)) - if err != nil { - log.Fatal(err) - } - - RootMintableERC1155Predicate, err = artifact.DecodeArtifact([]byte(RootMintableERC1155PredicateArtifact)) - if err != nil { - log.Fatal(err) - } - - RootMintableERC1155PredicateACL, err = artifact.DecodeArtifact([]byte(RootMintableERC1155PredicateACLArtifact)) - if err != nil { - log.Fatal(err) - } - - NativeERC20, err = artifact.DecodeArtifact([]byte(NativeERC20Artifact)) - if err != nil { - log.Fatal(err) - } - - NativeERC20Mintable, err = artifact.DecodeArtifact([]byte(NativeERC20MintableArtifact)) - if err != nil { - log.Fatal(err) - } - - RootERC20, err = artifact.DecodeArtifact([]byte(MockERC20Artifact)) - if err != nil { - log.Fatal(err) - } - - RootERC721, err = artifact.DecodeArtifact([]byte(MockERC721Artifact)) - if err != nil { - log.Fatal(err) - } - - RootERC1155, err = artifact.DecodeArtifact([]byte(MockERC1155Artifact)) - if err != nil { - log.Fatal(err) - } - - TestWriteBlockMetadata, err = artifact.DecodeArtifact(readTestContractContent("TestWriteBlockMetadata.json")) - if err != nil { - log.Fatal(err) - } - - TestSimple, err = artifact.DecodeArtifact(readTestContractContent("TestSimple.json")) - if err != nil { - log.Fatal(err) - } - - TestRewardToken, err = artifact.DecodeArtifact(readTestContractContent("TestRewardToken.json")) - if err != nil { - log.Fatal(err) - } - - CustomSupernetManager, err = artifact.DecodeArtifact([]byte(CustomSupernetManagerArtifact)) - if err != nil { - log.Fatal(err) - } - - StakeManager, err = artifact.DecodeArtifact([]byte(StakeManagerArtifact)) - if err != nil { - log.Fatal(err) - } - - RewardPool, err = artifact.DecodeArtifact([]byte(RewardPoolArtifact)) - if err != nil { - log.Fatal(err) - } - - ValidatorSet, err = artifact.DecodeArtifact([]byte(ValidatorSetArtifact)) - if err != nil { - log.Fatal(err) - } - - EIP1559Burn, err = artifact.DecodeArtifact([]byte(EIP1559BurnArtifact)) - if err != nil { - log.Fatal(err) - } - - GenesisProxy, err = artifact.DecodeArtifact([]byte(GenesisProxyArtifact)) - if err != nil { - log.Fatal(err) - } - - TransparentUpgradeableProxy, err = artifact.DecodeArtifact([]byte(TransparentUpgradeableProxyArtifact)) - if err != nil { - log.Fatal(err) - } -} - -func readTestContractContent(contractFileName string) []byte { - contractRaw, err := testContracts.ReadFile(path.Join(testContractsDir, contractFileName)) - if err != nil { - log.Fatal(err) - } - - return contractRaw -} diff --git a/consensus/polybft/contractsapi/init_test.go b/consensus/polybft/contractsapi/init_test.go deleted file mode 100644 index c64d965..0000000 --- a/consensus/polybft/contractsapi/init_test.go +++ /dev/null @@ -1,29 +0,0 @@ -package contractsapi - -import ( - "testing" - - "github.com/stretchr/testify/require" -) - -func TestArtifactNotEmpty(t *testing.T) { - require.NotEmpty(t, CheckpointManager.Bytecode) - require.NotEmpty(t, CheckpointManager.DeployedBytecode) - require.NotEmpty(t, CheckpointManager.Abi) - - require.NotEmpty(t, ExitHelper.Bytecode) - require.NotEmpty(t, ExitHelper.DeployedBytecode) - require.NotEmpty(t, ExitHelper.Abi) - - require.NotEmpty(t, L2StateSender.Bytecode) - require.NotEmpty(t, L2StateSender.DeployedBytecode) - require.NotEmpty(t, L2StateSender.Abi) - - require.NotEmpty(t, BLS.Bytecode) - require.NotEmpty(t, BLS.DeployedBytecode) - require.NotEmpty(t, BLS.Abi) - - require.NotEmpty(t, BLS256.Bytecode) - require.NotEmpty(t, BLS256.DeployedBytecode) - require.NotEmpty(t, BLS256.Abi) -} diff --git a/consensus/polybft/contractsapi/test-contracts/TestRewardToken.json b/consensus/polybft/contractsapi/test-contracts/TestRewardToken.json deleted file mode 100644 index 86f12b2..0000000 --- a/consensus/polybft/contractsapi/test-contracts/TestRewardToken.json +++ /dev/null @@ -1,330 +0,0 @@ -{ - "_format": "hh-sol-artifact-1", - "contractName": "TestRewardToken", - "sourceName": "contracts/mocks/TestRewardToken.sol", - "abi": [ - { - "anonymous": false, - "inputs": [ - { - "indexed": true, - "internalType": "address", - "name": "owner", - "type": "address" - }, - { - "indexed": true, - "internalType": "address", - "name": "spender", - "type": "address" - }, - { - "indexed": false, - "internalType": "uint256", - "name": "value", - "type": "uint256" - } - ], - "name": "Approval", - "type": "event" - }, - { - "anonymous": false, - "inputs": [ - { - "indexed": false, - "internalType": "uint8", - "name": "version", - "type": "uint8" - } - ], - "name": "Initialized", - "type": "event" - }, - { - "anonymous": false, - "inputs": [ - { - "indexed": true, - "internalType": "address", - "name": "from", - "type": "address" - }, - { - "indexed": true, - "internalType": "address", - "name": "to", - "type": "address" - }, - { - "indexed": false, - "internalType": "uint256", - "name": "value", - "type": "uint256" - } - ], - "name": "Transfer", - "type": "event" - }, - { - "inputs": [ - { - "internalType": "address", - "name": "owner", - "type": "address" - }, - { - "internalType": "address", - "name": "spender", - "type": "address" - } - ], - "name": "allowance", - "outputs": [ - { - "internalType": "uint256", - "name": "", - "type": "uint256" - } - ], - "stateMutability": "view", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "address", - "name": "spender", - "type": "address" - }, - { - "internalType": "uint256", - "name": "amount", - "type": "uint256" - } - ], - "name": "approve", - "outputs": [ - { - "internalType": "bool", - "name": "", - "type": "bool" - } - ], - "stateMutability": "nonpayable", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "address", - "name": "account", - "type": "address" - } - ], - "name": "balanceOf", - "outputs": [ - { - "internalType": "uint256", - "name": "", - "type": "uint256" - } - ], - "stateMutability": "view", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "address", - "name": "account", - "type": "address" - }, - { - "internalType": "uint256", - "name": "amount", - "type": "uint256" - } - ], - "name": "burn", - "outputs": [], - "stateMutability": "nonpayable", - "type": "function" - }, - { - "inputs": [], - "name": "decimals", - "outputs": [ - { - "internalType": "uint8", - "name": "", - "type": "uint8" - } - ], - "stateMutability": "view", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "address", - "name": "spender", - "type": "address" - }, - { - "internalType": "uint256", - "name": "subtractedValue", - "type": "uint256" - } - ], - "name": "decreaseAllowance", - "outputs": [ - { - "internalType": "bool", - "name": "", - "type": "bool" - } - ], - "stateMutability": "nonpayable", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "address", - "name": "spender", - "type": "address" - }, - { - "internalType": "uint256", - "name": "addedValue", - "type": "uint256" - } - ], - "name": "increaseAllowance", - "outputs": [ - { - "internalType": "bool", - "name": "", - "type": "bool" - } - ], - "stateMutability": "nonpayable", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "address", - "name": "to", - "type": "address" - }, - { - "internalType": "uint256", - "name": "amount", - "type": "uint256" - } - ], - "name": "mint", - "outputs": [], - "stateMutability": "nonpayable", - "type": "function" - }, - { - "inputs": [], - "name": "name", - "outputs": [ - { - "internalType": "string", - "name": "", - "type": "string" - } - ], - "stateMutability": "view", - "type": "function" - }, - { - "inputs": [], - "name": "symbol", - "outputs": [ - { - "internalType": "string", - "name": "", - "type": "string" - } - ], - "stateMutability": "view", - "type": "function" - }, - { - "inputs": [], - "name": "totalSupply", - "outputs": [ - { - "internalType": "uint256", - "name": "", - "type": "uint256" - } - ], - "stateMutability": "view", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "address", - "name": "to", - "type": "address" - }, - { - "internalType": "uint256", - "name": "amount", - "type": "uint256" - } - ], - "name": "transfer", - "outputs": [ - { - "internalType": "bool", - "name": "", - "type": "bool" - } - ], - "stateMutability": "nonpayable", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "address", - "name": "from", - "type": "address" - }, - { - "internalType": "address", - "name": "to", - "type": "address" - }, - { - "internalType": "uint256", - "name": "amount", - "type": "uint256" - } - ], - "name": "transferFrom", - "outputs": [ - { - "internalType": "bool", - "name": "", - "type": "bool" - } - ], - "stateMutability": "nonpayable", - "type": "function" - } - ], - "bytecode": "0x608060405234801561001057600080fd5b50610a87806100206000396000f3fe608060405234801561001057600080fd5b50600436106100bf5760003560e01c806340c10f191161007c57806340c10f191461014c57806370a082311461016157806395d89b411461018a5780639dc29fac14610192578063a457c2d7146101a5578063a9059cbb146101b8578063dd62ed3e146101cb57600080fd5b806306fdde03146100c4578063095ea7b3146100e257806318160ddd1461010557806323b872dd14610117578063313ce5671461012a5780633950935114610139575b600080fd5b6100cc6101de565b6040516100d991906108b1565b60405180910390f35b6100f56100f036600461091b565b610270565b60405190151581526020016100d9565b6035545b6040519081526020016100d9565b6100f5610125366004610945565b61028a565b604051601281526020016100d9565b6100f561014736600461091b565b6102ae565b61015f61015a36600461091b565b6102d0565b005b61010961016f366004610981565b6001600160a01b031660009081526033602052604090205490565b6100cc6102de565b61015f6101a036600461091b565b6102ed565b6100f56101b336600461091b565b6102f7565b6100f56101c636600461091b565b610377565b6101096101d93660046109a3565b610385565b6060603680546101ed906109d6565b80601f0160208091040260200160405190810160405280929190818152602001828054610219906109d6565b80156102665780601f1061023b57610100808354040283529160200191610266565b820191906000526020600020905b81548152906001019060200180831161024957829003601f168201915b5050505050905090565b60003361027e8185856103b0565b60019150505b92915050565b6000336102988582856104d5565b6102a385858561054f565b506001949350505050565b60003361027e8185856102c18383610385565b6102cb9190610a10565b6103b0565b6102da82826106e8565b5050565b6060603780546101ed906109d6565b6102da8282610797565b600033816103058286610385565b90508381101561036a5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084015b60405180910390fd5b6102a382868684036103b0565b60003361027e81858561054f565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b6001600160a01b0383166104125760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610361565b6001600160a01b0382166104735760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610361565b6001600160a01b0383811660008181526034602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b60006104e18484610385565b90506000198114610549578181101561053c5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610361565b61054984848484036103b0565b50505050565b6001600160a01b0383166105b35760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610361565b6001600160a01b0382166106155760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610361565b6001600160a01b0383166000908152603360205260409020548181101561068d5760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610361565b6001600160a01b038085166000818152603360205260408082208686039055928616808252908390208054860190559151600080516020610a32833981519152906106db9086815260200190565b60405180910390a3610549565b6001600160a01b03821661073e5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610361565b80603560008282546107509190610a10565b90915550506001600160a01b038216600081815260336020908152604080832080548601905551848152600080516020610a32833981519152910160405180910390a35050565b6001600160a01b0382166107f75760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610361565b6001600160a01b0382166000908152603360205260409020548181101561086b5760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610361565b6001600160a01b0383166000818152603360209081526040808320868603905560358054879003905551858152919291600080516020610a3283398151915291016104c8565b600060208083528351808285015260005b818110156108de578581018301518582016040015282016108c2565b506000604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b038116811461091657600080fd5b919050565b6000806040838503121561092e57600080fd5b610937836108ff565b946020939093013593505050565b60008060006060848603121561095a57600080fd5b610963846108ff565b9250610971602085016108ff565b9150604084013590509250925092565b60006020828403121561099357600080fd5b61099c826108ff565b9392505050565b600080604083850312156109b657600080fd5b6109bf836108ff565b91506109cd602084016108ff565b90509250929050565b600181811c908216806109ea57607f821691505b602082108103610a0a57634e487b7160e01b600052602260045260246000fd5b50919050565b8082018082111561028457634e487b7160e01b600052601160045260246000fdfeddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa26469706673582212207a3087f7ea340d96d27d018cb7cdeb374c187cb5bf45382f42a2c2793bd19ff264736f6c63430008130033", - "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100bf5760003560e01c806340c10f191161007c57806340c10f191461014c57806370a082311461016157806395d89b411461018a5780639dc29fac14610192578063a457c2d7146101a5578063a9059cbb146101b8578063dd62ed3e146101cb57600080fd5b806306fdde03146100c4578063095ea7b3146100e257806318160ddd1461010557806323b872dd14610117578063313ce5671461012a5780633950935114610139575b600080fd5b6100cc6101de565b6040516100d991906108b1565b60405180910390f35b6100f56100f036600461091b565b610270565b60405190151581526020016100d9565b6035545b6040519081526020016100d9565b6100f5610125366004610945565b61028a565b604051601281526020016100d9565b6100f561014736600461091b565b6102ae565b61015f61015a36600461091b565b6102d0565b005b61010961016f366004610981565b6001600160a01b031660009081526033602052604090205490565b6100cc6102de565b61015f6101a036600461091b565b6102ed565b6100f56101b336600461091b565b6102f7565b6100f56101c636600461091b565b610377565b6101096101d93660046109a3565b610385565b6060603680546101ed906109d6565b80601f0160208091040260200160405190810160405280929190818152602001828054610219906109d6565b80156102665780601f1061023b57610100808354040283529160200191610266565b820191906000526020600020905b81548152906001019060200180831161024957829003601f168201915b5050505050905090565b60003361027e8185856103b0565b60019150505b92915050565b6000336102988582856104d5565b6102a385858561054f565b506001949350505050565b60003361027e8185856102c18383610385565b6102cb9190610a10565b6103b0565b6102da82826106e8565b5050565b6060603780546101ed906109d6565b6102da8282610797565b600033816103058286610385565b90508381101561036a5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084015b60405180910390fd5b6102a382868684036103b0565b60003361027e81858561054f565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b6001600160a01b0383166104125760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610361565b6001600160a01b0382166104735760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610361565b6001600160a01b0383811660008181526034602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b60006104e18484610385565b90506000198114610549578181101561053c5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610361565b61054984848484036103b0565b50505050565b6001600160a01b0383166105b35760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610361565b6001600160a01b0382166106155760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610361565b6001600160a01b0383166000908152603360205260409020548181101561068d5760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610361565b6001600160a01b038085166000818152603360205260408082208686039055928616808252908390208054860190559151600080516020610a32833981519152906106db9086815260200190565b60405180910390a3610549565b6001600160a01b03821661073e5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610361565b80603560008282546107509190610a10565b90915550506001600160a01b038216600081815260336020908152604080832080548601905551848152600080516020610a32833981519152910160405180910390a35050565b6001600160a01b0382166107f75760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610361565b6001600160a01b0382166000908152603360205260409020548181101561086b5760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610361565b6001600160a01b0383166000818152603360209081526040808320868603905560358054879003905551858152919291600080516020610a3283398151915291016104c8565b600060208083528351808285015260005b818110156108de578581018301518582016040015282016108c2565b506000604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b038116811461091657600080fd5b919050565b6000806040838503121561092e57600080fd5b610937836108ff565b946020939093013593505050565b60008060006060848603121561095a57600080fd5b610963846108ff565b9250610971602085016108ff565b9150604084013590509250925092565b60006020828403121561099357600080fd5b61099c826108ff565b9392505050565b600080604083850312156109b657600080fd5b6109bf836108ff565b91506109cd602084016108ff565b90509250929050565b600181811c908216806109ea57607f821691505b602082108103610a0a57634e487b7160e01b600052602260045260246000fd5b50919050565b8082018082111561028457634e487b7160e01b600052601160045260246000fdfeddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa26469706673582212207a3087f7ea340d96d27d018cb7cdeb374c187cb5bf45382f42a2c2793bd19ff264736f6c63430008130033", - "linkReferences": {}, - "deployedLinkReferences": {} -} diff --git a/consensus/polybft/contractsapi/test-contracts/TestSimple.json b/consensus/polybft/contractsapi/test-contracts/TestSimple.json deleted file mode 100644 index 2772c44..0000000 --- a/consensus/polybft/contractsapi/test-contracts/TestSimple.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "_format": "hh-sol-artifact-1", - "contractName": "TestSimple", - "sourceName": "contracts/TestSimple.sol", - "abi": [ - { - "inputs": [], - "name": "getValue", - "outputs": [ - { - "internalType": "uint256", - "name": "", - "type": "uint256" - } - ], - "stateMutability": "view", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "uint256", - "name": "_val", - "type": "uint256" - } - ], - "name": "setValue", - "outputs": [], - "stateMutability": "nonpayable", - "type": "function" - } - ], - "bytecode": "0x608060405234801561001057600080fd5b50610150806100206000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c8063209652551461003b5780635524107714610059575b600080fd5b610043610075565b60405161005091906100a1565b60405180910390f35b610073600480360381019061006e91906100ed565b61007e565b005b60008054905090565b8060008190555050565b6000819050919050565b61009b81610088565b82525050565b60006020820190506100b66000830184610092565b92915050565b600080fd5b6100ca81610088565b81146100d557600080fd5b50565b6000813590506100e7816100c1565b92915050565b600060208284031215610103576101026100bc565b5b6000610111848285016100d8565b9150509291505056fea2646970667358221220470fde08a8031bec841c7cc72e8ff6af3fefb578f1a87c4d89d5fb45f57a532464736f6c63430008110033", - "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100365760003560e01c8063209652551461003b5780635524107714610059575b600080fd5b610043610075565b60405161005091906100a1565b60405180910390f35b610073600480360381019061006e91906100ed565b61007e565b005b60008054905090565b8060008190555050565b6000819050919050565b61009b81610088565b82525050565b60006020820190506100b66000830184610092565b92915050565b600080fd5b6100ca81610088565b81146100d557600080fd5b50565b6000813590506100e7816100c1565b92915050565b600060208284031215610103576101026100bc565b5b6000610111848285016100d8565b9150509291505056fea2646970667358221220470fde08a8031bec841c7cc72e8ff6af3fefb578f1a87c4d89d5fb45f57a532464736f6c63430008110033", - "linkReferences": {}, - "deployedLinkReferences": {} -} - - diff --git a/consensus/polybft/contractsapi/test-contracts/TestSimple.sol b/consensus/polybft/contractsapi/test-contracts/TestSimple.sol deleted file mode 100644 index 9366467..0000000 --- a/consensus/polybft/contractsapi/test-contracts/TestSimple.sol +++ /dev/null @@ -1,14 +0,0 @@ -// SPDX-License-Identifier: MIT -pragma solidity 0.8.17; - -contract TestSimple { - uint256 val; - - function getValue() public view returns (uint256) { - return val; - } - - function setValue(uint256 _val) public { - val = _val; - } -} diff --git a/consensus/polybft/contractsapi/test-contracts/TestWriteBlockMetadata.json b/consensus/polybft/contractsapi/test-contracts/TestWriteBlockMetadata.json deleted file mode 100644 index 5b92e99..0000000 --- a/consensus/polybft/contractsapi/test-contracts/TestWriteBlockMetadata.json +++ /dev/null @@ -1,50 +0,0 @@ -{ - "_format": "hh-sol-artifact-1", - "contractName": "TestWriteBlockMetadata", - "sourceName": "test-contracts/TestWriteBlockMetadata.sol", - "abi": [ - { - "inputs": [], - "name": "coinbase", - "outputs": [ - { - "internalType": "address", - "name": "", - "type": "address" - } - ], - "stateMutability": "view", - "type": "function" - }, - { - "inputs": [ - { - "internalType": "uint256", - "name": "", - "type": "uint256" - } - ], - "name": "data", - "outputs": [ - { - "internalType": "uint256", - "name": "", - "type": "uint256" - } - ], - "stateMutability": "view", - "type": "function" - }, - { - "inputs": [], - "name": "init", - "outputs": [], - "stateMutability": "nonpayable", - "type": "function" - } - ], - "bytecode": "0x608060405234801561001057600080fd5b50610187806100206000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c8063a6ae0aac14610046578063e1c7392a14610076578063f0ba8440146100f6575b600080fd5b600154610059906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6100f46000805460018181018355828052447f290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e56392830155825480820184554390830155825480820184554290830155825480820184554590830155825480820190935546929091019190915580546001600160a01b03191641179055565b005b610109610104366004610138565b610117565b60405190815260200161006d565b6000818154811061012757600080fd5b600091825260209091200154905081565b60006020828403121561014a57600080fd5b503591905056fea26469706673582212200950a847916ef267078b133380353b5117947fac6a936af48086ceed389149f164736f6c63430008110033", - "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100415760003560e01c8063a6ae0aac14610046578063e1c7392a14610076578063f0ba8440146100f6575b600080fd5b600154610059906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b6100f46000805460018181018355828052447f290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e56392830155825480820184554390830155825480820184554290830155825480820184554590830155825480820190935546929091019190915580546001600160a01b03191641179055565b005b610109610104366004610138565b610117565b60405190815260200161006d565b6000818154811061012757600080fd5b600091825260209091200154905081565b60006020828403121561014a57600080fd5b503591905056fea26469706673582212200950a847916ef267078b133380353b5117947fac6a936af48086ceed389149f164736f6c63430008110033", - "linkReferences": {}, - "deployedLinkReferences": {} -} diff --git a/consensus/polybft/contractsapi/test-contracts/TestWriteBlockMetadata.sol b/consensus/polybft/contractsapi/test-contracts/TestWriteBlockMetadata.sol deleted file mode 100644 index c24384b..0000000 --- a/consensus/polybft/contractsapi/test-contracts/TestWriteBlockMetadata.sol +++ /dev/null @@ -1,19 +0,0 @@ -// SPDX-License-Identifier: MIT -pragma solidity 0.8.17; - -contract TestWriteBlockMetadata { - uint[] public data; - address public coinbase; - // bytes32 public hash; - - function init() external { - data.push(block.difficulty); - data.push(block.number); - data.push(block.timestamp); - data.push(block.gaslimit); - data.push(block.chainid); - coinbase = block.coinbase; - data.push(block.basefee); - // hash = blockhash(block.number); - } -} \ No newline at end of file diff --git a/consensus/polybft/extra.go b/consensus/polybft/extra.go deleted file mode 100644 index 3cbc817..0000000 --- a/consensus/polybft/extra.go +++ /dev/null @@ -1,505 +0,0 @@ -package polybft - -import ( - "fmt" - "math/big" - - "github.com/hashicorp/go-hclog" - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/fastrlp" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/crypto" - "github.com/xgr-network/xgr-node/types" -) - -const ( - // ExtraVanity represents a fixed number of extra-data bytes reserved for proposer vanity - ExtraVanity = 32 - - // ExtraSeal represents the fixed number of extra-data bytes reserved for proposer seal - ExtraSeal = 65 -) - -// PolyBFTMixDigest represents a hash of "PolyBFT Mix" to identify whether the block is from PolyBFT consensus engine -var PolyBFTMixDigest = types.StringToHash("adce6e5230abe012342a44e4e9b6d05997d6f015387ae0e59be924afc7ec70c1") - -// Extra defines the structure of the extra field for Istanbul -type Extra struct { - Validators *validator.ValidatorSetDelta - Parent *Signature - Committed *Signature - Checkpoint *CheckpointData -} - -// MarshalRLPTo defines the marshal function wrapper for Extra -func (i *Extra) MarshalRLPTo(dst []byte) []byte { - ar := &fastrlp.Arena{} - - return append(make([]byte, ExtraVanity), i.MarshalRLPWith(ar).MarshalTo(dst)...) -} - -// MarshalRLPWith defines the marshal function implementation for Extra -func (i *Extra) MarshalRLPWith(ar *fastrlp.Arena) *fastrlp.Value { - vv := ar.NewArray() - - // Validators - if i.Validators == nil { - vv.Set(ar.NewNullArray()) - } else { - vv.Set(i.Validators.MarshalRLPWith(ar)) - } - - // Parent Signatures - if i.Parent == nil { - vv.Set(ar.NewNullArray()) - } else { - vv.Set(i.Parent.MarshalRLPWith(ar)) - } - - // Committed Signatures - if i.Committed == nil { - vv.Set(ar.NewNullArray()) - } else { - vv.Set(i.Committed.MarshalRLPWith(ar)) - } - - // Checkpoint - if i.Checkpoint == nil { - vv.Set(ar.NewNullArray()) - } else { - vv.Set(i.Checkpoint.MarshalRLPWith(ar)) - } - - return vv -} - -// UnmarshalRLP defines the unmarshal function wrapper for Extra -func (i *Extra) UnmarshalRLP(input []byte) error { - return fastrlp.UnmarshalRLP(input[ExtraVanity:], i) -} - -// UnmarshalRLPWith defines the unmarshal implementation for Extra -func (i *Extra) UnmarshalRLPWith(v *fastrlp.Value) error { - const expectedElements = 4 - - elems, err := v.GetElems() - if err != nil { - return err - } - - if num := len(elems); num != expectedElements { - return fmt.Errorf("incorrect elements count to decode Extra, expected %d but found %d", expectedElements, num) - } - - // Validators - if elems[0].Elems() > 0 { - i.Validators = &validator.ValidatorSetDelta{} - if err := i.Validators.UnmarshalRLPWith(elems[0]); err != nil { - return err - } - } - - // Parent Signatures - if elems[1].Elems() > 0 { - i.Parent = &Signature{} - if err := i.Parent.UnmarshalRLPWith(elems[1]); err != nil { - return err - } - } - - // Committed Signatures - if elems[2].Elems() > 0 { - i.Committed = &Signature{} - if err := i.Committed.UnmarshalRLPWith(elems[2]); err != nil { - return err - } - } - - // Checkpoint - if elems[3].Elems() > 0 { - i.Checkpoint = &CheckpointData{} - if err := i.Checkpoint.UnmarshalRLPWith(elems[3]); err != nil { - return err - } - } - - return nil -} - -// ValidateFinalizedData contains extra data validations for finalized headers -func (i *Extra) ValidateFinalizedData(header *types.Header, parent *types.Header, parents []*types.Header, - chainID uint64, consensusBackend polybftBackend, domain []byte, logger hclog.Logger) error { - // validate committed signatures - blockNumber := header.Number - if i.Committed == nil { - return fmt.Errorf("failed to verify signatures for block %d, because signatures are not present", blockNumber) - } - - if i.Checkpoint == nil { - return fmt.Errorf("failed to verify signatures for block %d, because checkpoint data are not present", blockNumber) - } - - // validate current block signatures - checkpointHash, err := i.Checkpoint.Hash(chainID, blockNumber, header.Hash) - if err != nil { - return fmt.Errorf("failed to calculate proposal hash: %w", err) - } - - validators, err := consensusBackend.GetValidators(blockNumber-1, parents) - if err != nil { - return fmt.Errorf("failed to validate header for block %d. could not retrieve block validators:%w", blockNumber, err) - } - - if err := i.Committed.Verify(blockNumber, validators, checkpointHash, domain, logger); err != nil { - return fmt.Errorf("failed to verify signatures for block %d (proposal hash %s): %w", - blockNumber, checkpointHash, err) - } - - parentExtra, err := GetIbftExtra(parent.ExtraData) - if err != nil { - return fmt.Errorf("failed to verify signatures for block %d: %w", blockNumber, err) - } - - // validate parent signatures - if err := i.ValidateParentSignatures(blockNumber, consensusBackend, parents, - parent, parentExtra, chainID, domain, logger); err != nil { - return err - } - - return i.Checkpoint.ValidateBasic(parentExtra.Checkpoint) -} - -// ValidateParentSignatures validates signatures for parent block -func (i *Extra) ValidateParentSignatures(blockNumber uint64, consensusBackend polybftBackend, parents []*types.Header, - parent *types.Header, parentExtra *Extra, chainID uint64, domain []byte, logger hclog.Logger) error { - // skip block 1 because genesis does not have committed signatures - if blockNumber <= 1 { - return nil - } - - if i.Parent == nil { - return fmt.Errorf("failed to verify signatures for parent of block %d because signatures are not present", - blockNumber) - } - - parentValidators, err := consensusBackend.GetValidators(blockNumber-2, parents) - if err != nil { - return fmt.Errorf( - "failed to validate header for block %d. could not retrieve parent validators: %w", - blockNumber, - err, - ) - } - - parentCheckpointHash, err := parentExtra.Checkpoint.Hash(chainID, parent.Number, parent.Hash) - if err != nil { - return fmt.Errorf("failed to calculate parent proposal hash: %w", err) - } - - parentBlockNumber := blockNumber - 1 - if err := i.Parent.Verify(parentBlockNumber, parentValidators, parentCheckpointHash, domain, logger); err != nil { - return fmt.Errorf("failed to verify signatures for parent of block %d (proposal hash: %s): %w", - blockNumber, parentCheckpointHash, err) - } - - return nil -} - -// Signature represents aggregated signatures of signers accompanied with a bitmap -// (in order to be able to determine identities of each signer) -type Signature struct { - AggregatedSignature []byte - Bitmap []byte -} - -// MarshalRLPWith marshals Signature object into RLP format -func (s *Signature) MarshalRLPWith(ar *fastrlp.Arena) *fastrlp.Value { - committed := ar.NewArray() - if s.AggregatedSignature == nil { - committed.Set(ar.NewNull()) - } else { - committed.Set(ar.NewBytes(s.AggregatedSignature)) - } - - if s.Bitmap == nil { - committed.Set(ar.NewNull()) - } else { - committed.Set(ar.NewBytes(s.Bitmap)) - } - - return committed -} - -// UnmarshalRLPWith unmarshals Signature object from the RLP format -func (s *Signature) UnmarshalRLPWith(v *fastrlp.Value) error { - vals, err := v.GetElems() - if err != nil { - return fmt.Errorf("array type expected for signature struct") - } - - // there should be exactly two elements (aggregated signature and bitmap) - if num := len(vals); num != 2 { - return fmt.Errorf("incorrect elements count to decode Signature, expected 2 but found %d", num) - } - - s.AggregatedSignature, err = vals[0].GetBytes(nil) - if err != nil { - return err - } - - s.Bitmap, err = vals[1].GetBytes(nil) - if err != nil { - return err - } - - return nil -} - -// Verify is used to verify aggregated signature based on current validator set, message hash and domain -func (s *Signature) Verify(blockNumber uint64, validators validator.AccountSet, - hash types.Hash, domain []byte, logger hclog.Logger) error { - signers, err := validators.GetFilteredValidators(s.Bitmap) - if err != nil { - return err - } - - validatorSet := validator.NewValidatorSet(validators, logger) - if !validatorSet.HasQuorum(blockNumber, signers.GetAddressesAsSet()) { - return fmt.Errorf("quorum not reached") - } - - blsPublicKeys := make([]*bls.PublicKey, len(signers)) - for i, validator := range signers { - blsPublicKeys[i] = validator.BlsKey - } - - aggs, err := bls.UnmarshalSignature(s.AggregatedSignature) - if err != nil { - return err - } - - if !aggs.VerifyAggregated(blsPublicKeys, hash[:], domain) { - return fmt.Errorf("could not verify aggregated signature") - } - - return nil -} - -var checkpointDataABIType = abi.MustNewType(`tuple( - uint256 chainId, - uint256 blockNumber, - bytes32 blockHash, - uint256 blockRound, - uint256 epochNumber, - bytes32 eventRoot, - bytes32 currentValidatorsHash, - bytes32 nextValidatorsHash)`) - -// CheckpointData represents data needed for checkpointing mechanism -type CheckpointData struct { - BlockRound uint64 - EpochNumber uint64 - CurrentValidatorsHash types.Hash - NextValidatorsHash types.Hash - EventRoot types.Hash -} - -// MarshalRLPWith defines the marshal function implementation for CheckpointData -func (c *CheckpointData) MarshalRLPWith(ar *fastrlp.Arena) *fastrlp.Value { - vv := ar.NewArray() - // BlockRound - vv.Set(ar.NewUint(c.BlockRound)) - // EpochNumber - vv.Set(ar.NewUint(c.EpochNumber)) - // CurrentValidatorsHash - vv.Set(ar.NewBytes(c.CurrentValidatorsHash.Bytes())) - // NextValidatorsHash - vv.Set(ar.NewBytes(c.NextValidatorsHash.Bytes())) - // EventRoot - vv.Set(ar.NewBytes(c.EventRoot.Bytes())) - - return vv -} - -// UnmarshalRLPWith unmarshals CheckpointData object from the RLP format -func (c *CheckpointData) UnmarshalRLPWith(v *fastrlp.Value) error { - vals, err := v.GetElems() - if err != nil { - return fmt.Errorf("array type expected for CheckpointData struct") - } - - // there should be exactly 5 elements: - // BlockRound, EpochNumber, CurrentValidatorsHash, NextValidatorsHash, EventRoot - if num := len(vals); num != 5 { - return fmt.Errorf("incorrect elements count to decode CheckpointData, expected 5 but found %d", num) - } - - // BlockRound - c.BlockRound, err = vals[0].GetUint64() - if err != nil { - return err - } - - // EpochNumber - c.EpochNumber, err = vals[1].GetUint64() - if err != nil { - return err - } - - // CurrentValidatorsHash - currentValidatorsHashRaw, err := vals[2].GetBytes(nil) - if err != nil { - return err - } - - c.CurrentValidatorsHash = types.BytesToHash(currentValidatorsHashRaw) - - // NextValidatorsHash - nextValidatorsHashRaw, err := vals[3].GetBytes(nil) - if err != nil { - return err - } - - c.NextValidatorsHash = types.BytesToHash(nextValidatorsHashRaw) - - // EventRoot - eventRootRaw, err := vals[4].GetBytes(nil) - if err != nil { - return err - } - - c.EventRoot = types.BytesToHash(eventRootRaw) - - return nil -} - -// Copy returns deep copy of CheckpointData instance -func (c *CheckpointData) Copy() *CheckpointData { - newCheckpointData := new(CheckpointData) - *newCheckpointData = *c - - return newCheckpointData -} - -// Hash calculates keccak256 hash of the CheckpointData. -// CheckpointData is ABI encoded and then hashed. -func (c *CheckpointData) Hash(chainID uint64, blockNumber uint64, blockHash types.Hash) (types.Hash, error) { - checkpointMap := map[string]interface{}{ - "chainId": new(big.Int).SetUint64(chainID), - "blockNumber": new(big.Int).SetUint64(blockNumber), - "blockHash": blockHash, - "blockRound": new(big.Int).SetUint64(c.BlockRound), - "epochNumber": new(big.Int).SetUint64(c.EpochNumber), - "eventRoot": c.EventRoot, - "currentValidatorsHash": c.CurrentValidatorsHash, - "nextValidatorsHash": c.NextValidatorsHash, - } - - abiEncoded, err := checkpointDataABIType.Encode(checkpointMap) - if err != nil { - return types.ZeroHash, err - } - - return types.BytesToHash(crypto.Keccak256(abiEncoded)), nil -} - -// ValidateBasic encapsulates basic validation logic for checkpoint data. -// It only checks epoch numbers validity and whether validators hashes are non-empty. -func (c *CheckpointData) ValidateBasic(parentCheckpoint *CheckpointData) error { - if c.EpochNumber != parentCheckpoint.EpochNumber && - c.EpochNumber != parentCheckpoint.EpochNumber+1 { - // epoch-beginning block - // epoch number must be incremented by one compared to parent block's checkpoint - return fmt.Errorf("invalid epoch number for epoch-beginning block") - } - - if c.CurrentValidatorsHash == types.ZeroHash { - return fmt.Errorf("current validators hash must not be empty") - } - - if c.NextValidatorsHash == types.ZeroHash { - return fmt.Errorf("next validators hash must not be empty") - } - - return nil -} - -// Validate encapsulates validation logic for checkpoint data -// (with regards to current and next epoch validators) -func (c *CheckpointData) Validate(parentCheckpoint *CheckpointData, - currentValidators validator.AccountSet, nextValidators validator.AccountSet, - exitRootHash types.Hash) error { - if err := c.ValidateBasic(parentCheckpoint); err != nil { - return err - } - - // check if currentValidatorsHash, present in CheckpointData is correct - currentValidatorsHash, err := currentValidators.Hash() - if err != nil { - return fmt.Errorf("failed to calculate current validators hash: %w", err) - } - - if currentValidatorsHash != c.CurrentValidatorsHash { - return fmt.Errorf("current validators hashes don't match") - } - - // check if nextValidatorsHash, present in CheckpointData is correct - nextValidatorsHash, err := nextValidators.Hash() - if err != nil { - return fmt.Errorf("failed to calculate next validators hash: %w", err) - } - - if nextValidatorsHash != c.NextValidatorsHash { - return fmt.Errorf("next validators hashes don't match") - } - - // epoch ending blocks have validator set transitions - if !currentValidators.Equals(nextValidators) && - c.EpochNumber != parentCheckpoint.EpochNumber { - // epoch ending blocks should have the same epoch number as parent block - // (as they belong to the same epoch) - return fmt.Errorf("epoch number should not change for epoch-ending block") - } - - // exit root hash of proposer and - // validator that validates proposal have to match - if exitRootHash != c.EventRoot { - return fmt.Errorf("exit root hash not as expected") - } - - return nil -} - -// GetIbftExtraClean returns unmarshaled extra field from the passed in header, -// but without signatures for the given header (it only includes signatures for the parent block) -func GetIbftExtraClean(extraRaw []byte) ([]byte, error) { - extra, err := GetIbftExtra(extraRaw) - if err != nil { - return nil, err - } - - ibftExtra := &Extra{ - Parent: extra.Parent, - Validators: extra.Validators, - Checkpoint: extra.Checkpoint, - Committed: &Signature{}, - } - - return ibftExtra.MarshalRLPTo(nil), nil -} - -// GetIbftExtra returns the istanbul extra data field from the passed in header -func GetIbftExtra(extraRaw []byte) (*Extra, error) { - if len(extraRaw) < ExtraVanity { - return nil, fmt.Errorf("wrong extra size: %d", len(extraRaw)) - } - - extra := &Extra{} - - if err := extra.UnmarshalRLP(extraRaw); err != nil { - return nil, err - } - - return extra, nil -} diff --git a/consensus/polybft/extra_test.go b/consensus/polybft/extra_test.go deleted file mode 100644 index 259267f..0000000 --- a/consensus/polybft/extra_test.go +++ /dev/null @@ -1,779 +0,0 @@ -package polybft - -import ( - "crypto/rand" - "errors" - "fmt" - "math/big" - mrand "math/rand" - "testing" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/umbracle/fastrlp" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/crypto" - "github.com/xgr-network/xgr-node/types" -) - -func TestExtra_Encoding(t *testing.T) { - t.Parallel() - - digest := crypto.Keccak256([]byte("Dummy content to sign")) - keys := createRandomTestKeys(t, 2) - parentSig, err := keys[0].Sign(digest) - require.NoError(t, err) - - committedSig, err := keys[1].Sign(digest) - require.NoError(t, err) - - bmp := bitmap.Bitmap{} - bmp.Set(1) - bmp.Set(4) - - addedValidators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C"}).GetPublicIdentities() - - removedValidators := bitmap.Bitmap{} - removedValidators.Set(2) - - // different extra data for marshall/unmarshall - var cases = []struct { - extra *Extra - }{ - { - &Extra{}, - }, - { - &Extra{ - Validators: &validator.ValidatorSetDelta{}, - Parent: &Signature{}, - Committed: &Signature{}, - }, - }, - { - &Extra{ - Validators: &validator.ValidatorSetDelta{}, - }, - }, - { - &Extra{ - Validators: &validator.ValidatorSetDelta{ - Added: addedValidators, - }, - Parent: &Signature{}, - Committed: &Signature{}, - }, - }, - { - &Extra{ - Validators: &validator.ValidatorSetDelta{ - Removed: removedValidators, - }, - Parent: &Signature{AggregatedSignature: parentSig, Bitmap: bmp}, - Committed: &Signature{}, - }, - }, - { - &Extra{ - Validators: &validator.ValidatorSetDelta{ - Added: addedValidators, - Updated: addedValidators[1:], - Removed: removedValidators, - }, - Parent: &Signature{}, - Committed: &Signature{AggregatedSignature: committedSig, Bitmap: bmp}, - }, - }, - { - &Extra{ - Parent: &Signature{AggregatedSignature: parentSig, Bitmap: bmp}, - Committed: &Signature{AggregatedSignature: committedSig, Bitmap: bmp}, - }, - }, - { - &Extra{ - Parent: &Signature{AggregatedSignature: parentSig, Bitmap: bmp}, - Committed: &Signature{AggregatedSignature: committedSig, Bitmap: bmp}, - Checkpoint: &CheckpointData{ - BlockRound: 0, - EpochNumber: 3, - CurrentValidatorsHash: types.BytesToHash(generateRandomBytes(t)), - NextValidatorsHash: types.BytesToHash(generateRandomBytes(t)), - EventRoot: types.BytesToHash(generateRandomBytes(t)), - }, - }, - }, - } - - for _, c := range cases { - data := c.extra.MarshalRLPTo(nil) - extra := &Extra{} - assert.NoError(t, extra.UnmarshalRLP(data)) - assert.Equal(t, c.extra, extra) - } -} - -func TestExtra_UnmarshalRLPWith_NegativeCases(t *testing.T) { - t.Parallel() - - t.Run("Incorrect RLP marshalled data type", func(t *testing.T) { - t.Parallel() - - extra := &Extra{} - ar := &fastrlp.Arena{} - require.Error(t, extra.UnmarshalRLPWith(ar.NewBool(false))) - }) - - t.Run("Incorrect count of RLP marshalled array elements", func(t *testing.T) { - t.Parallel() - - extra := &Extra{} - ar := &fastrlp.Arena{} - require.ErrorContains(t, extra.UnmarshalRLPWith(ar.NewArray()), "incorrect elements count to decode Extra, expected 4 but found 0") - }) - - t.Run("Incorrect ValidatorSetDelta marshalled", func(t *testing.T) { - t.Parallel() - - extra := &Extra{} - ar := &fastrlp.Arena{} - extraMarshalled := ar.NewArray() - deltaMarshalled := ar.NewArray() - deltaMarshalled.Set(ar.NewBytes([]byte{0x73})) - extraMarshalled.Set(deltaMarshalled) // ValidatorSetDelta - extraMarshalled.Set(ar.NewBytes([]byte{})) // Seal - extraMarshalled.Set(ar.NewBytes([]byte{})) // Parent - extraMarshalled.Set(ar.NewBytes([]byte{})) // Committed - require.Error(t, extra.UnmarshalRLPWith(extraMarshalled)) - }) - - t.Run("Incorrect Seal marshalled", func(t *testing.T) { - t.Parallel() - - extra := &Extra{} - ar := &fastrlp.Arena{} - extraMarshalled := ar.NewArray() - deltaMarshalled := new(validator.ValidatorSetDelta).MarshalRLPWith(ar) - extraMarshalled.Set(deltaMarshalled) // ValidatorSetDelta - extraMarshalled.Set(ar.NewBytes([]byte{})) // Parent - extraMarshalled.Set(ar.NewBytes([]byte{})) // Committed - require.Error(t, extra.UnmarshalRLPWith(extraMarshalled)) - }) - - t.Run("Incorrect Parent signatures marshalled", func(t *testing.T) { - t.Parallel() - - extra := &Extra{} - ar := &fastrlp.Arena{} - extraMarshalled := ar.NewArray() - deltaMarshalled := new(validator.ValidatorSetDelta).MarshalRLPWith(ar) - extraMarshalled.Set(deltaMarshalled) // ValidatorSetDelta - extraMarshalled.Set(ar.NewBytes([]byte{})) // Seal - // Parent - parentArr := ar.NewArray() - parentArr.Set(ar.NewBytes([]byte{})) - extraMarshalled.Set(parentArr) - extraMarshalled.Set(ar.NewBytes([]byte{})) // Committed - require.Error(t, extra.UnmarshalRLPWith(extraMarshalled)) - }) - - t.Run("Incorrect Committed signatures marshalled", func(t *testing.T) { - t.Parallel() - - extra := &Extra{} - ar := &fastrlp.Arena{} - extraMarshalled := ar.NewArray() - deltaMarshalled := new(validator.ValidatorSetDelta).MarshalRLPWith(ar) - extraMarshalled.Set(deltaMarshalled) // ValidatorSetDelta - extraMarshalled.Set(ar.NewBytes([]byte{})) // Seal - - // Parent - key, err := wallet.GenerateAccount() - require.NoError(t, err) - - parentSignature := createSignature(t, []*wallet.Account{key}, types.BytesToHash([]byte("This is test hash")), signer.DomainCheckpointManager) - extraMarshalled.Set(parentSignature.MarshalRLPWith(ar)) - - // Committed - committedArr := ar.NewArray() - committedArr.Set(ar.NewBytes([]byte{})) - extraMarshalled.Set(committedArr) - require.Error(t, extra.UnmarshalRLPWith(extraMarshalled)) - }) - - t.Run("Incorrect Checkpoint data marshalled", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - extraMarshalled := ar.NewArray() - deltaMarshalled := new(validator.ValidatorSetDelta).MarshalRLPWith(ar) - extraMarshalled.Set(deltaMarshalled) // ValidatorSetDelta - extraMarshalled.Set(ar.NewBytes([]byte{})) // Seal - - // Parent - key, err := wallet.GenerateAccount() - require.NoError(t, err) - - parentSignature := createSignature(t, []*wallet.Account{key}, types.BytesToHash(generateRandomBytes(t)), signer.DomainCheckpointManager) - extraMarshalled.Set(parentSignature.MarshalRLPWith(ar)) - - // Committed - committedSignature := createSignature(t, []*wallet.Account{key}, types.BytesToHash(generateRandomBytes(t)), signer.DomainCheckpointManager) - extraMarshalled.Set(committedSignature.MarshalRLPWith(ar)) - - // Checkpoint data - checkpointDataArr := ar.NewArray() - checkpointDataArr.Set(ar.NewBytes(generateRandomBytes(t))) - extraMarshalled.Set(checkpointDataArr) - - extra := &Extra{} - require.Error(t, extra.UnmarshalRLPWith(extraMarshalled)) - }) -} - -func TestExtra_ValidateFinalizedData_UnhappyPath(t *testing.T) { - t.Parallel() - - const ( - headerNum = 10 - chainID = uint64(20) - ) - - header := &types.Header{ - Number: headerNum, - Hash: types.BytesToHash(generateRandomBytes(t)), - } - parent := &types.Header{ - Number: headerNum - 1, - Hash: types.BytesToHash(generateRandomBytes(t)), - } - - validators := validator.NewTestValidators(t, 6) - - polyBackendMock := new(polybftBackendMock) - polyBackendMock.On("GetValidators", mock.Anything, mock.Anything).Return(nil, errors.New("validators not found")) - - // missing Committed field - extra := &Extra{} - err := extra.ValidateFinalizedData( - header, parent, nil, chainID, nil, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.ErrorContains(t, err, fmt.Sprintf("failed to verify signatures for block %d, because signatures are not present", headerNum)) - - // missing Checkpoint field - extra = &Extra{Committed: &Signature{}} - err = extra.ValidateFinalizedData( - header, parent, nil, chainID, polyBackendMock, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.ErrorContains(t, err, fmt.Sprintf("failed to verify signatures for block %d, because checkpoint data are not present", headerNum)) - - // failed to retrieve validators from snapshot - checkpoint := &CheckpointData{ - EpochNumber: 10, - BlockRound: 2, - EventRoot: types.BytesToHash(generateRandomBytes(t)), - } - extra = &Extra{Committed: &Signature{}, Checkpoint: checkpoint} - err = extra.ValidateFinalizedData( - header, parent, nil, chainID, polyBackendMock, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.ErrorContains(t, err, - fmt.Sprintf("failed to validate header for block %d. could not retrieve block validators:validators not found", headerNum)) - - // failed to verify signatures (quorum not reached) - polyBackendMock = new(polybftBackendMock) - polyBackendMock.On("GetValidators", mock.Anything, mock.Anything).Return(validators.GetPublicIdentities()) - - noQuorumSignature := createSignature(t, validators.GetPrivateIdentities("0", "1"), types.BytesToHash([]byte("FooBar")), signer.DomainCheckpointManager) - extra = &Extra{Committed: noQuorumSignature, Checkpoint: checkpoint} - checkpointHash, err := checkpoint.Hash(chainID, headerNum, header.Hash) - require.NoError(t, err) - - err = extra.ValidateFinalizedData( - header, parent, nil, chainID, polyBackendMock, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.ErrorContains(t, err, - fmt.Sprintf("failed to verify signatures for block %d (proposal hash %s): quorum not reached", headerNum, checkpointHash)) - - // incorrect parent extra size - validSignature := createSignature(t, validators.GetPrivateIdentities(), checkpointHash, signer.DomainCheckpointManager) - extra = &Extra{Committed: validSignature, Checkpoint: checkpoint} - err = extra.ValidateFinalizedData( - header, parent, nil, chainID, polyBackendMock, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.ErrorContains(t, err, - fmt.Sprintf("failed to verify signatures for block %d: wrong extra size: 0", headerNum)) -} - -func TestExtra_ValidateParentSignatures(t *testing.T) { - t.Parallel() - - const ( - chainID = 15 - headerNum = 23 - ) - - polyBackendMock := new(polybftBackendMock) - polyBackendMock.On("GetValidators", mock.Anything, mock.Anything).Return(nil, errors.New("no validators")) - - // validation is skipped for blocks 0 and 1 - extra := &Extra{} - err := extra.ValidateParentSignatures( - 1, polyBackendMock, nil, nil, nil, chainID, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.NoError(t, err) - - // parent signatures not present - err = extra.ValidateParentSignatures( - headerNum, polyBackendMock, nil, nil, nil, chainID, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.ErrorContains(t, err, fmt.Sprintf("failed to verify signatures for parent of block %d because signatures are not present", headerNum)) - - // validators not found - validators := validator.NewTestValidators(t, 5) - incorrectHash := types.BytesToHash([]byte("Hello World")) - invalidSig := createSignature(t, validators.GetPrivateIdentities(), incorrectHash, signer.DomainCheckpointManager) - extra = &Extra{Parent: invalidSig} - err = extra.ValidateParentSignatures( - headerNum, polyBackendMock, nil, nil, nil, chainID, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.ErrorContains(t, err, - fmt.Sprintf("failed to validate header for block %d. could not retrieve parent validators: no validators", headerNum)) - - // incorrect hash is signed - polyBackendMock = new(polybftBackendMock) - polyBackendMock.On("GetValidators", mock.Anything, mock.Anything).Return(validators.GetPublicIdentities()) - - parent := &types.Header{Number: headerNum - 1, Hash: types.BytesToHash(generateRandomBytes(t))} - parentCheckpoint := &CheckpointData{EpochNumber: 3, BlockRound: 5} - parentExtra := &Extra{Checkpoint: parentCheckpoint} - - parentCheckpointHash, err := parentCheckpoint.Hash(chainID, parent.Number, parent.Hash) - require.NoError(t, err) - - err = extra.ValidateParentSignatures( - headerNum, polyBackendMock, nil, parent, parentExtra, chainID, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.ErrorContains(t, err, - fmt.Sprintf("failed to verify signatures for parent of block %d (proposal hash: %s): could not verify aggregated signature", headerNum, parentCheckpointHash)) - - // valid signature provided - validSig := createSignature(t, validators.GetPrivateIdentities(), parentCheckpointHash, signer.DomainCheckpointManager) - extra = &Extra{Parent: validSig} - err = extra.ValidateParentSignatures( - headerNum, polyBackendMock, nil, parent, parentExtra, chainID, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.NoError(t, err) -} - -func TestSignature_Verify(t *testing.T) { - t.Parallel() - - t.Run("Valid signatures", func(t *testing.T) { - t.Parallel() - - numValidators := 100 - msgHash := types.Hash{0x1} - - vals := validator.NewTestValidators(t, numValidators) - validatorsMetadata := vals.GetPublicIdentities() - validatorSet := vals.ToValidatorSet() - - var signatures bls.Signatures - bitmap := bitmap.Bitmap{} - signers := make(map[types.Address]struct{}, len(validatorsMetadata)) - - for i, val := range vals.GetValidators() { - bitmap.Set(uint64(i)) - - tempSign, err := val.Account.Bls.Sign(msgHash[:], signer.DomainCheckpointManager) - require.NoError(t, err) - - signatures = append(signatures, tempSign) - aggs, err := signatures.Aggregate().Marshal() - assert.NoError(t, err) - - s := &Signature{ - AggregatedSignature: aggs, - Bitmap: bitmap, - } - - err = s.Verify(10, validatorsMetadata, msgHash, signer.DomainCheckpointManager, hclog.NewNullLogger()) - signers[val.Address()] = struct{}{} - - if !validatorSet.HasQuorum(10, signers) { - assert.ErrorContains(t, err, "quorum not reached", "failed for %d", i) - } else { - assert.NoError(t, err) - } - } - }) - - t.Run("Invalid bitmap provided", func(t *testing.T) { - t.Parallel() - - validatorSet := validator.NewTestValidators(t, 3).GetPublicIdentities() - bmp := bitmap.Bitmap{} - - // Make bitmap invalid, by setting some flag larger than length of validator set to 1 - bmp.Set(uint64(validatorSet.Len() + 1)) - s := &Signature{Bitmap: bmp} - - err := s.Verify(0, validatorSet, types.Hash{0x1}, signer.DomainCheckpointManager, hclog.NewNullLogger()) - require.Error(t, err) - }) -} - -func TestSignature_UnmarshalRLPWith_NegativeCases(t *testing.T) { - t.Parallel() - - t.Run("Incorrect RLP marshalled data type", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - signature := Signature{} - require.ErrorContains(t, signature.UnmarshalRLPWith(ar.NewNull()), "array type expected for signature struct") - }) - - t.Run("Incorrect AggregatedSignature field data type", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - signature := Signature{} - signatureMarshalled := ar.NewArray() - signatureMarshalled.Set(ar.NewNull()) - signatureMarshalled.Set(ar.NewNull()) - require.ErrorContains(t, signature.UnmarshalRLPWith(signatureMarshalled), "value is not of type bytes") - }) - - t.Run("Incorrect Bitmap field data type", func(t *testing.T) { - ar := &fastrlp.Arena{} - signature := Signature{} - signatureMarshalled := ar.NewArray() - signatureMarshalled.Set(ar.NewBytes([]byte{0x5, 0x90})) - signatureMarshalled.Set(ar.NewNull()) - require.ErrorContains(t, signature.UnmarshalRLPWith(signatureMarshalled), "value is not of type bytes") - }) -} - -func TestSignature_VerifyRandom(t *testing.T) { - t.Parallel() - - numValidators := 100 - vals := validator.NewTestValidators(t, numValidators) - msgHash := types.Hash{0x1} - - var signature bls.Signatures - - bitmap := bitmap.Bitmap{} - valIndxsRnd := mrand.Perm(numValidators)[:numValidators*2/3+1] - - accounts := vals.GetValidators() - - for _, index := range valIndxsRnd { - bitmap.Set(uint64(index)) - - tempSign, err := accounts[index].Account.Bls.Sign(msgHash[:], signer.DomainCheckpointManager) - require.NoError(t, err) - - signature = append(signature, tempSign) - } - - aggs, err := signature.Aggregate().Marshal() - require.NoError(t, err) - - s := &Signature{ - AggregatedSignature: aggs, - Bitmap: bitmap, - } - - err = s.Verify(1, vals.GetPublicIdentities(), msgHash, signer.DomainCheckpointManager, hclog.NewNullLogger()) - assert.NoError(t, err) -} - -func TestExtra_InitGenesisValidatorsDelta(t *testing.T) { - t.Parallel() - - t.Run("Happy path", func(t *testing.T) { - t.Parallel() - - const validatorsCount = 7 - vals := validator.NewTestValidators(t, validatorsCount) - - delta := &validator.ValidatorSetDelta{ - Added: make(validator.AccountSet, validatorsCount), - Removed: bitmap.Bitmap{}, - } - - var i int - for _, val := range vals.Validators { - delta.Added[i] = &validator.ValidatorMetadata{ - Address: types.Address(val.Account.Ecdsa.Address()), - BlsKey: val.Account.Bls.PublicKey(), - VotingPower: new(big.Int).SetUint64(val.VotingPower), - } - i++ - } - - extra := Extra{Validators: delta} - - genesis := &chain.Genesis{ - ExtraData: extra.MarshalRLPTo(nil), - } - - genesisExtra, err := GetIbftExtra(genesis.ExtraData) - assert.NoError(t, err) - assert.Len(t, genesisExtra.Validators.Added, validatorsCount) - assert.Empty(t, genesisExtra.Validators.Removed) - }) - - t.Run("Invalid Extra data", func(t *testing.T) { - t.Parallel() - - genesis := &chain.Genesis{ - ExtraData: append(make([]byte, ExtraVanity), []byte{0x2, 0x3}...), - } - - _, err := GetIbftExtra(genesis.ExtraData) - - require.Error(t, err) - }) -} - -func Test_GetIbftExtraClean(t *testing.T) { - t.Parallel() - - key, err := wallet.GenerateAccount() - require.NoError(t, err) - - extra := &Extra{ - Validators: &validator.ValidatorSetDelta{ - Added: validator.AccountSet{ - &validator.ValidatorMetadata{ - Address: types.BytesToAddress([]byte{11, 22}), - BlsKey: key.Bls.PublicKey(), - VotingPower: new(big.Int).SetUint64(1000), - IsActive: true, - }, - }, - }, - Committed: &Signature{ - AggregatedSignature: []byte{23, 24}, - Bitmap: []byte{11}, - }, - Parent: &Signature{ - AggregatedSignature: []byte{0, 1}, - Bitmap: []byte{1}, - }, - Checkpoint: &CheckpointData{ - BlockRound: 1, - EpochNumber: 1, - CurrentValidatorsHash: types.BytesToHash([]byte{2, 3}), - NextValidatorsHash: types.BytesToHash([]byte{4, 5}), - EventRoot: types.BytesToHash([]byte{6, 7}), - }, - } - - extraClean, err := GetIbftExtraClean(extra.MarshalRLPTo(nil)) - require.NoError(t, err) - - extraTwo := &Extra{} - require.NoError(t, extraTwo.UnmarshalRLP(extraClean)) - require.True(t, extra.Validators.Equals(extra.Validators)) - require.Equal(t, extra.Checkpoint.BlockRound, extraTwo.Checkpoint.BlockRound) - require.Equal(t, extra.Checkpoint.EpochNumber, extraTwo.Checkpoint.EpochNumber) - require.Equal(t, extra.Checkpoint.CurrentValidatorsHash, extraTwo.Checkpoint.CurrentValidatorsHash) - require.Equal(t, extra.Checkpoint.NextValidatorsHash, extraTwo.Checkpoint.NextValidatorsHash) - require.Equal(t, extra.Checkpoint.NextValidatorsHash, extraTwo.Checkpoint.NextValidatorsHash) - require.Equal(t, extra.Parent.AggregatedSignature, extraTwo.Parent.AggregatedSignature) - require.Equal(t, extra.Parent.Bitmap, extraTwo.Parent.Bitmap) - - require.Nil(t, extraTwo.Committed.AggregatedSignature) - require.Nil(t, extraTwo.Committed.Bitmap) -} - -func Test_GetIbftExtraClean_Fail(t *testing.T) { - t.Parallel() - - randomBytes := [ExtraVanity]byte{} - _, err := rand.Read(randomBytes[:]) - require.NoError(t, err) - - extra, err := GetIbftExtraClean(append(randomBytes[:], []byte{0x12, 0x6}...)) - require.Error(t, err) - require.Nil(t, extra) -} - -func TestCheckpointData_Hash(t *testing.T) { - const ( - chainID = uint64(1) - blockNumber = uint64(27) - ) - - blockHash := types.BytesToHash(generateRandomBytes(t)) - origCheckpoint := &CheckpointData{ - BlockRound: 0, - EpochNumber: 3, - CurrentValidatorsHash: types.BytesToHash(generateRandomBytes(t)), - NextValidatorsHash: types.BytesToHash(generateRandomBytes(t)), - EventRoot: types.BytesToHash(generateRandomBytes(t)), - } - copyCheckpoint := &CheckpointData{} - *copyCheckpoint = *origCheckpoint - - origHash, err := origCheckpoint.Hash(chainID, blockNumber, blockHash) - require.NoError(t, err) - - copyHash, err := copyCheckpoint.Hash(chainID, blockNumber, blockHash) - require.NoError(t, err) - - require.Equal(t, origHash, copyHash) -} - -func TestCheckpointData_Validate(t *testing.T) { - t.Parallel() - - currentValidators := validator.NewTestValidators(t, 5).GetPublicIdentities() - nextValidators := validator.NewTestValidators(t, 3).GetPublicIdentities() - - currentValidatorsHash, err := currentValidators.Hash() - require.NoError(t, err) - - nextValidatorsHash, err := nextValidators.Hash() - require.NoError(t, err) - - cases := []struct { - name string - parentEpochNumber uint64 - epochNumber uint64 - currentValidators validator.AccountSet - nextValidators validator.AccountSet - currentValidatorsHash types.Hash - nextValidatorsHash types.Hash - exitRootHash types.Hash - errString string - }{ - { - name: "Valid (validator set changes)", - parentEpochNumber: 2, - epochNumber: 2, - currentValidators: currentValidators, - nextValidators: nextValidators, - currentValidatorsHash: currentValidatorsHash, - nextValidatorsHash: nextValidatorsHash, - errString: "", - }, - { - name: "Valid (validator set remains the same)", - parentEpochNumber: 2, - epochNumber: 2, - currentValidators: currentValidators, - nextValidators: currentValidators, - currentValidatorsHash: currentValidatorsHash, - nextValidatorsHash: currentValidatorsHash, - errString: "", - }, - { - name: "Invalid (gap in epoch numbers)", - parentEpochNumber: 2, - epochNumber: 6, - errString: "invalid epoch number for epoch-beginning block", - }, - { - name: "Invalid (empty currentValidatorsHash)", - currentValidators: currentValidators, - nextValidators: currentValidators, - errString: "current validators hash must not be empty", - }, - { - name: "Invalid (empty nextValidatorsHash)", - currentValidators: currentValidators, - nextValidators: currentValidators, - currentValidatorsHash: currentValidatorsHash, - errString: "next validators hash must not be empty", - }, - { - name: "Invalid (incorrect currentValidatorsHash)", - currentValidators: currentValidators, - nextValidators: currentValidators, - currentValidatorsHash: nextValidatorsHash, - nextValidatorsHash: nextValidatorsHash, - errString: "current validators hashes don't match", - }, - { - name: "Invalid (incorrect nextValidatorsHash)", - currentValidators: nextValidators, - nextValidators: nextValidators, - currentValidatorsHash: nextValidatorsHash, - nextValidatorsHash: currentValidatorsHash, - errString: "next validators hashes don't match", - }, - { - name: "Invalid (validator set and epoch numbers change)", - parentEpochNumber: 2, - epochNumber: 3, - currentValidators: currentValidators, - nextValidators: nextValidators, - currentValidatorsHash: currentValidatorsHash, - nextValidatorsHash: nextValidatorsHash, - errString: "epoch number should not change for epoch-ending block", - }, - { - name: "Invalid exit root hash", - parentEpochNumber: 2, - epochNumber: 2, - currentValidators: currentValidators, - nextValidators: currentValidators, - currentValidatorsHash: currentValidatorsHash, - nextValidatorsHash: currentValidatorsHash, - exitRootHash: types.BytesToHash([]byte{0, 1, 2, 3, 4, 5, 6, 7}), - errString: "exit root hash not as expected", - }, - } - - for _, c := range cases { - c := c - t.Run(c.name, func(t *testing.T) { - t.Parallel() - checkpoint := &CheckpointData{ - EpochNumber: c.epochNumber, - CurrentValidatorsHash: c.currentValidatorsHash, - NextValidatorsHash: c.nextValidatorsHash, - EventRoot: c.exitRootHash, - } - parentCheckpoint := &CheckpointData{EpochNumber: c.parentEpochNumber} - err := checkpoint.Validate(parentCheckpoint, c.currentValidators, c.nextValidators, types.ZeroHash) - - if c.errString != "" { - require.ErrorContains(t, err, c.errString) - } else { - require.NoError(t, err) - } - }) - } -} - -func TestCheckpointData_Copy(t *testing.T) { - t.Parallel() - - validatorAccs := validator.NewTestValidators(t, 5) - currentValidatorsHash, err := validatorAccs.GetPublicIdentities("0", "1", "2").Hash() - require.NoError(t, err) - - nextValidatorsHash, err := validatorAccs.GetPublicIdentities("1", "3", "4").Hash() - require.NoError(t, err) - - eventRoot := generateRandomBytes(t) - original := &CheckpointData{ - BlockRound: 1, - EpochNumber: 5, - CurrentValidatorsHash: currentValidatorsHash, - NextValidatorsHash: nextValidatorsHash, - EventRoot: types.BytesToHash(eventRoot), - } - - copied := original.Copy() - require.Equal(t, original, copied) - require.NotSame(t, original, copied) - - // alter arbitrary field on copied instance - copied.BlockRound = 10 - require.NotEqual(t, original.BlockRound, copied.BlockRound) -} diff --git a/consensus/polybft/fsm.go b/consensus/polybft/fsm.go deleted file mode 100644 index 2269824..0000000 --- a/consensus/polybft/fsm.go +++ /dev/null @@ -1,717 +0,0 @@ -package polybft - -import ( - "bytes" - "errors" - "fmt" - "math/big" - "time" - - "github.com/0xPolygon/go-ibft/messages" - "github.com/0xPolygon/go-ibft/messages/proto" - "github.com/armon/go-metrics" - hcf "github.com/hashicorp/go-hclog" - - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/state" - "github.com/xgr-network/xgr-node/types" -) - -type blockBuilder interface { - Reset() error - WriteTx(*types.Transaction) error - Fill() - Build(func(h *types.Header)) (*types.FullBlock, error) - GetState() *state.Transition - Receipts() []*types.Receipt -} - -var ( - errCommitEpochTxDoesNotExist = errors.New("commit epoch transaction is not found in the epoch ending block") - errCommitEpochTxNotExpected = errors.New("didn't expect commit epoch transaction in a non epoch ending block") - errCommitEpochTxSingleExpected = errors.New("only one commit epoch transaction is allowed " + - "in an epoch ending block") - errDistributeRewardsTxDoesNotExist = errors.New("distribute rewards transaction is " + - "not found in the epoch ending block") - errDistributeRewardsTxNotExpected = errors.New("didn't expect distribute rewards transaction " + - "in a non epoch ending block") - errDistributeRewardsTxSingleExpected = errors.New("only one distribute rewards transaction is " + - "allowed in an epoch ending block") - errProposalDontMatch = errors.New("failed to insert proposal, because the validated proposal " + - "is either nil or it does not match the received one") - errValidatorSetDeltaMismatch = errors.New("validator set delta mismatch") - errValidatorsUpdateInNonEpochEnding = errors.New("trying to update validator set in a non epoch ending block") - errValidatorDeltaNilInEpochEndingBlock = errors.New("validator set delta is nil in epoch ending block") -) - -type fsm struct { - // PolyBFT consensus protocol configuration - config *PolyBFTConfig - - // parent block header - parent *types.Header - - // backend implements methods for retrieving data from block chain - backend blockchainBackend - - // polybftBackend implements methods needed from the polybft - polybftBackend polybftBackend - - // validators is the list of validators for this round - validators validator.ValidatorSet - - // proposerSnapshot keeps information about new proposer - proposerSnapshot *ProposerSnapshot - - // blockBuilder is the block builder for proposers - blockBuilder blockBuilder - - // epochNumber denotes current epoch number - epochNumber uint64 - - // commitEpochInput holds info about a single epoch - // It is populated only for epoch-ending blocks. - commitEpochInput *contractsapi.CommitEpochValidatorSetFn - - // distributeRewardsInput holds info about validators work in a single epoch - // mainly, how many blocks they signed during given epoch - // It is populated only for epoch-ending blocks. - distributeRewardsInput *contractsapi.DistributeRewardForRewardPoolFn - - // isEndOfEpoch indicates if epoch reached its end - isEndOfEpoch bool - - // isEndOfSprint indicates if sprint reached its end - isEndOfSprint bool - - // proposerCommitmentToRegister is a commitment that is registered via state transaction by proposer - proposerCommitmentToRegister *CommitmentMessageSigned - - // logger instance - logger hcf.Logger - - // target is the block being computed - target *types.FullBlock - - // exitEventRootHash is the calculated root hash for given checkpoint block - exitEventRootHash types.Hash - - // newValidatorsDelta carries the updates of validator set on epoch ending block - newValidatorsDelta *validator.ValidatorSetDelta -} - -// BuildProposal builds a proposal for the current round (used if proposer) -func (f *fsm) BuildProposal(currentRound uint64) ([]byte, error) { - start := time.Now().UTC() - defer metrics.SetGauge([]string{consensusMetricsPrefix, "block_building_time"}, - float32(time.Now().UTC().Sub(start).Seconds())) - - parent := f.parent - - extraParent, err := GetIbftExtra(parent.ExtraData) - if err != nil { - return nil, err - } - - extra := &Extra{Parent: extraParent.Committed} - // for non-epoch ending blocks, currentValidatorsHash is the same as the nextValidatorsHash - nextValidators := f.validators.Accounts() - - if err := f.blockBuilder.Reset(); err != nil { - return nil, fmt.Errorf("failed to initialize block builder: %w", err) - } - - if f.isEndOfEpoch { - tx, err := f.createCommitEpochTx() - if err != nil { - return nil, err - } - - if err := f.blockBuilder.WriteTx(tx); err != nil { - return nil, fmt.Errorf("failed to apply commit epoch transaction: %w", err) - } - - tx, err = f.createDistributeRewardsTx() - if err != nil { - return nil, err - } - - if err := f.blockBuilder.WriteTx(tx); err != nil { - return nil, fmt.Errorf("failed to apply distribute rewards transaction: %w", err) - } - } - - if f.config.IsBridgeEnabled() { - if err := f.applyBridgeCommitmentTx(); err != nil { - return nil, err - } - } - - // fill the block with transactions - f.blockBuilder.Fill() - - if f.isEndOfEpoch { - nextValidators, err = nextValidators.ApplyDelta(f.newValidatorsDelta) - if err != nil { - return nil, err - } - - extra.Validators = f.newValidatorsDelta - } - - currentValidatorsHash, err := f.validators.Accounts().Hash() - if err != nil { - return nil, err - } - - nextValidatorsHash, err := nextValidators.Hash() - if err != nil { - return nil, err - } - - extra.Checkpoint = &CheckpointData{ - BlockRound: currentRound, - EpochNumber: f.epochNumber, - CurrentValidatorsHash: currentValidatorsHash, - NextValidatorsHash: nextValidatorsHash, - EventRoot: f.exitEventRootHash, - } - - f.logger.Debug("[Build Proposal]", "Current validators hash", currentValidatorsHash, - "Next validators hash", nextValidatorsHash) - - stateBlock, err := f.blockBuilder.Build(func(h *types.Header) { - h.ExtraData = extra.MarshalRLPTo(nil) - h.MixHash = PolyBFTMixDigest - }) - - if err != nil { - return nil, err - } - - if f.logger.IsDebug() { - checkpointHash, err := extra.Checkpoint.Hash(f.backend.GetChainID(), f.Height(), stateBlock.Block.Hash()) - if err != nil { - return nil, fmt.Errorf("failed to calculate proposal hash: %w", err) - } - - f.logger.Debug("[FSM Build Proposal]", - "txs", len(stateBlock.Block.Transactions), - "proposal hash", checkpointHash.String()) - } - - f.target = stateBlock - - return stateBlock.Block.MarshalRLP(), nil -} - -// applyBridgeCommitmentTx builds state transaction which contains data for bridge commitment registration -func (f *fsm) applyBridgeCommitmentTx() error { - if f.proposerCommitmentToRegister != nil { - bridgeCommitmentTx, err := f.createBridgeCommitmentTx() - if err != nil { - return fmt.Errorf("creation of bridge commitment transaction failed: %w", err) - } - - if err := f.blockBuilder.WriteTx(bridgeCommitmentTx); err != nil { - return fmt.Errorf("failed to apply bridge commitment state transaction. Error: %w", err) - } - } - - return nil -} - -// createBridgeCommitmentTx builds bridge commitment registration transaction -func (f *fsm) createBridgeCommitmentTx() (*types.Transaction, error) { - inputData, err := f.proposerCommitmentToRegister.EncodeAbi() - if err != nil { - return nil, fmt.Errorf("failed to encode input data for bridge commitment registration: %w", err) - } - - return createStateTransactionWithData(f.Height(), contracts.StateReceiverContract, inputData), nil -} - -// getValidatorsTransition applies delta to the current validators, -func (f *fsm) getValidatorsTransition(delta *validator.ValidatorSetDelta) (validator.AccountSet, error) { - nextValidators, err := f.validators.Accounts().ApplyDelta(delta) - if err != nil { - return nil, err - } - - f.logger.Debug("getValidatorsTransition", "Next validators", nextValidators) - - return nextValidators, nil -} - -// createCommitEpochTx create a StateTransaction, which invokes ValidatorSet smart contract -// and sends all the necessary metadata to it. -func (f *fsm) createCommitEpochTx() (*types.Transaction, error) { - input, err := f.commitEpochInput.EncodeAbi() - if err != nil { - return nil, err - } - - return createStateTransactionWithData(f.Height(), contracts.ValidatorSetContract, input), nil -} - -// createDistributeRewardsTx create a StateTransaction, which invokes RewardPool smart contract -// and sends all the necessary metadata to it. -func (f *fsm) createDistributeRewardsTx() (*types.Transaction, error) { - input, err := f.distributeRewardsInput.EncodeAbi() - if err != nil { - return nil, err - } - - return createStateTransactionWithData(f.Height(), contracts.RewardPoolContract, input), nil -} - -// ValidateCommit is used to validate that a given commit is valid -func (f *fsm) ValidateCommit(signerAddr []byte, seal []byte, proposalHash []byte) error { - from := types.BytesToAddress(signerAddr) - - validator := f.validators.Accounts().GetValidatorMetadata(from) - if validator == nil { - return fmt.Errorf("unable to resolve validator %s", from) - } - - signature, err := bls.UnmarshalSignature(seal) - if err != nil { - return fmt.Errorf("failed to unmarshall signature: %w", err) - } - - if !signature.Verify(validator.BlsKey, proposalHash, signer.DomainCheckpointManager) { - return fmt.Errorf("incorrect commit signature from %s", from) - } - - return nil -} - -// Validate validates a raw proposal (used if non-proposer) -func (f *fsm) Validate(proposal []byte) error { - var block types.Block - if err := block.UnmarshalRLP(proposal); err != nil { - return fmt.Errorf("failed to validate, cannot decode block data. Error: %w", err) - } - - // validate header fields - if err := validateHeaderFields(f.parent, block.Header, f.config.BlockTimeDrift); err != nil { - return fmt.Errorf( - "failed to validate header (parent header# %d, current header#%d): %w", - f.parent.Number, - block.Number(), - err, - ) - } - - extra, err := GetIbftExtra(block.Header.ExtraData) - if err != nil { - return fmt.Errorf("cannot get extra data:%w", err) - } - - parentExtra, err := GetIbftExtra(f.parent.ExtraData) - if err != nil { - return err - } - - if extra.Checkpoint == nil { - return fmt.Errorf("checkpoint data for block %d is missing", block.Number()) - } - - if parentExtra.Checkpoint == nil { - return fmt.Errorf("checkpoint data for parent block %d is missing", f.parent.Number) - } - - if err := extra.ValidateParentSignatures(block.Number(), f.polybftBackend, nil, f.parent, parentExtra, - f.backend.GetChainID(), signer.DomainCheckpointManager, f.logger); err != nil { - return err - } - - if err := f.VerifyStateTransactions(block.Transactions); err != nil { - return err - } - - currentValidators := f.validators.Accounts() - - // validate validators delta - if f.isEndOfEpoch { - if extra.Validators == nil { - return errValidatorDeltaNilInEpochEndingBlock - } - - if !extra.Validators.Equals(f.newValidatorsDelta) { - return errValidatorSetDeltaMismatch - } - } else if extra.Validators != nil { - // delta should be nil in non epoch ending blocks - return errValidatorsUpdateInNonEpochEnding - } - - nextValidators, err := f.getValidatorsTransition(extra.Validators) - if err != nil { - return err - } - - // validate checkpoint data - if err := extra.Checkpoint.Validate(parentExtra.Checkpoint, - currentValidators, nextValidators, f.exitEventRootHash); err != nil { - return err - } - - if f.logger.IsTrace() && block.Number() > 1 { - validators, err := f.polybftBackend.GetValidators(block.Number()-2, nil) - if err != nil { - return fmt.Errorf("failed to retrieve validators:%w", err) - } - - f.logger.Trace("[FSM Validate]", "Block", block.Number(), "parent validators", validators) - } - - stateBlock, err := f.backend.ProcessBlock(f.parent, &block) - if err != nil { - return err - } - - if f.logger.IsDebug() { - checkpointHash, err := extra.Checkpoint.Hash(f.backend.GetChainID(), block.Number(), block.Hash()) - if err != nil { - return fmt.Errorf("failed to calculate proposal hash: %w", err) - } - - f.logger.Debug("[FSM Validate]", "txs", len(block.Transactions), "proposal hash", checkpointHash) - } - - f.target = stateBlock - - return nil -} - -// ValidateSender validates sender address and signature -func (f *fsm) ValidateSender(msg *proto.Message) error { - msgNoSig, err := msg.PayloadNoSig() - if err != nil { - return err - } - - signerAddress, err := wallet.RecoverAddressFromSignature(msg.Signature, msgNoSig) - if err != nil { - return fmt.Errorf("failed to recover address from signature: %w", err) - } - - // verify the signature came from the sender - if !bytes.Equal(msg.From, signerAddress.Bytes()) { - return fmt.Errorf("signer address %s doesn't match From field", signerAddress.String()) - } - - // verify the sender is in the active validator set - if !f.validators.Includes(signerAddress) { - return fmt.Errorf("signer address %s is not included in validator set", signerAddress.String()) - } - - return nil -} - -func (f *fsm) VerifyStateTransactions(transactions []*types.Transaction) error { - var ( - commitmentTxExists bool - commitEpochTxExists bool - distributeRewardsTxExists bool - ) - - for _, tx := range transactions { - if tx.Type != types.StateTx { - continue - } - - decodedStateTx, err := decodeStateTransaction(tx.Input) - if err != nil { - return fmt.Errorf("unknown state transaction: tx = %v, err = %w", tx.Hash, err) - } - - switch stateTxData := decodedStateTx.(type) { - case *CommitmentMessageSigned: - if !f.isEndOfSprint { - return fmt.Errorf("found commitment tx in block which should not contain it (tx hash=%s)", tx.Hash) - } - - if commitmentTxExists { - return fmt.Errorf("only one commitment tx is allowed per block (tx hash=%s)", tx.Hash) - } - - commitmentTxExists = true - - if err = verifyBridgeCommitmentTx(f.Height(), tx.Hash, stateTxData, f.validators); err != nil { - return err - } - case *contractsapi.CommitEpochValidatorSetFn: - if commitEpochTxExists { - // if we already validated commit epoch tx, - // that means someone added more than one commit epoch tx to block, - // which is invalid - return errCommitEpochTxSingleExpected - } - - commitEpochTxExists = true - - if err := f.verifyCommitEpochTx(tx); err != nil { - return fmt.Errorf("error while verifying commit epoch transaction. error: %w", err) - } - case *contractsapi.DistributeRewardForRewardPoolFn: - if distributeRewardsTxExists { - // if we already validated distribute rewards tx, - // that means someone added more than one distribute rewards tx to block, - // which is invalid - return errDistributeRewardsTxSingleExpected - } - - distributeRewardsTxExists = true - - if err := f.verifyDistributeRewardsTx(tx); err != nil { - return fmt.Errorf("error while verifying distribute rewards transaction. error: %w", err) - } - default: - return fmt.Errorf("invalid state transaction data type: %v", stateTxData) - } - } - - if f.isEndOfEpoch { - if !commitEpochTxExists { - // this is a check if commit epoch transaction is not in the list of transactions at all - // but it should be - return errCommitEpochTxDoesNotExist - } - - if !distributeRewardsTxExists { - // this is a check if distribute rewards transaction is not in the list of transactions at all - // but it should be - return errDistributeRewardsTxDoesNotExist - } - } - - return nil -} - -// Insert inserts the sealed proposal -func (f *fsm) Insert(proposal []byte, committedSeals []*messages.CommittedSeal) (*types.FullBlock, error) { - newBlock := f.target - - var proposedBlock types.Block - if err := proposedBlock.UnmarshalRLP(proposal); err != nil { - return nil, fmt.Errorf("failed to insert proposal, block unmarshaling failed: %w", err) - } - - if newBlock == nil || newBlock.Block.Hash() != proposedBlock.Hash() { - // if this is the case, we will let syncer insert the block - return nil, errProposalDontMatch - } - - // In this function we should try to return little to no errors since - // at this point everything we have to do is just commit something that - // we should have already computed beforehand. - extra, err := GetIbftExtra(newBlock.Block.Header.ExtraData) - if err != nil { - return nil, fmt.Errorf("failed to insert proposal, due to not being able to extract extra data: %w", err) - } - - // create map for faster access to indexes - nodeIDIndexMap := make(map[types.Address]int, f.validators.Len()) - for i, addr := range f.validators.Accounts().GetAddresses() { - nodeIDIndexMap[addr] = i - } - - // populated bitmap according to nodeId from validator set and committed seals - // also populate slice of signatures - bitmap := bitmap.Bitmap{} - signatures := make(bls.Signatures, 0, len(committedSeals)) - - for _, commSeal := range committedSeals { - signerAddr := types.BytesToAddress(commSeal.Signer) - - index, exists := nodeIDIndexMap[signerAddr] - if !exists { - return nil, fmt.Errorf("invalid node id = %s", signerAddr.String()) - } - - s, err := bls.UnmarshalSignature(commSeal.Signature) - if err != nil { - return nil, fmt.Errorf("invalid signature = %s", commSeal.Signature) - } - - signatures = append(signatures, s) - - bitmap.Set(uint64(index)) - } - - aggregatedSignature, err := signatures.Aggregate().Marshal() - if err != nil { - return nil, fmt.Errorf("could not aggregate seals: %w", err) - } - - // include aggregated signature of all committed seals - // also includes bitmap which contains all indexes from validator set which provides there seals - extra.Committed = &Signature{ - AggregatedSignature: aggregatedSignature, - Bitmap: bitmap, - } - - // Write extra data to header - newBlock.Block.Header.ExtraData = extra.MarshalRLPTo(nil) - - if err := f.backend.CommitBlock(newBlock); err != nil { - return nil, err - } - - return newBlock, nil -} - -// Height returns the height for the current round -func (f *fsm) Height() uint64 { - return f.parent.Number + 1 -} - -// ValidatorSet returns the validator set for the current round -func (f *fsm) ValidatorSet() validator.ValidatorSet { - return f.validators -} - -// verifyCommitEpochTx creates commit epoch transaction and compares its hash with the one extracted from the block. -func (f *fsm) verifyCommitEpochTx(commitEpochTx *types.Transaction) error { - if f.isEndOfEpoch { - localCommitEpochTx, err := f.createCommitEpochTx() - if err != nil { - return err - } - - if commitEpochTx.Hash != localCommitEpochTx.Hash { - return fmt.Errorf( - "invalid commit epoch transaction. Expected '%s', but got '%s' commit epoch transaction hash", - localCommitEpochTx.Hash, - commitEpochTx.Hash, - ) - } - - return nil - } - - return errCommitEpochTxNotExpected -} - -// verifyDistributeRewardsTx creates distribute rewards transaction -// and compares its hash with the one extracted from the block. -func (f *fsm) verifyDistributeRewardsTx(distributeRewardsTx *types.Transaction) error { - if f.isEndOfEpoch { - localDistributeRewardsTx, err := f.createDistributeRewardsTx() - if err != nil { - return err - } - - if distributeRewardsTx.Hash != localDistributeRewardsTx.Hash { - return fmt.Errorf( - "invalid distribute rewards transaction. Expected '%s', but got '%s' distribute rewards hash", - localDistributeRewardsTx.Hash, - distributeRewardsTx.Hash, - ) - } - - return nil - } - - return errDistributeRewardsTxNotExpected -} - -// verifyBridgeCommitmentTx validates bridge commitment transaction -func verifyBridgeCommitmentTx(blockNumber uint64, txHash types.Hash, - commitment *CommitmentMessageSigned, - validators validator.ValidatorSet) error { - signers, err := validators.Accounts().GetFilteredValidators(commitment.AggSignature.Bitmap) - if err != nil { - return fmt.Errorf("failed to retrieve signers for state tx (%s): %w", txHash, err) - } - - if !validators.HasQuorum(blockNumber, signers.GetAddressesAsSet()) { - return fmt.Errorf("quorum size not reached for state tx (%s)", txHash) - } - - commitmentHash, err := commitment.Hash() - if err != nil { - return err - } - - signature, err := bls.UnmarshalSignature(commitment.AggSignature.AggregatedSignature) - if err != nil { - return fmt.Errorf("error for state tx (%s) while unmarshaling signature: %w", txHash, err) - } - - verified := signature.VerifyAggregated(signers.GetBlsKeys(), commitmentHash.Bytes(), signer.DomainStateReceiver) - if !verified { - return fmt.Errorf("invalid signature for state tx (%s)", txHash) - } - - return nil -} - -func validateHeaderFields(parent *types.Header, header *types.Header, blockTimeDrift uint64) error { - // header extra data must be higher or equal to ExtraVanity = 32 in order to be compliant with Ethereum blocks - if len(header.ExtraData) < ExtraVanity { - return fmt.Errorf("extra-data shorter than %d bytes (%d)", ExtraVanity, len(header.ExtraData)) - } - // verify parent hash - if parent.Hash != header.ParentHash { - return fmt.Errorf("incorrect header parent hash (parent=%s, header parent=%s)", parent.Hash, header.ParentHash) - } - // verify parent number - if header.Number != parent.Number+1 { - return fmt.Errorf("invalid number") - } - // verify time is from the future - if header.Timestamp > (uint64(time.Now().UTC().Unix()) + blockTimeDrift) { - return fmt.Errorf("block from the future. block timestamp: %s, configured block time drift %d seconds", - time.Unix(int64(header.Timestamp), 0).Format(time.RFC3339), blockTimeDrift) - } - // verify header nonce is zero - if header.Nonce != types.ZeroNonce { - return fmt.Errorf("invalid nonce") - } - // verify that the gasUsed is <= gasLimit - if header.GasUsed > header.GasLimit { - return fmt.Errorf("invalid gas limit: have %v, max %v", header.GasUsed, header.GasLimit) - } - // verify time has passed - if header.Timestamp <= parent.Timestamp { - return fmt.Errorf("timestamp older than parent") - } - // verify mix digest - if header.MixHash != PolyBFTMixDigest { - return fmt.Errorf("mix digest is not correct") - } - // difficulty must be > 0 - if header.Difficulty <= 0 { - return fmt.Errorf("difficulty should be greater than zero") - } - // calculated header hash must be correct - if header.Hash != types.HeaderHash(header) { - return fmt.Errorf("invalid header hash") - } - - return nil -} - -// createStateTransactionWithData creates a state transaction -// with provided target address and inputData parameter which is ABI encoded byte array. -func createStateTransactionWithData(blockNumber uint64, target types.Address, inputData []byte) *types.Transaction { - tx := &types.Transaction{ - From: contracts.SystemCaller, - To: &target, - Type: types.StateTx, - Input: inputData, - Gas: types.StateTransactionGasLimit, - GasPrice: big.NewInt(0), - } - - return tx.ComputeHash(blockNumber) -} diff --git a/consensus/polybft/fsm_test.go b/consensus/polybft/fsm_test.go deleted file mode 100644 index 64c62ad..0000000 --- a/consensus/polybft/fsm_test.go +++ /dev/null @@ -1,1677 +0,0 @@ -package polybft - -import ( - "errors" - "fmt" - "math/big" - "math/rand" - "testing" - "time" - - "github.com/0xPolygon/go-ibft/messages" - "github.com/0xPolygon/go-ibft/messages/proto" - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/types" -) - -func TestFSM_ValidateHeader(t *testing.T) { - t.Parallel() - - blockTimeDrift := uint64(1) - extra := createTestExtra(validator.AccountSet{}, validator.AccountSet{}, 0, 0, 0) - parent := &types.Header{Number: 0, Hash: types.BytesToHash([]byte{1, 2, 3})} - header := &types.Header{Number: 0} - - // extra data - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "extra-data shorter than") - header.ExtraData = extra - - // parent hash - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "incorrect header parent hash") - header.ParentHash = parent.Hash - - // sequence number - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "invalid number") - header.Number = 1 - - // failed timestamp - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "timestamp older than parent") - header.Timestamp = 10 - - // failed nonce - header.SetNonce(1) - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "invalid nonce") - - header.SetNonce(0) - - // failed gas - header.GasLimit = 10 - header.GasUsed = 11 - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "invalid gas limit") - header.GasLimit = 10 - header.GasUsed = 10 - - // mix digest - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "mix digest is not correct") - header.MixHash = PolyBFTMixDigest - - // difficulty - header.Difficulty = 0 - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "difficulty should be greater than zero") - - header.Difficulty = 1 - header.Hash = types.BytesToHash([]byte{11, 22, 33}) - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "invalid header hash") - header.Timestamp = uint64(time.Now().UTC().Unix() + 150) - require.ErrorContains(t, validateHeaderFields(parent, header, blockTimeDrift), "block from the future") - - header.Timestamp = uint64(time.Now().UTC().Unix()) - - header.ComputeHash() - require.NoError(t, validateHeaderFields(parent, header, blockTimeDrift)) -} - -func TestFSM_verifyCommitEpochTx(t *testing.T) { - t.Parallel() - - fsm := &fsm{ - isEndOfEpoch: true, - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - parent: &types.Header{}, - } - - // include commit epoch transaction to the epoch ending block - commitEpochTx, err := fsm.createCommitEpochTx() - assert.NoError(t, err) - assert.NotNil(t, commitEpochTx) - - assert.NoError(t, fsm.verifyCommitEpochTx(commitEpochTx)) - - // submit tampered commit epoch transaction to the epoch ending block - alteredCommitEpochTx := &types.Transaction{ - To: &contracts.ValidatorSetContract, - Input: []byte{}, - Gas: 0, - Type: types.StateTx, - } - assert.ErrorContains(t, fsm.verifyCommitEpochTx(alteredCommitEpochTx), "invalid commit epoch transaction") - - // submit validators commit epoch transaction to the non-epoch ending block - fsm.isEndOfEpoch = false - commitEpochTx, err = fsm.createCommitEpochTx() - assert.NoError(t, err) - assert.NotNil(t, commitEpochTx) - assert.ErrorContains(t, fsm.verifyCommitEpochTx(commitEpochTx), errCommitEpochTxNotExpected.Error()) -} - -func TestFSM_BuildProposal_WithoutCommitEpochTxGood(t *testing.T) { - t.Parallel() - - const ( - accountCount = 5 - committedCount = 4 - parentCount = 3 - confirmedStateSyncsCount = 5 - parentBlockNumber = 1023 - currentRound = 1 - ) - - eventRoot := types.ZeroHash - - validators := validator.NewTestValidators(t, accountCount) - validatorSet := validators.GetPublicIdentities() - extra := createTestExtra(validatorSet, validator.AccountSet{}, accountCount-1, committedCount, parentCount) - - parent := &types.Header{Number: parentBlockNumber, ExtraData: extra} - parent.ComputeHash() - stateBlock := createDummyStateBlock(parentBlockNumber+1, parent.Hash, extra) - mBlockBuilder := newBlockBuilderMock(stateBlock) - - blockchainMock := &blockchainMock{} - runtime := &consensusRuntime{ - logger: hclog.NewNullLogger(), - config: &runtimeConfig{ - Key: wallet.NewKey(validators.GetPrivateIdentities()[0]), - blockchain: blockchainMock, - }, - } - - fsm := &fsm{parent: parent, blockBuilder: mBlockBuilder, config: &PolyBFTConfig{}, backend: blockchainMock, - validators: validators.ToValidatorSet(), exitEventRootHash: eventRoot, logger: hclog.NewNullLogger()} - - proposal, err := fsm.BuildProposal(currentRound) - assert.NoError(t, err) - assert.NotNil(t, proposal) - - currentValidatorsHash, err := validatorSet.Hash() - require.NoError(t, err) - - rlpBlock := stateBlock.Block.MarshalRLP() - assert.Equal(t, rlpBlock, proposal) - - block := types.Block{} - require.NoError(t, block.UnmarshalRLP(proposal)) - - checkpoint := &CheckpointData{ - BlockRound: currentRound, - EpochNumber: fsm.epochNumber, - EventRoot: eventRoot, - CurrentValidatorsHash: currentValidatorsHash, - NextValidatorsHash: currentValidatorsHash, - } - - checkpointHash, err := checkpoint.Hash(fsm.backend.GetChainID(), block.Number(), block.Hash()) - require.NoError(t, err) - - msg := runtime.BuildPrePrepareMessage(proposal, nil, &proto.View{}) - require.Equal(t, checkpointHash.Bytes(), msg.GetPreprepareData().ProposalHash) - - mBlockBuilder.AssertExpectations(t) -} - -func TestFSM_BuildProposal_WithCommitEpochTxGood(t *testing.T) { - t.Parallel() - - const ( - accountCount = 5 - committedCount = 4 - parentCount = 3 - confirmedStateSyncsCount = 5 - currentRound = 0 - parentBlockNumber = 1023 - ) - - eventRoot := types.ZeroHash - - validators := validator.NewTestValidators(t, accountCount) - extra := createTestExtra(validators.GetPublicIdentities(), validator.AccountSet{}, accountCount-1, committedCount, parentCount) - - parent := &types.Header{Number: parentBlockNumber, ExtraData: extra} - parent.ComputeHash() - stateBlock := createDummyStateBlock(parentBlockNumber+1, parent.Hash, extra) - - mBlockBuilder := newBlockBuilderMock(stateBlock) - mBlockBuilder.On("WriteTx", mock.Anything).Return(error(nil)).Twice() - - blockChainMock := new(blockchainMock) - - runtime := &consensusRuntime{ - logger: hclog.NewNullLogger(), - config: &runtimeConfig{ - Key: wallet.NewKey(validators.GetPrivateIdentities()[0]), - blockchain: blockChainMock, - }, - } - - fsm := &fsm{parent: parent, blockBuilder: mBlockBuilder, config: &PolyBFTConfig{}, backend: blockChainMock, - isEndOfEpoch: true, - validators: validators.ToValidatorSet(), - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - distributeRewardsInput: createTestDistributeRewardsInput(t, 0, nil, 10), - exitEventRootHash: eventRoot, - logger: hclog.NewNullLogger(), - } - - proposal, err := fsm.BuildProposal(currentRound) - assert.NoError(t, err) - assert.NotNil(t, proposal) - - block := types.Block{} - require.NoError(t, block.UnmarshalRLP(proposal)) - - assert.Equal(t, stateBlock.Block.MarshalRLP(), proposal) - - currentValidatorsHash, err := validators.GetPublicIdentities().Hash() - require.NoError(t, err) - - nextValidatorsHash, err := validators.ToValidatorSet().Accounts().Hash() - require.NoError(t, err) - - checkpoint := &CheckpointData{ - BlockRound: currentRound, - EpochNumber: fsm.epochNumber, - EventRoot: eventRoot, - CurrentValidatorsHash: currentValidatorsHash, - NextValidatorsHash: nextValidatorsHash, - } - - checkpointHash, err := checkpoint.Hash(fsm.backend.GetChainID(), block.Number(), block.Hash()) - require.NoError(t, err) - - msg := runtime.BuildPrePrepareMessage(proposal, nil, &proto.View{}) - require.Equal(t, checkpointHash.Bytes(), msg.GetPreprepareData().ProposalHash) - - mBlockBuilder.AssertExpectations(t) -} - -func TestFSM_BuildProposal_EpochEndingBlock_FailedToApplyStateTx(t *testing.T) { - t.Parallel() - - const ( - accountCount = 5 - committedCount = 4 - parentCount = 3 - parentBlockNumber = 1023 - ) - - validators := validator.NewTestValidators(t, accountCount) - extra := createTestExtra(validators.GetPublicIdentities(), validator.AccountSet{}, accountCount-1, committedCount, parentCount) - - parent := &types.Header{Number: parentBlockNumber, ExtraData: extra} - - mBlockBuilder := new(blockBuilderMock) - mBlockBuilder.On("WriteTx", mock.Anything).Return(errors.New("error")).Once() - mBlockBuilder.On("Reset").Return(error(nil)).Once() - - validatorSet := validator.NewValidatorSet(validators.GetPublicIdentities(), hclog.NewNullLogger()) - - fsm := &fsm{parent: parent, blockBuilder: mBlockBuilder, backend: &blockchainMock{}, - isEndOfEpoch: true, - validators: validatorSet, - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - exitEventRootHash: types.ZeroHash, - } - - _, err := fsm.BuildProposal(0) - assert.ErrorContains(t, err, "failed to apply commit epoch transaction") - mBlockBuilder.AssertExpectations(t) -} - -func TestFSM_BuildProposal_EpochEndingBlock_ValidatorsDeltaExists(t *testing.T) { - t.Parallel() - - const ( - validatorsCount = 6 - remainingValidatorsCount = 3 - signaturesCount = 4 - parentBlockNumber = 49 - ) - - validators := validator.NewTestValidators(t, validatorsCount).GetPublicIdentities() - extra := createTestExtraObject(validators, validator.AccountSet{}, validatorsCount-1, signaturesCount, signaturesCount) - extra.Validators = nil - - extraData := extra.MarshalRLPTo(nil) - parent := &types.Header{Number: parentBlockNumber, ExtraData: extraData} - parent.ComputeHash() - stateBlock := createDummyStateBlock(parentBlockNumber+1, parent.Hash, extraData) - - blockBuilderMock := newBlockBuilderMock(stateBlock) - blockBuilderMock.On("WriteTx", mock.Anything).Return(error(nil)).Twice() - - addedValidators := validator.NewTestValidators(t, 2).GetPublicIdentities() - removedValidators := [3]uint64{3, 4, 5} - removedBitmap := &bitmap.Bitmap{} - - for _, i := range removedValidators { - removedBitmap.Set(i) - } - - newDelta := &validator.ValidatorSetDelta{ - Added: addedValidators, - Updated: validator.AccountSet{}, - Removed: *removedBitmap, - } - - blockChainMock := new(blockchainMock) - - validatorSet := validator.NewValidatorSet(validators, hclog.NewNullLogger()) - - fsm := &fsm{ - parent: parent, - blockBuilder: blockBuilderMock, - config: &PolyBFTConfig{}, - backend: blockChainMock, - isEndOfEpoch: true, - validators: validatorSet, - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - distributeRewardsInput: createTestDistributeRewardsInput(t, 0, validators, 10), - exitEventRootHash: types.ZeroHash, - logger: hclog.NewNullLogger(), - newValidatorsDelta: newDelta, - } - - proposal, err := fsm.BuildProposal(0) - assert.NoError(t, err) - assert.NotNil(t, proposal) - - blockExtra, err := GetIbftExtra(stateBlock.Block.Header.ExtraData) - assert.NoError(t, err) - assert.Len(t, blockExtra.Validators.Added, 2) - assert.False(t, blockExtra.Validators.IsEmpty()) - - for _, addedValidator := range addedValidators { - assert.True(t, blockExtra.Validators.Added.ContainsAddress(addedValidator.Address)) - } - - for _, removedValidator := range removedValidators { - assert.True( - t, - blockExtra.Validators.Removed.IsSet(removedValidator), - fmt.Sprintf("Expected validator at index %d to be marked as removed, but it wasn't", removedValidator), - ) - } - - blockBuilderMock.AssertExpectations(t) - blockChainMock.AssertExpectations(t) -} - -func TestFSM_BuildProposal_NonEpochEndingBlock_ValidatorsDeltaNil(t *testing.T) { - t.Parallel() - - const ( - accountCount = 6 - signaturesCount = 4 - parentBlockNumber = 9 - ) - - testValidators := validator.NewTestValidators(t, accountCount) - extra := createTestExtra(testValidators.GetPublicIdentities(), validator.AccountSet{}, accountCount-1, signaturesCount, signaturesCount) - parent := &types.Header{Number: parentBlockNumber, ExtraData: extra} - parent.ComputeHash() - stateBlock := createDummyStateBlock(parentBlockNumber+1, parent.Hash, extra) - - blockBuilderMock := &blockBuilderMock{} - blockBuilderMock.On("Build", mock.Anything).Return(stateBlock).Once() - blockBuilderMock.On("Fill").Once() - blockBuilderMock.On("Reset").Return(error(nil)).Once() - - fsm := &fsm{parent: parent, blockBuilder: blockBuilderMock, - config: &PolyBFTConfig{}, backend: &blockchainMock{}, - isEndOfEpoch: false, validators: testValidators.ToValidatorSet(), - exitEventRootHash: types.ZeroHash, logger: hclog.NewNullLogger()} - - proposal, err := fsm.BuildProposal(0) - assert.NoError(t, err) - assert.NotNil(t, proposal) - - blockExtra, err := GetIbftExtra(stateBlock.Block.Header.ExtraData) - assert.NoError(t, err) - assert.Nil(t, blockExtra.Validators) - - blockBuilderMock.AssertExpectations(t) -} - -func TestFSM_BuildProposal_EpochEndingBlock_FailToGetNextValidatorsHash(t *testing.T) { - t.Parallel() - - const ( - accountCount = 6 - signaturesCount = 4 - parentBlockNumber = 49 - ) - - testValidators := validator.NewTestValidators(t, accountCount) - allAccounts := testValidators.GetPublicIdentities() - extra := createTestExtraObject(allAccounts, validator.AccountSet{}, accountCount-1, signaturesCount, signaturesCount) - extra.Validators = nil - - newValidatorDelta := &validator.ValidatorSetDelta{ - // this will prompt an error since all the validators are already in the validator set - Added: testValidators.ToValidatorSet().Accounts(), - } - - parent := &types.Header{Number: parentBlockNumber, ExtraData: extra.MarshalRLPTo(nil)} - - blockBuilderMock := new(blockBuilderMock) - blockBuilderMock.On("WriteTx", mock.Anything).Return(error(nil)).Twice() - blockBuilderMock.On("Reset").Return(error(nil)).Once() - blockBuilderMock.On("Fill").Once() - - fsm := &fsm{parent: parent, - blockBuilder: blockBuilderMock, - config: &PolyBFTConfig{}, - isEndOfEpoch: true, - validators: testValidators.ToValidatorSet(), - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - distributeRewardsInput: createTestDistributeRewardsInput(t, 0, allAccounts, 10), - exitEventRootHash: types.ZeroHash, - newValidatorsDelta: newValidatorDelta, - } - - proposal, err := fsm.BuildProposal(0) - assert.ErrorContains(t, err, "already present in the validators snapshot") - assert.Nil(t, proposal) - - blockBuilderMock.AssertNotCalled(t, "Build") - blockBuilderMock.AssertExpectations(t) -} - -func TestFSM_VerifyStateTransactions_MiddleOfEpochWithTransaction(t *testing.T) { - t.Parallel() - - fsm := &fsm{commitEpochInput: createTestCommitEpochInput(t, 0, 10), parent: &types.Header{}} - tx, err := fsm.createCommitEpochTx() - assert.NoError(t, err) - err = fsm.VerifyStateTransactions([]*types.Transaction{tx}) - assert.ErrorContains(t, err, err.Error()) -} - -func TestFSM_VerifyStateTransactions_MiddleOfEpochWithoutTransaction(t *testing.T) { - t.Parallel() - - fsm := &fsm{commitEpochInput: createTestCommitEpochInput(t, 0, 10), parent: &types.Header{}} - err := fsm.VerifyStateTransactions([]*types.Transaction{}) - assert.NoError(t, err) -} - -func TestFSM_VerifyStateTransactions_EndOfEpochWithoutTransaction(t *testing.T) { - t.Parallel() - - fsm := &fsm{isEndOfEpoch: true, commitEpochInput: createTestCommitEpochInput(t, 0, 10)} - assert.EqualError(t, fsm.VerifyStateTransactions([]*types.Transaction{}), - "commit epoch transaction is not found in the epoch ending block") -} - -func TestFSM_VerifyStateTransactions_EndOfEpochWrongCommitEpochTx(t *testing.T) { - t.Parallel() - - fsm := &fsm{ - isEndOfEpoch: true, - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - parent: &types.Header{}, - } - commitEpochInput, err := createTestCommitEpochInput(t, 1, 5).EncodeAbi() - require.NoError(t, err) - - commitEpochTx := createStateTransactionWithData(1, contracts.ValidatorSetContract, commitEpochInput) - assert.ErrorContains(t, fsm.VerifyStateTransactions([]*types.Transaction{commitEpochTx}), "invalid commit epoch transaction") -} - -func TestFSM_VerifyStateTransactions_CommitmentTransactionAndSprintIsFalse(t *testing.T) { - t.Parallel() - - fsm := &fsm{parent: &types.Header{}} - - encodedCommitment, err := createTestCommitmentMessage(t, 1).EncodeAbi() - require.NoError(t, err) - - tx := createStateTransactionWithData(1, contracts.StateReceiverContract, encodedCommitment) - assert.ErrorContains(t, fsm.VerifyStateTransactions([]*types.Transaction{tx}), - "found commitment tx in block which should not contain it") -} - -func TestFSM_VerifyStateTransactions_EndOfEpochMoreThanOneCommitEpochTx(t *testing.T) { - t.Parallel() - - txs := make([]*types.Transaction, 2) - fsm := &fsm{ - isEndOfEpoch: true, - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - parent: &types.Header{}, - } - - commitEpochTxOne, err := fsm.createCommitEpochTx() - require.NoError(t, err) - - txs[0] = commitEpochTxOne - - commitEpochTxTwo := createTestCommitEpochInput(t, 0, 100) - input, err := commitEpochTxTwo.EncodeAbi() - require.NoError(t, err) - - txs[1] = createStateTransactionWithData(1, types.ZeroAddress, input) - - assert.ErrorIs(t, fsm.VerifyStateTransactions(txs), errCommitEpochTxSingleExpected) -} - -func TestFSM_VerifyStateTransactions_StateTransactionPass(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidators(t, 5) - - validatorSet := validator.NewValidatorSet(validators.GetPublicIdentities(), hclog.NewNullLogger()) - - fsm := &fsm{ - parent: &types.Header{Number: 1}, - isEndOfEpoch: true, - isEndOfSprint: true, - validators: validatorSet, - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - distributeRewardsInput: createTestDistributeRewardsInput(t, 0, validators.GetPublicIdentities(), 10), - logger: hclog.NewNullLogger(), - } - - // add commit epoch commitEpochTx to the end of transactions list - commitEpochTx, err := fsm.createCommitEpochTx() - require.NoError(t, err) - - distributeRewardsTx, err := fsm.createDistributeRewardsTx() - require.NoError(t, err) - - err = fsm.VerifyStateTransactions([]*types.Transaction{commitEpochTx, distributeRewardsTx}) - require.NoError(t, err) -} - -func TestFSM_VerifyStateTransactions_StateTransactionQuorumNotReached(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidators(t, 5) - commitment := createTestCommitment(t, validators.GetPrivateIdentities()) - commitment.AggSignature = Signature{ - AggregatedSignature: []byte{1, 2}, - Bitmap: []byte{}, - } - - validatorSet := validator.NewValidatorSet(validators.GetPublicIdentities(), hclog.NewNullLogger()) - - fsm := &fsm{ - parent: &types.Header{Number: 2}, - isEndOfEpoch: true, - isEndOfSprint: true, - validators: validatorSet, - proposerCommitmentToRegister: commitment, - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - distributeRewardsInput: createTestDistributeRewardsInput(t, 0, nil, 10), - logger: hclog.NewNullLogger(), - } - - bridgeCommitmentTx, err := fsm.createBridgeCommitmentTx() - require.NoError(t, err) - - // add commit epoch commitEpochTx to the end of transactions list - commitEpochTx, err := fsm.createCommitEpochTx() - require.NoError(t, err) - - stateTxs := []*types.Transaction{commitEpochTx, bridgeCommitmentTx} - - err = fsm.VerifyStateTransactions(stateTxs) - require.ErrorContains(t, err, "quorum size not reached") -} - -func TestFSM_VerifyStateTransactions_StateTransactionInvalidSignature(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidators(t, 5) - commitment := createTestCommitment(t, validators.GetPrivateIdentities()) - nonValidators := validator.NewTestValidators(t, 3) - aggregatedSigs := bls.Signatures{} - - nonValidators.IterAcct(nil, func(t *validator.TestValidator) { - aggregatedSigs = append(aggregatedSigs, t.MustSign([]byte("dummyHash"), signer.DomainStateReceiver)) - }) - - sig, err := aggregatedSigs.Aggregate().Marshal() - require.NoError(t, err) - - commitment.AggSignature.AggregatedSignature = sig - - validatorSet := validator.NewValidatorSet(validators.GetPublicIdentities(), hclog.NewNullLogger()) - - fsm := &fsm{ - parent: &types.Header{Number: 1}, - isEndOfEpoch: true, - isEndOfSprint: true, - validators: validatorSet, - proposerCommitmentToRegister: commitment, - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - distributeRewardsInput: createTestDistributeRewardsInput(t, 0, nil, 10), - logger: hclog.NewNullLogger(), - } - - bridgeCommitmentTx, err := fsm.createBridgeCommitmentTx() - require.NoError(t, err) - - // add commit epoch commitEpochTx to the end of transactions list - commitEpochTx, err := fsm.createCommitEpochTx() - require.NoError(t, err) - - err = fsm.VerifyStateTransactions([]*types.Transaction{commitEpochTx, bridgeCommitmentTx}) - require.ErrorContains(t, err, "invalid signature") -} - -func TestFSM_ValidateCommit_WrongValidator(t *testing.T) { - t.Parallel() - - const ( - accountsCount = 5 - parentBlockNumber = 10 - ) - - validators := validator.NewTestValidators(t, accountsCount) - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: createTestExtra(validators.GetPublicIdentities(), validator.AccountSet{}, 5, 3, 3), - } - parent.ComputeHash() - stateBlock := createDummyStateBlock(parentBlockNumber+1, parent.Hash, parent.ExtraData) - mBlockBuilder := newBlockBuilderMock(stateBlock) - - fsm := &fsm{parent: parent, blockBuilder: mBlockBuilder, config: &PolyBFTConfig{}, backend: &blockchainMock{}, - validators: validators.ToValidatorSet(), logger: hclog.NewNullLogger(), exitEventRootHash: types.ZeroHash} - - _, err := fsm.BuildProposal(0) - require.NoError(t, err) - - err = fsm.ValidateCommit([]byte("0x7467674"), types.ZeroAddress.Bytes(), []byte{}) - require.ErrorContains(t, err, "unable to resolve validator") -} - -func TestFSM_ValidateCommit_InvalidHash(t *testing.T) { - t.Parallel() - - const ( - accountsCount = 5 - parentBlockNumber = 10 - ) - - validators := validator.NewTestValidators(t, accountsCount) - - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: createTestExtra(validators.GetPublicIdentities(), validator.AccountSet{}, 5, 3, 3), - } - parent.ComputeHash() - stateBlock := createDummyStateBlock(parentBlockNumber+1, parent.Hash, parent.ExtraData) - mBlockBuilder := newBlockBuilderMock(stateBlock) - - fsm := &fsm{parent: parent, blockBuilder: mBlockBuilder, config: &PolyBFTConfig{}, backend: &blockchainMock{}, - validators: validators.ToValidatorSet(), exitEventRootHash: types.ZeroHash, logger: hclog.NewNullLogger()} - - _, err := fsm.BuildProposal(0) - require.NoError(t, err) - - nonValidatorAcc := validator.NewTestValidator(t, "non_validator", 1) - wrongSignature, err := nonValidatorAcc.MustSign([]byte("Foo"), signer.DomainCheckpointManager).Marshal() - require.NoError(t, err) - - err = fsm.ValidateCommit(validators.GetValidator("0").Address().Bytes(), wrongSignature, []byte{}) - require.ErrorContains(t, err, "incorrect commit signature from") -} - -func TestFSM_ValidateCommit_Good(t *testing.T) { - t.Parallel() - - const parentBlockNumber = 10 - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E"}) - validatorsMetadata := validators.GetPublicIdentities() - - parent := &types.Header{Number: parentBlockNumber, ExtraData: createTestExtra(validatorsMetadata, validator.AccountSet{}, 5, 3, 3)} - parent.ComputeHash() - stateBlock := createDummyStateBlock(parentBlockNumber+1, parent.Hash, parent.ExtraData) - mBlockBuilder := newBlockBuilderMock(stateBlock) - - validatorSet := validator.NewValidatorSet(validatorsMetadata, hclog.NewNullLogger()) - - fsm := &fsm{parent: parent, blockBuilder: mBlockBuilder, config: &PolyBFTConfig{}, backend: &blockchainMock{}, - validators: validatorSet, - exitEventRootHash: types.ZeroHash, - logger: hclog.NewNullLogger()} - - proposal, err := fsm.BuildProposal(0) - require.NoError(t, err) - - block := types.Block{} - require.NoError(t, block.UnmarshalRLP(proposal)) - - validator := validators.GetValidator("A") - seal, err := validator.MustSign(block.Hash().Bytes(), signer.DomainCheckpointManager).Marshal() - require.NoError(t, err) - err = fsm.ValidateCommit(validator.Key().Address().Bytes(), seal, block.Hash().Bytes()) - require.NoError(t, err) -} - -func TestFSM_Validate_ExitEventRootNotExpected(t *testing.T) { - t.Parallel() - - const ( - accountsCount = 5 - parentBlockNumber = 25 - signaturesCount = 3 - ) - - validators := validator.NewTestValidators(t, accountsCount) - parentExtra := createTestExtraObject(validators.GetPublicIdentities(), validator.AccountSet{}, 4, signaturesCount, signaturesCount) - parentExtra.Validators = nil - - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: parentExtra.MarshalRLPTo(nil), - } - parent.ComputeHash() - - polybftBackendMock := new(polybftBackendMock) - polybftBackendMock.On("GetValidators", mock.Anything, mock.Anything).Return(validators.GetPublicIdentities(), nil).Once() - - extra := createTestExtraObject(validators.GetPublicIdentities(), validator.AccountSet{}, 4, signaturesCount, signaturesCount) - extra.Validators = nil - parentCheckpointHash, err := extra.Checkpoint.Hash(0, parentBlockNumber, parent.Hash) - require.NoError(t, err) - - currentValSetHash, err := validators.GetPublicIdentities().Hash() - require.NoError(t, err) - - extra.Parent = createSignature(t, validators.GetPrivateIdentities(), parentCheckpointHash, signer.DomainCheckpointManager) - extra.Checkpoint.EpochNumber = 1 - extra.Checkpoint.CurrentValidatorsHash = currentValSetHash - extra.Checkpoint.NextValidatorsHash = currentValSetHash - - stateBlock := createDummyStateBlock(parent.Number+1, types.Hash{100, 15}, extra.MarshalRLPTo(nil)) - - proposalHash, err := extra.Checkpoint.Hash(0, stateBlock.Block.Number(), stateBlock.Block.Hash()) - require.NoError(t, err) - - stateBlock.Block.Header.Hash = proposalHash - stateBlock.Block.Header.ParentHash = parent.Hash - stateBlock.Block.Header.Timestamp = uint64(time.Now().UTC().Unix()) - stateBlock.Block.Transactions = []*types.Transaction{} - - proposal := stateBlock.Block.MarshalRLP() - - fsm := &fsm{ - parent: parent, - backend: new(blockchainMock), - validators: validators.ToValidatorSet(), - logger: hclog.NewNullLogger(), - polybftBackend: polybftBackendMock, - config: &PolyBFTConfig{BlockTimeDrift: 1}, - exitEventRootHash: types.BytesToHash([]byte{0, 1, 2, 3, 4}), // expect this to be in proposal extra - } - - err = fsm.Validate(proposal) - require.ErrorContains(t, err, "exit root hash not as expected") - - polybftBackendMock.AssertExpectations(t) -} - -func TestFSM_Validate_EpochEndingBlock_MismatchInDeltas(t *testing.T) { - t.Parallel() - - const ( - accountsCount = 5 - parentBlockNumber = 25 - signaturesCount = 3 - ) - - validators := validator.NewTestValidators(t, accountsCount) - parentExtra := createTestExtraObject(validators.GetPublicIdentities(), validator.AccountSet{}, 4, signaturesCount, signaturesCount) - parentExtra.Validators = nil - - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: parentExtra.MarshalRLPTo(nil), - } - parent.ComputeHash() - - polybftBackendMock := new(polybftBackendMock) - polybftBackendMock.On("GetValidators", mock.Anything, mock.Anything).Return(validators.GetPublicIdentities(), nil).Once() - - extra := createTestExtraObject(validators.GetPublicIdentities(), validator.AccountSet{}, 4, signaturesCount, signaturesCount) - parentCheckpointHash, err := extra.Checkpoint.Hash(0, parentBlockNumber, parent.Hash) - require.NoError(t, err) - - extra.Validators = &validator.ValidatorSetDelta{} // this will cause test to fail - extra.Parent = createSignature(t, validators.GetPrivateIdentities(), parentCheckpointHash, signer.DomainCheckpointManager) - - stateBlock := createDummyStateBlock(parent.Number+1, types.Hash{100, 15}, extra.MarshalRLPTo(nil)) - - proposalHash, err := new(CheckpointData).Hash(0, stateBlock.Block.Number(), stateBlock.Block.Hash()) - require.NoError(t, err) - - commitEpoch := createTestCommitEpochInput(t, 1, 10) - commitEpochTxInput, err := commitEpoch.EncodeAbi() - require.NoError(t, err) - - distributeRewards := createTestDistributeRewardsInput(t, 1, validators.GetPublicIdentities(), 10) - distributeRewardsTxInput, err := distributeRewards.EncodeAbi() - require.NoError(t, err) - - stateBlock.Block.Header.Hash = proposalHash - stateBlock.Block.Header.ParentHash = parent.Hash - stateBlock.Block.Header.Timestamp = uint64(time.Now().UTC().Unix()) - stateBlock.Block.Transactions = []*types.Transaction{ - createStateTransactionWithData(1, contracts.ValidatorSetContract, commitEpochTxInput), - createStateTransactionWithData(1, contracts.RewardPoolContract, distributeRewardsTxInput), - } - - proposal := stateBlock.Block.MarshalRLP() - - blockchainMock := new(blockchainMock) - blockchainMock.On("ProcessBlock", mock.Anything, mock.Anything). - Return(stateBlock, error(nil)). - Maybe() - - // a new validator is added to delta which proposers block does not have - privateKey, err := bls.GenerateBlsKey() - require.NoError(t, err) - - newValidatorDelta := &validator.ValidatorSetDelta{ - Added: validator.AccountSet{&validator.ValidatorMetadata{ - Address: types.BytesToAddress([]byte{0, 1, 2, 3}), - BlsKey: privateKey.PublicKey(), - VotingPower: new(big.Int).SetUint64(1), - IsActive: true, - }}, - } - - fsm := &fsm{ - parent: parent, - backend: blockchainMock, - validators: validators.ToValidatorSet(), - logger: hclog.NewNullLogger(), - isEndOfEpoch: true, - commitEpochInput: commitEpoch, - distributeRewardsInput: distributeRewards, - polybftBackend: polybftBackendMock, - newValidatorsDelta: newValidatorDelta, - config: &PolyBFTConfig{BlockTimeDrift: 1}, - } - - err = fsm.Validate(proposal) - require.ErrorIs(t, err, errValidatorSetDeltaMismatch) - - polybftBackendMock.AssertExpectations(t) - blockchainMock.AssertExpectations(t) -} - -func TestFSM_Validate_EpochEndingBlock_UpdatingValidatorSetInNonEpochEndingBlock(t *testing.T) { - t.Parallel() - - const ( - accountsCount = 5 - parentBlockNumber = 25 - signaturesCount = 3 - ) - - validators := validator.NewTestValidators(t, accountsCount) - parentExtra := createTestExtraObject(validators.GetPublicIdentities(), validator.AccountSet{}, 4, signaturesCount, signaturesCount) - parentExtra.Validators = nil - - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: parentExtra.MarshalRLPTo(nil), - } - parent.ComputeHash() - - polybftBackendMock := new(polybftBackendMock) - polybftBackendMock.On("GetValidators", mock.Anything, mock.Anything).Return(validators.GetPublicIdentities(), nil).Once() - - // a new validator is added to delta which proposers block does not have - privateKey, err := bls.GenerateBlsKey() - require.NoError(t, err) - - newValidatorDelta := &validator.ValidatorSetDelta{ - Added: validator.AccountSet{&validator.ValidatorMetadata{ - Address: types.BytesToAddress([]byte{0, 1, 2, 3}), - BlsKey: privateKey.PublicKey(), - VotingPower: new(big.Int).SetUint64(1), - IsActive: true, - }}, - } - - extra := createTestExtraObject(validators.GetPublicIdentities(), validator.AccountSet{}, 4, signaturesCount, signaturesCount) - parentCheckpointHash, err := extra.Checkpoint.Hash(0, parentBlockNumber, parent.Hash) - require.NoError(t, err) - - extra.Validators = newValidatorDelta // this will cause test to fail - extra.Parent = createSignature(t, validators.GetPrivateIdentities(), parentCheckpointHash, signer.DomainCheckpointManager) - - stateBlock := createDummyStateBlock(parent.Number+1, types.Hash{100, 15}, extra.MarshalRLPTo(nil)) - - proposalHash, err := new(CheckpointData).Hash(0, stateBlock.Block.Number(), stateBlock.Block.Hash()) - require.NoError(t, err) - - stateBlock.Block.Header.Hash = proposalHash - stateBlock.Block.Header.ParentHash = parent.Hash - stateBlock.Block.Header.Timestamp = uint64(time.Now().UTC().Unix()) - - proposal := stateBlock.Block.MarshalRLP() - - blockchainMock := new(blockchainMock) - blockchainMock.On("ProcessBlock", mock.Anything, mock.Anything). - Return(stateBlock, error(nil)). - Maybe() - - fsm := &fsm{ - parent: parent, - backend: blockchainMock, - validators: validators.ToValidatorSet(), - logger: hclog.NewNullLogger(), - polybftBackend: polybftBackendMock, - config: &PolyBFTConfig{BlockTimeDrift: 1}, - } - - err = fsm.Validate(proposal) - require.ErrorIs(t, err, errValidatorsUpdateInNonEpochEnding) - - polybftBackendMock.AssertExpectations(t) - blockchainMock.AssertExpectations(t) -} - -func TestFSM_Validate_IncorrectHeaderParentHash(t *testing.T) { - t.Parallel() - - const ( - accountsCount = 5 - parentBlockNumber = 25 - signaturesCount = 3 - ) - - validators := validator.NewTestValidators(t, accountsCount) - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: createTestExtra(validators.GetPublicIdentities(), validator.AccountSet{}, 4, signaturesCount, signaturesCount), - } - parent.ComputeHash() - - fsm := &fsm{ - parent: parent, - backend: &blockchainMock{}, - validators: validators.ToValidatorSet(), - logger: hclog.NewNullLogger(), - config: &PolyBFTConfig{ - BlockTimeDrift: 1, - }, - } - - stateBlock := createDummyStateBlock(parent.Number+1, types.Hash{100, 15}, parent.ExtraData) - - hash, err := new(CheckpointData).Hash(fsm.backend.GetChainID(), stateBlock.Block.Number(), stateBlock.Block.Hash()) - require.NoError(t, err) - - stateBlock.Block.Header.Hash = hash - proposal := stateBlock.Block.MarshalRLP() - - err = fsm.Validate(proposal) - require.ErrorContains(t, err, "incorrect header parent hash") -} - -func TestFSM_Validate_InvalidNumber(t *testing.T) { - t.Parallel() - - const ( - accountsCount = 5 - parentBlockNumber = 10 - signaturesCount = 3 - ) - - validators := validator.NewTestValidators(t, accountsCount) - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: createTestExtra(validators.GetPublicIdentities(), validator.AccountSet{}, 4, signaturesCount, signaturesCount), - } - parent.ComputeHash() - - // try some invalid block numbers, parentBlockNumber + 1 should be correct - for _, blockNum := range []uint64{parentBlockNumber - 1, parentBlockNumber, parentBlockNumber + 2} { - stateBlock := createDummyStateBlock(blockNum, parent.Hash, parent.ExtraData) - mBlockBuilder := newBlockBuilderMock(stateBlock) - fsm := &fsm{ - parent: parent, - blockBuilder: mBlockBuilder, - backend: &blockchainMock{}, - validators: validators.ToValidatorSet(), - logger: hclog.NewNullLogger(), - config: &PolyBFTConfig{BlockTimeDrift: 1}, - } - - proposalHash, err := new(CheckpointData).Hash(fsm.backend.GetChainID(), stateBlock.Block.Number(), stateBlock.Block.Hash()) - require.NoError(t, err) - - stateBlock.Block.Header.Hash = proposalHash - proposal := stateBlock.Block.MarshalRLP() - - err = fsm.Validate(proposal) - require.ErrorContains(t, err, "invalid number") - } -} - -func TestFSM_Validate_TimestampOlder(t *testing.T) { - t.Parallel() - - const parentBlockNumber = 10 - - validators := validator.NewTestValidators(t, 5) - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: createTestExtra(validators.GetPublicIdentities(), validator.AccountSet{}, 4, 3, 3), - Timestamp: uint64(time.Now().UTC().Unix()), - } - parent.ComputeHash() - - // try some invalid times - for _, blockTime := range []uint64{parent.Timestamp - 1, parent.Timestamp} { - header := &types.Header{ - Number: parentBlockNumber + 1, - ParentHash: parent.Hash, - Timestamp: blockTime, - ExtraData: parent.ExtraData, - } - stateBlock := &types.FullBlock{Block: consensus.BuildBlock(consensus.BuildBlockParams{Header: header})} - fsm := &fsm{ - parent: parent, - backend: &blockchainMock{}, - validators: validators.ToValidatorSet(), - logger: hclog.NewNullLogger(), - config: &PolyBFTConfig{ - BlockTimeDrift: 1, - }} - - checkpointHash, err := new(CheckpointData).Hash(fsm.backend.GetChainID(), header.Number, header.Hash) - require.NoError(t, err) - - stateBlock.Block.Header.Hash = checkpointHash - proposal := stateBlock.Block.MarshalRLP() - - err = fsm.Validate(proposal) - assert.ErrorContains(t, err, "timestamp older than parent") - } -} - -func TestFSM_Validate_IncorrectMixHash(t *testing.T) { - t.Parallel() - - const parentBlockNumber = 10 - - validators := validator.NewTestValidators(t, 5) - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: createTestExtra(validators.GetPublicIdentities(), validator.AccountSet{}, 4, 3, 3), - Timestamp: uint64(100), - } - parent.ComputeHash() - - header := &types.Header{ - Number: parentBlockNumber + 1, - ParentHash: parent.Hash, - Timestamp: parent.Timestamp + 1, - MixHash: types.Hash{}, - ExtraData: parent.ExtraData, - } - - buildBlock := &types.FullBlock{Block: consensus.BuildBlock(consensus.BuildBlockParams{Header: header})} - - fsm := &fsm{ - parent: parent, - backend: &blockchainMock{}, - validators: validators.ToValidatorSet(), - logger: hclog.NewNullLogger(), - config: &PolyBFTConfig{ - BlockTimeDrift: 1, - }, - } - rlpBlock := buildBlock.Block.MarshalRLP() - - _, err := new(CheckpointData).Hash(fsm.backend.GetChainID(), header.Number, header.Hash) - require.NoError(t, err) - - err = fsm.Validate(rlpBlock) - assert.ErrorContains(t, err, "mix digest is not correct") -} - -func TestFSM_Insert_Good(t *testing.T) { - t.Parallel() - - const ( - accountCount = 5 - parentBlockNumber = uint64(10) - signaturesCount = 3 - ) - - setupFn := func() (*fsm, []*messages.CommittedSeal, *types.FullBlock, *blockchainMock) { - validators := validator.NewTestValidators(t, accountCount) - allAccounts := validators.GetPrivateIdentities() - validatorsMetadata := validators.GetPublicIdentities() - - extraParent := createTestExtra(validatorsMetadata, validator.AccountSet{}, len(allAccounts)-1, signaturesCount, signaturesCount) - parent := &types.Header{Number: parentBlockNumber, ExtraData: extraParent} - extraBlock := createTestExtra(validatorsMetadata, validator.AccountSet{}, len(allAccounts)-1, signaturesCount, signaturesCount) - block := consensus.BuildBlock( - consensus.BuildBlockParams{ - Header: &types.Header{Number: parentBlockNumber + 1, ParentHash: parent.Hash, ExtraData: extraBlock}, - }) - - builtBlock := &types.FullBlock{Block: block} - - builderMock := newBlockBuilderMock(builtBlock) - chainMock := &blockchainMock{} - chainMock.On("CommitBlock", mock.Anything).Return(error(nil)).Once() - chainMock.On("ProcessBlock", mock.Anything, mock.Anything). - Return(builtBlock, error(nil)). - Maybe() - - f := &fsm{ - parent: parent, - blockBuilder: builderMock, - target: builtBlock, - backend: chainMock, - validators: validator.NewValidatorSet(validatorsMetadata[0:len(validatorsMetadata)-1], hclog.NewNullLogger()), - logger: hclog.NewNullLogger(), - } - - seals := make([]*messages.CommittedSeal, signaturesCount) - - for i := 0; i < signaturesCount; i++ { - sign, err := allAccounts[i].Bls.Sign(builtBlock.Block.Hash().Bytes(), signer.DomainCheckpointManager) - require.NoError(t, err) - sigRaw, err := sign.Marshal() - require.NoError(t, err) - - seals[i] = &messages.CommittedSeal{ - Signer: validatorsMetadata[i].Address.Bytes(), - Signature: sigRaw, - } - } - - return f, seals, builtBlock, chainMock - } - - t.Run("Insert with target block defined", func(t *testing.T) { - t.Parallel() - - fsm, seals, builtBlock, chainMock := setupFn() - proposal := builtBlock.Block.MarshalRLP() - fullBlock, err := fsm.Insert(proposal, seals) - - require.NoError(t, err) - require.Equal(t, parentBlockNumber+1, fullBlock.Block.Number()) - chainMock.AssertExpectations(t) - }) - - t.Run("Insert with target block undefined", func(t *testing.T) { - t.Parallel() - - fsm, seals, builtBlock, _ := setupFn() - fsm.target = nil - proposal := builtBlock.Block.MarshalRLP() - _, err := fsm.Insert(proposal, seals) - - require.ErrorIs(t, err, errProposalDontMatch) - }) - - t.Run("Insert with target block hash not match", func(t *testing.T) { - t.Parallel() - - fsm, seals, builtBlock, _ := setupFn() - proposal := builtBlock.Block.MarshalRLP() - fsm.target = builtBlock - fsm.target.Block.Header.Hash = types.BytesToHash(generateRandomBytes(t)) - _, err := fsm.Insert(proposal, seals) - - require.ErrorIs(t, err, errProposalDontMatch) - }) -} - -func TestFSM_Insert_InvalidNode(t *testing.T) { - t.Parallel() - - const ( - accountCount = 5 - parentBlockNumber = 10 - signaturesCount = 3 - ) - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E"}) - validatorsMetadata := validators.GetPublicIdentities() - - parent := &types.Header{Number: parentBlockNumber} - parent.ComputeHash() - - extraBlock := createTestExtra(validatorsMetadata, validator.AccountSet{}, len(validators.Validators)-1, signaturesCount, signaturesCount) - finalBlock := consensus.BuildBlock( - consensus.BuildBlockParams{ - Header: &types.Header{Number: parentBlockNumber + 1, ParentHash: parent.Hash, ExtraData: extraBlock}, - }) - - buildBlock := &types.FullBlock{Block: finalBlock, Receipts: []*types.Receipt{}} - mBlockBuilder := newBlockBuilderMock(buildBlock) - - validatorSet := validator.NewValidatorSet(validatorsMetadata[0:len(validatorsMetadata)-1], hclog.NewNullLogger()) - - fsm := &fsm{parent: parent, blockBuilder: mBlockBuilder, backend: &blockchainMock{}, - validators: validatorSet, - } - - proposal := buildBlock.Block.MarshalRLP() - validatorA := validators.GetValidator("A") - validatorB := validators.GetValidator("B") - proposalHash := buildBlock.Block.Hash().Bytes() - sigA, err := validatorA.MustSign(proposalHash, signer.DomainCheckpointManager).Marshal() - require.NoError(t, err) - - sigB, err := validatorB.MustSign(proposalHash, signer.DomainCheckpointManager).Marshal() - require.NoError(t, err) - - // create test account outside of validator set - nonValidatorAccount := validator.NewTestValidator(t, "non_validator", 1) - nonValidatorSignature, err := nonValidatorAccount.MustSign(proposalHash, signer.DomainCheckpointManager).Marshal() - require.NoError(t, err) - - commitedSeals := []*messages.CommittedSeal{ - {Signer: validatorA.Address().Bytes(), Signature: sigA}, - {Signer: validatorB.Address().Bytes(), Signature: sigB}, - {Signer: nonValidatorAccount.Address().Bytes(), Signature: nonValidatorSignature}, // this one should fail - } - - fsm.target = buildBlock - - _, err = fsm.Insert(proposal, commitedSeals) - assert.ErrorContains(t, err, "invalid node id") -} - -func TestFSM_Height(t *testing.T) { - t.Parallel() - - parentNumber := uint64(3) - parent := &types.Header{Number: parentNumber} - fsm := &fsm{parent: parent} - assert.Equal(t, parentNumber+1, fsm.Height()) -} - -func TestFSM_DecodeCommitmentStateTxs(t *testing.T) { - t.Parallel() - - const ( - commitmentsCount = 8 - from = 15 - eventsSize = 40 - ) - - _, signedCommitment, _ := buildCommitmentAndStateSyncs(t, eventsSize, uint64(3), from) - - f := &fsm{ - proposerCommitmentToRegister: signedCommitment, - commitEpochInput: createTestCommitEpochInput(t, 0, 10), - distributeRewardsInput: createTestDistributeRewardsInput(t, 0, nil, 10), - logger: hclog.NewNullLogger(), - parent: &types.Header{}, - } - - bridgeCommitmentTx, err := f.createBridgeCommitmentTx() - require.NoError(t, err) - - decodedData, err := decodeStateTransaction(bridgeCommitmentTx.Input) - require.NoError(t, err) - - decodedCommitmentMsg, ok := decodedData.(*CommitmentMessageSigned) - require.True(t, ok) - require.Equal(t, signedCommitment, decodedCommitmentMsg) -} - -func TestFSM_DecodeCommitEpochStateTx(t *testing.T) { - t.Parallel() - - commitEpoch := createTestCommitEpochInput(t, 0, 10) - input, err := commitEpoch.EncodeAbi() - require.NoError(t, err) - require.NotNil(t, input) - - tx := createStateTransactionWithData(1, contracts.ValidatorSetContract, input) - decodedInputData, err := decodeStateTransaction(tx.Input) - require.NoError(t, err) - - decodedCommitEpoch, ok := decodedInputData.(*contractsapi.CommitEpochValidatorSetFn) - require.True(t, ok) - require.True(t, commitEpoch.ID.Cmp(decodedCommitEpoch.ID) == 0) - require.NotNil(t, decodedCommitEpoch.Epoch) - require.True(t, commitEpoch.Epoch.StartBlock.Cmp(decodedCommitEpoch.Epoch.StartBlock) == 0) - require.True(t, commitEpoch.Epoch.EndBlock.Cmp(decodedCommitEpoch.Epoch.EndBlock) == 0) -} - -func TestFSM_VerifyStateTransaction_ValidBothTypesOfStateTransactions(t *testing.T) { - t.Parallel() - - var ( - commitments [2]*PendingCommitment - stateSyncs [2][]*contractsapi.StateSyncedEvent - signedCommitments [2]*CommitmentMessageSigned - ) - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E"}) - commitments[0], signedCommitments[0], stateSyncs[0] = buildCommitmentAndStateSyncs(t, 10, uint64(3), 2) - commitments[1], signedCommitments[1], stateSyncs[1] = buildCommitmentAndStateSyncs(t, 10, uint64(3), 12) - - executeForValidators := func(aliases ...string) error { - for _, sc := range signedCommitments { - // add register commitment state transaction - hash, err := sc.Hash() - require.NoError(t, err) - signature := createSignature(t, validators.GetPrivateIdentities(aliases...), hash, signer.DomainStateReceiver) - sc.AggSignature = *signature - } - - f := &fsm{ - parent: &types.Header{Number: 9}, - isEndOfSprint: true, - validators: validators.ToValidatorSet(), - } - - var txns []*types.Transaction - - for i, sc := range signedCommitments { - inputData, err := sc.EncodeAbi() - require.NoError(t, err) - - if i == 0 { - tx := createStateTransactionWithData(1, contracts.StateReceiverContract, inputData) - txns = append(txns, tx) - } - } - - return f.VerifyStateTransactions(txns) - } - - assert.NoError(t, executeForValidators("A", "B", "C", "D")) - assert.ErrorContains(t, executeForValidators("A", "B", "C"), "quorum size not reached for state tx") -} - -func TestFSM_VerifyStateTransaction_InvalidTypeOfStateTransactions(t *testing.T) { - t.Parallel() - - f := &fsm{ - isEndOfSprint: true, - } - - var txns []*types.Transaction - txns = append(txns, - createStateTransactionWithData(1, contracts.StateReceiverContract, []byte{9, 3, 1, 1})) - - require.ErrorContains(t, f.VerifyStateTransactions(txns), "unknown state transaction") -} - -func TestFSM_VerifyStateTransaction_QuorumNotReached(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - _, commitmentMessageSigned, _ := buildCommitmentAndStateSyncs(t, 10, uint64(3), 2) - f := &fsm{ - parent: &types.Header{Number: 9}, - isEndOfSprint: true, - validators: validators.ToValidatorSet(), - } - - hash, err := commitmentMessageSigned.Hash() - require.NoError(t, err) - - var txns []*types.Transaction - - signature := createSignature(t, validators.GetPrivateIdentities("A", "B"), hash, signer.DomainStateReceiver) - commitmentMessageSigned.AggSignature = *signature - - inputData, err := commitmentMessageSigned.EncodeAbi() - require.NoError(t, err) - - txns = append(txns, - createStateTransactionWithData(1, contracts.StateReceiverContract, inputData)) - - err = f.VerifyStateTransactions(txns) - require.ErrorContains(t, err, "quorum size not reached for state tx") -} - -func TestFSM_VerifyStateTransaction_InvalidSignature(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - _, commitmentMessageSigned, _ := buildCommitmentAndStateSyncs(t, 10, uint64(3), 2) - f := &fsm{ - parent: &types.Header{Number: 9}, - isEndOfSprint: true, - validators: validators.ToValidatorSet(), - } - - hash, err := commitmentMessageSigned.Hash() - require.NoError(t, err) - - var txns []*types.Transaction - - signature := createSignature(t, validators.GetPrivateIdentities("A", "B", "C", "D"), hash, signer.DomainStateReceiver) - invalidValidator := validator.NewTestValidator(t, "G", 1) - invalidSignature, err := invalidValidator.MustSign([]byte("malicious message"), signer.DomainStateReceiver).Marshal() - require.NoError(t, err) - - commitmentMessageSigned.AggSignature = Signature{ - Bitmap: signature.Bitmap, - AggregatedSignature: invalidSignature, - } - - inputData, err := commitmentMessageSigned.EncodeAbi() - require.NoError(t, err) - - txns = append(txns, - createStateTransactionWithData(1, contracts.StateReceiverContract, inputData)) - - require.ErrorContains(t, f.VerifyStateTransactions(txns), "invalid signature for state tx") -} - -func TestFSM_VerifyStateTransaction_TwoCommitmentMessages(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - _, commitmentMessageSigned, _ := buildCommitmentAndStateSyncs(t, 10, uint64(3), 2) - - validatorSet := validator.NewValidatorSet(validators.GetPublicIdentities(), hclog.NewNullLogger()) - - f := &fsm{ - parent: &types.Header{Number: 9}, - isEndOfSprint: true, - validators: validatorSet, - } - - hash, err := commitmentMessageSigned.Hash() - require.NoError(t, err) - - var txns []*types.Transaction - - signature := createSignature(t, validators.GetPrivateIdentities("A", "B", "C", "D"), hash, signer.DomainStateReceiver) - commitmentMessageSigned.AggSignature = *signature - - inputData, err := commitmentMessageSigned.EncodeAbi() - require.NoError(t, err) - - txns = append(txns, - createStateTransactionWithData(1, contracts.StateReceiverContract, inputData)) - inputData, err = commitmentMessageSigned.EncodeAbi() - require.NoError(t, err) - - txns = append(txns, - createStateTransactionWithData(1, contracts.StateReceiverContract, inputData)) - err = f.VerifyStateTransactions(txns) - require.ErrorContains(t, err, "only one commitment tx is allowed per block") -} - -func TestFSM_Validate_FailToVerifySignatures(t *testing.T) { - t.Parallel() - - const ( - accountsCount = 5 - parentBlockNumber = 10 - signaturesCount = 3 - ) - - validators := validator.NewTestValidators(t, accountsCount) - validatorsMetadata := validators.GetPublicIdentities() - - extra := createTestExtraObject(validatorsMetadata, validator.AccountSet{}, 4, signaturesCount, signaturesCount) - validatorsHash, err := validatorsMetadata.Hash() - require.NoError(t, err) - - extra.Checkpoint = &CheckpointData{CurrentValidatorsHash: validatorsHash, NextValidatorsHash: validatorsHash} - parent := &types.Header{ - Number: parentBlockNumber, - ExtraData: extra.MarshalRLPTo(nil), - } - parent.ComputeHash() - - polybftBackendMock := new(polybftBackendMock) - polybftBackendMock.On("GetValidators", mock.Anything, mock.Anything).Return(validatorsMetadata, nil).Once() - - validatorSet := validator.NewValidatorSet(validatorsMetadata, hclog.NewNullLogger()) - - fsm := &fsm{ - parent: parent, - backend: &blockchainMock{}, - polybftBackend: polybftBackendMock, - validators: validatorSet, - logger: hclog.NewNullLogger(), - config: &PolyBFTConfig{ - BlockTimeDrift: 1, - }, - } - - finalBlock := consensus.BuildBlock(consensus.BuildBlockParams{ - Header: &types.Header{ - Number: parentBlockNumber + 1, - ParentHash: parent.Hash, - Timestamp: parent.Timestamp + 1, - MixHash: PolyBFTMixDigest, - Difficulty: 1, - ExtraData: parent.ExtraData, - }, - }) - - checkpointHash, err := new(CheckpointData).Hash(fsm.backend.GetChainID(), finalBlock.Number(), finalBlock.Hash()) - require.NoError(t, err) - - finalBlock.Header.Hash = checkpointHash - proposal := finalBlock.MarshalRLP() - - assert.ErrorContains(t, fsm.Validate(proposal), "failed to verify signatures") - - polybftBackendMock.AssertExpectations(t) -} - -func createDummyStateBlock(blockNumber uint64, parentHash types.Hash, extraData []byte) *types.FullBlock { - finalBlock := consensus.BuildBlock(consensus.BuildBlockParams{ - Header: &types.Header{ - Number: blockNumber, - ParentHash: parentHash, - Difficulty: 1, - ExtraData: extraData, - MixHash: PolyBFTMixDigest, - }, - }) - - return &types.FullBlock{Block: finalBlock} -} - -func createTestExtra( - allAccounts, - previousValidatorSet validator.AccountSet, - validatorsCount, - committedSignaturesCount, - parentSignaturesCount int, -) []byte { - extraData := createTestExtraObject(allAccounts, previousValidatorSet, validatorsCount, committedSignaturesCount, parentSignaturesCount) - - return extraData.MarshalRLPTo(nil) -} - -func createTestCommitment(t *testing.T, accounts []*wallet.Account) *CommitmentMessageSigned { - t.Helper() - - bitmap := bitmap.Bitmap{} - stateSyncEvents := make([]*contractsapi.StateSyncedEvent, len(accounts)) - - for i := 0; i < len(accounts); i++ { - stateSyncEvents[i] = &contractsapi.StateSyncedEvent{ - ID: big.NewInt(int64(i)), - Sender: types.Address(accounts[i].Ecdsa.Address()), - Receiver: types.Address(accounts[0].Ecdsa.Address()), - Data: []byte{}, - } - - bitmap.Set(uint64(i)) - } - - commitment, err := NewPendingCommitment(1, stateSyncEvents) - require.NoError(t, err) - - hash, err := commitment.Hash() - require.NoError(t, err) - - var signatures bls.Signatures - - for _, a := range accounts { - signature, err := a.Bls.Sign(hash.Bytes(), signer.DomainStateReceiver) - assert.NoError(t, err) - - signatures = append(signatures, signature) - } - - aggregatedSignature, err := signatures.Aggregate().Marshal() - assert.NoError(t, err) - - signature := Signature{ - AggregatedSignature: aggregatedSignature, - Bitmap: bitmap, - } - - assert.NoError(t, err) - - return &CommitmentMessageSigned{ - Message: commitment.StateSyncCommitment, - AggSignature: signature, - } -} - -func newBlockBuilderMock(stateBlock *types.FullBlock) *blockBuilderMock { - mBlockBuilder := new(blockBuilderMock) - mBlockBuilder.On("Build", mock.Anything).Return(stateBlock).Once() - mBlockBuilder.On("Fill", mock.Anything).Once() - mBlockBuilder.On("Reset", mock.Anything).Return(error(nil)).Once() - - return mBlockBuilder -} - -func createTestExtraObject(allAccounts, - previousValidatorSet validator.AccountSet, - validatorsCount, - committedSignaturesCount, - parentSignaturesCount int) *Extra { - accountCount := len(allAccounts) - dummySignature := [64]byte{} - bitmapCommitted, bitmapParent := bitmap.Bitmap{}, bitmap.Bitmap{} - extraData := &Extra{} - extraData.Validators = generateValidatorDelta(validatorsCount, allAccounts, previousValidatorSet) - - for j := range rand.Perm(accountCount)[:committedSignaturesCount] { - bitmapCommitted.Set(uint64(j)) - } - - for j := range rand.Perm(accountCount)[:parentSignaturesCount] { - bitmapParent.Set(uint64(j)) - } - - extraData.Parent = &Signature{Bitmap: bitmapCommitted, AggregatedSignature: dummySignature[:]} - extraData.Committed = &Signature{Bitmap: bitmapParent, AggregatedSignature: dummySignature[:]} - extraData.Checkpoint = &CheckpointData{} - - return extraData -} - -func generateValidatorDelta(validatorCount int, allAccounts, previousValidatorSet validator.AccountSet) (vd *validator.ValidatorSetDelta) { - oldMap := make(map[types.Address]int, previousValidatorSet.Len()) - for i, x := range previousValidatorSet { - oldMap[x.Address] = i - } - - vd = &validator.ValidatorSetDelta{} - vd.Removed = bitmap.Bitmap{} - - for _, id := range rand.Perm(len(allAccounts))[:validatorCount] { - _, exists := oldMap[allAccounts[id].Address] - if !exists { - vd.Added = append(vd.Added, allAccounts[id]) - } - - delete(oldMap, allAccounts[id].Address) - } - - for _, v := range oldMap { - vd.Removed.Set(uint64(v)) - } - - return -} diff --git a/consensus/polybft/handlers.go b/consensus/polybft/handlers.go deleted file mode 100644 index 2c45015..0000000 --- a/consensus/polybft/handlers.go +++ /dev/null @@ -1,38 +0,0 @@ -package polybft - -import ( - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" -) - -type PostBlockRequest struct { - // FullBlock is a reference of the executed block - FullBlock *types.FullBlock - // Epoch is the epoch number of the executed block - Epoch uint64 - // IsEpochEndingBlock indicates if this was the last block of given epoch - IsEpochEndingBlock bool - // DBTx is the opened transaction on state store (in our case boltDB) - // used to save necessary data on PostBlock - DBTx *bolt.Tx -} - -type PostEpochRequest struct { - // NewEpochID is the id of the new epoch - NewEpochID uint64 - - // FirstBlockOfEpoch is the number of the epoch beginning block - FirstBlockOfEpoch uint64 - - // SystemState is the state of the governance smart contracts - // after this block - SystemState SystemState - - // ValidatorSet is the validator set for the new epoch - ValidatorSet validator.ValidatorSet - - // DBTx is the opened transaction on state store (in our case boltDB) - // used to save necessary data on PostEpoch - DBTx *bolt.Tx -} diff --git a/consensus/polybft/hash.go b/consensus/polybft/hash.go deleted file mode 100644 index 9e48631..0000000 --- a/consensus/polybft/hash.go +++ /dev/null @@ -1,32 +0,0 @@ -package polybft - -import ( - "sync" - - "github.com/xgr-network/xgr-node/types" -) - -var setupHeaderHashFuncOnce sync.Once - -// polyBFTHeaderHash defines the custom implementation for getting the header hash, -// because of the extraData field -func setupHeaderHashFunc() { - setupHeaderHashFuncOnce.Do(func() { - originalHeaderHash := types.HeaderHash - - types.HeaderHash = func(h *types.Header) types.Hash { - // when hashing the block for signing we have to remove from - // the extra field the seal and committed seal items - extra, err := GetIbftExtraClean(h.ExtraData) - if err != nil { - return types.ZeroHash - } - - // override extra data without seals and committed seal items - hh := h.Copy() - hh.ExtraData = extra - - return originalHeaderHash(hh) - } - }) -} diff --git a/consensus/polybft/hash_test.go b/consensus/polybft/hash_test.go deleted file mode 100644 index bdd39cc..0000000 --- a/consensus/polybft/hash_test.go +++ /dev/null @@ -1,39 +0,0 @@ -package polybft - -import ( - "testing" - - "github.com/stretchr/testify/assert" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/types" -) - -func Test_setupHeaderHashFunc(t *testing.T) { - extra := &Extra{ - Validators: &validator.ValidatorSetDelta{Removed: bitmap.Bitmap{1}}, - Parent: createSignature(t, []*wallet.Account{generateTestAccount(t)}, types.ZeroHash, signer.DomainCheckpointManager), - Checkpoint: &CheckpointData{}, - Committed: &Signature{}, - } - - header := &types.Header{ - Number: 2, - GasLimit: 10000003, - Timestamp: 18, - } - - header.ExtraData = extra.MarshalRLPTo(nil) - notFullExtraHash := types.HeaderHash(header) - - extra.Committed = createSignature(t, []*wallet.Account{generateTestAccount(t)}, types.ZeroHash, signer.DomainCheckpointManager) - header.ExtraData = extra.MarshalRLPTo(nil) - fullExtraHash := types.HeaderHash(header) - - assert.Equal(t, notFullExtraHash, fullExtraHash) - - header.ExtraData = []byte{1, 2, 3, 4, 100, 200, 255} - assert.Equal(t, types.ZeroHash, types.HeaderHash(header)) // to small extra data -} diff --git a/consensus/polybft/helpers_test.go b/consensus/polybft/helpers_test.go deleted file mode 100644 index 63c39bb..0000000 --- a/consensus/polybft/helpers_test.go +++ /dev/null @@ -1,196 +0,0 @@ -package polybft - -import ( - "crypto/rand" - "fmt" - "math/big" - "os" - "path" - "testing" - "time" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/types" -) - -func createTestKey(t *testing.T) *wallet.Key { - t.Helper() - - return wallet.NewKey(generateTestAccount(t)) -} - -func createRandomTestKeys(t *testing.T, numberOfKeys int) []*wallet.Key { - t.Helper() - - result := make([]*wallet.Key, numberOfKeys, numberOfKeys) - - for i := 0; i < numberOfKeys; i++ { - result[i] = wallet.NewKey(generateTestAccount(t)) - } - - return result -} - -func createSignature(t *testing.T, accounts []*wallet.Account, hash types.Hash, domain []byte) *Signature { - t.Helper() - - var signatures bls.Signatures - - var bmp bitmap.Bitmap - for i, x := range accounts { - bmp.Set(uint64(i)) - - src, err := x.Bls.Sign(hash[:], domain) - require.NoError(t, err) - - signatures = append(signatures, src) - } - - aggs, err := signatures.Aggregate().Marshal() - require.NoError(t, err) - - return &Signature{AggregatedSignature: aggs, Bitmap: bmp} -} - -func createTestCommitEpochInput(t *testing.T, epochID uint64, - epochSize uint64) *contractsapi.CommitEpochValidatorSetFn { - t.Helper() - - var startBlock uint64 = 0 - if epochID > 1 { - startBlock = (epochID - 1) * epochSize - } - - commitEpoch := &contractsapi.CommitEpochValidatorSetFn{ - ID: new(big.Int).SetUint64(epochID), - Epoch: &contractsapi.Epoch{ - StartBlock: new(big.Int).SetUint64(startBlock + 1), - EndBlock: new(big.Int).SetUint64(epochSize * epochID), - EpochRoot: types.Hash{}, - }, - } - - return commitEpoch -} - -func createTestDistributeRewardsInput(t *testing.T, epochID uint64, - validatorSet validator.AccountSet, epochSize uint64) *contractsapi.DistributeRewardForRewardPoolFn { - t.Helper() - - if validatorSet == nil { - validatorSet = validator.NewTestValidators(t, 5).GetPublicIdentities() - } - - uptime := make([]*contractsapi.Uptime, len(validatorSet)) - - for i, v := range validatorSet { - uptime[i] = &contractsapi.Uptime{ - Validator: v.Address, - SignedBlocks: new(big.Int).SetUint64(epochSize), - } - } - - return &contractsapi.DistributeRewardForRewardPoolFn{ - EpochID: new(big.Int).SetUint64(epochID), - Uptime: uptime, - } -} - -func generateStateSyncEvents(t *testing.T, eventsCount int, startIdx uint64) []*contractsapi.StateSyncedEvent { - t.Helper() - - stateSyncEvents := make([]*contractsapi.StateSyncedEvent, eventsCount) - for i := 0; i < eventsCount; i++ { - stateSyncEvents[i] = &contractsapi.StateSyncedEvent{ - ID: big.NewInt(int64(startIdx + uint64(i))), - Sender: types.StringToAddress(fmt.Sprintf("0x5%d", i)), - Data: generateRandomBytes(t), - } - } - - return stateSyncEvents -} - -// generateRandomBytes generates byte array with random data of 32 bytes length -func generateRandomBytes(t *testing.T) (result []byte) { - t.Helper() - - result = make([]byte, types.HashLength) - _, err := rand.Reader.Read(result) - require.NoError(t, err, "Cannot generate random byte array content.") - - return -} - -// getEpochNumber returns epoch number for given blockNumber and epochSize. -// Epoch number is derived as a result of division of block number and epoch size. -// Since epoch number is 1-based (0 block represents special case zero epoch), -// we are incrementing result by one for non epoch-ending blocks. -func getEpochNumber(t *testing.T, blockNumber, epochSize uint64) uint64 { - t.Helper() - - if isEndOfPeriod(blockNumber, epochSize) { - return blockNumber / epochSize - } - - return blockNumber/epochSize + 1 -} - -// newTestState creates new instance of state used by tests. -func newTestState(tb testing.TB) *State { - tb.Helper() - - dir := fmt.Sprintf("/tmp/consensus-temp_%v", time.Now().UTC().Format(time.RFC3339Nano)) - err := os.Mkdir(dir, 0775) - - if err != nil { - tb.Fatal(err) - } - - state, err := newState(path.Join(dir, "my.db"), hclog.NewNullLogger(), make(chan struct{})) - if err != nil { - tb.Fatal(err) - } - - tb.Cleanup(func() { - if err := os.RemoveAll(dir); err != nil { - tb.Fatal(err) - } - }) - - return state -} - -func generateTestAccount(tb testing.TB) *wallet.Account { - tb.Helper() - - acc, err := wallet.GenerateAccount() - require.NoError(tb, err) - - return acc -} - -// createTestBridgeConfig creates test bridge configuration with hard-coded addresses -func createTestBridgeConfig() *BridgeConfig { - return &BridgeConfig{ - StateSenderAddr: types.StringToAddress("1"), - CheckpointManagerAddr: types.StringToAddress("2"), - ExitHelperAddr: types.StringToAddress("3"), - RootERC20PredicateAddr: types.StringToAddress("4"), - ChildMintableERC20PredicateAddr: types.StringToAddress("5"), - RootNativeERC20Addr: types.StringToAddress("6"), - RootERC721PredicateAddr: types.StringToAddress("8"), - ChildMintableERC721PredicateAddr: types.StringToAddress("9"), - RootERC1155PredicateAddr: types.StringToAddress("11"), - ChildMintableERC1155PredicateAddr: types.StringToAddress("12"), - CustomSupernetManagerAddr: types.StringToAddress("13"), - StakeManagerAddr: types.StringToAddress("14"), - JSONRPCEndpoint: "http://localhost:8545", - } -} diff --git a/consensus/polybft/ibft_consensus.go b/consensus/polybft/ibft_consensus.go deleted file mode 100644 index 5f7ebf7..0000000 --- a/consensus/polybft/ibft_consensus.go +++ /dev/null @@ -1,43 +0,0 @@ -package polybft - -import ( - "context" - - "github.com/0xPolygon/go-ibft/core" -) - -// IBFTConsensusWrapper is a convenience wrapper for the go-ibft package -type IBFTConsensusWrapper struct { - *core.IBFT -} - -func newIBFTConsensusWrapper( - logger core.Logger, - backend core.Backend, - transport core.Transport, -) *IBFTConsensusWrapper { - return &IBFTConsensusWrapper{ - IBFT: core.NewIBFT(logger, backend, transport), - } -} - -// runSequence starts the underlying consensus mechanism for the given height. -// It may be called by a single thread at any given time -// It returns channel which will be closed after c.IBFT.RunSequence is done -// and stopSequence function which can be used to halt c.IBFT.RunSequence routine from outside -func (c *IBFTConsensusWrapper) runSequence(height uint64) (<-chan struct{}, func()) { - sequenceDone := make(chan struct{}) - ctx, cancelSequence := context.WithCancel(context.Background()) - - go func() { - c.IBFT.RunSequence(ctx, height) - cancelSequence() - close(sequenceDone) - }() - - return sequenceDone, func() { - // stopSequence terminates the running IBFT sequence gracefully and waits for it to return - cancelSequence() - <-sequenceDone // waits until c.IBFT.RunSequenc routine finishes - } -} diff --git a/consensus/polybft/mocks_test.go b/consensus/polybft/mocks_test.go deleted file mode 100644 index c78e391..0000000 --- a/consensus/polybft/mocks_test.go +++ /dev/null @@ -1,401 +0,0 @@ -package polybft - -import ( - "time" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/mock" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/contract" - "github.com/xgr-network/xgr-node/blockchain" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/helper/progress" - "github.com/xgr-network/xgr-node/state" - "github.com/xgr-network/xgr-node/syncer" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" -) - -var _ blockchainBackend = (*blockchainMock)(nil) - -type blockchainMock struct { - mock.Mock -} - -func (m *blockchainMock) CurrentHeader() *types.Header { - args := m.Called() - - return args.Get(0).(*types.Header) //nolint:forcetypeassert -} - -func (m *blockchainMock) CommitBlock(block *types.FullBlock) error { - args := m.Called(block) - - return args.Error(0) -} - -func (m *blockchainMock) NewBlockBuilder(parent *types.Header, coinbase types.Address, - txPool txPoolInterface, blockTime time.Duration, logger hclog.Logger) (blockBuilder, error) { - args := m.Called() - - return args.Get(0).(blockBuilder), args.Error(1) //nolint:forcetypeassert -} - -func (m *blockchainMock) ProcessBlock(parent *types.Header, block *types.Block) (*types.FullBlock, error) { - args := m.Called(parent, block) - - return args.Get(0).(*types.FullBlock), args.Error(1) //nolint:forcetypeassert -} - -func (m *blockchainMock) GetStateProviderForBlock(block *types.Header) (contract.Provider, error) { - args := m.Called(block) - stateProvider, _ := args.Get(0).(contract.Provider) - - return stateProvider, nil -} - -func (m *blockchainMock) GetStateProvider(transition *state.Transition) contract.Provider { - args := m.Called() - stateProvider, _ := args.Get(0).(contract.Provider) - - return stateProvider -} - -func (m *blockchainMock) GetHeaderByNumber(number uint64) (*types.Header, bool) { - args := m.Called(number) - - if len(args) == 1 { - header, ok := args.Get(0).(*types.Header) - - if ok { - return header, true - } - - getHeaderCallback, ok := args.Get(0).(func(number uint64) *types.Header) - if ok { - h := getHeaderCallback(number) - - return h, h != nil - } - } else if len(args) == 2 { - return args.Get(0).(*types.Header), args.Get(1).(bool) //nolint:forcetypeassert - } - - panic("Unsupported mock for GetHeaderByNumber") //nolint:gocritic -} - -func (m *blockchainMock) GetHeaderByHash(hash types.Hash) (*types.Header, bool) { - args := m.Called(hash) - header, ok := args.Get(0).(*types.Header) - - if ok { - return header, true - } - - getHeaderCallback, ok := args.Get(0).(func(hash types.Hash) *types.Header) - if ok { - h := getHeaderCallback(hash) - - return h, h != nil - } - - panic("Unsupported mock for GetHeaderByHash") //nolint:gocritic -} - -func (m *blockchainMock) GetSystemState(provider contract.Provider) SystemState { - args := m.Called(provider) - - return args.Get(0).(SystemState) //nolint:forcetypeassert -} - -func (m *blockchainMock) SubscribeEvents() blockchain.Subscription { - return nil -} - -func (m *blockchainMock) UnubscribeEvents(blockchain.Subscription) { -} - -func (m *blockchainMock) CalculateGasLimit(number uint64) (uint64, error) { - return 0, nil -} - -func (m *blockchainMock) GetChainID() uint64 { - return 0 -} - -func (m *blockchainMock) GetReceiptsByHash(hash types.Hash) ([]*types.Receipt, error) { - args := m.Called(hash) - - return args.Get(0).([]*types.Receipt), args.Error(1) //nolint:forcetypeassert -} - -var _ polybftBackend = (*polybftBackendMock)(nil) - -type polybftBackendMock struct { - mock.Mock -} - -// GetValidators retrieves validator set for the given block -func (p *polybftBackendMock) GetValidators(blockNumber uint64, parents []*types.Header) (validator.AccountSet, error) { - args := p.Called(blockNumber, parents) - if len(args) == 1 { - accountSet, _ := args.Get(0).(validator.AccountSet) - - return accountSet, nil - } else if len(args) == 2 { - accountSet, _ := args.Get(0).(validator.AccountSet) - - return accountSet, args.Error(1) - } - - panic("polybftBackendMock.GetValidators doesn't support such combination of arguments") //nolint:gocritic -} - -func (p *polybftBackendMock) GetValidatorsWithTx(blockNumber uint64, parents []*types.Header, - dbTx *bolt.Tx) (validator.AccountSet, error) { - args := p.Called(blockNumber, parents, dbTx) - if len(args) == 1 { - accountSet, _ := args.Get(0).(validator.AccountSet) - - return accountSet, nil - } else if len(args) == 2 { - accountSet, _ := args.Get(0).(validator.AccountSet) - - return accountSet, args.Error(1) - } - - panic("polybftBackendMock.GetValidatorsWithTx doesn't support such combination of arguments") //nolint:gocritic -} - -var _ blockBuilder = (*blockBuilderMock)(nil) - -type blockBuilderMock struct { - mock.Mock -} - -func (m *blockBuilderMock) Reset() error { - args := m.Called() - if len(args) == 0 { - return nil - } - - return args.Error(0) -} - -func (m *blockBuilderMock) WriteTx(tx *types.Transaction) error { - args := m.Called(tx) - if len(args) == 0 { - return nil - } - - return args.Error(0) -} - -func (m *blockBuilderMock) Fill() { - m.Called() -} - -// Receipts returns the collection of transaction receipts for given block -func (m *blockBuilderMock) Receipts() []*types.Receipt { - args := m.Called() - - return args.Get(0).([]*types.Receipt) //nolint:forcetypeassert -} - -func (m *blockBuilderMock) Build(handler func(*types.Header)) (*types.FullBlock, error) { - args := m.Called(handler) - builtBlock := args.Get(0).(*types.FullBlock) //nolint:forcetypeassert - - handler(builtBlock.Block.Header) - - return builtBlock, nil -} - -func (m *blockBuilderMock) GetState() *state.Transition { - args := m.Called() - - return args.Get(0).(*state.Transition) //nolint:forcetypeassert -} - -var _ SystemState = (*systemStateMock)(nil) - -type systemStateMock struct { - mock.Mock -} - -func (m *systemStateMock) GetNextCommittedIndex() (uint64, error) { - args := m.Called() - - if len(args) == 1 { - index, _ := args.Get(0).(uint64) - - return index, nil - } else if len(args) == 2 { - index, _ := args.Get(0).(uint64) - - return index, args.Error(1) - } - - return 0, nil -} - -func (m *systemStateMock) GetEpoch() (uint64, error) { - args := m.Called() - if len(args) == 1 { - epochNumber, _ := args.Get(0).(uint64) - - return epochNumber, nil - } else if len(args) == 2 { - epochNumber, _ := args.Get(0).(uint64) - err, ok := args.Get(1).(error) - if ok { - return epochNumber, err - } - - return epochNumber, nil - } - - return 0, nil -} - -var _ contract.Provider = (*stateProviderMock)(nil) - -type stateProviderMock struct { - mock.Mock -} - -func (s *stateProviderMock) Call(ethgo.Address, []byte, *contract.CallOpts) ([]byte, error) { - return nil, nil -} - -func (s *stateProviderMock) Txn(ethgo.Address, ethgo.Key, []byte) (contract.Txn, error) { - return nil, nil -} - -var _ BridgeTransport = (*transportMock)(nil) - -type transportMock struct { - mock.Mock -} - -func (t *transportMock) Multicast(msg interface{}) { - _ = t.Called(msg) -} - -type testHeadersMap struct { - headersByNumber map[uint64]*types.Header -} - -func (t *testHeadersMap) addHeader(header *types.Header) { - if t.headersByNumber == nil { - t.headersByNumber = map[uint64]*types.Header{} - } - - t.headersByNumber[header.Number] = header -} - -func (t *testHeadersMap) getHeader(number uint64) *types.Header { - return t.headersByNumber[number] -} - -func (t *testHeadersMap) getHeaderByHash(hash types.Hash) *types.Header { - for _, header := range t.headersByNumber { - if header.Hash == hash { - return header - } - } - - return nil -} - -func (t *testHeadersMap) getHeaders() []*types.Header { - headers := make([]*types.Header, 0, len(t.headersByNumber)) - for _, header := range t.headersByNumber { - headers = append(headers, header) - } - - return headers -} - -var _ txPoolInterface = (*txPoolMock)(nil) - -type txPoolMock struct { - mock.Mock -} - -func (tp *txPoolMock) Prepare() { - tp.Called() -} - -func (tp *txPoolMock) Length() uint64 { - args := tp.Called() - - return args[0].(uint64) //nolint -} - -func (tp *txPoolMock) Peek() *types.Transaction { - args := tp.Called() - - return args[0].(*types.Transaction) //nolint -} - -func (tp *txPoolMock) Pop(tx *types.Transaction) { - tp.Called(tx) -} - -func (tp *txPoolMock) Drop(tx *types.Transaction) { - tp.Called(tx) -} - -func (tp *txPoolMock) Demote(tx *types.Transaction) { - tp.Called(tx) -} - -func (tp *txPoolMock) SetSealing(v bool) { - tp.Called(v) -} - -func (tp *txPoolMock) ResetWithHeaders(values ...*types.Header) { - tp.Called(values) -} - -var _ syncer.Syncer = (*syncerMock)(nil) - -type syncerMock struct { - mock.Mock -} - -func (tp *syncerMock) Start() error { - args := tp.Called() - - return args.Error(0) -} - -func (tp *syncerMock) Close() error { - args := tp.Called() - - return args.Error(0) -} - -func (tp *syncerMock) GetSyncProgression() *progress.Progression { - args := tp.Called() - - return args[0].(*progress.Progression) //nolint -} - -func (tp *syncerMock) HasSyncPeer() bool { - args := tp.Called() - - return args[0].(bool) //nolint -} - -func (tp *syncerMock) Sync(func(*types.FullBlock) bool) error { - args := tp.Called() - - return args.Error(0) -} - -func init() { - // setup custom hash header func - setupHeaderHashFunc() -} diff --git a/consensus/polybft/polybft.go b/consensus/polybft/polybft.go deleted file mode 100644 index d18ba7e..0000000 --- a/consensus/polybft/polybft.go +++ /dev/null @@ -1,848 +0,0 @@ -// Package polybft implements PBFT consensus algorithm integration and bridge feature -package polybft - -import ( - "context" - "encoding/json" - "errors" - "fmt" - "math/big" - "path/filepath" - "time" - - "github.com/hashicorp/go-hclog" - bolt "go.etcd.io/bbolt" - - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/consensus" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/forkmanager" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/helper/progress" - "github.com/xgr-network/xgr-node/network" - "github.com/xgr-network/xgr-node/state" - "github.com/xgr-network/xgr-node/syncer" - "github.com/xgr-network/xgr-node/types" -) - -const ( - minSyncPeers = 2 - pbftProto = "/pbft/0.2" - bridgeProto = "/bridge/0.2" -) - -var ( - errMissingBridgeConfig = errors.New("invalid genesis configuration, missing bridge configuration") -) - -// polybftBackend is an interface defining polybft methods needed by fsm and sync tracker -type polybftBackend interface { - // GetValidators retrieves validator set for the given block - GetValidators(blockNumber uint64, parents []*types.Header) (validator.AccountSet, error) - - // GetValidators retrieves validator set for the given block - // Function expects that db tx is already open - GetValidatorsWithTx(blockNumber uint64, parents []*types.Header, - dbTx *bolt.Tx) (validator.AccountSet, error) -} - -// Factory is the factory function to create a discovery consensus -func Factory(params *consensus.Params) (consensus.Consensus, error) { - logger := params.Logger.Named("polybft") - - setupHeaderHashFunc() - - polybft := &Polybft{ - config: params, - closeCh: make(chan struct{}), - logger: logger, - txPool: params.TxPool, - } - - // initialize polybft consensus config - customConfigJSON, err := json.Marshal(params.Config.Config) - if err != nil { - return nil, err - } - - err = json.Unmarshal(customConfigJSON, &polybft.consensusConfig) - if err != nil { - return nil, err - } - - return polybft, nil -} - -type Polybft struct { - // closeCh is used to signal that consensus protocol is stopped - closeCh chan struct{} - - // ibft is the ibft engine - ibft *IBFTConsensusWrapper - - // state is reference to the struct which encapsulates consensus data persistence logic - state *State - - // consensus parameters - config *consensus.Params - - // consensusConfig is genesis configuration for polybft consensus protocol - consensusConfig *PolyBFTConfig - - // blockchain is a reference to the blockchain object - blockchain blockchainBackend - - // runtime handles consensus runtime features like epoch, state and event management - runtime *consensusRuntime - - // block time duration - blockTime time.Duration - - // dataDir is the data directory to store the info - dataDir string - - // reference to the syncer - syncer syncer.Syncer - - // topic for consensus engine messages - consensusTopic *network.Topic - - // topic for bridge messages - bridgeTopic *network.Topic - - // key encapsulates ECDSA address and BLS signing logic - key *wallet.Key - - // validatorsCache represents cache of validators snapshots - validatorsCache *validatorsSnapshotCache - - // logger - logger hclog.Logger - - // tx pool as interface - txPool txPoolInterface -} - -func GenesisPostHookFactory(config *chain.Chain, engineName string) func(txn *state.Transition) error { - return func(transition *state.Transition) error { - polyBFTConfig, err := GetPolyBFTConfig(config) - if err != nil { - return err - } - - // calculate initial total supply of native erc20 token - // we skip zero address, since its a special case address - // that is used for minting and burning native token - initialTotalSupply := big.NewInt(0) - - for addr, alloc := range config.Genesis.Alloc { - if addr == types.ZeroAddress { - continue - } - - initialTotalSupply.Add(initialTotalSupply, alloc.Balance) - } - - bridgeCfg := polyBFTConfig.Bridge - if bridgeCfg == nil { - return errMissingBridgeConfig - } - - proxyAddrMapping := contracts.GetProxyImplementationMapping() - - burnContractAddress, isBurnContractSet := getBurnContractAddress(config, polyBFTConfig) - if isBurnContractSet { - proxyAddrMapping[contracts.DefaultBurnContract] = burnContractAddress - } - - if _, ok := config.Genesis.Alloc[contracts.RewardTokenContract]; ok { - proxyAddrMapping[contracts.RewardTokenContract] = contracts.RewardTokenContractV1 - } - - if err = initProxies(transition, polyBFTConfig.ProxyContractsAdmin, proxyAddrMapping); err != nil { - return err - } - - // initialize ValidatorSet SC - if err = initValidatorSet(polyBFTConfig, transition); err != nil { - return err - } - - // approve reward pool - if err = approveRewardPoolAsSpender(polyBFTConfig, transition); err != nil { - return err - } - - // mint reward tokens to reward wallet - if err = mintRewardTokensToWallet(polyBFTConfig, transition); err != nil { - return err - } - - // initialize RewardPool SC - if err = initRewardPool(polyBFTConfig, transition); err != nil { - return err - } - - // check if there are Bridge Allow List Admins and Bridge Block List Admins - // and if there are, get the first address as the Admin - bridgeAllowListAdmin := types.ZeroAddress - if config.Params.BridgeAllowList != nil && len(config.Params.BridgeAllowList.AdminAddresses) > 0 { - bridgeAllowListAdmin = config.Params.BridgeAllowList.AdminAddresses[0] - } - - bridgeBlockListAdmin := types.ZeroAddress - if config.Params.BridgeBlockList != nil && len(config.Params.BridgeBlockList.AdminAddresses) > 0 { - bridgeBlockListAdmin = config.Params.BridgeBlockList.AdminAddresses[0] - } - - // initialize Predicate SCs - if bridgeAllowListAdmin != types.ZeroAddress || bridgeBlockListAdmin != types.ZeroAddress { - // The owner of the contract will be the allow list admin or the block list admin, if any of them is set. - owner := contracts.SystemCaller - useBridgeAllowList := bridgeAllowListAdmin != types.ZeroAddress - useBridgeBlockList := bridgeBlockListAdmin != types.ZeroAddress - - if bridgeAllowListAdmin != types.ZeroAddress { - owner = bridgeAllowListAdmin - } else if bridgeBlockListAdmin != types.ZeroAddress { - owner = bridgeBlockListAdmin - } - - // initialize ChildERC20PredicateAccessList SC - input, err := getInitERC20PredicateACLInput(polyBFTConfig.Bridge, owner, - useBridgeAllowList, useBridgeBlockList, false) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.ChildERC20PredicateContract, input, - "ChildERC20PredicateAccessList", transition); err != nil { - return err - } - - // initialize ChildERC721PredicateAccessList SC - input, err = getInitERC721PredicateACLInput(polyBFTConfig.Bridge, owner, - useBridgeAllowList, useBridgeBlockList, false) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.ChildERC721PredicateContract, input, - "ChildERC721PredicateAccessList", transition); err != nil { - return err - } - - // initialize ChildERC1155PredicateAccessList SC - input, err = getInitERC1155PredicateACLInput(polyBFTConfig.Bridge, owner, - useBridgeAllowList, useBridgeBlockList, false) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.ChildERC1155PredicateContract, input, - "ChildERC1155PredicateAccessList", transition); err != nil { - return err - } - - // initialize RootMintableERC20PredicateAccessList SC - input, err = getInitERC20PredicateACLInput(polyBFTConfig.Bridge, owner, - useBridgeAllowList, useBridgeBlockList, true) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.RootMintableERC20PredicateContract, input, - "RootMintableERC20PredicateAccessList", transition); err != nil { - return err - } - - // initialize RootMintableERC721PredicateAccessList SC - input, err = getInitERC721PredicateACLInput(polyBFTConfig.Bridge, owner, - useBridgeAllowList, useBridgeBlockList, true) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.RootMintableERC721PredicateContract, input, - "RootMintableERC721PredicateAccessList", transition); err != nil { - return err - } - - // initialize RootMintableERC1155PredicateAccessList SC - input, err = getInitERC1155PredicateACLInput(polyBFTConfig.Bridge, owner, - useBridgeAllowList, useBridgeBlockList, true) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.RootMintableERC1155PredicateContract, input, - "RootMintableERC1155PredicateAccessList", transition); err != nil { - return err - } - } else { - // initialize ChildERC20Predicate SC - input, err := getInitERC20PredicateInput(bridgeCfg, false) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.ChildERC20PredicateContract, input, - "ChildERC20Predicate", transition); err != nil { - return err - } - - // initialize ChildERC721Predicate SC - input, err = getInitERC721PredicateInput(bridgeCfg, false) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.ChildERC721PredicateContract, input, - "ChildERC721Predicate", transition); err != nil { - return err - } - - // initialize ChildERC1155Predicate SC - input, err = getInitERC1155PredicateInput(bridgeCfg, false) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.ChildERC1155PredicateContract, input, - "ChildERC1155Predicate", transition); err != nil { - return err - } - - // initialize RootMintableERC20Predicate SC - input, err = getInitERC20PredicateInput(bridgeCfg, true) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.RootMintableERC20PredicateContract, input, - "RootMintableERC20Predicate", transition); err != nil { - return err - } - - // initialize RootMintableERC721Predicate SC - input, err = getInitERC721PredicateInput(bridgeCfg, true) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.RootMintableERC721PredicateContract, input, - "RootMintableERC721Predicate", transition); err != nil { - return err - } - - // initialize RootMintableERC1155Predicate SC - input, err = getInitERC1155PredicateInput(bridgeCfg, true) - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, contracts.RootMintableERC1155PredicateContract, input, - "RootMintableERC1155Predicate", transition); err != nil { - return err - } - } - - if polyBFTConfig.NativeTokenConfig.IsMintable { - // initialize NativeERC20Mintable SC - params := &contractsapi.InitializeNativeERC20MintableFn{ - Predicate_: contracts.ChildERC20PredicateContract, - Owner_: polyBFTConfig.NativeTokenConfig.Owner, - RootToken_: types.ZeroAddress, // in case native mintable token is used, it is always root token - Name_: polyBFTConfig.NativeTokenConfig.Name, - Symbol_: polyBFTConfig.NativeTokenConfig.Symbol, - Decimals_: polyBFTConfig.NativeTokenConfig.Decimals, - TokenSupply_: initialTotalSupply, - } - - input, err := params.EncodeAbi() - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, - contracts.NativeERC20TokenContract, input, "NativeERC20Mintable", transition); err != nil { - return err - } - } else { - // initialize NativeERC20 SC - params := &contractsapi.InitializeNativeERC20Fn{ - Name_: polyBFTConfig.NativeTokenConfig.Name, - Symbol_: polyBFTConfig.NativeTokenConfig.Symbol, - Decimals_: polyBFTConfig.NativeTokenConfig.Decimals, - RootToken_: polyBFTConfig.Bridge.RootNativeERC20Addr, - Predicate_: contracts.ChildERC20PredicateContract, - TokenSupply_: initialTotalSupply, - } - - input, err := params.EncodeAbi() - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, - contracts.NativeERC20TokenContract, input, "NativeERC20", transition); err != nil { - return err - } - - // initialize EIP1559Burn SC - if isBurnContractSet { - burnParams := &contractsapi.InitializeEIP1559BurnFn{ - NewChildERC20Predicate: contracts.ChildERC20PredicateContract, - NewBurnDestination: config.Params.BurnContractDestinationAddress, - } - - input, err = burnParams.EncodeAbi() - if err != nil { - return err - } - - if err = callContract(contracts.SystemCaller, - burnContractAddress, - input, "EIP1559Burn", transition); err != nil { - return err - } - } - } - - return nil - } -} - -func ForkManagerFactory(forks *chain.Forks) error { - // place fork manager handler registration here - return nil -} - -// Initialize initializes the consensus (e.g. setup data) -func (p *Polybft) Initialize() error { - p.logger.Info("initializing polybft...") - - // read account - account, err := wallet.NewAccountFromSecret(p.config.SecretsManager) - if err != nil { - return fmt.Errorf("failed to read account data. Error: %w", err) - } - - // set key - p.key = wallet.NewKey(account) - - // create and set syncer - p.syncer = syncer.NewSyncer( - p.config.Logger.Named("syncer"), - p.config.Network, - p.config.Blockchain, - time.Duration(p.config.BlockTime)*3*time.Second, - ) - - // set blockchain backend - p.blockchain = &blockchainWrapper{ - blockchain: p.config.Blockchain, - executor: p.config.Executor, - } - - // create bridge and consensus topics - if err = p.createTopics(); err != nil { - return fmt.Errorf("cannot create topics: %w", err) - } - - // set block time - p.blockTime = time.Duration(p.config.BlockTime) - - // initialize polybft consensus data directory - p.dataDir = filepath.Join(p.config.Config.Path, "polybft") - // create the data dir if not exists - if err = common.CreateDirSafe(p.dataDir, 0750); err != nil { - return fmt.Errorf("failed to create data directory. Error: %w", err) - } - - stt, err := newState(filepath.Join(p.dataDir, stateFileName), p.logger, p.closeCh) - if err != nil { - return fmt.Errorf("failed to create state instance. Error: %w", err) - } - - p.state = stt - p.validatorsCache = newValidatorsSnapshotCache(p.config.Logger, stt, p.blockchain) - - // create runtime - if err := p.initRuntime(); err != nil { - return err - } - - p.ibft = newIBFTConsensusWrapper(p.logger, p.runtime, p) - - if err = p.subscribeToIbftTopic(); err != nil { - return fmt.Errorf("IBFT topic subscription failed: %w", err) - } - - return nil -} - -func ForkManagerInitialParamsFactory(config *chain.Chain) (*forkmanager.ForkParams, error) { - pbftConfig, err := GetPolyBFTConfig(config) - if err != nil { - return nil, err - } - - return &forkmanager.ForkParams{ - MaxValidatorSetSize: &pbftConfig.MaxValidatorSetSize, - EpochSize: &pbftConfig.EpochSize, - SprintSize: &pbftConfig.SprintSize, - BlockTime: &pbftConfig.BlockTime, - BlockTimeDrift: &pbftConfig.BlockTimeDrift, - }, nil -} - -// Start starts the consensus and servers -func (p *Polybft) Start() error { - p.logger.Info("starting polybft consensus", "signer", p.key.String()) - - // start syncer (also initializes peer map) - if err := p.syncer.Start(); err != nil { - return fmt.Errorf("failed to start syncer. Error: %w", err) - } - - // sync concurrently, retrying indefinitely - go common.RetryForever(context.Background(), time.Second, func(context.Context) error { - blockHandler := func(b *types.FullBlock) bool { - p.runtime.OnBlockInserted(b) - - return false - } - if err := p.syncer.Sync(blockHandler); err != nil { - p.logger.Error("blocks synchronization failed", "error", err) - - return err - } - - return nil - }) - - // start consensus runtime - if err := p.startRuntime(); err != nil { - return fmt.Errorf("consensus runtime start failed: %w", err) - } - - // start state DB process - go p.state.startStatsReleasing() - - // polybft rootchain metrics - go p.publishRootchainMetrics(p.logger.Named("rootchain_metrics")) - - return nil -} - -// initRuntime creates consensus runtime -func (p *Polybft) initRuntime() error { - runtimeConfig := &runtimeConfig{ - PolyBFTConfig: p.consensusConfig, - Key: p.key, - DataDir: p.dataDir, - State: p.state, - blockchain: p.blockchain, - polybftBackend: p, - txPool: p.txPool, - bridgeTopic: p.bridgeTopic, - numBlockConfirmations: p.config.NumBlockConfirmations, - consensusConfig: p.config.Config, - } - - runtime, err := newConsensusRuntime(p.logger, runtimeConfig) - if err != nil { - return err - } - - p.runtime = runtime - - return nil -} - -// startRuntime starts consensus runtime -func (p *Polybft) startRuntime() error { - go p.startConsensusProtocol() - - return nil -} - -func (p *Polybft) startConsensusProtocol() { - // wait to have at least n peers connected. The 2 is just an initial heuristic value - // Most likely we will parametrize this in the future. - if !p.waitForNPeers() { - return - } - - p.logger.Debug("peers connected") - - newBlockSub := p.blockchain.SubscribeEvents() - defer p.blockchain.UnubscribeEvents(newBlockSub) - - syncerBlockCh := make(chan struct{}) - - go func() { - eventCh := newBlockSub.GetEventCh() - - for { - select { - case <-p.closeCh: - return - case ev := <-eventCh: - // The blockchain notification system can eventually deliver - // stale block notifications. These should be ignored - if ev.Source == "syncer" && ev.NewChain[0].Number >= p.blockchain.CurrentHeader().Number { - p.logger.Info("sync block notification received", "block height", ev.NewChain[0].Number, - "current height", p.blockchain.CurrentHeader().Number) - syncerBlockCh <- struct{}{} - } - } - } - }() - - var ( - sequenceCh <-chan struct{} - stopSequence func() - ) - - for { - latestHeader := p.blockchain.CurrentHeader() - - currentValidators, err := p.GetValidators(latestHeader.Number, nil) - if err != nil { - p.logger.Error("failed to query current validator set", "block number", latestHeader.Number, "error", err) - } - - isValidator := currentValidators.ContainsNodeID(p.key.String()) - p.runtime.setIsActiveValidator(isValidator) - - p.txPool.SetSealing(isValidator) // update tx pool - - if isValidator { - // initialize FSM as a stateless ibft backend via runtime as an adapter - err = p.runtime.FSM() - if err != nil { - p.logger.Error("failed to create fsm", "block number", latestHeader.Number, "error", err) - - continue - } - - sequenceCh, stopSequence = p.ibft.runSequence(latestHeader.Number + 1) - } - - now := time.Now().UTC() - - select { - case <-syncerBlockCh: - if isValidator { - stopSequence() - p.logger.Info("canceled sequence", "sequence", latestHeader.Number+1) - } - case <-sequenceCh: - case <-p.closeCh: - if isValidator { - stopSequence() - } - - return - } - - p.logger.Debug("time to run the sequence", "seconds", time.Since(now)) - } -} - -func (p *Polybft) waitForNPeers() bool { - for { - select { - case <-p.closeCh: - return false - case <-time.After(2 * time.Second): - } - - if len(p.config.Network.Peers()) >= minSyncPeers { - break - } - } - - return true -} - -// Close closes the connection -func (p *Polybft) Close() error { - if p.syncer != nil { - if err := p.syncer.Close(); err != nil { - return err - } - } - - close(p.closeCh) - p.runtime.close() - - return nil -} - -// GetSyncProgression retrieves the current sync progression, if any -func (p *Polybft) GetSyncProgression() *progress.Progression { - return p.syncer.GetSyncProgression() -} - -// VerifyHeader implements consensus.Engine and checks whether a header conforms to the consensus rules -func (p *Polybft) VerifyHeader(header *types.Header) error { - // Short circuit if the header is known - if _, ok := p.blockchain.GetHeaderByHash(header.Hash); ok { - return nil - } - - parent, ok := p.blockchain.GetHeaderByHash(header.ParentHash) - if !ok { - return fmt.Errorf( - "unable to get parent header by hash for block number %d", - header.Number, - ) - } - - return p.verifyHeaderImpl(parent, header, p.consensusConfig.BlockTimeDrift, nil) -} - -func (p *Polybft) verifyHeaderImpl(parent, header *types.Header, blockTimeDrift uint64, parents []*types.Header) error { - // validate header fields - if err := validateHeaderFields(parent, header, blockTimeDrift); err != nil { - return fmt.Errorf("failed to validate header for block %d. error = %w", header.Number, err) - } - - // decode the extra data - extra, err := GetIbftExtra(header.ExtraData) - if err != nil { - return fmt.Errorf("failed to verify header for block %d. get extra error = %w", header.Number, err) - } - - // validate extra data - return extra.ValidateFinalizedData( - header, parent, parents, p.blockchain.GetChainID(), p, signer.DomainCheckpointManager, p.logger) -} - -func (p *Polybft) GetValidators(blockNumber uint64, parents []*types.Header) (validator.AccountSet, error) { - return p.validatorsCache.GetSnapshot(blockNumber, parents, nil) -} - -func (p *Polybft) GetValidatorsWithTx(blockNumber uint64, parents []*types.Header, - dbTx *bolt.Tx) (validator.AccountSet, error) { - return p.validatorsCache.GetSnapshot(blockNumber, parents, dbTx) -} - -// ProcessHeaders updates the snapshot based on the verified headers -func (p *Polybft) ProcessHeaders(_ []*types.Header) error { - // Not required - return nil -} - -// GetBlockCreator retrieves the block creator (or signer) given the block header -func (p *Polybft) GetBlockCreator(h *types.Header) (types.Address, error) { - return types.BytesToAddress(h.Miner), nil -} - -// PreCommitState a hook to be called before finalizing state transition on inserting block -func (p *Polybft) PreCommitState(block *types.Block, _ *state.Transition) error { - commitmentTxExists := false - - validators, err := p.GetValidators(block.Number()-1, nil) - if err != nil { - return err - } - - // validate commitment state transactions - for _, tx := range block.Transactions { - if tx.Type != types.StateTx { - continue - } - - decodedStateTx, err := decodeStateTransaction(tx.Input) - if err != nil { - return fmt.Errorf("unknown state transaction: tx=%v, error: %w", tx.Hash, err) - } - - if signedCommitment, ok := decodedStateTx.(*CommitmentMessageSigned); ok { - if commitmentTxExists { - return fmt.Errorf("only one commitment state tx is allowed per block: %v", tx.Hash) - } - - commitmentTxExists = true - - if err := verifyBridgeCommitmentTx( - block.Number(), - tx.Hash, - signedCommitment, - validator.NewValidatorSet(validators, p.logger)); err != nil { - return err - } - } - } - - return nil -} - -// GetBridgeProvider is an implementation of Consensus interface -// Returns an instance of BridgeDataProvider -func (p *Polybft) GetBridgeProvider() consensus.BridgeDataProvider { - return p.runtime -} - -// FilterExtra is an implementation of Consensus interface -func (p *Polybft) FilterExtra(extra []byte) ([]byte, error) { - return GetIbftExtraClean(extra) -} - -// initProxies initializes proxy contracts, that allow upgradeability of contracts implementation -func initProxies(transition *state.Transition, admin types.Address, - proxyToImplMap map[types.Address]types.Address) error { - for proxyAddress, implAddress := range proxyToImplMap { - protectSetupProxyFn := &contractsapi.ProtectSetUpProxyGenesisProxyFn{Initiator: contracts.SystemCaller} - - proxyInput, err := protectSetupProxyFn.EncodeAbi() - if err != nil { - return fmt.Errorf("GenesisProxy.protectSetUpProxy params encoding failed: %w", err) - } - - err = callContract(contracts.SystemCaller, proxyAddress, proxyInput, "GenesisProxy.protectSetUpProxy", transition) - if err != nil { - return err - } - - setUpproxyFn := &contractsapi.SetUpProxyGenesisProxyFn{ - Logic: implAddress, - Admin: admin, - Data: []byte{}, - } - - proxyInput, err = setUpproxyFn.EncodeAbi() - if err != nil { - return fmt.Errorf("GenesisProxy.setUpProxy params encoding failed: %w", err) - } - - err = callContract(contracts.SystemCaller, proxyAddress, proxyInput, "GenesisProxy.setUpProxy", transition) - if err != nil { - return err - } - } - - return nil -} - -func getBurnContractAddress(config *chain.Chain, polyBFTConfig PolyBFTConfig) (types.Address, bool) { - if config.Params.BurnContract != nil && - len(config.Params.BurnContract) == 1 && - !polyBFTConfig.NativeTokenConfig.IsMintable { - for _, address := range config.Params.BurnContract { - if _, ok := config.Genesis.Alloc[address]; ok { - return address, true - } - } - } - - return types.ZeroAddress, false -} diff --git a/consensus/polybft/polybft_config.go b/consensus/polybft/polybft_config.go deleted file mode 100644 index 29a3957..0000000 --- a/consensus/polybft/polybft_config.go +++ /dev/null @@ -1,316 +0,0 @@ -package polybft - -import ( - "encoding/json" - "errors" - "math" - "math/big" - "strconv" - "strings" - - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/types" -) - -const ( - ConsensusName = "polybft" - minNativeTokenParamsNumber = 4 - - defaultNativeTokenName = "Polygon" - defaultNativeTokenSymbol = "MATIC" - defaultNativeTokenDecimals = uint8(18) -) - -var ( - DefaultTokenConfig = &TokenConfig{ - Name: defaultNativeTokenName, - Symbol: defaultNativeTokenSymbol, - Decimals: defaultNativeTokenDecimals, - IsMintable: false, - Owner: types.ZeroAddress, - } - - errInvalidTokenParams = errors.New("native token params were not submitted in proper format " + - "()") -) - -// PolyBFTConfig is the configuration file for the Polybft consensus protocol. -type PolyBFTConfig struct { - // InitialValidatorSet are the genesis validators - InitialValidatorSet []*validator.GenesisValidator `json:"initialValidatorSet"` - - // Bridge is the rootchain bridge configuration - Bridge *BridgeConfig `json:"bridge"` - - // EpochSize is size of epoch - EpochSize uint64 `json:"epochSize"` - - // EpochReward is assigned to validators for blocks sealing - EpochReward uint64 `json:"epochReward"` - - // SprintSize is size of sprint - SprintSize uint64 `json:"sprintSize"` - - // BlockTime is target frequency of blocks production - BlockTime common.Duration `json:"blockTime"` - - // Governance is the initial governance address - Governance types.Address `json:"governance"` - - // NativeTokenConfig defines name, symbol and decimal count of the native token - NativeTokenConfig *TokenConfig `json:"nativeTokenConfig"` - - InitialTrieRoot types.Hash `json:"initialTrieRoot"` - - // SupernetID indicates ID of given supernet generated by stake manager contract - SupernetID int64 `json:"supernetID"` - - // MinValidatorSetSize indicates the minimum size of validator set - MinValidatorSetSize uint64 `json:"minValidatorSetSize"` - - // MaxValidatorSetSize indicates the maximum size of validator set - MaxValidatorSetSize uint64 `json:"maxValidatorSetSize"` - - // RewardConfig defines rewards configuration - RewardConfig *RewardsConfig `json:"rewardConfig"` - - // BlockTimeDrift defines the time slot in which a new block can be created - BlockTimeDrift uint64 `json:"blockTimeDrift"` - - // BlockTrackerPollInterval specifies interval - // at which block tracker polls for blocks on a rootchain - BlockTrackerPollInterval common.Duration `json:"blockTrackerPollInterval,omitempty"` - - // ProxyContractsAdmin is the address that will have the privilege to change both the proxy - // implementation address and the admin - ProxyContractsAdmin types.Address `json:"proxyContractsAdmin,omitempty"` -} - -// LoadPolyBFTConfig loads chain config from provided path and unmarshals PolyBFTConfig -func LoadPolyBFTConfig(chainConfigFile string) (PolyBFTConfig, error) { - chainCfg, err := chain.ImportFromFile(chainConfigFile) - if err != nil { - return PolyBFTConfig{}, err - } - - polybftConfig, err := GetPolyBFTConfig(chainCfg) - if err != nil { - return PolyBFTConfig{}, err - } - - return polybftConfig, err -} - -// GetPolyBFTConfig deserializes provided chain config and returns PolyBFTConfig -func GetPolyBFTConfig(chainConfig *chain.Chain) (PolyBFTConfig, error) { - consensusConfigJSON, err := json.Marshal(chainConfig.Params.Engine[ConsensusName]) - if err != nil { - return PolyBFTConfig{}, err - } - - var polyBFTConfig PolyBFTConfig - if err = json.Unmarshal(consensusConfigJSON, &polyBFTConfig); err != nil { - return PolyBFTConfig{}, err - } - - return polyBFTConfig, nil -} - -// BridgeConfig is the rootchain configuration, needed for bridging -type BridgeConfig struct { - StateSenderAddr types.Address `json:"stateSenderAddress"` - CheckpointManagerAddr types.Address `json:"checkpointManagerAddress"` - ExitHelperAddr types.Address `json:"exitHelperAddress"` - RootERC20PredicateAddr types.Address `json:"erc20PredicateAddress"` - ChildMintableERC20PredicateAddr types.Address `json:"erc20ChildMintablePredicateAddress"` - RootNativeERC20Addr types.Address `json:"nativeERC20Address"` - RootERC721PredicateAddr types.Address `json:"erc721PredicateAddress"` - ChildMintableERC721PredicateAddr types.Address `json:"erc721ChildMintablePredicateAddress"` - RootERC1155PredicateAddr types.Address `json:"erc1155PredicateAddress"` - ChildMintableERC1155PredicateAddr types.Address `json:"erc1155ChildMintablePredicateAddress"` - ChildERC20Addr types.Address `json:"childERC20Address"` - ChildERC721Addr types.Address `json:"childERC721Address"` - ChildERC1155Addr types.Address `json:"childERC1155Address"` - CustomSupernetManagerAddr types.Address `json:"customSupernetManagerAddr"` - StakeManagerAddr types.Address `json:"stakeManagerAddr"` - // only populated if stake-manager-deploy command is executed, and used for e2e tests - StakeTokenAddr types.Address `json:"stakeTokenAddr,omitempty"` - BLSAddress types.Address `json:"blsAddr"` - BN256G2Address types.Address `json:"bn256G2Addr"` - - JSONRPCEndpoint string `json:"jsonRPCEndpoint"` - EventTrackerStartBlocks map[types.Address]uint64 `json:"eventTrackerStartBlocks"` -} - -func (p *PolyBFTConfig) IsBridgeEnabled() bool { - return p.Bridge != nil -} - -// RootchainConfig contains rootchain metadata (such as JSON RPC endpoint and contract addresses) -type RootchainConfig struct { - JSONRPCAddr string - - StateSenderAddress types.Address - CheckpointManagerAddress types.Address - BLSAddress types.Address - BN256G2Address types.Address - ExitHelperAddress types.Address - RootERC20PredicateAddress types.Address - ChildMintableERC20PredicateAddress types.Address - RootNativeERC20Address types.Address - ChildERC20Address types.Address - RootERC721PredicateAddress types.Address - ChildMintableERC721PredicateAddress types.Address - ChildERC721Address types.Address - RootERC1155PredicateAddress types.Address - ChildMintableERC1155PredicateAddress types.Address - ChildERC1155Address types.Address - CustomSupernetManagerAddress types.Address - StakeManagerAddress types.Address - StakeTokenAddress types.Address -} - -// ToBridgeConfig creates BridgeConfig instance -func (r *RootchainConfig) ToBridgeConfig() *BridgeConfig { - return &BridgeConfig{ - JSONRPCEndpoint: r.JSONRPCAddr, - - StateSenderAddr: r.StateSenderAddress, - CheckpointManagerAddr: r.CheckpointManagerAddress, - ExitHelperAddr: r.ExitHelperAddress, - RootERC20PredicateAddr: r.RootERC20PredicateAddress, - ChildMintableERC20PredicateAddr: r.ChildMintableERC20PredicateAddress, - RootNativeERC20Addr: r.RootNativeERC20Address, - RootERC721PredicateAddr: r.RootERC721PredicateAddress, - ChildMintableERC721PredicateAddr: r.ChildMintableERC721PredicateAddress, - RootERC1155PredicateAddr: r.RootERC1155PredicateAddress, - ChildMintableERC1155PredicateAddr: r.ChildMintableERC1155PredicateAddress, - ChildERC20Addr: r.ChildERC20Address, - ChildERC721Addr: r.ChildERC721Address, - ChildERC1155Addr: r.ChildERC1155Address, - CustomSupernetManagerAddr: r.CustomSupernetManagerAddress, - StakeManagerAddr: r.StakeManagerAddress, - BLSAddress: r.BLSAddress, - BN256G2Address: r.BN256G2Address, - } -} - -// TokenConfig is the configuration of native token used by edge network -type TokenConfig struct { - Name string `json:"name"` - Symbol string `json:"symbol"` - Decimals uint8 `json:"decimals"` - IsMintable bool `json:"isMintable"` - Owner types.Address `json:"owner"` -} - -func ParseRawTokenConfig(rawConfig string) (*TokenConfig, error) { - if rawConfig == "" { - return DefaultTokenConfig, nil - } - - params := strings.Split(rawConfig, ":") - if len(params) < minNativeTokenParamsNumber { - return nil, errInvalidTokenParams - } - - // name - name := strings.TrimSpace(params[0]) - if name == "" { - return nil, errInvalidTokenParams - } - - // symbol - symbol := strings.TrimSpace(params[1]) - if symbol == "" { - return nil, errInvalidTokenParams - } - - // decimals - decimals, err := strconv.ParseUint(strings.TrimSpace(params[2]), 10, 8) - if err != nil || decimals > math.MaxUint8 { - return nil, errInvalidTokenParams - } - - // is mintable native token used - isMintable, err := strconv.ParseBool(strings.TrimSpace(params[3])) - if err != nil { - return nil, errInvalidTokenParams - } - - // in case it is mintable native token, it is expected to have 5 parameters provided - if isMintable && len(params) != minNativeTokenParamsNumber+1 { - return nil, errInvalidTokenParams - } - - // owner address - owner := types.ZeroAddress - if isMintable { - owner = types.StringToAddress(strings.TrimSpace(params[4])) - } - - return &TokenConfig{ - Name: name, - Symbol: symbol, - Decimals: uint8(decimals), - IsMintable: isMintable, - Owner: owner, - }, nil -} - -type RewardsConfig struct { - // TokenAddress is the address of reward token on child chain - TokenAddress types.Address - - // WalletAddress is the address of reward wallet on child chain - WalletAddress types.Address - - // WalletAmount is the amount of tokens in reward wallet - WalletAmount *big.Int -} - -func (r *RewardsConfig) MarshalJSON() ([]byte, error) { - raw := &rewardsConfigRaw{ - TokenAddress: r.TokenAddress, - WalletAddress: r.WalletAddress, - WalletAmount: common.EncodeBigInt(r.WalletAmount), - } - - return json.Marshal(raw) -} - -func (r *RewardsConfig) UnmarshalJSON(data []byte) error { - var ( - raw rewardsConfigRaw - err error - ) - - if err = json.Unmarshal(data, &raw); err != nil { - return err - } - - r.TokenAddress = raw.TokenAddress - r.WalletAddress = raw.WalletAddress - - r.WalletAmount, err = common.ParseUint256orHex(raw.WalletAmount) - if err != nil { - return err - } - - return nil -} - -type rewardsConfigRaw struct { - TokenAddress types.Address `json:"rewardTokenAddress"` - WalletAddress types.Address `json:"rewardWalletAddress"` - WalletAmount *string `json:"rewardWalletAmount"` -} - -// BurnContractInfo contains metadata for burn contract, which is part of EIP-1559 specification -type BurnContractInfo struct { - BlockNumber uint64 - Address types.Address - DestinationAddress types.Address -} diff --git a/consensus/polybft/polybft_test.go b/consensus/polybft/polybft_test.go deleted file mode 100644 index e94f805..0000000 --- a/consensus/polybft/polybft_test.go +++ /dev/null @@ -1,354 +0,0 @@ -package polybft - -import ( - "errors" - "testing" - "time" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/consensus" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/helper/progress" - "github.com/xgr-network/xgr-node/txpool" - "github.com/xgr-network/xgr-node/types" -) - -// the test initializes polybft and chain mock (map of headers) after which a new header is verified -// firstly, two invalid situation of header verifications are triggered (missing Committed field and invalid validators for ParentCommitted) -// afterwards, valid inclusion into the block chain is checked -// and at the end there is a situation when header is already a part of blockchain -func TestPolybft_VerifyHeader(t *testing.T) { - t.Parallel() - - const ( - allValidatorsSize = 6 // overall there are 6 validators - validatorSetSize = 5 // only 5 validators are active at the time - fixedEpochSize = uint64(10) - ) - - updateHeaderExtra := func(header *types.Header, - validators *validator.ValidatorSetDelta, - parentSignature *Signature, - checkpointData *CheckpointData, - committedAccounts []*wallet.Account) *Signature { - extra := &Extra{ - Validators: validators, - Parent: parentSignature, - Checkpoint: checkpointData, - Committed: &Signature{}, - } - - if extra.Checkpoint == nil { - extra.Checkpoint = &CheckpointData{} - } - - header.ExtraData = extra.MarshalRLPTo(nil) - header.ComputeHash() - - if len(committedAccounts) > 0 { - checkpointHash, err := extra.Checkpoint.Hash(0, header.Number, header.Hash) - require.NoError(t, err) - - extra.Committed = createSignature(t, committedAccounts, checkpointHash, signer.DomainCheckpointManager) - header.ExtraData = extra.MarshalRLPTo(nil) - } - - return extra.Committed - } - - // create all validators - validators := validator.NewTestValidators(t, allValidatorsSize) - - // create configuration - polyBftConfig := PolyBFTConfig{ - InitialValidatorSet: validators.GetParamValidators(), - EpochSize: fixedEpochSize, - SprintSize: 5, - BlockTimeDrift: 10, - } - - validatorSet := validators.GetPublicIdentities() - accounts := validators.GetPrivateIdentities() - - // calculate validators before and after the end of the first epoch - validatorSetParent, validatorSetCurrent := validatorSet[:len(validatorSet)-1], validatorSet[1:] - accountSetParent, accountSetCurrent := accounts[:len(accounts)-1], accounts[1:] - - // create header map to simulate blockchain - headersMap := &testHeadersMap{} - - // create genesis header - genesisDelta, err := validator.CreateValidatorSetDelta(nil, validatorSetParent) - require.NoError(t, err) - - genesisHeader := &types.Header{Number: 0} - updateHeaderExtra(genesisHeader, genesisDelta, nil, nil, nil) - - // add genesis header to map - headersMap.addHeader(genesisHeader) - - // create headers from 1 to 9 - for i := uint64(1); i < polyBftConfig.EpochSize; i++ { - delta, err := validator.CreateValidatorSetDelta(validatorSetParent, validatorSetParent) - require.NoError(t, err) - - header := &types.Header{Number: i} - updateHeaderExtra(header, delta, nil, &CheckpointData{EpochNumber: 1}, nil) - - // add headers from 1 to 9 to map (blockchain imitation) - headersMap.addHeader(header) - } - - // mock blockchain - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headersMap.getHeader) - blockchainMock.On("GetHeaderByHash", mock.Anything).Return(headersMap.getHeaderByHash) - - // create polybft with appropriate mocks - polybft := &Polybft{ - closeCh: make(chan struct{}), - logger: hclog.NewNullLogger(), - consensusConfig: &polyBftConfig, - blockchain: blockchainMock, - validatorsCache: newValidatorsSnapshotCache( - hclog.NewNullLogger(), - newTestState(t), - blockchainMock, - ), - } - - // create parent header (block 10) - parentDelta, err := validator.CreateValidatorSetDelta(validatorSetParent, validatorSetCurrent) - require.NoError(t, err) - - parentHeader := &types.Header{ - Number: polyBftConfig.EpochSize, - Timestamp: uint64(time.Now().UTC().Unix()), - } - parentCommitment := updateHeaderExtra(parentHeader, parentDelta, nil, &CheckpointData{EpochNumber: 1}, accountSetParent) - - // add parent header to map - headersMap.addHeader(parentHeader) - - // create current header (block 11) with all appropriate fields required for validation - currentDelta, err := validator.CreateValidatorSetDelta(validatorSetCurrent, validatorSetCurrent) - require.NoError(t, err) - - currentHeader := &types.Header{ - Number: polyBftConfig.EpochSize + 1, - ParentHash: parentHeader.Hash, - Timestamp: parentHeader.Timestamp + 1, - MixHash: PolyBFTMixDigest, - Difficulty: 1, - } - updateHeaderExtra(currentHeader, currentDelta, nil, - &CheckpointData{ - EpochNumber: 2, - CurrentValidatorsHash: types.StringToHash("Foo"), - NextValidatorsHash: types.StringToHash("Bar"), - }, nil) - - currentHeader.Hash[0] = currentHeader.Hash[0] + 1 - assert.ErrorContains(t, polybft.VerifyHeader(currentHeader), "invalid header hash") - - // omit Parent field (parent signature) intentionally - updateHeaderExtra(currentHeader, currentDelta, nil, - &CheckpointData{ - EpochNumber: 1, - CurrentValidatorsHash: types.StringToHash("Foo"), - NextValidatorsHash: types.StringToHash("Bar")}, - accountSetCurrent) - - // since parent signature is intentionally disregarded the following error is expected - assert.ErrorContains(t, polybft.VerifyHeader(currentHeader), "failed to verify signatures for parent of block") - - updateHeaderExtra(currentHeader, currentDelta, parentCommitment, - &CheckpointData{ - EpochNumber: 1, - CurrentValidatorsHash: types.StringToHash("Foo"), - NextValidatorsHash: types.StringToHash("Bar")}, - accountSetCurrent) - - assert.NoError(t, polybft.VerifyHeader(currentHeader)) - - // clean validator snapshot cache (re-instantiate it), submit invalid validator set for parent signature and expect the following error - polybft.validatorsCache = newValidatorsSnapshotCache(hclog.NewNullLogger(), newTestState(t), blockchainMock) - assert.NoError(t, polybft.validatorsCache.storeSnapshot( - &validatorSnapshot{Epoch: 0, Snapshot: validatorSetCurrent}, nil)) // invalid validator set is submitted - assert.NoError(t, polybft.validatorsCache.storeSnapshot( - &validatorSnapshot{Epoch: 1, Snapshot: validatorSetCurrent}, nil)) - assert.ErrorContains(t, polybft.VerifyHeader(currentHeader), "failed to verify signatures for parent of block") - - // clean validators cache again and set valid snapshots - polybft.validatorsCache = newValidatorsSnapshotCache(hclog.NewNullLogger(), newTestState(t), blockchainMock) - assert.NoError(t, polybft.validatorsCache.storeSnapshot( - &validatorSnapshot{Epoch: 0, Snapshot: validatorSetParent}, nil)) - assert.NoError(t, polybft.validatorsCache.storeSnapshot( - &validatorSnapshot{Epoch: 1, Snapshot: validatorSetCurrent}, nil)) - assert.NoError(t, polybft.VerifyHeader(currentHeader)) - - // add current header to the blockchain (headersMap) and try validating again - headersMap.addHeader(currentHeader) - assert.NoError(t, polybft.VerifyHeader(currentHeader)) -} - -func TestPolybft_Close(t *testing.T) { - t.Parallel() - - syncer := &syncerMock{} - syncer.On("Close", mock.Anything).Return(error(nil)).Once() - - polybft := Polybft{ - closeCh: make(chan struct{}), - syncer: syncer, - runtime: &consensusRuntime{ - stateSyncManager: &dummyStateSyncManager{}, - stateSyncRelayer: &dummyStateSyncRelayer{}, - }, - } - - assert.NoError(t, polybft.Close()) - - <-polybft.closeCh - - syncer.AssertExpectations(t) - - errExpected := errors.New("something") - syncer.On("Close", mock.Anything).Return(errExpected).Once() - - polybft.closeCh = make(chan struct{}) - - assert.Error(t, errExpected, polybft.Close()) - - select { - case <-polybft.closeCh: - assert.Fail(t, "channel closing is invoked") - case <-time.After(time.Millisecond * 100): - } - - syncer.AssertExpectations(t) -} - -func TestPolybft_GetSyncProgression(t *testing.T) { - t.Parallel() - - result := &progress.Progression{} - - syncer := &syncerMock{} - syncer.On("GetSyncProgression", mock.Anything).Return(result).Once() - - polybft := Polybft{ - syncer: syncer, - } - - assert.Equal(t, result, polybft.GetSyncProgression()) -} - -func Test_Factory(t *testing.T) { - t.Parallel() - - const epochSize = uint64(141) - - txPool := &txpool.TxPool{} - - params := &consensus.Params{ - TxPool: txPool, - Logger: hclog.Default(), - Config: &consensus.Config{ - Config: map[string]interface{}{ - "EpochSize": epochSize, - }, - }, - } - - r, err := Factory(params) - - require.NoError(t, err) - require.NotNil(t, r) - - polybft, ok := r.(*Polybft) - require.True(t, ok) - - assert.Equal(t, txPool, polybft.txPool) - assert.Equal(t, epochSize, polybft.consensusConfig.EpochSize) - assert.Equal(t, params, polybft.config) -} - -func Test_GenesisPostHookFactory(t *testing.T) { - t.Parallel() - - const ( - epochSize = 15 - maxValidators = 150 - ) - - validators := validator.NewTestValidators(t, 6) - bridgeCfg := createTestBridgeConfig() - cases := []struct { - name string - config *PolyBFTConfig - bridgeAllowList *chain.AddressListConfig - expectedErr error - }{ - { - name: "non-mintable native token; access lists disabled", - config: &PolyBFTConfig{ - InitialValidatorSet: validators.GetParamValidators(), - Bridge: bridgeCfg, - EpochSize: epochSize, - RewardConfig: &RewardsConfig{WalletAmount: ethgo.Ether(1000)}, - NativeTokenConfig: &TokenConfig{Name: "Test", Symbol: "TEST", Decimals: 18}, - MaxValidatorSetSize: maxValidators, - }, - }, - { - name: "mintable native token; access lists enabled", - config: &PolyBFTConfig{ - InitialValidatorSet: validators.GetParamValidators(), - Bridge: bridgeCfg, - EpochSize: epochSize, - RewardConfig: &RewardsConfig{WalletAmount: ethgo.Ether(1000)}, - NativeTokenConfig: &TokenConfig{Name: "Test Mintable", Symbol: "TEST_MNT", Decimals: 18, IsMintable: true}, - MaxValidatorSetSize: maxValidators, - }, - bridgeAllowList: &chain.AddressListConfig{ - AdminAddresses: []types.Address{validators.Validators["0"].Address()}, - EnabledAddresses: []types.Address{validators.Validators["1"].Address()}, - }, - }, - { - name: "missing bridge configuration", - config: &PolyBFTConfig{}, - expectedErr: errMissingBridgeConfig, - }, - } - - for _, tc := range cases { - tc := tc - t.Run(tc.name, func(t *testing.T) { - t.Parallel() - - params := &chain.Params{ - Engine: map[string]interface{}{ConsensusName: tc.config}, - BridgeAllowList: tc.bridgeAllowList, - } - chainConfig := &chain.Chain{Params: params, Genesis: &chain.Genesis{Alloc: make(map[types.Address]*chain.GenesisAccount)}} - initHandler := GenesisPostHookFactory(chainConfig, ConsensusName) - require.NotNil(t, initHandler) - - transition := newTestTransition(t, nil) - if tc.expectedErr == nil { - require.NoError(t, initHandler(transition)) - } else { - require.ErrorIs(t, initHandler(transition), tc.expectedErr) - } - }) - } -} diff --git a/consensus/polybft/proposer_calculator.go b/consensus/polybft/proposer_calculator.go deleted file mode 100644 index 103c2ff..0000000 --- a/consensus/polybft/proposer_calculator.go +++ /dev/null @@ -1,504 +0,0 @@ -package polybft - -import ( - "bytes" - "fmt" - "math/big" - - "github.com/hashicorp/go-hclog" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" -) - -var ( - // priorityWindowSizeFactor - is a constant that when multiplied with the - // total voting power gives the maximum allowed distance between validator - // priorities. - priorityWindowSizeFactor = big.NewInt(2) -) - -// PrioritizedValidator holds ValidatorMetadata together with priority -type PrioritizedValidator struct { - Metadata *validator.ValidatorMetadata - ProposerPriority *big.Int -} - -func (pv PrioritizedValidator) String() string { - return fmt.Sprintf("[%v, voting power %v, priority %v]", pv.Metadata.Address.String(), - pv.Metadata.VotingPower, pv.ProposerPriority) -} - -// ProposerSnapshot represents snapshot of one proposer calculation -type ProposerSnapshot struct { - Height uint64 - Round uint64 - Proposer *PrioritizedValidator - Validators []*PrioritizedValidator -} - -// NewProposerSnapshotFromState create ProposerSnapshot from state if possible or from genesis block -func NewProposerSnapshotFromState(config *runtimeConfig, dbTx *bolt.Tx) (*ProposerSnapshot, error) { - snapshot, err := config.State.ProposerSnapshotStore.getProposerSnapshot(dbTx) - if err != nil { - return nil, err - } - - if snapshot == nil { - // pick validator set from genesis block if snapshot is not saved in db - genesisValidatorsSet, err := config.polybftBackend.GetValidatorsWithTx(0, nil, dbTx) - if err != nil { - return nil, err - } - - snapshot = NewProposerSnapshot(1, genesisValidatorsSet) - } - - return snapshot, nil -} - -// NewProposerSnapshot creates ProposerSnapshot with height and validators with all priorities set to zero -func NewProposerSnapshot(height uint64, validators []*validator.ValidatorMetadata) *ProposerSnapshot { - validatorsSnap := make([]*PrioritizedValidator, len(validators)) - - for i, x := range validators { - validatorsSnap[i] = &PrioritizedValidator{Metadata: x, ProposerPriority: big.NewInt(0)} - } - - return &ProposerSnapshot{ - Round: 0, - Proposer: nil, - Height: height, - Validators: validatorsSnap, - } -} - -// CalcProposer calculates next proposer -func (pcs *ProposerSnapshot) CalcProposer(round, height uint64) (types.Address, error) { - if height != pcs.Height { - return types.ZeroAddress, fmt.Errorf("invalid height - expected %d, got %d", pcs.Height, height) - } - - // optimization -> return current proposer if already calculated for this round - if pcs.Round == round && pcs.Proposer != nil { - return pcs.Proposer.Metadata.Address, nil - } - - // do not change priorities on original snapshot while executing CalcProposer - // if round = 0 then we need one iteration - proposer, err := incrementProposerPriorityNTimes(pcs.Copy(), round+1) - if err != nil { - return types.ZeroAddress, err - } - - pcs.Proposer = proposer - pcs.Round = round - - return proposer.Metadata.Address, nil -} - -// GetLatestProposer returns latest calculated proposer if any -func (pcs *ProposerSnapshot) GetLatestProposer(round, height uint64) (types.Address, error) { - // round must be same as saved one and proposer must exist - if pcs == nil || pcs.Proposer == nil || pcs.Round != round || pcs.Height != height { - return types.ZeroAddress, - fmt.Errorf("get latest proposer not found - height: %d, round: %d, pc height: %d, pc round: %d", - height, round, pcs.Height, pcs.Round) - } - - return pcs.Proposer.Metadata.Address, nil -} - -// GetTotalVotingPower returns total voting power from all the validators -func (pcs ProposerSnapshot) GetTotalVotingPower() *big.Int { - totalVotingPower := new(big.Int) - for _, v := range pcs.Validators { - totalVotingPower.Add(totalVotingPower, v.Metadata.VotingPower) - } - - return totalVotingPower -} - -// Copy Returns copy of current ProposerSnapshot object -func (pcs *ProposerSnapshot) Copy() *ProposerSnapshot { - var proposer *PrioritizedValidator - - valCopy := make([]*PrioritizedValidator, len(pcs.Validators)) - - for i, val := range pcs.Validators { - valCopy[i] = &PrioritizedValidator{Metadata: val.Metadata.Copy(), ProposerPriority: val.ProposerPriority} - - if pcs.Proposer != nil && pcs.Proposer.Metadata.Address == val.Metadata.Address { - proposer = valCopy[i] - } - } - - return &ProposerSnapshot{ - Validators: valCopy, - Height: pcs.Height, - Round: pcs.Round, - Proposer: proposer, - } -} - -func (pcs *ProposerSnapshot) toMap() map[types.Address]*PrioritizedValidator { - validatorMap := make(map[types.Address]*PrioritizedValidator) - for _, v := range pcs.Validators { - validatorMap[v.Metadata.Address] = v - } - - return validatorMap -} - -type ProposerCalculator struct { - // current snapshot - snapshot *ProposerSnapshot - - // runtime configuration - config *runtimeConfig - - // state to save snapshot - state *State - - // logger instance - logger hclog.Logger -} - -// NewProposerCalculator creates a new proposer calculator object -func NewProposerCalculator(config *runtimeConfig, logger hclog.Logger, - dbTx *bolt.Tx) (*ProposerCalculator, error) { - snap, err := NewProposerSnapshotFromState(config, dbTx) - - if err != nil { - return nil, err - } - - pc := &ProposerCalculator{ - snapshot: snap, - config: config, - state: config.State, - logger: logger, - } - - // If the node was previously stopped, leaving the proposer calculator in an inconsistent state, - // proposer calculator needs to be updated. - blockNumber := config.blockchain.CurrentHeader().Number - if pc.snapshot.Height <= blockNumber { - if err = pc.update(blockNumber, dbTx); err != nil { - return nil, err - } - } - - return pc, nil -} - -// NewProposerCalculator creates a new proposer calculator object -func NewProposerCalculatorFromSnapshot(pcs *ProposerSnapshot, config *runtimeConfig, - logger hclog.Logger) *ProposerCalculator { - return &ProposerCalculator{ - snapshot: pcs.Copy(), - config: config, - state: config.State, - logger: logger, - } -} - -// Get copy of the proposers' snapshot -func (pc *ProposerCalculator) GetSnapshot() (*ProposerSnapshot, bool) { - if pc.snapshot == nil { - return nil, false - } - - return pc.snapshot.Copy(), true -} - -// PostBlock is called on every insert of finalized block (either from consensus or syncer) -// It will update priorities and save the updated snapshot to db -func (pc *ProposerCalculator) PostBlock(req *PostBlockRequest) error { - return pc.update(req.FullBlock.Block.Number(), req.DBTx) -} - -func (pc *ProposerCalculator) update(blockNumber uint64, dbTx *bolt.Tx) error { - pc.logger.Debug("Update proposers snapshot started", "target block", blockNumber) - - from := pc.snapshot.Height - - // using a for loop if in some previous block, an error occurred while updating snapshot - // so that we can recalculate it to have accurate priorities. - // Note, this will change once we introduce component wide global transaction - for height := from; height <= blockNumber; height++ { - if err := pc.updatePerBlock(height, dbTx); err != nil { - return err - } - - pc.logger.Debug("Proposer snapshot has been updated", - "block", height, "validators", pc.snapshot.Validators) - } - - if err := pc.state.ProposerSnapshotStore.writeProposerSnapshot(pc.snapshot, dbTx); err != nil { - return fmt.Errorf("cannot save proposers snapshot for block %d: %w", blockNumber, err) - } - - pc.logger.Info("Proposer snapshot update has been finished", - "target block", blockNumber+1, "validators", len(pc.snapshot.Validators)) - - return nil -} - -// Updates ProposerSnapshot to block block with number `blockNumber` -func (pc *ProposerCalculator) updatePerBlock(blockNumber uint64, dbTx *bolt.Tx) error { - if pc.snapshot.Height != blockNumber { - return fmt.Errorf("proposers snapshot update called for wrong block. block number=%d, snapshot block number=%d", - blockNumber, pc.snapshot.Height) - } - - _, extra, err := getBlockData(blockNumber, pc.config.blockchain) - if err != nil { - return fmt.Errorf("cannot get block header and extra while updating proposers snapshot %d: %w", blockNumber, err) - } - - var newValidatorSet validator.AccountSet = nil - - if extra.Validators != nil && !extra.Validators.IsEmpty() { - newValidatorSet, err = pc.config.polybftBackend.GetValidatorsWithTx(blockNumber, nil, dbTx) - if err != nil { - return fmt.Errorf("cannot get validators for block %d: %w", blockNumber, err) - } - } - - // if round = 0 then we need one iteration - _, err = incrementProposerPriorityNTimes(pc.snapshot, extra.Checkpoint.BlockRound+1) - if err != nil { - return fmt.Errorf("failed to update proposers snapshot for block %d: %w", blockNumber, err) - } - - // update to new validator set and center if needed - if err = updateValidators(pc.snapshot, newValidatorSet); err != nil { - return fmt.Errorf("cannot update validators: %w", err) - } - - pc.snapshot.Height = blockNumber + 1 // snapshot (validator priorities) is prepared for the next block - pc.snapshot.Round = 0 - pc.snapshot.Proposer = nil - - return nil -} - -// algorithm functions receive snapshot and do appropriate calculations and changes -func incrementProposerPriorityNTimes(snapshot *ProposerSnapshot, times uint64) (*PrioritizedValidator, error) { - if len(snapshot.Validators) == 0 { - return nil, fmt.Errorf("validator set cannot be nul or empty") - } - - if times <= 0 { - return nil, fmt.Errorf("cannot call IncrementProposerPriority with non-positive times") - } - - var ( - proposer *PrioritizedValidator - err error - tvp = snapshot.GetTotalVotingPower() - ) - - if err := updateWithChangeSet(snapshot, tvp); err != nil { - return nil, err - } - - for i := uint64(0); i < times; i++ { - if proposer, err = incrementProposerPriority(snapshot, tvp); err != nil { - return nil, fmt.Errorf("cannot increment proposer priority: %w", err) - } - } - - snapshot.Proposer = proposer - snapshot.Round = times - 1 - - return proposer, nil -} - -func updateValidators(snapshot *ProposerSnapshot, newValidatorSet validator.AccountSet) error { - if newValidatorSet.Len() == 0 { - return nil - } - - snapshotValidators := snapshot.toMap() - newValidators := make([]*PrioritizedValidator, len(newValidatorSet)) - - // compute total voting power of removed validators and current validator - removedValidatorsVotingPower := new(big.Int) - newValidatorsVotingPower := new(big.Int) - - for address, val := range snapshotValidators { - if !newValidatorSet.ContainsNodeID(address.String()) { - removedValidatorsVotingPower.Add(removedValidatorsVotingPower, val.Metadata.VotingPower) - } - } - - for _, v := range newValidatorSet { - newValidatorsVotingPower.Add(newValidatorsVotingPower, v.VotingPower) - } - - tvpAfterUpdatesBeforeRemovals := new(big.Int).Add(newValidatorsVotingPower, removedValidatorsVotingPower) - - for i, newValidator := range newValidatorSet { - if val, exists := snapshotValidators[newValidator.Address]; exists { - // old validators have the same priority - newValidators[i] = &PrioritizedValidator{ - Metadata: newValidator, - ProposerPriority: val.ProposerPriority, - } - } else { - // added validator has priority = -C*totalVotingPowerBeforeRemoval (with C ~= 1.125) - coefficient := new(big.Int).Div(tvpAfterUpdatesBeforeRemovals, big.NewInt(8)) - newValidators[i] = &PrioritizedValidator{ - Metadata: newValidator, - ProposerPriority: new(big.Int).Neg(tvpAfterUpdatesBeforeRemovals.Add(tvpAfterUpdatesBeforeRemovals, coefficient)), - } - } - } - - snapshot.Validators = newValidators - - // after validator set changes, center values around 0 and scale - if err := updateWithChangeSet(snapshot, snapshot.GetTotalVotingPower()); err != nil { - return fmt.Errorf("cannot update validator changeset: %w", err) - } - - return nil -} - -func incrementProposerPriority(snapshot *ProposerSnapshot, totalVotingPower *big.Int) (*PrioritizedValidator, error) { - for _, val := range snapshot.Validators { - // Check for overflow for sum. - newPrio := new(big.Int).Add(val.ProposerPriority, val.Metadata.VotingPower) - val.ProposerPriority = newPrio - } - // Decrement the validator with most ProposerPriority. - mostest, err := getValWithMostPriority(snapshot) - if err != nil { - return nil, fmt.Errorf("cannot get validator with most priority: %w", err) - } - - mostest.ProposerPriority.Sub(mostest.ProposerPriority, totalVotingPower) - - return mostest, nil -} - -func updateWithChangeSet(snapshot *ProposerSnapshot, totalVotingPower *big.Int) error { - if err := rescalePriorities(snapshot, totalVotingPower); err != nil { - return fmt.Errorf("cannot rescale priorities: %w", err) - } - - if err := shiftByAvgProposerPriority(snapshot); err != nil { - return fmt.Errorf("cannot shift proposer priorities: %w", err) - } - - return nil -} - -func shiftByAvgProposerPriority(snapshot *ProposerSnapshot) error { - avgProposerPriority, err := computeAvgProposerPriority(snapshot) - if err != nil { - return fmt.Errorf("cannot compute proposer priority: %w", err) - } - - for _, val := range snapshot.Validators { - val.ProposerPriority.Sub(val.ProposerPriority, avgProposerPriority) - } - - return nil -} - -func getValWithMostPriority(snapshot *ProposerSnapshot) (result *PrioritizedValidator, err error) { - if len(snapshot.Validators) == 0 { - return nil, fmt.Errorf("validators cannot be nil or empty") - } - - for _, curr := range snapshot.Validators { - // pick curr as result if it has greater priority - // or if it has same priority but "smaller" address - if isBetterProposer(curr, result) { - result = curr - } - } - - return result, nil -} - -func computeAvgProposerPriority(snapshot *ProposerSnapshot) (*big.Int, error) { - if len(snapshot.Validators) == 0 { - return nil, fmt.Errorf("validator set cannot be nul or empty") - } - - validatorsCount := big.NewInt(int64(len(snapshot.Validators))) - sum := new(big.Int) - - for _, val := range snapshot.Validators { - sum = sum.Add(sum, val.ProposerPriority) - } - - return sum.Div(sum, validatorsCount), nil -} - -// rescalePriorities rescales the priorities such that the distance between the -// maximum and minimum is smaller than `diffMax`. -func rescalePriorities(snapshot *ProposerSnapshot, totalVotingPower *big.Int) error { - if len(snapshot.Validators) == 0 { - return fmt.Errorf("validator set cannot be nul or empty") - } - - // Cap the difference between priorities to be proportional to 2*totalPower by - // re-normalizing priorities, i.e., rescale all priorities by multiplying with: - // 2*totalVotingPower/(maxPriority - minPriority) - diffMax := new(big.Int).Mul(priorityWindowSizeFactor, totalVotingPower) - - // Calculating ceil(diff/diffMax): - // Re-normalization is performed by dividing by an integer for simplicity. - // NOTE: This may make debugging priority issues easier as well. - diff := computeMaxMinPriorityDiff(snapshot.Validators) - ratio := common.BigIntDivCeil(diff, diffMax) - - if diff.Cmp(diffMax) > 0 { - for _, val := range snapshot.Validators { - val.ProposerPriority.Quo(val.ProposerPriority, ratio) - } - } - - return nil -} - -// computeMaxMinPriorityDiff computes the difference between the max and min ProposerPriority of that set. -func computeMaxMinPriorityDiff(validators []*PrioritizedValidator) *big.Int { - min, max := validators[0].ProposerPriority, validators[0].ProposerPriority - - for _, v := range validators[1:] { - if v.ProposerPriority.Cmp(min) < 0 { - min = v.ProposerPriority - } - - if v.ProposerPriority.Cmp(max) > 0 { - max = v.ProposerPriority - } - } - - diff := new(big.Int).Sub(max, min) - - if diff.Cmp(big.NewInt(0)) < 0 { - return diff.Neg(diff) - } - - return diff -} - -// isBetterProposer compares provided PrioritizedValidator instances -// and chooses either one with higher ProposerPriority or the one with the smaller address (compared lexicographically). -func isBetterProposer(a, b *PrioritizedValidator) bool { - if b == nil || a.ProposerPriority.Cmp(b.ProposerPriority) > 0 { - return true - } else if a.ProposerPriority == b.ProposerPriority { - return bytes.Compare(a.Metadata.Address.Bytes(), b.Metadata.Address.Bytes()) <= 0 - } - - return false -} diff --git a/consensus/polybft/proposer_calculator_test.go b/consensus/polybft/proposer_calculator_test.go deleted file mode 100644 index bfceaa7..0000000 --- a/consensus/polybft/proposer_calculator_test.go +++ /dev/null @@ -1,712 +0,0 @@ -package polybft - -import ( - "bytes" - "math/big" - "testing" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/types" -) - -func TestProposerCalculator_SetIndex(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E"}, []uint64{10, 100, 1, 50, 30}) - metadata := validators.GetPublicIdentities() - - vs := validators.ToValidatorSet() - - snapshot := NewProposerSnapshot(1, metadata) - - // validate no changes to validator set positions - for i, v := range vs.Accounts() { - assert.Equal(t, metadata[i].Address, v.Address) - } - - proposer, err := snapshot.CalcProposer(0, 1) - require.NoError(t, err) - assert.Equal(t, proposer, metadata[1].Address) - // validate no changes to validator set positions - for i, v := range vs.Accounts() { - assert.Equal(t, metadata[i].Address, v.Address) - } -} - -func TestProposerCalculator_RegularFlow(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E"}, []uint64{1, 2, 3, 4, 5}) - metadata := validators.GetPublicIdentities() - - snapshot := NewProposerSnapshot(0, metadata) - - currProposerAddress, err := snapshot.CalcProposer(0, 0) - require.NoError(t, err) - assert.Equal(t, metadata[4].Address, currProposerAddress) - - proposerAddressR1, err := snapshot.CalcProposer(1, 0) - require.NoError(t, err) - assert.Equal(t, metadata[3].Address, proposerAddressR1) - - proposerAddressR2, err := snapshot.CalcProposer(2, 0) - require.NoError(t, err) - assert.Equal(t, metadata[2].Address, proposerAddressR2) - - proposerAddressR3, err := snapshot.CalcProposer(3, 0) - require.NoError(t, err) - assert.Equal(t, metadata[1].Address, proposerAddressR3) - - proposerAddressR4, err := snapshot.CalcProposer(4, 0) - require.NoError(t, err) - assert.Equal(t, metadata[4].Address, proposerAddressR4) - - proposerAddressR5, err := snapshot.CalcProposer(5, 0) - require.NoError(t, err) - assert.Equal(t, metadata[3].Address, proposerAddressR5) - - proposerAddressR6, err := snapshot.CalcProposer(6, 0) - require.NoError(t, err) - assert.Equal(t, metadata[0].Address, proposerAddressR6) -} - -func TestProposerCalculator_SamePriority(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(5) - require.NoError(t, err) - - // at some point priorities will be the same and bytes address will be compared - vs := validator.NewValidatorSet([]*validator.ValidatorMetadata{ - { - BlsKey: keys[0].PublicKey(), - Address: types.Address{0x1}, - VotingPower: big.NewInt(1), - }, - { - BlsKey: keys[1].PublicKey(), - Address: types.Address{0x2}, - VotingPower: big.NewInt(2), - }, - { - BlsKey: keys[2].PublicKey(), - Address: types.Address{0x3}, - VotingPower: big.NewInt(3), - }, - }, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(0, vs.Accounts()) - - proposerR0, err := snapshot.CalcProposer(0, 0) - require.NoError(t, err) - assert.Equal(t, types.Address{0x3}, proposerR0) - - proposerR1, err := snapshot.CalcProposer(1, 0) - require.NoError(t, err) - assert.Equal(t, types.Address{0x2}, proposerR1) - - proposerR2, err := snapshot.CalcProposer(2, 0) - require.NoError(t, err) - assert.Equal(t, types.Address{0x1}, proposerR2) - - proposerR2, err = snapshot.CalcProposer(2, 0) // call again same round - require.NoError(t, err) - assert.Equal(t, types.Address{0x1}, proposerR2) -} - -func TestProposerCalculator_InversePriorityOrderWithExpectedListOfSelection(t *testing.T) { - t.Parallel() - - const numberOfIteration = 99 - - keys, err := bls.CreateRandomBlsKeys(3) - require.NoError(t, err) - - // priorities are from high to low vp in validator set - vset := validator.NewValidatorSet([]*validator.ValidatorMetadata{ - { - BlsKey: keys[0].PublicKey(), - Address: types.Address{0x1}, - VotingPower: big.NewInt(1000), - }, - { - BlsKey: keys[1].PublicKey(), - Address: types.Address{0x2}, - VotingPower: big.NewInt(300), - }, - { - BlsKey: keys[2].PublicKey(), - Address: types.Address{0x3}, - VotingPower: big.NewInt(330), - }, - }, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(4, vset.Accounts()) - - var proposers = make([]types.Address, numberOfIteration) - - for i := uint64(0); i < numberOfIteration; i++ { - proposers[i], err = snapshot.CalcProposer(i, 4) - require.NoError(t, err) - } - - // list of addresses in order that should be selected - expectedValidatorAddresses := []types.Address{ - {0x1}, {0x3}, {0x1}, {0x2}, {0x1}, {0x1}, {0x3}, {0x1}, {0x2}, {0x1}, {0x1}, {0x3}, {0x1}, {0x1}, {0x2}, {0x1}, - {0x3}, {0x1}, {0x1}, {0x2}, {0x1}, {0x1}, {0x3}, {0x1}, {0x2}, {0x1}, {0x1}, {0x3}, {0x1}, {0x2}, {0x1}, {0x1}, - {0x3}, {0x1}, {0x1}, {0x2}, {0x1}, {0x3}, {0x1}, {0x1}, {0x2}, {0x1}, {0x3}, {0x1}, {0x1}, {0x2}, {0x1}, {0x3}, - {0x1}, {0x1}, {0x2}, {0x1}, {0x3}, {0x1}, {0x1}, {0x1}, {0x3}, {0x2}, {0x1}, {0x1}, {0x1}, {0x3}, {0x1}, {0x2}, - {0x1}, {0x1}, {0x3}, {0x1}, {0x2}, {0x1}, {0x1}, {0x3}, {0x1}, {0x2}, {0x1}, {0x1}, {0x3}, {0x1}, {0x2}, {0x1}, - {0x1}, {0x3}, {0x1}, {0x1}, {0x2}, {0x1}, {0x3}, {0x1}, {0x1}, {0x2}, {0x1}, {0x3}, {0x1}, {0x1}, {0x2}, {0x1}, - {0x3}, {0x1}, {0x1}, - } - - for i, p := range proposers { - assert.True(t, bytes.Equal(expectedValidatorAddresses[i].Bytes(), p.Bytes())) - } -} - -func TestProposerCalculator_IncrementProposerPrioritySameVotingPower(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(3) - require.NoError(t, err) - - vs := validator.NewValidatorSet([]*validator.ValidatorMetadata{ - { - BlsKey: keys[0].PublicKey(), - Address: types.Address{0x1}, - VotingPower: big.NewInt(1), - }, - { - BlsKey: keys[1].PublicKey(), - Address: types.Address{0x2}, - VotingPower: big.NewInt(1), - }, - { - BlsKey: keys[2].PublicKey(), - Address: types.Address{0x3}, - VotingPower: big.NewInt(1), - }, - }, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(0, vs.Accounts()) - - // when voting power is the same order is by address - currProposerAddress, err := snapshot.CalcProposer(0, 0) - require.NoError(t, err) - assert.Equal(t, types.Address{0x1}, currProposerAddress) - - proposerAddresR1, err := snapshot.CalcProposer(1, 0) - require.NoError(t, err) - assert.Equal(t, types.Address{0x2}, proposerAddresR1) - - proposerAddressR2, err := snapshot.CalcProposer(2, 0) - require.NoError(t, err) - assert.Equal(t, types.Address{0x3}, proposerAddressR2) - - proposerAddressR3, err := snapshot.CalcProposer(3, 0) - require.NoError(t, err) - assert.Equal(t, types.Address{0x1}, proposerAddressR3) - - proposerAddressR4, err := snapshot.CalcProposer(4, 0) - require.NoError(t, err) - assert.Equal(t, types.Address{0x2}, proposerAddressR4) -} - -func TestProposerCalculator_AveragingInIncrementProposerPriorityWithVotingPower(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(3) - require.NoError(t, err) - - // Other than TestAveragingInIncrementProposerPriority this is a more complete test showing - // how each ProposerPriority changes in relation to the validator's voting power respectively. - // average is zero in each round: - vp0 := int64(10) - vp1 := int64(1) - vp2 := int64(1) - total := vp0 + vp1 + vp2 - avg := (vp0 + vp1 + vp2 - total) / 3 - valz := []*validator.ValidatorMetadata{ - { - BlsKey: keys[0].PublicKey(), - Address: types.Address{0x1}, - VotingPower: big.NewInt(vp0), - }, - { - BlsKey: keys[1].PublicKey(), - Address: types.Address{0x2}, - VotingPower: big.NewInt(vp1), - }, - { - BlsKey: keys[2].PublicKey(), - Address: types.Address{0x3}, - VotingPower: big.NewInt(vp2), - }, - } - - tcs := []struct { - wantProposerPriority []int64 - times uint64 - wantProposerIndex int64 - }{ - - 0: { - []int64{ - // Acumm+VotingPower-Avg: - 0 + vp0 - total - avg, // mostest will be subtracted by total voting power (12) - 0 + vp1, - 0 + vp2}, - 1, - 0, - }, - 1: { - []int64{ - (0 + vp0 - total) + vp0 - total - avg, // this will be mostest on 2nd iter, too - (0 + vp1) + vp1, - (0 + vp2) + vp2}, - 2, - 0, - }, // increment twice -> expect average to be subtracted twice - 2: { - []int64{ - 0 + 3*(vp0-total) - avg, // still mostest - 0 + 3*vp1, - 0 + 3*vp2}, - 3, - 0, - }, - 3: { - []int64{ - 0 + 4*(vp0-total), // still mostest - 0 + 4*vp1, - 0 + 4*vp2}, - 4, - 0, - }, - 4: { - []int64{ - 0 + 4*(vp0-total) + vp0, // 4 iters was mostest - 0 + 5*vp1 - total, // now this val is mostest for the 1st time (hence -12==totalVotingPower) - 0 + 5*vp2}, - 5, - 1, - }, - 5: { - []int64{ - 0 + 6*vp0 - 5*total, // mostest again - 0 + 6*vp1 - total, // mostest once up to here - 0 + 6*vp2}, - 6, - 0, - }, - 6: { - []int64{ - 0 + 7*vp0 - 6*total, // in 7 iters this val is mostest 6 times - 0 + 7*vp1 - total, // in 7 iters this val is mostest 1 time - 0 + 7*vp2}, - 7, - 0, - }, - 7: { - []int64{ - 0 + 8*vp0 - 7*total, // mostest again - 0 + 8*vp1 - total, - 0 + 8*vp2}, - 8, - 0, - }, - 8: { - []int64{ - 0 + 9*vp0 - 7*total, - 0 + 9*vp1 - total, - 0 + 9*vp2 - total}, // mostest - 9, - 2, - }, - 9: { - []int64{ - 0 + 10*vp0 - 8*total, // after 10 iters this is mostest again - 0 + 10*vp1 - total, // after 6 iters this val is "mostest" once and not in between - 0 + 10*vp2 - total}, // in between 10 iters this val is "mostest" once - 10, - 0, - }, - 10: { - []int64{ - 0 + 11*vp0 - 9*total, - 0 + 11*vp1 - total, // after 6 iters this val is "mostest" once and not in between - 0 + 11*vp2 - total}, // after 10 iters this val is "mostest" once - 11, - 0, - }, - } - - for i, tc := range tcs { - snap := NewProposerSnapshot(1, valz) - - _, err := incrementProposerPriorityNTimes(snap, tc.times) - require.NoError(t, err) - - address, _ := snap.GetLatestProposer(tc.times-1, 1) - - assert.Equal(t, snap.Validators[tc.wantProposerIndex].Metadata.Address, address, - "test case: %v", - i) - - for valIdx, val := range snap.Validators { - assert.Equal(t, - tc.wantProposerPriority[valIdx], - val.ProposerPriority.Int64(), - "test case: %v, validator: %v", - i, - valIdx) - } - } -} - -func TestProposerCalculator_UpdatesForNewValidatorSet(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(2) - require.NoError(t, err) - - v1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(100)} - v2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(100)} - - accountSet := []*validator.ValidatorMetadata{v1, v2} - vs := validator.NewValidatorSet(accountSet, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(0, vs.Accounts()) - - _, err = snapshot.CalcProposer(1, 0) - require.NoError(t, err) - - // verify that the capacity and length of validators is the same - assert.Equal(t, len(vs.Accounts()), cap(snapshot.Validators)) - // verify that validator priorities are centered - valsCount := int64(len(snapshot.Validators)) - - sum := big.NewInt(0) - for _, val := range snapshot.Validators { - // mind overflow - sum = new(big.Int).Add(sum, val.ProposerPriority) - } - - assert.True(t, sum.Cmp(big.NewInt(valsCount)) < 0 && sum.Cmp(big.NewInt(-valsCount)) > 0, - "expected total priority in (-%d, %d). Got %d", valsCount, valsCount, sum) - - // verify that priorities are scaled - diff := computeMaxMinPriorityDiff(snapshot.Validators) - totalVotingPower := vs.TotalVotingPower() - diffMax := new(big.Int).Mul(priorityWindowSizeFactor, &totalVotingPower) - assert.True(t, diff.Cmp(diffMax) <= 0, "expected priority distance < %d. Got %d", diffMax, diff) -} - -func TestProposerCalculator_GetLatestProposer(t *testing.T) { - t.Parallel() - - const ( - bestIdx = 5 - count = 10 - ) - - validatorSet := validator.NewTestValidators(t, count).GetPublicIdentities() - snapshot := NewProposerSnapshot(0, validatorSet) - snapshot.Validators[bestIdx].ProposerPriority = big.NewInt(1000000) - - // not set - _, err := snapshot.GetLatestProposer(0, 0) - assert.Error(t, err) - - _, err = snapshot.CalcProposer(0, 0) - assert.NoError(t, err) - - // wrong round - _, err = snapshot.GetLatestProposer(1, 0) - assert.Error(t, err) - - // wrong height - _, err = snapshot.GetLatestProposer(0, 1) - assert.Error(t, err) - - // ok - address, err := snapshot.GetLatestProposer(0, 0) - assert.NoError(t, err) - - proposerAddress := validatorSet[bestIdx].Address - assert.Equal(t, proposerAddress, address) -} - -func TestProposerCalculator_UpdateValidatorsSameVpUpdatedAndNewAdded(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(8) - require.NoError(t, err) - - v1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(100)} - v2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(100)} - v3 := &validator.ValidatorMetadata{Address: types.Address{0x3}, BlsKey: keys[2].PublicKey(), VotingPower: big.NewInt(100)} - v4 := &validator.ValidatorMetadata{Address: types.Address{0x4}, BlsKey: keys[3].PublicKey(), VotingPower: big.NewInt(100)} - v5 := &validator.ValidatorMetadata{Address: types.Address{0x5}, BlsKey: keys[4].PublicKey(), VotingPower: big.NewInt(100)} - - vs := validator.NewValidatorSet([]*validator.ValidatorMetadata{v1, v2, v3, v4, v5}, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(0, vs.Accounts()) - - // iterate one cycle should bring back priority to 0 - _, err = incrementProposerPriorityNTimes(snapshot, 5) - require.NoError(t, err) - - for _, v := range snapshot.Validators { - assert.True(t, v.ProposerPriority.Cmp(big.NewInt(0)) == 0) - } - - // updated old validators - u1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(10)} - u2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[2].PublicKey(), VotingPower: big.NewInt(10)} - // added new validator - a1 := &validator.ValidatorMetadata{Address: types.Address{0x9}, BlsKey: keys[7].PublicKey(), VotingPower: big.NewInt(100)} - - newAccountSet := []*validator.ValidatorMetadata{u1, u2, a1} - - require.NoError(t, updateValidators(snapshot, newAccountSet)) - assert.Equal(t, 3, len(snapshot.Validators)) - - // removedVp := sum(v3, v4, v5) = 300 - // newVp := sum(u1, u2, a1) = 120 - // sum(removedVp, newVp) = 420; priority(a1) = -1.125*420 = -472 - // scale: difMax = 2 * 120; diff(-475, 0); ratio ~ 2 - // priority(a1) = -472/2 = 236; u1 = 0, u2 = 0 - // center: avg = 236/3 = 79; priority(a1)= 236 - 79 - - // check voting power after update - assert.Equal(t, big.NewInt(10), snapshot.Validators[0].Metadata.VotingPower) - assert.Equal(t, big.NewInt(10), snapshot.Validators[1].Metadata.VotingPower) - assert.Equal(t, big.NewInt(100), snapshot.Validators[2].Metadata.VotingPower) - // newly added validator - assert.Equal(t, big.NewInt(100), snapshot.Validators[2].Metadata.VotingPower) - assert.Equal(t, types.Address{0x9}, snapshot.Validators[2].Metadata.Address) - assert.Equal(t, big.NewInt(-157), snapshot.Validators[2].ProposerPriority) // a1 - // check priority - assert.Equal(t, big.NewInt(79), snapshot.Validators[0].ProposerPriority) // u1 - assert.Equal(t, big.NewInt(79), snapshot.Validators[1].ProposerPriority) // u2 - - _, err = incrementProposerPriorityNTimes(snapshot, 1) - require.NoError(t, err) - - // 79 + 10 - (100+10+10) - assert.Equal(t, big.NewInt(-31), snapshot.Validators[0].ProposerPriority) - // 79 + 10 - assert.Equal(t, big.NewInt(89), snapshot.Validators[1].ProposerPriority) - // -157+100 - assert.Equal(t, big.NewInt(-57), snapshot.Validators[2].ProposerPriority) -} - -func TestProposerCalculator_UpdateValidators(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(4) - require.NoError(t, err) - - v1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(10)} - v2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(20)} - v3 := &validator.ValidatorMetadata{Address: types.Address{0x3}, BlsKey: keys[2].PublicKey(), VotingPower: big.NewInt(30)} - - vs := validator.NewValidatorSet([]*validator.ValidatorMetadata{v1, v2, v3}, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(0, vs.Accounts()) - require.Equal(t, big.NewInt(60), snapshot.GetTotalVotingPower()) - // init priority must be 0 - require.Zero(t, snapshot.Validators[0].ProposerPriority.Int64()) - require.Zero(t, snapshot.Validators[1].ProposerPriority.Int64()) - require.Zero(t, snapshot.Validators[2].ProposerPriority.Int64()) - // vp must be initialized - require.Equal(t, big.NewInt(10), snapshot.Validators[0].Metadata.VotingPower) - require.Equal(t, big.NewInt(20), snapshot.Validators[1].Metadata.VotingPower) - require.Equal(t, big.NewInt(30), snapshot.Validators[2].Metadata.VotingPower) - - // increment once - _, err = incrementProposerPriorityNTimes(snapshot, 1) - require.NoError(t, err) - - // updated - u1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(100)} - u2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(200)} - u3 := &validator.ValidatorMetadata{Address: types.Address{0x3}, BlsKey: keys[2].PublicKey(), VotingPower: big.NewInt(300)} - // added - a1 := &validator.ValidatorMetadata{Address: types.Address{0x4}, BlsKey: keys[3].PublicKey(), VotingPower: big.NewInt(400)} - - require.NoError(t, updateValidators(snapshot, []*validator.ValidatorMetadata{u1, u2, u3, a1})) - - require.Equal(t, 4, len(snapshot.Validators)) - // priorities are from previous iteration - require.Equal(t, big.NewInt(292), snapshot.Validators[0].ProposerPriority) - require.Equal(t, big.NewInt(302), snapshot.Validators[1].ProposerPriority) - require.Equal(t, big.NewInt(252), snapshot.Validators[2].ProposerPriority) - // new added a1 - require.Equal(t, types.Address{0x4}, snapshot.Validators[3].Metadata.Address) - require.Equal(t, big.NewInt(-843), snapshot.Validators[3].ProposerPriority) - // total vp is updated - require.Equal(t, big.NewInt(1000), snapshot.GetTotalVotingPower()) -} - -func TestProposerCalculator_ScaleAfterDelete(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(3) - require.NoError(t, err) - - v1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(10)} - v2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(10)} - v3 := &validator.ValidatorMetadata{Address: types.Address{0x3}, BlsKey: keys[2].PublicKey(), VotingPower: big.NewInt(80000)} - - vs := validator.NewValidatorSet([]*validator.ValidatorMetadata{v1, v2, v3}, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(0, vs.Accounts()) - assert.Equal(t, big.NewInt(80020), snapshot.GetTotalVotingPower()) - - _, err = incrementProposerPriorityNTimes(snapshot, 1) - require.NoError(t, err) - - // priorities are from previous iteration - require.Equal(t, big.NewInt(10), snapshot.Validators[0].ProposerPriority) - require.Equal(t, big.NewInt(10), snapshot.Validators[1].ProposerPriority) - require.Equal(t, big.NewInt(-20), snapshot.Validators[2].ProposerPriority) - - // another increment - proposer, err := incrementProposerPriorityNTimes(snapshot, 4000) - require.NoError(t, err) - // priorities are from previous iteration - assert.Equal(t, types.Address{0x3}, proposer.Metadata.Address) - - // reduce validator voting power from 8k to 1 - u1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(10)} - u2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(10)} - - require.Equal(t, big.NewInt(-40010), snapshot.Validators[0].ProposerPriority) - require.Equal(t, big.NewInt(40010), snapshot.Validators[1].ProposerPriority) - - require.NoError(t, updateValidators(snapshot, []*validator.ValidatorMetadata{u1, u2})) - - // maxdiff = 2*tvp = 40 - // diff(min,max) (-40010, 40010) = 80020 - // ratio := (diff + diffMax - 1) / diffMax; (80020 + 20 - 1)/20 = 2001 - // priority = priority / ratio; u1 = -40010 / 4001 ~ -19; u2 = 40010 / 4001 ~ 19 - require.Equal(t, big.NewInt(-19), snapshot.Validators[0].ProposerPriority) - require.Equal(t, big.NewInt(19), snapshot.Validators[1].ProposerPriority) - require.Equal(t, big.NewInt(20), snapshot.GetTotalVotingPower()) -} - -func TestProposerCalculator_ShiftAfterUpdate(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(3) - require.NoError(t, err) - - v1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(50)} - v2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(80)} - v3 := &validator.ValidatorMetadata{Address: types.Address{0x3}, BlsKey: keys[2].PublicKey(), VotingPower: big.NewInt(100000)} - - vs := validator.NewValidatorSet([]*validator.ValidatorMetadata{v1, v2, v3}, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(0, vs.Accounts()) - assert.Equal(t, big.NewInt(100130), snapshot.GetTotalVotingPower()) - - _, err = incrementProposerPriorityNTimes(snapshot, 4000) - require.NoError(t, err) - - // updates - u1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(5)} - u2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(8)} - - require.NoError(t, updateValidators(snapshot, []*validator.ValidatorMetadata{u1, u2})) - - // maxdiff = 2*tvp = 26 - // diff(min,max) (-260, 19610) = 19870 - // ratio := (diff + diffMax - 1) / diffMax; (19870 + 26 - 1)/26 =765 - // scale priority = priority / ratio; p1 = 0; p2 = 25 - // shift with avg=(25+0)/2=12; p = priority - avg; u1 = -12; u2= 13 - require.Equal(t, big.NewInt(-12), snapshot.Validators[0].ProposerPriority) - require.Equal(t, big.NewInt(13), snapshot.Validators[1].ProposerPriority) - require.Equal(t, big.NewInt(13), snapshot.GetTotalVotingPower()) -} - -func TestProposerCalculator_UpdateValidatorSet(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(3) - require.NoError(t, err) - - v1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(1)} - v2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(8)} - v3 := &validator.ValidatorMetadata{Address: types.Address{0x3}, BlsKey: keys[2].PublicKey(), VotingPower: big.NewInt(15)} - - vs := validator.NewValidatorSet([]*validator.ValidatorMetadata{v1, v2, v3}, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(0, vs.Accounts()) - assert.Equal(t, big.NewInt(24), snapshot.GetTotalVotingPower()) - - _, err = incrementProposerPriorityNTimes(snapshot, 2) - require.NoError(t, err) - - // modified validator - u1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(5)} - // added validator - a1 := &validator.ValidatorMetadata{Address: types.Address{0x4}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(8)} - - require.NoError(t, updateValidators(snapshot, []*validator.ValidatorMetadata{u1, a1})) - // expecting 2 validators with updated voting power and total voting power - require.Equal(t, 2, len(snapshot.Validators)) - require.Equal(t, types.Address{0x1}, snapshot.Validators[0].Metadata.Address) - require.Equal(t, big.NewInt(5), snapshot.Validators[0].Metadata.VotingPower) - require.Equal(t, big.NewInt(11), snapshot.Validators[0].ProposerPriority) - - require.Equal(t, types.Address{0x4}, snapshot.Validators[1].Metadata.Address) - require.Equal(t, big.NewInt(8), snapshot.Validators[1].Metadata.VotingPower) - require.Equal(t, big.NewInt(-10), snapshot.Validators[1].ProposerPriority) - require.Equal(t, big.NewInt(13), snapshot.GetTotalVotingPower()) -} - -func TestProposerCalculator_AddValidator(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(3) - require.NoError(t, err) - - v1 := &validator.ValidatorMetadata{Address: types.Address{0x1}, BlsKey: keys[0].PublicKey(), VotingPower: big.NewInt(3)} - v2 := &validator.ValidatorMetadata{Address: types.Address{0x2}, BlsKey: keys[1].PublicKey(), VotingPower: big.NewInt(1)} - - vs := validator.NewValidatorSet([]*validator.ValidatorMetadata{v1, v2}, hclog.NewNullLogger()) - - snapshot := NewProposerSnapshot(0, vs.Accounts()) - assert.Equal(t, big.NewInt(4), snapshot.GetTotalVotingPower()) - proposer, err := incrementProposerPriorityNTimes(snapshot, 1) - require.NoError(t, err) - require.Equal(t, types.Address{0x1}, proposer.Metadata.Address) - require.Equal(t, big.NewInt(-1), snapshot.Validators[0].ProposerPriority) - require.Equal(t, big.NewInt(1), snapshot.Validators[1].ProposerPriority) - - _, err = incrementProposerPriorityNTimes(snapshot, 1) - require.NoError(t, err) - - require.Equal(t, big.NewInt(-2), snapshot.Validators[0].ProposerPriority) - require.Equal(t, big.NewInt(2), snapshot.Validators[1].ProposerPriority) - - a1 := &validator.ValidatorMetadata{Address: types.Address{0x3}, BlsKey: keys[2].PublicKey(), VotingPower: big.NewInt(8)} - - require.NoError(t, updateValidators(snapshot, []*validator.ValidatorMetadata{v1, v2, a1})) - - // updated vp: 8+3+1 = 12 - // added validator priority = -1.125*8 ~ -13 - // scaling: max(-13, 3) = 16 < 2* 12; no scaling - // centring: avg = (13+3+1)/3=5; v1=-2+5, v2=2+5; u3=-13+5 - require.Equal(t, big.NewInt(3), snapshot.Validators[0].ProposerPriority) - require.Equal(t, big.NewInt(7), snapshot.Validators[1].ProposerPriority) - require.Equal(t, big.NewInt(-8), snapshot.Validators[2].ProposerPriority) -} diff --git a/consensus/polybft/proto/transport.pb.go b/consensus/polybft/proto/transport.pb.go deleted file mode 100644 index 3aaa60f..0000000 --- a/consensus/polybft/proto/transport.pb.go +++ /dev/null @@ -1,144 +0,0 @@ -// Code generated by protoc-gen-go. DO NOT EDIT. -// versions: -// protoc-gen-go v1.28.1 -// protoc v3.21.7 -// source: consensus/polybft/proto/transport.proto - -package proto - -import ( - protoreflect "google.golang.org/protobuf/reflect/protoreflect" - protoimpl "google.golang.org/protobuf/runtime/protoimpl" - reflect "reflect" - sync "sync" -) - -const ( - // Verify that this generated code is sufficiently up-to-date. - _ = protoimpl.EnforceVersion(20 - protoimpl.MinVersion) - // Verify that runtime/protoimpl is sufficiently up-to-date. - _ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20) -) - -type TransportMessage struct { - state protoimpl.MessageState - sizeCache protoimpl.SizeCache - unknownFields protoimpl.UnknownFields - - Data []byte `protobuf:"bytes,1,opt,name=data,proto3" json:"data,omitempty"` -} - -func (x *TransportMessage) Reset() { - *x = TransportMessage{} - if protoimpl.UnsafeEnabled { - mi := &file_consensus_polybft_proto_transport_proto_msgTypes[0] - ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x)) - ms.StoreMessageInfo(mi) - } -} - -func (x *TransportMessage) String() string { - return protoimpl.X.MessageStringOf(x) -} - -func (*TransportMessage) ProtoMessage() {} - -func (x *TransportMessage) ProtoReflect() protoreflect.Message { - mi := &file_consensus_polybft_proto_transport_proto_msgTypes[0] - if protoimpl.UnsafeEnabled && x != nil { - ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x)) - if ms.LoadMessageInfo() == nil { - ms.StoreMessageInfo(mi) - } - return ms - } - return mi.MessageOf(x) -} - -// Deprecated: Use TransportMessage.ProtoReflect.Descriptor instead. -func (*TransportMessage) Descriptor() ([]byte, []int) { - return file_consensus_polybft_proto_transport_proto_rawDescGZIP(), []int{0} -} - -func (x *TransportMessage) GetData() []byte { - if x != nil { - return x.Data - } - return nil -} - -var File_consensus_polybft_proto_transport_proto protoreflect.FileDescriptor - -var file_consensus_polybft_proto_transport_proto_rawDesc = []byte{ - 0x0a, 0x27, 0x63, 0x6f, 0x6e, 0x73, 0x65, 0x6e, 0x73, 0x75, 0x73, 0x2f, 0x70, 0x6f, 0x6c, 0x79, - 0x62, 0x66, 0x74, 0x2f, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x2f, 0x74, 0x72, 0x61, 0x6e, 0x73, 0x70, - 0x6f, 0x72, 0x74, 0x2e, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x12, 0x02, 0x76, 0x31, 0x22, 0x26, 0x0a, - 0x10, 0x54, 0x72, 0x61, 0x6e, 0x73, 0x70, 0x6f, 0x72, 0x74, 0x4d, 0x65, 0x73, 0x73, 0x61, 0x67, - 0x65, 0x12, 0x12, 0x0a, 0x04, 0x64, 0x61, 0x74, 0x61, 0x18, 0x01, 0x20, 0x01, 0x28, 0x0c, 0x52, - 0x04, 0x64, 0x61, 0x74, 0x61, 0x42, 0x1a, 0x5a, 0x18, 0x2f, 0x63, 0x6f, 0x6e, 0x73, 0x65, 0x6e, - 0x73, 0x75, 0x73, 0x2f, 0x70, 0x6f, 0x6c, 0x79, 0x62, 0x66, 0x74, 0x2f, 0x70, 0x72, 0x6f, 0x74, - 0x6f, 0x62, 0x06, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x33, -} - -var ( - file_consensus_polybft_proto_transport_proto_rawDescOnce sync.Once - file_consensus_polybft_proto_transport_proto_rawDescData = file_consensus_polybft_proto_transport_proto_rawDesc -) - -func file_consensus_polybft_proto_transport_proto_rawDescGZIP() []byte { - file_consensus_polybft_proto_transport_proto_rawDescOnce.Do(func() { - file_consensus_polybft_proto_transport_proto_rawDescData = protoimpl.X.CompressGZIP(file_consensus_polybft_proto_transport_proto_rawDescData) - }) - return file_consensus_polybft_proto_transport_proto_rawDescData -} - -var file_consensus_polybft_proto_transport_proto_msgTypes = make([]protoimpl.MessageInfo, 1) -var file_consensus_polybft_proto_transport_proto_goTypes = []interface{}{ - (*TransportMessage)(nil), // 0: v1.TransportMessage -} -var file_consensus_polybft_proto_transport_proto_depIdxs = []int32{ - 0, // [0:0] is the sub-list for method output_type - 0, // [0:0] is the sub-list for method input_type - 0, // [0:0] is the sub-list for extension type_name - 0, // [0:0] is the sub-list for extension extendee - 0, // [0:0] is the sub-list for field type_name -} - -func init() { file_consensus_polybft_proto_transport_proto_init() } -func file_consensus_polybft_proto_transport_proto_init() { - if File_consensus_polybft_proto_transport_proto != nil { - return - } - if !protoimpl.UnsafeEnabled { - file_consensus_polybft_proto_transport_proto_msgTypes[0].Exporter = func(v interface{}, i int) interface{} { - switch v := v.(*TransportMessage); i { - case 0: - return &v.state - case 1: - return &v.sizeCache - case 2: - return &v.unknownFields - default: - return nil - } - } - } - type x struct{} - out := protoimpl.TypeBuilder{ - File: protoimpl.DescBuilder{ - GoPackagePath: reflect.TypeOf(x{}).PkgPath(), - RawDescriptor: file_consensus_polybft_proto_transport_proto_rawDesc, - NumEnums: 0, - NumMessages: 1, - NumExtensions: 0, - NumServices: 0, - }, - GoTypes: file_consensus_polybft_proto_transport_proto_goTypes, - DependencyIndexes: file_consensus_polybft_proto_transport_proto_depIdxs, - MessageInfos: file_consensus_polybft_proto_transport_proto_msgTypes, - }.Build() - File_consensus_polybft_proto_transport_proto = out.File - file_consensus_polybft_proto_transport_proto_rawDesc = nil - file_consensus_polybft_proto_transport_proto_goTypes = nil - file_consensus_polybft_proto_transport_proto_depIdxs = nil -} diff --git a/consensus/polybft/proto/transport.pb.validate.go b/consensus/polybft/proto/transport.pb.validate.go deleted file mode 100644 index b198296..0000000 --- a/consensus/polybft/proto/transport.pb.validate.go +++ /dev/null @@ -1,138 +0,0 @@ -// Code generated by protoc-gen-validate. DO NOT EDIT. -// source: consensus/polybft/proto/transport.proto - -package proto - -import ( - "bytes" - "errors" - "fmt" - "net" - "net/mail" - "net/url" - "regexp" - "sort" - "strings" - "time" - "unicode/utf8" - - "google.golang.org/protobuf/types/known/anypb" -) - -// ensure the imports are used -var ( - _ = bytes.MinRead - _ = errors.New("") - _ = fmt.Print - _ = utf8.UTFMax - _ = (*regexp.Regexp)(nil) - _ = (*strings.Reader)(nil) - _ = net.IPv4len - _ = time.Duration(0) - _ = (*url.URL)(nil) - _ = (*mail.Address)(nil) - _ = anypb.Any{} - _ = sort.Sort -) - -// Validate checks the field values on TransportMessage with the rules defined -// in the proto definition for this message. If any rules are violated, the -// first error encountered is returned, or nil if there are no violations. -func (m *TransportMessage) Validate() error { - return m.validate(false) -} - -// ValidateAll checks the field values on TransportMessage with the rules -// defined in the proto definition for this message. If any rules are -// violated, the result is a list of violation errors wrapped in -// TransportMessageMultiError, or nil if none found. -func (m *TransportMessage) ValidateAll() error { - return m.validate(true) -} - -func (m *TransportMessage) validate(all bool) error { - if m == nil { - return nil - } - - var errors []error - - // no validation rules for Data - - if len(errors) > 0 { - return TransportMessageMultiError(errors) - } - - return nil -} - -// TransportMessageMultiError is an error wrapping multiple validation errors -// returned by TransportMessage.ValidateAll() if the designated constraints -// aren't met. -type TransportMessageMultiError []error - -// Error returns a concatenation of all the error messages it wraps. -func (m TransportMessageMultiError) Error() string { - var msgs []string - for _, err := range m { - msgs = append(msgs, err.Error()) - } - return strings.Join(msgs, "; ") -} - -// AllErrors returns a list of validation violation errors. -func (m TransportMessageMultiError) AllErrors() []error { return m } - -// TransportMessageValidationError is the validation error returned by -// TransportMessage.Validate if the designated constraints aren't met. -type TransportMessageValidationError struct { - field string - reason string - cause error - key bool -} - -// Field function returns field value. -func (e TransportMessageValidationError) Field() string { return e.field } - -// Reason function returns reason value. -func (e TransportMessageValidationError) Reason() string { return e.reason } - -// Cause function returns cause value. -func (e TransportMessageValidationError) Cause() error { return e.cause } - -// Key function returns key value. -func (e TransportMessageValidationError) Key() bool { return e.key } - -// ErrorName returns error name. -func (e TransportMessageValidationError) ErrorName() string { return "TransportMessageValidationError" } - -// Error satisfies the builtin error interface -func (e TransportMessageValidationError) Error() string { - cause := "" - if e.cause != nil { - cause = fmt.Sprintf(" | caused by: %v", e.cause) - } - - key := "" - if e.key { - key = "key for " - } - - return fmt.Sprintf( - "invalid %sTransportMessage.%s: %s%s", - key, - e.field, - e.reason, - cause) -} - -var _ error = TransportMessageValidationError{} - -var _ interface { - Field() string - Reason() string - Key() bool - Cause() error - ErrorName() string -} = TransportMessageValidationError{} diff --git a/consensus/polybft/proto/transport.proto b/consensus/polybft/proto/transport.proto deleted file mode 100644 index 329c105..0000000 --- a/consensus/polybft/proto/transport.proto +++ /dev/null @@ -1,9 +0,0 @@ -syntax = "proto3"; - -package v1; - -option go_package = "/consensus/polybft/proto"; - -message TransportMessage { - bytes data = 1; -} \ No newline at end of file diff --git a/consensus/polybft/runtime_helpers.go b/consensus/polybft/runtime_helpers.go deleted file mode 100644 index d1d419a..0000000 --- a/consensus/polybft/runtime_helpers.go +++ /dev/null @@ -1,50 +0,0 @@ -package polybft - -import ( - "github.com/xgr-network/xgr-node/blockchain" - "github.com/xgr-network/xgr-node/types" -) - -// isEndOfPeriod checks if an end of a period (either it be sprint or epoch) -// is reached with the current block (the parent block of the current fsm iteration) -func isEndOfPeriod(blockNumber, periodSize uint64) bool { - return blockNumber%periodSize == 0 -} - -// getBlockData returns block header and extra -func getBlockData(blockNumber uint64, blockchainBackend blockchainBackend) (*types.Header, *Extra, error) { - blockHeader, found := blockchainBackend.GetHeaderByNumber(blockNumber) - if !found { - return nil, nil, blockchain.ErrNoBlock - } - - blockExtra, err := GetIbftExtra(blockHeader.ExtraData) - if err != nil { - return nil, nil, err - } - - return blockHeader, blockExtra, nil -} - -// isEpochEndingBlock checks if given block is an epoch ending block -func isEpochEndingBlock(blockNumber uint64, extra *Extra, blockchain blockchainBackend) (bool, error) { - if extra.Validators == nil { - // non epoch ending blocks have validator set delta as nil - return false, nil - } - - if !extra.Validators.IsEmpty() { - // if validator set delta is not empty, the validator set was changed in this block - // meaning the epoch changed as well - return true, nil - } - - _, nextBlockExtra, err := getBlockData(blockNumber+1, blockchain) - if err != nil { - return false, err - } - - // validator set delta can be empty (no change in validator set happened) - // so we need to check if their epoch numbers are different - return extra.Checkpoint.EpochNumber != nextBlockExtra.Checkpoint.EpochNumber, nil -} diff --git a/consensus/polybft/runtime_helpers_test.go b/consensus/polybft/runtime_helpers_test.go deleted file mode 100644 index 77f7e5b..0000000 --- a/consensus/polybft/runtime_helpers_test.go +++ /dev/null @@ -1,88 +0,0 @@ -package polybft - -import ( - "testing" - - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/blockchain" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/types" -) - -func TestHelpers_isEpochEndingBlock_DeltaNotEmpty(t *testing.T) { - t.Parallel() - - validators := validator.NewTestValidators(t, 3).GetPublicIdentities() - bitmap := bitmap.Bitmap{} - bitmap.Set(0) - - delta := &validator.ValidatorSetDelta{ - Added: validators[1:], - Removed: bitmap, - } - - extra := &Extra{Validators: delta, Checkpoint: &CheckpointData{EpochNumber: 2}} - blockNumber := uint64(20) - - isEndOfEpoch, err := isEpochEndingBlock(blockNumber, extra, new(blockchainMock)) - require.NoError(t, err) - require.True(t, isEndOfEpoch) -} - -func TestHelpers_isEpochEndingBlock_NoBlock(t *testing.T) { - t.Parallel() - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(&types.Header{}, false) - - extra := &Extra{Checkpoint: &CheckpointData{EpochNumber: 2}, Validators: &validator.ValidatorSetDelta{}} - blockNumber := uint64(20) - - isEndOfEpoch, err := isEpochEndingBlock(blockNumber, extra, blockchainMock) - require.ErrorIs(t, blockchain.ErrNoBlock, err) - require.False(t, isEndOfEpoch) -} - -func TestHelpers_isEpochEndingBlock_EpochsNotTheSame(t *testing.T) { - t.Parallel() - - blockchainMock := new(blockchainMock) - - nextBlockExtra := &Extra{Checkpoint: &CheckpointData{EpochNumber: 3}, Validators: &validator.ValidatorSetDelta{}} - nextBlock := &types.Header{ - Number: 21, - ExtraData: nextBlockExtra.MarshalRLPTo(nil), - } - - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(nextBlock, true) - - extra := &Extra{Checkpoint: &CheckpointData{EpochNumber: 2}, Validators: &validator.ValidatorSetDelta{}} - blockNumber := uint64(20) - - isEndOfEpoch, err := isEpochEndingBlock(blockNumber, extra, blockchainMock) - require.NoError(t, err) - require.True(t, isEndOfEpoch) -} - -func TestHelpers_isEpochEndingBlock_EpochsAreTheSame(t *testing.T) { - t.Parallel() - - blockchainMock := new(blockchainMock) - - nextBlockExtra := &Extra{Checkpoint: &CheckpointData{EpochNumber: 2}, Validators: &validator.ValidatorSetDelta{}} - nextBlock := &types.Header{ - Number: 16, - ExtraData: nextBlockExtra.MarshalRLPTo(nil), - } - - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(nextBlock, true) - - extra := &Extra{Checkpoint: &CheckpointData{EpochNumber: 2}, Validators: &validator.ValidatorSetDelta{}} - blockNumber := uint64(15) - - isEndOfEpoch, err := isEpochEndingBlock(blockNumber, extra, blockchainMock) - require.NoError(t, err) - require.False(t, isEndOfEpoch) -} diff --git a/consensus/polybft/sc_integration_test.go b/consensus/polybft/sc_integration_test.go deleted file mode 100644 index 3638c26..0000000 --- a/consensus/polybft/sc_integration_test.go +++ /dev/null @@ -1,413 +0,0 @@ -package polybft - -import ( - "math" - "math/big" - "strconv" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/crypto" - "github.com/xgr-network/xgr-node/helper/hex" - "github.com/xgr-network/xgr-node/state" - "github.com/xgr-network/xgr-node/types" -) - -func TestIntegration_PerformExit(t *testing.T) { - t.Parallel() - - const gasLimit = 1000000000000 - - // create validator set and checkpoint mngr - currentValidators := validator.NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D"}, []uint64{100, 100, 100, 100}) - accSet := currentValidators.GetPublicIdentities() - cm := checkpointManager{blockchain: &blockchainMock{}} - - deployerAddress := types.Address{76, 76, 1} // account that will deploy contracts - senderAddress := types.Address{1} // account that sends exit/withdraw transactions - receiverAddr := types.Address{6} // account that receive tokens - amount1 := big.NewInt(3) // amount of the first widrawal - amount2 := big.NewInt(2) // amount of the second widrawal - bn256Addr := types.Address{2} // bls contract - stateSenderAddr := types.Address{5} // generic bridge contract on rootchain - - alloc := map[types.Address]*chain.GenesisAccount{ - senderAddress: {Balance: new(big.Int).Add(amount1, amount2)}, // give some ethers to sender - deployerAddress: {Balance: ethgo.Ether(100)}, // give 100 ethers to deployer - contracts.BLSContract: {Code: contractsapi.BLS.DeployedBytecode}, - bn256Addr: {Code: contractsapi.BLS256.DeployedBytecode}, - stateSenderAddr: {Code: contractsapi.StateSender.DeployedBytecode}, - } - transition := newTestTransition(t, alloc) - - getField := func(addr types.Address, abi *abi.ABI, function string, args ...interface{}) []byte { - input, err := abi.GetMethod(function).Encode(args) - require.NoError(t, err) - - result := transition.Call2(deployerAddress, addr, input, big.NewInt(0), gasLimit) - require.True(t, result.Succeeded()) - - return result.ReturnValue - } - - // deploy MockERC20 as root chain ERC 20 token - rootERC20Addr := deployAndInitContract(t, transition, contractsapi.RootERC20.Bytecode, deployerAddress, nil) - - // deploy CheckpointManager - checkpointManagerInit := func() ([]byte, error) { - return (&contractsapi.InitializeCheckpointManagerFn{ - NewBls: contracts.BLSContract, - NewBn256G2: bn256Addr, - NewValidatorSet: accSet.ToAPIBinding(), - ChainID_: big.NewInt(0), - }).EncodeAbi() - } - - checkpointMgrConstructor := &contractsapi.CheckpointManagerConstructorFn{Initiator: deployerAddress} - constructorInput, err := checkpointMgrConstructor.EncodeAbi() - require.NoError(t, err) - - checkpointManagerAddr := deployAndInitContract(t, transition, append(contractsapi.CheckpointManager.Bytecode, constructorInput...), deployerAddress, checkpointManagerInit) - - // deploy ExitHelper - exitHelperInit := func() ([]byte, error) { - return (&contractsapi.InitializeExitHelperFn{NewCheckpointManager: checkpointManagerAddr}).EncodeAbi() - } - exitHelperContractAddress := deployAndInitContract(t, transition, contractsapi.ExitHelper.Bytecode, deployerAddress, exitHelperInit) - - // deploy RootERC20Predicate - rootERC20PredicateInit := func() ([]byte, error) { - return (&contractsapi.InitializeRootERC20PredicateFn{ - NewStateSender: stateSenderAddr, - NewExitHelper: exitHelperContractAddress, - NewChildERC20Predicate: contracts.ChildERC20PredicateContract, - NewChildTokenTemplate: contracts.ChildERC20Contract, - NewNativeTokenRoot: contracts.NativeERC20TokenContract, - }).EncodeAbi() - } - rootERC20PredicateAddr := deployAndInitContract(t, transition, contractsapi.RootERC20Predicate.Bytecode, deployerAddress, rootERC20PredicateInit) - - // validate initialization of CheckpointManager - require.Equal(t, getField(checkpointManagerAddr, contractsapi.CheckpointManager.Abi, "currentCheckpointBlockNumber")[31], uint8(0)) - - accSetHash, err := accSet.Hash() - require.NoError(t, err) - - blockHash := types.Hash{5} - blockNumber := uint64(1) - epochNumber := uint64(1) - blockRound := uint64(1) - - // mint - mintInput, err := (&contractsapi.MintRootERC20Fn{ - To: senderAddress, - Amount: alloc[senderAddress].Balance, - }).EncodeAbi() - require.NoError(t, err) - - result := transition.Call2(deployerAddress, rootERC20Addr, mintInput, nil, gasLimit) - require.NoError(t, result.Err) - - // approve - approveInput, err := (&contractsapi.ApproveRootERC20Fn{ - Spender: rootERC20PredicateAddr, - Amount: alloc[senderAddress].Balance, - }).EncodeAbi() - require.NoError(t, err) - - result = transition.Call2(senderAddress, rootERC20Addr, approveInput, big.NewInt(0), gasLimit) - require.NoError(t, result.Err) - - // deposit - depositInput, err := (&contractsapi.DepositToRootERC20PredicateFn{ - RootToken: rootERC20Addr, - Receiver: receiverAddr, - Amount: new(big.Int).Add(amount1, amount2), - }).EncodeAbi() - require.NoError(t, err) - - // send sync events to childchain so that receiver can obtain tokens - result = transition.Call2(senderAddress, rootERC20PredicateAddr, depositInput, big.NewInt(0), gasLimit) - require.NoError(t, result.Err) - - // simulate withdrawal from childchain to rootchain - widthdrawSig := crypto.Keccak256([]byte("WITHDRAW")) - erc20DataType := abi.MustNewType( - "tuple(bytes32 withdrawSignature, address rootToken, address withdrawer, address receiver, uint256 amount)") - - exitData1, err := erc20DataType.Encode(map[string]interface{}{ - "withdrawSignature": widthdrawSig, - "rootToken": ethgo.Address(rootERC20Addr), - "withdrawer": ethgo.Address(senderAddress), - "receiver": ethgo.Address(receiverAddr), - "amount": amount1, - }) - require.NoError(t, err) - - exitData2, err := erc20DataType.Encode(map[string]interface{}{ - "withdrawSignature": widthdrawSig, - "rootToken": ethgo.Address(rootERC20Addr), - "withdrawer": ethgo.Address(senderAddress), - "receiver": ethgo.Address(receiverAddr), - "amount": amount2, - }) - require.NoError(t, err) - - exits := []*ExitEvent{ - { - L2StateSyncedEvent: &contractsapi.L2StateSyncedEvent{ - ID: big.NewInt(1), - Sender: contracts.ChildERC20PredicateContract, - Receiver: rootERC20PredicateAddr, - Data: exitData1, - }, - }, - { - L2StateSyncedEvent: &contractsapi.L2StateSyncedEvent{ - ID: big.NewInt(2), - Sender: contracts.ChildERC20PredicateContract, - Receiver: rootERC20PredicateAddr, - Data: exitData2, - }, - }, - } - exitTree, err := createExitTree(exits) - require.NoError(t, err) - - eventRoot := exitTree.Hash() - - checkpointData := &CheckpointData{ - BlockRound: blockRound, - EpochNumber: epochNumber, - CurrentValidatorsHash: accSetHash, - NextValidatorsHash: accSetHash, - EventRoot: eventRoot, - } - - checkpointHash, err := checkpointData.Hash( - cm.blockchain.GetChainID(), - blockRound, - blockHash) - require.NoError(t, err) - - i := uint64(0) - bmp := bitmap.Bitmap{} - signatures := bls.Signatures(nil) - - currentValidators.IterAcct(nil, func(v *validator.TestValidator) { - signatures = append(signatures, v.MustSign(checkpointHash[:], signer.DomainCheckpointManager)) - bmp.Set(i) - i++ - }) - - aggSignature, err := signatures.Aggregate().Marshal() - require.NoError(t, err) - - extra := &Extra{ - Checkpoint: checkpointData, - Committed: &Signature{ - AggregatedSignature: aggSignature, - Bitmap: bmp, - }, - } - - // submit a checkpoint - submitCheckpointEncoded, err := cm.abiEncodeCheckpointBlock(blockNumber, blockHash, extra, accSet) - require.NoError(t, err) - - result = transition.Call2(senderAddress, checkpointManagerAddr, submitCheckpointEncoded, big.NewInt(0), gasLimit) - require.NoError(t, result.Err) - require.Equal(t, getField(checkpointManagerAddr, contractsapi.CheckpointManager.Abi, "currentCheckpointBlockNumber")[31], uint8(1)) - - // check that the exit hasn't performed - res := getField(exitHelperContractAddress, contractsapi.ExitHelper.Abi, "processedExits", exits[0].ID) - require.Equal(t, 0, int(res[31])) - - proofExitEvent, err := exits[0].L2StateSyncedEvent.Encode() - require.NoError(t, err) - - proof, err := exitTree.GenerateProof(proofExitEvent) - require.NoError(t, err) - - leafIndex, err := exitTree.LeafIndex(proofExitEvent) - require.NoError(t, err) - - exitFnInput, err := (&contractsapi.ExitExitHelperFn{ - BlockNumber: new(big.Int).SetUint64(blockNumber), - LeafIndex: new(big.Int).SetUint64(leafIndex), - UnhashedLeaf: proofExitEvent, - Proof: proof, - }).EncodeAbi() - require.NoError(t, err) - - result = transition.Call2(senderAddress, exitHelperContractAddress, exitFnInput, big.NewInt(0), gasLimit) - require.NoError(t, result.Err) - - // check that first exit event is processed - res = getField(exitHelperContractAddress, contractsapi.ExitHelper.Abi, "processedExits", exits[0].ID) - require.Equal(t, 1, int(res[31])) - - res = getField(rootERC20Addr, contractsapi.RootERC20.Abi, "balanceOf", receiverAddr) - require.Equal(t, amount1, new(big.Int).SetBytes(res)) -} - -func TestIntegration_CommitEpoch(t *testing.T) { - t.Parallel() - - // init validator sets - validatorSetSize := []int{5, 10, 50, 100} - - intialBalance := uint64(5 * math.Pow(10, 18)) // 5 tokens - reward := uint64(math.Pow(10, 18)) // 1 token - walletAddress := types.StringToAddress("1234889893") - - validatorSets := make([]*validator.TestValidators, len(validatorSetSize), len(validatorSetSize)) - - // create all validator sets which will be used in test - for i, size := range validatorSetSize { - aliases := make([]string, size, size) - vps := make([]uint64, size, size) - - for j := 0; j < size; j++ { - aliases[j] = "v" + strconv.Itoa(j) - vps[j] = intialBalance - } - - validatorSets[i] = validator.NewTestValidatorsWithAliases(t, aliases, vps) - } - - // iterate through the validator set and do the test for each of them - for _, currentValidators := range validatorSets { - accSet := currentValidators.GetPublicIdentities() - - // validator data for polybft config - initValidators := make([]*validator.GenesisValidator, accSet.Len()) - // add contracts to genesis data - alloc := map[types.Address]*chain.GenesisAccount{ - contracts.ValidatorSetContract: { - Code: contractsapi.ValidatorSet.DeployedBytecode, - }, - contracts.RewardPoolContract: { - Code: contractsapi.RewardPool.DeployedBytecode, - }, - contracts.NativeERC20TokenContract: { - Code: contractsapi.NativeERC20.DeployedBytecode, - }, - walletAddress: { - Balance: new(big.Int).SetUint64(intialBalance), - }, - } - - for i, val := range accSet { - // add validator to genesis data - alloc[val.Address] = &chain.GenesisAccount{ - Balance: val.VotingPower, - } - - // create validator data for polybft config - initValidators[i] = &validator.GenesisValidator{ - Address: val.Address, - Stake: val.VotingPower, - BlsKey: hex.EncodeToString(val.BlsKey.Marshal()), - } - } - - polyBFTConfig := PolyBFTConfig{ - InitialValidatorSet: initValidators, - EpochSize: 24 * 60 * 60 / 2, - SprintSize: 5, - EpochReward: reward, - // use 1st account as governance address - Governance: currentValidators.ToValidatorSet().Accounts().GetAddresses()[0], - RewardConfig: &RewardsConfig{ - TokenAddress: contracts.NativeERC20TokenContract, - WalletAddress: walletAddress, - WalletAmount: new(big.Int).SetUint64(intialBalance), - }, - Bridge: &BridgeConfig{ - CustomSupernetManagerAddr: types.StringToAddress("0x12312451"), - }, - } - - transition := newTestTransition(t, alloc) - - // init ValidatorSet - err := initValidatorSet(polyBFTConfig, transition) - require.NoError(t, err) - - // init RewardPool - err = initRewardPool(polyBFTConfig, transition) - require.NoError(t, err) - - // approve reward pool as reward token spender - err = approveRewardPoolAsSpender(polyBFTConfig, transition) - require.NoError(t, err) - - // create input for commit epoch - commitEpoch := createTestCommitEpochInput(t, 1, polyBFTConfig.EpochSize) - input, err := commitEpoch.EncodeAbi() - require.NoError(t, err) - - // call commit epoch - result := transition.Call2(contracts.SystemCaller, contracts.ValidatorSetContract, input, big.NewInt(0), 10000000000) - require.NoError(t, result.Err) - t.Logf("Number of validators %d on commit epoch, Gas used %+v\n", accSet.Len(), result.GasUsed) - - // create input for distribute rewards - distributeRewards := createTestDistributeRewardsInput(t, 1, accSet, polyBFTConfig.EpochSize) - input, err = distributeRewards.EncodeAbi() - require.NoError(t, err) - - // call reward distributor - result = transition.Call2(contracts.SystemCaller, contracts.RewardPoolContract, input, big.NewInt(0), 10000000000) - require.NoError(t, result.Err) - t.Logf("Number of validators %d on reward distribution, Gas used %+v\n", accSet.Len(), result.GasUsed) - - commitEpoch = createTestCommitEpochInput(t, 2, polyBFTConfig.EpochSize) - input, err = commitEpoch.EncodeAbi() - require.NoError(t, err) - - // call commit epoch - result = transition.Call2(contracts.SystemCaller, contracts.ValidatorSetContract, input, big.NewInt(0), 10000000000) - require.NoError(t, result.Err) - t.Logf("Number of validators %d on commit epoch, Gas used %+v\n", accSet.Len(), result.GasUsed) - - distributeRewards = createTestDistributeRewardsInput(t, 2, accSet, polyBFTConfig.EpochSize) - input, err = distributeRewards.EncodeAbi() - require.NoError(t, err) - - // call reward distributor - result = transition.Call2(contracts.SystemCaller, contracts.RewardPoolContract, input, big.NewInt(0), 10000000000) - require.NoError(t, result.Err) - t.Logf("Number of validators %d on reward distribution, Gas used %+v\n", accSet.Len(), result.GasUsed) - } -} - -func deployAndInitContract(t *testing.T, transition *state.Transition, bytecode []byte, sender types.Address, - initCallback func() ([]byte, error)) types.Address { - t.Helper() - - deployResult := transition.Create2(sender, bytecode, big.NewInt(0), 1e9) - assert.NoError(t, deployResult.Err) - - if initCallback != nil { - initInput, err := initCallback() - require.NoError(t, err) - - result := transition.Call2(sender, deployResult.Address, initInput, big.NewInt(0), 1e9) - require.NoError(t, result.Err) - } - - return deployResult.Address -} diff --git a/consensus/polybft/signer/utils.go b/consensus/polybft/signer/utils.go deleted file mode 100644 index 80efefe..0000000 --- a/consensus/polybft/signer/utils.go +++ /dev/null @@ -1,60 +0,0 @@ -package signer - -import ( - "bytes" - "math/big" - - "github.com/umbracle/ethgo/abi" - - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/crypto" - "github.com/xgr-network/xgr-node/types" -) - -var ( - addressABIType = abi.MustNewType("address") - uint256ABIType = abi.MustNewType("uint256") -) - -const ( - DomainValidatorSetString = "DOMAIN_CHILD_VALIDATOR_SET" - DomainCheckpointManagerString = "DOMAIN_CHECKPOINT_MANAGER" - DomainCommonSigningString = "DOMAIN_COMMON_SIGNING" - DomainStateReceiverString = "DOMAIN_STATE_RECEIVER" -) - -var ( - // domain used to map hash to G1 used by (child) validator set - DomainValidatorSet = crypto.Keccak256([]byte(DomainValidatorSetString)) - - // domain used to map hash to G1 used by child checkpoint manager - DomainCheckpointManager = crypto.Keccak256([]byte(DomainCheckpointManagerString)) - - DomainCommonSigning = crypto.Keccak256([]byte(DomainCommonSigningString)) - DomainStateReceiver = crypto.Keccak256([]byte(DomainStateReceiverString)) -) - -// MakeKOSKSignature creates KOSK signature which prevents rogue attack -func MakeKOSKSignature(privateKey *bls.PrivateKey, address types.Address, - chainID int64, domain []byte, supernetManagerAddr types.Address) (*bls.Signature, error) { - spenderABI, err := addressABIType.Encode(address) - if err != nil { - return nil, err - } - - supernetManagerABI, err := addressABIType.Encode(supernetManagerAddr) - if err != nil { - return nil, err - } - - chainIDABI, err := uint256ABIType.Encode(big.NewInt(chainID)) - if err != nil { - return nil, err - } - - // ethgo pads address to 32 bytes, but solidity doesn't (keeps it 20 bytes) - // that's why we are skipping first 12 bytes - message := bytes.Join([][]byte{spenderABI[12:], supernetManagerABI[12:], chainIDABI}, nil) - - return privateKey.Sign(message, domain) -} diff --git a/consensus/polybft/signer/utils_test.go b/consensus/polybft/signer/utils_test.go deleted file mode 100644 index f99fd45..0000000 --- a/consensus/polybft/signer/utils_test.go +++ /dev/null @@ -1,40 +0,0 @@ -package signer - -import ( - "encoding/hex" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/types" -) - -func Test_MakeKOSKSignature(t *testing.T) { - t.Parallel() - - expected := "03441ebc4bbca37664455b293cfc371ccf9a4f21e40c19a3a25beee77bf6e97d16cdd264c188a01d415ee99865f52567a402044a1c13aa6915a1237a41d35e9e" - bytes, _ := hex.DecodeString("3139343634393730313533353434353137333331343333303931343932303731313035313730303336303738373134363131303435323837383335373237343933383834303135343336383231") - - pk, err := bls.UnmarshalPrivateKey(bytes) - require.NoError(t, err) - - supernetManagerAddr := types.StringToAddress("0x1010101") - address := types.BytesToAddress((pk.PublicKey().Marshal())[:types.AddressLength]) - - signature, err := MakeKOSKSignature(pk, address, 10, DomainValidatorSet, supernetManagerAddr) - require.NoError(t, err) - - signatureBytes, err := signature.Marshal() - require.NoError(t, err) - - assert.Equal(t, expected, hex.EncodeToString(signatureBytes)) - - signature, err = MakeKOSKSignature(pk, address, 100, DomainValidatorSet, supernetManagerAddr) - require.NoError(t, err) - - signatureBytes, err = signature.Marshal() - require.NoError(t, err) - - assert.NotEqual(t, expected, hex.EncodeToString(signatureBytes)) -} diff --git a/consensus/polybft/stake_manager.go b/consensus/polybft/stake_manager.go deleted file mode 100644 index 46c2ab9..0000000 --- a/consensus/polybft/stake_manager.go +++ /dev/null @@ -1,526 +0,0 @@ -package polybft - -import ( - "bytes" - "encoding/json" - "errors" - "fmt" - "math/big" - "sort" - "strings" - - "github.com/hashicorp/go-hclog" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/helper/hex" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" -) - -var ( - bigZero = big.NewInt(0) - validatorTypeABI = abi.MustNewType("tuple(uint256[4] blsKey, uint256 stake, bool isWhitelisted, bool isActive)") -) - -// StakeManager interface provides functions for handling stake change of validators -// and updating validator set based on changed stake -type StakeManager interface { - EventSubscriber - PostBlock(req *PostBlockRequest) error - UpdateValidatorSet(epoch uint64, currentValidatorSet validator.AccountSet) (*validator.ValidatorSetDelta, error) -} - -var _ StakeManager = (*dummyStakeManager)(nil) - -// dummyStakeManager is a dummy implementation of StakeManager interface -// used only for unit testing -type dummyStakeManager struct{} - -func (d *dummyStakeManager) PostBlock(req *PostBlockRequest) error { return nil } -func (d *dummyStakeManager) UpdateValidatorSet(epoch uint64, - currentValidatorSet validator.AccountSet) (*validator.ValidatorSetDelta, error) { - return &validator.ValidatorSetDelta{}, nil -} - -// EventSubscriber implementation -func (d *dummyStakeManager) GetLogFilters() map[types.Address][]types.Hash { - return make(map[types.Address][]types.Hash) -} -func (d *dummyStakeManager) ProcessLog(header *types.Header, log *ethgo.Log, dbTx *bolt.Tx) error { - return nil -} - -var _ StakeManager = (*stakeManager)(nil) - -// stakeManager saves transfer events that happened in each block -// and calculates updated validator set based on changed stake -type stakeManager struct { - logger hclog.Logger - state *State - rootChainRelayer txrelayer.TxRelayer - key ethgo.Key - supernetManagerContract types.Address - validatorSetContract types.Address - maxValidatorSetSize int - polybftBackend polybftBackend -} - -// newStakeManager returns a new instance of stake manager -func newStakeManager( - logger hclog.Logger, - state *State, - rootchainRelayer txrelayer.TxRelayer, - key ethgo.Key, - validatorSetAddr, supernetManagerAddr types.Address, - blockchain blockchainBackend, - polybftBackend polybftBackend, - maxValidatorSetSize int, - dbTx *bolt.Tx, -) (*stakeManager, error) { - sm := &stakeManager{ - logger: logger, - state: state, - rootChainRelayer: rootchainRelayer, - key: key, - supernetManagerContract: supernetManagerAddr, - validatorSetContract: validatorSetAddr, - maxValidatorSetSize: maxValidatorSetSize, - polybftBackend: polybftBackend, - } - - if err := sm.init(blockchain, dbTx); err != nil { - return nil, err - } - - return sm, nil -} - -// PostBlock is called on every insert of finalized block (either from consensus or syncer) -// It will update the fullValidatorSet in db to the current block number -// Note that EventSubscriber - AddLog will get all the transfer events that happened in block -func (s *stakeManager) PostBlock(req *PostBlockRequest) error { - fullValidatorSet, err := s.getOrInitValidatorSet(req.DBTx) - if err != nil { - return err - } - - blockNumber := req.FullBlock.Block.Number() - - s.logger.Debug("Stake manager on post block", - "block", blockNumber, - "last saved", fullValidatorSet.BlockNumber, - "last updated", fullValidatorSet.UpdatedAtBlockNumber) - - // we should save new state even if number of events is zero - // because otherwise next time we will process more blocks - fullValidatorSet.EpochID = req.Epoch - fullValidatorSet.BlockNumber = blockNumber - - return s.state.StakeStore.insertFullValidatorSet(fullValidatorSet, req.DBTx) -} - -func (s *stakeManager) init(blockchain blockchainBackend, dbTx *bolt.Tx) error { - currentHeader := blockchain.CurrentHeader() - currentBlockNumber := currentHeader.Number - - validatorSet, err := s.getOrInitValidatorSet(dbTx) - if err != nil { - return err - } - - // early return if current block is already processed - if validatorSet.BlockNumber == currentBlockNumber { - return nil - } - - // retrieve epoch needed for state - epochID, err := getEpochID(blockchain, currentHeader) - if err != nil { - return err - } - - s.logger.Debug("Stake manager on post block", - "block", currentBlockNumber, - "last saved", validatorSet.BlockNumber, - "last updated", validatorSet.UpdatedAtBlockNumber) - - // we will use eventsGetter to update the fullValidatorSet if - // for any reason, we don't have the correct state - eventsGetter := &eventsGetter[*contractsapi.TransferEvent]{ - receiptsGetter: receiptsGetter{ - blockchain: blockchain, - }, - isValidLogFn: func(l *types.Log) bool { - return l.Address == s.validatorSetContract - }, - parseEventFn: func(h *types.Header, l *ethgo.Log) (*contractsapi.TransferEvent, bool, error) { - var transferEvent contractsapi.TransferEvent - doesMatch, err := transferEvent.ParseLog(l) - - return &transferEvent, doesMatch, err - }, - } - - transferEvents, err := eventsGetter.getEventsFromBlocksRange(validatorSet.BlockNumber+1, currentBlockNumber) - if err != nil { - return err - } - - if err := s.updateWithReceipts(&validatorSet, transferEvents, currentBlockNumber); err != nil { - return err - } - - // we should save new state even if number of events is zero - // because otherwise next time we will process more blocks - validatorSet.EpochID = epochID - validatorSet.BlockNumber = currentBlockNumber - - return s.state.StakeStore.insertFullValidatorSet(validatorSet, dbTx) -} - -func (s *stakeManager) getOrInitValidatorSet(dbTx *bolt.Tx) (validatorSetState, error) { - validatorSet, err := s.state.StakeStore.getFullValidatorSet(dbTx) - if err != nil { - if !errors.Is(err, errNoFullValidatorSet) { - return validatorSetState{}, err - } - - validators, err := s.polybftBackend.GetValidatorsWithTx(0, nil, dbTx) - if err != nil { - return validatorSetState{}, err - } - - validatorSet = validatorSetState{ - BlockNumber: 0, - EpochID: 0, - UpdatedAtBlockNumber: 0, - Validators: newValidatorStakeMap(validators), - } - - if err = s.state.StakeStore.insertFullValidatorSet(validatorSet, dbTx); err != nil { - return validatorSetState{}, err - } - } - - return validatorSet, nil -} - -func (s *stakeManager) updateWithReceipts( - fullValidatorSet *validatorSetState, - transferEvents []*contractsapi.TransferEvent, - blockNumber uint64) error { - if len(transferEvents) == 0 { - return nil - } - - for _, event := range transferEvents { - if event.IsStake() { - s.logger.Debug("Stake transfer event", "to", event.To, "value", event.Value) - - // then this amount was minted To validator address - fullValidatorSet.Validators.addStake(event.To, event.Value) - } else if event.IsUnstake() { - s.logger.Debug("Unstake transfer event", "from", event.From, "value", event.Value) - - // then this amount was burned From validator address - fullValidatorSet.Validators.removeStake(event.From, event.Value) - } else { - // this should not happen, but lets log it if it does - s.logger.Warn("Found a transfer event that represents neither stake nor unstake") - } - } - - for addr, data := range fullValidatorSet.Validators { - if data.BlsKey == nil { - blsKey, err := s.getBlsKey(data.Address) - if err != nil { - s.logger.Warn("Could not get info for new validator", - "block", blockNumber, "address", addr) - } - - data.BlsKey = blsKey - } - - data.IsActive = data.VotingPower.Cmp(bigZero) > 0 - } - - // mark on which block validator set has been updated - fullValidatorSet.UpdatedAtBlockNumber = blockNumber - - s.logger.Debug("Full validator set after", "block", blockNumber, "data", fullValidatorSet.Validators) - - return nil -} - -// UpdateValidatorSet returns an updated validator set -// based on stake change (transfer) events from ValidatorSet contract -func (s *stakeManager) UpdateValidatorSet( - epoch uint64, oldValidatorSet validator.AccountSet) (*validator.ValidatorSetDelta, error) { - s.logger.Info("Calculating validators set update...", "epoch", epoch) - - fullValidatorSet, err := s.state.StakeStore.getFullValidatorSet(nil) - if err != nil { - return nil, fmt.Errorf("failed to get full validators set. Epoch: %d. Error: %w", epoch, err) - } - - // stake map that holds stakes for all validators - stakeMap := fullValidatorSet.Validators - - // slice of all validator set - newValidatorSet := stakeMap.getSorted(s.maxValidatorSetSize) - // set of all addresses that will be in next validator set - addressesSet := make(map[types.Address]struct{}, len(newValidatorSet)) - - for _, si := range newValidatorSet { - addressesSet[si.Address] = struct{}{} - } - - removedBitmap := bitmap.Bitmap{} - updatedValidators := validator.AccountSet{} - addedValidators := validator.AccountSet{} - oldActiveMap := make(map[types.Address]*validator.ValidatorMetadata) - - for i, validator := range oldValidatorSet { - oldActiveMap[validator.Address] = validator - // remove existing validators from validator set if they did not make it to the set - if _, exists := addressesSet[validator.Address]; !exists { - removedBitmap.Set(uint64(i)) - } - } - - for _, newValidator := range newValidatorSet { - // check if its already in existing validator set - if oldValidator, exists := oldActiveMap[newValidator.Address]; exists { - if oldValidator.VotingPower.Cmp(newValidator.VotingPower) != 0 { - updatedValidators = append(updatedValidators, newValidator) - } - } else { - if newValidator.BlsKey == nil { - newValidator.BlsKey, err = s.getBlsKey(newValidator.Address) - if err != nil { - return nil, fmt.Errorf("could not retrieve validator data. Address: %v. Error: %w", - newValidator.Address, err) - } - } - - addedValidators = append(addedValidators, newValidator) - } - } - - s.logger.Info("Calculating validators set update finished.", "epoch", epoch) - - delta := &validator.ValidatorSetDelta{ - Added: addedValidators, - Updated: updatedValidators, - Removed: removedBitmap, - } - - if s.logger.IsDebug() { - newValidatorSet, err := oldValidatorSet.Copy().ApplyDelta(delta) - if err != nil { - return nil, err - } - - s.logger.Debug("New validator set", "validatorSet", newValidatorSet) - } - - return delta, nil -} - -// getBlsKey returns bls key for validator from the supernet contract -func (s *stakeManager) getBlsKey(address types.Address) (*bls.PublicKey, error) { - getValidatorFn := &contractsapi.GetValidatorCustomSupernetManagerFn{ - Validator_: address, - } - - encoded, err := getValidatorFn.EncodeAbi() - if err != nil { - return nil, err - } - - response, err := s.rootChainRelayer.Call( - s.key.Address(), - ethgo.Address(s.supernetManagerContract), - encoded) - if err != nil { - return nil, fmt.Errorf("failed to invoke validators function on the supernet manager: %w", err) - } - - byteResponse, err := hex.DecodeHex(response) - if err != nil { - return nil, fmt.Errorf("unable to decode hex response, %w", err) - } - - decoded, err := validatorTypeABI.Decode(byteResponse) - if err != nil { - return nil, err - } - - output, ok := decoded.(map[string]interface{}) - if !ok { - return nil, fmt.Errorf("could not convert decoded outputs to map") - } - - blsKey, ok := output["blsKey"].([4]*big.Int) - if !ok { - return nil, fmt.Errorf("failed to decode blskey") - } - - pubKey, err := bls.UnmarshalPublicKeyFromBigInt(blsKey) - if err != nil { - return nil, fmt.Errorf("failed to unmarshal BLS public key: %w", err) - } - - return pubKey, nil -} - -// EventSubscriber implementation - -// GetLogFilters returns a map of log filters for getting desired events, -// where the key is the address of contract that emits desired events, -// and the value is a slice of signatures of events we want to get. -// This function is the implementation of EventSubscriber interface -func (s *stakeManager) GetLogFilters() map[types.Address][]types.Hash { - var transferEvent contractsapi.TransferEvent - - return map[types.Address][]types.Hash{ - s.validatorSetContract: {types.Hash(transferEvent.Sig())}, - } -} - -// ProcessLog is the implementation of EventSubscriber interface, -// used to handle a log defined in GetLogFilters, provided by event provider -func (s *stakeManager) ProcessLog(header *types.Header, log *ethgo.Log, dbTx *bolt.Tx) error { - var transferEvent contractsapi.TransferEvent - - doesMatch, err := transferEvent.ParseLog(log) - if err != nil { - return err - } - - if !doesMatch { - return nil - } - - fullValidatorSet, err := s.getOrInitValidatorSet(dbTx) - if err != nil { - return err - } - - if err := s.updateWithReceipts(&fullValidatorSet, - []*contractsapi.TransferEvent{&transferEvent}, header.Number); err != nil { - return err - } - - return s.state.StakeStore.insertFullValidatorSet(fullValidatorSet, dbTx) -} - -type validatorSetState struct { - BlockNumber uint64 `json:"block"` - EpochID uint64 `json:"epoch"` - UpdatedAtBlockNumber uint64 `json:"updated_at_block"` - Validators validatorStakeMap `json:"validators"` -} - -func (vs validatorSetState) Marshal() ([]byte, error) { - return json.Marshal(vs) -} - -func (vs *validatorSetState) Unmarshal(b []byte) error { - return json.Unmarshal(b, vs) -} - -// validatorStakeMap holds ValidatorMetadata for each validator address -type validatorStakeMap map[types.Address]*validator.ValidatorMetadata - -// newValidatorStakeMap returns a new instance of validatorStakeMap -func newValidatorStakeMap(validatorSet validator.AccountSet) validatorStakeMap { - stakeMap := make(validatorStakeMap, len(validatorSet)) - - for _, v := range validatorSet { - stakeMap[v.Address] = v.Copy() - } - - return stakeMap -} - -// addStake adds given amount to a validator defined by address -func (sc *validatorStakeMap) addStake(address types.Address, amount *big.Int) { - if metadata, exists := (*sc)[address]; exists { - metadata.VotingPower.Add(metadata.VotingPower, amount) - metadata.IsActive = metadata.VotingPower.Cmp(bigZero) > 0 - } else { - (*sc)[address] = &validator.ValidatorMetadata{ - VotingPower: new(big.Int).Set(amount), - Address: address, - IsActive: amount.Cmp(bigZero) > 0, - } - } -} - -// removeStake removes given amount from validator defined by address -func (sc *validatorStakeMap) removeStake(address types.Address, amount *big.Int) { - stakeData := (*sc)[address] - stakeData.VotingPower.Sub(stakeData.VotingPower, amount) - stakeData.IsActive = stakeData.VotingPower.Cmp(bigZero) > 0 -} - -// getSorted returns validators (*ValidatorMetadata) in sorted order -func (sc validatorStakeMap) getSorted(maxValidatorSetSize int) validator.AccountSet { - activeValidators := make(validator.AccountSet, 0, len(sc)) - - for _, v := range sc { - if v.VotingPower.Cmp(bigZero) > 0 { - activeValidators = append(activeValidators, v) - } - } - - sort.Slice(activeValidators, func(i, j int) bool { - v1, v2 := activeValidators[i], activeValidators[j] - - switch v1.VotingPower.Cmp(v2.VotingPower) { - case 1: - return true - case 0: - return bytes.Compare(v1.Address[:], v2.Address[:]) < 0 - default: - return false - } - }) - - if len(activeValidators) <= maxValidatorSetSize { - return activeValidators - } - - return activeValidators[:maxValidatorSetSize] -} - -func (sc validatorStakeMap) String() string { - var sb strings.Builder - - for _, x := range sc.getSorted(len(sc)) { - bls := "" - if x.BlsKey != nil { - bls = hex.EncodeToString(x.BlsKey.Marshal()) - } - - sb.WriteString(fmt.Sprintf("%s:%s:%s:%t\n", - x.Address, x.VotingPower, bls, x.IsActive)) - } - - return sb.String() -} - -func getEpochID(blockchain blockchainBackend, header *types.Header) (uint64, error) { - provider, err := blockchain.GetStateProviderForBlock(header) - if err != nil { - return 0, err - } - - return blockchain.GetSystemState(provider).GetEpoch() -} diff --git a/consensus/polybft/stake_manager_fuzz_test.go b/consensus/polybft/stake_manager_fuzz_test.go deleted file mode 100644 index 0f2e61a..0000000 --- a/consensus/polybft/stake_manager_fuzz_test.go +++ /dev/null @@ -1,248 +0,0 @@ -package polybft - -import ( - "encoding/json" - "errors" - "fmt" - "math/big" - "reflect" - "testing" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/types" -) - -type epochIDValidatorsF struct { - EpochID uint64 - Validators []*validator.ValidatorMetadata -} - -type postBlockStructF struct { - EpochID uint64 - ValidatorID uint64 - BlockID uint64 - StakeValue uint64 -} - -type updateValidatorSetF struct { - EpochID uint64 - Index uint64 - VotingPower int64 -} - -func FuzzTestStakeManagerPostBlock(f *testing.F) { - var ( - allAliases = []string{"A", "B", "C", "D", "E", "F"} - initialSetAliases = []string{"A", "B", "C", "D", "E"} - validators = validator.NewTestValidatorsWithAliases(f, allAliases) - state = newTestState(f) - ) - - seeds := []postBlockStructF{ - { - EpochID: 0, - ValidatorID: 1, - BlockID: 1, - StakeValue: 30, - }, - { - EpochID: 5, - ValidatorID: 30, - BlockID: 4, - StakeValue: 60, - }, - { - EpochID: 1, - ValidatorID: 42, - BlockID: 11, - StakeValue: 70, - }, - { - EpochID: 7, - ValidatorID: 1, - BlockID: 2, - StakeValue: 10, - }, - } - - for _, seed := range seeds { - data, err := json.Marshal(seed) - if err != nil { - return - } - - f.Add(data) - } - - f.Fuzz(func(t *testing.T, input []byte) { - t.Parallel() - - var data postBlockStructF - if err := json.Unmarshal(input, &data); err != nil { - t.Skip(err) - } - - if err := ValidateStruct(data); err != nil { - t.Skip(err) - } - - if data.ValidatorID > uint64(len(initialSetAliases)-1) { - t.Skip() - } - - validatorSetAddr := types.StringToAddress("0x0001") - - bcMock := new(blockchainMock) - for i := 0; i < int(data.BlockID); i++ { - bcMock.On("CurrentHeader").Return(&types.Header{Number: 0}) - bcMock.On("GetHeaderByNumber", mock.Anything).Return(&types.Header{Hash: types.Hash{6, 4}}, true).Once() - bcMock.On("GetReceiptsByHash", mock.Anything).Return([]*types.Receipt{{}}, error(nil)).Once() - } - - // insert initial full validator set - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(validators.GetPublicIdentities(initialSetAliases...)), - }, nil)) - - stakeManager, err := newStakeManager( - hclog.NewNullLogger(), - state, - nil, - wallet.NewEcdsaSigner(validators.GetValidator("A").Key()), - validatorSetAddr, - types.StringToAddress("0x0002"), - bcMock, - nil, - 5, - nil, - ) - require.NoError(t, err) - - header := &types.Header{Number: data.BlockID} - require.NoError(t, stakeManager.ProcessLog(header, convertLog(createTestLogForTransferEvent( - t, - validatorSetAddr, - validators.GetValidator(initialSetAliases[data.ValidatorID]).Address(), - types.ZeroAddress, - data.StakeValue, - )), nil)) - - require.NoError(t, stakeManager.PostBlock(&PostBlockRequest{ - FullBlock: &types.FullBlock{Block: &types.Block{Header: &types.Header{Number: data.BlockID}}}, - Epoch: data.EpochID, - })) - }) -} - -func FuzzTestStakeManagerUpdateValidatorSet(f *testing.F) { - var ( - aliases = []string{"A", "B", "C", "D", "E"} - stakes = []uint64{10, 10, 10, 10, 10} - ) - - validators := validator.NewTestValidatorsWithAliases(f, aliases, stakes) - state := newTestState(f) - - bcMock := new(blockchainMock) - bcMock.On("CurrentHeader").Return(&types.Header{Number: 0}) - - err := state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(validators.GetPublicIdentities())}, nil) - require.NoError(f, err) - - stakeManager, err := newStakeManager( - hclog.NewNullLogger(), - state, - nil, - wallet.NewEcdsaSigner(validators.GetValidator("A").Key()), - types.StringToAddress("0x0001"), types.StringToAddress("0x0002"), - bcMock, - nil, - 10, - nil, - ) - require.NoError(f, err) - - seeds := []updateValidatorSetF{ - { - EpochID: 0, - Index: 1, - VotingPower: 30, - }, - { - EpochID: 1, - Index: 4, - VotingPower: 1, - }, - { - EpochID: 2, - Index: 3, - VotingPower: -2, - }, - } - - for _, seed := range seeds { - data, err := json.Marshal(seed) - if err != nil { - return - } - - f.Add(data) - } - - f.Fuzz(func(t *testing.T, input []byte) { - var data updateValidatorSetF - if err := json.Unmarshal(input, &data); err != nil { - t.Skip(err) - } - - if err := ValidateStruct(data); err != nil { - t.Skip(err) - } - - if data.Index > uint64(len(aliases)-1) { - t.Skip() - } - - err := state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(validators.GetPublicIdentities())}, nil) - require.NoError(t, err) - - _, err = stakeManager.UpdateValidatorSet(data.EpochID, validators.GetPublicIdentities(aliases[data.Index:]...)) - require.NoError(t, err) - - fullValidatorSet := validators.GetPublicIdentities().Copy() - validatorToUpdate := fullValidatorSet[data.Index] - validatorToUpdate.VotingPower = big.NewInt(data.VotingPower) - - _, err = stakeManager.UpdateValidatorSet(data.EpochID, validators.GetPublicIdentities()) - require.NoError(t, err) - }) -} - -func ValidateStruct(s interface{}) (err error) { - structType := reflect.TypeOf(s) - if structType.Kind() != reflect.Struct { - return errors.New("input param should be a struct") - } - - structVal := reflect.ValueOf(s) - fieldNum := structVal.NumField() - - for i := 0; i < fieldNum; i++ { - field := structVal.Field(i) - fieldName := structType.Field(i).Name - - isSet := field.IsValid() && !field.IsZero() - - if !isSet { - err = fmt.Errorf("%w%s is not set; ", err, fieldName) - } - } - - return err -} diff --git a/consensus/polybft/stake_manager_test.go b/consensus/polybft/stake_manager_test.go deleted file mode 100644 index 8b78a6b..0000000 --- a/consensus/polybft/stake_manager_test.go +++ /dev/null @@ -1,580 +0,0 @@ -package polybft - -import ( - "math/big" - "testing" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/ethgo/jsonrpc" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/helper/hex" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -func TestStakeManager_PostBlock(t *testing.T) { - t.Parallel() - - var ( - allAliases = []string{"A", "B", "C", "D", "E", "F"} - initialSetAliases = []string{"A", "B", "C", "D", "E"} - epoch = uint64(1) - block = uint64(10) - newStake = uint64(100) - firstValidator = uint64(0) - secondValidator = uint64(1) - validatorSetAddr = types.StringToAddress("0x0001") - ) - - t.Run("PostBlock - unstake to zero", func(t *testing.T) { - t.Parallel() - - state := newTestState(t) - - bcMock := new(blockchainMock) - bcMock.On("CurrentHeader").Return(&types.Header{Number: block - 1}, true).Once() - - validators := validator.NewTestValidatorsWithAliases(t, allAliases) - - // insert initial full validator set - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(validators.GetPublicIdentities(initialSetAliases...)), - BlockNumber: block - 1, - }, nil)) - - stakeManager, err := newStakeManager( - hclog.NewNullLogger(), - state, - nil, - wallet.NewEcdsaSigner(validators.GetValidator("A").Key()), - validatorSetAddr, types.StringToAddress("0x0002"), - bcMock, - nil, - 5, - nil, - ) - require.NoError(t, err) - - header := &types.Header{Number: block} - - require.NoError(t, stakeManager.ProcessLog(header, convertLog(createTestLogForTransferEvent( - t, - validatorSetAddr, - validators.GetValidator(initialSetAliases[firstValidator]).Address(), - types.ZeroAddress, - 1, // initial validator stake was 1 - )), nil)) - - req := &PostBlockRequest{ - FullBlock: &types.FullBlock{Block: &types.Block{Header: header}}, - Epoch: epoch, - } - - require.NoError(t, stakeManager.PostBlock(req)) - - fullValidatorSet, err := state.StakeStore.getFullValidatorSet(nil) - require.NoError(t, err) - var firstValidatorMeta *validator.ValidatorMetadata - firstValidatorMeta = nil - for _, validator := range fullValidatorSet.Validators { - if validator.Address.String() == validators.GetValidator(initialSetAliases[firstValidator]).Address().String() { - firstValidatorMeta = validator - } - } - require.NotNil(t, firstValidatorMeta) - require.Equal(t, bigZero, firstValidatorMeta.VotingPower) - require.False(t, firstValidatorMeta.IsActive) - }) - t.Run("PostBlock - add stake to one validator", func(t *testing.T) { - t.Parallel() - - state := newTestState(t) - - bcMock := new(blockchainMock) - bcMock.On("CurrentHeader").Return(&types.Header{Number: block - 1}, true).Once() - - validators := validator.NewTestValidatorsWithAliases(t, allAliases) - - // insert initial full validator set - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(validators.GetPublicIdentities(initialSetAliases...)), - BlockNumber: block - 1, - }, nil)) - - stakeManager, err := newStakeManager( - hclog.NewNullLogger(), - state, - nil, - wallet.NewEcdsaSigner(validators.GetValidator("A").Key()), - types.StringToAddress("0x0001"), types.StringToAddress("0x0002"), - bcMock, - nil, - 5, - nil, - ) - require.NoError(t, err) - - header := &types.Header{Number: block} - require.NoError(t, stakeManager.ProcessLog(header, convertLog(createTestLogForTransferEvent( - t, - validatorSetAddr, - types.ZeroAddress, - validators.GetValidator(initialSetAliases[secondValidator]).Address(), - 250, - )), nil)) - - req := &PostBlockRequest{ - FullBlock: &types.FullBlock{Block: &types.Block{Header: header}}, - Epoch: epoch, - } - - require.NoError(t, stakeManager.PostBlock(req)) - - fullValidatorSet, err := state.StakeStore.getFullValidatorSet(nil) - require.NoError(t, err) - var firstValidator *validator.ValidatorMetadata - firstValidator = nil - for _, validator := range fullValidatorSet.Validators { - if validator.Address.String() == validators.GetValidator(initialSetAliases[secondValidator]).Address().String() { - firstValidator = validator - } - } - require.NotNil(t, firstValidator) - require.Equal(t, big.NewInt(251), firstValidator.VotingPower) // 250 + initial 1 - require.True(t, firstValidator.IsActive) - }) - - t.Run("PostBlock - add validator and stake", func(t *testing.T) { - t.Parallel() - - state := newTestState(t) - - validators := validator.NewTestValidatorsWithAliases(t, allAliases, []uint64{1, 2, 3, 4, 5, 6}) - - txRelayerMock := newDummyStakeTxRelayer(t, func() *validator.ValidatorMetadata { - return validators.GetValidator("F").ValidatorMetadata() - }) - - // just mock the call however, the dummy relayer should do its magic - txRelayerMock.On("Call", mock.Anything, mock.Anything, mock.Anything). - Return(nil, error(nil)) - - bcMock := new(blockchainMock) - bcMock.On("CurrentHeader").Return(&types.Header{Number: block - 1}, true).Once() - - // insert initial full validator set - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(validators.GetPublicIdentities(initialSetAliases...)), - BlockNumber: block - 1, - }, nil)) - - stakeManager, err := newStakeManager( - hclog.NewNullLogger(), - state, - txRelayerMock, - wallet.NewEcdsaSigner(validators.GetValidator("A").Key()), - types.StringToAddress("0x0001"), types.StringToAddress("0x0002"), - bcMock, - nil, - 5, - nil, - ) - require.NoError(t, err) - - header := &types.Header{Number: block} - - for i := 0; i < len(allAliases); i++ { - require.NoError(t, stakeManager.ProcessLog(header, convertLog(createTestLogForTransferEvent( - t, - validatorSetAddr, - types.ZeroAddress, - validators.GetValidator(allAliases[i]).Address(), - newStake, - )), nil)) - } - - req := &PostBlockRequest{ - FullBlock: &types.FullBlock{Block: &types.Block{Header: header}}, - Epoch: epoch, - } - - require.NoError(t, stakeManager.PostBlock(req)) - - fullValidatorSet, err := state.StakeStore.getFullValidatorSet(nil) - require.NoError(t, err) - require.Len(t, fullValidatorSet.Validators, len(allAliases)) - - validatorsCount := validators.ToValidatorSet().Len() - for i, v := range fullValidatorSet.Validators.getSorted(validatorsCount) { - require.Equal(t, newStake+uint64(validatorsCount)-uint64(i)-1, v.VotingPower.Uint64()) - } - }) -} - -func TestStakeManager_UpdateValidatorSet(t *testing.T) { - var ( - aliases = []string{"A", "B", "C", "D", "E"} - stakes = []uint64{10, 10, 10, 10, 10} - epoch = uint64(1) - ) - - validators := validator.NewTestValidatorsWithAliases(t, aliases, stakes) - state := newTestState(t) - - bcMock := new(blockchainMock) - bcMock.On("CurrentHeader").Return(&types.Header{Number: 0}, true).Once() - - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(validators.ToValidatorSet().Accounts()), - }, nil)) - - stakeManager, err := newStakeManager( - hclog.NewNullLogger(), - state, - nil, - wallet.NewEcdsaSigner(validators.GetValidator("A").Key()), - types.StringToAddress("0x0001"), types.StringToAddress("0x0002"), - bcMock, - nil, - 10, - nil, - ) - require.NoError(t, err) - - t.Run("UpdateValidatorSet - only update", func(t *testing.T) { - fullValidatorSet := validators.GetPublicIdentities().Copy() - validatorToUpdate := fullValidatorSet[0] - validatorToUpdate.VotingPower = big.NewInt(11) - - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(fullValidatorSet), - }, nil)) - - updateDelta, err := stakeManager.UpdateValidatorSet(epoch, validators.GetPublicIdentities()) - require.NoError(t, err) - require.Len(t, updateDelta.Added, 0) - require.Len(t, updateDelta.Updated, 1) - require.Len(t, updateDelta.Removed, 0) - require.Equal(t, updateDelta.Updated[0].Address, validatorToUpdate.Address) - require.Equal(t, updateDelta.Updated[0].VotingPower.Uint64(), validatorToUpdate.VotingPower.Uint64()) - }) - - t.Run("UpdateValidatorSet - one unstake", func(t *testing.T) { - fullValidatorSet := validators.GetPublicIdentities(aliases[1:]...) - - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(fullValidatorSet), - }, nil)) - - updateDelta, err := stakeManager.UpdateValidatorSet(epoch+1, validators.GetPublicIdentities()) - require.NoError(t, err) - require.Len(t, updateDelta.Added, 0) - require.Len(t, updateDelta.Updated, 0) - require.Len(t, updateDelta.Removed, 1) - }) - - t.Run("UpdateValidatorSet - one new validator", func(t *testing.T) { - addedValidator := validators.GetValidator("A") - - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(validators.GetPublicIdentities()), - }, nil)) - - updateDelta, err := stakeManager.UpdateValidatorSet(epoch+2, - validators.GetPublicIdentities(aliases[1:]...)) - require.NoError(t, err) - require.Len(t, updateDelta.Added, 1) - require.Len(t, updateDelta.Updated, 0) - require.Len(t, updateDelta.Removed, 0) - require.Equal(t, addedValidator.Address(), updateDelta.Added[0].Address) - require.Equal(t, addedValidator.VotingPower, updateDelta.Added[0].VotingPower.Uint64()) - }) - t.Run("UpdateValidatorSet - remove some stake", func(t *testing.T) { - fullValidatorSet := validators.GetPublicIdentities().Copy() - validatorToUpdate := fullValidatorSet[2] - validatorToUpdate.VotingPower = big.NewInt(5) - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(fullValidatorSet), - }, nil)) - - updateDelta, err := stakeManager.UpdateValidatorSet(epoch+3, validators.GetPublicIdentities()) - require.NoError(t, err) - require.Len(t, updateDelta.Added, 0) - require.Len(t, updateDelta.Updated, 1) - require.Len(t, updateDelta.Removed, 0) - require.Equal(t, updateDelta.Updated[0].Address, validatorToUpdate.Address) - require.Equal(t, updateDelta.Updated[0].VotingPower.Uint64(), validatorToUpdate.VotingPower.Uint64()) - }) - t.Run("UpdateValidatorSet - remove entire stake", func(t *testing.T) { - fullValidatorSet := validators.GetPublicIdentities().Copy() - validatorToUpdate := fullValidatorSet[3] - validatorToUpdate.VotingPower = bigZero - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(fullValidatorSet), - }, nil)) - - updateDelta, err := stakeManager.UpdateValidatorSet(epoch+4, validators.GetPublicIdentities()) - require.NoError(t, err) - require.Len(t, updateDelta.Added, 0) - require.Len(t, updateDelta.Updated, 0) - require.Len(t, updateDelta.Removed, 1) - }) - t.Run("UpdateValidatorSet - voting power negative", func(t *testing.T) { - fullValidatorSet := validators.GetPublicIdentities().Copy() - validatorsToUpdate := fullValidatorSet[4] - validatorsToUpdate.VotingPower = bigZero - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(fullValidatorSet), - }, nil)) - - updateDelta, err := stakeManager.UpdateValidatorSet(epoch+5, validators.GetPublicIdentities()) - require.NoError(t, err) - require.Len(t, updateDelta.Added, 0) - require.Len(t, updateDelta.Updated, 0) - require.Len(t, updateDelta.Removed, 1) - }) - - t.Run("UpdateValidatorSet - max validator set size reached", func(t *testing.T) { - // because we now have 5 validators, and the new validator has more stake - stakeManager.maxValidatorSetSize = 4 - - fullValidatorSet := validators.GetPublicIdentities().Copy() - validatorToAdd := fullValidatorSet[0] - validatorToAdd.VotingPower = big.NewInt(11) - - require.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - Validators: newValidatorStakeMap(fullValidatorSet), - }, nil)) - - updateDelta, err := stakeManager.UpdateValidatorSet(epoch+6, - validators.GetPublicIdentities(aliases[1:]...)) - - require.NoError(t, err) - require.Len(t, updateDelta.Added, 1) - require.Len(t, updateDelta.Updated, 0) - require.Len(t, updateDelta.Removed, 1) - require.Equal(t, validatorToAdd.Address, updateDelta.Added[0].Address) - require.Equal(t, validatorToAdd.VotingPower.Uint64(), updateDelta.Added[0].VotingPower.Uint64()) - }) -} - -func TestStakeCounter_ShouldBeDeterministic(t *testing.T) { - t.Parallel() - - const timesToExecute = 100 - - stakes := [][]uint64{ - {103, 102, 101, 51, 50, 30, 10}, - {100, 100, 100, 50, 50, 30, 10}, - {103, 102, 101, 51, 50, 30, 10}, - {100, 100, 100, 50, 50, 30, 10}, - } - maxValidatorSetSizes := []int{1000, 1000, 5, 6} - - for ind, stake := range stakes { - maxValidatorSetSize := maxValidatorSetSizes[ind] - - aliases := []string{"A", "B", "C", "D", "E", "F", "G"} - validators := validator.NewTestValidatorsWithAliases(t, aliases, stake) - - test := func() []*validator.ValidatorMetadata { - stakeCounter := newValidatorStakeMap(validators.GetPublicIdentities("A", "B", "C", "D", "E")) - - return stakeCounter.getSorted(maxValidatorSetSize) - } - - initialSlice := test() - - // stake counter and stake map should always be deterministic - for i := 0; i < timesToExecute; i++ { - currentSlice := test() - - require.Len(t, currentSlice, len(initialSlice)) - - for i, si := range currentSlice { - initialSi := initialSlice[i] - require.Equal(t, si.Address, initialSi.Address) - require.Equal(t, si.VotingPower.Uint64(), initialSi.VotingPower.Uint64()) - } - } - } -} - -func TestStakeManager_UpdateOnInit(t *testing.T) { - t.Parallel() - - var ( - allAliases = []string{"A", "B", "C", "D", "E", "F"} - validatorSetAddr = types.StringToAddress("0xf001") - epochID = uint64(120) - ) - - success := types.ReceiptSuccess - contractProvider := &stateProvider{} - header1Hash := types.StringToHash("0x99aa") - header2Hash := types.StringToHash("0xffee") - header3Hash := types.StringToHash("0xeeff") - header4Hash := types.StringToHash("0xaaff") - currentHeader := &types.Header{Number: 4} - validators := validator.NewTestValidatorsWithAliases(t, allAliases) - accountSet := validators.GetPublicIdentities(allAliases...) - addresses := accountSet.GetAddresses() - state := newTestState(t) - - sysStateMock := &systemStateMock{} - sysStateMock.On("GetEpoch").Return(epochID, nil).Once() - - polyBackendMock := new(polybftBackendMock) - polyBackendMock.On("GetValidatorsWithTx", uint64(0), []*types.Header(nil), mock.Anything).Return(accountSet, nil).Once() - - bcMock := new(blockchainMock) - bcMock.On("GetStateProviderForBlock", currentHeader).Return(contractProvider, nil).Once() - bcMock.On("GetSystemState", contractProvider).Return(sysStateMock, nil).Once() - bcMock.On("CurrentHeader", mock.Anything).Return(currentHeader, true).Once() - bcMock.On("GetHeaderByNumber", uint64(1)).Return(&types.Header{Number: 1, Hash: header1Hash}, true).Once() - bcMock.On("GetHeaderByNumber", uint64(2)).Return(&types.Header{Number: 2, Hash: header2Hash}, true).Once() - bcMock.On("GetHeaderByNumber", uint64(3)).Return(&types.Header{Number: 3, Hash: header3Hash}, true).Once() - bcMock.On("GetHeaderByNumber", uint64(4)).Return(&types.Header{Number: 4, Hash: header4Hash}, true).Once() - bcMock.On("GetReceiptsByHash", header1Hash).Return([]*types.Receipt(nil), nil).Once() - bcMock.On("GetReceiptsByHash", header2Hash).Return([]*types.Receipt{ - { - Status: &success, - Logs: []*types.Log{ - createTestLogForTransferEvent( - t, - validatorSetAddr, - types.ZeroAddress, - addresses[len(addresses)-2], - 4, - ), - }, - }, - }, nil).Once() - bcMock.On("GetReceiptsByHash", header3Hash).Return([]*types.Receipt{ - { - Status: &success, - Logs: []*types.Log{ - createTestLogForTransferEvent( - t, - validatorSetAddr, - types.ZeroAddress, - addresses[len(addresses)-1], - 6, - ), - }, - }, - }, nil).Once() - bcMock.On("GetReceiptsByHash", header4Hash).Return([]*types.Receipt{{}}, nil).Once() - - _, err := newStakeManager( - hclog.NewNullLogger(), - state, - nil, - wallet.NewEcdsaSigner(validators.GetValidator("A").Key()), - validatorSetAddr, types.StringToAddress("0x0002"), - bcMock, - polyBackendMock, - 5, - nil, - ) - require.NoError(t, err) - - bcMock.AssertExpectations(t) - sysStateMock.AssertExpectations(t) - - fullValidatorSet, err := state.StakeStore.getFullValidatorSet(nil) - require.NoError(t, err) - - require.Equal(t, uint64(4), fullValidatorSet.BlockNumber) - require.Equal(t, uint64(4), fullValidatorSet.UpdatedAtBlockNumber) - require.Equal(t, epochID, fullValidatorSet.EpochID) - - for _, x := range fullValidatorSet.Validators { - if x.Address == addresses[len(addresses)-1] { - require.Equal(t, new(big.Int).SetUint64(7), x.VotingPower) - } else if x.Address == addresses[len(addresses)-2] { - require.Equal(t, new(big.Int).SetUint64(5), x.VotingPower) - } else { - require.Equal(t, new(big.Int).SetUint64(1), x.VotingPower) - } - } -} - -func createTestLogForTransferEvent(t *testing.T, validatorSet, from, to types.Address, stake uint64) *types.Log { - t.Helper() - - var transferEvent contractsapi.TransferEvent - - topics := make([]types.Hash, 3) - topics[0] = types.Hash(transferEvent.Sig()) - topics[1] = types.BytesToHash(from.Bytes()) - topics[2] = types.BytesToHash(to.Bytes()) - encodedData, err := abi.MustNewType("uint256").Encode(new(big.Int).SetUint64(stake)) - require.NoError(t, err) - - return &types.Log{ - Address: validatorSet, - Topics: topics, - Data: encodedData, - } -} - -var _ txrelayer.TxRelayer = (*dummyStakeTxRelayer)(nil) - -type dummyStakeTxRelayer struct { - mock.Mock - callback func() *validator.ValidatorMetadata - t *testing.T -} - -func newDummyStakeTxRelayer(t *testing.T, callback func() *validator.ValidatorMetadata) *dummyStakeTxRelayer { - t.Helper() - - return &dummyStakeTxRelayer{ - t: t, - callback: callback, - } -} - -func (d *dummyStakeTxRelayer) Call(from ethgo.Address, to ethgo.Address, input []byte) (string, error) { - args := d.Called(from, to, input) - - if d.callback != nil { - validatorMetaData := d.callback() - encoded, err := validatorTypeABI.Encode(map[string]interface{}{ - "blsKey": validatorMetaData.BlsKey.ToBigInt(), - "stake": validatorMetaData.VotingPower, - "isWhitelisted": true, - "isActive": true, - }) - - require.NoError(d.t, err) - - return hex.EncodeToHex(encoded), nil - } - - return args.String(0), args.Error(1) -} - -func (d *dummyStakeTxRelayer) SendTransaction(transaction *ethgo.Transaction, key ethgo.Key) (*ethgo.Receipt, error) { - args := d.Called(transaction, key) - - return args.Get(0).(*ethgo.Receipt), args.Error(1) //nolint:forcetypeassert -} - -// SendTransactionLocal sends non-signed transaction (this is only for testing purposes) -func (d *dummyStakeTxRelayer) SendTransactionLocal(txn *ethgo.Transaction) (*ethgo.Receipt, error) { - args := d.Called(txn) - - return args.Get(0).(*ethgo.Receipt), args.Error(1) //nolint:forcetypeassert -} - -func (d *dummyStakeTxRelayer) Client() *jsonrpc.Client { - return nil -} diff --git a/consensus/polybft/state.go b/consensus/polybft/state.go deleted file mode 100644 index d78d091..0000000 --- a/consensus/polybft/state.go +++ /dev/null @@ -1,184 +0,0 @@ -package polybft - -import ( - "fmt" - - "github.com/hashicorp/go-hclog" - "github.com/xgr-network/xgr-node/helper/common" - bolt "go.etcd.io/bbolt" -) - -var ( - edgeEventsLastProcessedBlockBucket = []byte("EdgeEventsLastProcessedBlock") - edgeEventsLastProcessedBlockKey = []byte("EdgeEventsLastProcessedBlockKey") -) - -// MessageSignature encapsulates sender identifier and its signature -type MessageSignature struct { - // Signer of the vote - From string - // Signature of the message - Signature []byte -} - -// TransportMessage represents the payload which is gossiped across the network -type TransportMessage struct { - // Hash is encoded data - Hash []byte - // Message signature - Signature []byte - // From is the address of the message signer - From string - // Number of epoch - EpochNumber uint64 -} - -// State represents a persistence layer which persists consensus data off-chain -type State struct { - db *bolt.DB - close chan struct{} - - StateSyncStore *StateSyncStore - CheckpointStore *CheckpointStore - EpochStore *EpochStore - ProposerSnapshotStore *ProposerSnapshotStore - StakeStore *StakeStore -} - -// newState creates new instance of State -func newState(path string, logger hclog.Logger, closeCh chan struct{}) (*State, error) { - db, err := bolt.Open(path, 0666, nil) - if err != nil { - return nil, err - } - - s := &State{ - db: db, - close: closeCh, - StateSyncStore: &StateSyncStore{db: db}, - CheckpointStore: &CheckpointStore{db: db}, - EpochStore: &EpochStore{db: db}, - ProposerSnapshotStore: &ProposerSnapshotStore{db: db}, - StakeStore: &StakeStore{db: db}, - } - - if err = s.initStorages(); err != nil { - return nil, err - } - - return s, nil -} - -// initStorages initializes data storages -func (s *State) initStorages() error { - // init the buckets - return s.db.Update(func(tx *bolt.Tx) error { - if err := s.StateSyncStore.initialize(tx); err != nil { - return err - } - if err := s.CheckpointStore.initialize(tx); err != nil { - return err - } - if err := s.EpochStore.initialize(tx); err != nil { - return err - } - if err := s.ProposerSnapshotStore.initialize(tx); err != nil { - return err - } - if err := s.StakeStore.initialize(tx); err != nil { - return err - } - - _, err := tx.CreateBucketIfNotExists(edgeEventsLastProcessedBlockBucket) - if err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(edgeEventsLastProcessedBlockBucket), err) - } - - lastProcessedBlock, err := s.getLastProcessedEventsBlock(tx) - if err != nil { - return fmt.Errorf("failed to get last processed block: %w", err) - } - - if lastProcessedBlock == 0 { - // we do this for already existing chains, which just updated their Edge binary, - // to not get events from scratch, but start from what other stores have - lastSaved, err := s.CheckpointStore.getLastSaved(tx) - if err != nil { - return fmt.Errorf("could not initialize last processed block bucket: %w", err) - } - - if lastSaved > 0 { - return s.insertLastProcessedEventsBlock(lastSaved, tx) - } - } - - return nil - }) -} - -// insertLastProcessedEventsBlock inserts the last processed block for events on Edge -func (s *State) insertLastProcessedEventsBlock(block uint64, dbTx *bolt.Tx) error { - insertFn := func(tx *bolt.Tx) error { - return tx.Bucket(edgeEventsLastProcessedBlockBucket).Put( - edgeEventsLastProcessedBlockKey, common.EncodeUint64ToBytes(block)) - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return insertFn(tx) - }) - } - - return insertFn(dbTx) -} - -// getLastProcessedEventsBlock gets the last processed block for events on Edge -func (s *State) getLastProcessedEventsBlock(dbTx *bolt.Tx) (uint64, error) { - var ( - lastProcessed uint64 - err error - ) - - getFn := func(tx *bolt.Tx) { - value := tx.Bucket(edgeEventsLastProcessedBlockBucket).Get(edgeEventsLastProcessedBlockKey) - if value != nil { - lastProcessed = common.EncodeBytesToUint64(value) - } - } - - if dbTx == nil { - err = s.db.View(func(tx *bolt.Tx) error { - getFn(tx) - - return nil - }) - } else { - getFn(dbTx) - } - - return lastProcessed, err -} - -// beginDBTransaction creates and begins a transaction on BoltDB -// Note that transaction needs to be manually rollback or committed -func (s *State) beginDBTransaction(isWriteTx bool) (*bolt.Tx, error) { - return s.db.Begin(isWriteTx) -} - -// bucketStats returns stats for the given bucket in db -func bucketStats(bucketName []byte, db *bolt.DB) (*bolt.BucketStats, error) { - var stats *bolt.BucketStats - - err := db.View(func(tx *bolt.Tx) error { - s := tx.Bucket(bucketName).Stats() - stats = &s - - return nil - }) - - if err != nil { - return nil, fmt.Errorf("cannot check bucket stats. Bucket name=%s: %w", string(bucketName), err) - } - - return stats, nil -} diff --git a/consensus/polybft/state_event_getter.go b/consensus/polybft/state_event_getter.go deleted file mode 100644 index 2f223ff..0000000 --- a/consensus/polybft/state_event_getter.go +++ /dev/null @@ -1,256 +0,0 @@ -package polybft - -import ( - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/blockchain" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" -) - -// EventSubscriber specifies functions needed for a component to subscribe to eventProvider -type EventSubscriber interface { - // GetLogFilters returns a map of log filters for getting desired events, - // where the key is the address of contract that emits desired events, - // and the value is a slice of signatures of events we want to get. - GetLogFilters() map[types.Address][]types.Hash - - // ProcessLog is used to handle a log defined in GetLogFilters, provided by event provider - ProcessLog(header *types.Header, log *ethgo.Log, dbTx *bolt.Tx) error -} - -// EventProvider represents an event provider in a blockchain system -// that returns desired events to subscribers from finalized blocks -// Note that this provider needs to be called manually on each block finalization. -// The EventProvider struct has the following fields: -// - blockchain: A blockchainBackend type that represents the blockchain backend used by the event provider. -// - subscribers: A map[string]eventSubscriber that stores the subscribers of the event provider. -// - allFilters: A map[types.Address]map[types.Hash][]string that stores the filters for event logs. -type EventProvider struct { - receiptsGetter - - subscriberIDCounter uint64 - - blockchain blockchainBackend - - subscribers map[uint64]EventSubscriber - allFilters map[types.Address]map[types.Hash][]uint64 -} - -// NewEventProvider returns a new instance of eventProvider -func NewEventProvider(blockchain blockchainBackend) *EventProvider { - return &EventProvider{ - receiptsGetter: receiptsGetter{ - blockchain: blockchain, - }, - subscribers: make(map[uint64]EventSubscriber, 0), - allFilters: make(map[types.Address]map[types.Hash][]uint64, 0), - } -} - -// Subscribe subscribes given EventSubscriber to desired logs (events) -func (e *EventProvider) Subscribe(subscriber EventSubscriber) { - e.subscriberIDCounter++ - subscriberID := e.subscriberIDCounter - e.subscribers[subscriberID] = subscriber - - for address, filters := range subscriber.GetLogFilters() { - existingAddressFilters, exist := e.allFilters[address] - if !exist { - existingAddressFilters = make(map[types.Hash][]uint64, 0) - e.allFilters[address] = existingAddressFilters - } - - for _, f := range filters { - existingAddressFilters[f] = append(existingAddressFilters[f], subscriberID) - } - } -} - -// GetEventsFromBlocks gets all desired logs (events) for each subscriber in given block range -// -// Inputs: -// - lastProcessedBlock - last finalized block that was processed for desired events -// - latestBlock - latest finalized block -// - dbTx - database transaction under which events are gathered -// -// Returns: -// - nil - if getting events finished successfully -// - error - if a block or its receipts could not be retrieved from blockchain -func (e *EventProvider) GetEventsFromBlocks(lastProcessedBlock uint64, - latestBlock *types.FullBlock, - dbTx *bolt.Tx) error { - if err := e.getEventsFromBlocksRange(lastProcessedBlock+1, latestBlock.Block.Number()-1, dbTx); err != nil { - return err - } - - return e.getEventsFromReceipts(latestBlock.Block.Header, latestBlock.Receipts, dbTx) -} - -// getEventsFromBlocksRange gets all desired logs (events) for each subscriber in given block range -// -// Inputs: -// - from - block from which log (event) retrieval should start -// - to - last block from which log (event) retrieval should be done -// - dbTx - database transaction under which events are gathered -// -// Returns: -// - nil - if getting events finished successfully -// - error - if a block or its receipts could not be retrieved from blockchain -func (e *EventProvider) getEventsFromBlocksRange(from, to uint64, dbTx *bolt.Tx) error { - receiptsHandler := func(header *types.Header, receipts []*types.Receipt) error { - return e.getEventsFromReceipts(header, receipts, dbTx) - } - - return e.receiptsGetter.getReceiptsFromBlocksRange(from, to, receiptsHandler) -} - -// getEventsFromReceipts gets all desired logs (events) for each subscriber from given block receipts -// -// Inputs: -// - blockHeader - header of block from whose receipts the function will retrieve logs (events) -// - receipts - given block receipts from which the function will retrieve logs (events) -// - dbTx - database transaction under which events are gathered -// -// Returns: -// - nil - if getting events finished successfully -// - error - if a subscriber for a certain log (event) returns an error on log (event) handling -func (e *EventProvider) getEventsFromReceipts(blockHeader *types.Header, - receipts []*types.Receipt, - dbTx *bolt.Tx) error { - for _, receipt := range receipts { - if receipt.Status == nil || *receipt.Status != types.ReceiptSuccess { - continue - } - - for _, log := range receipt.Logs { - logFilters, isRelevantLog := e.allFilters[log.Address] - if !isRelevantLog { - continue - } - - for logFilter, subscribers := range logFilters { - if log.Topics[0] == logFilter { - convertedLog := convertLog(log) - for _, subscriber := range subscribers { - if err := e.subscribers[subscriber].ProcessLog(blockHeader, convertedLog, dbTx); err != nil { - return err - } - } - } - } - } - } - - return nil -} - -// eventsGetter is a struct for getting missed and current events -// of specified type from specified blocks -type eventsGetter[T contractsapi.EventAbi] struct { - receiptsGetter - // parseEventFn is a plugin function used to parse the event from transaction log - parseEventFn func(*types.Header, *ethgo.Log) (T, bool, error) - // isValidLogFn is a plugin function that validates the log - // for example: if it was sent from the desired address - isValidLogFn func(*types.Log) bool -} - -// getFromBlocks gets events of specified type from specified blocks -// and saves them using the provided saveEventsFn -func (e *eventsGetter[T]) getFromBlocks(lastProcessedBlock uint64, - currentBlock *types.FullBlock) ([]T, error) { - allEvents, err := e.getEventsFromBlocksRange(lastProcessedBlock+1, currentBlock.Block.Number()-1) - if err != nil { - return nil, err - } - - currentEvents, err := e.getEventsFromReceipts(currentBlock.Block.Header, currentBlock.Receipts) - if err != nil { - return nil, err - } - - allEvents = append(allEvents, currentEvents...) - - return allEvents, nil -} - -// getEventsFromBlocksRange gets events of specified type from all the blocks specified [from, to] -func (e *eventsGetter[T]) getEventsFromBlocksRange(from, to uint64) ([]T, error) { - var allEvents []T - - receiptsHandler := func(header *types.Header, receipts []*types.Receipt) error { - events, err := e.getEventsFromReceipts(header, receipts) - if err != nil { - return err - } - - allEvents = append(allEvents, events...) - - return nil - } - - if err := e.receiptsGetter.getReceiptsFromBlocksRange(from, to, receiptsHandler); err != nil { - return nil, err - } - - return allEvents, nil -} - -// getEventsFromReceipts returns events of specified type from block transaction receipts -func (e *eventsGetter[T]) getEventsFromReceipts(blockHeader *types.Header, - receipts []*types.Receipt) ([]T, error) { - var events []T - - for _, receipt := range receipts { - if receipt.Status == nil || *receipt.Status != types.ReceiptSuccess { - continue - } - - for _, log := range receipt.Logs { - if e.isValidLogFn != nil && !e.isValidLogFn(log) { - continue - } - - event, doesMatch, err := e.parseEventFn(blockHeader, convertLog(log)) - if err != nil { - return nil, err - } - - if !doesMatch { - continue - } - - events = append(events, event) - } - } - - return events, nil -} - -type receiptsGetter struct { - // blockchain is an abstraction of blockchain that provides necessary functions - // for querying blockchain data (blocks, receipts, etc.) - blockchain blockchainBackend -} - -func (r *receiptsGetter) getReceiptsFromBlocksRange(from, to uint64, - receiptsHandler func(*types.Header, []*types.Receipt) error) error { - for i := from; i <= to; i++ { - blockHeader, found := r.blockchain.GetHeaderByNumber(i) - if !found { - return blockchain.ErrNoBlock - } - - receipts, err := r.blockchain.GetReceiptsByHash(blockHeader.Hash) - if err != nil { - return err - } - - if err := receiptsHandler(blockHeader, receipts); err != nil { - return err - } - } - - return nil -} diff --git a/consensus/polybft/state_event_getter_test.go b/consensus/polybft/state_event_getter_test.go deleted file mode 100644 index ad0505d..0000000 --- a/consensus/polybft/state_event_getter_test.go +++ /dev/null @@ -1,50 +0,0 @@ -package polybft - -import ( - "testing" - - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/types" -) - -func TestEventDBInsertRetry_GetEvents(t *testing.T) { - receipt := &types.Receipt{ - Logs: []*types.Log{ - createTestLogForTransferEvent(t, contracts.ValidatorSetContract, types.ZeroAddress, types.ZeroAddress, 10), - }, - } - receipt.SetStatus(types.ReceiptSuccess) - - backend := new(blockchainMock) - backend.On("GetHeaderByNumber", mock.Anything).Return(&types.Header{ - Hash: types.BytesToHash([]byte{0, 1, 2, 3}), - }, true) - backend.On("GetReceiptsByHash", mock.Anything).Return([]*types.Receipt{receipt}, nil) - - retryManager := &eventsGetter[*contractsapi.TransferEvent]{ - receiptsGetter: receiptsGetter{ - blockchain: backend, - }, - isValidLogFn: func(l *types.Log) bool { - return l.Address == contracts.ValidatorSetContract - }, - parseEventFn: func(h *types.Header, l *ethgo.Log) (*contractsapi.TransferEvent, bool, error) { - var e contractsapi.TransferEvent - doesMatch, err := e.ParseLog(l) - - return &e, doesMatch, err - }, - } - - events, err := retryManager.getFromBlocks(0, &types.FullBlock{ - Block: &types.Block{Header: &types.Header{Number: 2}}, - Receipts: []*types.Receipt{}, - }) - - require.NoError(t, err) - require.Len(t, events, 1) -} diff --git a/consensus/polybft/state_store_checkpoint.go b/consensus/polybft/state_store_checkpoint.go deleted file mode 100644 index 964e00e..0000000 --- a/consensus/polybft/state_store_checkpoint.go +++ /dev/null @@ -1,245 +0,0 @@ -package polybft - -import ( - "bytes" - "encoding/json" - "errors" - "fmt" - "sort" - - "github.com/umbracle/ethgo" - bolt "go.etcd.io/bbolt" - - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/types" -) - -var ( - // bucket to store exit contract events - exitEventsBucket = []byte("exitEvent") - exitEventToEpochLookupBucket = []byte("exitIdToEpochLookup") - exitEventLastProcessedBlockBucket = []byte("lastProcessedBlock") - - lastProcessedBlockKey = []byte("lastProcessedBlock") - errNoLastSavedEntry = errors.New("there is no last saved block in last saved bucket") -) - -type exitEventNotFoundError struct { - exitID uint64 - epoch uint64 -} - -func (e *exitEventNotFoundError) Error() string { - return fmt.Sprintf("could not find any exit event that has an id: %v and epoch: %v", e.exitID, e.epoch) -} - -// ExitEvent is an event emitted by Exit contract -type ExitEvent struct { - *contractsapi.L2StateSyncedEvent - // EpochNumber is the epoch number in which exit event was added - EpochNumber uint64 `abi:"-"` - // BlockNumber is the block in which exit event was added - BlockNumber uint64 `abi:"-"` -} - -/* -Bolt DB schema: - -exit events/ -|--> (id+epoch+blockNumber) -> *ExitEvent (json marshalled) -|--> (exitEventID) -> epochNumber -|--> (lastProcessedBlockKey) -> block number -*/ -type CheckpointStore struct { - db *bolt.DB -} - -// initialize creates necessary buckets in DB if they don't already exist -func (s *CheckpointStore) initialize(tx *bolt.Tx) error { - if _, err := tx.CreateBucketIfNotExists(exitEventsBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(exitEventsBucket), err) - } - - if _, err := tx.CreateBucketIfNotExists(exitEventToEpochLookupBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(exitEventToEpochLookupBucket), err) - } - - if _, err := tx.CreateBucketIfNotExists(exitEventLastProcessedBlockBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(exitEventLastProcessedBlockBucket), err) - } - - return tx.Bucket(exitEventLastProcessedBlockBucket).Put(lastProcessedBlockKey, common.EncodeUint64ToBytes(0)) -} - -// insertExitEventWithTx inserts an exit event to db -func (s *CheckpointStore) insertExitEvent(exitEvent *ExitEvent, dbTx *bolt.Tx) error { - insertFn := func(tx *bolt.Tx) error { - raw, err := json.Marshal(exitEvent) - if err != nil { - return err - } - - epochBytes := common.EncodeUint64ToBytes(exitEvent.EpochNumber) - exitIDBytes := common.EncodeUint64ToBytes(exitEvent.ID.Uint64()) - - err = tx.Bucket(exitEventsBucket).Put(bytes.Join([][]byte{epochBytes, - exitIDBytes, common.EncodeUint64ToBytes(exitEvent.BlockNumber)}, nil), raw) - if err != nil { - return err - } - - return tx.Bucket(exitEventToEpochLookupBucket).Put(exitIDBytes, epochBytes) - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return insertFn(tx) - }) - } - - return insertFn(dbTx) -} - -// getExitEvent returns exit event with given id, which happened in given epoch and given block number -func (s *CheckpointStore) getExitEvent(exitEventID uint64) (*ExitEvent, error) { - var exitEvent *ExitEvent - - err := s.db.View(func(tx *bolt.Tx) error { - exitEventBucket := tx.Bucket(exitEventsBucket) - lookupBucket := tx.Bucket(exitEventToEpochLookupBucket) - - exitIDBytes := common.EncodeUint64ToBytes(exitEventID) - - epochBytes := lookupBucket.Get(exitIDBytes) - if epochBytes == nil { - return fmt.Errorf("could not find any exit event that has an id: %v. Its epoch was not found in lookup table", - exitEventID) - } - - key := bytes.Join([][]byte{epochBytes, exitIDBytes}, nil) - k, v := exitEventBucket.Cursor().Seek(key) - - if bytes.HasPrefix(k, key) == false || v == nil { - return &exitEventNotFoundError{ - exitID: exitEventID, - epoch: common.EncodeBytesToUint64(epochBytes), - } - } - - return json.Unmarshal(v, &exitEvent) - }) - - return exitEvent, err -} - -// getExitEventsByEpoch returns all exit events that happened in the given epoch -func (s *CheckpointStore) getExitEventsByEpoch(epoch uint64) ([]*ExitEvent, error) { - return s.getExitEvents(epoch, func(exitEvent *ExitEvent) bool { - return exitEvent.EpochNumber == epoch - }) -} - -// getExitEventsForProof returns all exit events that happened in and prior to the given checkpoint block number -// with respect to the epoch in which block is added -func (s *CheckpointStore) getExitEventsForProof(epoch, checkpointBlock uint64) ([]*ExitEvent, error) { - return s.getExitEvents(epoch, func(exitEvent *ExitEvent) bool { - return exitEvent.EpochNumber == epoch && exitEvent.BlockNumber <= checkpointBlock - }) -} - -// getExitEvents returns exit events for given epoch and provided filter -func (s *CheckpointStore) getExitEvents(epoch uint64, filter func(exitEvent *ExitEvent) bool) ([]*ExitEvent, error) { - var events []*ExitEvent - - err := s.db.View(func(tx *bolt.Tx) error { - c := tx.Bucket(exitEventsBucket).Cursor() - prefix := common.EncodeUint64ToBytes(epoch) - - for k, v := c.Seek(prefix); bytes.HasPrefix(k, prefix); k, v = c.Next() { - var event *ExitEvent - if err := json.Unmarshal(v, &event); err != nil { - return err - } - - if filter(event) { - events = append(events, event) - } - } - - return nil - }) - - // enforce sequential order - sort.Slice(events, func(i, j int) bool { - return events[i].ID.Cmp(events[j].ID) < 0 - }) - - return events, err -} - -// updateLastSaved saves the last block processed for exit events -func (s *CheckpointStore) getLastSaved(dbTx *bolt.Tx) (uint64, error) { - var ( - lastSavedBlock uint64 - err error - ) - - getFn := func(tx *bolt.Tx) error { - v := tx.Bucket(exitEventLastProcessedBlockBucket).Get(lastProcessedBlockKey) - if v == nil { - return errNoLastSavedEntry - } - - lastSavedBlock = common.EncodeBytesToUint64(v) - - return nil - } - - if dbTx == nil { - err = s.db.View(func(tx *bolt.Tx) error { - return getFn(tx) - }) - } else { - err = getFn(dbTx) - } - - return lastSavedBlock, err -} - -// decodeExitEvent tries to decode exit event from the provided log -func decodeExitEvent(log *ethgo.Log, epoch, block uint64) (*ExitEvent, error) { - var l2StateSyncedEvent contractsapi.L2StateSyncedEvent - - doesMatch, err := l2StateSyncedEvent.ParseLog(log) - if err != nil { - return nil, err - } - - if !doesMatch { - return nil, nil - } - - return &ExitEvent{ - L2StateSyncedEvent: &l2StateSyncedEvent, - EpochNumber: epoch, - BlockNumber: block, - }, nil -} - -// convertLog converts types.Log to ethgo.Log -func convertLog(log *types.Log) *ethgo.Log { - l := ðgo.Log{ - Address: ethgo.Address(log.Address), - Data: make([]byte, len(log.Data)), - Topics: make([]ethgo.Hash, len(log.Topics)), - } - - copy(l.Data, log.Data) - - for i, topic := range log.Topics { - l.Topics[i] = ethgo.Hash(topic) - } - - return l -} diff --git a/consensus/polybft/state_store_checkpoint_test.go b/consensus/polybft/state_store_checkpoint_test.go deleted file mode 100644 index 5edbf82..0000000 --- a/consensus/polybft/state_store_checkpoint_test.go +++ /dev/null @@ -1,206 +0,0 @@ -package polybft - -import ( - "math/big" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" -) - -func TestState_Insert_And_Get_ExitEvents_PerEpoch(t *testing.T) { - const ( - numOfEpochs = 11 - numOfBlocksPerEpoch = 10 - numOfEventsPerBlock = 11 - ) - - state := newTestState(t) - insertTestExitEvents(t, state, numOfEpochs, numOfBlocksPerEpoch, numOfEventsPerBlock) - - t.Run("Get events for existing epoch", func(t *testing.T) { - events, err := state.CheckpointStore.getExitEventsByEpoch(1) - - assert.NoError(t, err) - assert.Len(t, events, numOfBlocksPerEpoch*numOfEventsPerBlock) - }) - - t.Run("Get events for non-existing epoch", func(t *testing.T) { - events, err := state.CheckpointStore.getExitEventsByEpoch(12) - - assert.NoError(t, err) - assert.Len(t, events, 0) - }) -} - -func TestState_Insert_And_Get_ExitEvents_ForProof(t *testing.T) { - const ( - numOfEpochs = 11 - numOfBlocksPerEpoch = 10 - numOfEventsPerBlock = 10 - ) - - state := newTestState(t) - insertTestExitEvents(t, state, numOfEpochs, numOfBlocksPerEpoch, numOfEventsPerBlock) - - var cases = []struct { - epoch uint64 - checkpointBlockNumber uint64 - expectedNumberOfEvents int - }{ - {1, 1, 10}, - {1, 2, 20}, - {1, 8, 80}, - {2, 12, 20}, - {2, 14, 40}, - {3, 26, 60}, - {4, 38, 80}, - {11, 105, 50}, - } - - for _, c := range cases { - events, err := state.CheckpointStore.getExitEventsForProof(c.epoch, c.checkpointBlockNumber) - - assert.NoError(t, err) - assert.Len(t, events, c.expectedNumberOfEvents) - } -} - -func TestState_Insert_And_Get_ExitEvents_ForProof_NoEvents(t *testing.T) { - t.Parallel() - - state := newTestState(t) - insertTestExitEvents(t, state, 1, 10, 1) - - events, err := state.CheckpointStore.getExitEventsForProof(2, 11) - - assert.NoError(t, err) - assert.Nil(t, events) -} - -func TestState_NoEpochForExitEventInLookup(t *testing.T) { - t.Parallel() - - const ( - exitToTest = uint64(11) - epochToMatch = uint64(2) - blockNumberToMatch = uint64(12) - ) - - state := newTestState(t) - insertTestExitEvents(t, state, 3, 10, 1) - - exitEventFromDB, err := state.CheckpointStore.getExitEvent(exitToTest) - require.NoError(t, err) - require.Equal(t, exitToTest, exitEventFromDB.ID.Uint64()) - require.Equal(t, epochToMatch, exitEventFromDB.EpochNumber) - require.Equal(t, blockNumberToMatch, exitEventFromDB.BlockNumber) - - // simulate invalid case (for some reason lookup table doesn't have epoch for given exit) - err = state.db.Update(func(tx *bolt.Tx) error { - return tx.Bucket(exitEventToEpochLookupBucket).Delete(common.EncodeUint64ToBytes(exitEventFromDB.ID.Uint64())) - }) - - require.NoError(t, err) - - _, err = state.CheckpointStore.getExitEvent(exitToTest) - require.ErrorContains(t, err, "epoch was not found in lookup table") -} - -func TestState_decodeExitEvent(t *testing.T) { - t.Parallel() - - const ( - exitID = 1 - epoch = 1 - blockNumber = 10 - ) - - state := newTestState(t) - - var exitEvent contractsapi.L2StateSyncedEvent - - topics := make([]ethgo.Hash, 4) - topics[0] = exitEvent.Sig() - topics[1] = ethgo.BytesToHash([]byte{exitID}) - topics[2] = ethgo.BytesToHash(ethgo.HexToAddress("0x1111").Bytes()) - topics[3] = ethgo.BytesToHash(ethgo.HexToAddress("0x2222").Bytes()) - personType := abi.MustNewType("tuple(string firstName, string lastName)") - encodedData, err := personType.Encode(map[string]string{"firstName": "John", "lastName": "Doe"}) - require.NoError(t, err) - - log := ðgo.Log{ - Address: ethgo.ZeroAddress, - Topics: topics, - Data: encodedData, - } - - event, err := decodeExitEvent(log, epoch, blockNumber) - require.NoError(t, err) - require.Equal(t, uint64(exitID), event.ID.Uint64()) - require.Equal(t, uint64(epoch), event.EpochNumber) - require.Equal(t, uint64(blockNumber), event.BlockNumber) - - require.NoError(t, state.CheckpointStore.insertExitEvent(event, nil)) -} - -func TestState_decodeExitEvent_NotAnExitEvent(t *testing.T) { - t.Parallel() - - var stateSyncedEvent contractsapi.StateSyncedEvent - - topics := make([]ethgo.Hash, 4) - topics[0] = stateSyncedEvent.Sig() - - log := ðgo.Log{ - Address: ethgo.ZeroAddress, - Topics: topics, - } - - event, err := decodeExitEvent(log, 1, 1) - require.NoError(t, err) - require.Nil(t, event) -} - -func insertTestExitEvents(t *testing.T, state *State, - numOfEpochs, numOfBlocksPerEpoch, numOfEventsPerBlock int) []*ExitEvent { - t.Helper() - - var ( - index = uint64(0) - block = uint64(1) - exitEvents = make([]*ExitEvent, numOfEpochs*numOfBlocksPerEpoch*numOfEventsPerBlock) - ) - - for i := uint64(1); i <= uint64(numOfEpochs); i++ { - for j := 1; j <= numOfBlocksPerEpoch; j++ { - for k := 1; k <= numOfEventsPerBlock; k++ { - exitEvents[index] = - &ExitEvent{ - L2StateSyncedEvent: &contractsapi.L2StateSyncedEvent{ - ID: new(big.Int).SetUint64(index), - Sender: types.ZeroAddress, - Receiver: types.ZeroAddress, - Data: generateRandomBytes(t), - }, - EpochNumber: i, - BlockNumber: block, - } - index++ - } - block++ - } - } - - for _, ee := range exitEvents { - require.NoError(t, state.CheckpointStore.insertExitEvent(ee, nil)) - } - - return exitEvents -} diff --git a/consensus/polybft/state_store_epoch.go b/consensus/polybft/state_store_epoch.go deleted file mode 100644 index 416890b..0000000 --- a/consensus/polybft/state_store_epoch.go +++ /dev/null @@ -1,289 +0,0 @@ -package polybft - -import ( - "encoding/json" - "fmt" - - "github.com/xgr-network/xgr-node/helper/common" - bolt "go.etcd.io/bbolt" -) - -const ( - // validatorSnapshotLimit defines a maximum number of validator snapshots - // that can be stored in cache (both memory and db) - validatorSnapshotLimit = 100 - // numberOfSnapshotsToLeaveInMemory defines a number of validator snapshots to leave in memory - numberOfSnapshotsToLeaveInMemory = 12 - // numberOfSnapshotsToLeaveInDB defines a number of validator snapshots to leave in db - numberOfSnapshotsToLeaveInDB = 20 -) - -var ( - // bucket to store epochs and all its nested buckets (message votes and message pool events) - epochsBucket = []byte("epochs") - - // bucket to store validator snapshots - validatorSnapshotsBucket = []byte("validatorSnapshots") -) - -/* -Bolt DB schema: - -epochs/ -|--> epochNumber - |--> hash -> []*MessageSignatures (json marshalled) - -epochs/ -|--> epochNumber -> []*TransferEvent (json marshalled) - -validatorSnapshots/ -|--> epochNumber -> *AccountSet (json marshalled) -*/ - -type EpochStore struct { - db *bolt.DB -} - -// initialize creates necessary buckets in DB if they don't already exist -func (s *EpochStore) initialize(tx *bolt.Tx) error { - if _, err := tx.CreateBucketIfNotExists(epochsBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(epochsBucket), err) - } - - if _, err := tx.CreateBucketIfNotExists(validatorSnapshotsBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(validatorSnapshotsBucket), err) - } - - return nil -} - -// insertValidatorSnapshot inserts a validator snapshot for the given block to its bucket in db -func (s *EpochStore) insertValidatorSnapshot(validatorSnapshot *validatorSnapshot, dbTx *bolt.Tx) error { - insertFn := func(tx *bolt.Tx) error { - raw, err := json.Marshal(validatorSnapshot) - if err != nil { - return err - } - - return tx.Bucket(validatorSnapshotsBucket).Put(common.EncodeUint64ToBytes(validatorSnapshot.Epoch), raw) - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return insertFn(tx) - }) - } - - return insertFn(dbTx) -} - -// getValidatorSnapshot queries the validator snapshot for given block from db -func (s *EpochStore) getValidatorSnapshot(epoch uint64) (*validatorSnapshot, error) { - var validatorSnapshot *validatorSnapshot - - err := s.db.View(func(tx *bolt.Tx) error { - v := tx.Bucket(validatorSnapshotsBucket).Get(common.EncodeUint64ToBytes(epoch)) - if v != nil { - return json.Unmarshal(v, &validatorSnapshot) - } - - return nil - }) - - return validatorSnapshot, err -} - -// getLastSnapshot returns the last snapshot saved in db -// since they are stored by epoch number (uint64), they are sequentially stored, -// so the latest epoch will be the last snapshot in db -func (s *EpochStore) getLastSnapshot(dbTx *bolt.Tx) (*validatorSnapshot, error) { - var ( - snapshot *validatorSnapshot - err error - ) - - getFn := func(tx *bolt.Tx) error { - c := tx.Bucket(validatorSnapshotsBucket).Cursor() - k, v := c.Last() - - if k == nil { - // we have no snapshots in db - return nil - } - - return json.Unmarshal(v, &snapshot) - } - - if dbTx == nil { - err = s.db.View(func(tx *bolt.Tx) error { - return getFn(tx) - }) - } else { - err = getFn(dbTx) - } - - return snapshot, err -} - -// insertEpoch inserts a new epoch to db with its meta data -func (s *EpochStore) insertEpoch(epoch uint64, dbTx *bolt.Tx) error { - insertFn := func(tx *bolt.Tx) error { - epochBucket, err := tx.Bucket(epochsBucket).CreateBucketIfNotExists(common.EncodeUint64ToBytes(epoch)) - if err != nil { - return err - } - - _, err = epochBucket.CreateBucketIfNotExists(messageVotesBucket) - if err != nil { - return err - } - - return err - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return insertFn(tx) - }) - } - - return insertFn(dbTx) -} - -// isEpochInserted checks if given epoch is present in db -func (s *EpochStore) isEpochInserted(epoch uint64) bool { - return s.db.View(func(tx *bolt.Tx) error { - _, err := getEpochBucket(tx, epoch) - - return err - }) == nil -} - -// getEpochBucket returns bucket from db associated with given epoch -func getEpochBucket(tx *bolt.Tx, epoch uint64) (*bolt.Bucket, error) { - epochBucket := tx.Bucket(epochsBucket).Bucket(common.EncodeUint64ToBytes(epoch)) - if epochBucket == nil { - return nil, fmt.Errorf("could not find bucket for epoch: %v", epoch) - } - - return epochBucket, nil -} - -// cleanEpochsFromDB cleans epoch buckets from db -func (s *EpochStore) cleanEpochsFromDB(dbTx *bolt.Tx) error { - cleanFn := func(tx *bolt.Tx) error { - if err := tx.DeleteBucket(epochsBucket); err != nil { - return err - } - - _, err := tx.CreateBucket(epochsBucket) - - return err - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return cleanFn(tx) - }) - } - - return cleanFn(dbTx) -} - -// cleanValidatorSnapshotsFromDB cleans the validator snapshots bucket if a limit is reached, -// but it leaves the latest (n) number of snapshots -func (s *EpochStore) cleanValidatorSnapshotsFromDB(epoch uint64, dbTx *bolt.Tx) error { - cleanFn := func(tx *bolt.Tx) error { - bucket := tx.Bucket(validatorSnapshotsBucket) - - // paired list - keys := make([][]byte, 0) - values := make([][]byte, 0) - - for i := 0; i < numberOfSnapshotsToLeaveInDB; i++ { // exclude the last inserted we already appended - key := common.EncodeUint64ToBytes(epoch) - value := bucket.Get(key) - - if value == nil { - continue - } - - keys = append(keys, key) - values = append(values, value) - epoch-- - } - - // removing an entire bucket is much faster than removing all keys - // look at thread https://github.com/boltdb/bolt/issues/667 - err := tx.DeleteBucket(validatorSnapshotsBucket) - if err != nil { - return err - } - - bucket, err = tx.CreateBucket(validatorSnapshotsBucket) - if err != nil { - return err - } - - // we start the loop in reverse so that the oldest of snapshots get inserted first in db - for i := len(keys) - 1; i >= 0; i-- { - if err := bucket.Put(keys[i], values[i]); err != nil { - return err - } - } - - return nil - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return cleanFn(tx) - }) - } - - return cleanFn(dbTx) -} - -// removeAllValidatorSnapshots drops a validator snapshot bucket and re-creates it in bolt database -func (s *EpochStore) removeAllValidatorSnapshots() error { - return s.db.Update(func(tx *bolt.Tx) error { - // removing an entire bucket is much faster than removing all keys - // look at thread https://github.com/boltdb/bolt/issues/667 - err := tx.DeleteBucket(validatorSnapshotsBucket) - if err != nil { - return err - } - - _, err = tx.CreateBucket(validatorSnapshotsBucket) - if err != nil { - return err - } - - return nil - }) -} - -// epochsDBStats returns stats of epochs bucket in db -func (s *EpochStore) epochsDBStats() (*bolt.BucketStats, error) { - return bucketStats(epochsBucket, s.db) -} - -// validatorSnapshotsDBStats returns stats of validators snapshot bucket in db -func (s *EpochStore) validatorSnapshotsDBStats() (*bolt.BucketStats, error) { - return bucketStats(validatorSnapshotsBucket, s.db) -} - -// getNestedBucketInEpoch returns a nested (child) bucket from db associated with given epoch -func getNestedBucketInEpoch(tx *bolt.Tx, epoch uint64, bucketKey []byte) (*bolt.Bucket, error) { - epochBucket, err := getEpochBucket(tx, epoch) - if err != nil { - return nil, err - } - - bucket := epochBucket.Bucket(bucketKey) - if bucket == nil { - return nil, fmt.Errorf("could not find %v bucket for epoch: %v", string(bucketKey), epoch) - } - - return bucket, nil -} diff --git a/consensus/polybft/state_store_epoch_test.go b/consensus/polybft/state_store_epoch_test.go deleted file mode 100644 index 7ad8206..0000000 --- a/consensus/polybft/state_store_epoch_test.go +++ /dev/null @@ -1,219 +0,0 @@ -package polybft - -import ( - "fmt" - "sync" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/types" -) - -func TestState_insertAndGetValidatorSnapshot(t *testing.T) { - t.Parallel() - - const ( - epoch = uint64(1) - epochEndingBlock = uint64(100) - ) - - state := newTestState(t) - keys, err := bls.CreateRandomBlsKeys(3) - - require.NoError(t, err) - - snapshot := validator.AccountSet{ - &validator.ValidatorMetadata{Address: types.BytesToAddress([]byte{0x18}), BlsKey: keys[0].PublicKey()}, - &validator.ValidatorMetadata{Address: types.BytesToAddress([]byte{0x23}), BlsKey: keys[1].PublicKey()}, - &validator.ValidatorMetadata{Address: types.BytesToAddress([]byte{0x37}), BlsKey: keys[2].PublicKey()}, - } - - assert.NoError(t, state.EpochStore.insertValidatorSnapshot( - &validatorSnapshot{epoch, epochEndingBlock, snapshot}, nil)) - - snapshotFromDB, err := state.EpochStore.getValidatorSnapshot(epoch) - - assert.NoError(t, err) - assert.Equal(t, snapshot.Len(), snapshotFromDB.Snapshot.Len()) - assert.Equal(t, epoch, snapshotFromDB.Epoch) - assert.Equal(t, epochEndingBlock, snapshotFromDB.EpochEndingBlock) - - for i, v := range snapshot { - assert.Equal(t, v.Address, snapshotFromDB.Snapshot[i].Address) - assert.Equal(t, v.BlsKey, snapshotFromDB.Snapshot[i].BlsKey) - } -} - -func TestState_cleanValidatorSnapshotsFromDb(t *testing.T) { - t.Parallel() - - fixedEpochSize := uint64(10) - state := newTestState(t) - keys, err := bls.CreateRandomBlsKeys(3) - require.NoError(t, err) - - snapshot := validator.AccountSet{ - &validator.ValidatorMetadata{Address: types.BytesToAddress([]byte{0x18}), BlsKey: keys[0].PublicKey()}, - &validator.ValidatorMetadata{Address: types.BytesToAddress([]byte{0x23}), BlsKey: keys[1].PublicKey()}, - &validator.ValidatorMetadata{Address: types.BytesToAddress([]byte{0x37}), BlsKey: keys[2].PublicKey()}, - } - - var epoch uint64 - // add a couple of more snapshots above limit just to make sure we reached it - for i := 1; i <= validatorSnapshotLimit+2; i++ { - epoch = uint64(i) - assert.NoError(t, state.EpochStore.insertValidatorSnapshot( - &validatorSnapshot{epoch, epoch * fixedEpochSize, snapshot}, nil)) - } - - snapshotFromDB, err := state.EpochStore.getValidatorSnapshot(epoch) - - assert.NoError(t, err) - assert.Equal(t, snapshot.Len(), snapshotFromDB.Snapshot.Len()) - assert.Equal(t, epoch, snapshotFromDB.Epoch) - assert.Equal(t, epoch*fixedEpochSize, snapshotFromDB.EpochEndingBlock) - - for i, v := range snapshot { - assert.Equal(t, v.Address, snapshotFromDB.Snapshot[i].Address) - assert.Equal(t, v.BlsKey, snapshotFromDB.Snapshot[i].BlsKey) - } - - assert.NoError(t, state.EpochStore.cleanValidatorSnapshotsFromDB(epoch, nil)) - - // test that last (numberOfSnapshotsToLeaveInDb) of snapshots are left in db after cleanup - validatorSnapshotsBucketStats, err := state.EpochStore.validatorSnapshotsDBStats() - require.NoError(t, err) - - assert.Equal(t, numberOfSnapshotsToLeaveInDB, validatorSnapshotsBucketStats.KeyN) - - for i := 0; i < numberOfSnapshotsToLeaveInDB; i++ { - snapshotFromDB, err = state.EpochStore.getValidatorSnapshot(epoch) - assert.NoError(t, err) - assert.NotNil(t, snapshotFromDB) - epoch-- - } -} - -func TestState_InsertVoteConcurrent(t *testing.T) { - t.Parallel() - - state := newTestState(t) - epoch := uint64(1) - assert.NoError(t, state.EpochStore.insertEpoch(epoch, nil)) - - hash := []byte{1, 2} - - var wg sync.WaitGroup - - for i := 0; i < 100; i++ { - wg.Add(1) - - go func(i int) { - defer wg.Done() - - _, _ = state.StateSyncStore.insertMessageVote(epoch, hash, &MessageSignature{ - From: fmt.Sprintf("NODE_%d", i), - Signature: []byte{1, 2}, - }, nil) - }(i) - } - - wg.Wait() - - signatures, err := state.StateSyncStore.getMessageVotes(epoch, hash) - assert.NoError(t, err) - assert.Len(t, signatures, 100) -} - -func TestState_Insert_And_Cleanup(t *testing.T) { - t.Parallel() - - state := newTestState(t) - hash1 := []byte{1, 2} - - for i := uint64(1); i <= 500; i++ { - epoch := i - err := state.EpochStore.insertEpoch(epoch, nil) - - assert.NoError(t, err) - - _, _ = state.StateSyncStore.insertMessageVote(epoch, hash1, &MessageSignature{ - From: "NODE_1", - Signature: []byte{1, 2}, - }, nil) - } - - stats, err := state.EpochStore.epochsDBStats() - require.NoError(t, err) - - // BucketN returns number of all buckets inside root bucket (including nested buckets) + the root itself - // Since we inserted 500 epochs we expect to have 1000 buckets inside epochs root bucket - // (500 buckets for epochs + each epoch has 1 nested bucket for message votes) - assert.Equal(t, 1000, stats.BucketN-1) - - assert.NoError(t, state.EpochStore.cleanEpochsFromDB(nil)) - - stats, err = state.EpochStore.epochsDBStats() - require.NoError(t, err) - - assert.Equal(t, 0, stats.BucketN-1) - - // there should be no votes for given epoch since we cleaned the db - votes, _ := state.StateSyncStore.getMessageVotes(1, hash1) - assert.Nil(t, votes) - - for i := uint64(501); i <= 1000; i++ { - epoch := i - err := state.EpochStore.insertEpoch(epoch, nil) - assert.NoError(t, err) - - _, _ = state.StateSyncStore.insertMessageVote(epoch, hash1, &MessageSignature{ - From: "NODE_1", - Signature: []byte{1, 2}, - }, nil) - } - - stats, err = state.EpochStore.epochsDBStats() - require.NoError(t, err) - - assert.Equal(t, 1000, stats.BucketN-1) - - votes, _ = state.StateSyncStore.getMessageVotes(1000, hash1) - assert.Equal(t, 1, len(votes)) -} - -func TestState_getLastSnapshot(t *testing.T) { - t.Parallel() - - const ( - lastEpoch = uint64(10) - fixedEpochSize = uint64(10) - numberOfValidators = 3 - ) - - state := newTestState(t) - - for i := uint64(1); i <= lastEpoch; i++ { - keys, err := bls.CreateRandomBlsKeys(numberOfValidators) - - require.NoError(t, err) - - var snapshot validator.AccountSet - for j := 0; j < numberOfValidators; j++ { - snapshot = append(snapshot, &validator.ValidatorMetadata{Address: types.BytesToAddress(generateRandomBytes(t)), BlsKey: keys[j].PublicKey()}) - } - - require.NoError(t, state.EpochStore.insertValidatorSnapshot( - &validatorSnapshot{i, i * fixedEpochSize, snapshot}, nil)) - } - - snapshotFromDB, err := state.EpochStore.getLastSnapshot(nil) - - assert.NoError(t, err) - assert.Equal(t, numberOfValidators, snapshotFromDB.Snapshot.Len()) - assert.Equal(t, lastEpoch, snapshotFromDB.Epoch) - assert.Equal(t, lastEpoch*fixedEpochSize, snapshotFromDB.EpochEndingBlock) -} diff --git a/consensus/polybft/state_store_proposer_snapshot.go b/consensus/polybft/state_store_proposer_snapshot.go deleted file mode 100644 index abcae84..0000000 --- a/consensus/polybft/state_store_proposer_snapshot.go +++ /dev/null @@ -1,82 +0,0 @@ -package polybft - -import ( - "encoding/json" - "fmt" - - bolt "go.etcd.io/bbolt" -) - -/* -Bolt DB schema: - -proposer snapshot/ -|--> proposerSnapshotKey - only current one snapshot is preserved -> *ProposerSnapshot (json marshalled) -*/ -var ( - // bucket to store proposer calculator snapshot - proposerSnapshotBucket = []byte("proposerSnapshot") - // proposerSnapshotKey is a static key which is used to save latest proposer snapshot. - // (there will always be one object in bucket) - proposerSnapshotKey = []byte("proposerSnapshotKey") -) - -type ProposerSnapshotStore struct { - db *bolt.DB -} - -// initialize creates necessary buckets in DB if they don't already exist -func (s *ProposerSnapshotStore) initialize(tx *bolt.Tx) error { - if _, err := tx.CreateBucketIfNotExists(proposerSnapshotBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(validatorSnapshotsBucket), err) - } - - return nil -} - -// getProposerSnapshot gets latest proposer snapshot -func (s *ProposerSnapshotStore) getProposerSnapshot(dbTx *bolt.Tx) (*ProposerSnapshot, error) { - var ( - snapshot *ProposerSnapshot - err error - ) - - getFn := func(tx *bolt.Tx) error { - value := tx.Bucket(proposerSnapshotBucket).Get(proposerSnapshotKey) - if value == nil { - return nil - } - - return json.Unmarshal(value, &snapshot) - } - - if dbTx == nil { - err = s.db.View(func(tx *bolt.Tx) error { - return getFn(tx) - }) - } else { - err = getFn(dbTx) - } - - return snapshot, err -} - -// writeProposerSnapshot writes proposer snapshot -func (s *ProposerSnapshotStore) writeProposerSnapshot(snapshot *ProposerSnapshot, dbTx *bolt.Tx) error { - insertFn := func(tx *bolt.Tx) error { - raw, err := json.Marshal(snapshot) - if err != nil { - return err - } - - return tx.Bucket(proposerSnapshotBucket).Put(proposerSnapshotKey, raw) - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return insertFn(tx) - }) - } - - return insertFn(dbTx) -} diff --git a/consensus/polybft/state_store_proposer_snapshot_test.go b/consensus/polybft/state_store_proposer_snapshot_test.go deleted file mode 100644 index e8657f2..0000000 --- a/consensus/polybft/state_store_proposer_snapshot_test.go +++ /dev/null @@ -1,29 +0,0 @@ -package polybft - -import ( - "testing" - - "github.com/stretchr/testify/require" -) - -func TestState_getProposerSnapshot_writeProposerSnapshot(t *testing.T) { - t.Parallel() - - const ( - height = uint64(100) - round = uint64(5) - ) - - state := newTestState(t) - - snap, err := state.ProposerSnapshotStore.getProposerSnapshot(nil) - require.NoError(t, err) - require.Nil(t, snap) - - newSnapshot := &ProposerSnapshot{Height: height, Round: round} - require.NoError(t, state.ProposerSnapshotStore.writeProposerSnapshot(newSnapshot, nil)) - - snap, err = state.ProposerSnapshotStore.getProposerSnapshot(nil) - require.NoError(t, err) - require.Equal(t, newSnapshot, snap) -} diff --git a/consensus/polybft/state_store_stake.go b/consensus/polybft/state_store_stake.go deleted file mode 100644 index 1734b63..0000000 --- a/consensus/polybft/state_store_stake.go +++ /dev/null @@ -1,81 +0,0 @@ -package polybft - -import ( - "errors" - "fmt" - - bolt "go.etcd.io/bbolt" -) - -var ( - // bucket to store full validator set - validatorSetBucket = []byte("fullValidatorSetBucket") - // key of the full validator set in bucket - fullValidatorSetKey = []byte("fullValidatorSet") - // error returned if full validator set does not exists in db - errNoFullValidatorSet = errors.New("full validator set not in db") -) - -type StakeStore struct { - db *bolt.DB -} - -// initialize creates necessary buckets in DB if they don't already exist -func (s *StakeStore) initialize(tx *bolt.Tx) error { - if _, err := tx.CreateBucketIfNotExists(validatorSetBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(epochsBucket), err) - } - - return nil -} - -// insertFullValidatorSet inserts full validator set to its bucket (or updates it if exists) -// If the passed tx is already open (not nil), it will use it to insert full validator set -// If the passed tx is not open (it is nil), it will open a new transaction on db and insert full validator set -func (s *StakeStore) insertFullValidatorSet(fullValidatorSet validatorSetState, dbTx *bolt.Tx) error { - insertFn := func(tx *bolt.Tx) error { - raw, err := fullValidatorSet.Marshal() - if err != nil { - return err - } - - return tx.Bucket(validatorSetBucket).Put(fullValidatorSetKey, raw) - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return insertFn(tx) - }) - } - - return insertFn(dbTx) -} - -// getFullValidatorSet returns full validator set from its bucket if exists -// If the passed tx is already open (not nil), it will use it to get full validator set -// If the passed tx is not open (it is nil), it will open a new transaction on db and get full validator set -func (s *StakeStore) getFullValidatorSet(dbTx *bolt.Tx) (validatorSetState, error) { - var ( - fullValidatorSet validatorSetState - err error - ) - - getFn := func(tx *bolt.Tx) error { - raw := tx.Bucket(validatorSetBucket).Get(fullValidatorSetKey) - if raw == nil { - return errNoFullValidatorSet - } - - return fullValidatorSet.Unmarshal(raw) - } - - if dbTx == nil { - err = s.db.View(func(tx *bolt.Tx) error { - return getFn(tx) - }) - } else { - err = getFn(dbTx) - } - - return fullValidatorSet, err -} diff --git a/consensus/polybft/state_store_stake_test.go b/consensus/polybft/state_store_stake_test.go deleted file mode 100644 index c3fd813..0000000 --- a/consensus/polybft/state_store_stake_test.go +++ /dev/null @@ -1,51 +0,0 @@ -package polybft - -import ( - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" -) - -func TestState_Insert_And_Get_FullValidatorSet(t *testing.T) { - state := newTestState(t) - - t.Run("No full validator set", func(t *testing.T) { - _, err := state.StakeStore.getFullValidatorSet(nil) - - require.ErrorIs(t, err, errNoFullValidatorSet) - }) - - t.Run("Insert validator set", func(t *testing.T) { - validators := validator.NewTestValidators(t, 5).GetPublicIdentities() - - assert.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - BlockNumber: 100, - EpochID: 10, - Validators: newValidatorStakeMap(validators), - }, nil)) - - fullValidatorSet, err := state.StakeStore.getFullValidatorSet(nil) - require.NoError(t, err) - assert.Equal(t, uint64(100), fullValidatorSet.BlockNumber) - assert.Equal(t, uint64(10), fullValidatorSet.EpochID) - assert.Len(t, fullValidatorSet.Validators, len(validators)) - }) - - t.Run("Update validator set", func(t *testing.T) { - validators := validator.NewTestValidators(t, 10).GetPublicIdentities() - - assert.NoError(t, state.StakeStore.insertFullValidatorSet(validatorSetState{ - BlockNumber: 40, - EpochID: 4, - Validators: newValidatorStakeMap(validators), - }, nil)) - - fullValidatorSet, err := state.StakeStore.getFullValidatorSet(nil) - require.NoError(t, err) - assert.Len(t, fullValidatorSet.Validators, len(validators)) - assert.Equal(t, uint64(40), fullValidatorSet.BlockNumber) - assert.Equal(t, uint64(4), fullValidatorSet.EpochID) - }) -} diff --git a/consensus/polybft/state_store_state_sync.go b/consensus/polybft/state_store_state_sync.go deleted file mode 100644 index d6b0422..0000000 --- a/consensus/polybft/state_store_state_sync.go +++ /dev/null @@ -1,442 +0,0 @@ -package polybft - -import ( - "encoding/json" - "errors" - "fmt" - - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/helper/common" - bolt "go.etcd.io/bbolt" -) - -var ( - // bucket to store rootchain bridge events - stateSyncEventsBucket = []byte("stateSyncEvents") - // bucket to store commitments - commitmentsBucket = []byte("commitments") - // bucket to store state sync proofs - stateSyncProofsBucket = []byte("stateSyncProofs") - // bucket to store message votes (signatures) - messageVotesBucket = []byte("votes") - // bucket to store all state sync relayer events - stateSyncRelayerEventsBucket = []byte("relayerEvents") - - // errNotEnoughStateSyncs error message - errNotEnoughStateSyncs = errors.New("there is either a gap or not enough sync events") - // errCommitmentNotBuilt error message - errCommitmentNotBuilt = errors.New("there is no built commitment to register") - // errNoCommitmentForStateSync error message - errNoCommitmentForStateSync = errors.New("no commitment found for given state sync event") -) - -/* -Bolt DB schema: - -state sync events/ -|--> stateSyncEvent.Id -> *StateSyncEvent (json marshalled) - -commitments/ -|--> commitment.Message.ToIndex -> *CommitmentMessageSigned (json marshalled) - -stateSyncProofs/ -|--> stateSyncProof.StateSync.Id -> *StateSyncProof (json marshalled) - -relayerEvents/ -|--> StateSyncRelayerEventData.EventID -> *StateSyncRelayerEventData (json marshalled) -*/ - -type StateSyncStore struct { - db *bolt.DB -} - -// initialize creates necessary buckets in DB if they don't already exist -func (s *StateSyncStore) initialize(tx *bolt.Tx) error { - if _, err := tx.CreateBucketIfNotExists(stateSyncEventsBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(stateSyncEventsBucket), err) - } - - if _, err := tx.CreateBucketIfNotExists(commitmentsBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(commitmentsBucket), err) - } - - if _, err := tx.CreateBucketIfNotExists(stateSyncProofsBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(stateSyncProofsBucket), err) - } - - if _, err := tx.CreateBucketIfNotExists(stateSyncRelayerEventsBucket); err != nil { - return fmt.Errorf("failed to create bucket=%s: %w", string(stateSyncRelayerEventsBucket), err) - } - - return nil -} - -// insertStateSyncEvent inserts a new state sync event to state event bucket in db -func (s *StateSyncStore) insertStateSyncEvent(event *contractsapi.StateSyncedEvent) error { - return s.db.Update(func(tx *bolt.Tx) error { - raw, err := json.Marshal(event) - if err != nil { - return err - } - - bucket := tx.Bucket(stateSyncEventsBucket) - - return bucket.Put(common.EncodeUint64ToBytes(event.ID.Uint64()), raw) - }) -} - -// removeStateSyncEventsAndProofs removes state sync events and their proofs from the buckets in db -func (s *StateSyncStore) removeStateSyncEventsAndProofs(stateSyncEventIDs []uint64) error { - return s.db.Update(func(tx *bolt.Tx) error { - eventsBucket := tx.Bucket(stateSyncEventsBucket) - proofsBucket := tx.Bucket(stateSyncProofsBucket) - - for _, stateSyncEventID := range stateSyncEventIDs { - stateSyncEventIDKey := common.EncodeUint64ToBytes(stateSyncEventID) - - if err := eventsBucket.Delete(stateSyncEventIDKey); err != nil { - return fmt.Errorf("failed to remove state sync event (ID=%d): %w", stateSyncEventID, err) - } - - if err := proofsBucket.Delete(stateSyncEventIDKey); err != nil { - return fmt.Errorf("failed to remove state sync event proof (ID=%d): %w", stateSyncEventID, err) - } - } - - return nil - }) -} - -// list iterates through all events in events bucket in db, un-marshals them, and returns as array -func (s *StateSyncStore) list() ([]*contractsapi.StateSyncedEvent, error) { - events := []*contractsapi.StateSyncedEvent{} - - err := s.db.View(func(tx *bolt.Tx) error { - return tx.Bucket(stateSyncEventsBucket).ForEach(func(k, v []byte) error { - var event *contractsapi.StateSyncedEvent - if err := json.Unmarshal(v, &event); err != nil { - return err - } - events = append(events, event) - - return nil - }) - }) - if err != nil { - return nil, err - } - - return events, nil -} - -// getStateSyncEventsForCommitment returns state sync events for commitment -func (s *StateSyncStore) getStateSyncEventsForCommitment( - fromIndex, toIndex uint64, dbTx *bolt.Tx) ([]*contractsapi.StateSyncedEvent, error) { - var ( - events []*contractsapi.StateSyncedEvent - err error - ) - - getFn := func(tx *bolt.Tx) error { - bucket := tx.Bucket(stateSyncEventsBucket) - for i := fromIndex; i <= toIndex; i++ { - v := bucket.Get(common.EncodeUint64ToBytes(i)) - if v == nil { - return errNotEnoughStateSyncs - } - - var event *contractsapi.StateSyncedEvent - if err := json.Unmarshal(v, &event); err != nil { - return err - } - - events = append(events, event) - } - - return nil - } - - if dbTx == nil { - err = s.db.View(func(tx *bolt.Tx) error { - return getFn(tx) - }) - } else { - err = getFn(dbTx) - } - - return events, err -} - -// getCommitmentForStateSync returns the commitment that contains given state sync event if it exists -func (s *StateSyncStore) getCommitmentForStateSync(stateSyncID uint64) (*CommitmentMessageSigned, error) { - var commitment *CommitmentMessageSigned - - err := s.db.View(func(tx *bolt.Tx) error { - c := tx.Bucket(commitmentsBucket).Cursor() - - k, v := c.Seek(common.EncodeUint64ToBytes(stateSyncID)) - if k == nil { - return errNoCommitmentForStateSync - } - - if err := json.Unmarshal(v, &commitment); err != nil { - return err - } - - if !commitment.ContainsStateSync(stateSyncID) { - return errNoCommitmentForStateSync - } - - return nil - }) - - return commitment, err -} - -// insertCommitmentMessage inserts signed commitment to db -func (s *StateSyncStore) insertCommitmentMessage(commitment *CommitmentMessageSigned, - dbTx *bolt.Tx) error { - insertFn := func(tx *bolt.Tx) error { - raw, err := json.Marshal(commitment) - if err != nil { - return err - } - - if err := tx.Bucket(commitmentsBucket).Put( - common.EncodeUint64ToBytes(commitment.Message.EndID.Uint64()), raw); err != nil { - return err - } - - return nil - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return insertFn(tx) - }) - } - - return insertFn(dbTx) -} - -// getCommitmentMessage queries the signed commitment from the db -func (s *StateSyncStore) getCommitmentMessage(toIndex uint64) (*CommitmentMessageSigned, error) { - var commitment *CommitmentMessageSigned - - err := s.db.View(func(tx *bolt.Tx) error { - raw := tx.Bucket(commitmentsBucket).Get(common.EncodeUint64ToBytes(toIndex)) - if raw == nil { - return nil - } - - return json.Unmarshal(raw, &commitment) - }) - - return commitment, err -} - -// insertMessageVote inserts given vote to signatures bucket of given epoch -func (s *StateSyncStore) insertMessageVote(epoch uint64, key []byte, - vote *MessageSignature, dbTx *bolt.Tx) (int, error) { - var ( - numOfSignatures int - err error - ) - - insertFn := func(tx *bolt.Tx) error { - signatures, err := s.getMessageVotesLocked(tx, epoch, key) - if err != nil { - return err - } - - // check if the signature has already being included - for _, sigs := range signatures { - if sigs.From == vote.From { - return nil - } - } - - if signatures == nil { - signatures = []*MessageSignature{vote} - } else { - signatures = append(signatures, vote) - } - - raw, err := json.Marshal(signatures) - if err != nil { - return err - } - - bucket, err := getNestedBucketInEpoch(tx, epoch, messageVotesBucket) - if err != nil { - return err - } - - numOfSignatures = len(signatures) - - return bucket.Put(key, raw) - } - - if dbTx == nil { - err = s.db.Update(func(tx *bolt.Tx) error { - return insertFn(tx) - }) - } else { - err = insertFn(dbTx) - } - - return numOfSignatures, err -} - -// getMessageVotes gets all signatures from db associated with given epoch and hash -func (s *StateSyncStore) getMessageVotes(epoch uint64, hash []byte) ([]*MessageSignature, error) { - var signatures []*MessageSignature - - err := s.db.View(func(tx *bolt.Tx) error { - res, err := s.getMessageVotesLocked(tx, epoch, hash) - if err != nil { - return err - } - signatures = res - - return nil - }) - - if err != nil { - return nil, err - } - - return signatures, nil -} - -// getMessageVotesLocked gets all signatures from db associated with given epoch and hash -func (s *StateSyncStore) getMessageVotesLocked(tx *bolt.Tx, epoch uint64, - hash []byte) ([]*MessageSignature, error) { - bucket, err := getNestedBucketInEpoch(tx, epoch, messageVotesBucket) - if err != nil { - return nil, err - } - - v := bucket.Get(hash) - if v == nil { - return nil, nil - } - - var signatures []*MessageSignature - if err := json.Unmarshal(v, &signatures); err != nil { - return nil, err - } - - return signatures, nil -} - -// insertStateSyncProofs inserts the provided state sync proofs to db -func (s *StateSyncStore) insertStateSyncProofs(stateSyncProof []*StateSyncProof, dbTx *bolt.Tx) error { - insertFn := func(tx *bolt.Tx) error { - bucket := tx.Bucket(stateSyncProofsBucket) - - for _, ssp := range stateSyncProof { - raw, err := json.Marshal(ssp) - if err != nil { - return err - } - - if err := bucket.Put(common.EncodeUint64ToBytes(ssp.StateSync.ID.Uint64()), raw); err != nil { - return err - } - } - - return nil - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return insertFn(tx) - }) - } - - return insertFn(dbTx) -} - -// getStateSyncProof gets state sync proof that are not executed -func (s *StateSyncStore) getStateSyncProof(stateSyncID uint64) (*StateSyncProof, error) { - var ssp *StateSyncProof - - err := s.db.View(func(tx *bolt.Tx) error { - if v := tx.Bucket(stateSyncProofsBucket).Get(common.EncodeUint64ToBytes(stateSyncID)); v != nil { - if err := json.Unmarshal(v, &ssp); err != nil { - return err - } - } - - return nil - }) - - return ssp, err -} - -// updateStateSyncRelayerEvents updates/remove desired events -func (s *StateSyncStore) updateStateSyncRelayerEvents( - events []*StateSyncRelayerEventData, removeIDs []uint64, dbTx *bolt.Tx) error { - updateFn := func(tx *bolt.Tx) error { - relayerEventsBucket := tx.Bucket(stateSyncRelayerEventsBucket) - - for _, evnt := range events { - raw, err := json.Marshal(evnt) - if err != nil { - return err - } - - key := common.EncodeUint64ToBytes(evnt.EventID) - - if err := relayerEventsBucket.Put(key, raw); err != nil { - return err - } - } - - for _, stateSyncEventID := range removeIDs { - stateSyncEventIDKey := common.EncodeUint64ToBytes(stateSyncEventID) - - if err := relayerEventsBucket.Delete(stateSyncEventIDKey); err != nil { - return fmt.Errorf("failed to remove state sync relayer event (ID=%d): %w", stateSyncEventID, err) - } - } - - return nil - } - - if dbTx == nil { - return s.db.Update(func(tx *bolt.Tx) error { - return updateFn(tx) - }) - } - - return updateFn(dbTx) -} - -// getAllAvailableEvents retrieves all StateSyncRelayerEventData that should be sent as a transactions -func (s *StateSyncStore) getAllAvailableEvents(limit int) (result []*StateSyncRelayerEventData, err error) { - if err = s.db.View(func(tx *bolt.Tx) error { - cursor := tx.Bucket(stateSyncRelayerEventsBucket).Cursor() - - for k, v := cursor.First(); k != nil; k, v = cursor.Next() { - var event *StateSyncRelayerEventData - - if err := json.Unmarshal(v, &event); err != nil { - return err - } - - result = append(result, event) - - if limit > 0 && len(result) >= limit { - break - } - } - - return nil - }); err != nil { - return nil, err - } - - return result, nil -} diff --git a/consensus/polybft/state_store_state_sync_test.go b/consensus/polybft/state_store_state_sync_test.go deleted file mode 100644 index 599eb53..0000000 --- a/consensus/polybft/state_store_state_sync_test.go +++ /dev/null @@ -1,355 +0,0 @@ -package polybft - -import ( - "bytes" - "fmt" - "math/big" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/merkle-tree" - "github.com/xgr-network/xgr-node/types" - "go.etcd.io/bbolt" -) - -func TestState_InsertEvent(t *testing.T) { - t.Parallel() - - state := newTestState(t) - event1 := &contractsapi.StateSyncedEvent{ - ID: big.NewInt(0), - Sender: types.Address{}, - Receiver: types.Address{}, - Data: []byte{}, - } - - err := state.StateSyncStore.insertStateSyncEvent(event1) - assert.NoError(t, err) - - events, err := state.StateSyncStore.list() - assert.NoError(t, err) - assert.Len(t, events, 1) -} - -func TestState_Insert_And_Get_MessageVotes(t *testing.T) { - t.Parallel() - - state := newTestState(t) - epoch := uint64(1) - assert.NoError(t, state.EpochStore.insertEpoch(epoch, nil)) - - hash := []byte{1, 2} - _, err := state.StateSyncStore.insertMessageVote(1, hash, &MessageSignature{ - From: "NODE_1", - Signature: []byte{1, 2}, - }, nil) - - assert.NoError(t, err) - - votes, err := state.StateSyncStore.getMessageVotes(epoch, hash) - assert.NoError(t, err) - assert.Equal(t, 1, len(votes)) - assert.Equal(t, "NODE_1", votes[0].From) - assert.True(t, bytes.Equal([]byte{1, 2}, votes[0].Signature)) -} - -func TestState_getStateSyncEventsForCommitment_NotEnoughEvents(t *testing.T) { - t.Parallel() - - state := newTestState(t) - - for i := 0; i < maxCommitmentSize-2; i++ { - assert.NoError(t, state.StateSyncStore.insertStateSyncEvent(&contractsapi.StateSyncedEvent{ - ID: big.NewInt(int64(i)), - Data: []byte{1, 2}, - })) - } - - _, err := state.StateSyncStore.getStateSyncEventsForCommitment(0, maxCommitmentSize-1, nil) - assert.ErrorIs(t, err, errNotEnoughStateSyncs) -} - -func TestState_getStateSyncEventsForCommitment(t *testing.T) { - t.Parallel() - - state := newTestState(t) - - for i := 0; i < maxCommitmentSize; i++ { - assert.NoError(t, state.StateSyncStore.insertStateSyncEvent(&contractsapi.StateSyncedEvent{ - ID: big.NewInt(int64(i)), - Data: []byte{1, 2}, - })) - } - - t.Run("Return all - forced. Enough events", func(t *testing.T) { - t.Parallel() - - events, err := state.StateSyncStore.getStateSyncEventsForCommitment(0, maxCommitmentSize-1, nil) - require.NoError(t, err) - require.Equal(t, maxCommitmentSize, len(events)) - }) - - t.Run("Return all - forced. Not enough events", func(t *testing.T) { - t.Parallel() - - _, err := state.StateSyncStore.getStateSyncEventsForCommitment(0, maxCommitmentSize+1, nil) - require.ErrorIs(t, err, errNotEnoughStateSyncs) - }) - - t.Run("Return all you can. Enough events", func(t *testing.T) { - t.Parallel() - - events, err := state.StateSyncStore.getStateSyncEventsForCommitment(0, maxCommitmentSize-1, nil) - assert.NoError(t, err) - assert.Equal(t, maxCommitmentSize, len(events)) - }) - - t.Run("Return all you can. Not enough events", func(t *testing.T) { - t.Parallel() - - events, err := state.StateSyncStore.getStateSyncEventsForCommitment(0, maxCommitmentSize+1, nil) - assert.ErrorIs(t, err, errNotEnoughStateSyncs) - assert.Equal(t, maxCommitmentSize, len(events)) - }) -} - -func TestState_insertCommitmentMessage(t *testing.T) { - t.Parallel() - - commitment := createTestCommitmentMessage(t, 11) - - state := newTestState(t) - assert.NoError(t, state.StateSyncStore.insertCommitmentMessage(commitment, nil)) - - commitmentFromDB, err := state.StateSyncStore.getCommitmentMessage(commitment.Message.EndID.Uint64()) - - assert.NoError(t, err) - assert.NotNil(t, commitmentFromDB) - assert.Equal(t, commitment, commitmentFromDB) -} - -func TestState_StateSync_insertAndGetStateSyncProof(t *testing.T) { - t.Parallel() - - state := newTestState(t) - commitment := createTestCommitmentMessage(t, 0) - require.NoError(t, state.StateSyncStore.insertCommitmentMessage(commitment, nil)) - - insertTestStateSyncProofs(t, state, 10) - - proofFromDB, err := state.StateSyncStore.getStateSyncProof(1) - - assert.NoError(t, err) - assert.Equal(t, uint64(1), proofFromDB.StateSync.ID.Uint64()) - assert.NotNil(t, proofFromDB.Proof) -} - -func TestState_getCommitmentForStateSync(t *testing.T) { - const ( - numOfCommitments = 10 - ) - - state := newTestState(t) - - insertTestCommitments(t, state, numOfCommitments) - - var cases = []struct { - stateSyncID uint64 - hasCommitment bool - }{ - {1, true}, - {10, true}, - {11, true}, - {7, true}, - {999, false}, - {121, false}, - {99, true}, - {101, true}, - {111, false}, - {75, true}, - {5, true}, - {102, true}, - {211, false}, - {21, true}, - {30, true}, - {81, true}, - {90, true}, - } - - for _, c := range cases { - commitment, err := state.StateSyncStore.getCommitmentForStateSync(c.stateSyncID) - - if c.hasCommitment { - require.NoError(t, err, fmt.Sprintf("state sync %v", c.stateSyncID)) - require.Equal(t, c.hasCommitment, commitment.ContainsStateSync(c.stateSyncID)) - } else { - require.ErrorIs(t, errNoCommitmentForStateSync, err) - } - } -} - -func TestState_GetNestedBucketInEpoch(t *testing.T) { - t.Parallel() - - cases := []struct { - name string - epochNumber uint64 - bucketName []byte - errMsg string - }{ - { - name: "Not existing inner bucket", - epochNumber: 3, - bucketName: []byte("Foo"), - errMsg: "could not find Foo bucket for epoch: 3", - }, - { - name: "Happy path", - epochNumber: 5, - bucketName: messageVotesBucket, - errMsg: "", - }, - } - - for _, c := range cases { - c := c - t.Run(c.name, func(t *testing.T) { - t.Parallel() - - var ( - nestedBucket *bbolt.Bucket - err error - ) - - s := newTestState(t) - require.NoError(t, s.EpochStore.insertEpoch(c.epochNumber, nil)) - err = s.db.View(func(tx *bbolt.Tx) error { - nestedBucket, err = getNestedBucketInEpoch(tx, c.epochNumber, c.bucketName) - - return err - }) - if c.errMsg != "" { - require.ErrorContains(t, err, c.errMsg) - require.Nil(t, nestedBucket) - } else { - require.NoError(t, err) - require.NotNil(t, nestedBucket) - } - }) - } -} - -func createTestCommitmentMessage(t *testing.T, fromIndex uint64) *CommitmentMessageSigned { - t.Helper() - - tree, err := merkle.NewMerkleTree([][]byte{ - {0, 1}, - {2, 3}, - {4, 5}, - }) - - require.NoError(t, err) - - msg := &contractsapi.StateSyncCommitment{ - Root: tree.Hash(), - StartID: big.NewInt(int64(fromIndex)), - EndID: big.NewInt(int64(fromIndex + maxCommitmentSize - 1)), - } - - return &CommitmentMessageSigned{ - Message: msg, - AggSignature: Signature{}, - } -} - -func insertTestCommitments(t *testing.T, state *State, numberOfCommitments uint64) { - t.Helper() - - for i := uint64(0); i <= numberOfCommitments; i++ { - commitment := createTestCommitmentMessage(t, i*maxCommitmentSize+1) - require.NoError(t, state.StateSyncStore.insertCommitmentMessage(commitment, nil)) - } -} - -func insertTestStateSyncProofs(t *testing.T, state *State, numberOfProofs int64) { - t.Helper() - - ssProofs := make([]*StateSyncProof, numberOfProofs) - - for i := int64(0); i < numberOfProofs; i++ { - proofs := &StateSyncProof{ - Proof: []types.Hash{types.BytesToHash(generateRandomBytes(t))}, - StateSync: createTestStateSync(i), - } - ssProofs[i] = proofs - } - - require.NoError(t, state.StateSyncStore.insertStateSyncProofs(ssProofs, nil)) -} - -func createTestStateSync(index int64) *contractsapi.StateSyncedEvent { - return &contractsapi.StateSyncedEvent{ - ID: big.NewInt(index), - Sender: types.ZeroAddress, - Receiver: types.ZeroAddress, - Data: []byte{0, 1}, - } -} - -func TestState_StateSync_StateSyncRelayerDataAndEvents(t *testing.T) { - t.Parallel() - - state := newTestState(t) - - // update - require.NoError(t, state.StateSyncStore.updateStateSyncRelayerEvents([]*StateSyncRelayerEventData{ - {EventID: 2}, - {EventID: 4}, - {EventID: 7, SentStatus: true, BlockNumber: 100}, - }, []uint64{}, nil)) - - // get available events - events, err := state.StateSyncStore.getAllAvailableEvents(0) - - require.NoError(t, err) - require.Len(t, events, 3) - require.Equal(t, uint64(2), events[0].EventID) - require.Equal(t, uint64(4), events[1].EventID) - require.Equal(t, uint64(7), events[2].EventID) - - // update again - require.NoError(t, state.StateSyncStore.updateStateSyncRelayerEvents( - []*StateSyncRelayerEventData{ - {EventID: 10}, - {EventID: 12}, - {EventID: 11}, - }, - []uint64{4, 7}, - nil, - )) - - // get available events - events, err = state.StateSyncStore.getAllAvailableEvents(1000) - - require.NoError(t, err) - require.Len(t, events, 4) - require.Equal(t, uint64(2), events[0].EventID) - require.Equal(t, uint64(10), events[1].EventID) - require.Equal(t, false, events[1].SentStatus) - require.Equal(t, uint64(11), events[2].EventID) - require.Equal(t, uint64(12), events[3].EventID) - - events[1].SentStatus = true - require.NoError(t, state.StateSyncStore.updateStateSyncRelayerEvents(events[1:2], []uint64{2}, nil)) - - // get available events with limit - events, err = state.StateSyncStore.getAllAvailableEvents(2) - - require.NoError(t, err) - require.Len(t, events, 2) - require.Equal(t, uint64(10), events[0].EventID) - require.Equal(t, true, events[0].SentStatus) - require.Equal(t, uint64(11), events[1].EventID) -} diff --git a/consensus/polybft/state_sync_commitment.go b/consensus/polybft/state_sync_commitment.go deleted file mode 100644 index 932975c..0000000 --- a/consensus/polybft/state_sync_commitment.go +++ /dev/null @@ -1,202 +0,0 @@ -package polybft - -import ( - "bytes" - "errors" - "fmt" - - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/crypto" - "github.com/xgr-network/xgr-node/merkle-tree" - "github.com/xgr-network/xgr-node/state/runtime/precompiled" - "github.com/xgr-network/xgr-node/types" -) - -const ( - stTypeBridgeCommitment = "commitment" - stTypeEndEpoch = "end-epoch" -) - -// PendingCommitment holds merkle trie of bridge transactions accompanied by epoch number -type PendingCommitment struct { - *contractsapi.StateSyncCommitment - MerkleTree *merkle.MerkleTree - Epoch uint64 -} - -// NewPendingCommitment creates a new commitment object -func NewPendingCommitment(epoch uint64, stateSyncEvents []*contractsapi.StateSyncedEvent) (*PendingCommitment, error) { - tree, err := createMerkleTree(stateSyncEvents) - if err != nil { - return nil, err - } - - return &PendingCommitment{ - MerkleTree: tree, - Epoch: epoch, - StateSyncCommitment: &contractsapi.StateSyncCommitment{ - StartID: stateSyncEvents[0].ID, - EndID: stateSyncEvents[len(stateSyncEvents)-1].ID, - Root: tree.Hash(), - }, - }, nil -} - -// Hash calculates hash value for commitment object. -func (cm *PendingCommitment) Hash() (types.Hash, error) { - data, err := cm.StateSyncCommitment.EncodeAbi() - if err != nil { - return types.Hash{}, err - } - - return crypto.Keccak256Hash(data), nil -} - -var _ contractsapi.StateTransactionInput = &CommitmentMessageSigned{} - -// CommitmentMessageSigned encapsulates commitment message with aggregated signatures -type CommitmentMessageSigned struct { - Message *contractsapi.StateSyncCommitment - AggSignature Signature - PublicKeys [][]byte -} - -// Hash calculates hash value for commitment object. -func (cm *CommitmentMessageSigned) Hash() (types.Hash, error) { - data, err := cm.Message.EncodeAbi() - if err != nil { - return types.Hash{}, err - } - - return crypto.Keccak256Hash(data), nil -} - -// VerifyStateSyncProof validates given state sync proof -// against merkle tree root hash contained in the CommitmentMessage -func (cm *CommitmentMessageSigned) VerifyStateSyncProof(proof []types.Hash, - stateSync *contractsapi.StateSyncedEvent) error { - if stateSync == nil { - return errors.New("no state sync event") - } - - if stateSync.ID.Uint64() < cm.Message.StartID.Uint64() || - stateSync.ID.Uint64() > cm.Message.EndID.Uint64() { - return errors.New("invalid state sync ID") - } - - hash, err := stateSync.EncodeAbi() - if err != nil { - return err - } - - return merkle.VerifyProof(stateSync.ID.Uint64()-cm.Message.StartID.Uint64(), - hash, proof, cm.Message.Root) -} - -// ContainsStateSync checks if commitment contains given state sync event -func (cm *CommitmentMessageSigned) ContainsStateSync(stateSyncID uint64) bool { - return cm.Message.StartID.Uint64() <= stateSyncID && cm.Message.EndID.Uint64() >= stateSyncID -} - -// EncodeAbi contains logic for encoding arbitrary data into ABI format -func (cm *CommitmentMessageSigned) EncodeAbi() ([]byte, error) { - blsVerificationPart, err := precompiled.BlsVerificationABIType.Encode( - [2]interface{}{cm.PublicKeys, cm.AggSignature.Bitmap}) - if err != nil { - return nil, err - } - - commit := &contractsapi.CommitStateReceiverFn{ - Commitment: cm.Message, - Signature: cm.AggSignature.AggregatedSignature, - Bitmap: blsVerificationPart, - } - - return commit.EncodeAbi() -} - -// DecodeAbi contains logic for decoding given ABI data -func (cm *CommitmentMessageSigned) DecodeAbi(txData []byte) error { - if len(txData) < abiMethodIDLength { - return fmt.Errorf("invalid commitment data, len = %d", len(txData)) - } - - commit := contractsapi.CommitStateReceiverFn{} - - err := commit.DecodeAbi(txData) - if err != nil { - return err - } - - decoded, err := precompiled.BlsVerificationABIType.Decode(commit.Bitmap) - if err != nil { - return err - } - - blsMap, isOk := decoded.(map[string]interface{}) - if !isOk { - return fmt.Errorf("invalid commitment data. Bls verification part not in correct format") - } - - publicKeys, isOk := blsMap["0"].([][]byte) - if !isOk { - return fmt.Errorf("invalid commitment data. Could not find public keys part") - } - - bitmap, isOk := blsMap["1"].([]byte) - if !isOk { - return fmt.Errorf("invalid commitment data. Could not find bitmap part") - } - - *cm = CommitmentMessageSigned{ - Message: commit.Commitment, - AggSignature: Signature{ - AggregatedSignature: commit.Signature, - Bitmap: bitmap, - }, - PublicKeys: publicKeys, - } - - return nil -} - -// getCommitmentMessageSignedTx returns a CommitmentMessageSigned object from a commit state transaction -func getCommitmentMessageSignedTx(txs []*types.Transaction) (*CommitmentMessageSigned, error) { - var commitFn contractsapi.CommitStateReceiverFn - for _, tx := range txs { - // skip non state CommitmentMessageSigned transactions - if tx.Type != types.StateTx || - len(tx.Input) < abiMethodIDLength || - !bytes.Equal(tx.Input[:abiMethodIDLength], commitFn.Sig()) { - continue - } - - obj := &CommitmentMessageSigned{} - - if err := obj.DecodeAbi(tx.Input); err != nil { - return nil, fmt.Errorf("get commitment message signed tx error: %w", err) - } - - return obj, nil - } - - return nil, nil -} - -// createMerkleTree creates a merkle tree from provided state sync events -// if only one state sync event is provided, a second, empty leaf will be added to merkle tree -// so that we can have a commitment with a single state sync event -func createMerkleTree(stateSyncEvents []*contractsapi.StateSyncedEvent) (*merkle.MerkleTree, error) { - stateSyncData := make([][]byte, len(stateSyncEvents)) - - for i, sse := range stateSyncEvents { - data, err := sse.EncodeAbi() - if err != nil { - return nil, err - } - - stateSyncData[i] = data - } - - return merkle.NewMerkleTree(stateSyncData) -} diff --git a/consensus/polybft/state_sync_commitment_test.go b/consensus/polybft/state_sync_commitment_test.go deleted file mode 100644 index ea0bec9..0000000 --- a/consensus/polybft/state_sync_commitment_test.go +++ /dev/null @@ -1,178 +0,0 @@ -package polybft - -import ( - "math/big" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/types" -) - -func TestCommitmentMessage_Hash(t *testing.T) { - t.Parallel() - - const ( - eventsCount = 10 - ) - - stateSyncEvents := generateStateSyncEvents(t, eventsCount, 0) - - trie1, err := createMerkleTree(stateSyncEvents) - require.NoError(t, err) - - trie2, err := createMerkleTree(stateSyncEvents[0 : len(stateSyncEvents)-1]) - require.NoError(t, err) - - commitmentMessage1 := newTestCommitmentSigned(t, trie1.Hash(), 2, 8) - commitmentMessage2 := newTestCommitmentSigned(t, trie1.Hash(), 2, 8) - commitmentMessage3 := newTestCommitmentSigned(t, trie1.Hash(), 6, 10) - commitmentMessage4 := newTestCommitmentSigned(t, trie2.Hash(), 2, 8) - - hash1, err := commitmentMessage1.Hash() - require.NoError(t, err) - hash2, err := commitmentMessage2.Hash() - require.NoError(t, err) - hash3, err := commitmentMessage3.Hash() - require.NoError(t, err) - hash4, err := commitmentMessage4.Hash() - require.NoError(t, err) - - require.Equal(t, hash1, hash2) - require.NotEqual(t, hash1, hash3) - require.NotEqual(t, hash1, hash4) - require.NotEqual(t, hash3, hash4) -} - -func TestCommitmentMessage_ToRegisterCommitmentInputData(t *testing.T) { - t.Parallel() - - const epoch, eventsCount = uint64(100), 11 - pendingCommitment, _, _ := buildCommitmentAndStateSyncs(t, eventsCount, epoch, uint64(2)) - expectedSignedCommitmentMsg := &CommitmentMessageSigned{ - Message: pendingCommitment.StateSyncCommitment, - AggSignature: Signature{ - Bitmap: []byte{5, 1}, - AggregatedSignature: []byte{1, 1}, - }, - PublicKeys: [][]byte{{0, 1}, {2, 3}, {4, 5}}, - } - inputData, err := expectedSignedCommitmentMsg.EncodeAbi() - require.NoError(t, err) - require.NotEmpty(t, inputData) - - var actualSignedCommitmentMsg CommitmentMessageSigned - - require.NoError(t, actualSignedCommitmentMsg.DecodeAbi(inputData)) - require.NoError(t, err) - require.Equal(t, *expectedSignedCommitmentMsg.Message, *actualSignedCommitmentMsg.Message) - require.Equal(t, expectedSignedCommitmentMsg.AggSignature, actualSignedCommitmentMsg.AggSignature) -} - -func TestCommitmentMessage_VerifyProof(t *testing.T) { - t.Parallel() - - const epoch, eventsCount = uint64(100), 11 - commitment, commitmentSigned, stateSyncs := buildCommitmentAndStateSyncs(t, eventsCount, epoch, 0) - require.Equal(t, uint64(10), commitment.EndID.Sub(commitment.EndID, commitment.StartID).Uint64()) - - for _, stateSync := range stateSyncs { - leaf, err := stateSync.EncodeAbi() - require.NoError(t, err) - - proof, err := commitment.MerkleTree.GenerateProof(leaf) - require.NoError(t, err) - - execute := &contractsapi.ExecuteStateReceiverFn{ - Proof: proof, - Obj: (*contractsapi.StateSync)(stateSync), - } - - inputData, err := execute.EncodeAbi() - require.NoError(t, err) - - executionStateSync := &contractsapi.ExecuteStateReceiverFn{} - require.NoError(t, executionStateSync.DecodeAbi(inputData)) - require.Equal(t, stateSync.ID.Uint64(), executionStateSync.Obj.ID.Uint64()) - require.Equal(t, stateSync.Sender, executionStateSync.Obj.Sender) - require.Equal(t, stateSync.Receiver, executionStateSync.Obj.Receiver) - require.Equal(t, stateSync.Data, executionStateSync.Obj.Data) - require.Equal(t, proof, executionStateSync.Proof) - - err = commitmentSigned.VerifyStateSyncProof(executionStateSync.Proof, - (*contractsapi.StateSyncedEvent)(executionStateSync.Obj)) - require.NoError(t, err) - } -} - -func TestCommitmentMessage_VerifyProof_NoStateSyncsInCommitment(t *testing.T) { - t.Parallel() - - commitment := &CommitmentMessageSigned{Message: &contractsapi.StateSyncCommitment{StartID: big.NewInt(1), EndID: big.NewInt(10)}} - err := commitment.VerifyStateSyncProof([]types.Hash{}, nil) - assert.ErrorContains(t, err, "no state sync event") -} - -func TestCommitmentMessage_VerifyProof_StateSyncHashNotEqualToProof(t *testing.T) { - t.Parallel() - - const ( - fromIndex = 0 - toIndex = 4 - ) - - stateSyncs := generateStateSyncEvents(t, 5, 0) - tree, err := createMerkleTree(stateSyncs) - require.NoError(t, err) - - leaf, err := stateSyncs[0].EncodeAbi() - require.NoError(t, err) - - proof, err := tree.GenerateProof(leaf) - require.NoError(t, err) - - commitment := &CommitmentMessageSigned{ - Message: &contractsapi.StateSyncCommitment{ - StartID: big.NewInt(fromIndex), - EndID: big.NewInt(toIndex), - Root: tree.Hash(), - }, - } - - assert.ErrorContains(t, commitment.VerifyStateSyncProof(proof, stateSyncs[4]), "not a member of merkle tree") -} - -func newTestCommitmentSigned(t *testing.T, root types.Hash, startID, endID int64) *CommitmentMessageSigned { - t.Helper() - - return &CommitmentMessageSigned{ - Message: &contractsapi.StateSyncCommitment{ - StartID: big.NewInt(startID), - EndID: big.NewInt(endID), - Root: root, - }, - AggSignature: Signature{}, - PublicKeys: [][]byte{}, - } -} - -func buildCommitmentAndStateSyncs(t *testing.T, stateSyncsCount int, - epoch, startIdx uint64) (*PendingCommitment, *CommitmentMessageSigned, []*contractsapi.StateSyncedEvent) { - t.Helper() - - stateSyncEvents := generateStateSyncEvents(t, stateSyncsCount, startIdx) - commitment, err := NewPendingCommitment(epoch, stateSyncEvents) - require.NoError(t, err) - - commitmentSigned := &CommitmentMessageSigned{ - Message: commitment.StateSyncCommitment, - AggSignature: Signature{ - AggregatedSignature: []byte{}, - Bitmap: []byte{}, - }, - PublicKeys: [][]byte{}, - } - - return commitment, commitmentSigned, stateSyncEvents -} diff --git a/consensus/polybft/state_sync_manager.go b/consensus/polybft/state_sync_manager.go deleted file mode 100644 index c60a692..0000000 --- a/consensus/polybft/state_sync_manager.go +++ /dev/null @@ -1,651 +0,0 @@ -package polybft - -import ( - "context" - "encoding/hex" - "encoding/json" - "errors" - "fmt" - "path" - "sync" - "time" - - "github.com/hashicorp/go-hclog" - "github.com/libp2p/go-libp2p/core/peer" - "github.com/umbracle/ethgo" - bolt "go.etcd.io/bbolt" - "google.golang.org/protobuf/proto" - - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - polybftProto "github.com/xgr-network/xgr-node/consensus/polybft/proto" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/tracker" - "github.com/xgr-network/xgr-node/types" -) - -type Runtime interface { - IsActiveValidator() bool -} - -type StateSyncProof struct { - Proof []types.Hash - StateSync *contractsapi.StateSyncedEvent -} - -// StateSyncManager is an interface that defines functions for state sync workflow -type StateSyncManager interface { - EventSubscriber - Init() error - Close() - Commitment(blockNumber uint64) (*CommitmentMessageSigned, error) - GetStateSyncProof(stateSyncID uint64) (types.Proof, error) - PostBlock(req *PostBlockRequest) error - PostEpoch(req *PostEpochRequest) error -} - -var _ StateSyncManager = (*dummyStateSyncManager)(nil) - -// dummyStateSyncManager is used when bridge is not enabled -type dummyStateSyncManager struct{} - -func (d *dummyStateSyncManager) Init() error { return nil } -func (d *dummyStateSyncManager) Close() {} -func (d *dummyStateSyncManager) Commitment(blockNumber uint64) (*CommitmentMessageSigned, error) { - return nil, nil -} -func (d *dummyStateSyncManager) PostBlock(req *PostBlockRequest) error { return nil } -func (d *dummyStateSyncManager) PostEpoch(req *PostEpochRequest) error { return nil } -func (d *dummyStateSyncManager) GetStateSyncProof(stateSyncID uint64) (types.Proof, error) { - return types.Proof{}, nil -} - -// EventSubscriber implementation -func (d *dummyStateSyncManager) GetLogFilters() map[types.Address][]types.Hash { - return make(map[types.Address][]types.Hash) -} -func (d *dummyStateSyncManager) ProcessLog(header *types.Header, - log *ethgo.Log, dbTx *bolt.Tx) error { - return nil -} - -// stateSyncConfig holds the configuration data of state sync manager -type stateSyncConfig struct { - stateSenderAddr types.Address - stateSenderStartBlock uint64 - jsonrpcAddr string - dataDir string - topic topic - key *wallet.Key - maxCommitmentSize uint64 - numBlockConfirmations uint64 - blockTrackerPollInterval time.Duration -} - -var _ StateSyncManager = (*stateSyncManager)(nil) - -// stateSyncManager is a struct that manages the workflow of -// saving and querying state sync events, and creating, and submitting new commitments -type stateSyncManager struct { - logger hclog.Logger - state *State - - config *stateSyncConfig - closeCh chan struct{} - - // per epoch fields - lock sync.RWMutex - pendingCommitments []*PendingCommitment - validatorSet validator.ValidatorSet - epoch uint64 - nextCommittedIndex uint64 - - runtime Runtime -} - -// topic is an interface for p2p message gossiping -type topic interface { - Publish(obj proto.Message) error - Subscribe(handler func(obj interface{}, from peer.ID)) error -} - -// newStateSyncManager creates a new instance of state sync manager -func newStateSyncManager(logger hclog.Logger, state *State, config *stateSyncConfig, - runtime Runtime) *stateSyncManager { - return &stateSyncManager{ - logger: logger, - state: state, - config: config, - closeCh: make(chan struct{}), - runtime: runtime, - } -} - -// Init subscribes to bridge topics (getting votes) and start the event tracker routine -func (s *stateSyncManager) Init() error { - if err := s.initTracker(); err != nil { - return fmt.Errorf("failed to init event tracker. Error: %w", err) - } - - if err := s.initTransport(); err != nil { - return fmt.Errorf("failed to initialize state sync transport layer. Error: %w", err) - } - - return nil -} - -func (s *stateSyncManager) Close() { - close(s.closeCh) -} - -// initTracker starts a new event tracker (to receive new state sync events) -func (s *stateSyncManager) initTracker() error { - ctx, cancelFn := context.WithCancel(context.Background()) - - evtTracker := tracker.NewEventTracker( - path.Join(s.config.dataDir, "/deposit.db"), - s.config.jsonrpcAddr, - ethgo.Address(s.config.stateSenderAddr), - s, - s.config.numBlockConfirmations, - s.config.stateSenderStartBlock, - s.logger, - s.config.blockTrackerPollInterval) - - go func() { - <-s.closeCh - cancelFn() - }() - - return evtTracker.Start(ctx) -} - -// initTransport subscribes to bridge topics (getting votes for commitments) -func (s *stateSyncManager) initTransport() error { - return s.config.topic.Subscribe(func(obj interface{}, _ peer.ID) { - if !s.runtime.IsActiveValidator() { - // don't save votes if not a validator - return - } - - msg, ok := obj.(*polybftProto.TransportMessage) - if !ok { - s.logger.Warn("failed to deliver vote, invalid msg", "obj", obj) - - return - } - - var transportMsg *TransportMessage - - if err := json.Unmarshal(msg.Data, &transportMsg); err != nil { - s.logger.Warn("failed to deliver vote", "error", err) - - return - } - - if err := s.saveVote(transportMsg); err != nil { - s.logger.Warn("failed to deliver vote", "error", err) - } - }) -} - -// saveVote saves the gotten vote to boltDb for later quorum check and signature aggregation -func (s *stateSyncManager) saveVote(msg *TransportMessage) error { - s.lock.RLock() - epoch := s.epoch - valSet := s.validatorSet - s.lock.RUnlock() - - if valSet == nil || msg.EpochNumber != epoch { - // Epoch metadata is undefined or received a message for the irrelevant epoch - return nil - } - - if err := s.verifyVoteSignature(valSet, types.StringToAddress(msg.From), msg.Signature, msg.Hash); err != nil { - return fmt.Errorf("error verifying vote signature: %w", err) - } - - msgVote := &MessageSignature{ - From: msg.From, - Signature: msg.Signature, - } - - numSignatures, err := s.state.StateSyncStore.insertMessageVote(msg.EpochNumber, msg.Hash, msgVote, nil) - if err != nil { - return fmt.Errorf("error inserting message vote: %w", err) - } - - s.logger.Info( - "deliver message", - "hash", hex.EncodeToString(msg.Hash), - "sender", msg.From, - "signatures", numSignatures, - ) - - return nil -} - -// Verifies signature of the message against the public key of the signer and checks if the signer is a validator -func (s *stateSyncManager) verifyVoteSignature(valSet validator.ValidatorSet, signerAddr types.Address, - signature []byte, hash []byte) error { - validator := valSet.Accounts().GetValidatorMetadata(signerAddr) - if validator == nil { - return fmt.Errorf("unable to resolve validator %s", signerAddr) - } - - unmarshaledSignature, err := bls.UnmarshalSignature(signature) - if err != nil { - return fmt.Errorf("failed to unmarshal signature from signer %s, %w", signerAddr.String(), err) - } - - if !unmarshaledSignature.Verify(validator.BlsKey, hash, signer.DomainStateReceiver) { - return fmt.Errorf("incorrect signature from %s", signerAddr) - } - - return nil -} - -// AddLog saves the received log from event tracker if it matches a state sync event ABI -func (s *stateSyncManager) AddLog(eventLog *ethgo.Log) error { - event := &contractsapi.StateSyncedEvent{} - - doesMatch, err := event.ParseLog(eventLog) - if !doesMatch { - return nil - } - - s.logger.Info( - "Add State sync event", - "block", eventLog.BlockNumber, - "hash", eventLog.TransactionHash, - "index", eventLog.LogIndex, - ) - - if err != nil { - s.logger.Error("could not decode state sync event", "err", err) - - return err - } - - if err := s.state.StateSyncStore.insertStateSyncEvent(event); err != nil { - s.logger.Error("could not save state sync event to boltDb", "err", err) - - return err - } - - if err := s.buildCommitment(nil); err != nil { - // we don't return an error here. If state sync event is inserted in db, - // we will just try to build a commitment on next block or next event arrival - s.logger.Error("could not build a commitment on arrival of new state sync", "err", err, "stateSyncID", event.ID) - } - - return nil -} - -// Commitment returns a commitment to be submitted if there is a pending commitment with quorum -func (s *stateSyncManager) Commitment(blockNumber uint64) (*CommitmentMessageSigned, error) { - s.lock.RLock() - defer s.lock.RUnlock() - - var largestCommitment *CommitmentMessageSigned - - // we start from the end, since last pending commitment is the largest one - for i := len(s.pendingCommitments) - 1; i >= 0; i-- { - commitment := s.pendingCommitments[i] - aggregatedSignature, publicKeys, err := s.getAggSignatureForCommitmentMessage(blockNumber, commitment) - - if err != nil { - if errors.Is(err, errQuorumNotReached) { - // a valid case, commitment has no quorum, we should not return an error - s.logger.Debug("can not submit a commitment, quorum not reached", - "from", commitment.StartID.Uint64(), - "to", commitment.EndID.Uint64()) - - continue - } - - return nil, err - } - - largestCommitment = &CommitmentMessageSigned{ - Message: commitment.StateSyncCommitment, - AggSignature: aggregatedSignature, - PublicKeys: publicKeys, - } - - break - } - - return largestCommitment, nil -} - -// getAggSignatureForCommitmentMessage checks if pending commitment has quorum, -// and if it does, aggregates the signatures -func (s *stateSyncManager) getAggSignatureForCommitmentMessage(blockNumber uint64, - commitment *PendingCommitment) (Signature, [][]byte, error) { - validatorSet := s.validatorSet - - validatorAddrToIndex := make(map[string]int, validatorSet.Len()) - validatorsMetadata := validatorSet.Accounts() - - for i, validator := range validatorsMetadata { - validatorAddrToIndex[validator.Address.String()] = i - } - - commitmentHash, err := commitment.Hash() - if err != nil { - return Signature{}, nil, err - } - - // get all the votes from the database for this commitment - votes, err := s.state.StateSyncStore.getMessageVotes(commitment.Epoch, commitmentHash.Bytes()) - if err != nil { - return Signature{}, nil, err - } - - var signatures bls.Signatures - - publicKeys := make([][]byte, 0) - bmap := bitmap.Bitmap{} - signers := make(map[types.Address]struct{}, 0) - - for _, vote := range votes { - index, exists := validatorAddrToIndex[vote.From] - if !exists { - continue // don't count this vote, because it does not belong to validator - } - - signature, err := bls.UnmarshalSignature(vote.Signature) - if err != nil { - return Signature{}, nil, err - } - - bmap.Set(uint64(index)) - - signatures = append(signatures, signature) - publicKeys = append(publicKeys, validatorsMetadata[index].BlsKey.Marshal()) - signers[types.StringToAddress(vote.From)] = struct{}{} - } - - if !validatorSet.HasQuorum(blockNumber, signers) { - return Signature{}, nil, errQuorumNotReached - } - - aggregatedSignature, err := signatures.Aggregate().Marshal() - if err != nil { - return Signature{}, nil, err - } - - result := Signature{ - AggregatedSignature: aggregatedSignature, - Bitmap: bmap, - } - - return result, publicKeys, nil -} - -// PostEpoch notifies the state sync manager that an epoch has changed, -// so that it can discard any previous epoch commitments, and build a new one (since validator set changed) -func (s *stateSyncManager) PostEpoch(req *PostEpochRequest) error { - s.lock.Lock() - - s.pendingCommitments = nil - s.validatorSet = req.ValidatorSet - s.epoch = req.NewEpochID - - // build a new commitment at the end of the epoch - nextCommittedIndex, err := req.SystemState.GetNextCommittedIndex() - if err != nil { - s.lock.Unlock() - - return err - } - - s.nextCommittedIndex = nextCommittedIndex - - s.lock.Unlock() - - return s.buildCommitment(req.DBTx) -} - -// PostBlock notifies state sync manager that a block was finalized, -// so that it can build state sync proofs if a block has a commitment submission transaction. -// Additionally, it will remove any processed state sync events and their proofs from the store. -func (s *stateSyncManager) PostBlock(req *PostBlockRequest) error { - commitment, err := getCommitmentMessageSignedTx(req.FullBlock.Block.Transactions) - if err != nil { - return err - } - - // no commitment message -> this is not end of sprint block - if commitment == nil { - return nil - } - - if err := s.state.StateSyncStore.insertCommitmentMessage(commitment, req.DBTx); err != nil { - return fmt.Errorf("insert commitment message error: %w", err) - } - - if err := s.buildProofs(commitment.Message, req.DBTx); err != nil { - return fmt.Errorf("build commitment proofs error: %w", err) - } - - s.lock.Lock() - defer s.lock.Unlock() - // update the nextCommittedIndex since a commitment was submitted - s.nextCommittedIndex = commitment.Message.EndID.Uint64() + 1 - // commitment was submitted, so discard what we have in memory, so we can build a new one - s.pendingCommitments = nil - - return nil -} - -// GetStateSyncProof returns the proof for the state sync -func (s *stateSyncManager) GetStateSyncProof(stateSyncID uint64) (types.Proof, error) { - stateSyncProof, err := s.state.StateSyncStore.getStateSyncProof(stateSyncID) - if err != nil { - return types.Proof{}, fmt.Errorf("cannot get state sync proof for StateSync id %d: %w", stateSyncID, err) - } - - if stateSyncProof == nil { - // check if we might've missed a commitment. if it is so, we didn't build proofs for it while syncing - // if we are all synced up, commitment will be saved through PostBlock, but we won't have proofs, - // so we will build them now and save them to db so that we have proofs for missed commitment - commitment, err := s.state.StateSyncStore.getCommitmentForStateSync(stateSyncID) - if err != nil { - return types.Proof{}, fmt.Errorf("cannot find commitment for StateSync id %d: %w", stateSyncID, err) - } - - if err := s.buildProofs(commitment.Message, nil); err != nil { - return types.Proof{}, fmt.Errorf("cannot build proofs for commitment for StateSync id %d: %w", stateSyncID, err) - } - - stateSyncProof, err = s.state.StateSyncStore.getStateSyncProof(stateSyncID) - if err != nil { - return types.Proof{}, fmt.Errorf("cannot get state sync proof for StateSync id %d: %w", stateSyncID, err) - } - } - - return types.Proof{ - Data: stateSyncProof.Proof, - Metadata: map[string]interface{}{ - "StateSync": stateSyncProof.StateSync, - }, - }, nil -} - -// buildProofs builds state sync proofs for the submitted commitment and saves them in boltDb for later execution -func (s *stateSyncManager) buildProofs(commitmentMsg *contractsapi.StateSyncCommitment, - dbTx *bolt.Tx) error { - from := commitmentMsg.StartID.Uint64() - to := commitmentMsg.EndID.Uint64() - - s.logger.Debug( - "[buildProofs] Building proofs for commitment...", - "fromIndex", from, - "toIndex", to, - ) - - events, err := s.state.StateSyncStore.getStateSyncEventsForCommitment(from, to, dbTx) - if err != nil { - return fmt.Errorf("failed to get state sync events for commitment to build proofs. Error: %w", err) - } - - tree, err := createMerkleTree(events) - if err != nil { - return fmt.Errorf("could not create merkle tree. error: %w", err) - } - - stateSyncProofs := make([]*StateSyncProof, len(events)) - - for i, event := range events { - leaf, err := event.EncodeAbi() - if err != nil { - return fmt.Errorf("could not encode state sync event. error: %w", err) - } - - p, err := tree.GenerateProof(leaf) - if err != nil { - return fmt.Errorf("error generating proof for event: %v. error: %w", event.ID, err) - } - - stateSyncProofs[i] = &StateSyncProof{ - Proof: p, - StateSync: event, - } - } - - s.logger.Debug( - "[buildProofs] Building proofs for commitment finished.", - "fromIndex", from, - "toIndex", to, - ) - - return s.state.StateSyncStore.insertStateSyncProofs(stateSyncProofs, dbTx) -} - -// buildCommitment builds a new commitment, signs it and gossips its vote for it -func (s *stateSyncManager) buildCommitment(dbTx *bolt.Tx) error { - if !s.runtime.IsActiveValidator() { - // don't build commitment if not a validator - return nil - } - - s.lock.Lock() - defer s.lock.Unlock() - - stateSyncEvents, err := s.state.StateSyncStore.getStateSyncEventsForCommitment(s.nextCommittedIndex, - s.nextCommittedIndex+s.config.maxCommitmentSize-1, dbTx) - if err != nil && !errors.Is(err, errNotEnoughStateSyncs) { - return fmt.Errorf("failed to get state sync events for commitment. Error: %w", err) - } - - if len(stateSyncEvents) == 0 { - // there are no state sync events - return nil - } - - if len(s.pendingCommitments) > 0 && - s.pendingCommitments[len(s.pendingCommitments)-1].StartID.Cmp(stateSyncEvents[len(stateSyncEvents)-1].ID) >= 0 { - // already built a commitment of this size which is pending to be submitted - return nil - } - - commitment, err := NewPendingCommitment(s.epoch, stateSyncEvents) - if err != nil { - return err - } - - hash, err := commitment.Hash() - if err != nil { - return fmt.Errorf("failed to generate hash for commitment. Error: %w", err) - } - - hashBytes := hash.Bytes() - - signature, err := s.config.key.SignWithDomain(hashBytes, signer.DomainStateReceiver) - if err != nil { - return fmt.Errorf("failed to sign commitment message. Error: %w", err) - } - - sig := &MessageSignature{ - From: s.config.key.String(), - Signature: signature, - } - - if _, err = s.state.StateSyncStore.insertMessageVote(s.epoch, hashBytes, sig, dbTx); err != nil { - return fmt.Errorf( - "failed to insert signature for hash=%v to the state. Error: %w", - hex.EncodeToString(hashBytes), - err, - ) - } - - // gossip message - s.multicast(&TransportMessage{ - Hash: hashBytes, - Signature: signature, - From: s.config.key.String(), - EpochNumber: s.epoch, - }) - - s.logger.Debug( - "[buildCommitment] Built commitment", - "from", commitment.StartID.Uint64(), - "to", commitment.EndID.Uint64(), - ) - - s.pendingCommitments = append(s.pendingCommitments, commitment) - - return nil -} - -// multicast publishes given message to the rest of the network -func (s *stateSyncManager) multicast(msg interface{}) { - data, err := json.Marshal(msg) - if err != nil { - s.logger.Warn("failed to marshal bridge message", "err", err) - - return - } - - err = s.config.topic.Publish(&polybftProto.TransportMessage{Data: data}) - if err != nil { - s.logger.Warn("failed to gossip bridge message", "err", err) - } -} - -// EventSubscriber implementation - -// GetLogFilters returns a map of log filters for getting desired events, -// where the key is the address of contract that emits desired events, -// and the value is a slice of signatures of events we want to get. -// This function is the implementation of EventSubscriber interface -func (s *stateSyncManager) GetLogFilters() map[types.Address][]types.Hash { - var stateSyncResultEvent contractsapi.StateSyncResultEvent - - return map[types.Address][]types.Hash{ - contracts.StateReceiverContract: {types.Hash(stateSyncResultEvent.Sig())}, - } -} - -// ProcessLog is the implementation of EventSubscriber interface, -// used to handle a log defined in GetLogFilters, provided by event provider -func (s *stateSyncManager) ProcessLog(header *types.Header, log *ethgo.Log, dbTx *bolt.Tx) error { - var stateSyncResultEvent contractsapi.StateSyncResultEvent - - doesMatch, err := stateSyncResultEvent.ParseLog(log) - if err != nil { - return err - } - - if !doesMatch { - return nil - } - - return s.state.StateSyncStore.removeStateSyncEventsAndProofs([]uint64{stateSyncResultEvent.Counter.Uint64()}) -} diff --git a/consensus/polybft/state_sync_manager_test.go b/consensus/polybft/state_sync_manager_test.go deleted file mode 100644 index 1721ba5..0000000 --- a/consensus/polybft/state_sync_manager_test.go +++ /dev/null @@ -1,702 +0,0 @@ -package polybft - -import ( - "math/big" - "math/rand" - "os" - "testing" - "time" - - "github.com/hashicorp/go-hclog" - "github.com/libp2p/go-libp2p/core/peer" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/ethgo/testutil" - "google.golang.org/protobuf/proto" - - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/merkle-tree" - "github.com/xgr-network/xgr-node/types" -) - -func newTestStateSyncManager(t *testing.T, key *validator.TestValidator, runtime Runtime) *stateSyncManager { - t.Helper() - - tmpDir, err := os.MkdirTemp("/tmp", "test-data-dir-state-sync") - require.NoError(t, err) - - state := newTestState(t) - require.NoError(t, state.EpochStore.insertEpoch(0, nil)) - - topic := &mockTopic{} - - s := newStateSyncManager(hclog.NewNullLogger(), state, - &stateSyncConfig{ - stateSenderAddr: types.Address{}, - jsonrpcAddr: "", - dataDir: tmpDir, - topic: topic, - key: key.Key(), - maxCommitmentSize: maxCommitmentSize, - }, runtime) - - t.Cleanup(func() { - os.RemoveAll(tmpDir) - }) - - return s -} - -func TestStateSyncManager_PostEpoch_BuildCommitment(t *testing.T) { - t.Parallel() - - vals := validator.NewTestValidators(t, 5) - - t.Run("When node is validator", func(t *testing.T) { - t.Parallel() - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - - // there are no state syncs - require.NoError(t, s.buildCommitment(nil)) - require.Nil(t, s.pendingCommitments) - - stateSyncs10 := generateStateSyncEvents(t, 10, 0) - - // add 5 state syncs starting in index 0, it will generate one smaller commitment - for i := 0; i < 5; i++ { - require.NoError(t, s.state.StateSyncStore.insertStateSyncEvent(stateSyncs10[i])) - } - - require.NoError(t, s.buildCommitment(nil)) - require.Len(t, s.pendingCommitments, 1) - require.Equal(t, uint64(0), s.pendingCommitments[0].StartID.Uint64()) - require.Equal(t, uint64(4), s.pendingCommitments[0].EndID.Uint64()) - require.Equal(t, uint64(0), s.pendingCommitments[0].Epoch) - - // add the next 5 state syncs, at that point, so that it generates a larger commitment - for i := 5; i < 10; i++ { - require.NoError(t, s.state.StateSyncStore.insertStateSyncEvent(stateSyncs10[i])) - } - - require.NoError(t, s.buildCommitment(nil)) - require.Len(t, s.pendingCommitments, 2) - require.Equal(t, uint64(0), s.pendingCommitments[1].StartID.Uint64()) - require.Equal(t, uint64(9), s.pendingCommitments[1].EndID.Uint64()) - require.Equal(t, uint64(0), s.pendingCommitments[1].Epoch) - - // the message was sent - require.NotNil(t, s.config.topic.(*mockTopic).consume()) //nolint - }) - - t.Run("When node is not validator", func(t *testing.T) { - t.Parallel() - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: false}) - - stateSyncs10 := generateStateSyncEvents(t, 10, 0) - - // add 5 state syncs starting in index 0, they will be saved to db - for i := 0; i < 5; i++ { - require.NoError(t, s.state.StateSyncStore.insertStateSyncEvent(stateSyncs10[i])) - } - - // I am not a validator so no commitments should be built - require.NoError(t, s.buildCommitment(nil)) - require.Len(t, s.pendingCommitments, 0) - }) -} - -func TestStateSyncManager_MessagePool(t *testing.T) { - t.Parallel() - - vals := validator.NewTestValidators(t, 5) - - t.Run("Old epoch", func(t *testing.T) { - t.Parallel() - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - - s.epoch = 1 - msg := &TransportMessage{ - EpochNumber: 0, - } - - err := s.saveVote(msg) - require.NoError(t, err) - }) - - t.Run("Sender is not a validator", func(t *testing.T) { - t.Parallel() - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - s.validatorSet = vals.ToValidatorSet() - - badVal := validator.NewTestValidator(t, "a", 0) - msg, err := newMockMsg().sign(badVal, signer.DomainStateReceiver) - require.NoError(t, err) - - require.Error(t, s.saveVote(msg)) - }) - - t.Run("Invalid epoch", func(t *testing.T) { - t.Parallel() - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - s.validatorSet = vals.ToValidatorSet() - - val := newMockMsg() - msg, err := val.sign(vals.GetValidator("0"), signer.DomainStateReceiver) - require.NoError(t, err) - - msg.EpochNumber = 1 - - require.NoError(t, s.saveVote(msg)) - - // no votes for the current epoch - votes, err := s.state.StateSyncStore.getMessageVotes(0, msg.Hash) - require.NoError(t, err) - require.Len(t, votes, 0) - - // returns an error for the invalid epoch - _, err = s.state.StateSyncStore.getMessageVotes(1, msg.Hash) - require.Error(t, err) - }) - - t.Run("Sender and signature mismatch", func(t *testing.T) { - t.Parallel() - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - s.validatorSet = vals.ToValidatorSet() - - // validator signs the msg in behalf of another validator - val := newMockMsg() - msg, err := val.sign(vals.GetValidator("0"), signer.DomainStateReceiver) - require.NoError(t, err) - - msg.From = vals.GetValidator("1").Address().String() - require.Error(t, s.saveVote(msg)) - - // non validator signs the msg in behalf of a validator - badVal := validator.NewTestValidator(t, "a", 0) - msg, err = newMockMsg().sign(badVal, signer.DomainStateReceiver) - require.NoError(t, err) - - msg.From = vals.GetValidator("1").Address().String() - require.Error(t, s.saveVote(msg)) - }) - - t.Run("Sender votes", func(t *testing.T) { - t.Parallel() - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - s.validatorSet = vals.ToValidatorSet() - - msg := newMockMsg() - val1signed, err := msg.sign(vals.GetValidator("1"), signer.DomainStateReceiver) - require.NoError(t, err) - - val2signed, err := msg.sign(vals.GetValidator("2"), signer.DomainStateReceiver) - require.NoError(t, err) - - // vote with validator 1 - require.NoError(t, s.saveVote(val1signed)) - - votes, err := s.state.StateSyncStore.getMessageVotes(0, msg.hash) - require.NoError(t, err) - require.Len(t, votes, 1) - - // vote with validator 1 again (the votes do not increase) - require.NoError(t, s.saveVote(val1signed)) - votes, _ = s.state.StateSyncStore.getMessageVotes(0, msg.hash) - require.Len(t, votes, 1) - - // vote with validator 2 - require.NoError(t, s.saveVote(val2signed)) - votes, _ = s.state.StateSyncStore.getMessageVotes(0, msg.hash) - require.Len(t, votes, 2) - }) -} - -func TestStateSyncManager_BuildCommitment(t *testing.T) { - vals := validator.NewTestValidators(t, 5) - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - s.validatorSet = vals.ToValidatorSet() - - // commitment is empty - commitment, err := s.Commitment(1) - require.NoError(t, err) - require.Nil(t, commitment) - - tree, err := merkle.NewMerkleTree([][]byte{{0x1}}) - require.NoError(t, err) - - s.pendingCommitments = []*PendingCommitment{ - { - MerkleTree: tree, - StateSyncCommitment: &contractsapi.StateSyncCommitment{ - Root: tree.Hash(), - StartID: big.NewInt(0), - EndID: big.NewInt(1), - }, - }, - } - - hash, err := s.pendingCommitments[0].Hash() - require.NoError(t, err) - - msg := newMockMsg().WithHash(hash.Bytes()) - - // validators 0 and 1 vote for the proposal, there is not enough - // voting power for the proposal - signedMsg1, err := msg.sign(vals.GetValidator("0"), signer.DomainStateReceiver) - require.NoError(t, err) - - signedMsg2, err := msg.sign(vals.GetValidator("1"), signer.DomainStateReceiver) - require.NoError(t, err) - - require.NoError(t, s.saveVote(signedMsg1)) - require.NoError(t, s.saveVote(signedMsg2)) - - commitment, err = s.Commitment(1) - require.NoError(t, err) // there is no error if quorum is not met, since its a valid case - require.Nil(t, commitment) - - // validator 2 and 3 vote for the proposal, there is enough voting power now - - signedMsg1, err = msg.sign(vals.GetValidator("2"), signer.DomainStateReceiver) - require.NoError(t, err) - - signedMsg2, err = msg.sign(vals.GetValidator("3"), signer.DomainStateReceiver) - require.NoError(t, err) - - require.NoError(t, s.saveVote(signedMsg1)) - require.NoError(t, s.saveVote(signedMsg2)) - - commitment, err = s.Commitment(1) - require.NoError(t, err) - require.NotNil(t, commitment) -} - -func TestStateSyncerManager_BuildProofs(t *testing.T) { - vals := validator.NewTestValidators(t, 5) - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - - for _, evnt := range generateStateSyncEvents(t, 20, 0) { - require.NoError(t, s.state.StateSyncStore.insertStateSyncEvent(evnt)) - } - - require.NoError(t, s.buildCommitment(nil)) - require.Len(t, s.pendingCommitments, 1) - - mockMsg := &CommitmentMessageSigned{ - Message: &contractsapi.StateSyncCommitment{ - StartID: s.pendingCommitments[0].StartID, - EndID: s.pendingCommitments[0].EndID, - }, - } - - txData, err := mockMsg.EncodeAbi() - require.NoError(t, err) - - tx := createStateTransactionWithData(1, types.Address{}, txData) - - req := &PostBlockRequest{ - FullBlock: &types.FullBlock{ - Block: &types.Block{ - Transactions: []*types.Transaction{tx}, - }, - }, - } - - require.NoError(t, s.PostBlock(req)) - require.Equal(t, mockMsg.Message.EndID.Uint64()+1, s.nextCommittedIndex) - - for i := uint64(0); i < 10; i++ { - proof, err := s.state.StateSyncStore.getStateSyncProof(i) - require.NoError(t, err) - require.NotNil(t, proof) - } -} - -func TestStateSyncerManager_RemoveProcessedEventsAndProofs(t *testing.T) { - const stateSyncEventsCount = 5 - - vals := validator.NewTestValidators(t, 5) - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - stateSyncEvents := generateStateSyncEvents(t, stateSyncEventsCount, 0) - - for _, event := range stateSyncEvents { - require.NoError(t, s.state.StateSyncStore.insertStateSyncEvent(event)) - } - - require.NoError(t, s.buildProofs(&contractsapi.StateSyncCommitment{ - StartID: stateSyncEvents[0].ID, - EndID: stateSyncEvents[len(stateSyncEvents)-1].ID, - }, nil)) - - stateSyncEventsBefore, err := s.state.StateSyncStore.list() - require.NoError(t, err) - require.Equal(t, stateSyncEventsCount, len(stateSyncEventsBefore)) - - for _, event := range stateSyncEvents { - proof, err := s.state.StateSyncStore.getStateSyncProof(event.ID.Uint64()) - require.NoError(t, err) - require.NotNil(t, proof) - } - - for _, event := range stateSyncEvents { - eventLog := createTestLogForStateSyncResultEvent(t, event.ID.Uint64()) - require.NoError(t, s.ProcessLog(&types.Header{Number: 10}, convertLog(eventLog), nil)) - } - - // all state sync events and their proofs should be removed from the store - stateSyncEventsAfter, err := s.state.StateSyncStore.list() - require.NoError(t, err) - require.Equal(t, 0, len(stateSyncEventsAfter)) - - for _, event := range stateSyncEvents { - proof, err := s.state.StateSyncStore.getStateSyncProof(event.ID.Uint64()) - require.NoError(t, err) - require.Nil(t, proof) - } -} - -func TestStateSyncerManager_AddLog_BuildCommitments(t *testing.T) { - t.Parallel() - - vals := validator.NewTestValidators(t, 5) - - t.Run("Node is a validator", func(t *testing.T) { - t.Parallel() - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - - // empty log which is not an state sync - require.NoError(t, s.AddLog(ðgo.Log{})) - stateSyncs, err := s.state.StateSyncStore.list() - - require.NoError(t, err) - require.Len(t, stateSyncs, 0) - - var stateSyncedEvent contractsapi.StateSyncedEvent - - stateSyncEventID := stateSyncedEvent.Sig() - - // log with the state sync topic but incorrect content - require.Error(t, s.AddLog(ðgo.Log{Topics: []ethgo.Hash{stateSyncEventID}})) - stateSyncs, err = s.state.StateSyncStore.list() - - require.NoError(t, err) - require.Len(t, stateSyncs, 0) - - // correct event log - data, err := abi.MustNewType("tuple(string a)").Encode([]string{"data"}) - require.NoError(t, err) - - goodLog := ðgo.Log{ - Topics: []ethgo.Hash{ - stateSyncEventID, - ethgo.BytesToHash([]byte{0x0}), // state sync index 0 - ethgo.ZeroHash, - ethgo.ZeroHash, - }, - Data: data, - } - - require.NoError(t, s.AddLog(goodLog)) - - stateSyncs, err = s.state.StateSyncStore.getStateSyncEventsForCommitment(0, 0, nil) - require.NoError(t, err) - require.Len(t, stateSyncs, 1) - require.Len(t, s.pendingCommitments, 1) - require.Equal(t, uint64(0), s.pendingCommitments[0].StartID.Uint64()) - require.Equal(t, uint64(0), s.pendingCommitments[0].EndID.Uint64()) - - // add one more log to have a minimum commitment - goodLog2 := goodLog.Copy() - goodLog2.Topics[1] = ethgo.BytesToHash([]byte{0x1}) // state sync index 1 - require.NoError(t, s.AddLog(goodLog2)) - - require.Len(t, s.pendingCommitments, 2) - require.Equal(t, uint64(0), s.pendingCommitments[1].StartID.Uint64()) - require.Equal(t, uint64(1), s.pendingCommitments[1].EndID.Uint64()) - - // add two more logs to have larger commitments - goodLog3 := goodLog.Copy() - goodLog3.Topics[1] = ethgo.BytesToHash([]byte{0x2}) // state sync index 2 - require.NoError(t, s.AddLog(goodLog3)) - - goodLog4 := goodLog.Copy() - goodLog4.Topics[1] = ethgo.BytesToHash([]byte{0x3}) // state sync index 3 - require.NoError(t, s.AddLog(goodLog4)) - - require.Len(t, s.pendingCommitments, 4) - require.Equal(t, uint64(0), s.pendingCommitments[3].StartID.Uint64()) - require.Equal(t, uint64(3), s.pendingCommitments[3].EndID.Uint64()) - }) - - t.Run("Node is not a validator", func(t *testing.T) { - t.Parallel() - - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: false}) - - // correct event log - data, err := abi.MustNewType("tuple(string a)").Encode([]string{"data"}) - require.NoError(t, err) - - var stateSyncedEvent contractsapi.StateSyncedEvent - - goodLog := ðgo.Log{ - Topics: []ethgo.Hash{ - stateSyncedEvent.Sig(), - ethgo.BytesToHash([]byte{0x0}), // state sync index 0 - ethgo.ZeroHash, - ethgo.ZeroHash, - }, - Data: data, - } - - require.NoError(t, s.AddLog(goodLog)) - - // node should have inserted given state sync event, but it shouldn't build any commitment - stateSyncs, err := s.state.StateSyncStore.getStateSyncEventsForCommitment(0, 0, nil) - require.NoError(t, err) - require.Len(t, stateSyncs, 1) - require.Equal(t, uint64(0), stateSyncs[0].ID.Uint64()) - require.Len(t, s.pendingCommitments, 0) - }) -} - -func TestStateSyncerManager_EventTracker_Sync(t *testing.T) { - t.Parallel() - - vals := validator.NewTestValidators(t, 5) - s := newTestStateSyncManager(t, vals.GetValidator("0"), &mockRuntime{isActiveValidator: true}) - - server := testutil.DeployTestServer(t, nil) - - // Deploy contract - contractReceipt, err := server.SendTxn(ðgo.Transaction{ - Input: contractsapi.StateSender.Bytecode, - }) - require.NoError(t, err) - - // Create contract function call payload - encodedSyncStateData, err := (&contractsapi.SyncStateStateSenderFn{ - Receiver: types.BytesToAddress(server.Account(0).Bytes()), - Data: []byte{}, - }).EncodeAbi() - require.NoError(t, err) - - // prefill with 10 events - for i := 0; i < 10; i++ { - receipt, err := server.SendTxn(ðgo.Transaction{ - To: &contractReceipt.ContractAddress, - Input: encodedSyncStateData, - }) - require.NoError(t, err) - require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) - } - - s.config.stateSenderAddr = types.Address(contractReceipt.ContractAddress) - s.config.jsonrpcAddr = server.HTTPAddr() - - require.NoError(t, s.initTracker()) - - time.Sleep(2 * time.Second) - - events, err := s.state.StateSyncStore.getStateSyncEventsForCommitment(1, 10, nil) - require.NoError(t, err) - require.Len(t, events, 10) -} - -func TestStateSyncManager_Close(t *testing.T) { - t.Parallel() - - mgr := newTestStateSyncManager(t, validator.NewTestValidator(t, "A", 100), &mockRuntime{isActiveValidator: true}) - require.NotPanics(t, func() { mgr.Close() }) -} - -func TestStateSyncManager_GetProofs(t *testing.T) { - t.Parallel() - - const ( - stateSyncID = uint64(5) - ) - - state := newTestState(t) - insertTestStateSyncProofs(t, state, maxCommitmentSize) - - stateSyncManager := &stateSyncManager{state: state} - - proof, err := stateSyncManager.GetStateSyncProof(stateSyncID) - require.NoError(t, err) - - stateSync, ok := (proof.Metadata["StateSync"]).(*contractsapi.StateSyncedEvent) - require.True(t, ok) - require.Equal(t, stateSyncID, stateSync.ID.Uint64()) - require.NotEmpty(t, proof.Data) -} - -func TestStateSyncManager_GetProofs_NoProof_NoCommitment(t *testing.T) { - t.Parallel() - - const ( - stateSyncID = uint64(5) - ) - - stateSyncManager := &stateSyncManager{state: newTestState(t)} - - _, err := stateSyncManager.GetStateSyncProof(stateSyncID) - require.ErrorContains(t, err, "cannot find commitment for StateSync id") -} - -func TestStateSyncManager_GetProofs_NoProof_HasCommitment_NoStateSyncs(t *testing.T) { - t.Parallel() - - const ( - stateSyncID = uint64(5) - ) - - state := newTestState(t) - require.NoError(t, state.StateSyncStore.insertCommitmentMessage(createTestCommitmentMessage(t, 1), nil)) - - stateSyncManager := &stateSyncManager{state: state, logger: hclog.NewNullLogger()} - - _, err := stateSyncManager.GetStateSyncProof(stateSyncID) - require.ErrorContains(t, err, "failed to get state sync events for commitment to build proofs") -} - -func TestStateSyncManager_GetProofs_NoProof_BuildProofs(t *testing.T) { - t.Parallel() - - const ( - stateSyncID = uint64(5) - fromIndex = 1 - ) - - state := newTestState(t) - stateSyncs := generateStateSyncEvents(t, maxCommitmentSize, fromIndex) - - tree, err := createMerkleTree(stateSyncs) - require.NoError(t, err) - - commitment := &CommitmentMessageSigned{ - Message: &contractsapi.StateSyncCommitment{ - StartID: big.NewInt(fromIndex), - EndID: big.NewInt(maxCommitmentSize), - Root: tree.Hash(), - }, - } - - for _, sse := range stateSyncs { - require.NoError(t, state.StateSyncStore.insertStateSyncEvent(sse)) - } - - require.NoError(t, state.StateSyncStore.insertCommitmentMessage(commitment, nil)) - - stateSyncManager := &stateSyncManager{state: state, logger: hclog.NewNullLogger()} - - proof, err := stateSyncManager.GetStateSyncProof(stateSyncID) - require.NoError(t, err) - - stateSync, ok := (proof.Metadata["StateSync"]).(*contractsapi.StateSyncedEvent) - require.True(t, ok) - require.Equal(t, stateSyncID, stateSync.ID.Uint64()) - require.NotEmpty(t, proof.Data) - - require.NoError(t, commitment.VerifyStateSyncProof(proof.Data, stateSync)) -} - -func createTestLogForStateSyncResultEvent(t *testing.T, stateSyncEventID uint64) *types.Log { - t.Helper() - - var stateSyncResultEvent contractsapi.StateSyncResultEvent - - topics := make([]types.Hash, 3) - topics[0] = types.Hash(stateSyncResultEvent.Sig()) - topics[1] = types.BytesToHash(common.EncodeUint64ToBytes(stateSyncEventID)) - topics[2] = types.BytesToHash(common.EncodeUint64ToBytes(1)) // Status = true - someType := abi.MustNewType("tuple(string field1, string field2)") - encodedData, err := someType.Encode(map[string]string{"field1": "value1", "field2": "value2"}) - require.NoError(t, err) - - return &types.Log{ - Address: contracts.StateReceiverContract, - Topics: topics, - Data: encodedData, - } -} - -type mockTopic struct { - published proto.Message -} - -func (m *mockTopic) consume() proto.Message { - msg := m.published - - if m.published != nil { - m.published = nil - } - - return msg -} - -func (m *mockTopic) Publish(obj proto.Message) error { - m.published = obj - - return nil -} - -func (m *mockTopic) Subscribe(handler func(obj interface{}, from peer.ID)) error { - return nil -} - -type mockMsg struct { - hash []byte - epoch uint64 -} - -func newMockMsg() *mockMsg { - hash := make([]byte, 32) - rand.Read(hash) - - return &mockMsg{hash: hash} -} - -func (m *mockMsg) WithHash(hash []byte) *mockMsg { - m.hash = hash - - return m -} - -func (m *mockMsg) sign(val *validator.TestValidator, domain []byte) (*TransportMessage, error) { - signature, err := val.MustSign(m.hash, domain).Marshal() - if err != nil { - return nil, err - } - - return &TransportMessage{ - Hash: m.hash, - Signature: signature, - From: val.Address().String(), - EpochNumber: m.epoch, - }, nil -} - -type mockRuntime struct { - isActiveValidator bool -} - -func (m *mockRuntime) IsActiveValidator() bool { - return m.isActiveValidator -} diff --git a/consensus/polybft/state_sync_relayer.go b/consensus/polybft/state_sync_relayer.go deleted file mode 100644 index 863eb6b..0000000 --- a/consensus/polybft/state_sync_relayer.go +++ /dev/null @@ -1,347 +0,0 @@ -package polybft - -import ( - "encoding/json" - "errors" - "fmt" - "net" - "strings" - - "github.com/hashicorp/go-hclog" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" -) - -const ( - // defaultMaxBlocksToWaitForResend specifies how many blocks should be wait - // in order to try again to send transaction - defaultMaxBlocksToWaitForResend = uint64(30) - // defaultMaxAttemptsToSend specifies how many sending retries for one transaction - defaultMaxAttemptsToSend = uint64(15) - // defaultMaxEventsPerBatch specifies maximum events per one batchExecute tx - defaultMaxEventsPerBatch = uint64(10) -) - -var ( - errFailedToExecuteStateSync = errors.New("failed to execute state sync") - errUnknownStateSyncRelayerEvent = errors.New("unknown event") - - commitmentEventSignature = new(contractsapi.NewCommitmentEvent).Sig() - stateSyncResultEventSignature = new(contractsapi.StateSyncResultEvent).Sig() -) - -// StateSyncRelayer is an interface that defines functions for state sync relayer -type StateSyncRelayer interface { - EventSubscriber - PostBlock(req *PostBlockRequest) error - Init() error - Close() -} - -// stateSyncProofRetriever is an interface that exposes function for retrieving state sync proof -type stateSyncProofRetriever interface { - GetStateSyncProof(stateSyncID uint64) (types.Proof, error) -} - -var _ StateSyncRelayer = (*dummyStateSyncRelayer)(nil) - -// dummyStateSyncRelayer is a dummy implementation of a StateSyncRelayer -type dummyStateSyncRelayer struct{} - -func (d *dummyStateSyncRelayer) PostBlock(req *PostBlockRequest) error { return nil } - -func (d *dummyStateSyncRelayer) Init() error { return nil } -func (d *dummyStateSyncRelayer) Close() {} - -// EventSubscriber implementation -func (d *dummyStateSyncRelayer) GetLogFilters() map[types.Address][]types.Hash { - return make(map[types.Address][]types.Hash) -} -func (d *dummyStateSyncRelayer) ProcessLog(header *types.Header, log *ethgo.Log, dbTx *bolt.Tx) error { - return nil -} - -var _ StateSyncRelayer = (*stateSyncRelayerImpl)(nil) - -// StateSyncRelayerEventData keeps information about an event -type StateSyncRelayerEventData struct { - EventID uint64 `json:"eventID"` - CountTries uint64 `json:"countTries"` - BlockNumber uint64 `json:"blockNumber"` // block when state sync is sent - SentStatus bool `json:"sentStatus"` -} - -func (ed StateSyncRelayerEventData) String() string { - return fmt.Sprintf("%d", ed.EventID) -} - -type stateSyncRelayerConfig struct { - maxBlocksToWaitForResend uint64 - maxAttemptsToSend uint64 - maxEventsPerBatch uint64 -} - -type stateSyncRelayerImpl struct { - txRelayer txrelayer.TxRelayer - key ethgo.Key - proofRetriever stateSyncProofRetriever - state *StateSyncStore - logger hclog.Logger - blockchain blockchainBackend - - notifyCh chan struct{} - closeCh chan struct{} - - config *stateSyncRelayerConfig -} - -func NewStateSyncRelayer( - txRelayer txrelayer.TxRelayer, - stateReceiverAddr types.Address, - state *StateSyncStore, - store stateSyncProofRetriever, - blockchain blockchainBackend, - key ethgo.Key, - config *stateSyncRelayerConfig, - logger hclog.Logger, -) *stateSyncRelayerImpl { - if config == nil { - config = &stateSyncRelayerConfig{ - maxBlocksToWaitForResend: defaultMaxBlocksToWaitForResend, - maxAttemptsToSend: defaultMaxAttemptsToSend, - maxEventsPerBatch: defaultMaxEventsPerBatch, - } - } - - return &stateSyncRelayerImpl{ - txRelayer: txRelayer, - key: key, - proofRetriever: store, - state: state, - closeCh: make(chan struct{}), - notifyCh: make(chan struct{}, 1), - blockchain: blockchain, - config: config, - logger: logger, - } -} - -func (ssr *stateSyncRelayerImpl) Init() error { - // start consumer - go func() { - for { - select { - case <-ssr.closeCh: - return - case <-ssr.notifyCh: - ssr.processEvents() - } - } - }() - - return nil -} - -func (ssr *stateSyncRelayerImpl) Close() { - close(ssr.closeCh) -} - -func (ssr *stateSyncRelayerImpl) PostBlock(req *PostBlockRequest) error { - select { - case ssr.notifyCh <- struct{}{}: - default: - } - - return nil -} - -func (ssr *stateSyncRelayerImpl) processEvents() { - // we need twice as batch size because events from first batch are possible already sent maxAttemptsToSend times - events, err := ssr.state.getAllAvailableEvents(int(ssr.config.maxEventsPerBatch) * 2) - if err != nil { - ssr.logger.Error("retrieving events failed", "err", err) - - return - } - - removedEventIDs := []uint64{} - sendingEvents := []*StateSyncRelayerEventData{} - currentBlockNumber := ssr.blockchain.CurrentHeader().Number - - // check already processed events - for _, evnt := range events { - // quit if we are still waiting for some old event confirmation (there is no paralelization right now!) - if evnt.SentStatus && evnt.BlockNumber+ssr.config.maxBlocksToWaitForResend > currentBlockNumber { - return - } - - // remove event if it is processed too many times - if evnt.CountTries+1 > ssr.config.maxAttemptsToSend { - removedEventIDs = append(removedEventIDs, evnt.EventID) - } else { - evnt.CountTries++ - evnt.BlockNumber = currentBlockNumber - evnt.SentStatus = true - - sendingEvents = append(sendingEvents, evnt) - if len(sendingEvents) == int(ssr.config.maxEventsPerBatch) { - break - } - } - } - - // update state only if needed - if len(sendingEvents)+len(removedEventIDs) > 0 { - ssr.logger.Info("sending events", "events", sendingEvents, "removed", removedEventIDs) - - if err := ssr.state.updateStateSyncRelayerEvents(sendingEvents, removedEventIDs, nil); err != nil { - ssr.logger.Error("updating events failed", - "events", sendingEvents, "removed", removedEventIDs, "err", err) - - return - } - } - - // send tx only if needed - if len(sendingEvents) > 0 { - if err := ssr.sendTx(sendingEvents); err != nil { - ssr.logger.Error("failed to send tx", "block", currentBlockNumber, "events", sendingEvents, "err", err) - } else { - ssr.logger.Info("tx has been successfully sent", "block", currentBlockNumber, "events", sendingEvents) - } - } -} - -func (ssr *stateSyncRelayerImpl) sendTx(events []*StateSyncRelayerEventData) error { - proofs := make([][]types.Hash, len(events)) - objs := make([]*contractsapi.StateSync, len(events)) - - for i, event := range events { - proof, err := ssr.proofRetriever.GetStateSyncProof(event.EventID) - if err != nil { - return fmt.Errorf("failed to get proof for %d: %w", event.EventID, err) - } - - // since state sync event is a map in the jsonrpc response, - // to not have custom logic of converting the map to state sync event - // json encoding is used, since it manages to successfully unmarshal the - // event from the marshaled map - raw, err := json.Marshal(proof.Metadata["StateSync"]) - if err != nil { - return fmt.Errorf("failed to marshal event %d: %w", event.EventID, err) - } - - if err = json.Unmarshal(raw, &objs[i]); err != nil { - return fmt.Errorf("failed to unmarshal event %d: %w", event.EventID, err) - } - - proofs[i] = proof.Data - } - - input, err := (&contractsapi.BatchExecuteStateReceiverFn{ - Proofs: proofs, - Objs: objs, - }).EncodeAbi() - if err != nil { - return err - } - - // send batchExecute state sync - _, err = ssr.txRelayer.SendTransaction(ðgo.Transaction{ - From: ssr.key.Address(), - To: (*ethgo.Address)(&contracts.StateReceiverContract), - Gas: types.StateTransactionGasLimit, - Input: input, - }, ssr.key) - - return err -} - -// EventSubscriber implementation - -// GetLogFilters returns a map of log filters for getting desired events, -// where the key is the address of contract that emits desired events, -// and the value is a slice of signatures of events we want to get. -// This function is the implementation of EventSubscriber interface -func (ssr *stateSyncRelayerImpl) GetLogFilters() map[types.Address][]types.Hash { - var ( - stateSyncResultEvent contractsapi.StateSyncResultEvent - newCommitmentEvent contractsapi.NewCommitmentEvent - ) - - return map[types.Address][]types.Hash{ - contracts.StateReceiverContract: { - types.Hash(stateSyncResultEvent.Sig()), - types.Hash(newCommitmentEvent.Sig()), - }, - } -} - -// ProcessLog is the implementation of EventSubscriber interface, -// used to handle a log defined in GetLogFilters, provided by event provider -func (ssr *stateSyncRelayerImpl) ProcessLog(header *types.Header, log *ethgo.Log, dbTx *bolt.Tx) error { - var ( - commitEvent contractsapi.NewCommitmentEvent - stateSyncResultEvent contractsapi.StateSyncResultEvent - ) - - switch log.Topics[0] { - case commitmentEventSignature: - _, err := commitEvent.ParseLog(log) - if err != nil { - return err - } - - firstID, lastID := commitEvent.StartID.Uint64(), commitEvent.EndID.Uint64() - newEvents := make([]*StateSyncRelayerEventData, lastID-firstID+1) - - for eventID := firstID; eventID <= lastID; eventID++ { - newEvents[eventID-firstID] = &StateSyncRelayerEventData{EventID: eventID} - } - - ssr.logger.Info("new events has been arrived", "block", header.Number, "events", newEvents) - - return ssr.state.updateStateSyncRelayerEvents(newEvents, nil, dbTx) - - case stateSyncResultEventSignature: - _, err := stateSyncResultEvent.ParseLog(log) - if err != nil { - return err - } - - eventID := stateSyncResultEvent.Counter.Uint64() - - if stateSyncResultEvent.Status { - ssr.logger.Info("event has been processed", "block", header.Number, "event", eventID) - - return ssr.state.updateStateSyncRelayerEvents(nil, []uint64{eventID}, dbTx) - } - - ssr.logger.Info("event has been failed to process", "block", header.Number, - "event", eventID, "reason", string(stateSyncResultEvent.Message)) - - return nil - - default: - return errUnknownStateSyncRelayerEvent - } -} - -func getStateSyncTxRelayer(rpcEndpoint string, logger hclog.Logger) (txrelayer.TxRelayer, error) { - if rpcEndpoint == "" || strings.Contains(rpcEndpoint, "0.0.0.0") { - _, port, err := net.SplitHostPort(rpcEndpoint) - if err == nil { - rpcEndpoint = fmt.Sprintf("http://%s:%s", "127.0.0.1", port) - } else { - rpcEndpoint = txrelayer.DefaultRPCAddress - } - } - - return txrelayer.NewTxRelayer( - txrelayer.WithIPAddress(rpcEndpoint), txrelayer.WithNumRetries(-1), - txrelayer.WithWriter(logger.StandardWriter(&hclog.StandardLoggerOptions{}))) -} diff --git a/consensus/polybft/state_sync_relayer_test.go b/consensus/polybft/state_sync_relayer_test.go deleted file mode 100644 index 11ecee4..0000000 --- a/consensus/polybft/state_sync_relayer_test.go +++ /dev/null @@ -1,203 +0,0 @@ -package polybft - -import ( - "errors" - "math/big" - "testing" - "time" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/types" -) - -func TestStateSyncRelayer_FullWorkflow(t *testing.T) { - t.Parallel() - - testKey := createTestKey(t) - stateSyncAddr := types.StringToAddress("0x56563") - - resultLogs := []*types.Log{ - createTestLogForStateSyncResultEvent(t, 1), createTestLogForStateSyncResultEvent(t, 2), - createTestLogForStateSyncResultEvent(t, 3), createTestLogForStateSyncResultEvent(t, 4), - createTestLogForStateSyncResultEvent(t, 5), - } - commitmentLogs := []*types.Log{ - createTestLogForNewCommitmentEvent(t, stateSyncAddr, 1, 1, types.StringToHash("0x2")), - createTestLogForNewCommitmentEvent(t, stateSyncAddr, 2, 3, types.StringToHash("0x2")), - createTestLogForNewCommitmentEvent(t, stateSyncAddr, 4, 5, types.StringToHash("0x2")), - } - - headers := []*types.Header{ - {Number: 2}, {Number: 3}, {Number: 4}, {Number: 5}, {Number: 5}, - } - - proofMock := &mockStateSyncProofRetriever{ - fn: func(stateSyncID uint64) (types.Proof, error) { - return types.Proof{ - Data: []types.Hash{types.StringToHash("0x1122334455")}, - Metadata: map[string]interface{}{ - "StateSync": map[string]interface{}{ - "ID": stateSyncID, - "Sender": types.StringToAddress("0xffee"), - "Receiver": types.StringToAddress("0xeeff"), - "Data": nil, - }, - }, - }, nil - }, - } - blockhainMock := &blockchainMock{} - dummyTxRelayer := newDummyStakeTxRelayer(t, nil) - state := newTestState(t) - - stateSyncRelayer := NewStateSyncRelayer( - dummyTxRelayer, - stateSyncAddr, - state.StateSyncStore, - proofMock, - blockhainMock, - testKey, - &stateSyncRelayerConfig{ - maxAttemptsToSend: 6, - maxBlocksToWaitForResend: 1, - maxEventsPerBatch: 1, - }, - hclog.Default(), - ) - - for _, h := range headers { - blockhainMock.On("CurrentHeader").Return(h).Once() - } - - // send first two events without errors - dummyTxRelayer.On("SendTransaction", mock.Anything, testKey).Return((*ethgo.Receipt)(nil), nil).Times(2) - // fail 3rd time - dummyTxRelayer.On("SendTransaction", mock.Anything, testKey).Return( - (*ethgo.Receipt)(nil), errors.New("e")).Once() - // send 3 events all at once at the end - dummyTxRelayer.On("SendTransaction", mock.Anything, testKey).Return((*ethgo.Receipt)(nil), nil).Once() - - require.NoError(t, stateSyncRelayer.Init()) - - // post 1st block - require.NoError(t, stateSyncRelayer.ProcessLog(headers[0], convertLog(commitmentLogs[0]), nil)) - require.NoError(t, stateSyncRelayer.ProcessLog(headers[0], convertLog(commitmentLogs[1]), nil)) - require.NoError(t, stateSyncRelayer.PostBlock(&PostBlockRequest{})) - - time.Sleep(time.Second * 2) // wait for some time - - events, err := state.StateSyncStore.getAllAvailableEvents(0) - - require.NoError(t, err) - require.Len(t, events, 3) - require.Equal(t, uint64(1), events[0].EventID) - require.True(t, events[0].SentStatus) - require.False(t, events[1].SentStatus) - require.False(t, events[2].SentStatus) - - // post 2nd block - require.NoError(t, stateSyncRelayer.ProcessLog(headers[1], convertLog(resultLogs[0]), nil)) - require.NoError(t, stateSyncRelayer.ProcessLog(headers[1], convertLog(commitmentLogs[2]), nil)) - require.NoError(t, stateSyncRelayer.PostBlock(&PostBlockRequest{})) - - time.Sleep(time.Second * 2) // wait for some time - - events, err = state.StateSyncStore.getAllAvailableEvents(0) - - require.NoError(t, err) - require.Len(t, events, 4) - require.True(t, events[0].SentStatus) - require.Equal(t, uint64(2), events[0].EventID) - require.False(t, events[1].SentStatus) - require.False(t, events[2].SentStatus) - - // post 3rd block - require.NoError(t, stateSyncRelayer.ProcessLog(headers[2], convertLog(resultLogs[1]), nil)) - require.NoError(t, stateSyncRelayer.PostBlock(&PostBlockRequest{})) - - time.Sleep(time.Second * 2) // wait for some time - - events, err = state.StateSyncStore.getAllAvailableEvents(0) - - require.NoError(t, err) - require.Len(t, events, 3) - require.True(t, events[0].SentStatus) - require.Equal(t, uint64(3), events[0].EventID) - require.False(t, events[1].SentStatus) - - // post 4th block - will not provide result, so one more SendTransaction will be triggered - stateSyncRelayer.config.maxEventsPerBatch = 3 // send all 3 left events at once - - require.NoError(t, stateSyncRelayer.PostBlock(&PostBlockRequest{})) - - time.Sleep(time.Second * 2) // wait for some time - - events, err = state.StateSyncStore.getAllAvailableEvents(0) - - require.NoError(t, err) - require.Len(t, events, 3) - require.True(t, events[0].SentStatus && events[1].SentStatus && events[2].SentStatus) - - // post 5th block - require.NoError(t, stateSyncRelayer.ProcessLog(headers[4], convertLog(resultLogs[2]), nil)) - require.NoError(t, stateSyncRelayer.ProcessLog(headers[4], convertLog(resultLogs[3]), nil)) - require.NoError(t, stateSyncRelayer.ProcessLog(headers[4], convertLog(resultLogs[4]), nil)) - require.NoError(t, stateSyncRelayer.PostBlock(&PostBlockRequest{})) - - time.Sleep(time.Second * 2) // wait for some time - - events, err = state.StateSyncStore.getAllAvailableEvents(0) - - require.NoError(t, err) - require.Len(t, events, 0) - - stateSyncRelayer.Close() - time.Sleep(time.Second) - - blockhainMock.AssertExpectations(t) - dummyTxRelayer.AssertExpectations(t) -} - -type mockStateSyncProofRetriever struct { - fn func(uint64) (types.Proof, error) -} - -func (m *mockStateSyncProofRetriever) GetStateSyncProof(stateSyncID uint64) (types.Proof, error) { - if m.fn != nil { - return m.fn(stateSyncID) - } - - return types.Proof{}, nil -} - -func createTestLogForNewCommitmentEvent( - t *testing.T, - stateSyncAddr types.Address, - startEventID uint64, - endEventID uint64, - rootHash types.Hash) *types.Log { - t.Helper() - - var evnt contractsapi.NewCommitmentEvent - - encodedData1, err := abi.MustNewType("uint256").Encode(new(big.Int).SetUint64(startEventID)) - require.NoError(t, err) - - encodedData2, err := abi.MustNewType("uint256").Encode(new(big.Int).SetUint64(endEventID)) - require.NoError(t, err) - - return &types.Log{ - Address: stateSyncAddr, - Topics: []types.Hash{ - types.Hash(evnt.Sig()), - types.BytesToHash(encodedData1), - types.BytesToHash(encodedData2), - }, - Data: rootHash[:], - } -} diff --git a/consensus/polybft/state_transaction.go b/consensus/polybft/state_transaction.go deleted file mode 100644 index 48ff64e..0000000 --- a/consensus/polybft/state_transaction.go +++ /dev/null @@ -1,44 +0,0 @@ -package polybft - -import ( - "bytes" - "fmt" - - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" -) - -const abiMethodIDLength = 4 - -func decodeStateTransaction(txData []byte) (contractsapi.StateTransactionInput, error) { - if len(txData) < abiMethodIDLength { - return nil, fmt.Errorf("state transactions have input") - } - - sig := txData[:abiMethodIDLength] - - var ( - commitFn contractsapi.CommitStateReceiverFn - commitEpochFn contractsapi.CommitEpochValidatorSetFn - distributeRewardsFn contractsapi.DistributeRewardForRewardPoolFn - obj contractsapi.StateTransactionInput - ) - - if bytes.Equal(sig, commitFn.Sig()) { - // bridge commitment - obj = &CommitmentMessageSigned{} - } else if bytes.Equal(sig, commitEpochFn.Sig()) { - // commit epoch - obj = &contractsapi.CommitEpochValidatorSetFn{} - } else if bytes.Equal(sig, distributeRewardsFn.Sig()) { - // distribute rewards - obj = &contractsapi.DistributeRewardForRewardPoolFn{} - } else { - return nil, fmt.Errorf("unknown state transaction") - } - - if err := obj.DecodeAbi(txData); err != nil { - return nil, err - } - - return obj, nil -} diff --git a/consensus/polybft/state_transaction_test.go b/consensus/polybft/state_transaction_test.go deleted file mode 100644 index 4e6ca9e..0000000 --- a/consensus/polybft/state_transaction_test.go +++ /dev/null @@ -1,63 +0,0 @@ -package polybft - -import ( - "encoding/hex" - "math/big" - "reflect" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo/abi" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/types" -) - -func TestStateTransaction_Signature(t *testing.T) { - t.Parallel() - - cases := []struct { - m *abi.Method - sig string - }{ - { - contractsapi.ValidatorSet.Abi.GetMethod("commitEpoch"), - "0f50287c", - }, - } - for _, c := range cases { - sig := hex.EncodeToString(c.m.ID()) - require.Equal(t, c.sig, sig) - } -} - -func TestStateTransaction_Encoding(t *testing.T) { - t.Parallel() - - cases := []contractsapi.StateTransactionInput{ - &contractsapi.CommitEpochValidatorSetFn{ - ID: big.NewInt(1), - Epoch: &contractsapi.Epoch{ - StartBlock: big.NewInt(1), - EndBlock: big.NewInt(10), - EpochRoot: types.Hash{}, - }, - }, - } - - for _, c := range cases { - res, err := c.EncodeAbi() - - require.NoError(t, err) - - // use reflection to create another type and decode - val := reflect.New(reflect.TypeOf(c).Elem()).Interface() - obj, ok := val.(contractsapi.StateTransactionInput) - assert.True(t, ok) - - err = obj.DecodeAbi(res) - require.NoError(t, err) - - require.Equal(t, obj, c) - } -} diff --git a/consensus/polybft/stats.go b/consensus/polybft/stats.go deleted file mode 100644 index bd3d254..0000000 --- a/consensus/polybft/stats.go +++ /dev/null @@ -1,210 +0,0 @@ -package polybft - -import ( - "math/big" - "time" - - "github.com/armon/go-metrics" - "github.com/hashicorp/go-hclog" - "github.com/prometheus/client_golang/prometheus" - "github.com/umbracle/ethgo" - "github.com/xgr-network/xgr-node/txrelayer" -) - -// startStatsReleasing starts the process that releases BoltDB stats into prometheus periodically. -func (s *State) startStatsReleasing() { - const ( - statUpdatePeriod = 10 * time.Second - dbSubsystem = "db" - txSubsystem = "tx" - namespace = "polybft_state" - ) - - // Grab the initial stats. - prev := s.db.Stats() - - // Initialize ticker in order to send stats once a statUpdatePeriod - ticker := time.NewTicker(statUpdatePeriod) - - // Stop ticker (stats releasing basically) when receiving the closing signal - go func() { - <-s.close - ticker.Stop() - }() - - for range ticker.C { - // Grab the current stats and diff them. - stats := s.db.Stats() - diff := stats.Sub(&prev) - - // Freelist stats - { - // Update total number of free pages on the freelist - metrics.SetGauge( - []string{prometheus.BuildFQName(namespace, dbSubsystem, "freelist_free_pages")}, - float32(diff.FreePageN), - ) - - // Update total number of pending pages on the freelist - metrics.SetGauge( - []string{prometheus.BuildFQName(namespace, dbSubsystem, "freelist_pending_pages")}, - float32(diff.PendingPageN), - ) - - // Update total bytes allocated in free pages - metrics.SetGauge( - []string{prometheus.BuildFQName(namespace, dbSubsystem, "freelist_free_page_allocated_bytes")}, - float32(diff.FreeAlloc), - ) - - // Update total bytes used by the freelist - metrics.SetGauge( - []string{prometheus.BuildFQName(namespace, dbSubsystem, "freelist_in_use_bytes")}, - float32(diff.FreelistInuse), - ) - } - - // Transaction stats - { - // Update total number of started read transactions - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, dbSubsystem, "read_tx_total")}, - float32(diff.TxN), - ) - - // Update number of currently open read transactions - metrics.SetGauge( - []string{prometheus.BuildFQName(namespace, dbSubsystem, "open_read_tx")}, - float32(diff.OpenTxN), - ) - } - - // Global, ongoing stats - { - // Update number of page allocations - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "pages_allocated_total")}, - float32(diff.TxStats.PageCount), - ) - - // Update total bytes allocated - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "pages_allocated_bytes_total")}, - float32(diff.TxStats.PageAlloc), - ) - - // Update number of cursors created - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "cursors_total")}, - float32(diff.TxStats.CursorCount), - ) - - // Update number of node allocations - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "nodes_allocated_total")}, - float32(diff.TxStats.NodeCount), - ) - - // Update number of node dereferences - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "nodes_dereferenced_total")}, - float32(diff.TxStats.NodeDeref), - ) - - // Update number of node rebalances - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "node_rebalances_total")}, - float32(diff.TxStats.Rebalance), - ) - - // Update total time spent rebalancing - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "node_rebalance_seconds_total")}, - float32(diff.TxStats.RebalanceTime.Seconds()), - ) - - // Update number of nodes split - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "nodes_split_total")}, - float32(diff.TxStats.Split), - ) - - // Update number of nodes spilled - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "nodes_spilled_total")}, - float32(diff.TxStats.Spill), - ) - - // Update total time spent spilling - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "nodes_spilled_seconds_total")}, - float32(diff.TxStats.SpillTime.Seconds()), - ) - - // Update number of writes performed - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "writes_total")}, - float32(diff.TxStats.Write), - ) - - // Update total time spent writing to disk - metrics.IncrCounter( - []string{prometheus.BuildFQName(namespace, txSubsystem, "write_seconds_total")}, - float32(diff.TxStats.WriteTime), - ) - } - - // Save stats for the next loop. - prev = stats - } -} - -// publishRootchainMetrics publishes rootchain related metrics -func (p *Polybft) publishRootchainMetrics(logger hclog.Logger) { - interval := p.config.MetricsInterval - validatorAddr := p.key.Address() - bridgeCfg := p.consensusConfig.Bridge - - // zero means metrics are disabled - if interval <= 0 { - return - } - - relayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(bridgeCfg.JSONRPCEndpoint)) - if err != nil { - logger.Error("failed to connect to the rootchain node", "err", err, "JSON RPC", bridgeCfg.JSONRPCEndpoint) - - return - } - - gweiPerWei := new(big.Float).SetInt(new(big.Int).Exp(big.NewInt(10), big.NewInt(9), nil)) // 10^9 - - ticker := time.NewTicker(interval) - defer ticker.Stop() - - for { - select { - case <-p.closeCh: - return - case <-ticker.C: - // rootchain validator balance - balance, err := relayer.Client().Eth().GetBalance(p.key.Address(), ethgo.Latest) - if err != nil { - logger.Error("failed to query eth_getBalance", "err", err) - } else { - balanceInGwei := new(big.Float).Quo(new(big.Float).SetInt(balance), gweiPerWei) - balanceInGweiFloat, _ := balanceInGwei.Float32() - - metrics.SetGauge([]string{"bridge", "validator_root_balance_gwei", validatorAddr.String()}, balanceInGweiFloat) - } - - // rootchain current checkpoint block - checkpointBlock, err := getCurrentCheckpointBlock(relayer, bridgeCfg.CheckpointManagerAddr) - if err != nil { - logger.Error("failed to query latest checkpoint block", "err", err) - } else { - metrics.SetGauge([]string{"bridge", "checkpoint_block_number"}, float32(checkpointBlock)) - } - } - } -} diff --git a/consensus/polybft/system_state.go b/consensus/polybft/system_state.go deleted file mode 100644 index aa7e102..0000000 --- a/consensus/polybft/system_state.go +++ /dev/null @@ -1,83 +0,0 @@ -package polybft - -import ( - "fmt" - "math/big" - - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/contract" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/types" -) - -// ValidatorInfo is data transfer object which holds validator information, -// provided by smart contract -type ValidatorInfo struct { - Address ethgo.Address `json:"address"` - Stake *big.Int `json:"stake"` - WithdrawableRewards *big.Int `json:"withdrawableRewards"` - IsActive bool `json:"isActive"` - IsWhitelisted bool `json:"isWhitelisted"` -} - -// SystemState is an interface to interact with the consensus system contracts in the chain -type SystemState interface { - // GetEpoch retrieves current epoch number from the smart contract - GetEpoch() (uint64, error) - // GetNextCommittedIndex retrieves next committed bridge state sync index - GetNextCommittedIndex() (uint64, error) -} - -var _ SystemState = &SystemStateImpl{} - -// SystemStateImpl is implementation of SystemState interface -type SystemStateImpl struct { - validatorContract *contract.Contract - sidechainBridgeContract *contract.Contract -} - -// NewSystemState initializes new instance of systemState which abstracts smart contracts functions -func NewSystemState(valSetAddr types.Address, stateRcvAddr types.Address, provider contract.Provider) *SystemStateImpl { - s := &SystemStateImpl{} - s.validatorContract = contract.NewContract( - ethgo.Address(valSetAddr), - contractsapi.ValidatorSet.Abi, contract.WithProvider(provider), - ) - s.sidechainBridgeContract = contract.NewContract( - ethgo.Address(stateRcvAddr), - contractsapi.StateReceiver.Abi, - contract.WithProvider(provider), - ) - - return s -} - -// GetEpoch retrieves current epoch number from the smart contract -func (s *SystemStateImpl) GetEpoch() (uint64, error) { - rawResult, err := s.validatorContract.Call("currentEpochId", ethgo.Latest) - if err != nil { - return 0, err - } - - epochNumber, isOk := rawResult["0"].(*big.Int) - if !isOk { - return 0, fmt.Errorf("failed to decode epoch") - } - - return epochNumber.Uint64(), nil -} - -// GetNextCommittedIndex retrieves next committed bridge state sync index -func (s *SystemStateImpl) GetNextCommittedIndex() (uint64, error) { - rawResult, err := s.sidechainBridgeContract.Call("lastCommittedId", ethgo.Latest) - if err != nil { - return 0, err - } - - nextCommittedIndex, isOk := rawResult["0"].(*big.Int) - if !isOk { - return 0, fmt.Errorf("failed to decode next committed index") - } - - return nextCommittedIndex.Uint64() + 1, nil -} diff --git a/consensus/polybft/system_state_test.go b/consensus/polybft/system_state_test.go deleted file mode 100644 index 31e4f52..0000000 --- a/consensus/polybft/system_state_test.go +++ /dev/null @@ -1,158 +0,0 @@ -package polybft - -import ( - "encoding/hex" - "math/big" - "testing" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/ethgo/contract" - "github.com/umbracle/ethgo/testutil" - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/state" - itrie "github.com/xgr-network/xgr-node/state/immutable-trie" - "github.com/xgr-network/xgr-node/types" -) - -func TestSystemState_GetNextCommittedIndex(t *testing.T) { - t.Parallel() - - var sideChainBridgeABI, _ = abi.NewMethod( - "function setNextCommittedIndex(uint256 _index) public payable", - ) - - cc := &testutil.Contract{} - cc.AddCallback(func() string { - return ` - uint256 public lastCommittedId; - - function setNextCommittedIndex(uint256 _index) public payable { - lastCommittedId = _index; - }` - }) - - solcContract, err := cc.Compile() - require.NoError(t, err) - - bin, err := hex.DecodeString(solcContract.Bin) - require.NoError(t, err) - - transition := newTestTransition(t, nil) - - // deploy a contract - result := transition.Create2(types.Address{}, bin, big.NewInt(0), 1000000000) - assert.NoError(t, result.Err) - - provider := &stateProvider{ - transition: transition, - } - - systemState := NewSystemState(contracts.ValidatorSetContract, result.Address, provider) - - expectedNextCommittedIndex := uint64(45) - input, err := sideChainBridgeABI.Encode([1]interface{}{expectedNextCommittedIndex}) - assert.NoError(t, err) - - _, err = provider.Call(ethgo.Address(result.Address), input, &contract.CallOpts{}) - assert.NoError(t, err) - - nextCommittedIndex, err := systemState.GetNextCommittedIndex() - assert.NoError(t, err) - assert.Equal(t, expectedNextCommittedIndex+1, nextCommittedIndex) -} - -func TestSystemState_GetEpoch(t *testing.T) { - t.Parallel() - - setEpochMethod, err := abi.NewMethod("function setEpoch(uint256 _epochId) public payable") - require.NoError(t, err) - - cc := &testutil.Contract{} - cc.AddCallback(func() string { - return ` - uint256 public currentEpochId; - - function setEpoch(uint256 _epochId) public payable { - currentEpochId = _epochId; - } - ` - }) - - solcContract, err := cc.Compile() - require.NoError(t, err) - - bin, err := hex.DecodeString(solcContract.Bin) - require.NoError(t, err) - - transition := newTestTransition(t, nil) - - // deploy a contract - result := transition.Create2(types.Address{}, bin, big.NewInt(0), 1000000000) - assert.NoError(t, result.Err) - - provider := &stateProvider{ - transition: transition, - } - - systemState := NewSystemState(result.Address, contracts.StateReceiverContract, provider) - - expectedEpoch := uint64(50) - input, err := setEpochMethod.Encode([1]interface{}{expectedEpoch}) - require.NoError(t, err) - - _, err = provider.Call(ethgo.Address(result.Address), input, &contract.CallOpts{}) - require.NoError(t, err) - - epoch, err := systemState.GetEpoch() - require.NoError(t, err) - require.Equal(t, expectedEpoch, epoch) -} - -func TestStateProvider_Txn_NotSupported(t *testing.T) { - t.Parallel() - - transition := newTestTransition(t, nil) - - provider := &stateProvider{ - transition: transition, - } - - _, err := provider.Txn(ethgo.ZeroAddress, createTestKey(t), []byte{0x1}) - require.ErrorIs(t, err, errSendTxnUnsupported) -} - -func newTestTransition(t *testing.T, alloc map[types.Address]*chain.GenesisAccount) *state.Transition { - t.Helper() - - st := itrie.NewState(itrie.NewMemoryStorage()) - - ex := state.NewExecutor(&chain.Params{ - Forks: chain.AllForksEnabled, - BurnContract: map[uint64]types.Address{ - 0: types.ZeroAddress, - }, - }, st, hclog.NewNullLogger()) - - rootHash, err := ex.WriteGenesis(alloc, types.Hash{}) - require.NoError(t, err) - - ex.GetHash = func(h *types.Header) state.GetHashByNumber { - return func(i uint64) types.Hash { - return rootHash - } - } - - transition, err := ex.BeginTxn( - rootHash, - &types.Header{}, - types.ZeroAddress, - ) - assert.NoError(t, err) - - return transition -} diff --git a/consensus/polybft/transport.go b/consensus/polybft/transport.go deleted file mode 100644 index 6ef662f..0000000 --- a/consensus/polybft/transport.go +++ /dev/null @@ -1,65 +0,0 @@ -package polybft - -import ( - "fmt" - - ibftProto "github.com/0xPolygon/go-ibft/messages/proto" - "github.com/libp2p/go-libp2p/core/peer" - polybftProto "github.com/xgr-network/xgr-node/consensus/polybft/proto" - "github.com/xgr-network/xgr-node/types" -) - -// BridgeTransport is an abstraction of network layer for a bridge -type BridgeTransport interface { - Multicast(msg interface{}) -} - -// subscribeToIbftTopic subscribes to ibft topic -func (p *Polybft) subscribeToIbftTopic() error { - return p.consensusTopic.Subscribe(func(obj interface{}, _ peer.ID) { - if !p.runtime.IsActiveValidator() { - return - } - - msg, ok := obj.(*ibftProto.Message) - if !ok { - p.logger.Error("consensus engine: invalid type assertion for message request") - - return - } - - p.ibft.AddMessage(msg) - - p.logger.Debug( - "validator message received", - "type", msg.Type.String(), - "height", msg.GetView().Height, - "round", msg.GetView().Round, - "addr", types.BytesToAddress(msg.From).String(), - ) - }) -} - -// createTopics create all topics for a PolyBft instance -func (p *Polybft) createTopics() (err error) { - if p.consensusConfig.IsBridgeEnabled() { - p.bridgeTopic, err = p.config.Network.NewTopic(bridgeProto, &polybftProto.TransportMessage{}) - if err != nil { - return fmt.Errorf("failed to create bridge topic: %w", err) - } - } - - p.consensusTopic, err = p.config.Network.NewTopic(pbftProto, &ibftProto.Message{}) - if err != nil { - return fmt.Errorf("failed to create consensus topic: %w", err) - } - - return nil -} - -// Multicast is implementation of core.Transport interface -func (p *Polybft) Multicast(msg *ibftProto.Message) { - if err := p.consensusTopic.Publish(msg); err != nil { - p.logger.Warn("failed to multicast consensus message", "error", err) - } -} diff --git a/consensus/polybft/validator/genesis_validator.go b/consensus/polybft/validator/genesis_validator.go deleted file mode 100644 index 155c983..0000000 --- a/consensus/polybft/validator/genesis_validator.go +++ /dev/null @@ -1,83 +0,0 @@ -package validator - -import ( - "encoding/hex" - "encoding/json" - "fmt" - "math/big" - - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/types" -) - -// GenesisValidator represents public information about validator accounts which are the part of genesis -type GenesisValidator struct { - Address types.Address - BlsKey string - Stake *big.Int - MultiAddr string -} - -type genesisValidatorRaw struct { - Address types.Address `json:"address"` - BlsKey string `json:"blsKey"` - Stake *string `json:"stake"` - MultiAddr string `json:"multiAddr"` -} - -func (v *GenesisValidator) MarshalJSON() ([]byte, error) { - raw := &genesisValidatorRaw{Address: v.Address, BlsKey: v.BlsKey, MultiAddr: v.MultiAddr} - raw.Stake = common.EncodeBigInt(v.Stake) - - return json.Marshal(raw) -} - -func (v *GenesisValidator) UnmarshalJSON(data []byte) (err error) { - var raw genesisValidatorRaw - - if err = json.Unmarshal(data, &raw); err != nil { - return err - } - - v.Address = raw.Address - v.BlsKey = raw.BlsKey - v.MultiAddr = raw.MultiAddr - - v.Stake, err = common.ParseUint256orHex(raw.Stake) - - return err -} - -// UnmarshalBLSPublicKey unmarshals the hex encoded BLS public key -func (v *GenesisValidator) UnmarshalBLSPublicKey() (*bls.PublicKey, error) { - decoded, err := hex.DecodeString(v.BlsKey) - if err != nil { - return nil, err - } - - return bls.UnmarshalPublicKey(decoded) -} - -// ToValidatorMetadata creates ValidatorMetadata instance -func (v *GenesisValidator) ToValidatorMetadata() (*ValidatorMetadata, error) { - blsKey, err := v.UnmarshalBLSPublicKey() - if err != nil { - return nil, err - } - - metadata := &ValidatorMetadata{ - Address: v.Address, - BlsKey: blsKey, - VotingPower: new(big.Int).Set(v.Stake), - IsActive: true, - } - - return metadata, nil -} - -// String implements fmt.Stringer interface -func (v *GenesisValidator) String() string { - return fmt.Sprintf("Address=%s; Stake=%d; P2P Multi addr=%s; BLS Key=%s;", - v.Address, v.Stake, v.MultiAddr, v.BlsKey) -} diff --git a/consensus/polybft/validator/test_helpers.go b/consensus/polybft/validator/test_helpers.go deleted file mode 100644 index e2c3507..0000000 --- a/consensus/polybft/validator/test_helpers.go +++ /dev/null @@ -1,243 +0,0 @@ -package validator - -import ( - "encoding/hex" - "fmt" - "math/big" - "sort" - "strconv" - "testing" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/types" -) - -type TestValidators struct { - Validators map[string]*TestValidator -} - -func NewTestValidators(tb testing.TB, validatorsCount int) *TestValidators { - tb.Helper() - - aliases := make([]string, validatorsCount) - for i := 0; i < validatorsCount; i++ { - aliases[i] = strconv.Itoa(i) - } - - return NewTestValidatorsWithAliases(tb, aliases) -} - -func NewTestValidatorsWithAliases(tb testing.TB, aliases []string, votingPowers ...[]uint64) *TestValidators { - tb.Helper() - - validators := map[string]*TestValidator{} - - for i, alias := range aliases { - votingPower := uint64(1) - if len(votingPowers) == 1 { - votingPower = votingPowers[0][i] - } - - validators[alias] = NewTestValidator(tb, alias, votingPower) - } - - return &TestValidators{Validators: validators} -} - -func (v *TestValidators) Create(t *testing.T, alias string, votingPower uint64) { - t.Helper() - - if _, ok := v.Validators[alias]; !ok { - v.Validators[alias] = NewTestValidator(t, alias, votingPower) - } -} - -func (v *TestValidators) IterAcct(aliases []string, handle func(t *TestValidator)) { - if len(aliases) == 0 { - // loop over the whole set - for k := range v.Validators { - aliases = append(aliases, k) - } - // sort the names since they get queried randomly - sort.Strings(aliases) - } - - for _, alias := range aliases { - handle(v.GetValidator(alias)) - } -} - -func (v *TestValidators) GetParamValidators(aliases ...string) (res []*GenesisValidator) { - v.IterAcct(aliases, func(t *TestValidator) { - res = append(res, t.ParamsValidator()) - }) - - return -} - -func (v *TestValidators) GetValidators(aliases ...string) (res []*TestValidator) { - v.IterAcct(aliases, func(t *TestValidator) { - res = append(res, t) - }) - - return -} - -func (v *TestValidators) GetPublicIdentities(aliases ...string) (res AccountSet) { - v.IterAcct(aliases, func(t *TestValidator) { - res = append(res, t.ValidatorMetadata()) - }) - - return -} - -func (v *TestValidators) GetPrivateIdentities(aliases ...string) (res []*wallet.Account) { - v.IterAcct(aliases, func(t *TestValidator) { - res = append(res, t.Account) - }) - - return -} - -func (v *TestValidators) GetValidator(alias string) *TestValidator { - vv, ok := v.Validators[alias] - if !ok { - panic(fmt.Sprintf("Validator %s does not exist", alias)) //nolint:gocritic - } - - return vv -} - -func (v *TestValidators) ToValidatorSet() ValidatorSet { - return NewValidatorSet(v.GetPublicIdentities(), hclog.NewNullLogger()) -} - -func (v *TestValidators) UpdateVotingPowers(votingPowersMap map[string]uint64) AccountSet { - if len(votingPowersMap) == 0 { - return AccountSet{} - } - - aliases := []string{} - for alias := range votingPowersMap { - aliases = append(aliases, alias) - } - - v.IterAcct(aliases, func(t *TestValidator) { - t.VotingPower = votingPowersMap[t.Alias] - }) - - return v.GetPublicIdentities(aliases...) -} - -type TestValidator struct { - Alias string - Account *wallet.Account - VotingPower uint64 -} - -func NewTestValidator(tb testing.TB, alias string, votingPower uint64) *TestValidator { - tb.Helper() - - return &TestValidator{ - Alias: alias, - VotingPower: votingPower, - Account: generateTestAccount(tb), - } -} - -func (v *TestValidator) Address() types.Address { - return types.Address(v.Account.Ecdsa.Address()) -} - -func (v *TestValidator) Key() *wallet.Key { - return wallet.NewKey(v.Account) -} - -func (v *TestValidator) ParamsValidator() *GenesisValidator { - bls := v.Account.Bls.PublicKey().Marshal() - - return &GenesisValidator{ - Address: v.Address(), - BlsKey: hex.EncodeToString(bls), - Stake: big.NewInt(1000), - } -} - -func (v *TestValidator) ValidatorMetadata() *ValidatorMetadata { - return &ValidatorMetadata{ - Address: types.Address(v.Account.Ecdsa.Address()), - BlsKey: v.Account.Bls.PublicKey(), - VotingPower: new(big.Int).SetUint64(v.VotingPower), - } -} - -func (v *TestValidator) MustSign(hash, domain []byte) *bls.Signature { - signature, err := v.Account.Bls.Sign(hash, domain) - if err != nil { - panic(fmt.Sprintf("BUG: failed to sign: %v", err)) //nolint:gocritic - } - - return signature -} - -func generateTestAccount(tb testing.TB) *wallet.Account { - tb.Helper() - - acc, err := wallet.GenerateAccount() - require.NoError(tb, err) - - return acc -} - -// CreateValidatorSetDelta calculates ValidatorSetDelta based on the provided old and new validator sets -func CreateValidatorSetDelta(oldValidatorSet, newValidatorSet AccountSet) (*ValidatorSetDelta, error) { - var addedValidators, updatedValidators AccountSet - - oldValidatorSetMap := make(map[types.Address]*ValidatorMetadata) - removedValidators := map[types.Address]int{} - - for i, validator := range oldValidatorSet { - if (validator.Address != types.Address{}) { - removedValidators[validator.Address] = i - oldValidatorSetMap[validator.Address] = validator - } - } - - for _, newValidator := range newValidatorSet { - // Check if the validator is among both old and new validator set - oldValidator, validatorExists := oldValidatorSetMap[newValidator.Address] - if validatorExists { - if !oldValidator.EqualAddressAndBlsKey(newValidator) { - return nil, fmt.Errorf("validator '%s' found in both old and new validator set, but its BLS keys differ", - newValidator.Address.String()) - } - - // If it is, then discard it from removed validators... - delete(removedValidators, newValidator.Address) - - if !oldValidator.Equals(newValidator) { - updatedValidators = append(updatedValidators, newValidator) - } - } else { - // ...otherwise it is added - addedValidators = append(addedValidators, newValidator) - } - } - - removedValsBitmap := bitmap.Bitmap{} - for _, i := range removedValidators { - removedValsBitmap.Set(uint64(i)) - } - - delta := &ValidatorSetDelta{ - Added: addedValidators, - Updated: updatedValidators, - Removed: removedValsBitmap, - } - - return delta, nil -} diff --git a/consensus/polybft/validator/validator_metadata.go b/consensus/polybft/validator/validator_metadata.go deleted file mode 100644 index 0dda1b2..0000000 --- a/consensus/polybft/validator/validator_metadata.go +++ /dev/null @@ -1,360 +0,0 @@ -package validator - -import ( - "bytes" - "encoding/hex" - "encoding/json" - "errors" - "fmt" - "math/big" - "reflect" - - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/crypto" - - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/fastrlp" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/types" -) - -var accountSetABIType = abi.MustNewType(`tuple(tuple(address _address, uint256[4] blsKey, uint256 votingPower)[])`) - -// ValidatorMetadata represents a validator metadata (its public identity) -type ValidatorMetadata struct { - Address types.Address - BlsKey *bls.PublicKey - VotingPower *big.Int - IsActive bool -} - -// Equals checks ValidatorMetadata equality -func (v *ValidatorMetadata) Equals(b *ValidatorMetadata) bool { - if b == nil { - return false - } - - return v.EqualAddressAndBlsKey(b) && v.VotingPower.Cmp(b.VotingPower) == 0 && v.IsActive == b.IsActive -} - -// EqualAddressAndBlsKey checks ValidatorMetadata equality against Address and BlsKey fields -func (v *ValidatorMetadata) EqualAddressAndBlsKey(b *ValidatorMetadata) bool { - if b == nil { - return false - } - - return v.Address == b.Address && reflect.DeepEqual(v.BlsKey, b.BlsKey) -} - -// Copy returns a deep copy of ValidatorMetadata -func (v *ValidatorMetadata) Copy() *ValidatorMetadata { - copiedBlsKey := v.BlsKey.Marshal() - blsKey, _ := bls.UnmarshalPublicKey(copiedBlsKey) - - return &ValidatorMetadata{ - Address: types.BytesToAddress(v.Address[:]), - BlsKey: blsKey, - VotingPower: new(big.Int).Set(v.VotingPower), - IsActive: v.IsActive, - } -} - -// MarshalRLPWith marshals ValidatorMetadata to the RLP format -func (v *ValidatorMetadata) MarshalRLPWith(ar *fastrlp.Arena) *fastrlp.Value { - vv := ar.NewArray() - // Address - vv.Set(ar.NewBytes(v.Address.Bytes())) - // BlsKey - vv.Set(ar.NewCopyBytes(v.BlsKey.Marshal())) - // VotingPower - vv.Set(ar.NewBigInt(v.VotingPower)) - // IsActive - vv.Set(ar.NewBool(v.IsActive)) - - return vv -} - -// UnmarshalRLPWith unmarshals ValidatorMetadata from the RLP format -func (v *ValidatorMetadata) UnmarshalRLPWith(val *fastrlp.Value) error { - elems, err := val.GetElems() - if err != nil { - return err - } - - if num := len(elems); num != 4 { - return fmt.Errorf("incorrect elements count to decode validator account, expected 4 but found %d", num) - } - - // Address - addressRaw, err := elems[0].GetBytes(nil) - if err != nil { - return fmt.Errorf("expected 'Address' field encoded as bytes. Error: %w", err) - } - - v.Address = types.BytesToAddress(addressRaw) - - // BlsKey - blsKeyRaw, err := elems[1].GetBytes(nil) - if err != nil { - return fmt.Errorf("expected 'BlsKey' encoded as bytes: %w", err) - } - - blsKey, err := bls.UnmarshalPublicKey(blsKeyRaw) - if err != nil { - return fmt.Errorf("failed to unmarshal BLS public key: %w", err) - } - - v.BlsKey = blsKey - - // VotingPower - votingPower := new(big.Int) - if err = elems[2].GetBigInt(votingPower); err != nil { - return fmt.Errorf("expected 'VotingPower' encoded as big int: %w", err) - } - - v.VotingPower = new(big.Int).Set(votingPower) - - // IsActive - isActive, err := elems[3].GetBool() - if err != nil { - return fmt.Errorf("expected 'IsActive' encoded as bool: %w", err) - } - - v.IsActive = isActive - - return nil -} - -// fmt.Stringer implementation -func (v *ValidatorMetadata) String() string { - return fmt.Sprintf("Address=%v; Is Active=%v; Voting Power=%d; BLS Key=%v;", - v.Address.String(), v.IsActive, v.VotingPower, hex.EncodeToString(v.BlsKey.Marshal())) -} - -// AccountSet is a type alias for slice of ValidatorMetadata instances -type AccountSet []*ValidatorMetadata - -// Equals compares checks if two AccountSet instances are equal (ordering is important) -func (as AccountSet) Equals(other AccountSet) bool { - if len(as) != len(other) { - return false - } - - for i := range as { - if !as[i].Equals(other[i]) { - return false - } - } - - return true -} - -// fmt.Stringer implementation -func (as AccountSet) String() string { - var buf bytes.Buffer - for _, v := range as { - buf.WriteString(fmt.Sprintf("%s\n", v.String())) - } - - return buf.String() -} - -// GetAddresses aggregates addresses for given AccountSet -func (as AccountSet) GetAddresses() []types.Address { - res := make([]types.Address, 0, len(as)) - for _, account := range as { - res = append(res, account.Address) - } - - return res -} - -// GetAddresses aggregates addresses as map for given AccountSet -func (as AccountSet) GetAddressesAsSet() map[types.Address]struct{} { - res := make(map[types.Address]struct{}, len(as)) - for _, account := range as { - res[account.Address] = struct{}{} - } - - return res -} - -// GetBlsKeys aggregates public BLS keys for given AccountSet -func (as AccountSet) GetBlsKeys() []*bls.PublicKey { - res := make([]*bls.PublicKey, 0, len(as)) - for _, account := range as { - res = append(res, account.BlsKey) - } - - return res -} - -// Len returns length of AccountSet -func (as AccountSet) Len() int { - return len(as) -} - -// ContainsNodeID checks whether ValidatorMetadata with given nodeID is present in the AccountSet -func (as AccountSet) ContainsNodeID(nodeID string) bool { - for _, validator := range as { - if validator.Address.String() == nodeID { - return true - } - } - - return false -} - -// ContainsAddress checks whether ValidatorMetadata with given address is present in the AccountSet -func (as AccountSet) ContainsAddress(address types.Address) bool { - return as.Index(address) != -1 -} - -// Index returns index of the given ValidatorMetadata, identified by address within the AccountSet. -// If given ValidatorMetadata is not present, it returns -1. -func (as AccountSet) Index(addr types.Address) int { - for indx, validator := range as { - if validator.Address == addr { - return indx - } - } - - return -1 -} - -// Copy returns deep copy of AccountSet -func (as AccountSet) Copy() AccountSet { - copiedAccs := make([]*ValidatorMetadata, as.Len()) - for i, acc := range as { - copiedAccs[i] = acc.Copy() - } - - return AccountSet(copiedAccs) -} - -// Hash returns hash value of the AccountSet -func (as AccountSet) Hash() (types.Hash, error) { - abiEncoded, err := accountSetABIType.Encode([]interface{}{as.ToAPIBinding()}) - if err != nil { - return types.ZeroHash, err - } - - return types.BytesToHash(crypto.Keccak256(abiEncoded)), nil -} - -// ToAPIBinding converts AccountSet to slice of contract api stubs to be encoded -func (as AccountSet) ToAPIBinding() []*contractsapi.Validator { - apiBinding := make([]*contractsapi.Validator, len(as)) - for i, v := range as { - apiBinding[i] = &contractsapi.Validator{ - Address: v.Address, - BlsKey: v.BlsKey.ToBigInt(), - VotingPower: new(big.Int).Set(v.VotingPower), - } - } - - return apiBinding -} - -// GetValidatorMetadata tries to retrieve validator account metadata by given address from the account set. -// It returns nil if such account is not found. -func (as AccountSet) GetValidatorMetadata(address types.Address) *ValidatorMetadata { - i := as.Index(address) - if i == -1 { - return nil - } - - return as[i] -} - -// GetFilteredValidators returns filtered validators based on provided bitmap. -// Filtered validators will contain validators whose index corresponds -// to the position in bitmap which has value set to 1. -func (as AccountSet) GetFilteredValidators(bitmap bitmap.Bitmap) (AccountSet, error) { - var filteredValidators AccountSet - if len(as) == 0 { - return filteredValidators, nil - } - - if bitmap.Len() > uint64(len(as)) { - for i := len(as); i < int(bitmap.Len()); i++ { - if bitmap.IsSet(uint64(i)) { - return filteredValidators, errors.New("invalid bitmap filter provided") - } - } - } - - for i, validator := range as { - if bitmap.IsSet(uint64(i)) { - filteredValidators = append(filteredValidators, validator) - } - } - - return filteredValidators, nil -} - -// ApplyDelta receives ValidatorSetDelta and applies it to the values from the current AccountSet -// (removes the ones marked for deletion and adds the one which are being added by delta) -// Function returns new AccountSet with old and new data merged. AccountSet is immutable! -func (as AccountSet) ApplyDelta(validatorsDelta *ValidatorSetDelta) (AccountSet, error) { - if validatorsDelta == nil || validatorsDelta.IsEmpty() { - return as.Copy(), nil - } - - // Figure out which validators from the existing set are not marked for deletion. - // Those should be kept in the snapshot. - validators := make(AccountSet, 0) - - for i, validator := range as { - // If a validator is not in the Removed set, or it is in the Removed set - // but it exists in the Added set as well (which should never happen), - // the validator should remain in the validator set. - if !validatorsDelta.Removed.IsSet(uint64(i)) || - validatorsDelta.Added.ContainsAddress(validator.Address) { - validators = append(validators, validator) - } - } - - // Append added validators - for _, addedValidator := range validatorsDelta.Added { - if validators.ContainsAddress(addedValidator.Address) { - return nil, fmt.Errorf("validator %v is already present in the validators snapshot", addedValidator.Address.String()) - } - - validators = append(validators, addedValidator) - } - - // Handle updated validators (find them in the validators slice and insert to appropriate index) - for _, updatedValidator := range validatorsDelta.Updated { - validatorIndex := validators.Index(updatedValidator.Address) - if validatorIndex == -1 { - return nil, fmt.Errorf("incorrect delta provided: validator %s is marked as updated but not found in the validators", - updatedValidator.Address) - } - - validators[validatorIndex] = updatedValidator - } - - return validators, nil -} - -// Marshal marshals AccountSet to JSON -func (as AccountSet) Marshal() ([]byte, error) { - return json.Marshal(as) -} - -// Unmarshal unmarshals AccountSet from JSON -func (as *AccountSet) Unmarshal(b []byte) error { - return json.Unmarshal(b, as) -} - -// GetTotalVotingPower calculates sum of voting power for each validator in the AccountSet -func (as *AccountSet) GetTotalVotingPower() *big.Int { - totalVotingPower := big.NewInt(0) - for _, v := range *as { - totalVotingPower = totalVotingPower.Add(totalVotingPower, v.VotingPower) - } - - return totalVotingPower -} diff --git a/consensus/polybft/validator/validator_metadata_test.go b/consensus/polybft/validator/validator_metadata_test.go deleted file mode 100644 index 0a6bad7..0000000 --- a/consensus/polybft/validator/validator_metadata_test.go +++ /dev/null @@ -1,281 +0,0 @@ -package validator - -import ( - "crypto/rand" - "math/big" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" - "github.com/xgr-network/xgr-node/types" -) - -// generateRandomBytes generates byte array with random data of 32 bytes length -func generateRandomBytes(t *testing.T) (result []byte) { - t.Helper() - - result = make([]byte, types.HashLength) - _, err := rand.Reader.Read(result) - require.NoError(t, err, "Cannot generate random byte array content.") - - return -} - -func TestValidatorMetadata_Equals(t *testing.T) { - t.Parallel() - - v := NewTestValidator(t, "A", 10) - validatorAcc := v.ValidatorMetadata() - // proper validator metadata instance doesn't equal to nil - require.False(t, validatorAcc.Equals(nil)) - // same instances of validator metadata are equal - require.True(t, validatorAcc.Equals(v.ValidatorMetadata())) - - // update voting power => validator metadata instances aren't equal - validatorAcc.VotingPower = new(big.Int).SetInt64(50) - require.False(t, validatorAcc.Equals(v.ValidatorMetadata())) -} - -func TestValidatorMetadata_EqualAddressAndBlsKey(t *testing.T) { - t.Parallel() - - v := NewTestValidator(t, "A", 10) - validatorAcc := v.ValidatorMetadata() - // proper validator metadata instance doesn't equal to nil - require.False(t, validatorAcc.EqualAddressAndBlsKey(nil)) - // same instances of validator metadata are equal - require.True(t, validatorAcc.EqualAddressAndBlsKey(v.ValidatorMetadata())) - - // update voting power => validator metadata instances aren't equal - validatorAcc.Address = types.BytesToAddress(generateRandomBytes(t)) - require.False(t, validatorAcc.EqualAddressAndBlsKey(v.ValidatorMetadata())) -} - -func TestAccountSet_GetAddresses(t *testing.T) { - t.Parallel() - - address1, address2, address3 := types.Address{4, 3}, types.Address{68, 123}, types.Address{168, 123} - ac := AccountSet{ - &ValidatorMetadata{Address: address1}, - &ValidatorMetadata{Address: address2}, - &ValidatorMetadata{Address: address3}, - } - rs := ac.GetAddresses() - assert.Len(t, rs, 3) - assert.Equal(t, address1, rs[0]) - assert.Equal(t, address2, rs[1]) - assert.Equal(t, address3, rs[2]) -} - -func TestAccountSet_GetBlsKeys(t *testing.T) { - t.Parallel() - - keys, err := bls.CreateRandomBlsKeys(3) - assert.NoError(t, err) - - key1, key2, key3 := keys[0], keys[1], keys[2] - ac := AccountSet{ - &ValidatorMetadata{BlsKey: key1.PublicKey()}, - &ValidatorMetadata{BlsKey: key2.PublicKey()}, - &ValidatorMetadata{BlsKey: key3.PublicKey()}, - } - rs := ac.GetBlsKeys() - assert.Len(t, rs, 3) - assert.Equal(t, key1.PublicKey(), rs[0]) - assert.Equal(t, key2.PublicKey(), rs[1]) - assert.Equal(t, key3.PublicKey(), rs[2]) -} - -func TestAccountSet_IndexContainsAddressesAndContainsNodeId(t *testing.T) { - t.Parallel() - - const count = 10 - - dummy := types.Address{2, 3, 4} - validators := NewTestValidators(t, count).GetPublicIdentities() - addresses := [count]types.Address{} - - for i, validator := range validators { - addresses[i] = validator.Address - } - - for i, a := range addresses { - assert.Equal(t, i, validators.Index(a)) - assert.True(t, validators.ContainsAddress(a)) - assert.True(t, validators.ContainsNodeID(a.String())) - } - - assert.Equal(t, -1, validators.Index(dummy)) - assert.False(t, validators.ContainsAddress(dummy)) - assert.False(t, validators.ContainsNodeID(dummy.String())) -} - -func TestAccountSet_Len(t *testing.T) { - t.Parallel() - - const count = 10 - - ac := AccountSet{} - - for i := 0; i < count; i++ { - ac = append(ac, &ValidatorMetadata{}) - assert.Equal(t, i+1, ac.Len()) - } -} - -func TestAccountSet_ApplyDelta(t *testing.T) { - t.Parallel() - - type Step struct { - added []string - updated map[string]uint64 - removed []uint64 - expected map[string]uint64 - errMsg string - } - - cases := []struct { - name string - steps []*Step - }{ - { - name: "Basic", - steps: []*Step{ - { - []string{"A", "B", "C", "D"}, - nil, - nil, - map[string]uint64{"A": 1, "B": 1, "C": 1, "D": 1}, - "", - }, - { - // add two new validators and remove 3 (one does not exists) - // update voting powers to subset of validators - // (two of them added in the previous step and one added in the current one) - []string{"E", "F"}, - map[string]uint64{"A": 30, "D": 10, "E": 5}, - []uint64{1, 2, 5}, - map[string]uint64{"A": 30, "D": 10, "E": 5, "F": 1}, - "", - }, - }, - }, - { - name: "AddRemoveSameValidator", - steps: []*Step{ - { - []string{"A"}, - nil, - []uint64{0}, - map[string]uint64{"A": 1}, - "", - }, - }, - }, - { - name: "AddSameValidatorTwice", - steps: []*Step{ - { - []string{"A", "A"}, - nil, - nil, - nil, - "is already present in the validators snapshot", - }, - }, - }, - { - name: "UpdateNonExistingValidator", - steps: []*Step{ - { - nil, - map[string]uint64{"B": 5}, - nil, - nil, - "incorrect delta provided: validator", - }, - }, - }, - } - - for _, cc := range cases { - cc := cc - t.Run(cc.name, func(t *testing.T) { - t.Parallel() - - snapshot := AccountSet{} - // Add a couple of validators to the snapshot => validators are present in the snapshot after applying such delta - vals := NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - - for _, step := range cc.steps { - addedValidators := AccountSet{} - if step.added != nil { - addedValidators = vals.GetPublicIdentities(step.added...) - } - delta := &ValidatorSetDelta{ - Added: addedValidators, - Removed: bitmap.Bitmap{}, - } - for _, i := range step.removed { - delta.Removed.Set(i) - } - - // update voting powers - delta.Updated = vals.UpdateVotingPowers(step.updated) - - // apply delta - var err error - snapshot, err = snapshot.ApplyDelta(delta) - if step.errMsg != "" { - require.ErrorContains(t, err, step.errMsg) - require.Nil(t, snapshot) - - return - } - require.NoError(t, err) - - // validate validator set - require.Equal(t, len(step.expected), snapshot.Len()) - for validatorAlias, votingPower := range step.expected { - v := vals.GetValidator(validatorAlias).ValidatorMetadata() - require.True(t, snapshot.ContainsAddress(v.Address), "validator '%s' not found in snapshot", validatorAlias) - require.Equal(t, new(big.Int).SetUint64(votingPower), v.VotingPower) - } - } - }) - } -} - -func TestAccountSet_ApplyEmptyDelta(t *testing.T) { - t.Parallel() - - v := NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - validatorAccs := v.GetPublicIdentities() - validators, err := validatorAccs.ApplyDelta(nil) - require.NoError(t, err) - require.Equal(t, validatorAccs, validators) -} - -func TestAccountSet_Hash(t *testing.T) { - t.Parallel() - - t.Run("Hash non-empty account set", func(t *testing.T) { - t.Parallel() - - v := NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - hash, err := v.GetPublicIdentities().Hash() - require.NoError(t, err) - require.NotEqual(t, types.ZeroHash, hash) - }) - - t.Run("Hash empty account set", func(t *testing.T) { - t.Parallel() - - empty := AccountSet{} - hash, err := empty.Hash() - require.NoError(t, err) - require.NotEqual(t, types.ZeroHash, hash) - }) -} diff --git a/consensus/polybft/validator/validator_set.go b/consensus/polybft/validator/validator_set.go deleted file mode 100644 index d0abcf4..0000000 --- a/consensus/polybft/validator/validator_set.go +++ /dev/null @@ -1,121 +0,0 @@ -package validator - -import ( - "math/big" - - "github.com/hashicorp/go-hclog" - "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/forkmanager" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/types" -) - -// ValidatorSet interface of the current validator set -type ValidatorSet interface { - // Includes check if given address is among the current validator set - Includes(address types.Address) bool - - // Len returns the size of the validator set - Len() int - - // Accounts returns the list of the ValidatorMetadata - Accounts() AccountSet - - // HasQuorum checks if submitted signers have reached quorum - HasQuorum(blockNumber uint64, signers map[types.Address]struct{}) bool - - // GetVotingPowers retrieves map: string(address) -> vp - GetVotingPowers() map[string]*big.Int -} - -var _ ValidatorSet = (*validatorSet)(nil) - -type validatorSet struct { - // validators represents current list of validators - validators AccountSet - - // votingPowerMap represents voting powers per validator address - votingPowerMap map[types.Address]*big.Int - - // totalVotingPower is sum of active validator set - totalVotingPower *big.Int - - // logger instance - logger hclog.Logger -} - -// NewValidatorSet creates a new validator set. -func NewValidatorSet(valz AccountSet, logger hclog.Logger) *validatorSet { - votingPowerMap := make(map[types.Address]*big.Int, len(valz)) - for _, val := range valz { - votingPowerMap[val.Address] = val.VotingPower - } - - return &validatorSet{ - validators: valz, - votingPowerMap: votingPowerMap, - totalVotingPower: valz.GetTotalVotingPower(), - logger: logger.Named("validator_set"), - } -} - -// HasQuorum determines if there is quorum of enough signers reached, -// based on its voting power and quorum size -func (vs validatorSet) HasQuorum(blockNumber uint64, signers map[types.Address]struct{}) bool { - aggregateVotingPower := big.NewInt(0) - - for address := range signers { - if votingPower := vs.votingPowerMap[address]; votingPower != nil { - _ = aggregateVotingPower.Add(aggregateVotingPower, votingPower) - } - } - - quorumSize := getQuorumSize(blockNumber, vs.totalVotingPower) - hasQuorum := aggregateVotingPower.Cmp(quorumSize) >= 0 - - vs.logger.Debug("HasQuorum", - "signers", len(signers), - "signers voting power", aggregateVotingPower, - "hasQuorum", hasQuorum) - - return hasQuorum -} - -func (vs validatorSet) GetVotingPowers() map[string]*big.Int { - result := make(map[string]*big.Int, vs.Len()) - - for address, vp := range vs.votingPowerMap { - result[types.AddressToString(address)] = vp - } - - return result -} - -func (vs validatorSet) Accounts() AccountSet { - return vs.validators -} - -func (vs validatorSet) Includes(address types.Address) bool { - return vs.validators.ContainsAddress(address) -} - -func (vs validatorSet) Len() int { - return vs.validators.Len() -} - -func (vs validatorSet) TotalVotingPower() big.Int { - return *vs.totalVotingPower -} - -// getQuorumSize calculates quorum size as 2/3 super-majority of provided total voting power -func getQuorumSize(blockNumber uint64, totalVotingPower *big.Int) *big.Int { - quorum := new(big.Int) - quorum.Mul(totalVotingPower, big.NewInt(2)) - - if forkmanager.GetInstance().IsForkEnabled(chain.QuorumCalcAlignment, blockNumber) { - // this will floor the 2 * totalVotingPower / 3 and add one to it - return quorum.Div(quorum, big.NewInt(3)).Add(quorum, big.NewInt(1)) - } - - return common.BigIntDivCeil(quorum, big.NewInt(3)) -} diff --git a/consensus/polybft/validator/validator_set_delta.go b/consensus/polybft/validator/validator_set_delta.go deleted file mode 100644 index 2c48871..0000000 --- a/consensus/polybft/validator/validator_set_delta.go +++ /dev/null @@ -1,144 +0,0 @@ -package validator - -import ( - "bytes" - "fmt" - - "github.com/umbracle/fastrlp" - "github.com/xgr-network/xgr-node/consensus/polybft/bitmap" -) - -// ValidatorSetDelta holds information about added and removed validators compared to the previous epoch -type ValidatorSetDelta struct { - // Added is the slice of added validators - Added AccountSet - // Updated is the slice of updated valiadtors - Updated AccountSet - // Removed is a bitmap of the validators removed from the set - Removed bitmap.Bitmap -} - -// Equals checks validator set delta equality -func (d *ValidatorSetDelta) Equals(other *ValidatorSetDelta) bool { - if other == nil { - return false - } - - return d.Added.Equals(other.Added) && - d.Updated.Equals(other.Updated) && - bytes.Equal(d.Removed, other.Removed) -} - -// MarshalRLPWith marshals ValidatorSetDelta to RLP format -func (d *ValidatorSetDelta) MarshalRLPWith(ar *fastrlp.Arena) *fastrlp.Value { - vv := ar.NewArray() - addedValidatorsRaw := ar.NewArray() - updatedValidatorsRaw := ar.NewArray() - - for _, validatorAccount := range d.Added { - addedValidatorsRaw.Set(validatorAccount.MarshalRLPWith(ar)) - } - - for _, validatorAccount := range d.Updated { - updatedValidatorsRaw.Set(validatorAccount.MarshalRLPWith(ar)) - } - - vv.Set(addedValidatorsRaw) // added - vv.Set(updatedValidatorsRaw) // updated - vv.Set(ar.NewCopyBytes(d.Removed)) // removed - - return vv -} - -// UnmarshalRLPWith unmarshals ValidatorSetDelta from RLP format -func (d *ValidatorSetDelta) UnmarshalRLPWith(v *fastrlp.Value) error { - elems, err := v.GetElems() - if err != nil { - return err - } - - if len(elems) == 0 { - return nil - } else if num := len(elems); num != 3 { - return fmt.Errorf("incorrect elements count to decode validator set delta, expected 3 but found %d", num) - } - - // Validators (added) - { - validatorsRaw, err := elems[0].GetElems() - if err != nil { - return fmt.Errorf("array expected for added validators") - } - - d.Added, err = unmarshalValidators(validatorsRaw) - if err != nil { - return err - } - } - - // Validators (updated) - { - validatorsRaw, err := elems[1].GetElems() - if err != nil { - return fmt.Errorf("array expected for updated validators") - } - - d.Updated, err = unmarshalValidators(validatorsRaw) - if err != nil { - return err - } - } - - // Bitmap (removed) - { - dst, err := elems[2].GetBytes(nil) - if err != nil { - return err - } - - d.Removed = bitmap.Bitmap(dst) - } - - return nil -} - -// unmarshalValidators unmarshals RLP encoded validators and returns AccountSet instance -func unmarshalValidators(validatorsRaw []*fastrlp.Value) (AccountSet, error) { - if len(validatorsRaw) == 0 { - return nil, nil - } - - validators := make(AccountSet, len(validatorsRaw)) - - for i, validatorRaw := range validatorsRaw { - acc := &ValidatorMetadata{} - if err := acc.UnmarshalRLPWith(validatorRaw); err != nil { - return nil, err - } - - validators[i] = acc - } - - return validators, nil -} - -// IsEmpty returns indication whether delta is empty (namely added, updated slices and removed bitmap are empty) -func (d *ValidatorSetDelta) IsEmpty() bool { - return len(d.Added) == 0 && - len(d.Updated) == 0 && - d.Removed.Len() == 0 -} - -// Copy creates deep copy of ValidatorSetDelta -func (d *ValidatorSetDelta) Copy() *ValidatorSetDelta { - added := d.Added.Copy() - removed := make([]byte, len(d.Removed)) - copy(removed, d.Removed) - - return &ValidatorSetDelta{Added: added, Removed: removed} -} - -// fmt.Stringer interface implementation -func (d *ValidatorSetDelta) String() string { - return fmt.Sprintf("Added: \n%v Removed: %v\n Updated: \n%v", d.Added, d.Removed, d.Updated) -} diff --git a/consensus/polybft/validator/validator_set_delta_test.go b/consensus/polybft/validator/validator_set_delta_test.go deleted file mode 100644 index d1c5aaa..0000000 --- a/consensus/polybft/validator/validator_set_delta_test.go +++ /dev/null @@ -1,237 +0,0 @@ -package validator - -import ( - "crypto/rand" - "math/big" - "testing" - - "github.com/stretchr/testify/require" - "github.com/umbracle/fastrlp" - "github.com/xgr-network/xgr-node/bls" -) - -func TestExtra_CreateValidatorSetDelta_BlsDiffer(t *testing.T) { - t.Parallel() - - vals := NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F"}) - oldValidatorSet := vals.GetPublicIdentities("A", "B", "C", "D") - - // change the public bls key of 'B' - newValidatorSet := vals.GetPublicIdentities("B", "E", "F") - privateKey, err := bls.GenerateBlsKey() - require.NoError(t, err) - - newValidatorSet[0].BlsKey = privateKey.PublicKey() - - _, err = CreateValidatorSetDelta(oldValidatorSet, newValidatorSet) - require.Error(t, err) -} - -func TestValidatorSetDelta_Copy(t *testing.T) { - t.Parallel() - - const ( - originalValidatorsCount = 10 - addedValidatorsCount = 2 - ) - - oldValidatorSet := NewTestValidators(t, originalValidatorsCount).GetPublicIdentities() - newValidatorSet := oldValidatorSet[:len(oldValidatorSet)-2] - originalDelta, err := CreateValidatorSetDelta(oldValidatorSet, newValidatorSet) - require.NoError(t, err) - require.NotNil(t, originalDelta) - require.Empty(t, originalDelta.Added) - - copiedDelta := originalDelta.Copy() - require.NotNil(t, copiedDelta) - require.NotSame(t, originalDelta, copiedDelta) - require.NotEqual(t, originalDelta, copiedDelta) - require.Empty(t, copiedDelta.Added) - require.Equal(t, copiedDelta.Removed.Len(), originalDelta.Removed.Len()) - - newValidators := NewTestValidators(t, addedValidatorsCount).GetPublicIdentities() - copiedDelta.Added = append(copiedDelta.Added, newValidators...) - require.Empty(t, originalDelta.Added) - require.Len(t, copiedDelta.Added, addedValidatorsCount) - require.Equal(t, copiedDelta.Removed.Len(), originalDelta.Removed.Len()) -} - -func TestValidatorSetDelta_UnmarshalRLPWith_NegativeCases(t *testing.T) { - t.Parallel() - - t.Run("Incorrect RLP value type provided", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - delta := &ValidatorSetDelta{} - require.ErrorContains(t, delta.UnmarshalRLPWith(ar.NewNull()), "value is not of type array") - }) - - t.Run("Empty RLP array provided", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - delta := &ValidatorSetDelta{} - require.NoError(t, delta.UnmarshalRLPWith(ar.NewArray())) - }) - - t.Run("Incorrect RLP array size", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - deltaMarshalled := ar.NewArray() - deltaMarshalled.Set(ar.NewBytes([]byte{0x59})) - deltaMarshalled.Set(ar.NewBytes([]byte{0x33})) - deltaMarshalled.Set(ar.NewBytes([]byte{0x26})) - deltaMarshalled.Set(ar.NewBytes([]byte{0x74})) - delta := &ValidatorSetDelta{} - require.ErrorContains(t, delta.UnmarshalRLPWith(deltaMarshalled), "incorrect elements count to decode validator set delta, expected 3 but found 4") - }) - - t.Run("Incorrect RLP value type for Added field", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - deltaMarshalled := ar.NewArray() - deltaMarshalled.Set(ar.NewBytes([]byte{0x59})) - deltaMarshalled.Set(ar.NewBytes([]byte{0x33})) - deltaMarshalled.Set(ar.NewBytes([]byte{0x27})) - delta := &ValidatorSetDelta{} - require.ErrorContains(t, delta.UnmarshalRLPWith(deltaMarshalled), "array expected for added validators") - }) - - t.Run("Incorrect RLP value type for ValidatorMetadata in Added field", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - deltaMarshalled := ar.NewArray() - addedArray := ar.NewArray() - addedArray.Set(ar.NewNull()) - deltaMarshalled.Set(addedArray) - deltaMarshalled.Set(ar.NewNullArray()) - deltaMarshalled.Set(ar.NewNull()) - delta := &ValidatorSetDelta{} - require.ErrorContains(t, delta.UnmarshalRLPWith(deltaMarshalled), "value is not of type array") - }) - - t.Run("Incorrect RLP value type for Removed field", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - deltaMarshalled := ar.NewArray() - addedValidators := NewTestValidators(t, 3).GetPublicIdentities() - addedArray := ar.NewArray() - updatedArray := ar.NewArray() - for _, validator := range addedValidators { - addedArray.Set(validator.MarshalRLPWith(ar)) - } - for _, validator := range addedValidators { - votingPower, err := rand.Int(rand.Reader, big.NewInt(100)) - require.NoError(t, err) - - validator.VotingPower = new(big.Int).Set(votingPower) - updatedArray.Set(validator.MarshalRLPWith(ar)) - } - deltaMarshalled.Set(addedArray) - deltaMarshalled.Set(updatedArray) - deltaMarshalled.Set(ar.NewNull()) - delta := &ValidatorSetDelta{} - require.ErrorContains(t, delta.UnmarshalRLPWith(deltaMarshalled), "value is not of type bytes") - }) - - t.Run("Incorrect RLP value type for Updated field", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - deltaMarshalled := ar.NewArray() - deltaMarshalled.Set(ar.NewArray()) - deltaMarshalled.Set(ar.NewBytes([]byte{0x33})) - deltaMarshalled.Set(ar.NewNull()) - delta := &ValidatorSetDelta{} - require.ErrorContains(t, delta.UnmarshalRLPWith(deltaMarshalled), "array expected for updated validators") - }) - - t.Run("Incorrect RLP value type for ValidatorMetadata in Updated field", func(t *testing.T) { - t.Parallel() - - ar := &fastrlp.Arena{} - deltaMarshalled := ar.NewArray() - updatedArray := ar.NewArray() - updatedArray.Set(ar.NewNull()) - deltaMarshalled.Set(ar.NewArray()) - deltaMarshalled.Set(updatedArray) - deltaMarshalled.Set(ar.NewNull()) - delta := &ValidatorSetDelta{} - require.ErrorContains(t, delta.UnmarshalRLPWith(deltaMarshalled), "value is not of type array") - }) -} - -func TestExtra_CreateValidatorSetDelta_Cases(t *testing.T) { - t.Parallel() - - cases := []struct { - name string - oldSet []string - newSet []string - added []string - updated []string - removed []uint64 - }{ - { - "Simple", - []string{"A", "B", "C", "E", "F"}, - []string{"B", "E", "H"}, - []string{"H"}, - []string{"B", "E"}, - []uint64{0, 2, 4}, - }, - } - - for _, c := range cases { - c := c - t.Run(c.name, func(t *testing.T) { - t.Parallel() - - vals := NewTestValidatorsWithAliases(t, []string{}) - - for _, name := range c.oldSet { - vals.Create(t, name, 1) - } - for _, name := range c.newSet { - vals.Create(t, name, 1) - } - - oldValidatorSet := vals.GetPublicIdentities(c.oldSet...) - // update voting power to random value - maxVotingPower := big.NewInt(100) - for _, name := range c.updated { - v := vals.GetValidator(name) - vp, err := rand.Int(rand.Reader, maxVotingPower) - require.NoError(t, err) - // make sure generated voting power is different than the original one - v.VotingPower += vp.Uint64() + 1 - } - newValidatorSet := vals.GetPublicIdentities(c.newSet...) - - delta, err := CreateValidatorSetDelta(oldValidatorSet, newValidatorSet) - require.NoError(t, err) - - // added validators - require.Len(t, delta.Added, len(c.added)) - for i, name := range c.added { - require.Equal(t, delta.Added[i].Address, vals.GetValidator(name).Address()) - } - - // removed validators - for _, i := range c.removed { - require.True(t, delta.Removed.IsSet(i)) - } - - // updated validators - require.Len(t, delta.Updated, len(c.updated)) - for i, name := range c.updated { - require.Equal(t, delta.Updated[i].Address, vals.GetValidator(name).Address()) - } - }) - } -} diff --git a/consensus/polybft/validator/validator_set_test.go b/consensus/polybft/validator/validator_set_test.go deleted file mode 100644 index 6dad5bc..0000000 --- a/consensus/polybft/validator/validator_set_test.go +++ /dev/null @@ -1,53 +0,0 @@ -package validator - -import ( - "math/big" - "testing" - - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/types" -) - -func TestValidatorSet_HasQuorum(t *testing.T) { - t.Parallel() - - // enough signers for quorum (2/3 super-majority of validators are signers) - validators := NewTestValidatorsWithAliases(t, []string{"A", "B", "C", "D", "E", "F", "G"}) - vs := validators.ToValidatorSet() - - signers := make(map[types.Address]struct{}) - - validators.IterAcct([]string{"A", "B", "C", "D", "E"}, func(v *TestValidator) { - signers[v.Address()] = struct{}{} - }) - - require.True(t, vs.HasQuorum(1, signers)) - - // not enough signers for quorum (less than 2/3 super-majority of validators are signers) - signers = make(map[types.Address]struct{}) - - validators.IterAcct([]string{"A", "B", "C", "D"}, func(v *TestValidator) { - signers[v.Address()] = struct{}{} - }) - require.False(t, vs.HasQuorum(1, signers)) -} - -func TestValidatorSet_getQuorumSize(t *testing.T) { - t.Parallel() - - cases := []struct { - totalVotingPower int64 - expectedQuorumSize int64 - }{ - {10, 7}, - {12, 8}, - {13, 9}, - {50, 34}, - {100, 67}, - } - - for _, c := range cases { - quorumSize := getQuorumSize(1, big.NewInt(c.totalVotingPower)) - require.Equal(t, c.expectedQuorumSize, quorumSize.Int64()) - } -} diff --git a/consensus/polybft/validators_snapshot.go b/consensus/polybft/validators_snapshot.go deleted file mode 100644 index 2f7735d..0000000 --- a/consensus/polybft/validators_snapshot.go +++ /dev/null @@ -1,358 +0,0 @@ -package polybft - -import ( - "errors" - "fmt" - "sync" - - "github.com/hashicorp/go-hclog" - "github.com/xgr-network/xgr-node/blockchain" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/types" - bolt "go.etcd.io/bbolt" -) - -type validatorSnapshot struct { - Epoch uint64 `json:"epoch"` - EpochEndingBlock uint64 `json:"epochEndingBlock"` - Snapshot validator.AccountSet `json:"snapshot"` -} - -func (vs *validatorSnapshot) copy() *validatorSnapshot { - copiedAccountSet := vs.Snapshot.Copy() - - return &validatorSnapshot{ - Epoch: vs.Epoch, - EpochEndingBlock: vs.EpochEndingBlock, - Snapshot: copiedAccountSet, - } -} - -type validatorsSnapshotCache struct { - snapshots map[uint64]*validatorSnapshot - state *State - blockchain blockchainBackend - lock sync.Mutex - logger hclog.Logger -} - -// newValidatorsSnapshotCache initializes a new instance of validatorsSnapshotCache -func newValidatorsSnapshotCache( - logger hclog.Logger, state *State, blockchain blockchainBackend, -) *validatorsSnapshotCache { - return &validatorsSnapshotCache{ - snapshots: map[uint64]*validatorSnapshot{}, - state: state, - blockchain: blockchain, - logger: logger.Named("validators_snapshot"), - } -} - -// GetSnapshot tries to retrieve the most recent cached snapshot (if any) and -// applies pending validator set deltas to it. -// Otherwise, it builds a snapshot from scratch and applies pending validator set deltas. -func (v *validatorsSnapshotCache) GetSnapshot( - blockNumber uint64, parents []*types.Header, dbTx *bolt.Tx) (validator.AccountSet, error) { - tx := dbTx - isPassedTxNil := dbTx == nil - - if isPassedTxNil { - // if no tx is passed, we need to open one, because, - // GetSnapshot is called from multiple routines (new sequence, fsm, OnBlockInserted, etc) - // and what can happen is that one routine takes its lock, and without a global tx, - // a deadlock can happen between that routine and OnBlockInserted, because it to - // is calling GetSnapshot, but it also opens a global db tx, resulting in a deadlock - // between one routine waiting to get a transaction on db, and OnBlockInserted waiting - // to get the validatorsSnapshotCache lock - t, err := v.state.beginDBTransaction(true) - if err != nil { - return nil, err - } - - tx = t - defer tx.Rollback() //nolint:errcheck - } - - v.lock.Lock() - defer func() { - v.lock.Unlock() - }() - - _, extra, err := getBlockData(blockNumber, v.blockchain) - if err != nil { - return nil, err - } - - isEpochEndingBlock, err := isEpochEndingBlock(blockNumber, extra, v.blockchain) - if err != nil && !errors.Is(err, blockchain.ErrNoBlock) { - // if there is no block after given block, we assume its not epoch ending block - // but, it's a regular use case, and we should not stop the snapshot calculation - // because there are cases we need the snapshot for the latest block in chain - return nil, err - } - - epochToGetSnapshot := extra.Checkpoint.EpochNumber - if !isEpochEndingBlock { - epochToGetSnapshot-- - } - - v.logger.Trace("Retrieving snapshot started...", "Block", blockNumber, "Epoch", epochToGetSnapshot) - - latestValidatorSnapshot, err := v.getLastCachedSnapshot(epochToGetSnapshot, tx) - if err != nil { - return nil, err - } - - if latestValidatorSnapshot != nil && latestValidatorSnapshot.Epoch == epochToGetSnapshot { - // we have snapshot for required block (epoch) in cache - return latestValidatorSnapshot.Snapshot, nil - } - - if latestValidatorSnapshot == nil { - // Haven't managed to retrieve snapshot for any epoch from the cache. - // Build snapshot from the scratch, by applying delta from the genesis block. - genesisBlockSnapshot, err := v.computeSnapshot(nil, 0, parents) - if err != nil { - return nil, fmt.Errorf("failed to compute snapshot for epoch 0: %w", err) - } - - err = v.storeSnapshot(genesisBlockSnapshot, tx) - if err != nil { - return nil, fmt.Errorf("failed to store validators snapshot for epoch 0: %w", err) - } - - latestValidatorSnapshot = genesisBlockSnapshot - - v.logger.Trace("Built validators snapshot for genesis block") - } - - deltasCount := 0 - - v.logger.Trace("Applying deltas started...", "LatestSnapshotEpoch", latestValidatorSnapshot.Epoch) - - // Create the snapshot for the desired block (epoch) by incrementally applying deltas to the latest stored snapshot - for latestValidatorSnapshot.Epoch < epochToGetSnapshot { - nextEpochEndBlockNumber, err := v.getNextEpochEndingBlock(latestValidatorSnapshot.EpochEndingBlock) - if err != nil { - return nil, fmt.Errorf("failed to get the epoch ending block for epoch: %d. Error: %w", - latestValidatorSnapshot.Epoch+1, err) - } - - v.logger.Trace("Applying delta", "epochEndBlock", nextEpochEndBlockNumber) - - intermediateSnapshot, err := v.computeSnapshot(latestValidatorSnapshot, nextEpochEndBlockNumber, parents) - if err != nil { - return nil, fmt.Errorf("failed to compute snapshot for epoch %d: %w", latestValidatorSnapshot.Epoch+1, err) - } - - latestValidatorSnapshot = intermediateSnapshot - if err = v.storeSnapshot(latestValidatorSnapshot, tx); err != nil { - return nil, fmt.Errorf("failed to store validators snapshot for epoch %d: %w", latestValidatorSnapshot.Epoch, err) - } - - deltasCount++ - } - - v.logger.Trace( - fmt.Sprintf("Applied %d delta(s) to the validators snapshot", deltasCount), - "Epoch", latestValidatorSnapshot.Epoch, - ) - - if err := v.cleanup(tx); err != nil { - // error on cleanup should not block or fail any action - v.logger.Error("could not clean validator snapshots from cache and db", "err", err) - } - - if isPassedTxNil { - if err := tx.Commit(); err != nil { - return nil, err - } - } - - return latestValidatorSnapshot.Snapshot, nil -} - -// computeSnapshot gets desired block header by block number, extracts its extra and applies given delta to the snapshot -func (v *validatorsSnapshotCache) computeSnapshot( - existingSnapshot *validatorSnapshot, - nextEpochEndBlockNumber uint64, - parents []*types.Header, -) (*validatorSnapshot, error) { - var header *types.Header - - v.logger.Trace("Compute snapshot started...", "BlockNumber", nextEpochEndBlockNumber) - - if len(parents) > 0 { - for i := len(parents) - 1; i >= 0; i-- { - parentHeader := parents[i] - if parentHeader.Number == nextEpochEndBlockNumber { - v.logger.Trace("Compute snapshot. Found header in parents", "Header", parentHeader.Number) - header = parentHeader - - break - } - } - } - - if header == nil { - var ok bool - - header, ok = v.blockchain.GetHeaderByNumber(nextEpochEndBlockNumber) - if !ok { - return nil, fmt.Errorf("unknown block. Block number=%v", nextEpochEndBlockNumber) - } - } - - extra, err := GetIbftExtra(header.ExtraData) - if err != nil { - return nil, fmt.Errorf("failed to decode extra from the block#%d: %w", header.Number, err) - } - - var ( - snapshot validator.AccountSet - snapshotEpoch uint64 - ) - - if existingSnapshot == nil { - snapshot = validator.AccountSet{} - } else { - snapshot = existingSnapshot.Snapshot - snapshotEpoch = existingSnapshot.Epoch + 1 - } - - snapshot, err = snapshot.ApplyDelta(extra.Validators) - if err != nil { - return nil, fmt.Errorf("failed to apply delta to the validators snapshot, block#%d: %w", header.Number, err) - } - - if len(snapshot) == 0 { - return nil, fmt.Errorf("validator snapshot is empty for block: %d", header.Number) - } - - v.logger.Debug("Computed snapshot", - "blockNumber", nextEpochEndBlockNumber, - "snapshot", snapshot.String(), - "delta", extra.Validators) - - return &validatorSnapshot{ - Epoch: snapshotEpoch, - EpochEndingBlock: nextEpochEndBlockNumber, - Snapshot: snapshot, - }, nil -} - -// storeSnapshot stores given snapshot to the in-memory cache and database -func (v *validatorsSnapshotCache) storeSnapshot(snapshot *validatorSnapshot, dbTx *bolt.Tx) error { - copySnap := snapshot.copy() - v.snapshots[copySnap.Epoch] = copySnap - - if err := v.state.EpochStore.insertValidatorSnapshot(copySnap, dbTx); err != nil { - return fmt.Errorf("failed to insert validator snapshot for epoch %d to the database: %w", copySnap.Epoch, err) - } - - v.logger.Trace("Store snapshot", "Snapshots", v.snapshots) - - return nil -} - -// Cleanup cleans the validators cache in memory and db -func (v *validatorsSnapshotCache) cleanup(dbTx *bolt.Tx) error { - if len(v.snapshots) >= validatorSnapshotLimit { - latestEpoch := uint64(0) - - for e := range v.snapshots { - if e > latestEpoch { - latestEpoch = e - } - } - - startEpoch := latestEpoch - cache := make(map[uint64]*validatorSnapshot, numberOfSnapshotsToLeaveInMemory) - - for i := 0; i < numberOfSnapshotsToLeaveInMemory; i++ { - if snapshot, exists := v.snapshots[startEpoch]; exists { - cache[startEpoch] = snapshot - } - - startEpoch-- - } - - v.snapshots = cache - - return v.state.EpochStore.cleanValidatorSnapshotsFromDB(latestEpoch, dbTx) - } - - return nil -} - -// getLastCachedSnapshot gets the latest snapshot cached -// If it doesn't have snapshot cached for desired epoch, it will return the latest one it has -func (v *validatorsSnapshotCache) getLastCachedSnapshot(currentEpoch uint64, - dbTx *bolt.Tx) (*validatorSnapshot, error) { - cachedSnapshot := v.snapshots[currentEpoch] - if cachedSnapshot != nil { - return cachedSnapshot, nil - } - - // if we do not have a snapshot in memory for given epoch, we will get the latest one we have - for ; currentEpoch >= 0; currentEpoch-- { - cachedSnapshot = v.snapshots[currentEpoch] - if cachedSnapshot != nil { - v.logger.Trace("Found snapshot in memory cache", "Epoch", currentEpoch) - - break - } - - if currentEpoch == 0 { // prevent uint64 underflow - break - } - } - - dbSnapshot, err := v.state.EpochStore.getLastSnapshot(dbTx) - if err != nil { - return nil, err - } - - if dbSnapshot != nil { - // if we do not have any snapshot in memory, or db snapshot is newer than the one in memory - // return the one from db - if cachedSnapshot == nil || dbSnapshot.Epoch > cachedSnapshot.Epoch { - cachedSnapshot = dbSnapshot - // save it in cache as well, since it doesn't exist - v.snapshots[dbSnapshot.Epoch] = dbSnapshot.copy() - } - } - - return cachedSnapshot, nil -} - -// getNextEpochEndingBlock gets the epoch ending block of a newer epoch -// It start checking the blocks from the provided epoch ending block of the previous epoch -func (v *validatorsSnapshotCache) getNextEpochEndingBlock(latestEpochEndingBlock uint64) (uint64, error) { - blockNumber := latestEpochEndingBlock + 1 // get next block - - _, extra, err := getBlockData(blockNumber, v.blockchain) - if err != nil { - return 0, err - } - - startEpoch := extra.Checkpoint.EpochNumber - epoch := startEpoch - - for startEpoch == epoch { - blockNumber++ - - _, extra, err = getBlockData(blockNumber, v.blockchain) - if err != nil { - if errors.Is(err, blockchain.ErrNoBlock) { - return blockNumber - 1, nil - } - - return 0, err - } - - epoch = extra.Checkpoint.EpochNumber - } - - return blockNumber - 1, nil -} diff --git a/consensus/polybft/validators_snapshot_test.go b/consensus/polybft/validators_snapshot_test.go deleted file mode 100644 index eb1aec0..0000000 --- a/consensus/polybft/validators_snapshot_test.go +++ /dev/null @@ -1,316 +0,0 @@ -package polybft - -import ( - "fmt" - "testing" - - "github.com/hashicorp/go-hclog" - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/mock" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/types" -) - -func TestValidatorsSnapshotCache_GetSnapshot_Build(t *testing.T) { - t.Parallel() - assertions := require.New(t) - - const ( - totalValidators = 10 - validatorSetSize = 5 - epochSize = uint64(10) - ) - - allValidators := validator.NewTestValidators(t, totalValidators).GetPublicIdentities() - - var oddValidators, evenValidators validator.AccountSet - - for i := 0; i < totalValidators; i++ { - if i%2 == 0 { - evenValidators = append(evenValidators, allValidators[i]) - } else { - oddValidators = append(oddValidators, allValidators[i]) - } - } - - headersMap := &testHeadersMap{headersByNumber: make(map[uint64]*types.Header)} - - createHeaders(t, headersMap, 0, epochSize-1, 1, nil, allValidators[:validatorSetSize]) - createHeaders(t, headersMap, epochSize, 2*epochSize-1, 2, allValidators[:validatorSetSize], allValidators[validatorSetSize:]) - createHeaders(t, headersMap, 2*epochSize, 3*epochSize-1, 3, allValidators[validatorSetSize:], oddValidators) - createHeaders(t, headersMap, 3*epochSize, 4*epochSize-1, 4, oddValidators, evenValidators) - - var cases = []struct { - blockNumber uint64 - expectedSnapshot validator.AccountSet - validatorsOverlap bool - parents []*types.Header - }{ - {4, allValidators[:validatorSetSize], false, nil}, - {1 * epochSize, allValidators[validatorSetSize:], false, nil}, - {13, allValidators[validatorSetSize:], false, nil}, - {27, oddValidators, true, nil}, - {36, evenValidators, true, nil}, - {4, allValidators[:validatorSetSize], false, headersMap.getHeaders()}, - {13, allValidators[validatorSetSize:], false, headersMap.getHeaders()}, - {27, oddValidators, true, headersMap.getHeaders()}, - {36, evenValidators, true, headersMap.getHeaders()}, - } - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headersMap.getHeader) - - testValidatorsCache := &testValidatorsCache{ - validatorsSnapshotCache: newValidatorsSnapshotCache(hclog.NewNullLogger(), newTestState(t), blockchainMock), - } - - for _, c := range cases { - snapshot, err := testValidatorsCache.GetSnapshot(c.blockNumber, c.parents, nil) - - assertions.NoError(err) - assertions.Len(snapshot, c.expectedSnapshot.Len()) - - if c.validatorsOverlap { - for _, validator := range c.expectedSnapshot { - // Order of validators is not preserved, because there are overlapping between validators set. - // In that case, at the beginning of the set are the ones preserved from the previous validator set. - // Newly validators are added to the end after the one from previous validator set. - assertions.True(snapshot.ContainsAddress(validator.Address)) - } - } else { - assertions.Equal(c.expectedSnapshot, snapshot) - } - - assertions.NoError(testValidatorsCache.cleanValidatorsCache()) - - if c.parents != nil { - blockchainMock.AssertNotCalled(t, "GetHeaderByNumber") - } - } -} - -func TestValidatorsSnapshotCache_GetSnapshot_FetchFromCache(t *testing.T) { - t.Parallel() - require := require.New(t) - - const ( - totalValidators = 10 - validatorSetSize = 5 - ) - - allValidators := validator.NewTestValidators(t, totalValidators).GetPublicIdentities() - epochOneValidators := validator.AccountSet{allValidators[0], allValidators[len(allValidators)-1]} - epochTwoValidators := allValidators[1 : len(allValidators)-2] - - headersMap := &testHeadersMap{headersByNumber: make(map[uint64]*types.Header)} - createHeaders(t, headersMap, 0, 9, 1, nil, allValidators) - createHeaders(t, headersMap, 10, 19, 2, allValidators, epochOneValidators) - createHeaders(t, headersMap, 20, 29, 3, epochOneValidators, epochTwoValidators) - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headersMap.getHeader) - - testValidatorsCache := &testValidatorsCache{ - validatorsSnapshotCache: newValidatorsSnapshotCache(hclog.NewNullLogger(), newTestState(t), blockchainMock), - } - - require.NoError(testValidatorsCache.storeSnapshot(&validatorSnapshot{1, 10, epochOneValidators}, nil)) - require.NoError(testValidatorsCache.storeSnapshot(&validatorSnapshot{2, 20, epochTwoValidators}, nil)) - - // Fetch snapshot from in memory cache - snapshot, err := testValidatorsCache.GetSnapshot(10, nil, nil) - require.NoError(err) - require.Equal(epochOneValidators, snapshot) - - // Invalidate in memory cache - testValidatorsCache.snapshots = map[uint64]*validatorSnapshot{} - require.NoError(testValidatorsCache.state.EpochStore.removeAllValidatorSnapshots()) - // Fetch snapshot from database - snapshot, err = testValidatorsCache.GetSnapshot(10, nil, nil) - require.NoError(err) - require.Equal(epochOneValidators, snapshot) - - snapshot, err = testValidatorsCache.GetSnapshot(20, nil, nil) - require.NoError(err) - require.Equal(epochTwoValidators, snapshot) -} - -func TestValidatorsSnapshotCache_Cleanup(t *testing.T) { - t.Parallel() - require := require.New(t) - - blockchainMock := new(blockchainMock) - cache := &testValidatorsCache{ - validatorsSnapshotCache: newValidatorsSnapshotCache(hclog.NewNullLogger(), newTestState(t), blockchainMock), - } - snapshot := validator.NewTestValidators(t, 3).GetPublicIdentities() - maxEpoch := uint64(0) - - for i := uint64(0); i < validatorSnapshotLimit; i++ { - require.NoError(cache.storeSnapshot(&validatorSnapshot{i, i * 10, snapshot}, nil)) - maxEpoch++ - } - - require.NoError(cache.cleanup(nil)) - - // assertions for remaining snapshots in the in memory cache - require.Len(cache.snapshots, numberOfSnapshotsToLeaveInMemory) - - currentEpoch := maxEpoch - - for i := 0; i < numberOfSnapshotsToLeaveInMemory; i++ { - currentEpoch-- - currentSnapshot, snapExists := cache.snapshots[currentEpoch] - require.True(snapExists, fmt.Sprintf("failed to fetch in memory snapshot for epoch %d", currentEpoch)) - require.Equal(snapshot, currentSnapshot.Snapshot, fmt.Sprintf("snapshots for epoch %d are not equal", currentEpoch)) - } - - stats, err := cache.state.EpochStore.validatorSnapshotsDBStats() - require.NoError(err) - - // assertions for remaining snapshots in database - require.Equal(stats.KeyN, numberOfSnapshotsToLeaveInDB) - - currentEpoch = maxEpoch - - for i := 0; i < numberOfSnapshotsToLeaveInDB; i++ { - currentEpoch-- - currentSnapshot, err := cache.state.EpochStore.getValidatorSnapshot(currentEpoch) - require.NoError(err, fmt.Sprintf("failed to fetch database snapshot for epoch %d", currentEpoch)) - require.Equal(snapshot, currentSnapshot.Snapshot, fmt.Sprintf("snapshots for epoch %d are not equal", currentEpoch)) - } -} - -func TestValidatorsSnapshotCache_ComputeSnapshot_UnknownBlock(t *testing.T) { - t.Parallel() - assertions := assert.New(t) - - const ( - totalValidators = 15 - validatorSetSize = totalValidators / 2 - epochSize = uint64(10) - ) - - allValidators := validator.NewTestValidators(t, totalValidators).GetPublicIdentities() - headersMap := &testHeadersMap{} - headersMap.addHeader(createValidatorDeltaHeader(t, 0, 0, nil, allValidators[:validatorSetSize])) - headersMap.addHeader(createValidatorDeltaHeader(t, 1*epochSize, 1, allValidators[:validatorSetSize], allValidators[validatorSetSize:])) - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headersMap.getHeader) - - testValidatorsCache := &testValidatorsCache{ - validatorsSnapshotCache: newValidatorsSnapshotCache(hclog.NewNullLogger(), newTestState(t), blockchainMock), - } - - snapshot, err := testValidatorsCache.computeSnapshot(nil, 5*epochSize, nil) - assertions.Nil(snapshot) - assertions.ErrorContains(err, "unknown block. Block number=50") -} - -func TestValidatorsSnapshotCache_ComputeSnapshot_IncorrectExtra(t *testing.T) { - t.Parallel() - assertions := assert.New(t) - - const ( - totalValidators = 6 - validatorSetSize = totalValidators / 2 - epochSize = uint64(10) - ) - - allValidators := validator.NewTestValidators(t, totalValidators).GetPublicIdentities() - headersMap := &testHeadersMap{} - invalidHeader := createValidatorDeltaHeader(t, 1*epochSize, 1, allValidators[:validatorSetSize], allValidators[validatorSetSize:]) - invalidHeader.ExtraData = []byte{0x2, 0x7} - headersMap.addHeader(invalidHeader) - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headersMap.getHeader) - - testValidatorsCache := &testValidatorsCache{ - validatorsSnapshotCache: newValidatorsSnapshotCache(hclog.NewNullLogger(), newTestState(t), blockchainMock), - } - - snapshot, err := testValidatorsCache.computeSnapshot(nil, 1*epochSize, nil) - assertions.Nil(snapshot) - assertions.ErrorContains(err, "failed to decode extra from the block#10: wrong extra size: 2") -} - -func TestValidatorsSnapshotCache_ComputeSnapshot_ApplyDeltaFail(t *testing.T) { - t.Parallel() - assertions := assert.New(t) - - const ( - totalValidators = 6 - validatorSetSize = totalValidators / 2 - epochSize = uint64(10) - ) - - allValidators := validator.NewTestValidators(t, totalValidators).GetPublicIdentities() - headersMap := &testHeadersMap{} - headersMap.addHeader(createValidatorDeltaHeader(t, 0, 0, nil, allValidators[:validatorSetSize])) - headersMap.addHeader(createValidatorDeltaHeader(t, 1*epochSize, 1, nil, allValidators[:validatorSetSize])) - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headersMap.getHeader) - - testValidatorsCache := &testValidatorsCache{ - validatorsSnapshotCache: newValidatorsSnapshotCache(hclog.NewNullLogger(), newTestState(t), blockchainMock), - } - - snapshot, err := testValidatorsCache.computeSnapshot(&validatorSnapshot{0, 0, allValidators}, 1*epochSize, nil) - assertions.Nil(snapshot) - assertions.ErrorContains(err, "failed to apply delta to the validators snapshot, block#10") -} - -func TestValidatorsSnapshotCache_Empty(t *testing.T) { - t.Parallel() - - headersMap := &testHeadersMap{headersByNumber: make(map[uint64]*types.Header)} - - createHeaders(t, headersMap, 0, 1, 1, nil, nil) - - blockchainMock := new(blockchainMock) - blockchainMock.On("GetHeaderByNumber", mock.Anything).Return(headersMap.getHeader) - - testValidatorsCache := &testValidatorsCache{ - validatorsSnapshotCache: newValidatorsSnapshotCache(hclog.NewNullLogger(), newTestState(t), blockchainMock), - } - - _, err := testValidatorsCache.GetSnapshot(1, nil, nil) - assert.ErrorContains(t, err, "validator snapshot is empty for block") -} - -func createHeaders(t *testing.T, headersMap *testHeadersMap, - fromBlock, toBlock, epoch uint64, oldValidators, newValidators validator.AccountSet) { - t.Helper() - - headersMap.addHeader(createValidatorDeltaHeader(t, fromBlock, epoch-1, oldValidators, newValidators)) - - for i := fromBlock + 1; i <= toBlock; i++ { - headersMap.addHeader(createValidatorDeltaHeader(t, i, epoch, nil, nil)) - } -} - -func createValidatorDeltaHeader(t *testing.T, blockNumber, epoch uint64, oldValidatorSet, newValidatorSet validator.AccountSet) *types.Header { - t.Helper() - - delta, _ := validator.CreateValidatorSetDelta(oldValidatorSet, newValidatorSet) - extra := &Extra{Validators: delta, Checkpoint: &CheckpointData{EpochNumber: epoch}} - - return &types.Header{ - Number: blockNumber, - ExtraData: extra.MarshalRLPTo(nil), - } -} - -type testValidatorsCache struct { - *validatorsSnapshotCache -} - -func (c *testValidatorsCache) cleanValidatorsCache() error { - c.snapshots = make(map[uint64]*validatorSnapshot) - - return c.state.EpochStore.removeAllValidatorSnapshots() -} diff --git a/consensus/polybft/wallet/account.go b/consensus/polybft/wallet/account.go deleted file mode 100644 index dcd7c31..0000000 --- a/consensus/polybft/wallet/account.go +++ /dev/null @@ -1,123 +0,0 @@ -package wallet - -import ( - "crypto/ecdsa" - "encoding/hex" - "fmt" - - "github.com/umbracle/ethgo/wallet" - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/secrets" - "github.com/xgr-network/xgr-node/types" -) - -// Account is an account for key signatures -type Account struct { - Ecdsa *wallet.Key - Bls *bls.PrivateKey -} - -// GenerateAccount generates a new random account -func GenerateAccount() (*Account, error) { - key, err := wallet.GenerateKey() - if err != nil { - return nil, fmt.Errorf("cannot generate key. error: %w", err) - } - - blsKey, err := bls.GenerateBlsKey() - if err != nil { - return nil, fmt.Errorf("cannot generate bls key. error: %w", err) - } - - return &Account{ - Ecdsa: key, - Bls: blsKey, - }, nil -} - -// NewAccountFromSecret creates new account by using provided secretsManager -func NewAccountFromSecret(secretsManager secrets.SecretsManager) (*Account, error) { - ecdsaKey, err := GetEcdsaFromSecret(secretsManager) - if err != nil { - return nil, err - } - - blsKey, err := GetBlsFromSecret(secretsManager) - if err != nil { - return nil, err - } - - return &Account{Ecdsa: ecdsaKey, Bls: blsKey}, nil -} - -// GetEcdsaFromSecret retrieves validator(ECDSA) key by using provided secretsManager -func GetEcdsaFromSecret(secretsManager secrets.SecretsManager) (*wallet.Key, error) { - encodedKey, err := secretsManager.GetSecret(secrets.ValidatorKey) - if err != nil { - return nil, fmt.Errorf("failed to retrieve ecdsa key: %w", err) - } - - ecdsaRaw, err := hex.DecodeString(string(encodedKey)) - if err != nil { - return nil, fmt.Errorf("failed to retrieve ecdsa key: %w", err) - } - - key, err := wallet.NewWalletFromPrivKey(ecdsaRaw) - if err != nil { - return nil, fmt.Errorf("failed to retrieve ecdsa key: %w", err) - } - - return key, nil -} - -// GetBlsFromSecret retrieves BLS key by using provided secretsManager -func GetBlsFromSecret(secretsManager secrets.SecretsManager) (*bls.PrivateKey, error) { - encodedKey, err := secretsManager.GetSecret(secrets.ValidatorBLSKey) - if err != nil { - return nil, fmt.Errorf("failed to retrieve bls key: %w", err) - } - - blsKey, err := bls.UnmarshalPrivateKey(encodedKey) - if err != nil { - return nil, fmt.Errorf("failed to retrieve bls key: %w", err) - } - - return blsKey, nil -} - -// Save persists ECDSA and BLS private keys to the SecretsManager -func (a *Account) Save(secretsManager secrets.SecretsManager) (err error) { - var ( - ecdsaRaw []byte - blsRaw []byte - ) - - // get serialized ecdsa private key - if ecdsaRaw, err = a.Ecdsa.MarshallPrivateKey(); err != nil { - return err - } - - if err = secretsManager.SetSecret(secrets.ValidatorKey, []byte(hex.EncodeToString(ecdsaRaw))); err != nil { - return err - } - - // get serialized bls private key - if blsRaw, err = a.Bls.Marshal(); err != nil { - return err - } - - return secretsManager.SetSecret(secrets.ValidatorBLSKey, blsRaw) -} - -func (a *Account) GetEcdsaPrivateKey() (*ecdsa.PrivateKey, error) { - ecdsaRaw, err := a.Ecdsa.MarshallPrivateKey() - if err != nil { - return nil, err - } - - return wallet.ParsePrivateKey(ecdsaRaw) -} - -func (a Account) Address() types.Address { - return types.Address(a.Ecdsa.Address()) -} diff --git a/consensus/polybft/wallet/account_test.go b/consensus/polybft/wallet/account_test.go deleted file mode 100644 index 0cd416c..0000000 --- a/consensus/polybft/wallet/account_test.go +++ /dev/null @@ -1,82 +0,0 @@ -package wallet - -import ( - "fmt" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/secrets" -) - -func TestAccount(t *testing.T) { - t.Parallel() - - secretsManager := newSecretsManagerMock() - - key := generateTestAccount(t) - pubKeyMarshalled := key.Bls.PublicKey().Marshal() - privKeyMarshalled, err := key.Bls.Marshal() - require.NoError(t, err) - - require.NoError(t, key.Save(secretsManager)) - - key1, err := NewAccountFromSecret(secretsManager) - require.NoError(t, err) - - pubKeyMarshalled1 := key1.Bls.PublicKey().Marshal() - privKeyMarshalled1, err := key1.Bls.Marshal() - require.NoError(t, err) - - assert.Equal(t, key.Ecdsa.Address(), key1.Ecdsa.Address()) - assert.Equal(t, pubKeyMarshalled, pubKeyMarshalled1) - assert.Equal(t, privKeyMarshalled, privKeyMarshalled1) -} - -func newSecretsManagerMock() secrets.SecretsManager { - return &secretsManagerMock{cache: make(map[string][]byte)} -} - -func generateTestAccount(t *testing.T) *Account { - t.Helper() - - acc, err := GenerateAccount() - require.NoError(t, err) - - return acc -} - -type secretsManagerMock struct { - cache map[string][]byte -} - -func (sm *secretsManagerMock) Setup() error { - return nil -} - -func (sm *secretsManagerMock) GetSecret(name string) ([]byte, error) { - value, exists := sm.cache[name] - if !exists { - return nil, fmt.Errorf("secret does not exists for %s", name) - } - - return value, nil -} - -func (sm *secretsManagerMock) SetSecret(name string, value []byte) error { - sm.cache[name] = value - - return nil -} - -func (sm *secretsManagerMock) HasSecret(name string) bool { - _, exists := sm.cache[name] - - return exists -} - -func (sm *secretsManagerMock) RemoveSecret(name string) error { - delete(sm.cache, name) - - return nil -} diff --git a/consensus/polybft/wallet/key.go b/consensus/polybft/wallet/key.go deleted file mode 100644 index e574ae3..0000000 --- a/consensus/polybft/wallet/key.go +++ /dev/null @@ -1,87 +0,0 @@ -package wallet - -import ( - "fmt" - - "github.com/0xPolygon/go-ibft/messages/proto" - "github.com/umbracle/ethgo" - protobuf "google.golang.org/protobuf/proto" - - "github.com/xgr-network/xgr-node/consensus/polybft/signer" - "github.com/xgr-network/xgr-node/crypto" - "github.com/xgr-network/xgr-node/types" -) - -type Key struct { - raw *Account -} - -func NewKey(raw *Account) *Key { - return &Key{ - raw: raw, - } -} - -// String returns hex encoded ECDSA address -func (k *Key) String() string { - return k.raw.Ecdsa.Address().String() -} - -// Address returns ECDSA address -func (k *Key) Address() ethgo.Address { - return k.raw.Ecdsa.Address() -} - -// Sign signs the provided digest with BLS key -// Used only to sign transactions -func (k *Key) Sign(digest []byte) ([]byte, error) { - return k.SignWithDomain(digest, signer.DomainCommonSigning) -} - -// SignWithDomain signs the provided digest with BLS key and provided domain -func (k *Key) SignWithDomain(digest, domain []byte) ([]byte, error) { - signature, err := k.raw.Bls.Sign(digest, domain) - if err != nil { - return nil, err - } - - return signature.Marshal() -} - -// SignIBFTMessage signs the IBFT consensus message with ECDSA key -func (k *Key) SignIBFTMessage(msg *proto.Message) (*proto.Message, error) { - msgRaw, err := protobuf.Marshal(msg) - if err != nil { - return nil, fmt.Errorf("cannot marshal message: %w", err) - } - - if msg.Signature, err = k.raw.Ecdsa.Sign(crypto.Keccak256(msgRaw)); err != nil { - return nil, fmt.Errorf("cannot create message signature: %w", err) - } - - return msg, nil -} - -// RecoverAddressFromSignature calculates keccak256 hash of provided rawContent -// and recovers signer address from given signature and hash -func RecoverAddressFromSignature(sig, rawContent []byte) (types.Address, error) { - pub, err := crypto.RecoverPubkey(sig, crypto.Keccak256(rawContent)) - if err != nil { - return types.Address{}, fmt.Errorf("cannot recover address from signature: %w", err) - } - - return crypto.PubKeyToAddress(pub), nil -} - -// ECDSASigner implements ethgo.Key interface and it is used for signing using provided ECDSA key -type ECDSASigner struct { - *Key -} - -func NewEcdsaSigner(ecdsaKey *Key) *ECDSASigner { - return &ECDSASigner{Key: ecdsaKey} -} - -func (k *ECDSASigner) Sign(b []byte) ([]byte, error) { - return k.raw.Ecdsa.Sign(b) -} diff --git a/consensus/polybft/wallet/key_test.go b/consensus/polybft/wallet/key_test.go deleted file mode 100644 index 0647f93..0000000 --- a/consensus/polybft/wallet/key_test.go +++ /dev/null @@ -1,61 +0,0 @@ -package wallet - -import ( - "testing" - - "github.com/0xPolygon/go-ibft/messages/proto" - "github.com/stretchr/testify/require" - - "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" -) - -func Test_RecoverAddressFromSignature(t *testing.T) { - t.Parallel() - - for _, account := range []*Account{generateTestAccount(t), generateTestAccount(t), generateTestAccount(t)} { - key := NewKey(account) - msgNoSig := &proto.Message{ - From: key.Address().Bytes(), - Type: proto.MessageType_COMMIT, - Payload: &proto.Message_CommitData{}, - } - - msg, err := key.SignIBFTMessage(msgNoSig) - require.NoError(t, err) - - payload, err := msgNoSig.PayloadNoSig() - require.NoError(t, err) - - address, err := RecoverAddressFromSignature(msg.Signature, payload) - require.NoError(t, err) - require.Equal(t, key.Address().Bytes(), address.Bytes()) - } -} - -func Test_Sign(t *testing.T) { - t.Parallel() - - msg := []byte("some message") - - for _, account := range []*Account{generateTestAccount(t), generateTestAccount(t)} { - key := NewKey(account) - ser, err := key.SignWithDomain(msg, signer.DomainCheckpointManager) - - require.NoError(t, err) - - sig, err := bls.UnmarshalSignature(ser) - require.NoError(t, err) - - require.True(t, sig.Verify(key.raw.Bls.PublicKey(), msg, signer.DomainCheckpointManager)) - } -} - -func Test_String(t *testing.T) { - t.Parallel() - - for _, account := range []*Account{generateTestAccount(t), generateTestAccount(t), generateTestAccount(t)} { - key := NewKey(account) - require.Equal(t, key.Address().String(), key.String()) - } -} diff --git a/consensus/utils.go b/consensus/utils.go index ef76764..45a88a8 100644 --- a/consensus/utils.go +++ b/consensus/utils.go @@ -25,8 +25,10 @@ func BuildBlock(params BuildBlockParams) *types.Block { if len(params.Receipts) == 0 { header.ReceiptsRoot = types.EmptyRootHash + header.LogsBloom = types.Bloom{} } else { header.ReceiptsRoot = buildroot.CalculateReceiptsRoot(params.Receipts) + header.LogsBloom = types.CreateBloom(params.Receipts) } header.Sha3Uncles = types.EmptyUncleHash diff --git a/contracts/abis/json.go b/contracts/abis/json.go index 88cb4b0..ccb61c3 100644 --- a/contracts/abis/json.go +++ b/contracts/abis/json.go @@ -4,19 +4,99 @@ const StakingJSONABI = `[ { "inputs": [ { - "internalType": "uint256", - "name": "minNumValidators", - "type": "uint256" + "internalType": "uint64", + "name": "_minNumValidators", + "type": "uint64" }, { - "internalType": "uint256", - "name": "maxNumValidators", - "type": "uint256" + "internalType": "uint64", + "name": "_maxNumValidators", + "type": "uint64" + }, + { + "internalType": "uint64", + "name": "_epochSize", + "type": "uint64" } ], "stateMutability": "nonpayable", "type": "constructor" }, + { + "inputs": [], + "name": "AlreadyInRequestedState", + "type": "error" + }, + { + "inputs": [], + "name": "DelegationPoolClosed", + "type": "error" + }, + { + "inputs": [], + "name": "DelegationPoolMaxExceeded", + "type": "error" + }, + { + "inputs": [], + "name": "DelegatorLimitExceeded", + "type": "error" + }, + { + "inputs": [], + "name": "InsufficientStakeAfterWithdraw", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidCommissionBps", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidEpochSize", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidMinDelegatorStake", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidValidatorTarget", + "type": "error" + }, + { + "inputs": [], + "name": "InvalidWithdrawAmount", + "type": "error" + }, + { + "inputs": [], + "name": "JoinStakeTooLow", + "type": "error" + }, + { + "inputs": [], + "name": "MustDeactivateBeforeUnstake", + "type": "error" + }, + { + "inputs": [], + "name": "NoStake", + "type": "error" + }, + { + "inputs": [], + "name": "UnstakeTooEarly", + "type": "error" + }, + { + "inputs": [], + "name": "ValidatorNotFound", + "type": "error" + }, { "anonymous": false, "inputs": [ @@ -56,65 +136,128 @@ const StakingJSONABI = `[ "type": "event" }, { - "inputs": [], - "name": "VALIDATOR_THRESHOLD", - "outputs": [ + "anonymous": false, + "inputs": [ { - "internalType": "uint128", - "name": "", - "type": "uint128" + "indexed": true, + "internalType": "address", + "name": "account", + "type": "address" + }, + { + "indexed": false, + "internalType": "bool", + "name": "active", + "type": "bool" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "blockNumber", + "type": "uint256" } ], - "stateMutability": "view", - "type": "function" + "name": "ValidatorActivationChanged", + "type": "event" }, { + "anonymous": false, "inputs": [ { + "indexed": true, "internalType": "address", - "name": "", + "name": "validator", "type": "address" + }, + { + "indexed": false, + "internalType": "bool", + "name": "delegationEnabled", + "type": "bool" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "maxTotalDelegatedStake", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "minDelegatorStake", + "type": "uint256" + }, + { + "indexed": false, + "internalType": "uint16", + "name": "commissionBps", + "type": "uint16" } ], - "name": "_addressToBLSPublicKey", - "outputs": [ + "name": "ValidatorPoolConfigUpdated", + "type": "event" + }, + { + "anonymous": false, + "inputs": [ { - "internalType": "bytes", - "name": "", - "type": "bytes" + "indexed": true, + "internalType": "address", + "name": "account", + "type": "address" } ], - "stateMutability": "view", - "type": "function" + "name": "ValidatorRemoved", + "type": "event" }, { + "anonymous": false, "inputs": [ { + "indexed": true, "internalType": "address", - "name": "", + "name": "account", "type": "address" + }, + { + "indexed": false, + "internalType": "uint256", + "name": "amount", + "type": "uint256" } ], - "name": "_addressToIsValidator", + "name": "Withdrawn", + "type": "event" + }, + { + "inputs": [], + "name": "DELEGATOR_MIN_STAKE", "outputs": [ { - "internalType": "bool", + "internalType": "uint256", "name": "", - "type": "bool" + "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { - "inputs": [ + "inputs": [], + "name": "MAX_DELEGATORS_PER_VALIDATOR", + "outputs": [ { - "internalType": "address", + "internalType": "uint256", "name": "", - "type": "address" + "type": "uint256" } ], - "name": "_addressToStakedAmount", + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "MIN_STAKE", "outputs": [ { "internalType": "uint256", @@ -126,14 +269,21 @@ const StakingJSONABI = `[ "type": "function" }, { - "inputs": [ + "inputs": [], + "name": "VALIDATOR_MIN_SELF_STAKE", + "outputs": [ { - "internalType": "address", + "internalType": "uint256", "name": "", - "type": "address" + "type": "uint256" } ], - "name": "_addressToValidatorIndex", + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "VALIDATOR_THRESHOLD", "outputs": [ { "internalType": "uint256", @@ -146,7 +296,7 @@ const StakingJSONABI = `[ }, { "inputs": [], - "name": "_maximumNumValidators", + "name": "VALIDATOR_THRESHOLD_TOTAL", "outputs": [ { "internalType": "uint256", @@ -158,8 +308,14 @@ const StakingJSONABI = `[ "type": "function" }, { - "inputs": [], - "name": "_minimumNumValidators", + "inputs": [ + { + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "accountStake", "outputs": [ { "internalType": "uint256", @@ -171,8 +327,14 @@ const StakingJSONABI = `[ "type": "function" }, { - "inputs": [], - "name": "_stakedAmount", + "inputs": [ + { + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "deactivationEffectiveAtBlock", "outputs": [ { "internalType": "uint256", @@ -186,19 +348,64 @@ const StakingJSONABI = `[ { "inputs": [ { - "internalType": "uint256", + "internalType": "address", + "name": "validator", + "type": "address" + } + ], + "name": "delegate", + "outputs": [], + "stateMutability": "payable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + } + ], + "name": "delegationEnabled", + "outputs": [ + { + "internalType": "bool", "name": "", - "type": "uint256" + "type": "bool" } ], - "name": "_validators", + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [], + "name": "epochSize", "outputs": [ { - "internalType": "address", + "internalType": "uint64", "name": "", + "type": "uint64" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", "type": "address" } ], + "name": "isValidatorThresholdMet", + "outputs": [ + { + "internalType": "bool", + "name": "", + "type": "bool" + } + ], "stateMutability": "view", "type": "function" }, @@ -206,11 +413,11 @@ const StakingJSONABI = `[ "inputs": [ { "internalType": "address", - "name": "addr", + "name": "account", "type": "address" } ], - "name": "accountStake", + "name": "joinEffectiveAtBlock", "outputs": [ { "internalType": "uint256", @@ -225,16 +432,16 @@ const StakingJSONABI = `[ "inputs": [ { "internalType": "address", - "name": "addr", + "name": "account", "type": "address" } ], - "name": "isValidator", + "name": "joinedAtBlock", "outputs": [ { - "internalType": "bool", + "internalType": "uint256", "name": "", - "type": "bool" + "type": "uint256" } ], "stateMutability": "view", @@ -242,12 +449,12 @@ const StakingJSONABI = `[ }, { "inputs": [], - "name": "maximumNumValidators", + "name": "maxNumValidators", "outputs": [ { - "internalType": "uint256", + "internalType": "uint64", "name": "", - "type": "uint256" + "type": "uint64" } ], "stateMutability": "view", @@ -255,12 +462,12 @@ const StakingJSONABI = `[ }, { "inputs": [], - "name": "minimumNumValidators", + "name": "minNumValidators", "outputs": [ { - "internalType": "uint256", + "internalType": "uint64", "name": "", - "type": "uint256" + "type": "uint64" } ], "stateMutability": "view", @@ -279,6 +486,65 @@ const StakingJSONABI = `[ "stateMutability": "nonpayable", "type": "function" }, + { + "inputs": [ + { + "internalType": "bool", + "name": "active_", + "type": "bool" + } + ], + "name": "setActive", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + }, + { + "internalType": "bool", + "name": "active_", + "type": "bool" + } + ], + "name": "setDelegationActive", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "bool", + "name": "delegationEnabled", + "type": "bool" + }, + { + "internalType": "uint256", + "name": "maxTotalDelegatedStake", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "minDelegatorStake", + "type": "uint256" + }, + { + "internalType": "uint16", + "name": "commissionBps", + "type": "uint16" + } + ], + "name": "setValidatorPoolConfig", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, { "inputs": [], "name": "stake", @@ -287,13 +553,61 @@ const StakingJSONABI = `[ "type": "function" }, { - "inputs": [], - "name": "stakedAmount", + "inputs": [ + { + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "stakerInfo", "outputs": [ { - "internalType": "uint256", + "components": [ + { + "internalType": "bool", + "name": "exists", + "type": "bool" + }, + { + "internalType": "bool", + "name": "active", + "type": "bool" + }, + { + "internalType": "uint64", + "name": "index", + "type": "uint64" + }, + { + "internalType": "uint256", + "name": "amount", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "joinedAtBlock", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "deactivatedAtBlock", + "type": "uint256" + }, + { + "internalType": "address", + "name": "validator", + "type": "address" + }, + { + "internalType": "bytes", + "name": "blsPubKey", + "type": "bytes" + } + ], + "internalType": "struct StakingV2.Staker", "name": "", - "type": "uint256" + "type": "tuple" } ], "stateMutability": "view", @@ -306,19 +620,246 @@ const StakingJSONABI = `[ "stateMutability": "nonpayable", "type": "function" }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + } + ], + "name": "unstakeDelegation", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, { "inputs": [], "name": "validatorBLSPublicKeys", "outputs": [ { "internalType": "bytes[]", - "name": "", + "name": "keys", "type": "bytes[]" } ], "stateMutability": "view", "type": "function" }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + } + ], + "name": "validatorDelegatedStakeActive", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + } + ], + "name": "validatorDelegatedStakeRaw", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "account", + "type": "address" + } + ], + "name": "validatorInfo", + "outputs": [ + { + "internalType": "bool", + "name": "exists", + "type": "bool" + }, + { + "internalType": "bool", + "name": "active", + "type": "bool" + }, + { + "internalType": "uint256", + "name": "stakedAmount", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "deactivatedAtBlock", + "type": "uint256" + }, + { + "internalType": "bytes", + "name": "blsPubKey", + "type": "bytes" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + } + ], + "name": "validatorPool", + "outputs": [ + { + "components": [ + { + "internalType": "bool", + "name": "exists", + "type": "bool" + }, + { + "internalType": "bool", + "name": "active", + "type": "bool" + }, + { + "internalType": "bool", + "name": "delegationEnabled", + "type": "bool" + }, + { + "internalType": "uint256", + "name": "maxTotalDelegatedStake", + "type": "uint256" + }, + { + "internalType": "uint256", + "name": "minDelegatorStake", + "type": "uint256" + }, + { + "internalType": "uint16", + "name": "commissionBps", + "type": "uint16" + }, + { + "internalType": "bytes", + "name": "blsPubKey", + "type": "bytes" + } + ], + "internalType": "struct StakingV2.ValidatorPoolConfig", + "name": "", + "type": "tuple" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + } + ], + "name": "validatorSelfStake", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + }, + { + "internalType": "uint256", + "name": "idx", + "type": "uint256" + } + ], + "name": "validatorStakerAt", + "outputs": [ + { + "internalType": "address", + "name": "", + "type": "address" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + } + ], + "name": "validatorStakerCount", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + } + ], + "name": "validatorTotalStake", + "outputs": [ + { + "internalType": "uint256", + "name": "", + "type": "uint256" + } + ], + "stateMutability": "view", + "type": "function" + }, { "inputs": [], "name": "validators", @@ -333,8 +874,35 @@ const StakingJSONABI = `[ "type": "function" }, { - "stateMutability": "payable", - "type": "receive" + "inputs": [ + { + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "withdraw", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" + }, + { + "inputs": [ + { + "internalType": "address", + "name": "validator", + "type": "address" + }, + { + "internalType": "uint256", + "name": "amount", + "type": "uint256" + } + ], + "name": "withdrawDelegation", + "outputs": [], + "stateMutability": "nonpayable", + "type": "function" } ]` diff --git a/contracts/staking/StakingV2.sol b/contracts/staking/StakingV2.sol new file mode 100644 index 0000000..133b587 --- /dev/null +++ b/contracts/staking/StakingV2.sol @@ -0,0 +1,452 @@ +// SPDX-License-Identifier: MIT +pragma solidity ^0.8.20; + +contract StakingV2 { + uint256 public constant VALIDATOR_THRESHOLD_TOTAL = 2_000_000 ether; + uint256 public constant VALIDATOR_MIN_SELF_STAKE = 200_000 ether; + uint256 public constant DELEGATOR_MIN_STAKE = 10_000 ether; + uint256 public constant MAX_DELEGATORS_PER_VALIDATOR = 200; + // Backward-compatible alias + uint256 public constant MIN_STAKE = VALIDATOR_THRESHOLD_TOTAL; + + uint256 public VALIDATOR_THRESHOLD; + uint64 public epochSize; + uint64 public minNumValidators; + uint64 public maxNumValidators; + + struct Staker { + bool exists; + bool active; + uint64 index; + uint256 amount; + uint256 joinedAtBlock; + uint256 deactivatedAtBlock; + address validator; + bytes blsPubKey; + } + + struct ValidatorPoolConfig { + bool exists; + bool active; + bool delegationEnabled; + uint256 maxTotalDelegatedStake; + uint256 minDelegatorStake; + uint16 commissionBps; + bytes blsPubKey; + } + + address[] private _validators; + mapping(address => Staker) private _staker; + address[] private _stakers; + mapping(address => ValidatorPoolConfig) private _poolConfig; + mapping(address => address[]) private _stakersByValidator; + mapping(address => mapping(address => uint256)) private _stakerIndexPlusOneByValidator; + mapping(address => uint256) private _validatorDelegatedStakeRaw; + mapping(address => uint256) private _validatorDelegatedStakeActive; + uint256 private _reentrancyStatus; + + event Staked(address indexed account, uint256 amount); + event Unstaked(address indexed account, uint256 amount); + event ValidatorActivationChanged(address indexed account, bool active, uint256 blockNumber); + event ValidatorRemoved(address indexed account); + event ValidatorPoolConfigUpdated( + address indexed validator, + bool delegationEnabled, + uint256 maxTotalDelegatedStake, + uint256 minDelegatorStake, + uint16 commissionBps + ); + event Withdrawn(address indexed account, uint256 amount); + + error InvalidEpochSize(); + error JoinStakeTooLow(); + error ValidatorNotFound(); + error AlreadyInRequestedState(); + error MustDeactivateBeforeUnstake(); + error UnstakeTooEarly(); + error NoStake(); + error InvalidWithdrawAmount(); + error InsufficientStakeAfterWithdraw(); + error InvalidValidatorTarget(); + error DelegationPoolClosed(); + error DelegationPoolMaxExceeded(); + error InvalidCommissionBps(); + error InvalidMinDelegatorStake(); + error DelegatorLimitExceeded(); + + modifier nonReentrant() { + require(_reentrancyStatus == 0, "REENTRANT"); + _reentrancyStatus = 1; + _; + _reentrancyStatus = 0; + } + + constructor(uint64 _minNumValidators, uint64 _maxNumValidators, uint64 _epochSize) { + if (_epochSize == 0) revert InvalidEpochSize(); + minNumValidators = _minNumValidators; + maxNumValidators = _maxNumValidators; + epochSize = _epochSize; + VALIDATOR_THRESHOLD = VALIDATOR_THRESHOLD_TOTAL; + } + + function validators() external view returns (address[] memory) { + return _validators; + } + + function validatorBLSPublicKeys() external view returns (bytes[] memory keys) { + keys = new bytes[](_validators.length); + for (uint256 i = 0; i < _validators.length; i++) { + keys[i] = _staker[_validators[i]].blsPubKey; + } + } + + function accountStake(address account) external view returns (uint256) { + return _staker[account].amount; + } + + function validatorInfo(address account) + external + view + returns (bool exists, bool active, uint256 stakedAmount, uint256 deactivatedAtBlock, bytes memory blsPubKey) + { + Staker storage s = _staker[account]; + return (s.exists, s.active, s.amount, s.deactivatedAtBlock, s.blsPubKey); + } + + function stakerInfo(address account) external view returns (Staker memory) { + return _staker[account]; + } + + function validatorPool(address validator) external view returns (ValidatorPoolConfig memory) { + return _poolConfig[validator]; + } + + function delegationEnabled(address validator) external view returns (bool) { + return _poolConfig[validator].delegationEnabled; + } + + function validatorSelfStake(address validator) external view returns (uint256) { + Staker storage s = _staker[validator]; + if (!s.exists || s.validator != validator) return 0; + return s.amount; + } + + function validatorDelegatedStakeRaw(address validator) external view returns (uint256) { + return _validatorDelegatedStakeRaw[validator]; + } + + function validatorDelegatedStakeActive(address validator) external view returns (uint256) { + return _validatorDelegatedStakeActive[validator]; + } + + function validatorTotalStake(address validator) public view returns (uint256) { + Staker storage s = _staker[validator]; + if (!s.exists || s.validator != validator) return 0; + uint256 selfStake = s.active ? s.amount : 0; + return selfStake + _validatorDelegatedStakeActive[validator]; + } + + function isValidatorThresholdMet(address validator) external view returns (bool) { + return validatorTotalStake(validator) >= VALIDATOR_THRESHOLD; + } + + function validatorStakerCount(address validator) external view returns (uint256) { + return _stakersByValidator[validator].length; + } + + function validatorStakerAt(address validator, uint256 idx) external view returns (address) { + return _stakersByValidator[validator][idx]; + } + + function joinedAtBlock(address account) external view returns (uint256) { + return _staker[account].joinedAtBlock; + } + + function joinEffectiveAtBlock(address account) external view returns (uint256) { + uint256 joined = _staker[account].joinedAtBlock; + if (joined == 0) return 0; + return (_epochOf(joined) + 1) * uint256(epochSize); + } + + function deactivationEffectiveAtBlock(address account) external view returns (uint256) { + Staker storage s = _staker[account]; + if (s.deactivatedAtBlock == 0) return 0; + return (_epochOf(s.deactivatedAtBlock) + 1) * uint256(epochSize); + } + + function registerBLSPublicKey(bytes calldata blsPubKey) external nonReentrant { + Staker storage s = _staker[msg.sender]; + if (!s.exists || s.validator != msg.sender) revert ValidatorNotFound(); + s.blsPubKey = blsPubKey; + _poolConfig[msg.sender].blsPubKey = blsPubKey; + } + + function stake() external payable nonReentrant { + _stakeFor(msg.sender, msg.sender, msg.value); + } + + function delegate(address validator) external payable nonReentrant { + _stakeFor(msg.sender, validator, msg.value); + } + + function setActive(bool active_) external nonReentrant { + _setStakerActive(msg.sender, msg.sender, active_); + } + + function setDelegationActive(address validator, bool active_) external nonReentrant { + _setStakerActive(msg.sender, validator, active_); + } + + function setValidatorPoolConfig( + bool delegationEnabled, + uint256 maxTotalDelegatedStake, + uint256 minDelegatorStake, + uint16 commissionBps + ) external nonReentrant { + Staker storage s = _staker[msg.sender]; + if (!s.exists || s.validator != msg.sender) revert ValidatorNotFound(); + if (commissionBps > 10000) revert InvalidCommissionBps(); + if (minDelegatorStake != 0 && minDelegatorStake < DELEGATOR_MIN_STAKE) revert InvalidMinDelegatorStake(); + + ValidatorPoolConfig storage p = _poolConfig[msg.sender]; + p.delegationEnabled = delegationEnabled; + p.maxTotalDelegatedStake = maxTotalDelegatedStake; + p.minDelegatorStake = minDelegatorStake; + p.commissionBps = commissionBps; + + emit ValidatorPoolConfigUpdated(msg.sender, delegationEnabled, maxTotalDelegatedStake, minDelegatorStake, commissionBps); + } + + function withdraw(uint256 amount) external nonReentrant { + _withdrawStaker(msg.sender, msg.sender, amount, false); + } + + function withdrawDelegation(address validator, uint256 amount) external nonReentrant { + _withdrawStaker(msg.sender, validator, amount, false); + } + + function unstake() external nonReentrant { + _withdrawStaker(msg.sender, msg.sender, 0, true); + } + + function unstakeDelegation(address validator) external nonReentrant { + _withdrawStaker(msg.sender, validator, 0, true); + } + + + + function _effectiveMinDelegatorStake(address validator) internal view returns (uint256) { + uint256 minDelegatorStake = _poolConfig[validator].minDelegatorStake; + return minDelegatorStake == 0 ? DELEGATOR_MIN_STAKE : minDelegatorStake; + } + + function _delegatorCount(address validator) internal view returns (uint256 count) { + address[] storage stakers = _stakersByValidator[validator]; + for (uint256 i = 0; i < stakers.length; i++) { + if (stakers[i] != validator) count++; + } + } + + function _stakeFor(address owner, address validator, uint256 amount) internal { + if (amount == 0) revert NoStake(); + bool selfStake = owner == validator; + + if (!selfStake) { + Staker storage target = _staker[validator]; + if (!target.exists || target.validator != validator) revert InvalidValidatorTarget(); + + ValidatorPoolConfig storage p = _poolConfig[validator]; + if (!p.delegationEnabled) revert DelegationPoolClosed(); + if (_validatorDelegatedStakeRaw[validator] + amount > p.maxTotalDelegatedStake) revert DelegationPoolMaxExceeded(); + } + + Staker storage s = _staker[owner]; + if (!s.exists) { + uint256 minJoin = selfStake ? VALIDATOR_MIN_SELF_STAKE : _effectiveMinDelegatorStake(validator); + if (amount < minJoin) revert JoinStakeTooLow(); + if (!selfStake && _delegatorCount(validator) >= MAX_DELEGATORS_PER_VALIDATOR) revert DelegatorLimitExceeded(); + + s.exists = true; + s.active = true; + s.index = uint64(_stakers.length); + s.joinedAtBlock = block.number; + s.validator = validator; + _stakers.push(owner); + + _stakerIndexPlusOneByValidator[validator][owner] = _stakersByValidator[validator].length + 1; + _stakersByValidator[validator].push(owner); + + if (selfStake) { + _validators.push(owner); + _poolConfig[owner].exists = true; + _poolConfig[owner].active = true; + _poolConfig[owner].delegationEnabled = false; + _poolConfig[owner].maxTotalDelegatedStake = 0; + _poolConfig[owner].minDelegatorStake = 0; + _poolConfig[owner].commissionBps = 0; + } + } else { + if (s.validator != validator) revert InvalidValidatorTarget(); + } + + s.amount += amount; + _syncAggregatorOnStake(owner, validator, amount, s.active); + + emit Staked(owner, amount); + } + + function _setStakerActive(address owner, address expectedValidator, bool active_) internal { + Staker storage s = _staker[owner]; + if (!s.exists || s.validator != expectedValidator) revert ValidatorNotFound(); + if (s.active == active_) revert AlreadyInRequestedState(); + + uint256 minStake = owner == expectedValidator ? VALIDATOR_MIN_SELF_STAKE : _effectiveMinDelegatorStake(expectedValidator); + if (active_ && s.amount < minStake) revert InsufficientStakeAfterWithdraw(); + + s.active = active_; + if (active_) { + s.deactivatedAtBlock = 0; + } else { + s.deactivatedAtBlock = block.number; + } + + if (owner == expectedValidator) { + _poolConfig[owner].active = active_; + } + + _syncAggregatorOnToggle(owner, expectedValidator, s.amount, active_); + emit ValidatorActivationChanged(owner, active_, block.number); + } + + function _withdrawStaker(address owner, address expectedValidator, uint256 amount, bool fullExit) internal { + Staker storage s = _staker[owner]; + if (!s.exists || s.validator != expectedValidator) revert ValidatorNotFound(); + if (s.active) revert MustDeactivateBeforeUnstake(); + if (s.deactivatedAtBlock == 0) revert MustDeactivateBeforeUnstake(); + if (_epochOf(block.number) <= _epochOf(s.deactivatedAtBlock)) revert UnstakeTooEarly(); + + uint256 payout; + if (fullExit) { + payout = s.amount; + } else { + if (amount == 0 || amount >= s.amount) revert InvalidWithdrawAmount(); + uint256 minStake = owner == expectedValidator ? VALIDATOR_MIN_SELF_STAKE : _effectiveMinDelegatorStake(expectedValidator); + uint256 remaining = s.amount - amount; + if (remaining < minStake) revert InsufficientStakeAfterWithdraw(); + payout = amount; + s.amount = remaining; + } + + if (fullExit) { + _syncAggregatorOnUnstake(owner, expectedValidator, s.amount, s.active); + if (owner == expectedValidator) { + _removeValidator(owner); + delete _poolConfig[owner]; + } + _removeFromValidatorDelegators(expectedValidator, owner); + _removeStaker(owner); + emit Unstaked(owner, payout); + if (owner == expectedValidator) { + emit ValidatorRemoved(owner); + } + } else { + _syncAggregatorOnWithdraw(owner, expectedValidator, payout, s.active); + emit Withdrawn(owner, payout); + } + + (bool ok, ) = payable(owner).call{value: payout}(""); + require(ok, "transfer failed"); + } + + function _syncAggregatorOnStake(address owner, address validator, uint256 amount, bool active_) internal { + if (owner == validator) { + return; + } + + _validatorDelegatedStakeRaw[validator] += amount; + if (active_) { + _validatorDelegatedStakeActive[validator] += amount; + } + } + + function _syncAggregatorOnToggle(address owner, address validator, uint256 amount, bool active_) internal { + if (owner == validator) { + return; + } + if (active_) { + _validatorDelegatedStakeActive[validator] += amount; + } else { + _validatorDelegatedStakeActive[validator] -= amount; + } + } + + function _syncAggregatorOnWithdraw(address owner, address validator, uint256 amount, bool active_) internal { + if (owner == validator) { + return; + } + _validatorDelegatedStakeRaw[validator] -= amount; + if (active_) { + _validatorDelegatedStakeActive[validator] -= amount; + } + } + + function _syncAggregatorOnUnstake(address owner, address validator, uint256 amount, bool active_) internal { + if (owner == validator) { + return; + } + _validatorDelegatedStakeRaw[validator] -= amount; + if (active_) { + _validatorDelegatedStakeActive[validator] -= amount; + } + } + + function _removeValidator(address account) internal { + uint256 last = _validators.length - 1; + uint256 idx; + for (uint256 i = 0; i < _validators.length; i++) { + if (_validators[i] == account) { + idx = i; + break; + } + } + if (idx != last) { + _validators[idx] = _validators[last]; + } + _validators.pop(); + } + + function _removeFromValidatorDelegators(address validator, address owner) internal { + uint256 idxPlusOne = _stakerIndexPlusOneByValidator[validator][owner]; + if (idxPlusOne == 0) return; + + uint256 idx = idxPlusOne - 1; + uint256 last = _stakersByValidator[validator].length - 1; + + if (idx != last) { + address moved = _stakersByValidator[validator][last]; + _stakersByValidator[validator][idx] = moved; + _stakerIndexPlusOneByValidator[validator][moved] = idx + 1; + } + + _stakersByValidator[validator].pop(); + delete _stakerIndexPlusOneByValidator[validator][owner]; + } + + function _removeStaker(address owner) internal { + uint256 idx = _staker[owner].index; + uint256 last = _stakers.length - 1; + + if (idx != last) { + address moved = _stakers[last]; + _stakers[idx] = moved; + _staker[moved].index = uint64(idx); + } + + _stakers.pop(); + delete _staker[owner]; + } + + function _epochOf(uint256 blockNumber) internal view returns (uint256) { + return blockNumber / uint256(epochSize); + } +} diff --git a/contracts/staking/query.go b/contracts/staking/query.go index 5592442..14832de 100644 --- a/contracts/staking/query.go +++ b/contracts/staking/query.go @@ -1,8 +1,12 @@ package staking import ( + "encoding/hex" "errors" + "fmt" "math/big" + "reflect" + "strings" "github.com/umbracle/ethgo" @@ -15,6 +19,12 @@ import ( const ( methodValidators = "validators" methodValidatorBLSPublicKeys = "validatorBLSPublicKeys" + methodAccountStake = "accountStake" + methodMinimumNumValidators = "minNumValidators" + methodMaximumNumValidators = "maxNumValidators" + methodValidatorThreshold = "VALIDATOR_THRESHOLD" + methodValidatorInfo = "validatorInfo" + methodStakerInfo = "stakerInfo" ) var ( @@ -37,22 +47,89 @@ type TxQueryHandler interface { // decodeWeb3ArrayOfBytes is a helper function to parse the data // representing array of bytes in contract result -func decodeWeb3ArrayOfBytes( - result interface{}, -) ([][]byte, error) { +func decodeWeb3ArrayOfBytes(method *abi.Method, result interface{}) ([][]byte, error) { mapResult, ok := result.(map[string]interface{}) if !ok { return nil, ErrFailedTypeAssertion } - bytesArray, ok := mapResult["0"].([][]byte) + value, ok := mapResult["0"] + if !ok { + outputs := method.Outputs.TupleElems() + if len(outputs) > 0 { + if name := outputs[0].Name; name != "" { + value, ok = mapResult[name] + } + } + } + if !ok && len(mapResult) == 1 { + for _, v := range mapResult { + value = v + ok = true + } + } if !ok { return nil, ErrFailedTypeAssertion } + bytesArray, err := decodeBytesArray(value) + if err != nil { + return nil, ErrFailedTypeAssertion + } + return bytesArray, nil } +func decodeBytesArray(raw interface{}) ([][]byte, error) { + v := reflect.ValueOf(raw) + if !v.IsValid() { + return nil, fmt.Errorf("unexpected value") + } + if v.Kind() != reflect.Slice && v.Kind() != reflect.Array { + return nil, fmt.Errorf("unexpected value") + } + + out := make([][]byte, 0, v.Len()) + for i := 0; i < v.Len(); i++ { + b, err := toBytes(v.Index(i).Interface()) + if err != nil { + return nil, err + } + out = append(out, b) + } + + return out, nil +} + +func toBytes(raw interface{}) ([]byte, error) { + switch v := raw.(type) { + case []byte: + return v, nil + case string: + v = strings.TrimPrefix(v, "0x") + if v == "" { + return []byte{}, nil + } + return hex.DecodeString(v) + } + + rv := reflect.ValueOf(raw) + if !rv.IsValid() { + return nil, fmt.Errorf("unexpected item type") + } + + if (rv.Kind() == reflect.Array || rv.Kind() == reflect.Slice) && rv.Type().Elem().Kind() == reflect.Uint8 { + b := make([]byte, rv.Len()) + for i := 0; i < rv.Len(); i++ { + b[i] = byte(rv.Index(i).Uint()) + } + + return b, nil + } + + return nil, fmt.Errorf("unexpected item type") +} + // createCallViewTx is a helper function to create a transaction to call view method func createCallViewTx( from types.Address, @@ -133,7 +210,7 @@ func decodeBLSPublicKeys( return nil, err } - blsPublicKeys, err := decodeWeb3ArrayOfBytes(decodedResults) + blsPublicKeys, err := decodeWeb3ArrayOfBytes(method, decodedResults) if err != nil { return nil, err } @@ -166,3 +243,272 @@ func QueryBLSPublicKeys(t TxQueryHandler, from types.Address) ([][]byte, error) return decodeBLSPublicKeys(method, res.ReturnValue) } + +// QueryAccountStake returns account stake amount for the given validator address. +func QueryAccountStake(t TxQueryHandler, from, validator types.Address) (*big.Int, error) { + method, ok := abis.StakingABI.Methods[methodAccountStake] + if !ok { + return nil, ErrMethodNotFoundInABI + } + + methodInput, err := method.Inputs.Encode(map[string]interface{}{ + "account": ethgo.Address(validator), + }) + if err != nil { + return nil, err + } + + t.SetNonPayable(true) + res, err := t.Apply(createCallViewTx( + from, + AddrStakingContract, + append(method.ID(), methodInput...), + t.GetNonce(from), + )) + if err != nil { + return nil, err + } + + if res.Failed() { + return nil, res.Err + } + + decodedResults, err := method.Outputs.Decode(res.ReturnValue) + if err != nil { + return nil, err + } + + mapResult, ok := decodedResults.(map[string]interface{}) + if !ok { + return nil, ErrFailedTypeAssertion + } + + stake, ok := mapResult["0"].(*big.Int) + if !ok { + return nil, ErrFailedTypeAssertion + } + + return stake, nil +} + +// ValidatorInfo is a decoded snapshot of validatorInfo(account). +type ValidatorInfo struct { + Exists bool + Active bool + StakedAmount *big.Int + DeactivatedAtBlock *big.Int + BLSPubKey []byte +} + +type StakerInfo struct { + Exists bool + Active bool + Amount *big.Int + JoinedAtBlock *big.Int + DeactivatedAtBlock *big.Int + Validator types.Address +} + +// QueryValidatorInfo returns validator metadata for the given account. +func QueryValidatorInfo(t TxQueryHandler, from, validator types.Address) (*ValidatorInfo, error) { + method, ok := abis.StakingABI.Methods[methodValidatorInfo] + if !ok { + return nil, ErrMethodNotFoundInABI + } + + methodInput, err := method.Inputs.Encode(map[string]interface{}{ + "account": ethgo.Address(validator), + }) + if err != nil { + return nil, err + } + + t.SetNonPayable(true) + res, err := t.Apply(createCallViewTx( + from, + AddrStakingContract, + append(method.ID(), methodInput...), + t.GetNonce(from), + )) + if err != nil { + return nil, err + } + if res.Failed() { + return nil, res.Err + } + + decodedResults, err := method.Outputs.Decode(res.ReturnValue) + if err != nil { + return nil, err + } + mapResult, ok := decodedResults.(map[string]interface{}) + if !ok { + return nil, ErrFailedTypeAssertion + } + + exists, ok := mapResult["0"].(bool) + if !ok { + exists, ok = mapResult["exists"].(bool) + if !ok { + return nil, ErrFailedTypeAssertion + } + } + active, ok := mapResult["1"].(bool) + if !ok { + active, ok = mapResult["active"].(bool) + if !ok { + return nil, ErrFailedTypeAssertion + } + } + stakedAmount, ok := mapResult["2"].(*big.Int) + if !ok { + stakedAmount, ok = mapResult["stakedAmount"].(*big.Int) + if !ok { + return nil, ErrFailedTypeAssertion + } + } + deact, ok := mapResult["3"].(*big.Int) + if !ok { + deact, ok = mapResult["deactivatedAtBlock"].(*big.Int) + if !ok { + return nil, ErrFailedTypeAssertion + } + } + bls, ok := mapResult["4"].([]byte) + if !ok { + bls, ok = mapResult["blsPubKey"].([]byte) + if !ok { + return nil, ErrFailedTypeAssertion + } + } + + return &ValidatorInfo{ + Exists: exists, + Active: active, + StakedAmount: stakedAmount, + DeactivatedAtBlock: deact, + BLSPubKey: bls, + }, nil +} + +func QueryStakerInfo(t TxQueryHandler, from, account types.Address) (*StakerInfo, error) { + method, ok := abis.StakingABI.Methods[methodStakerInfo] + if !ok { + return nil, ErrMethodNotFoundInABI + } + methodInput, err := method.Inputs.Encode(map[string]interface{}{"account": ethgo.Address(account)}) + if err != nil { + return nil, err + } + + t.SetNonPayable(true) + res, err := t.Apply(createCallViewTx(from, AddrStakingContract, append(method.ID(), methodInput...), t.GetNonce(from))) + if err != nil { + return nil, err + } + if res.Failed() { + return nil, res.Err + } + + decodedResults, err := method.Outputs.Decode(res.ReturnValue) + if err != nil { + return nil, err + } + mp, ok := decodedResults.(map[string]interface{}) + if !ok { + return nil, ErrFailedTypeAssertion + } + raw, ok := mp["0"].(map[string]interface{}) + if !ok { + return nil, ErrFailedTypeAssertion + } + out := &StakerInfo{} + if v, ok := raw["exists"].(bool); ok { + out.Exists = v + } + if v, ok := raw["active"].(bool); ok { + out.Active = v + } + if v, ok := raw["amount"].(*big.Int); ok { + out.Amount = v + } else { + out.Amount = new(big.Int) + } + if v, ok := raw["joinedAtBlock"].(*big.Int); ok { + out.JoinedAtBlock = v + } else { + out.JoinedAtBlock = new(big.Int) + } + if v, ok := raw["deactivatedAtBlock"].(*big.Int); ok { + out.DeactivatedAtBlock = v + } else { + out.DeactivatedAtBlock = new(big.Int) + } + if v, ok := raw["validator"].(ethgo.Address); ok { + out.Validator = types.Address(v) + } + + return out, nil +} +func queryUint256NoArgs(t TxQueryHandler, from types.Address, methodName string) (*big.Int, error) { + method, ok := abis.StakingABI.Methods[methodName] + if !ok { + return nil, ErrMethodNotFoundInABI + } + + t.SetNonPayable(true) + res, err := t.Apply(createCallViewTx( + from, + AddrStakingContract, + method.ID(), + t.GetNonce(from), + )) + if err != nil { + return nil, err + } + if res.Failed() { + return nil, res.Err + } + + decodedResults, err := method.Outputs.Decode(res.ReturnValue) + if err != nil { + return nil, err + } + mapResult, ok := decodedResults.(map[string]interface{}) + if !ok { + return nil, ErrFailedTypeAssertion + } + if val, ok := mapResult["0"].(*big.Int); ok { + return val, nil + } + if valU64, ok := mapResult["0"].(uint64); ok { + return new(big.Int).SetUint64(valU64), nil + } + if valU, ok := mapResult["0"].(uint); ok { + return new(big.Int).SetUint64(uint64(valU)), nil + } + return nil, ErrFailedTypeAssertion +} + +// QueryMinimumNumValidators returns the contract's minimum validator count. +func QueryMinimumNumValidators(t TxQueryHandler, from types.Address) (uint64, error) { + v, err := queryUint256NoArgs(t, from, methodMinimumNumValidators) + if err != nil { + return 0, err + } + return v.Uint64(), nil +} + +// QueryMaximumNumValidators returns the contract's maximum validator count. +func QueryMaximumNumValidators(t TxQueryHandler, from types.Address) (uint64, error) { + v, err := queryUint256NoArgs(t, from, methodMaximumNumValidators) + if err != nil { + return 0, err + } + return v.Uint64(), nil +} + +// QueryValidatorThreshold returns the stake threshold (in wei) required to be considered eligible. +func QueryValidatorThreshold(t TxQueryHandler, from types.Address) (*big.Int, error) { + return queryUint256NoArgs(t, from, methodValidatorThreshold) +} diff --git a/contracts/staking/query_test.go b/contracts/staking/query_test.go index 41b60c0..dfacd62 100644 --- a/contracts/staking/query_test.go +++ b/contracts/staking/query_test.go @@ -6,6 +6,7 @@ import ( "testing" "github.com/stretchr/testify/assert" + "github.com/umbracle/ethgo" "github.com/xgr-network/xgr-node/contracts/abis" "github.com/xgr-network/xgr-node/state/runtime" "github.com/xgr-network/xgr-node/types" @@ -59,6 +60,10 @@ func (m *TxMock) Apply(tx *types.Transaction) (*runtime.ExecutionResult, error) return nil, errors.New("not found") } +func (m *TxMock) Call(tx *types.Transaction) (*runtime.ExecutionResult, error) { + return m.Apply(tx) +} + func (m *TxMock) GetNonce(addr types.Address) uint64 { if m.nonce != nil { return m.nonce[addr] @@ -225,3 +230,89 @@ func TestQueryValidators(t *testing.T) { }) } } + +func TestQueryAccountStake(t *testing.T) { + method := abis.StakingABI.Methods["accountStake"] + if method == nil { + t.Fail() + } + + input, err := method.Inputs.Encode(map[string]interface{}{"account": ethgo.Address(addr2)}) + assert.NoError(t, err) + + tx := &types.Transaction{ + From: addr1, + To: &AddrStakingContract, + Value: big.NewInt(0), + Input: append(method.ID(), input...), + GasPrice: big.NewInt(0), + Gas: queryGasLimit, + Nonce: 7, + } + + expectedStake := big.NewInt(12345) + encodedOut, err := method.Outputs.Encode(map[string]interface{}{"0": expectedStake}) + assert.NoError(t, err) + + mock := &TxMock{ + hashToRes: map[types.Hash]*runtime.ExecutionResult{ + tx.ComputeHash(1).Hash: {ReturnValue: encodedOut}, + }, + nonce: map[types.Address]uint64{addr1: 7}, + } + + stake, err := QueryAccountStake(mock, addr1, addr2) + assert.NoError(t, err) + assert.Equal(t, 0, expectedStake.Cmp(stake)) +} + +func TestDecodeBLSPublicKeys(t *testing.T) { + method := abis.StakingABI.Methods["validatorBLSPublicKeys"] + if method == nil { + t.FailNow() + } + + want := [][]byte{{0x01, 0x02}, {0x03, 0x04}} + + encoded, err := method.Outputs.Encode(map[string]interface{}{"keys": want}) + assert.NoError(t, err) + + res, err := decodeBLSPublicKeys(method, encoded) + assert.NoError(t, err) + assert.Equal(t, want, res) +} + +func TestDecodeWeb3ArrayOfBytes_FixedArrayItems(t *testing.T) { + method := abis.StakingABI.Methods["validatorBLSPublicKeys"] + if method == nil { + t.FailNow() + } + + res, err := decodeWeb3ArrayOfBytes(method, map[string]interface{}{"keys": [][2]byte{{0x01, 0x02}, {0x03, 0x04}}}) + assert.NoError(t, err) + assert.Equal(t, [][]byte{{0x01, 0x02}, {0x03, 0x04}}, res) +} + +func TestStakingABI_SetValidatorPoolConfigSignature(t *testing.T) { + m := abis.StakingABI.Methods["setValidatorPoolConfig"] + assert.NotNil(t, m) + assert.Equal(t, 4, len(m.Inputs.TupleElems())) + assert.Equal(t, "delegationEnabled", m.Inputs.TupleElems()[0].Name) + assert.Equal(t, "maxTotalDelegatedStake", m.Inputs.TupleElems()[1].Name) + assert.Equal(t, "minDelegatorStake", m.Inputs.TupleElems()[2].Name) + assert.Equal(t, "commissionBps", m.Inputs.TupleElems()[3].Name) +} + +func TestStakingABI_ValidatorPoolTupleNames(t *testing.T) { + m := abis.StakingABI.Methods["validatorPool"] + assert.NotNil(t, m) + out := m.Outputs.TupleElems()[0] + elems := out.Elem.TupleElems() + assert.Equal(t, "exists", elems[0].Name) + assert.Equal(t, "active", elems[1].Name) + assert.Equal(t, "delegationEnabled", elems[2].Name) + assert.Equal(t, "maxTotalDelegatedStake", elems[3].Name) + assert.Equal(t, "minDelegatorStake", elems[4].Name) + assert.Equal(t, "commissionBps", elems[5].Name) + assert.Equal(t, "blsPubKey", elems[6].Name) +} diff --git a/docker/README.md b/docker/README.md deleted file mode 100644 index 85de78e..0000000 --- a/docker/README.md +++ /dev/null @@ -1,66 +0,0 @@ -# Deploying local docker cluster - -## Prerequisites - -* [Docker Engine](https://docs.docker.com/engine/install/) - Minimum version 20.10.23 -* [Docker compose v.1.x](https://docs.docker.com/compose/install/) - Minimum version 1.29 - -### `polybft` consensus - -When deploying with `polybft` consensus, there are some additional dependencies: - -* [go 1.20.x](https://go.dev/dl/) - -## Local development - -Running `xgrchain` local cluster with docker can be done very easily by using provided `scripts` folder -or by running `docker-compose` manually. - -### Using provided `scripts` folder - -***All commands need to be run from the repo root / root folder.*** - -* `scripts/cluster ibft --docker` - deploy environment with `ibft` consensus -* `scripts/cluster polybft --docker` - deploy environment with `polybft` consensus -* `scripts/cluster {ibft or polybft} --docker stop` - stop containers -* `scripts/cluster {ibft or polybft}--docker destroy` - destroy environment (delete containers and volumes) - -### Using `docker-compose` - -***All commands need to be run from the repo root / root folder.*** - -#### use `ibft` PoA consensus - -* `export EDGE_CONSENSUS=ibft` - set `ibft` consensus -* `docker-compose -f ./docker/local/docker-compose.yml up -d --build` - deploy environment - -#### use `polybft` consensus - -* `export EDGE_CONSENSUS=polybft` - set `polybft` consensus -* `docker-compose -f ./docker/local/docker-compose.yml up -d --build` - deploy environment - -#### stop / destroy - -* `docker-compose -f ./docker/local/docker-compose.yml stop` - stop containers -* `docker-compose -f ./docker/local/docker-compose.yml down -v` - destroy environment - -## Customization - -Use `docker/local/xgrchain.sh` script to customize chain parameters. -All parameters can be defined at the very beginning of the script, in the `CHAIN_CUSTOM_OPTIONS` variable. -It already has some default parameters, which can be easily modified. -These are the `genesis` parameters from the official [docs](https://wiki.xgr.network/docs/edge/operate/param-reference/). - -Primarily, the `--premine` parameter needs to be edited to include the accounts that the user has access to. - -## Considerations - -### Build times - -When building containers for the first time (or after purging docker build cache), -it might take a while to complete, depending on the hardware that the build operation is running on. - -### Production - -This is **NOT** a production ready deployment. It is to be used in *development* / *test* environments only. -For production usage, please check out the official [docs](https://wiki.xgr.network/docs/edge/). diff --git a/docker/local/docker-compose.yml b/docker/local/docker-compose.yml index da0e258..5d0734a 100644 --- a/docker/local/docker-compose.yml +++ b/docker/local/docker-compose.yml @@ -31,7 +31,7 @@ services: dockerfile: docker/local/Dockerfile image: local/xgrchain container_name: xgrchain-bootstrapper - command: [ "init", "${EDGE_CONSENSUS:-polybft}" ] + command: [ "init", "${EDGE_CONSENSUS:-ibft}" ] depends_on: rootchain: condition: service_started @@ -44,7 +44,7 @@ services: node-1: image: local/xgrchain container_name: xgrchain-validator-1 - command: [ "start-node-1", "${EDGE_CONSENSUS:-polybft}" ] + command: [ "start-node-1", "${EDGE_CONSENSUS:-ibft}" ] depends_on: init: condition: service_completed_successfully diff --git a/docker/local/xgrchain.sh b/docker/local/xgrchain.sh index ed2506d..fc2c7fb 100644 --- a/docker/local/xgrchain.sh +++ b/docker/local/xgrchain.sh @@ -50,89 +50,12 @@ case "$1" in createGenesisConfig "$2" "$secrets" fi ;; - "polybft") - echo "Generating PolyBFT secrets..." - secrets=$("$XGRCHAIN_BIN" polybft-secrets init --insecure --num 4 --data-dir /data/data- --json) - echo "Secrets have been successfully generated" - - rm -f /data/genesis.json - - proxyContractsAdmin=0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed - - createGenesisConfig "$2" "$secrets" \ - --reward-wallet 0xDEADBEEF:1000000 \ - --native-token-config "XGR:XGR:18:true:$(echo "$secrets" | jq -r '.[0] | .address')" \ - --proxy-contracts-admin ${proxyContractsAdmin} - - echo "Deploying stake manager..." - "$XGRCHAIN_BIN" polybft stake-manager-deploy \ - --jsonrpc http://rootchain:8545 \ - --genesis /data/genesis.json \ - --proxy-contracts-admin ${proxyContractsAdmin} \ - --test - - stakeManagerAddr=$(cat /data/genesis.json | jq -r '.params.engine.polybft.bridge.stakeManagerAddr') - stakeToken=$(cat /data/genesis.json | jq -r '.params.engine.polybft.bridge.stakeTokenAddr') - - "$XGRCHAIN_BIN" rootchain deploy \ - --stake-manager ${stakeManagerAddr} \ - --stake-token ${stakeToken} \ - --json-rpc http://rootchain:8545 \ - --genesis /data/genesis.json \ - --proxy-contracts-admin ${proxyContractsAdmin} \ - --test - - customSupernetManagerAddr=$(cat /data/genesis.json | jq -r '.params.engine.polybft.bridge.customSupernetManagerAddr') - supernetID=$(cat /data/genesis.json | jq -r '.params.engine.polybft.supernetID') - addresses="$(echo "$secrets" | jq -r '.[0] | .address'),$(echo "$secrets" | jq -r '.[1] | .address'),$(echo "$secrets" | jq -r '.[2] | .address'),$(echo "$secrets" | jq -r '.[3] | .address')" - - "$XGRCHAIN_BIN" rootchain fund \ - --json-rpc http://rootchain:8545 \ - --stake-token ${stakeToken} \ - --mint \ - --addresses ${addresses} \ - --amounts 1000000000000000000000000,1000000000000000000000000,1000000000000000000000000,1000000000000000000000000 - - "$XGRCHAIN_BIN" polybft whitelist-validators \ - --addresses ${addresses} \ - --supernet-manager ${customSupernetManagerAddr} \ - --private-key aa75e9a7d427efc732f8e4f1a5b7646adcc61fd5bae40f80d13c8419c9f43d6d \ - --jsonrpc http://rootchain:8545 - - counter=1 - while [ $counter -le 4 ]; do - echo "Registering validator: ${counter}" - - "$XGRCHAIN_BIN" polybft register-validator \ - --supernet-manager ${customSupernetManagerAddr} \ - --data-dir /data/data-${counter} \ - --jsonrpc http://rootchain:8545 - - "$XGRCHAIN_BIN" polybft stake \ - --data-dir /data/data-${counter} \ - --amount 1000000000000000000000000 \ - --supernet-id ${supernetID} \ - --stake-manager ${stakeManagerAddr} \ - --stake-token ${stakeToken} \ - --jsonrpc http://rootchain:8545 - - counter=$((counter + 1)) - done - - "$XGRCHAIN_BIN" polybft supernet \ - --private-key aa75e9a7d427efc732f8e4f1a5b7646adcc61fd5bae40f80d13c8419c9f43d6d \ - --supernet-manager ${customSupernetManagerAddr} \ - --finalize-genesis-set \ - --enable-staking \ - --genesis /data/genesis.json \ - --jsonrpc http://rootchain:8545 - ;; esac ;; "start-node-1") relayer_flag="" - # Start relayer only when run in polybft - if [ "$2" == "polybft" ]; then + # Start relayer only when run in ibft + if [ "$2" == "ibft" ]; then echo "Starting relayer..." relayer_flag="--relayer" fi diff --git a/docs/Dockerfile b/docs/Dockerfile deleted file mode 100644 index bb63d18..0000000 --- a/docs/Dockerfile +++ /dev/null @@ -1,17 +0,0 @@ -FROM python:3.9-alpine - -# Install system dependencies -RUN apk update && \ - apk add --no-cache rsync git nodejs npm && \ - rm -rf /var/cache/apk/* - -# Copy and install Python dependencies -COPY requirements.txt requirements.txt -RUN pip install -r requirements.txt --no-cache-dir - -# Switch to a non-root user (if 'nonroot' is already created) -USER nonroot - -# Build doc by default -ENTRYPOINT ["mkdocs"] -CMD ["serve", "--dev-addr", "0.0.0.0:8000"] diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index d6ace6c..0000000 --- a/docs/README.md +++ /dev/null @@ -1,48 +0,0 @@ -# XGRChain docs - -Welcome to the XGRChain documentation, built with [the Material theme for MkDocs](https://squidfunk.github.io/mkdocs-material/). - -## Build and serve the site - -### Clone the repo - -```sh -https://github.com/xgr-network/xgr-node.git -cd xgrchain/docs -``` - -### Run with Python - -1. Download and install Python 3.11: https://www.python.org/downloads/ - -2. Install the `virtualenv` package: - -```sh -pip install virtualenv -``` - -3. Build and serve the html - -```sh -./run.sh -``` - -The site runs at: http://127.0.0.1:8000/ - -### Run with Docker - -:warning: Remove line 10 from the `Dockerfile` to run locally. - -1. Spin up the image: - -```sh -docker build -t xgrchain-docs . -``` - -2. Run the container: - -``` -docker compose up -``` - -The site runs at: http://127.0.0.1:8000/ \ No newline at end of file diff --git a/docs/docker-compose.yml b/docs/docker-compose.yml deleted file mode 100644 index 62f0aef..0000000 --- a/docs/docker-compose.yml +++ /dev/null @@ -1,13 +0,0 @@ -version: "3.6" - -services: - developer-docs: - image: "xgrchain-docs" - ports: - - "0.0.0.0:8000:8000" - container_name: "serve-edge-docs" - working_dir: /workspace/ - volumes: - - type: bind - source: . - target: /workspace diff --git a/docs/docs/api/json-rpc-bridge.md b/docs/docs/api/json-rpc-bridge.md deleted file mode 100644 index f58f0e6..0000000 --- a/docs/docs/api/json-rpc-bridge.md +++ /dev/null @@ -1,31 +0,0 @@ -## bridge_generateExitProof - -Returns the proof for a given exit event. Used by users that want to exit the L2 chain and withdraw tokens to L1. - -### Parameters - -**exitID** - ID of the exit event submitted by L2StateSender contract when the user wants to exit the L2 contract. - -### Returns - - -- **Object** - A proof object containing: - - **Array of hashes** - representing the proof of membership of a given exit event on some checkpoint. - - **Map** - containing a leaf index of given exit event in the Merkle tree, Exit event and block number in which checkpoint that contains a given exit event was submitted to the rootchain. - ---- - -## bridge_getStateSyncProof - -Returns the proof for a given state sync event. Used by users (Relayer) when they want to execute a state change on the childchain (for example, depositing funds from L1 to L2). - -### Parameters - -**stateSyncID** - ID of the state sync event submitted by StateSender contract. - -### Returns - - -- **Object** - A proof object containing: - - **Array of hashes** - representing the proof of membership of a given state sync event on some commitment. - - **Map** - containing the state sync event data. diff --git a/docs/docs/api/json-rpc-debug.md b/docs/docs/api/json-rpc-debug.md deleted file mode 100644 index 117550f..0000000 --- a/docs/docs/api/json-rpc-debug.md +++ /dev/null @@ -1,137 +0,0 @@ -To enable the debug route namespace, you need to modify the configuration and add the "debug" parameter as shown below: - -``` -[jsonrpc.http] - enabled = true - port = 8545 - host = "0.0.0.0" - api = ["eth", "net", "web3", "txpool", "bor", "debug"] -``` - -## debug_traceBlockByNumber - -Executes all transactions in the block specified by number with a tracer and returns the tracing result. - -### Parameters - -* QUANTITY|TAG - integer of a block number, or the string "latest" -* Object - The tracer options: - - + enableMemory: Boolean - (optional, default: false) The flag indicating enabling memory capture. - + disableStack: Boolean - (optional, default: false) The flag indicating disabling stack capture. - + disableStorage: Boolean - (optional, default: false) The flag indicating disabling storage capture. - + enableReturnData: Boolean - (optional, default: false) The flag indicating enabling return data capture. - + timeOut: String - (optional, default: "5s") The timeout for cancellation of execution. - + tracer: String - (default: "structTracer") Defines the debug tracer used for given call. Supported values: structTracer, callTracer. - - -### Returns - - Array - Array of trace objects with the following fields: - - * failed: Boolean - the tx is successful or not - * gas: QUANTITY - the total consumed gas in the tx - * returnValue: DATA - the return value of the executed contract call - * structLogs: Array - the trace result of each step with the following fields: - - + pc: QUANTITY - the current index in bytecode - + op: String - the name of current executing operation - + gas: QUANTITY - the available gas ßin the execution - + gasCost: QUANTITY - the gas cost of the operation - + depth: QUANTITY - the number of levels of calling functions - + error: String - the error of the execution - + stack: Array - array of values in the current stack - + memory: Array - array of values in the current memory - + storage: Object - mapping of the current storage - + refund: QUANTITY - the total of current refund value - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"debug_traceBlockByNumber","params":["latest"],"id":1}' -```` - -## debug_traceBlockByHash - -Executes all transactions in the block specified by block hash with a tracer and returns the tracing result. - -### Parameters - -* DATA , 32 Bytes - Hash of a block. -* Object - The tracer options. See debug_traceBlockByNumber for more details. - -### Returns - - Array - Array of trace objects. See debug_traceBlockByNumber for more details. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"debug_traceBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"],"id":1}' -```` - -## debug_traceBlock - -Executes all transactions in the block given from the first argument with a tracer and returns the tracing result. - -### Parameters - -* DATA - RLP Encoded block bytes -* Object - The tracer options. See debug_traceBlockByNumber for more details. - -### Returns - - Array - Array of trace objects. See debug_traceBlockByNumber for more details. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"debug_traceBlock","params":["0xf9...."],"id":1}' -```` - -## debug_traceTransaction - -Executes the transaction specified by transaction hash with a tracer and returns the tracing result. - -### Parameters - -* DATA , 32 Bytes - Hash of a transaction. -* Object - The tracer options. See debug_traceBlockByNumber for more details. - -### Returns - - Object - Trace object. See debug_traceBlockByNumber for more details. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"debug_traceTransaction","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae"],"id":1}' -```` - -## debug_traceCall - -Executes a new message call with a tracer and returns the tracing result. - -### Parameters - -* Object - The transaction call object - - + from: DATA, 20 Bytes - (optional) The address the transaction is sent from. - + to: DATA, 20 Bytes - The address the transaction is directed to. - + gas: QUANTITY - (optional) Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions. - + gasPrice: QUANTITY - (optional) Integer of the gasPrice used for each paid gas - + value: QUANTITY - (optional) Integer of the value sent with this transaction - + data: DATA - (optional) Hash of the method signature and encoded parameters. For details see Ethereum Contract ABI in the Solidity documentation - -* QUANTITY|TAG - integer block number, or the string "latest" -* Object - The tracer options. See debug_traceBlockByNumber for more details. - -### Returns - - Object - Trace object. See debug_traceBlockByNumber for more details. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"debug_traceCall","params":[{"to": "0x1234", "data": "0x1234"}, "latest", {}],"id":1}' -```` diff --git a/docs/docs/api/json-rpc-eth.md b/docs/docs/api/json-rpc-eth.md deleted file mode 100644 index aa5e5f0..0000000 --- a/docs/docs/api/json-rpc-eth.md +++ /dev/null @@ -1,580 +0,0 @@ -## eth_chainId - -Returns the currently configured chain id, a value used in replay-protected transaction signing as introduced by EIP-155. - -### Parameters - -* None - -### Returns - - -* QUANTITY - big integer of the current chain id. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' -```` - -## eth_syncing - -Returns information about the sync status of the node - -### Parameters - -* None - -### Returns - - -* Boolean (FALSE) - if the node isn't syncing (which means it has fully synced) - -* Object - an object with sync status data if the node is syncing - * startingBlock: QUANTITY - The block at which the import started (will only be reset, after the sync reached his head) - * currentBlock: QUANTITY - The current block, same as eth_blockNumber - * highestBlock: QUANTITY - The estimated highest block - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}' -```` - -## eth_getBlockByNumber - -Returns block information by number. - -### Parameters - -* QUANTITY|TAG - integer of a block number, or the string "latest" -* Boolean - If true it returns the full transaction objects, if false only the hashes of the transactions. - -### Returns - -Object - A block object, or null when no block was found: - -* number: QUANTITY - the block number. -* hash: DATA, 32 Bytes - hash of the block. -* parentHash: DATA, 32 Bytes - hash of the parent block. -* nonce: DATA, 8 Bytes - hash of the generated proof-of-work. -* sha3Uncles: DATA, 32 Bytes - SHA3 of the uncles data in the block. -* logsBloom: DATA, 256 Bytes - the bloom filter for the logs of the block. -* transactionsRoot: DATA, 32 Bytes - the root of the transaction trie of the block. -* stateRoot: DATA, 32 Bytes - the root of the final state trie of the block. -* receiptsRoot: DATA, 32 Bytes - the root of the receipts trie of the block. -* miner: DATA, 20 Bytes - the address of the beneficiary to whom the mining rewards were given. -* difficulty: QUANTITY - integer of the difficulty for this block. -* totalDifficulty: QUANTITY - integer of the total difficulty of the chain until this block. -* extraData: DATA - the β€œextra data” field of this block. -* size: QUANTITY - integer the size of this block in bytes. -* gasLimit: QUANTITY - the maximum gas allowed in this block. -* gasUsed: QUANTITY - the total used gas by all transactions in this block. -* timestamp: QUANTITY - the unix timestamp for when the block was collated. -* transactions: Array - Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter. -* uncles: Array - Array of uncle hashes. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest", true],"id":1}' -```` - -## eth_getBlockByHash - -Returns block information by hash. - -### Parameters - -* DATA , 32 Bytes - Hash of a block. -* Boolean - If true it returns the full transaction objects, if false only the hashes of the transactions. - -### Returns - - Object - A block object, or null when no block was found: - -* number: QUANTITY - the block number. -* hash: DATA, 32 Bytes - hash of the block. -* parentHash: DATA, 32 Bytes - hash of the parent block. -* nonce: DATA, 8 Bytes - hash of the generated proof-of-work. -* sha3Uncles: DATA, 32 Bytes - SHA3 of the uncles data in the block. -* logsBloom: DATA, 256 Bytes - the bloom filter for the logs of the block. -* transactionsRoot: DATA, 32 Bytes - the root of the transaction trie of the block. -* stateRoot: DATA, 32 Bytes - the root of the final state trie of the block. -* receiptsRoot: DATA, 32 Bytes - the root of the receipts trie of the block. -* miner: DATA, 20 Bytes - the address of the beneficiary to whom the mining rewards were given. -* difficulty: QUANTITY - integer of the difficulty for this block. -* totalDifficulty: QUANTITY - integer of the total difficulty of the chain until this block. -* extraData: DATA - the β€œextra data” field of this block. -* size: QUANTITY - integer the size of this block in bytes. -* gasLimit: QUANTITY - the maximum gas allowed in this block. -* gasUsed: QUANTITY - the total used gas by all transactions in this block. -* timestamp: QUANTITY - the unix timestamp for when the block was collated. -* transactions: Array - Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter. -* uncles: Array - Array of uncle hashes. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",false],"id":1}' -```` - -## eth_blockNumber - -Returns the number of the most recent block. - -### Parameters - -None - -### Returns - - -* QUANTITY - integer of the current block number the client is on. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' -```` - -## eth_gasPrice - -Returns the current price of gas in wei. -If minimum gas price is enforced by setting the `--price-limit` flag, -this endpoint will return the value defined by this flag as minimum gas price. - ---- - -### Parameters - -None - -### Returns - - -* QUANTITY - integer of the current gas price in wei. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":1}' -```` - -## eth_getBalance - -Returns the balance of the account of the given address. - -### Parameters - -* DATA, 20 Bytes - address to check for balance. -* QUANTITY|TAG - integer block number, or the string "latest" - -### Returns - - -* QUANTITY - integer of the current balance in wei. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}' -```` - -## eth_sendRawTransaction - -Creates new message call transaction or a contract creation for signed transactions. - -### Parameters - -* DATA - The signed transaction data. - -### Returns - - -* DATA, 32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"],"id":1}' -```` - -## eth_getTransactionByHash - -Returns the information about a transaction requested by transaction hash. - -### Parameters - -* DATA, 32 Bytes - hash of a transaction - -### Returns - - Object - A transaction object, or null when no transaction was found: - -* blockHash: DATA, 32 Bytes - hash of the block where this transaction was in. -* blockNumber: QUANTITY - block number where this transaction was in. -* from: DATA, 20 Bytes - address of the sender. -* gas: QUANTITY - gas provided by the sender. -* gasPrice: QUANTITY - gas price provided by the sender in Wei. -* hash: DATA, 32 Bytes - hash of the transaction. -* input: DATA - the data send along with the transaction. -* nonce: QUANTITY - the number of transactions made by the sender prior to this one. -* to: DATA, 20 Bytes - address of the receiver. null when its a contract creation transaction. -* transactionIndex: QUANTITY - integer of the transactions index position in the block. -* value: QUANTITY - value transferred in Wei. -* v: QUANTITY - ECDSA recovery id -* r: DATA, 32 Bytes - ECDSA signature r -* s: DATA, 32 Bytes - ECDSA signature s - -### Example -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}' -```` - -## eth_getTransactionReceipt - -Returns the receipt of a transaction by transaction hash. - -Note That the receipt is not available for pending transactions. - -### Parameters - -* DATA, 32 Bytes - hash of a transaction - -### Returns - - Object - A transaction receipt object, or null when no receipt was found: - -* transactionHash : DATA, 32 Bytes - hash of the transaction. -* transactionIndex: QUANTITY - integer of the transactions index position in the block. -* blockHash: DATA, 32 Bytes - hash of the block where this transaction was in. -* blockNumber: QUANTITY - block number where this transaction was in. -* from: DATA, 20 Bytes - address of the sender. -* to: DATA, 20 Bytes - address of the receiver. null when its a contract creation transaction. -* cumulativeGasUsed : QUANTITY - The total amount of gas used when this transaction was executed in the block. -* gasUsed : QUANTITY - The amount of gas used by this specific transaction alone. -* contractAddress : DATA, 20 Bytes - The contract address created, if the transaction was a contract creation, otherwise null. -* logs: Array - Array of log objects, which this transaction generated. -* logsBloom: DATA, 256 Bytes - Bloom filter for light clients to quickly retrieve related logs. - -It also returns either : - -* root : DATA 32 bytes - post-transaction stateroot (pre Byzantium) -* status: QUANTITY - either 1 (success) or 0 (failure) - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1}' -```` - -## eth_getTransactionCount - -Returns the number of transactions sent from an address. - -### Parameters - -* DATA, 20 Bytes - address. -* QUANTITY|TAG - integer block number, or the string "latest" - -### Returns - - -* QUANTITY - integer of the number of transactions send from this address. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}' -```` - -## eth_getBlockTransactionCountByNumber - -Returns the number of transactions in a block matching the given block number. - -### Parameters - -* QUANTITY|TAG - integer of a block number, or the string "latest" - -### Returns - - -* QUANTITY - integer of the number of transactions in this block. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["latest"],"id":1}' -```` - -## eth_getLogs - -Returns an array of all logs matching a given filter object. - -### Parameters - Object - The filter options: - -* fromBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block -* toBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block -* address: DATA|Array, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate. -* topics: Array of DATA - (optional) Array of 32 Bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with β€œor” options. -* blockhash: DATA, 32 Bytes - (optional, future) With the addition of EIP-234, blockHash will be a new filter option which restricts the logs returned to the single block with the 32-byte hash blockHash. Using blockHash is equivalent to fromBlock = toBlock = the block number with hash blockHash. If blockHash is present in the filter criteria, then neither fromBlock nor toBlock is allowed. - -### Returns - - -* QUANTITY - integer of the number of transactions send from this address. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics": ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":1}' -```` - -## eth_getCode - -Returns code at a given address. - -### Parameters - -* DATA, 20 Bytes - address -* QUANTITY|TAG - integer block number, or the string "latest" - -### Returns - - -* DATA - the code from the given address. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x2"],"id":1}' -```` - -## eth_call - -Executes a new message call immediately without creating a transaction on the blockchain. - -### Parameters - Object - The transaction call object - -* from: DATA, 20 Bytes - (optional) The address the transaction is sent from. -* to: DATA, 20 Bytes - The address the transaction is directed to. -* gas: QUANTITY - (optional) Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions. -* gasPrice: QUANTITY - (optional) Integer of the gasPrice used for each paid gas -* value: QUANTITY - (optional) Integer of the value sent with this transaction -* data: DATA - (optional) Hash of the method signature and encoded parameters. For details see Ethereum Contract ABI in the Solidity documentation -* QUANTITY|TAG - integer block number, or the string "latest", see the default block paramete - -### Returns - - -* DATA - the return value of executed contract. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}' -```` - -## eth_getStorageAt - -Returns the value from a storage position at a given address. - -### Parameters - -* DATA, 20 Bytes - address of the storage. -* QUANTITY - integer of the position in the storage. -* QUANTITY|TAG - integer block number, or the string "latest" - -### Returns - - -* DATA - the value at this storage position. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getStorageAt","params":["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"],"id":1}' -```` - -## eth_estimateGas - -Generates and returns an estimate of how much gas is necessary to allow the transaction to complete. The transaction will not be added to the blockchain. Note that the estimate may be significantly more than the amount of gas actually used by the transaction, for a variety of reasons including EVM mechanics and node performance. - -### Parameters - -Expect that all properties are optional. - - Object - The transaction call object - -* from: DATA, 20 Bytes - The address the transaction is sent from. -* to: DATA, 20 Bytes - The address the transaction is directed to. -* gas: QUANTITY - Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions. -* gasPrice: QUANTITY - Integer of the gasPrice used for each paid gas -* value: QUANTITY - Integer of the value sent with this transaction -* data: DATA - Hash of the method signature and encoded parameters. For details see Ethereum Contract ABI in the Solidity documentation -* QUANTITY|TAG - integer block number, or the string "latest", see the default block paramete - -### Returns - - -* QUANTITY - the amount of gas used. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}' -```` - -## eth_newFilter - -Creates a filter object, based on filter options. -To get all matching logs for specific filter, call eth_getFilterLogs. -To check if the state has changed, call eth_getFilterChanges. - -### Parameters - Object - The filter options: - -* fromBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block -* toBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block -* address: DATA|Array, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate. -* topics: Array of DATA - (optional) Array of 32 Bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with β€œor” options. - -### Returns - - -* QUANTITY - A filter id. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":1}' -```` - -## eth_newBlockFilter - -Creates a filter in the node, to notify when a new block arrives. -To check if the state has changed, call eth_getFilterChanges. - -### Parameters - -None - -### Returns - - -1. QUANTITY - A filter id. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":1}' -```` - - - -## eth_getFilterLogs - -Returns an array of all logs matching filter with given id. - -:::caution eth_getLogs vs. eth_getFilterLogs -These 2 methods will return the same results for same filter options: -1. eth_getLogs with params [options] -2. eth_newFilter with params [options], getting a [filterId] back, then calling eth_getFilterLogs with [filterId] -::: - -### Parameters - -* QUANTITY - the filter id. - -### Returns - - Array - Array of log objects, or an empty array - -* For filters created with eth_newFilter logs are objects with the following params: - * removed: TAG - true when the log was removed, due to a chain reorganization. false if its a valid log. - * logIndex: QUANTITY - integer of the log index position in the block. null when its pending log. - * transactionIndex: QUANTITY - integer of the transactions index position log was created from. null when its pending log. - * transactionHash: DATA, 32 Bytes - hash of the transactions this log was created from. null when its pending log. - * blockHash: DATA, 32 Bytes - hash of the block where this log was in. null when its pending log. - * blockNumber: QUANTITY - the block number where this log was in. null when its pending log. - * address: DATA, 20 Bytes - address from which this log originated. - * data: DATA - contains one or more 32 Bytes non-indexed arguments of the log. - * topics: Array of DATA - Array of 0 to 4 32 Bytes DATA of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier.) - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":1}' -```` - -## eth_getFilterChanges - -Polling method for a filter, which returns an array of logs that occurred since the last poll. - -### Parameters - -* QUANTITY - the filter id. - -### Returns - - Array - Array of log objects, or an empty array if nothing has changed since last poll. - -* For filters created with eth_newBlockFilter the return are block hashes (DATA, 32 Bytes), e.g. ["0x3454645634534..."]. -* For filters created with eth_newFilter logs are objects with the following params: - * removed: TAG - true when the log was removed, due to a chain reorganization. false if its a valid log. - * logIndex: QUANTITY - integer of the log index position in the block. null when its pending log. - * transactionIndex: QUANTITY - integer of the transactions index position log was created from. null when its pending log. - * transactionHash: DATA, 32 Bytes - hash of the transactions this log was created from. null when its pending log. - * blockHash: DATA, 32 Bytes - hash of the block where this log was in. null when its pending log. - * blockNumber: QUANTITY - the block number where this log was in. null when its pending log. - * address: DATA, 20 Bytes - address from which this log originated. - * data: DATA - contains one or more 32 Bytes non-indexed arguments of the log. - * topics: Array of DATA - Array of 0 to 4 32 Bytes DATA of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier.) - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":1}' -```` - -## eth_uninstallFilter - -Uninstalls a filter with a given id. Should always be called when a watch is no longer needed. -Additionally, filters timeout when they aren’t requested with eth_getFilterChanges for some time. - -### Parameters - -* QUANTITY - The filter id. - -### Returns - - -* Boolean - true if the filter was successfully uninstalled, otherwise false. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":1}' -```` - -## eth_unsubscribe - -Subscriptions are cancelled with a regular RPC call with eth_unsubscribe as a method and the subscription id as the first parameter. It returns a bool indicating if the subscription was cancelled successfully. - -### Parameters - -* SUBSCRIPTION ID - -### Returns - - -* UNSUBSCRIBED FLAG - true if the subscription was cancelled successful. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_unsubscribe","params":["0x9cef478923ff08bf67fde6c64013158d"],"id":1}' -```` diff --git a/docs/docs/api/json-rpc-net.md b/docs/docs/api/json-rpc-net.md deleted file mode 100644 index 002d23e..0000000 --- a/docs/docs/api/json-rpc-net.md +++ /dev/null @@ -1,56 +0,0 @@ -## net_version - -Returns the current network id. - -### Parameters - -None - -### Returns - - -* String - The current network id. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":83}' -```` - -## net_listening - -Returns true if a client is actively listening for network connections. - -### Parameters - -None - -### Returns - - -* Boolean - true when listening, otherwise false. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":83}' -```` - -## net_peerCount - -Returns number of peers currently connected to the client. - -### Parameters - -None - -### Returns - - -* QUANTITY - integer of the number of connected peers. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":1}' -```` diff --git a/docs/docs/api/json-rpc-txpool.md b/docs/docs/api/json-rpc-txpool.md deleted file mode 100644 index 9f5a5de..0000000 --- a/docs/docs/api/json-rpc-txpool.md +++ /dev/null @@ -1,40 +0,0 @@ -## txpool_content - -Returns a list with the exact details of all the transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only. - -### Parameters - -None - -### Example -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"txpool_content","params":[],"id":1}' -```` - -## txpool_inspect - -Returns a list with a textual summary of all the transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only. This is a method specifically tailored to developers to quickly see the transactions in the pool and find any potential issues. - -### Parameters - -None - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"txpool_inspect","params":[],"id":1}' -```` - -## txpool_status - -Returns the number of transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only. - -### Parameters - -None - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"txpool_status","params":[],"id":1}' -```` diff --git a/docs/docs/api/json-rpc-web3.md b/docs/docs/api/json-rpc-web3.md deleted file mode 100644 index 0dabe70..0000000 --- a/docs/docs/api/json-rpc-web3.md +++ /dev/null @@ -1,37 +0,0 @@ -## web3_clientVersion - -Returns the current client version. - -### Parameters - -None - -### Returns - - -* String - The current client version - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":1}' -```` - -## web3_sha3 - -Returns Keccak-256 (not the standardized SHA3-256) of the given data. - -### Parameters - -* DATA - the data to convert into a SHA3 hash - -### Returns - - -* DATA - The SHA3 result of the given string. - -### Example - -````bash -curl https://rpc-endpoint.io:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":1}' -```` diff --git a/docs/docs/api/json-rpc-xgr.md b/docs/docs/api/json-rpc-xgr.md deleted file mode 100644 index 648fa83..0000000 --- a/docs/docs/api/json-rpc-xgr.md +++ /dev/null @@ -1,22 +0,0 @@ -# JSON-RPC XGR API - -## xgr_getNextProcessId - -Returns the next sequential `processId` for the provided address. The result is a decimal string. - -Example: - -```json -{"jsonrpc":"2.0","id":1,"method":"xgr_getNextProcessId","params":[{"from":"0x"}]} -``` - -## xgr_validateDataTransfer - -The `processId` field in permits is a `uint256` and is serialized as a decimal string in JSON-RPC. This method returns a quick acknowledgement without executing the session. The response contains a `status` field with one of the following values: - -| status | meaning | -|-----------------|-----------------------------------------------------------| -| `queued` | new session or due step queued for immediate execution | -| `already-queued`| session was already active; no additional action taken | -| `scheduled` | session is waiting for its scheduled wake-up time | -| `paused` | session is paused and was not re-queued | diff --git a/docs/docs/design/blockchain.md b/docs/docs/design/blockchain.md deleted file mode 100644 index e16d706..0000000 --- a/docs/docs/design/blockchain.md +++ /dev/null @@ -1,18 +0,0 @@ -Edge-powered chains are built on a common blockchain design that effectively manages and maintains the blockchain data structure, consisting of a sequential chain of blocks containing transactions and other metadata; a state database. - -The core blockchain implementation offers various functionalities, such as: - -- Adding new blocks to the chain. -- Retrieving blocks using their hash or number. -- Handling chain reorganizations (i.e., switching to a different chain with greater difficulty). -- Verifying block headers and gas limits. -- Caching block headers and receipts to improve retrieval speed. -- Updating the chain's average gas price. - -To provide these functionalities, the implementation employs several sub-components, including: - -- A consensus component responsible for validating new blocks and incorporating them into the chain. -- A database component that persistently stores blockchain data. -- An event component that notifies other components of chain reorganizations and new block additions. -- A transaction signer component that verifies transaction signatures and identifies the sender address. -- A gas price calculator component that computes the chain's average gas price. diff --git a/docs/docs/design/bridge/assets/erc/erc1155.md b/docs/docs/design/bridge/assets/erc/erc1155.md deleted file mode 100644 index 6f21a0b..0000000 --- a/docs/docs/design/bridge/assets/erc/erc1155.md +++ /dev/null @@ -1,19 +0,0 @@ -ERC-1155 is a token standard that enables the creation of both fungible and non-fungible tokens on a blockchain network. In the context of Edge, ERC-1155 tokens can be used to represent multiple instances of a single fungible or non-fungible asset on an Edge-powered chain. - -## ChildERC1155 - -Developers can use the [`ChildERC1155`](../../../../interfaces/erc1155/childerc1155.md) token standard to create ERC-1155 tokens on an Edge-powered chain. To create a new ChildERC1155 token, developers can use the `ChildERC1155` contract as a template and deploy it on the Edge-powered chain. The contract requires a name and symbol to determine the unique identity of the token. - -Once created, `ChildERC1155` tokens can be minted and burned on the Edge-powered chain through the corresponding ERC1155Predicate contract. This ensures that the supply of tokens on the rootchain and the Edge-powered chain remains in sync. The `ERC1155Predicate` contract also allows for the transfer of tokens between the two. - -## Predicates - -The [`RootERC1155Predicate`](../../../../interfaces/erc1155/rooterc1155-predicate.md) contract serves as the root token contract, while the [`ChildERC1155Predicate`](../../../../interfaces/erc1155/childerc1155-predicate.md) contract serves as the child token contract. When a user wants to deposit an ERC-1155 token on the rootchain into the Edge-powered chain, they call the deposit function on the `RootERC1155Predicate` contract with the appropriate parameters, including the token ID, sender, and receiver addresses. - -Once the child contract instance is created, the `RootERC1155Predicate` contract maps the root token to the child token using a mapping, allowing users to deposit and withdraw tokens between the root and Edge-powered chain. The ChildERC1155Predicate contract includes functions for minting and burning child tokens, which are triggered when the deposit and withdrawal functions are called. - -To withdraw a child token back to the rootchain, a user calls the appropriate function on the ChildERC1155Predicate contract with the necessary parameters, including the token ID, the amount to withdraw, and the receiver address. The `ChildERC1155Predicate` contract then burns the child token and emits a withdrawal event. The `RootERC1155Predicate` contract listens for these events and relays them to the rootchain using the `L2StateSender` contract. - -## Deposits and Withdrawals - -Depositing and withdrawing ERC-1155 tokens between the rootchain and Edge-powered chain can be done using the `deposit` and `withdraw` functions in the `RootERC1155Predicate` and `ChildERC1155Predicate` contracts, respectively. The `ChildERC1155Predicate` contract includes functions for minting and burning child tokens, which are triggered when the deposit and withdrawal functions are called. To withdraw a child token back to the rootchain, a user calls the appropriate function on the `ChildERC1155Predicate` contract with the necessary parameters, including the token ID, the amount to withdraw, and the receiver address. The `ChildERC1155Predicate` contract then burns the child token and emits a withdrawal event. diff --git a/docs/docs/design/bridge/assets/erc/erc20.md b/docs/docs/design/bridge/assets/erc/erc20.md deleted file mode 100644 index 25a8d42..0000000 --- a/docs/docs/design/bridge/assets/erc/erc20.md +++ /dev/null @@ -1,40 +0,0 @@ -Edge provides developers with two standards for creating ERC-20 fungible tokens on their networks: `NativeERC20` and `ChildERC20`. These standards are based on the widely-used ERC-20 standard and offer similar functionality, including the ability to transfer tokens between addresses, approve others to spend tokens on your behalf, and check your balance. However, there are significant differences in their deployment and management. - -## ChildERC20 - -The [`ChildERC20`](../../../../interfaces/erc20/childerc20.md) token standard is used for tokens mapping and enables developers to create tokens on both the Edge-powered chain and the associated rootchain. To create a new `ChildERC20` token, developers can use the `ChildERC20` contract as a template and deploy it on their Edge-powered chain. The contract requires a name, symbol, and number of decimals to determine the minimum unit of the token. - -`ChildERC20` tokens are minted and burned on the Edge-powered chain through the corresponding [`ERC20Predicate`](../../../../interfaces/erc20/childerc20-predicate.md) contract. This ensures that the supply of tokens on the rootchain and the Edge-powered chain remains in sync. The `ERC20Predicate` contract also allows for the transfer of tokens between the two networks using the native bridge. - -## NativeERC20 - -The [`NativeERC20`](../../../../interfaces/erc20/native-erc20.md) token standard represents native tokens on Edge and offers fast and inexpensive transactions. It is deployed only on the Edge-powered chain and relies on the native transfer precompile to make transfers. The `NativeERC20` tokens can be minted and burned by the associated predicate contract. - -In addition, developers can use the `NativeERC20Mintable` contract to create and manage `NativeMintable` tokens, which are fungible tokens that represent assets on the Edge-powered chain. These tokens can be managed through the native bridge contract and transferred between an Edge-powered chain and rootchain networks. - -## Deposits and Withdrawals - -The deposit and withdrawal functionality plays a critical role in bridging ERC-20 tokens between a rootchain and an Edge-powered chain. - -When a user wants to deposit ERC-20 tokens into an Edge-powered chain, they call the `deposit` function. This function maps the root token to a child token and then mints the equivalent amount of child tokens to the user's address on the Edge-powered chain. By doing this, the ERC-20 tokens are effectively transferred from the rootchain to the Edge-powered chain. The user can then use these tokens on the Edge-powered chain or transfer them to other addresses on the network. - -On the other hand, when a user wants to withdraw ERC-20 tokens from an Edge-powered chain to the rootchain, they call the `withdraw` function. This function burns the equivalent amount of child tokens on the Edge-powered chain and then triggers a function on the rootchain that transfers the equivalent amount of root tokens to the user's address on the rootchain. By doing this, the ERC-20 tokens are effectively transferred from the Edge-powered chain back to the rootchain. - -Both the `deposit` and `withdraw` functions emit events that log the amount and token involved in the transaction. This provides transparency and allows users to track the movement of their tokens between the two networks. - -### EIP1559Burn - -The dynamic gas fee mechanism implements a base fee per gas to improve transaction fee predictability and efficiency. The base fee adjusts dynamically based on gas target deviations and is burned within the protocol. - -- **Burn Contract**: The burn contract parameter specifies the contract address where fees will be sent and utilized. To enable the London hard fork and set the burn contract address, use the `--burn-contract` flag in the genesis command with the following format: `:
`. - -- **Genesis Base Fee**: The genesis base fee parameter sets the initial base fee (in GWEI) for the genesis block. Include this value in the genesis.json file during the genesis command. By default, the genesis base fee is set to 1 GWEI. - -- **Genesis Base FeeEM**: The genesis base fee elasticity multiplier determines the base fee for blocks following the genesis block. It is initially set to 2. If the London hard fork is disabled (i.e., when the burn contract is not set), the base fee remains the same as the genesis base fee. - -- **Burn Contract Parameter Revision**: The burn contract address can be adjusted during a node reboot, which is achieved by modifying the `burnContract` parameter in the genesis.json file. It's crucial to comprehend, however, that merely identifying the burn contract address does not implicitly activate the EIP-1559 feature. If the EIP-1559 was not initialized during genesis, a series of procedures are required to activate it subsequently: - -- The burn contract should be properly deployed onto the Edge-powered chain. -- The genesis file must detail the burn contracts map, incorporating both the block number and the burn contract address. -- The base fee and base fee elasticity multiplier are required to be manually defined in the genesis file. -- Finally, the EIP1559 fork must be activated. diff --git a/docs/docs/design/bridge/assets/erc/erc721.md b/docs/docs/design/bridge/assets/erc/erc721.md deleted file mode 100644 index 7c64a17..0000000 --- a/docs/docs/design/bridge/assets/erc/erc721.md +++ /dev/null @@ -1,18 +0,0 @@ - -ERC-721 is a token standard that allows for the creation of unique, non-fungible tokens on a blockchain network. In the context of Edge, ERC-721 tokens can be used to represent unique assets. - -## ChildERC721 - -Developers can use the [`ChildERC721`](../../../../interfaces/erc721/childerc721.md) token standard to create ERC-721 tokens on the Edge-powered chain. To create a new ChildERC721 token, developers can use the ChildERC721 predicate contract as a template and deploy it on the Edge-powered chain. The contract requires a name and symbol to determine the unique identity of the token. - -Once created, `ChildERC721` tokens can be minted and burned on the Edge-powered chain through the corresponding `ERC721Predicate` contract. This ensures that the supply of tokens on the rootchain and the Edge-powered chain remains in sync. The `ERC721Predicate` contract also allows for the transfer of tokens between the two networks using the native bridge. - -## Predicates - -The [`RootERC721Predicate`](../../../../interfaces/erc721/rooterc721-predicate.md) contract serves as the rootchain token predicate contract, while the [`ChildERC721Predicate`](../../../../interfaces/erc721/childerc721-predicate.md) contract serves as the Edge-powered chain token predicate contract. When a user wants to deposit an ERC-721 token on the rootchain into the Edge-powered chain, they call the `deposit` function on the `RootERC721Predicate` contract with the appropriate parameters, including the token ID, sender, and receiver addresses. - -When a user deposits a token for the first time, the token mapping between the root and Edge-powered chain is created automatically. This mapping allows users to deposit and withdraw tokens between the root and Edge-powered chain. - -## Deposits and Withdrawals - -The `ChildERC721Predicate` contract includes functions for minting and burning child tokens, which are triggered when the deposit and withdrawal functions are called. To withdraw a child token back to the rootchain, a user calls the appropriate function on the `ChildERC721Predicate` contract with the necessary parameters, including the token ID and receiver address. The `ChildERC721Predicate` contract then burns the child token and emits a withdrawal event. The `RootERC721Predicate` contract listens for these events and relays them to the rootchain using the `L2StateSender` contract. diff --git a/docs/docs/design/bridge/checkpoint.md b/docs/docs/design/bridge/checkpoint.md deleted file mode 100644 index e74e9af..0000000 --- a/docs/docs/design/bridge/checkpoint.md +++ /dev/null @@ -1,35 +0,0 @@ - -## Introduction - -Checkpointing is the process of recording and committing a snapshot of the state of a system at a specific point in time. In the context of blockchain, checkpoints are used to increase security by allowing faster verification of the state of the blockchain without needing to process all transactions from the genesis block. Checkpoints can be used to speed up sync times for new nodes and help prevent certain types of attacks, such as 51% attacks. - -## Checkpoints in Edge - -!!! info "Key point" - - - The checkpoints are made **by the validators on the Edge-powered chain** and are committed to the rootchain. - - A checkpoint serves as a snapshot of the Edge state. This snapshot is stored as a Merkle root and **represents the state of the Edge-powered chain** at that point in time it was created. - - The checkpoint process is important for **ensuring the security of the network** as it enables the rootchain to detect and prevent any potential fraud or malicious activity on the child. - - -### CheckpointManager - -A `CheckpointManager` contract responsible for managing checkpoints in the network. - -The checkpoints represent a snapshot of the Edge state, which is periodically checkpointed to the rootchain by the validators. The checkpoints are used as a reference point for the rootchain to verify the integrity and accuracy of the data on the Edge-powered chain. - -The contract has several functions to facilitate the management of checkpoints, such as submitting a new checkpoint with metadata, verifying signatures, and getting the event root by block number or epoch. The contract also has a mapping to store the checkpoints and the current validator set, and an array to keep track of the checkpoint block numbers. - -The contract uses a Merkle tree to efficiently prove the membership of an event in the Edge state. The tree is constructed using the hashed exit events sent by the L2StateSender, which the Edge client saves to its local storage after their transactions are executed. The membership proofs can be verified using the Merkle proofs provided by the users. - -The contract also implements a BLS signature scheme to verify the signatures submitted by the validators. The validators' signatures are aggregated, and the contract checks whether the required voting power threshold is met to accept the checkpoint. - -!!! info "Details of the checkpoint" - - To elaborate, the root of the Merkle tree is a hash value that represents a specific subset of the Edge state at a specific point in time. This state includes only the exit events sent by the L2StateSender contract. When a user wants to exit the L2 chain (transfer their tokens from L2 to L1), their exit transaction is included in this Merkle tree. - - When a checkpoint is made, the root of the Merkle tree is included as part of the checkpoint, along with other metadata. This checkpoint is then sent to the rootchain where it is verified and stored by the validators. - - Later, when a user wants to verify a particular exit event on the Edge-powered chain, they can provide a Merkle proof, which is a cryptographic proof that demonstrates the inclusion of a particular exit event in the Merkle tree. The Merkle proof can be verified by the rootchain using the root of the Merkle tree, which was included in the checkpoint. - - In short, the root of the Merkle tree is a compact representation of the exit events on the Edge-powered chain at a specific point in time, which is included in checkpoints and used for verification purposes. diff --git a/docs/docs/design/bridge/overview.md b/docs/docs/design/bridge/overview.md deleted file mode 100644 index 46c2274..0000000 --- a/docs/docs/design/bridge/overview.md +++ /dev/null @@ -1,41 +0,0 @@ -## Overview - -Edge provides a built-in bridging mechanism that enables cross-chain communication. The bridging mechanism is a technical infrastructure that facilitates the transfer of arbitrary messages between any EVM-compatible PoS blockchain (rootchain), and an Edge-powered chain. - -It relies on mapping between the token contracts on the rootchain and the target chain, which is crucial for tracking assets and ensuring the correct amount of tokens are minted and burned during the transfer process. - -!!! caution "Bridge as an Attack Vector" - The cross-chain bridge can be an attack vector if not properly managed. Ensure you fully understand its functionality, potential vulnerabilities, and security measures before use. Expertise in this area is crucial for maintaining system security. - - -During the transfer process, assets are locked in a contract on the rootchain, and an equivalent amount of tokens are minted on the target chain. When assets are withdrawn from the target chain, the corresponding tokens are burned, and the assets are unlocked on the rootchain. Smart contracts on both the rootchain and the target chain are used to facilitate these processes, ensuring that the asset transfer is secure and transparent. - -!!! note "Enabled by Default" - - The cross-chain bridge in Edge is an integral part of the consensus client and is enabled by default. It cannot be disabled, as it is required for the functioning of the network. Being native to Edge, the bridge is built into the protocol and does not require any external third-party solutions or plug-ins. - - If you choose to use another cross-chain bridging mechanism, you will need to customize it yourself, and there are no guarantees of compatibility with associated contracts and infrastructure. - - -
- bridge -
-

The following diagram provides a visual representation of how messages can be passed between different EVM blockchain layers, allowing for seamless message transfers and coordination between various components of a Super network.

-

How does message passing work?

-

StateSync: real-time synchronization

-

Message passing between a rootchain and an Edge-powered chain is achieved through continuous state synchronization, known as StateSync. This process involves transferring state data between system calls.

-

Check out the StateSync document to learn more.

-

Checkpoints: Ensuring liveliness and reference points

-

When passing messages from an Edge-chain to a rootchain, the validator set commits checkpoints, which are snapshots of the Edge state containing only the root of the Exit events, excluding all transactions. Checkpoints serve as reference points for clients, and validators periodically checkpoint all transactions occurring on the Edge-powered chain to the rootchain. Checkpoints also ensure liveliness and are submitted to the associated rootchain asset contract.

-

Check out the Checkpoint document to learn more.

-

Bridge States: tracking event progress

-

The bridge can exist in one of three states:

-
    -
  • Pending: Events are waiting to be bundled and sent over.
    • -
  • Committed: Event data has been relayed to the associated chain.
    • -
  • Executed: The event has been committed, and the state executed, resulting in a state change.
    • -
-

Assets: supporting a range of standards

-

The bridge is compatible with various token standards, including ERC-20, ERC-721, and ERC-1155, enabling a wide range of assets to be transferred between chains.

-
-
diff --git a/docs/docs/design/bridge/sequences.md b/docs/docs/design/bridge/sequences.md deleted file mode 100644 index 7134412..0000000 --- a/docs/docs/design/bridge/sequences.md +++ /dev/null @@ -1,64 +0,0 @@ -## Deposit - -Bridge ERC 20 tokens from rootchain to childchain via deposit. - -```mermaid -sequenceDiagram - User->>Edge: deposit - Edge->>RootERC20.sol: approve(RootERC20Predicate) - Edge->>RootERC20Predicate.sol: deposit() - RootERC20Predicate.sol->>RootERC20Predicate.sol: mapToken() - RootERC20Predicate.sol->>StateSender.sol: syncState(MAP_TOKEN_SIG), recv=ChildERC20Predicate - RootERC20Predicate.sol-->>Edge: TokenMapped Event - StateSender.sol-->>Edge: StateSynced Event to map tokens on child predicate - RootERC20Predicate.sol->>StateSender.sol: syncState(DEPOSIT_SIG), recv=ChildERC20Predicate - StateSender.sol-->>Edge: StateSynced Event to deposit on child chain - Edge->>User: ok - Edge->>StateReceiver.sol:commit() - StateReceiver.sol-->>Edge: NewCommitment Event - Edge->>StateReceiver.sol:execute() - StateReceiver.sol->>ChildERC20Predicate.sol:onStateReceive() - ChildERC20Predicate.sol->>ChildERC20.sol: mint() - StateReceiver.sol-->>Edge:StateSyncResult Event -``` - -## Withdraw - -Bridge ERC 20 tokens from childchain to rootchain via withdrawal. - -```mermaid -sequenceDiagram - User->>Edge: withdraw - Edge->>ChildERC20Predicate.sol: withdrawTo() - ChildERC20Predicate.sol->>ChildERC20: burn() - ChildERC20Predicate.sol->>L2StateSender.sol: syncState(WITHDRAW_SIG), recv=RootERC20Predicate - Edge->>User: tx hash - User->>Edge: get tx receipt - Edge->>User: exit event id - ChildERC20Predicate.sol-->>Edge: L2ERC20Withdraw Event - L2StateSender.sol-->>Edge: StateSynced Event - Edge->>Edge: Seal block - Edge->>CheckpointManager.sol: submit() -``` -## Exit - -Finalize withdrawal of ERC 20 tokens from childchain to rootchain. - -```mermaid -sequenceDiagram - User->>Edge: exit, event id:X - Edge->>Edge: bridge_generateExitProof() - Edge->>CheckpointManager.sol: getCheckpointBlock() - CheckpointManager.sol->>Edge: blockNum - Edge->>Edge: getExitEventsForProof(epochNum, blockNum) - Edge->>Edge: createExitTree(exitEvents) - Edge->>Edge: generateProof() - Edge->>ExitHelper.sol: exit() - ExitHelper.sol->>CheckpointManager.sol: getEventMembershipByBlockNumber() - ExitHelper.sol->>RootERC20Predicate.sol:onL2StateReceive() - RootERC20Predicate.sol->>RootERC20: transfer() - Edge->>User: ok - RootERC20Predicate.sol-->>Edge: ERC20Withdraw Event - ExitHelper.sol-->>Edge: ExitProcessed Event -``` - diff --git a/docs/docs/design/bridge/statesync.md b/docs/docs/design/bridge/statesync.md deleted file mode 100644 index decaa32..0000000 --- a/docs/docs/design/bridge/statesync.md +++ /dev/null @@ -1,37 +0,0 @@ -## Introduction - -State synchronization (StateSync) is a mechanism used to update the state of a contract on the Edge-powered chain based on events occurring on the rootchain. It is a critical component of blockchain technology as it enables secure and efficient communication between the two chains. State synchronization allows for a more efficient and secure way to update the chain state on the Edge-powered chain without needing to process all transactions from the genesis block. - -## StateSync in Edge - -!!! info "Key points" - - - `StateSync` enables the efficient and secure transfer of data between an Edge-powered chain and rootchain. - - `StateSync` is initiated on the Edge-powered chain through the `StateSender` contract and executed on the rootchain through the `StateReceiver` contract. - - The `StateSync` process is used to update the state of a contract on the rootchain based on events occurring on the Edge-powered chain. - -### StateSender - -The `StateSender` contract is deployed on the rootchain and is triggered by either the associated rootchain predicate or `SupernetManager` rootchain contract. Its main responsibility is to generate sync state events based on the provided data and receiver address. Anyone can call the `syncState` function to emit a sync state event. The data is sent along with the event and represents the state change that needs to be executed on the Edge-powered chain. - -### StateReceiver - -The `StateReceiver` contract is deployed on the Edge and is responsible for executing and relaying the state data sent from the rootchain. It receives the state change data from the rootchain contract bundled up in the form of a commitment, sent with the Merkle Tree root hash. This tree is created by bundling a number of `StateSync` events received by the `StateSender`. Commitments are submitted to the `StateReceiver` by a block proposer, and it is a system (state) transaction. They are used to verify the execution of state data from the rootchain to the Edge-powered chain, such as transferring funds from rootchain to Edge. Commitments are similar to checkpoints but are used in the process of transferring data from rootchain to Edge, while checkpoints are used in the process of transferring data from Edge to rootchain. - -## L2StateSender and ExitHelper - -To enable communication from the Edge-powered chain to the rootchain, the `L2StateSender` contract resides on an Edge-powered chain and is responsible for emitting `L2StateSyncs` (also referred to as exit events). These events are indexed by the rootchain validators and submitted as a checkpoint on the rootchain, allowing for lazy execution. Unlike the `StateSender`, there is no transaction execution on the rootchain for the `L2StateSender`. - -On the rootchain, the `ExitHelper` contract is responsible for verifying the execution of the exit events and enabling users to withdraw their funds from the Edge-powered chain to the rootchain. It is analogous to the StateReceiver on the Edge-powered chain, and both contracts work together to enable two-way communication between the rootchain and the Edge-powered chain. - -!!! info "Synchronization and commitments" - - The `StateSync` process involves two main steps: synchronization and commitments. - - In the synchronization step, the `StateSender` contract on the rootchain generates sync state events based on receiver and data. The `syncState` function allows anyone to call this method to emit an event. The data is sent along with the event and represents the state change that needs to be executed on the Edge. - - In the commitments step, the `StateReceiver` contract on the Edge-powered chain receives the state change data along with a Merkle proof from the `StateSender` contract and verifies the proof to ensure the data's integrity. If the proof is valid, the state change is executed on the Edge-powered chain. - - To ensure the validity of the state change, the `StateSender` contract generates a unique id for each sync state event. This id is used by the `StateReceiver` contract to prevent replay attacks, which could result in the execution of duplicate state changes. - - The `StateReceiver` contract also implements a BLS signature scheme to verify the signatures submitted by the validators. The validators' signatures are aggregated, and the contract checks whether the required voting power threshold is met to accept the state change. diff --git a/docs/docs/design/consensus/polybft/ibft.md b/docs/docs/design/consensus/polybft/ibft.md deleted file mode 100644 index f2976f4..0000000 --- a/docs/docs/design/consensus/polybft/ibft.md +++ /dev/null @@ -1,54 +0,0 @@ -## Consensus Engine - -The PolyBFT consensus mechanism uses the IBFT 2.0 consensus engine to agree on adding new blocks to the blockchain. The validator pool in IBFT 2.0 is responsible for validating candidate blocks proposed by a randomly selected block proposer who is part of the validator pool. The proposer is responsible for constructing a block at the block interval. The proposer mechanism is based on [Tendermint](https://tendermint.com/), where a proposer is chosen based on a deterministic selection algorithm. The frequency of selection is proportional to the voting power of the validator. - -Each block in IBFT 2.0 requires at least one round of voting by the validator to arrive at consensus, which is recorded as a collection of signatures on the block content. In general, a supermajority of validators must confirm that a block is valid for the block to be added to the blockchain. Only when there is no consensus on a given block, multiple rounds of voting are needed. The ideal path would be when the validator pool reaches consensus on a candidate block in the first round of voting, and the block is added to the blockchain without the need for additional rounds of voting. This is the most efficient and optimal outcome, as it allows the network to continue processing transactions and adding new blocks to the chain in a timely manner. - -A validator's voting power is proportional to the amount of stake they have locked up on the network. This means that validators with more stake will have more voting power and, therefore, more influence over the decision-making process on the network. This also provides an economic incentive for validators to behave honestly and act in the network's best interest. - -!!! info "Sealing a block" - - ### State transitions - - PolyBFT's consensus mechanism follows a series of state transitions that ensure network-wide consensus on the blockchain's state. The consensus process starts with a validator proposing a new block to be added to the blockchain, which includes a list of transactions to update the blockchain's state. - - Next, validators in the active set vote on whether to accept the proposed block. Each validator's voting weight determines their influence in voting, and a supermajority of validators must agree to accept the block for consensus to be reached. The protocol tracks the current block's position, also known as its **sequence**. - - The process to finalize a block in PolyBFT is referred to as **sealing**. When a validator proposes a new block, other validators vote on whether to accept it, and this process can be repeated multiple times. Each repetition is called a **round**, and during each round, a set number of validators must agree to seal the proposed block for it to be added to the blockchain. If the required number of votes isn't reached during a particular round, the voting process will continue into the next round, and the protocol "increases the round". Another validator will then attempt to seal the sequence in the new round. - - If the proposed block is accepted, it's added to the blockchain, and the state of the blockchain is updated to reflect the changes introduced by the transactions in the block. This process continues with the next proposer proposing a new block, and the process repeats. - -### Validator Set - -PolyBFT limits network participation to around 100 validators, and a variable amount of stake is used as a fixed stake criterion to limit the system's security and can make the system economically vulnerable. The validator set in the PolyBFT does not update on each block but is fixed during n block periods known as an epoch. - -The `n` block period to define one epoch is determined by `genesis` configuration, and until then, validators will remain the same. At the end of the epoch, a special state transaction to validatorSetManagementContract is emitted, notifying the system about the validators' uptime during the epoch. It is up to the smart contract to reward validators by their uptime and update the validator set for the next epoch. There is a function getValidatorSet which returns the current validator set at any time. - -!!! note - Proposer selection algorithm - Section is being updated - -The proposer selection algorithm is Tendermint-based. - -### Staking - -Staking is managed by staking contracts on the Edge-powered chain. The staking module on Polygon validates staked tokens and is independent of Ethereum's security. In principle, the network is secured by the rootchain and Ethereum. Transaction checkpoints still occur on Ethereum, but Ethereum does not validate staking on Polygon. - -At the end of each epoch, a reward calculation occurs to reward validators who actively participated in that epoch. - -!!! info - Staking details and rewards - Section is being updated - - -## Benefits - -### Consensus benefits - -- **Immediate block finality**: Only one block is proposed at a given chain height; thus, the single chain removes forking, uncle blocks, and the risk that a transaction may be "undone" once on the chain later. -- **Reduced time between blocks**: The effort needed to construct and validate blocks is decreased significantly, which increases the chain's throughput. -- **High data integrity and fault tolerance**: IBFT 2.0 uses a pool of validators to ensure the integrity of each proposed block. A supermajority (~66%) of these validators must sign the block before insertion into the chain, making block forgery very difficult. Also, the proposer of the block rotates over time, ensuring a faulty node cannot exert long-term influence over the chain. -- **Operationally flexible**: The validators can be modified quickly, ensuring the group contains only fully trusted nodes. - -### Network benefits - -- **Liveness**: It has been proven that IBFT 2.0 does not guarantee BFT persistence nor liveness when operating on a synchronous network. If a validator receives enough confirmation about a block, it can lock the proposed block (assuming it has not locked any prior). If a change were to occur because of a fault in the network, it could trigger the activation of the round change protocol, where the protocol would expect to commit the locked block at that specific height. -- **Persistence**: If, for instance, there is a faulty network condition present where two different node subsets lock to two different blocks, the system enters into an infinite cycle of state transitions that cannot converge states and finalize the block. diff --git a/docs/docs/design/consensus/polybft/overview.md b/docs/docs/design/consensus/polybft/overview.md deleted file mode 100644 index 2707897..0000000 --- a/docs/docs/design/consensus/polybft/overview.md +++ /dev/null @@ -1,22 +0,0 @@ -## Overview - -PolyBFT is a sophisticated and robust consensus mechanism employed by XGRChain. -The consensus mechanism comprises two key components, a **consensus engine** and **consensus protocol**. -PolyBFT utilizes the IBFT consensus engine and a Proof-of-Stake architecture to seal blocks, provide specific network capabilities, and govern the network. -The core smart contracts work in tandem with the consensus engine to define all the network's Proof-of-Stake rules. - -![bridge](../../..//img/edge/polybft.excalidraw.png) - -The consensus engine of PolyBFT is based on the Istanbul Byzantine Fault Tolerance [(IBFT 2.0) protocol](https://github.com/xgr-network/go-ibft), which is responsible for sealing blocks on the blockchain. -The IBFT 2.0 protocol ensures that network integrity is maintained even in the presence of malicious or dishonest nodes. - -To achieve fault tolerance, IBFT allows for `f` faulty nodes in a `3f + 1` network, as long as two-thirds of the nodes are honest. This algorithm is also known as a "super-majority rules" algorithm. -Each PolyBFT node maintains a local copy of the blockchain, represented as a list of blocks similar to the blockchain. The height of a block is defined as the number of parent links that separate the block from the genesis block, with the genesis block having a height of 0. Sequential instances of a block finalization protocol are run, with the objective of each instance being to determine which block is to be added at height h of the blockchain. - -PolyBFT's consensus protocol is implemented through a set of core smart contracts. These contracts serve multiple purposes, including enabling staking functionality and defining an incentivization scheme for validators on the network, managing the validator set, and facilitating cross-chain communication through a native bridge. - -![bridge](../../../img/edge/contracts.excalidraw.png) - -## Bridge - -The bridge transfers assets and data between an Edge-powered chain and an external EVM-compatible blockchain (rootchain), making it a critical component of the network's interoperability. Two predicate contracts, one on the childchain and one on the rootchain, implement the core bridge functionality and use the associated core contracts to deposit, withdraw, and verify cross-chain bridge transactions. The diagram above illustrates how the core contracts fit into the overall smart contract system design. diff --git a/docs/docs/design/consensus/polybft/protocol.md b/docs/docs/design/consensus/polybft/protocol.md deleted file mode 100644 index 21cd104..0000000 --- a/docs/docs/design/consensus/polybft/protocol.md +++ /dev/null @@ -1,123 +0,0 @@ -## State Transitions - -In PolyBFT, the consensus protocol follows a set of state transitions that enable the network to reach consensus on the state of the blockchain. The process begins when a validator proposes adding a new block to the blockchain. This block contains a list of transactions that the validator would like to include in the next update to the blockchain's state. - -Other validators in the active set will vote on whether to accept the proposed block. Each validator has a voting weight that influences voting. A super-majority of validators must agree to accept the block to reach consensus. Once a sufficient number of validators have agreed to accept the proposed block, it is added to the blockchain, and the state of the blockchain is updated to reflect the changes introduced by the transactions in the block. The protocol refers to the current block's position (the block height) as its *sequence*. - -The process to finalize a block in PolyBFT is known as *sealing*. When a validator proposes a new block, other validators on the network will vote on whether to accept the block. This process is may be repeated several times; each repetition is known as a *round*. During each round, certain validators must agree to seal the proposed block for it to be added to the blockchain. Another validator will attempt to seal the sequence in the new round. If the required number of votes is not reached during a particular round, the voting process will continue into the next round, and thus, the protocol "increases the round". - -Once the proposed block is accepted, it will be added to the blockchain, and the state of the blockchain will be updated to reflect the changes introduced by the transactions in the block. This process continues with the next proposer proposing a new block, and the process repeats. - -## Validator Set - -PolyBFT limits network participation to around 100 validators, and a variable amount of stake is used as a fixed stake criterion to limit the system's security and can make the system economically vulnerable. The validator set in the PolyBFT does not update on each block but is fixed during n block periods known as an epoch. - -The `n` block period to define one epoch is determined by governance, and until then, validators will remain the same. At the end of the epoch, a special state transaction to validatorSetManagementContract is emitted, notifying the system about the validators' uptime during the epoch. It is up to the smart contract to reward validators by their uptime and update the validator set for the next epoch. There is a function getValidatorSet which returns the current validator set at any time. - -## Staking - -Staking is governed by staking contracts directly on Polygon. To be clear, the staking module validates on Polygon and does not rely on Ethereum's security, but in principle, two chains are securing the network, PoS client and Ethereum. Transaction checkpoints still occur on Ethereum, but Ethereum does not validate staking on Polygon. - -At the end of each epoch, a reward calculation occurs to reward the active validators. - -## Native Bridge Integration - -PolyBFT supports an in-built bridging mechanism that enables arbitrary message passing between an Edge-powered chain and another Proof-of-Stake blockchain (rootchain) with the help of the consensus algorithm. Transfers can occur without mapping, allowing users to move assets between the two chains seamlessly. - -## Slashing - -Like in other Proof-of-Stake systems, validators are subject to slashing for malicious activity or poor performance. The slashing mechanics are still being determined, but PolyBFT will undoubtedly include a mechanism to penalize bad actors. Slashing a validator typically involves a penalty, such as losing some or all of their stake on the network. Examples of malicious activities are double-signing and equivocation. - -## State transitions - -The consensus protocol follows a set of state transitions. While things are still being finalized, the -process will typically follow the steps below. - -1. A validator proposes adding a new block to the blockchain. This block contains a list of transactions - that the validator would like to include in the next update to the blockchain's state. - -A - certain number of validators must agree to accept the block to reach consensus. 2. Other validators in the active set will vote on whether to accept the proposed block. The voting weight of - each validator influences voting. The protocol refers to block height as a *sequence*. - - All nodes in the network exchange information for a given sequence. The process to finalize a block in PolyBFT is known as *sealing*. The sealing of blocks is instant - and final. - - When a validator proposes a new block, other validators on the network will vote on whether to - accept the block. This process is typically repeated several times; each repetition is known as a - *round*. During each round, certain validators must agree to seal the proposed block - for it to be added to the blockchain. If the required number of votes is not reached during a - particular round, the voting process will continue into the next round, and thus, the protocol - "increases the round". Another validator will attempt to seal the sequence in the new round. - > The best case for a proposed block is that it is sealed at round 0. Blocks that are repeatedly - > sealed at a high-order round usually indicates a network problem. - -3. If the proposed block is accepted, it will be added to the blockchain, and the state of the blockchain - will be updated to reflect the changes introduced by the transactions in the block. - > If a malicious actor attempted to fork the network, they would need to obtain control of 2/3 of - > the network, which PolyBFT prevents. - -4. Once the state of the blockchain has been updated, the next proposer will propose a new block, and - the process repeats. - -IBFT limits network participation to around 100 validators. A variable amount of stake is used as a fixed -stake criterion to limit the system's security and can make the system economically vulnerable. The -validator set in the PolyBFT does not update on each block but is fixed during `n` block periods known as -an `epoch`. - -> The `n` block period to define one epoch is to be determined by governance. Until then, validators will -> remain the same. At the end of the epoch, a special `state transaction` to `validatorSetManagementContract` -> is emitted, notifying the system about validators' uptime during the `epoch`. It is up to the smart contract -> to reward validators by their uptime and **update the validator set** for the next `epoch`. There is a -> function `getValidatorSet`, which returns the current validator set at any time. - -Staking is governed by staking contracts directly on Polygon. To be clear, the staking module validates on -Polygon does not rely on Ethereum's security, but in principle, two chains are securing the network, PoS -client and Ethereum. Transaction checkpoints still occur on Ethereum, but Ethereum does not validate staking -on Polygon. - -!!! note - Note that in Tendermint, an epoch is set to 1. However, PolyBFT includes the logic to set a custom epoch time, with the intent of each epoch being one day in blocks, or around 14000 blocks. - -A reward calculation occurs at the end of the epoch to reward the active validators in that epoch. - -!!! caution "Slashing" - - Like in other Proof-of-Stake systems, validators are subject to slashing for malicious activity or - poor performance. Slashing a validator typically involves a penalty, such - as losing some or all of their stake on the network. The slashing mechanics are still being determined, but PolyBFT will undoubtedly - include a mechanism to penalize bad actors. - - Examples of malicious activities are double-signing and equivocation: - - - Double-signing refers to the act of signing two conflicting transactions. When a validator double-signs, - it creates a situation where the network is unable to reach consensus on the state of the blockchain, - which can lead to problems such as an attempt to fork or network instability. - - - Equivocation refers to the act of a validator attempting to create two conflicting versions of the - blockchain, which can also lead to problems such as a fork or network instability. - -## Block timestamp drift validation - -In the PolyBFT consensus mechanism, an important security feature is the validation of block timestamps. This -feature prevents malicious actors from creating blocks with timestamps far in the future, which could disrupt the -blockchain's operation. - -The block time drift validation works by checking if the block's timestamp is within a predefined time slot. If the -timestamp is outside this window, the block is considered a future block and is rejected. This time slot is defined by -a parameter called `blockTimeDrift`, which is nominated in seconds, and can be set during the genesis of the blockchain. -The default value for `blockTimeDrift` is 1 second. - -This feature ensures that all blocks in the blockchain have valid timestamps, preventing potential attacks and maintaining -the integrity of the blockchain. - -## Native bridge integration - -With the help of PolyBFT, Edge supports an -[in-built bridging mechanism (a two-way bridge)](../../bridge/overview.md), -which enables arbitrary message passing between an Edge-powered chain and another Proof-of-Stake -blockchain (`rootchain`). Transfers can occur without mapping. - -![bridge](../../../img/edge/contracts-bridge.excalidraw.png) - -Learn more [here](../../bridge/overview.md)). diff --git a/docs/docs/design/grpc.md b/docs/docs/design/grpc.md deleted file mode 100644 index 74deade..0000000 --- a/docs/docs/design/grpc.md +++ /dev/null @@ -1,20 +0,0 @@ -## What is gRPC used for? - -gRPC is a popular RPC (remote procedure call) framework that enables efficient communication between distributed systems. It is commonly used in microservices architectures and is especially useful for building high-performance, scalable applications that require low-latency communication between services. With its support for multiple programming languages and its built-in support for data serialization, gRPC provides a powerful and flexible tool for building distributed systems. - -## gRPC in Edge - -libp2p provides the underlying networking layer for establishing connections between peers. By creating a gRPC server instance on each peer in the network and allowing gRPC client connections to be established, a network API can be created that enables clients to interact with the network. - -When a client makes a remote procedure call to the server, the gRPC protocol abstracts the details of network communication, serialization, and deserialization. The gRPC client sends a request message to the gRPC server, which deserializes the request message, executes the appropriate method, and serializes the response message. The gRPC server then sends the response message back to the client, which deserializes the response message and returns the result to the caller. - -!!! info "Breakdown of the gRPC API" - - The `GrpcStream` struct lies at the core of the gRPC implementation, providing developers with a flexible and powerful tool for building decentralized applications on the network. By abstracting away the intricacies of network communication, it offers a simple and high-level API for constructing distributed systems. - - To create a new `GrpcStream` object and initialize a gRPC server instance, developers can call the `NewGrpcStream()` function. The `Client()` method allows developers to wrap a network stream in a gRPC client connection, and the `Serve()` method starts the gRPC server in a separate goroutine. - - For registering a gRPC service and its implementation with the server, developers can use the `RegisterService()` method. The `GrpcServer()` method returns the underlying gRPC server instance, making it simple to configure and manage. - - For greater flexibility and control over the network communication process, developers can use the `Accept()` method to wait for and accept incoming connections. The `WrapClient()` function can also wrap a network stream in a gRPC client connection. - diff --git a/docs/docs/design/jsonrpc.md b/docs/docs/design/jsonrpc.md deleted file mode 100644 index 40744ef..0000000 --- a/docs/docs/design/jsonrpc.md +++ /dev/null @@ -1,19 +0,0 @@ -## What is JSON-RPC used for? - -JSON-RPC is a remote procedure call (RPC) protocol encoded in JSON. It enables the communication between distributed systems, often found in microservices architectures. JSON-RPC is a lightweight, language-agnostic protocol that allows developers to build scalable applications with low-latency communication between services. With its simplicity and support for multiple programming languages, JSON-RPC offers an accessible and flexible tool for building distributed systems. - -## JSON-RPC in Edge - -JSON-RPC is implemented in Edge as an API consensus. - -When a client makes a remote procedure call to the server, the JSON-RPC protocol abstracts the details of network communication, serialization, and deserialization. The JSON-RPC client sends a request message to the JSON-RPC server, which deserializes the request message, executes the appropriate method, and serializes the response message. The JSON-RPC server then sends the response message back to the client, which deserializes the response message and returns the result to the caller. - -!!! info "Breakdown of the JSON-RPC API" - - The JSON-RPC implementation in Edge consists of several key components, including the `JSONRPC` struct and the `JSONRPCStore` interface. - - The `JSONRPC` struct handles the core functionality of the JSON-RPC server. It includes methods for setting up the HTTP server, handling WebSocket connections, and managing incoming requests. The `NewJSONRPC()` function is used to create a new instance of the JSONRPC server with a specified logger and configuration. - - The JSONRPCStore interface defines all the methods required by the JSON-RPC endpoints. These methods are implemented by various store types, such as `ethStore`, `networkStore`, `txPoolStore`, `filterManagerStore`, `bridgeStore`, and `debugStore`. These store types interact with different aspects of the system, allowing the JSON-RPC server to provide a comprehensive API for clients. - - For handling WebSocket connections, a `handleWs` function is used to upgrade HTTP connections to WebSocket connections. A `wsWrapper` struct wraps WebSocket connections and provides methods for managing WebSocket communication. diff --git a/docs/docs/design/libp2p.md b/docs/docs/design/libp2p.md deleted file mode 100644 index 22f653b..0000000 --- a/docs/docs/design/libp2p.md +++ /dev/null @@ -1,26 +0,0 @@ -## Overview - -PolyBFT uses a decentralized networking layer based on the libp2p protocol. The protocol provides peer-to-peer networking primitives such as peer discovery, connection management, and secure messaging. The network relies on a secure Identity Service to manage peer connectivity and handshaking, ensuring only valid peers can join the network. - -## Identity - -The Identity Service validates incoming connections and manages peer handshaking. It maintains a list of pending peer connections and uses a networkingServer interface to communicate with the underlying networking layer. - -## Peer discovery - -PolyBFT uses libp2p's distributed hash table (DHT) based on the Kademlia algorithm for peer discovery. The DHT stores information about other peers in the network, such as their addresses and availability. When a new node joins the network, it uses the DHT to find other peers that are currently online. The process of using the DHT to discover peers and then sending out connection requests is repeated periodically to maintain a sufficient number of connections in the network. - -## Peer routing - -Bootnodes act as rendezvous servers that help new nodes discover and connect to the network. The xgrchain command allows you to specify one or more bootnodes while creating the genesis file. Bootnodes are defined using libp2p multiaddrs, which contain information about the protocol, network address, and node port number. - -```bash ---bootnode /ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmJxxH1tScDX2rLGSU9exnuvZKNM9SoK3v315azp68DLPW \ ---bootnode /ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmS9Nq4QAaEiogE4ieJFUYsoH28magT7wSvJPpfUGBj3Hq \ -``` - -## Gossipsub - -Gossipsub is a decentralized, peer-to-peer messaging protocol used in XGRChain to broadcast messages efficiently across the network. It's used in various network components, including the TxPool, where it's used to broadcast new transactions and relay transaction data between nodes. Gossipsub allows for efficient and reliable message propagation while minimizing the bandwidth requirements of the network. - -To learn more about libp2p networking, check out the [official libp2p documentation](https://docs.libp2p.io/). diff --git a/docs/docs/design/mempool.md b/docs/docs/design/mempool.md deleted file mode 100644 index 4f5df8b..0000000 --- a/docs/docs/design/mempool.md +++ /dev/null @@ -1,17 +0,0 @@ -## What is a Mempool? - -A mempool, short for "memory pool," is a temporary storage area in a blockchain node for pending transactions before they are added to a block and confirmed on the network. When users submit transactions, they are initially held in the mempool, where miners or validators can select them to include in the next block. Transactions in the mempool are generally ordered based on factors such as transaction fees and age, which helps prioritize transactions for faster confirmation. - -## Mempool in Edge - -In Edge, the mempool is crucial in managing and prioritizing pending transactions. When a transaction is submitted to the network, it is first stored in the mempool, which remains until it is confirmed in a block. The mempool helps ensure that transactions are executed fairly and efficiently, as validators can choose which transactions to include in a block based on factors such as fees and age. - -The mempool in Edge is designed to optimize transaction processing and improve network performance. Some of the key features of the mempool in Edge include: - -- **Transaction prioritization**: The mempool prioritizes transactions based on fees and age. Transactions with higher fees are generally processed faster, providing greater incentives for validators to include them in a block. - -- **Mempool management**: Mechanisms for handling congestion, transaction eviction, and memory usage are implemented to help maintain a healthy mempool, ensuring that the network remains stable and responsive. - -- **Transaction validation**: Before a transaction is added to the mempool, validators validate it to ensure that it is valid and adheres to the network's consensus rules. - -- **Mempool synchronization**: Nodes share information about their mempools to maintain a consistent view of the pending transactions in the network. diff --git a/docs/docs/design/overview.md b/docs/docs/design/overview.md deleted file mode 100644 index 72e1f30..0000000 --- a/docs/docs/design/overview.md +++ /dev/null @@ -1,21 +0,0 @@ -The diagram below illustrates the major components of Edge. - -
- Edge architecture overview -
- -## Components - -The following table breaks down each of these components. - -| Component | Description | Link | -| --- | --- | --- | -| libp2p | Provides the networking layer for Edge and is designed for peer-to-peer network architectures. | [libp2p Overview](libp2p.md) | -| Bridge | An in-built bridging mechanism enabled by PolyBFT that allows message passing between an Edge-powered chain and another Proof-of-Stake blockchain without mapping. | [Native Bridge overview](bridge/overview.md) | -| Mempool | Enables multiple validators to aggregate their signatures to create a single, aggregated signature representing all validators in the pool. | [mempool Overview](mempool.md) | -| Consensus | PolyBFT serves as the consensus mechanism of XGRChain and consists of a consensus engine, IBFT 2.0, and a consensus protocol that includes the bridge, staking, and other utilities. | [PolyBFT Overview](consensus/polybft/overview.md) | -| Blockchain | Coordinates everything in the system, curates state transitions, and is responsible for state changes when a new block is added to the chain. | [Blockchain Overview](blockchain.md) | -| Runtime (EVM) | Uses the EVM as the runtime environment for executing smart contracts. | [Runtime Overview](runtime/overview.md) | -| TxPool | Represents the transaction pool, closely linked with other modules in the system. | [TxPool Overview](txpool.md) | -| JSON-RPC | Facilitates interaction between dApp developers and the blockchain, allowing developers to issue JSON-RPC requests to an Edge node and receive responses. | [JSON-RPC Overview](jsonrpc.md) | -| gRPC | Essential for operator interactions, allowing node operators to interact with the client easily and providing a seamless user experience. | [gRPC Overview](grpc.md) | diff --git a/docs/docs/design/runtime/allowlist.md b/docs/docs/design/runtime/allowlist.md deleted file mode 100644 index 9a7593c..0000000 --- a/docs/docs/design/runtime/allowlist.md +++ /dev/null @@ -1,51 +0,0 @@ -## Overview - -Edge offers access control lists (ACLs) to manage and control access to specific network resources, contracts, or functionalities. Network operators can limit access to certain addresses using ACLs, ensuring a controlled and secure environment for their applications. - -## Roles - -There are currently two primary roles within the ACL system: - -- **Admin**: An address with full control over the list, capable of adding, modifying, or removing entries. -- **Enabled**: An address that has been granted access to the specific resource or functionality covered by the list. - -## Initializing and Managing Admins in ACLs - -To effectively manage ACLs, at least one address with the Admin role should be assigned when initializing each list in your blockchain application. Admins have the authority to modify the roles of other addresses, granting or revoking access to resources or functionalities as needed. - -When setting up ACLs, you should: - -- Select trusted addresses to serve as admins. -- Assign the `Admin` role to these addresses using the appropriate flag for each list type. -- Admin addresses will manage the respective ACLs, including adding or removing new addresses. Ensure that the admin addresses are secure and that only authorized users have access to them to maintain the integrity and security of your application. - -## Designating Multiple Admins - -You can designate multiple admin addresses for redundancy and better access control management. Having more than one admin can help: - -- Prevent single points of failure. -- Distribute the responsibility of managing the ACLs among multiple trusted entities. - -However, assigning multiple admins also increases the potential attack surface. It is essential to strike the right balance between security and flexibility when managing admin addresses or use your best judgment based on the needs and purpose of the network. - -## ACL Types - -Edge supports several types of ACLs: - -- **Contract Deployer Allow/Block Lists**: Controls which can deploy contracts on the network. -- **Transactions Allow/Block Lists**: Controls which addresses can send transactions on the network. -- **Bridge Allow/Block Lists**: Controls that can interact with the bridge functionality. - -Each list type serves a different purpose and can be configured separately to provide fine-grained control over various aspects of the network. Network operators can use a combination of these lists to maintain a secure and controlled environment for their applications. - -### Bridge ACLs - -Bridge ACLs are an additional layer of security for cross-chain transactions, allowing only specific authorized contracts to interact with a particular bridge. By using an alternative ACL-enabled contract, network operators can have greater control over cross-chain interactions, ensuring that only trusted parties can perform certain actions. - -However, it's essential to note that using an alternative ACL-enabled contract comes with a trade-off in terms of gas consumption. Since these contracts introduce additional checks and restrictions on transactions, they require more computational resources, leading to higher gas fees. Network operators must carefully weigh the benefits of increased security against the potential increased costs for users. - -## Current Limitations - -- **Limited role definitions**: The current implementation only supports two primary roles (Admin and Enabled). You must modify the implementation if your application requires more granular access control or additional roles. -- **Granularity**: The current implementation applies the ACLs at the network level. More granular control may require custom implementation, such as using ACLs for specific contracts or functionalities. -- **Static call limitation**: Write operations are not allowed in static calls, which might be a constraint in specific scenarios where you would want to perform a write operation within a static call. diff --git a/docs/docs/design/runtime/overview.md b/docs/docs/design/runtime/overview.md deleted file mode 100644 index c3e4cac..0000000 --- a/docs/docs/design/runtime/overview.md +++ /dev/null @@ -1,10 +0,0 @@ - -The EVM is the core interface for executing and interacting with smart contracts on a Edge-powered chain. It operates consistently with the Ethereum EVM and supports the same set of OPCODEs. - -!!! info "Overview of the EVM" - - Smart contracts represent self-executing agreements, with their terms explicitly encoded into the contract's code. Deployed on the Ethereum network, these contracts are processed by the EVM, which provides a secure, decentralized environment for execution. The EVM guarantees that all network nodes adhere to the same rules and yield identical outcomes when running smart contracts. - - Featuring a stack-based architecture, the EVM processes low-level instructions known as opcodes. Each opcode serves a specific function, such as performing arithmetic operations, managing storage access, or facilitating interactions with other contracts. To limit resource consumption during contract execution and prevent issues like infinite loops, the EVM employs gas as a metric for computational work. - - Developers typically create smart contracts using high-level programming languages, such as Solidity, which are subsequently compiled into EVM bytecode. The EVM executes this bytecode, ensuring the contract's logic is implemented as intended. diff --git a/docs/docs/design/txpool.md b/docs/docs/design/txpool.md deleted file mode 100644 index 33598e3..0000000 --- a/docs/docs/design/txpool.md +++ /dev/null @@ -1,21 +0,0 @@ -## What is the TxPool used for? - -The TxPool module manages the incoming transactions for processing. It maintains a list of unprocessed transactions and ensures they conform to specific constraints before entering the pool. - -## TxPool in Edge - -The TxPool has several methods to handle incoming transactions. - -!!! info "Details on how the TxPool works" - - The `addTx()` method is the main entry point for all new transactions. It validates the incoming transaction and adds it to the pool. If the call is successful, an account is created for this address (only once), and an `enqueueRequest` is signaled. - - The `handleEnqueueRequest()` method attempts to enqueue the transaction in the given request to the associated account. If the account is eligible for promotion, a `promoteRequest` is signaled afterward. The `handlePromoteRequest()` method moves promotable transactions of some accounts from enqueued to promoted. It can only be invoked by `handleEnqueueRequest()` or `resetAccount()`. - - The TxPool also has a `validateTx()` method that checks specific constraints before entering the pool. These constraints include checking the transaction size to overcome DOS Attacks, ensuring the transaction has a strictly positive value, and checking if the transaction is appropriately signed. - - The `resetAccounts()` method also updates existing accounts with the new nonce and prunes stale transactions. This ensures that the pool only contains relevant and valid transactions. The `updateAccountSkipsCounts()` method updates the accounts' skips, which is the number of consecutive blocks that do not have the account's transactions. - - The TxPool implementation in XGRChain uses several data structures to manage transactions efficiently. The `accounts` data structure stores all the accounts and transactions in the pool. The `index` data structure maintains a list of all transactions in the pool, and the `gauge` data structure keeps track of the number of slots used in the pool. - - Finally, the TxPool implementation in XGRChain handles transactions gossiped by the network through the `addGossipTx()` method. It verifies that the gossiped transaction message is not empty, decodes the transaction, and adds it to the pool using the `addTx()` method. diff --git a/docs/docs/design/txrelayer.md b/docs/docs/design/txrelayer.md deleted file mode 100644 index 5181ab6..0000000 --- a/docs/docs/design/txrelayer.md +++ /dev/null @@ -1,19 +0,0 @@ -## What is a TxRelayer used for? - -A TxRelayer is a component that facilitates the creation and sending of transactions. It provides a simple interface for executing a message call without creating a dedicated transaction and sending signed transactions to a blockchain. - -## TxRelayer in Edge - -In XGRChain, the TxRelayer module contains a client communicating with an Ethereum node and a wallet for signing transactions. - -!!! info "Details on using the TxRelayer" - - The first step for those looking to use the TxRelayer is to create a new instance by calling the `NewTxRelayer()` function. This function takes several optional arguments that can be used to configure the TxRelayer, such as `clientConfig` and `receiptTimeout`. By default, the client is set to connect to an Ethereum node running on `localhost:8545`, and the `receiptTimeout` is set to 50 milliseconds. - - Once the TxRelayer is created, you can call the `Call()`, `SendTransaction()`, or `SendTransactionLocal()` methods to execute message calls or send signed transactions to the blockchain. - - The `Call()` method allows you to execute a message call without creating a transaction on the blockchain. It takes in the from and to addresses and the input data for the call. The result of the call is returned as a byte array. - - The `SendTransaction()` method signs the provided transaction with the provided key and sends it to the blockchain. It first fetches the nonce for the sender's address, sets the gas price and limit (if they are not already set), signs the transaction with the `EIP155Signer`, and then sends the raw transaction data to the Ethereum node. - - The `SendTransactionLocal()` method sends a non-signed transaction to the blockchain only for testing purposes. It sets the gas price and limit and uses the first account returned by the Ethereum node's `Accounts()` method as the sender. diff --git a/docs/docs/disclaimer.md b/docs/docs/disclaimer.md deleted file mode 100644 index 0e23884..0000000 --- a/docs/docs/disclaimer.md +++ /dev/null @@ -1,7 +0,0 @@ -## XGRChain Wiki Third-Party Content Disclaimer - -The XGRChain Wiki contains third-party content, including websites, products, and services, that are provided for informational purposes only. - -XGR.Network GmbH does not endorse, warrant, or make any representations regarding the accuracy, quality, reliability, or legality of any third-party websites, products, or services. If you decide to access any third-party content linked from the XGRChain Wiki, you do so entirely at your own risk and subject to the terms and conditions of use for such websites. XGR.Network GmbH reserves the right to withdraw such references and links without notice. - -The XGRChain Wiki serves as an industry public good and is made available under the MIT open source license. In addition, please view the official XGR.Network GmbH Terms of Use, available [here](https://xgr.network/terms-of-use). \ No newline at end of file diff --git a/docs/docs/img/edge/bridge-deposit-childchain.excalidraw.png b/docs/docs/img/edge/bridge-deposit-childchain.excalidraw.png deleted file mode 100644 index ff584ff..0000000 Binary files a/docs/docs/img/edge/bridge-deposit-childchain.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/bridge-deposit-rootchain.excalidraw.png b/docs/docs/img/edge/bridge-deposit-rootchain.excalidraw.png deleted file mode 100644 index 82e1d17..0000000 Binary files a/docs/docs/img/edge/bridge-deposit-rootchain.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/bridge-withdraw-childchain.excalidraw.png b/docs/docs/img/edge/bridge-withdraw-childchain.excalidraw.png deleted file mode 100644 index 363b514..0000000 Binary files a/docs/docs/img/edge/bridge-withdraw-childchain.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/bridge-withdraw-rootchain.excalidraw.png b/docs/docs/img/edge/bridge-withdraw-rootchain.excalidraw.png deleted file mode 100644 index c0b3220..0000000 Binary files a/docs/docs/img/edge/bridge-withdraw-rootchain.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/consensus.excalidraw.png b/docs/docs/img/edge/consensus.excalidraw.png deleted file mode 100644 index 4efdb75..0000000 Binary files a/docs/docs/img/edge/consensus.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/contracts-bridge.excalidraw.png b/docs/docs/img/edge/contracts-bridge.excalidraw.png deleted file mode 100644 index b9e5d0c..0000000 Binary files a/docs/docs/img/edge/contracts-bridge.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/contracts.excalidraw.png b/docs/docs/img/edge/contracts.excalidraw.png deleted file mode 100644 index 5ea5048..0000000 Binary files a/docs/docs/img/edge/contracts.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/l1-l2-l3.excalidraw.png b/docs/docs/img/edge/l1-l2-l3.excalidraw.png deleted file mode 100644 index bb50148..0000000 Binary files a/docs/docs/img/edge/l1-l2-l3.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/polybft-node.excalidraw.png b/docs/docs/img/edge/polybft-node.excalidraw.png deleted file mode 100644 index 26f7fd1..0000000 Binary files a/docs/docs/img/edge/polybft-node.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/polybft.excalidraw.png b/docs/docs/img/edge/polybft.excalidraw.png deleted file mode 100644 index 4baf86d..0000000 Binary files a/docs/docs/img/edge/polybft.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/supernet.svg b/docs/docs/img/edge/supernet.svg deleted file mode 100644 index 7959bed..0000000 --- a/docs/docs/img/edge/supernet.svg +++ /dev/null @@ -1,3 +0,0 @@ - - - diff --git a/docs/docs/img/edge/supernets-checkpoint-exit.excalidraw.png b/docs/docs/img/edge/supernets-checkpoint-exit.excalidraw.png deleted file mode 100644 index e91441d..0000000 Binary files a/docs/docs/img/edge/supernets-checkpoint-exit.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/supernets-checkpoint.excalidraw.png b/docs/docs/img/edge/supernets-checkpoint.excalidraw.png deleted file mode 100644 index 8d096dd..0000000 Binary files a/docs/docs/img/edge/supernets-checkpoint.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/supernets-consensus.excalidraw.png b/docs/docs/img/edge/supernets-consensus.excalidraw.png deleted file mode 100644 index 4bcabfd..0000000 Binary files a/docs/docs/img/edge/supernets-consensus.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/supernets-interconnected.excalidraw.png b/docs/docs/img/edge/supernets-interconnected.excalidraw.png deleted file mode 100644 index ed1735c..0000000 Binary files a/docs/docs/img/edge/supernets-interconnected.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/supernets-logo.png b/docs/docs/img/edge/supernets-logo.png deleted file mode 100644 index 76575aa..0000000 Binary files a/docs/docs/img/edge/supernets-logo.png and /dev/null differ diff --git a/docs/docs/img/edge/supernets-overview.excalidraw.png b/docs/docs/img/edge/supernets-overview.excalidraw.png deleted file mode 100644 index 1fcb26c..0000000 Binary files a/docs/docs/img/edge/supernets-overview.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/supernets-setup-non.excalidraw.png b/docs/docs/img/edge/supernets-setup-non.excalidraw.png deleted file mode 100644 index e04a8d6..0000000 Binary files a/docs/docs/img/edge/supernets-setup-non.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/supernets-setup.excalidraw.png b/docs/docs/img/edge/supernets-setup.excalidraw.png deleted file mode 100644 index cecb573..0000000 Binary files a/docs/docs/img/edge/supernets-setup.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/supernets-together-lp.excalidraw.png b/docs/docs/img/edge/supernets-together-lp.excalidraw.png deleted file mode 100644 index ebda3b1..0000000 Binary files a/docs/docs/img/edge/supernets-together-lp.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/supernets-together.excalidraw.png b/docs/docs/img/edge/supernets-together.excalidraw.png deleted file mode 100644 index 8d9fea6..0000000 Binary files a/docs/docs/img/edge/supernets-together.excalidraw.png and /dev/null differ diff --git a/docs/docs/img/edge/val-select.excalidraw.png b/docs/docs/img/edge/val-select.excalidraw.png deleted file mode 100644 index 33a720a..0000000 Binary files a/docs/docs/img/edge/val-select.excalidraw.png and /dev/null differ diff --git a/docs/docs/index.md b/docs/docs/index.md deleted file mode 100644 index 8f3c4b3..0000000 --- a/docs/docs/index.md +++ /dev/null @@ -1,38 +0,0 @@ -## Background - -XGRChain was established with the aim of delivering a robust Software Development Kit (SDK) for blockchains, grounded in Polygon's foundational vision for Ethereum. This vision sought to transform Ethereum into a multi-chain system by introducing a structured framework for its diversified expansion. - -Despite its role in empowering critical infrastructure, the original SDK lacked essential support and pre-built services necessary for overcoming challenges in blockchain infrastructure deployment, management, and bootstrapping. It was at this juncture that the Supernets vision was conceived to elevate Edge by developing a product suite centered around the [Edge client](https://github.com/xgr-network/xgr-node), while incorporating enterprise-grade features such as cross-chain interoperability, access control, and extensive customizability. - -Now, the innovations from ZK and PoS-based mechanisms are integrated into a comprehensive chain development kit, known as the Polygon CDK. - -In summary: - -- **XGRChain**: Originated as an SDK designed for initiating sidechains, it facilitated the development of Ethereum-compatible blockchain networks and functioned as a Layer 3 development kit. **The original Edge progressed until the 0.6.x versions, stopping at [v0.6.3](https://github.com/xgr-network/xgr-node/releases/tag/v0.6.3). Please read [this archive disclaimer](https://github.com/xgr-network/wiki/tree/main/archive/edge) on the legacy Edge documentation.** - -- **Polygon Supernets**: Representing the evolved form of Edge, it resolves the complexities associated with infrastructure development and bootstrapping for app-chains. It aimed to provide enhanced interoperability, customization options, and also operates as a Layer 3 development kit. **Supernets was introduced in [v0.7.0](https://github.com/xgr-network/xgr-node/releases/tag/v0.7.0-alpha1); the latest version is [v1.1.0](https://github.com/xgr-network/xgr-node/releases/tag/v1.1.0).** - -- **Polygon CDK**: The most refined and sophisticated version, focusing on Layer 2 solutions, exemplifies modularity and customization. It leverages the innovative ZK protocol primitives from Polygon 2.0, allowing developers to craft chains specifically aligned with their unique requirements. The CDK currently priortizes the validium offering, which is based on Polygon zkEVM. - -## Introduction - -Edge provides infrastructure for application-specific chains that operate with PolyBFT consensus. It leverages a native bridge to connect with an associated rootchain, enabling Edge-powered chains to inherit its security and capabilities. Additionally, Edge extend the block space available on the rootchain, providing scalability and interoperability for decentralized applications. With on-chain governance mechanisms, Edge empower communities to make decisions and upgrade the network in a transparent and compliant manner. - -The following table offers a comprehensive overview on what Edge-powered chains are through different perspectives. - -| Edge-powered chains are | Description | -|-----------|-------------| -| Application-specific blockchain networks designed for specific use cases. | Appchains are customizable blockchain networks that developers can tailor to meet specific enterprise or application use cases. With appchains, developers can create high-performance blockchain networks that are fast and low-cost. | -| Modular and complex-minimized blockchain development. | Edge offer a modular framework that simplifies blockchain development, providing developers with the tools necessary to create customizable blockchain networks that are scalable, secure, and interoperable. Developers can use the Edge stack to create high-performance blockchain networks with advanced capabilities without worrying about complex integrations or intermediaries. | -| Customizable blockchain networks for reliable business logic. | A customizable virtual machine provides full Ethereum Virtual Machine (EVM) support out of the box, enabling developers to tailor the virtual machine to their specific needs and requirements. This feature includes customizing gas limits, adding new opcodes, and integrating with other technologies. | -| Interoperable and multi-chain driven | A native bridging solution enables the seamless transfer of assets from various EVM-compatible blockchains back to the Polygon ecosystem. This bridging solution allows developers to customize bridge plugins to meet specific requirements, facilitating interoperability between blockchains and different layers. | - -
- bridge -
- -The diagram above demonstrates how Edge-powered chains are interconnected with the Polygon PoS network, which benefits from the security properties of Ethereum. By leveraging blockchain technology, Edge provide a strong foundation for building decentralized and blockchain-based solutions that can withstand adversarial conditions, resist censorship, and scale to meet the increasing demand for processing power, data storage, and transaction throughput. - -Edge employs a multi-faceted approach that leverages a combination of complementary scaling solutions to achieve maximum scalability. These solutions include layer-2 scaling techniques, parallelization, and, eventually, ZK technology. - -By integrating these methods, Edge can efficiently accommodate the increasing demand for processing power, data storage, and transaction throughput as the number of users and applications on the network grows. diff --git a/docs/docs/interfaces/cryptography/bls.md b/docs/docs/interfaces/cryptography/bls.md deleted file mode 100644 index 4f931d0..0000000 --- a/docs/docs/interfaces/cryptography/bls.md +++ /dev/null @@ -1,111 +0,0 @@ -The `IBLS` interface provides a set of functions for working with BLS (Boneh-Lynn-Shacham) signatures in a smart contract. This user guide will explain how to interact with the functions provided by the IBLS interface. - -## Functions - -### verifySingle() - -This function verifies a single signature. - -#### Parameters - -- `signature` (uint256[2]): A 64-byte G1 group element (small signature). -- `pubkey` (uint256[4]): A 128-byte G2 group element (big pubkey). -- `message` (uint256[2]): The message signed to produce the signature. - -#### Usage - -To verify a single signature, call the verifySingle() function with the required parameters: - -```solidity -(bool sigVerification, bool callSuccess) = IBLS.instance.verifySingle(signature, pubkey, message); -``` - -### verifyMultiple() - -This function verifies multiple non-aggregated signatures where each message is unique. - -#### Parameters - -- `signature` (uint256[2]): A 64-byte G1 group element (small signature). -- `pubkeys` (uint256[4][]): An array of 128-byte G2 group elements (big pubkeys). -- `messages` (uint256[2][]): An array of messages signed to produce the signature. - -#### Usage - -To verify multiple non-aggregated signatures, call the verifyMultiple() function with the required parameters: - -```solidity -(bool checkResult, bool callSuccess) = IBLS.instance.verifyMultiple(signature, pubkeys, messages); -``` - -### verifyMultipleSameMsg() - -This function verifies an aggregated signature where the same message is signed. - -#### Parameters - -- `signature` (uint256[2]): A 64-byte G1 group element (small signature). -- `pubkeys` (uint256[4][]): An array of 128-byte G2 group elements (big pubkeys). -- `message` (uint256[2]): The message signed by all to produce the signature. - -#### Usage - -To verify an aggregated signature with the same message, call the verifyMultipleSameMsg() function with the required parameters: - -```solidity -(bool checkResult, bool callSuccess) = IBLS.instance.verifyMultipleSameMsg(signature, pubkeys, message); -``` - -### mapToPoint() - -This function maps a field element to the curve. - -#### Parameters - -`_x`(uint256): A valid field element. - -#### Usage - -To map a field element to the curve, call the mapToPoint() function with the required parameter: - -```solidity -uint256[2] memory point = IBLS.instance.mapToPoint(_x); -``` - -### isValidSignature() - -This function checks if a signature is formatted correctly and valid. It will revert if improperly formatted and return false if invalid. - -#### Parameters - -`signature` (uint256[2]): The BLS signature. - -#### Usage - -To check if a signature is valid, call the isValidSignature() function with the required parameter: - -```solidity -bool isValid = IBLS.instance.isValidSignature(signature); -``` - -### isOnCurveG1() - -This function checks if a point in the finite field Fq (x, y) is on the G1 curve. - -#### Parameters - -`point` (uint256[2]): An array with x and y values of the point. - -#### Usage - -To check if a point is on the G1 curve, call the isOnCurveG1() function with the required parameter: - -```solidity -bool isOnCurve = IBLS.instance.isOnCurveG1(point); -``` - -### isOnCurveG2() - -This function checks if a point in the finite field Fq (x, y) is on the G2 curve. - -#### Parameters diff --git a/docs/docs/interfaces/cryptography/bn256g2.md b/docs/docs/interfaces/cryptography/bn256g2.md deleted file mode 100644 index 0386c2c..0000000 --- a/docs/docs/interfaces/cryptography/bn256g2.md +++ /dev/null @@ -1,35 +0,0 @@ -The `IBN256G2` interface provides functionality for performing addition operations on points in the G2 subgroup of the BN256 elliptic curve. This user guide will explain how to interact with the function provided by the `IBN256G2` interface. - -## Functions - -### ecTwistAdd() - -This function performs the addition operation on two points in the G2 subgroup of the BN256 elliptic curve. - -#### Parameters - -- `pt1xx` (uint256): The xx-coordinate of the first point. -- `pt1xy` (uint256): The xy-coordinate of the first point. -- `pt1yx` (uint256): The yx-coordinate of the first point. -- `pt1yy` (uint256): The yy-coordinate of the first point. -- `pt2xx` (uint256): The xx-coordinate of the second point. -- `pt2xy` (uint256): The xy-coordinate of the second point. -- `pt2yx` (uint256): The yx-coordinate of the second point. -- `pt2yy` (uint256): The yy-coordinate of the second point. - -#### Usage - -To perform the addition operation on two points in the G2 subgroup of the BN256 elliptic curve, call the `ecTwistAdd()` function with the required parameters: - -```solidity -IBN256G2 bn256g2Instance = IBN256G2(bn256g2Address); - -(uint256 pt3xx, uint256 pt3xy, uint256 pt3yx, uint256 pt3yy) = bn256g2Instance.ecTwistAdd( - pt1xx, pt1xy, pt1yx, pt1yy, - pt2xx, pt2xy, pt2yx, pt2yy -); -``` - -Replace `bn256g2Address` with the address of an existing `IBN256G2` implementation. Replace `pt1xx`, `pt1xy`, `pt1yx`, `pt1yy`, `pt2xx`, `pt2xy`, `pt2yx`, and `pt2yy` with the coordinates of the points you want to add. The resulting point, `pt3`, will have the coordinates (`pt3xx`, `pt3xy`, `pt3yx`, `pt3yy`). - -The `ecTwistAdd()` function allows you to perform elliptic curve operations on the BN256 curve in the G2 subgroup, which can be useful for cryptographic applications such as zero-knowledge proofs, signature schemes, and more. diff --git a/docs/docs/interfaces/eip1559.md b/docs/docs/interfaces/eip1559.md deleted file mode 100644 index de909dc..0000000 --- a/docs/docs/interfaces/eip1559.md +++ /dev/null @@ -1,47 +0,0 @@ -The `EIP1559Burn` contract burns the native token on the rootchain as an ERC-20 token. This operation is crucial for maintaining the value of the token across different chains. - -## Functions - -## initialize() - -```solidity -function initialize(IChildERC20Predicate newChildERC20Predicate, address newBurnDestination) -``` - -This is the initialization function for the `EIP1559Burn` contract. It sets the `childERC20Predicate` and `burnDestination` state variables. This function can only be called once due to the initializer modifier. - -### Parameters: - -- `newChildERC20Predicate`: Address of the ERC20 predicate on the childchain -- `newBurnDestination`: Address on the root chain to burn the tokens and send to - -## withdraw() - -```solidity -function withdraw() external { - require(address(childERC20Predicate) != address(0), "EIP1559Burn: UNINITIALIZED"); - ... -} -``` - -This function burns the native tokens on the childchain and sends them to the burn destination on the rootchain. It requires the `childERC20Predicate` to be initialized, and takes the entire current native token balance and burns it. - -## Events - -### NativeTokenBurnt() - -This event is emitted when native tokens are burnt. It includes the address of the burner and the amount of tokens that were burnt. - -## Usage - -The `EIP1559Burn` contract is a part of the asset bridging process between the rootchain and the childchain. It interacts with the `IChildERC20Predicate` contract, which is responsible for handling the token transfer process. - -In the asset bridging process, users deposit ERC20 tokens from the rootchain to the childchain, transact on the childchain, and then withdraw their assets back to the rootchain when they're done. The `withdraw()` function of the EIP1559Burn contract is called when users are ready to burn their tokens on the child chain and move them back to the rootchain. - -Here is a high-level sequence of the bridging process: - -- **Deposit**: Users deposit ERC20 tokens from the root chain to the childchain. The tokens are approved for transfer by the rootchain's ERC20 contract, and then deposited in the root chain's ERC20 predicate contract. The state of the deposit is synced to the childchain, and the tokens are minted on the child chain​1​ - -- **Withdraw**: When users want to move their assets back to the root chain, they initiate a withdrawal. The childchain's ERC20 predicate contract calls the `withdrawTo()` function, which burns the tokens on the childchain and syncs the state of the withdrawal back to the rootchain​​. - -- **Exit**: The withdrawal is finalized on the root chain. The root chain's ERC20 predicate contract transfers the tokens back to the user. diff --git a/docs/docs/interfaces/erc1155/childerc1155-predicate.md b/docs/docs/interfaces/erc1155/childerc1155-predicate.md deleted file mode 100644 index 7a5ea27..0000000 --- a/docs/docs/interfaces/erc1155/childerc1155-predicate.md +++ /dev/null @@ -1,77 +0,0 @@ -The `IChildERC1155Predicate` interface is designed to work with the ERC1155-compliant token on the L2 side of the childchain. It handles the minting, burning, and state management for child tokens. This user guide will explain how to interact with the functions provided by the `IChildERC1155Predicate` interface. - -## Functions - -### initialize() - -This function initializes the predicate with the required parameters. - -#### Parameters - -- `newL2StateSender` (address): The L2 state sender address. -- `newStateReceiver` (address): The state receiver address. -- `newRootERC721Predicate` (address): The root ERC721 predicate address. -- `newChildTokenTemplate` (address): The child token template address. - -#### Usage - -To initialize the `IChildERC1155Predicate` instance, call the `initialize()` function with the required parameters: - -```solidity -IChildERC1155Predicate.instance.initialize(newL2StateSender, newStateReceiver, newRootERC721Predicate, newChildTokenTemplate); -``` - -### onStateReceive() - -This function receives the state data from the main chain. - -#### Parameters - -- `id` (uint256): An identifier for the state data. -- `sender` (address): The sender address. -- `data` (bytes): The state data. - -#### Usage - -To handle state data received from the main chain, the predicate should call the `onStateReceive()` function with the required parameters: - -```solidity -IChildERC1155Predicate.instance.onStateReceive(id, sender, data); -``` - -### withdraw() - -This function allows the user to withdraw their child tokens to the main chain. - -#### Parameters - -- `childToken` (IChildERC1155): The child token contract. -- `tokenId` (uint256): The token identifier. -- `amount` (uint256): The amount of tokens to withdraw. - -#### Usage - -To withdraw child tokens to the main chain, call the `withdraw()` function with the required parameters: - -```solidity -IChildERC1155Predicate.instance.withdraw(childToken, tokenId, amount); -``` - -### withdrawTo() - -This function allows the user to withdraw their child tokens to a specific address on the main chain. - -#### Parameters - -- `childToken` (IChildERC1155): The child token contract. -- `receiver` (address): The address to receive the tokens on the main chain. -- `tokenId` (uint256): The token identifier. -- `amount` (uint256): The amount of tokens to withdraw. - -#### Usage - -To withdraw child tokens to a specific address on the main chain, call the `withdrawTo()` function with the required parameters: - -```solidity -IChildERC1155Predicate.instance.withdrawTo(childToken, receiver, tokenId, amount); -``` diff --git a/docs/docs/interfaces/erc1155/childerc1155.md b/docs/docs/interfaces/erc1155/childerc1155.md deleted file mode 100644 index 87eb979..0000000 --- a/docs/docs/interfaces/erc1155/childerc1155.md +++ /dev/null @@ -1,117 +0,0 @@ -The `IChildERC1155` interface represents an ERC1155-compliant token on the L2 side of the childchain. It allows the minting and burning of tokens under the control of a predicate address. This user guide will explain how to interact with the functions provided by the `IChildERC1155` interface. - -## Functions - -### initialize() - -This function sets the values for the rootToken, name, and uri. The value for rootToken is immutable and can only be set once during initialization. - -#### Parameters - -- `rootToken_` (address): The address of the token on the rootchain. -- `name_` (string): The token's name. -- `uri_` (string): The token's metadata URI. - -#### Usage - -To initialize the IChildERC1155 instance, call the initialize() function with the required parameters: - -```solidity -IChildERC1155.instance.initialize(rootToken, name, uri); -``` - -### predicate() - -This function returns the predicate address controlling the child token. - -#### Usage - -To get the predicate address, call the predicate() function: - -```solidity -const predicateAddress = IChildERC1155.instance.predicate(); -``` - -### rootToken() - -This function returns the address of the token on the rootchain. - -#### Usage - -To get the address of the token on the rootchain, call the rootToken() function: - -```solidity -const rootTokenAddress = IChildERC1155.instance.rootToken(); -``` - -### mint() - -This function mints an NFT token to a particular address. The predicate address can only call it. - -#### Parameters - -- `account` (address): The user's account to mint the tokens. -- `id` (uint256): The index of NFT to mint to the account. -- `amount` (uint256): The amount of NFT to mint. - -#### Usage - -To mint an NFT token to an address, the predicate should call the mint() function with the required parameters: - -```solidity -bool success = IChildERC1155.instance.mint(account, id, amount); -``` - -### mintBatch() - -This function mints multiple NFTs to one address. - -#### Parameters - -- `accounts` (address[]): An array of addresses to mint each NFT to. -- `tokenIds` (uint256[]): An array of indexes of the NFTs to be minted. -- `amounts` (uint256[]): An array of the amount of each NFT to be minted. - -#### Usage - -To mint multiple NFTs to one address, call the mintBatch() function with the required parameters: - -```solidity -bool success = IChildERC1155.instance.mintBatch(accounts, tokenIds, amounts); -``` - -### burn() - -This function burns an NFT token from a particular address. The predicate address can only call it. - -#### Parameters - -- `from` (address): The user's account to burn the tokens from. -- `id` (uint256): The index of NFT to burn from the account. -- `amount` (uint256): The amount of NFT to burn. - -#### Usage - -To burn an NFT token from an address, the predicate should call the burn() function with the required parameters: - -```solidity -bool success = IChildERC1155.instance.burn(from, id, amount); -``` - -### burnBatch() - -This function burns multiple NFTs from one address. - -#### Parameters - -- `from` (address): The address to burn NFTs from. -- `tokenIds` (uint256[]): An array of indexes of the NFTs to be burned. -- `amounts` (uint256[]): An array of the amount of each N - -#### Usage - -To burn multiple NFTs from one address, call the burnBatch() function with the required parameters: - -```solidity -bool success = IChildERC1155.instance.burnBatch(from, tokenIds, amounts); -``` diff --git a/docs/docs/interfaces/erc1155/rooterc1155-predicate.md b/docs/docs/interfaces/erc1155/rooterc1155-predicate.md deleted file mode 100644 index 31ed466..0000000 --- a/docs/docs/interfaces/erc1155/rooterc1155-predicate.md +++ /dev/null @@ -1,81 +0,0 @@ -The `IRootERC1155Predicate` interface is designed to work with ERC-1155 tokens on a rootchain. It provides functionality for depositing, withdrawing, and mapping ERC-1155 tokens between root and childchains. This user guide will explain how to interact with the functions provided by the `IRootERC1155Predicate` interface. - -## Functions - -### deposit() - -This function deposits tokens from the depositor to themselves on the childchain. - -#### Parameters - -- `rootToken` (IERC1155MetadataURI): The root token being deposited. -- `tokenId` (uint256): The index of the NFT to deposit. -- `amount` (uint256): The amount to deposit. - -#### Usage - -To deposit tokens from the depositor to themselves on the childchain, call the `deposit()` function with the required parameters: - -```solidity -IRootERC1155Predicate.instance.deposit(rootToken, tokenId, amount); -``` - -### depositTo() - -This function deposits tokens from the depositor to another address on the childchain. - -#### Parameters - -- `rootToken` (IERC1155MetadataURI): The root token being deposited. -- `receiver` (address): The address of the receiver on the childchain. -- `tokenId` (uint256): The index of the NFT to deposit. -- `amount` (uint256): The amount to deposit. - -#### Usage - -To deposit tokens from the depositor to another address on the childchain, call the `depositTo()` function with the required parameters: - -```solidity -IRootERC1155Predicate.instance.depositTo(rootToken, receiver, tokenId, amount); -``` - -### depositBatch() - -This function deposits tokens from the depositor to other addresses on the childchain. - -#### Parameters - -- `rootToken` (IERC1155MetadataURI): The root token being deposited. -- `receivers` (address[]): The addresses of the receivers on the childchain. -- `tokenIds` (uint256[]): The indices of the NFTs to deposit. -- `amounts` (uint256[]): The amounts to deposit. - -#### Usage - -To deposit tokens from the depositor to other addresses on the childchain, call the `depositBatch()` function with the required parameters: - -```solidity -IRootERC1155Predicate.instance.depositBatch(rootToken, receivers, tokenIds, amounts); -``` - -### mapToken() - -This function is used for token mapping. - -#### Parameters - -`rootToken` (IERC1155MetadataURI): The address of the root token to map. - -#### Returns - -`childToken` (address): The address of the mapped child token. - -#### Usage - -To map a token, call the mapToken() function with the required parameter: - -```solidity -address childToken = IRootERC1155Predicate.instance.mapToken(rootToken); -``` - -This function is called internally on deposit if the token is not mapped already. diff --git a/docs/docs/interfaces/erc20/childerc20-predicate.md b/docs/docs/interfaces/erc20/childerc20-predicate.md deleted file mode 100644 index 783af83..0000000 --- a/docs/docs/interfaces/erc20/childerc20-predicate.md +++ /dev/null @@ -1,55 +0,0 @@ -The `IChildERC20Predicate` interface is part of the cross-chain bridge system, which manages the child tokens on the L2 side. This guide will explain the methods provided by the IChildERC20Predicate interface and how to use them. - -## Overview - -The `IChildERC20Predicate` interface is responsible for managing child tokens on L2. It provides: - -- Methods for deploying new child tokens. -- Processing state updates received from L1. -- Withdrawing tokens back to L1. - -## Initialize - -Before using the IChildERC20Predicate contract, it must be initialized with the required parameters: - -```solidity -function initialize( - address newL2StateSender, - address newStateReceiver, - address newRootERC20Predicate, - address newChildTokenTemplate, - address newNativeTokenRootAddress -) public virtual onlySystemCall initializer { -``` - -The parameters for initialization include the addresses of the L2 state sender, the state receiver, the root ERC20 predicate, and the child token template. The initialization also requires the native token's root address, name, symbol, and decimals. - -## Process state updates - -The onStateReceive method receives state updates from the L1 side and processes the data accordingly: - -```solidity -function onStateReceive(uint256 /* id */, address sender, bytes calldata data) external; -``` - -When a state update is received, the method processes the data based on the sender's address and provided data. The system typically calls this method automatically when state updates are received from L1. - -## Withdraw tokens - -To withdraw tokens from L2 back to L1, call the withdraw method: - -```solidity -function withdraw(IChildERC20 childToken, uint256 amount) external; -``` - -This method takes the child token contract address and the amount to be withdrawn. The tokens will be withdrawn to the message sender's address on L1. - -## Withdraw tokens to a specific address - -If you want to withdraw tokens from L2 to L1 for a specific address, use the `withdrawTo` method: - -```solidity -function withdrawTo(IChildERC20 childToken, address receiver, uint256 amount) external; -``` - -This method takes the child token contract address, the receiver's address, and the amount to be withdrawn. The tokens will be withdrawn to the specified receiver's address on L1. diff --git a/docs/docs/interfaces/erc20/childerc20.md b/docs/docs/interfaces/erc20/childerc20.md deleted file mode 100644 index 92a5a97..0000000 --- a/docs/docs/interfaces/erc20/childerc20.md +++ /dev/null @@ -1,65 +0,0 @@ -The `IChildERC20` interface extends the `IERC20MetadataUpgradeable` interface to provide additional token functionality on a childchain or layer 2 solution. This guide explains how to interact with the interface and its methods. - -## Overview - -The `IChildERC20` interface includes methods for: - -- Initializing the token -- Retrieving the predicate and root token addresses -- Minting and burning tokens - -## Initializing the Token - -To initialize a child token, call the initialize function with the following parameters: - -- `rootToken_`: The address of the root token on the main chain. -- `name_`: The name of the token. -- `symbol_`: The symbol of the token. -- `decimals_`: The number of decimals used to define the smallest unit of the token. - -Example - -```solidity -childToken.initialize(rootTokenAddress, "My Token", "MTK", 18); -``` - -## Retrieving the Predicate and Root Token Addresses - -To get the predicate and root token addresses, call the `predicate` and `rootToken` functions respectively. - -Example: - -```solidity -address predicateAddress = childToken.predicate(); -address rootTokenAddress = childToken.rootToken(); -``` - -## Minting and Burning Tokens - -The `mint` and `burn` functions can only be called by the predicate address, which typically represents a bridge contract responsible for managing the token's supply between the main chain and the childchain. - -### Minting Tokens - -To mint tokens, call the mint function with the following parameters: - -- `account`: The user's address to mint the tokens. -- `amount`: The amount of tokens to mint to the account. - -```solidity -bool success = childToken.mint(userAddress, 100 * 10**18); -``` - -## Burning Tokens - -To burn tokens, call the burn function with the following parameters: - -- `account`: The user's address to burn the tokens. -- `amount`: The amount of tokens to burn from the account. - -Example: - -```solidity -bool success = childToken.burn(userAddress, 50 * 10**18); -``` - -> Note: The predicate address should only call the mint and burn functions. If you're a developer integrating with a child token, you typically won't need to interact with these functions directly. Instead, you'll interact with the bridge or the main chain's root token contract to move tokens between chains. diff --git a/docs/docs/interfaces/erc20/native-erc20.md b/docs/docs/interfaces/erc20/native-erc20.md deleted file mode 100644 index fbe70eb..0000000 --- a/docs/docs/interfaces/erc20/native-erc20.md +++ /dev/null @@ -1,84 +0,0 @@ -The `INativeERC20` interface represents a native ERC20 token on the L2 side of the childchain. It allows the minting and burning of tokens under the control of a predicate address. This user guide will explain how to interact with the functions provided by the `INativeERC20` interface. - -## Functions - -### initialize() - -This function sets the values for the predicate, rootToken, name, symbol, and decimals. - -#### Parameters - -- `predicate_` (address): The address of the predicate controlling the child token. -- `rootToken_` (address): The address of the root token on the mainchain. -- `name_` (string): The token's name. -- `symbol_` (string): The token's symbol. -- `decimals_` (uint8): The number of decimals for the token. -- `tokenSupply_` (uint256): Initial total supply of token. - -#### Usage - -To initialize the INativeERC20 instance, call the `initialize()` function with the required parameters: - -```solidity -INativeERC20.instance.initialize(predicate, rootToken, name, symbol, decimals); -``` - -### predicate() - -This function returns the predicate address controlling the child token. - -#### Usage - -To get the predicate address, call the `predicate()` function: - -```solidity -const predicateAddress = INativeERC20.instance.predicate(); -``` - -### rootToken() - -This function returns the root token address. - -#### Usage - -To get the root token address, call the `rootToken()` function: - -```solidity -const rootTokenAddress = INativeERC20.instance.rootToken(); -``` - -### mint() - -This function mints an amount of tokens to a particular address. The predicate address can only call it. - -#### Parameters - -- `account` (address): The user's account to mint the tokens. -- `amount` (uint256): The token amount to mint to the account. - -#### Usage - -To mint tokens to an address, the predicate should call the `mint()` function with the required parameters: - -```solidity -INativeERC20.instance.mint(account, amount); -``` - -### burn() - -This function burns an amount of tokens from a particular address. The predicate address can only call it. - -#### Parameters - -- `account` (address): The user's account to burn the tokens from. -- `amount` (uint256): The amount of tokens to burn from the account. - -#### Usage - -To burn tokens from an address, the predicate should call the `burn()` function with the required parameters: - -```solidity -INativeERC20.instance.burn(account, amount); -``` - -These functions enable interaction with native ERC20 tokens on the L2 side of the childchain. Developers can use these functions to mint, burn, and retrieve information about native ERC20 tokens. diff --git a/docs/docs/interfaces/erc20/rooterc20-predicate.md b/docs/docs/interfaces/erc20/rooterc20-predicate.md deleted file mode 100644 index 5de009c..0000000 --- a/docs/docs/interfaces/erc20/rooterc20-predicate.md +++ /dev/null @@ -1,50 +0,0 @@ -The `IRootERC20Predicate` interface is designed to work with ERC20 tokens on a rootchain. It provides functionality for depositing and mapping ERC20 tokens between root and childchains. This user guide will explain how to interact with the functions provided by the `IRootERC20Predicate` interface. - -## Functions - -### deposit() - -This function deposits tokens from the depositor to themselves on the childchain. - -#### Parameters - -- `rootToken` (IERC20Metadata): The root token being deposited. -- `amount` (uint256): The amount to deposit. - -#### Usage - -To deposit tokens from the depositor to themselves on the childchain, call the `deposit()` function with the required parameters: - -```solidity -IRootERC20Predicate.instance.deposit(rootToken, amount); -``` - -### depositTo() - -This function deposits tokens from the depositor to another address on the childchain. - -#### Parameters - -- `rootToken` (IERC20Metadata): The root token being deposited. -- `receiver` (address): The address of the receiver on the childchain. -- `amount` (uint256): The amount to deposit. - -#### Usage - -To deposit tokens from the depositor to another address on the childchain, call the `depositTo()` function with the required parameters: - -```solidity -IRootERC20Predicate.instance.depositTo(rootToken, receiver, amount); -``` - -### mapToken() - -This function is used for token mapping. - -#### Parameters - -rootToken (IERC20Metadata): The address of the root token to map. - -#### Usage - -The mapToken() function is called internally on deposit if the token is not mapped already. diff --git a/docs/docs/interfaces/erc721/childerc721-predicate.md b/docs/docs/interfaces/erc721/childerc721-predicate.md deleted file mode 100644 index bb90a32..0000000 --- a/docs/docs/interfaces/erc721/childerc721-predicate.md +++ /dev/null @@ -1,89 +0,0 @@ -The `IChildERC721Predicate` interface is designed to work in conjunction with the `IChildERC721` interface to enable the withdrawal of ERC721-compliant NFT tokens from a childchain back to the rootchain. This user guide will explain how to interact with the functions provided by the `IChildERC721Predicate` interface. - -## Functions - -### initialize() - -This function initializes the predicate contract with required parameters. - -#### Parameters - -- `newL2StateSender` (address): The address of the L2 state sender. -- `newStateReceiver` (address): The address of the state receiver. -- `newRootERC721Predicate` (address): The address of the root ERC721 predicate. -- `newChildTokenTemplate` (address): The address of the child token template. - -#### Usage - -To initialize the `IChildERC721Predicate` instance, call the `initialize()` function with the required parameters: - -```solidity -IChildERC721Predicate.instance.initialize(newL2StateSender, newStateReceiver, newRootERC721Predicate, newChildTokenTemplate); -``` - -### onStateReceive() - -This function is called when the predicate receives a state update from the L2 state sender. - -#### Parameters - -- `id` (uint256): An identifier, not used in this implementation. -- `sender` (address): The address of the sender. -- `data` (bytes): The calldata to be processed. - -#### Usage - -The `onStateReceive()` function is not intended to be called directly by developers. It is automatically called when the predicate receives a state update from the L2 state sender. - -### withdraw() - -This function withdraws an NFT token to the original owner. - -#### Parameters - -- `childToken` (IChildERC721): The child token contract instance. -- `tokenId` (uint256): The token identifier. - -#### Usage - -To withdraw an NFT token to the original owner, call the `withdraw()` function with the required parameters: - -```solidity -IChildERC721Predicate.instance.withdraw(childToken, tokenId); -``` - -### withdrawTo() - -This function withdraws an NFT token to a specified address. - -#### Parameters - -- `childToken` (IChildERC721): The child token contract instance. -- `receiver` (address): The address of the recipient. -- `tokenId` (uint256): The token identifier. - -#### Usage - -To withdraw an NFT token to a specified address, call the `withdrawTo()` function with the required parameters: - -```solidity -IChildERC721Predicate.instance.withdrawTo(childToken, receiver, tokenId); -``` - -### withdrawBatch() - -This function withdraws multiple NFT tokens to specified addresses in one transaction. - -#### Parameters - -- `childToken` (IChildERC721): The child token contract instance. -- `receivers` (address[]): An array of recipient addresses. -- `tokenIds` (uint256[]): An array of token identifiers. - -#### Usage - -To withdraw multiple NFT tokens to specified addresses in one transaction, call the `withdrawBatch()` function with the required parameters: - -```solidity -IChildERC721Predicate.instance.withdrawBatch(childToken, receivers, tokenIds); -``` diff --git a/docs/docs/interfaces/erc721/childerc721.md b/docs/docs/interfaces/erc721/childerc721.md deleted file mode 100644 index ec756b7..0000000 --- a/docs/docs/interfaces/erc721/childerc721.md +++ /dev/null @@ -1,113 +0,0 @@ -The `IChildERC721` interface is designed to work with ERC721-compliant NFT tokens on a childchain. It provides functionality for minting, burning, and managing NFTs. This user guide will explain how to interact with the functions provided by the `IChildERC721` interface. - -## Functions - -### initialize() - -This function initializes the child token contract with the root token address, name, and symbol. - -#### Parameters - -- `rootToken_` (address): The root token address. -- `name_` (string): The name of the token. -- `symbol_` (string): The symbol of the token. - -#### Usage - -To initialize the IChildERC721 instance, call the `initialize()` function with the required parameters: - -```solidity -IChildERC721.instance.initialize(rootToken_, name_, symbol_); -``` - -### predicate() - -This function returns the predicate address controlling the child token. - -#### Usage - -To get the predicate address, call the predicate() function: - -```solidity -address predicateAddress = IChildERC721.instance.predicate(); -``` - -### rootToken() - -This function returns the address of the token on the rootchain. - -#### Usage - -To get the root token address, call the `rootToken()` function: - -```solidity -address rootTokenAddress = IChildERC721.instance.rootToken(); -``` - -### mint() - -This function mints an NFT token to a specific address. - -#### Parameters - -- `account` (address): The recipient address. -- `tokenId` (uint256): The token identifier. - -#### Usage - -To mint an NFT token to a specific address, call the `mint()` function with the required parameters: - -```solidity -bool success = IChildERC721.instance.mint(account, tokenId); -``` - -### mintBatch() - -This function mints multiple NFT tokens in one transaction. - -#### Parameters - -- `accounts` (address[]): An array of recipient addresses. -- `tokenIds` (uint256[]): An array of token identifiers. - -#### Usage - -To mint multiple NFT tokens in one transaction, call the `mintBatch()` function with the required parameters: - -```solidity -bool success = IChildERC721.instance.mintBatch(accounts, tokenIds); -``` - -### burn() - -This function burns an NFT token from a specific address. - -#### Parameters - -- `account` (address): The address to burn the NFT from. -- `tokenId` (uint256): The token identifier. - -#### Usage - -To burn an NFT token from a specific address, call the `burn()` function with the required parameters: - -```solidity -bool success = IChildERC721.instance.burn(account, tokenId); -``` - -### burnBatch() - -This function burns multiple NFT tokens from a specific address in one transaction. - -#### Parameters - -- `account` (address): The address to burn the NFTs from. -- `tokenIds` (uint256[]): An array of token identifiers. - -#### Usage - -To burn multiple NFT tokens from a specific address in one transaction, call the `burnBatch()` function with the required parameters: - -```solidity -bool success = IChildERC721.instance.burnBatch(account, tokenIds); -``` diff --git a/docs/docs/interfaces/erc721/rooterc721-predicate.md b/docs/docs/interfaces/erc721/rooterc721-predicate.md deleted file mode 100644 index 2667642..0000000 --- a/docs/docs/interfaces/erc721/rooterc721-predicate.md +++ /dev/null @@ -1,68 +0,0 @@ -The `IRootERC721Predicate` interface is designed to work with ERC721-compliant NFT tokens on a rootchain. It provides functionality for depositing and mapping ERC721 tokens between root and childchains. This user guide will explain how to interact with the functions provided by the `IRootERC721Predicate` interface. - -## Functions - -### deposit() - -This function deposits tokens from the depositor to themselves on the childchain. - -#### Parameters - -- `rootToken` (IERC721Metadata): The root token being deposited. -- `tokenId` (uint256): The index of the NFT to deposit. - -#### Usage - -To deposit tokens from the depositor to themselves on the childchain, call the `deposit()` function with the required parameters: - -```solidity -IRootERC721Predicate.instance.deposit(rootToken, tokenId); -``` - -### depositTo() - -This function deposits tokens from the depositor to another address on the childchain. - -#### Parameters - -- `rootToken` (IERC721Metadata): The root token being deposited. -- `receiver` (address): The address of the receiver on the childchain. -- `tokenId` (uint256): The index of the NFT to deposit. - -#### Usage - -To deposit tokens from the depositor to another address on the childchain, call the depositTo() function with the required parameters: - -```solidity -IRootERC721Predicate.instance.depositTo(rootToken, receiver, tokenId); -``` - -### depositBatch() - -This function deposits tokens from the depositor to other addresses on the childchain. - -#### Parameters - -- `rootToken` (IERC721Metadata): The root token being deposited. -- `receivers` (address[]): An array of addresses of the receivers on the childchain. -- `tokenIds` (uint256[]): An array of indices of the NFTs to deposit. - -#### Usage - -To deposit tokens from the depositor to other addresses on the childchain, call the `depositBatch()` function with the required parameters: - -```solidity -IRootERC721Predicate.instance.depositBatch(rootToken, receivers, tokenIds); -``` - -### mapToken() - -This function is used for token mapping. - -#### Parameters - -`rootToken` (IERC721Metadata): The address of the root token to map. - -#### Usage - -The `mapToken()` function is called internally on deposit if the token is not mapped already. diff --git a/docs/docs/interfaces/network/checkpoint-manager.md b/docs/docs/interfaces/network/checkpoint-manager.md deleted file mode 100644 index 0eb32ab..0000000 --- a/docs/docs/interfaces/network/checkpoint-manager.md +++ /dev/null @@ -1,76 +0,0 @@ -The `ICheckpointManager` interface is a crucial part of the checkpoint system, allowing validators to submit signed checkpoints as proof of the canonical chain. This guide will explain the methods the ICheckpointManager interface provides and how to use them. - -## Overview - -The `ICheckpointManager` interface is responsible for managing checkpoints in the system. It provides methods for submitting checkpoints, verifying event membership by block number or epoch, and retrieving checkpoint information. - -## Submit a checkpoint - -To submit a checkpoint, call the submit method: - -```solidity -function submit( - CheckpointMetadata calldata checkpointMetadata, - Checkpoint calldata checkpoint, - uint256[2] calldata signature, - Validator[] calldata newValidatorSet, - bytes calldata bitmap -) external; -``` - -The parameters for submitting a checkpoint include the following: - -- The checkpoint metadata. -- The checkpoint itself. -- The aggregated signature. -- The new validator set. -- A bitmap of the old validator set that signed the message. -- The contract will verify the provided signature against the stored validator set. - -## Get event membership by block number - -To check if an event is part of the event root for a given block number, call the getEventMembershipByBlockNumber method: - -```solidity -function getEventMembershipByBlockNumber( - uint256 blockNumber, - bytes32 leaf, - uint256 leafIndex, - bytes32[] calldata proof -) external view returns (bool); -``` - -This method takes the block number, the leaf of the event (keccak256-encoded log), the leaf index in the Merkle root tree, and the proof for leaf membership in the event root tree. It returns true if the event is part of the event root. - -## Get event membership by epoch - -To check if an event is part of the event root for a given epoch, call the getEventMembershipByEpoch method: - -```solidity -function getEventMembershipByEpoch( - uint256 epoch, - bytes32 leaf, - uint256 leafIndex, - bytes32[] calldata proof -) external view returns (bool); -``` - -This method takes the epoch ID, the leaf of the event (keccak256-encoded log), the leaf index in the Merkle root tree, and the proof for leaf membership in the event root tree. It returns true if the event is part of the event root. - -## Get checkpoint block number - -To get the checkpoint block number for a given block number, call the getCheckpointBlock method: - -```solidity -function getCheckpointBlock(uint256 blockNumber) external view returns (bool, uint256); -``` - -This method takes the block number and returns a boolean indicating if the block number was checkpointed, as well as the checkpoint block number. - -## Get event root by block - -To get the event root for a given block number, call the getEventRootByBlock method: - -```solidity -function getEventRootByBlock(uint256 blockNumber) external view returns (bytes32); -``` diff --git a/docs/docs/interfaces/network/exit-helper.md b/docs/docs/interfaces/network/exit-helper.md deleted file mode 100644 index 02244ba..0000000 --- a/docs/docs/interfaces/network/exit-helper.md +++ /dev/null @@ -1,59 +0,0 @@ -The `IExitHelper` interface is a helper contract that processes exits from stored event roots in `CheckpointManager`. It allows users to perform an exit for one or multiple events. This user guide will explain how to interact with the functions provided by the IExitHelper interface. - -## Functions - -### exit() - -This function allows you to perform an exit for one event. - -#### Parameters - -- `blockNumber` (uint256): The block number of the exit event on L2. -- `leafIndex` (uint256): The leaf index in the exit event Merkle tree. -- `unhashedLeaf` (bytes): The ABI-encoded exit event leaf. -- `proof` (bytes32[]): The proof of the event inclusion in the tree. - -#### Usage - -To exit an event, call the `exit()` function with the required parameters: - -```solidity -IExitHelper.exitHelperInstance.exit(blockNumber, leafIndex, unhashedLeaf, proof); -``` - -### batchExit() - -This function allows you to perform a batch exit for multiple events. - -#### Parameters - -- `inputs` (BatchExitInput[]): An array of BatchExitInput structs, where each struct contains the following fields: - - `blockNumber` (uint256): The block number of the exit event on L2. - - `leafIndex` (uint256): The leaf index in the exit event Merkle tree. - - `unhashedLeaf` (bytes): The ABI-encoded exit event leaf. - - `proof` (bytes32[]): The proof of the event inclusion in the tree. - -#### Usage - -To perform a batch exit for multiple events, create an array of `BatchExitInput` structs and call the `batchExit()` function: - -```solidity -let batchExitInputs = [ - { - blockNumber: blockNumber1, - leafIndex: leafIndex1, - unhashedLeaf: unhashedLeaf1, - proof: proof1 - }, - { - blockNumber: blockNumber2, - leafIndex: leafIndex2, - unhashedLeaf: unhashedLeaf2, - proof: proof2 - } -]; - -IExitHelper.exitHelperInstance.batchExit(batchExitInputs); -``` - -This will process exits for multiple events in a single transaction, which can save gas and improve efficiency. diff --git a/docs/docs/interfaces/network/state-receiver.md b/docs/docs/interfaces/network/state-receiver.md deleted file mode 100644 index 1bd3d2d..0000000 --- a/docs/docs/interfaces/network/state-receiver.md +++ /dev/null @@ -1,30 +0,0 @@ -The `IStateReceiver` interface is designed to handle state updates received from a higher-level entity, typically on the L2 side of the childchain. This user guide will explain how to interact with the functions provided by the `IStateReceiver` interface. - -## Functions - -### onStateReceive() - -This function is called when the contract receives a state update. It processes the incoming state, allowing the contract to react to changes in the higher-level state. - -#### Parameters - -- `counter` (uint256): A counter value associated with the state update. -- `sender` (address): The entity's address sending the state update. -- `data` (bytes): The calldata associated with the state update. - -#### Usage - -To handle a state update in your contract, you must implement the onStateReceive() function. The higher-level entity will call this function when a state update is sent. - -For example, you might implement onStateReceive() as follows: - -```solidity -contract MyStateReceiver is IStateReceiver { - function onStateReceive(uint256 counter, address sender, bytes calldata data) external override { - // Process the incoming state update - // ... - } -} -``` - -This function allows your contract to react to state updates, enabling communication between your contract and higher-level state providers. By implementing the `IStateReceiver` interface, you can ensure that your contract stays current with broader ecosystem changes. diff --git a/docs/docs/interfaces/network/state-sender.md b/docs/docs/interfaces/network/state-sender.md deleted file mode 100644 index b20de65..0000000 --- a/docs/docs/interfaces/network/state-sender.md +++ /dev/null @@ -1,29 +0,0 @@ -The `IStateSender` interface provides a way to send state updates from one contract to another, often between different layers of a network, such as L1 and L2. This user guide will help you understand how to interact with the functions provided by the `IStateSender` interface. - -## Functions - -### syncState() - -This function sends a state update to a specified contract, allowing the receiving contract to process the changes in the state. - -#### Parameters - -- `receiver` (address): The contract address will receive the state update. -- `data` (bytes): The calldata associated with the state update to be sent. - -#### Usage - -You'll need to call the syncState() function to send a state update from your contract. This function will send the state update to the specified receiver contract. - -For example, you might use the `syncState()` function as follows: - -```solidity -contract MyStateSender is IStateSender { - function sendStateUpdate(address receiver, bytes calldata data) public { - // Send the state update to the specified receiver contract - syncState(receiver, data); - } -} -``` - -This function enables your contract to communicate state updates to other contracts, facilitating cross-contract and cross-layer communication. By implementing the IStateSender interface, you can ensure your contract can send state updates to other parts of the ecosystem. diff --git a/docs/docs/interfaces/staking/custom-supernet-manager.md b/docs/docs/interfaces/staking/custom-supernet-manager.md deleted file mode 100644 index 747c8c6..0000000 --- a/docs/docs/interfaces/staking/custom-supernet-manager.md +++ /dev/null @@ -1,147 +0,0 @@ -The `CustomSupernetManager` contract manages validator access and syncs voting power between the stake manager and the validator set on the child chain. It implements the base `SupernetManager` contract. - -## Events - -### AddedToWhitelist() - -```solidity -event AddedToWhitelist(address indexed validator); -``` - -This event is emitted when a validator is added to the whitelist of validators allowed to stake. - -### RemovedFromWhitelist() - -```solidity -event RemovedFromWhitelist(address indexed validator); -``` - -This event is emitted when a validator is removed from the whitelist of validators allowed to stake. - -### ValidatorRegistered() - -```solidity -event ValidatorRegistered(address indexed validator, uint256[4] blsKey); -``` - -This event is emitted when a validator is registered with their public key. - -### ValidatorDeactivated() - -```solidity -event ValidatorDeactivated(address validator); -``` - -This event is emitted when a validator is deactivated. - -### GenesisFinalized() - -```solidity -event GenesisFinalized(uint256 amountValidators); -``` - -This event is emitted when the initial genesis validator set is finalized. - -### StakingEnabled() - -```solidity -event StakingEnabled(); -``` - -This event is emitted when staking is enabled after the successful initialization of the child chain. - -## Functions - -### whitelistValidators() - -```solidity -function whitelistValidators(address[] calldata validators_) external; -``` - -This function allows whitelisting validators that are allowed to stake. It can only be called by the owner of the contract. - -### Parameters: - -`validators_`: An array of addresses representing the validators to be whitelisted. - -### register() - -```solidity -function register(uint256[2] calldata signature, uint256[4] calldata pubkey) external; -``` - -This function is called to register the public key of a validator. It validates the signature and registers the validator with their public key. - -#### Parameters: - -- `signature`: An array of two 256-bit integers representing the signature. -- `pubkey`: An array of four 256-bit integers representing the public key of the validator. - -### finalizeGenesis() - -```solidity -function finalizeGenesis() external; -``` - -This function is called to finalize the initial genesis validator set. It can only be called by the owner of the contract. - -### enableStaking() - -```solidity - function enableStaking() external; -``` - -This function is called to enable staking after the successful initialization of the child chain. It can only be called by the owner of the contract. - -### withdrawSlashedStake() - -```solidity -function withdrawSlashedStake(address to) external; -``` - -This function is called to withdraw slashed MATIC of slashed validators. It can only be called by the owner of the contract. - -#### Parameters: - -`to`: The address where the slashed stake will be withdrawn. - -### onL2StateReceive() - -```solidity -function onL2StateReceive(uint256 /*id*/, address sender, bytes calldata data) external; -``` - -This function is called by the exit helpers to either release the stake of a validator or slash it. It can only be called after the genesis and must be synced from the child chain. - -#### Parameters: - -- `sender`: The address of the sender calling the function. -- `data`: The data containing the information about the stake release or slash. - -### genesisSet() - -```solidity -function genesisSet() external view returns (GenesisValidator[] memory); -``` - -This function returns the initial genesis validator set with their balances. - -#### Returns: - -`GenesisValidator[]`: An array of GenesisValidator structs representing the initial genesis validator set. - -### getValidator() - -```solidity -function getValidator(address validator_) external view returns (Validator memory); -``` - -This function returns the Validator instance based on the provided validator address. - -#### Parameters: - -`validator_`: The address of the validator. - -#### Returns: - -`Validator`: The Validator struct representing the validator instance. diff --git a/docs/docs/interfaces/staking/stake-manager.md b/docs/docs/interfaces/staking/stake-manager.md deleted file mode 100644 index ff4e1e4..0000000 --- a/docs/docs/interfaces/staking/stake-manager.md +++ /dev/null @@ -1,218 +0,0 @@ -The `StakeManager` interface manages stakes for all childchains in the Edge architecture. - -## Events - -### ChildManagerRegistered() - -```solidity -event ChildManagerRegistered(uint256 indexed id, address indexed manager); -``` - -This event is emitted when a new child chain manager is registered with the StakeManager contract. It includes the ID of the child chain and the address of the manager contract. - -### StakeAdded() - -```solidity -event StakeAdded(uint256 indexed id, address indexed validator, uint256 amount); -``` - -This event is emitted when a validator adds stake for a child chain. It includes the ID of the child chain, the address of the validator, and the amount of stake added. - -### StakeRemoved() - -```solidity -event StakeRemoved(uint256 indexed id, address indexed validator, uint256 amount); -``` - -This event is emitted when a validator's stake is removed for a child chain. It includes the ID of the child chain, the address of the validator, and the amount of stake removed. - -### StakeWithdrawn() - -```solidity -event StakeWithdrawn(address indexed validator, address indexed recipient, uint256 amount); -``` - -This event is emitted when a validator withdraws their released stake. It includes the address of the validator, the address of the recipient, and the amount of stake withdrawn. - -### ValidatorSlashed() - -```solidity -event ValidatorSlashed(uint256 indexed id, address indexed validator, uint256 amount); -``` - -This event is emitted when a validator's stake is slashed for a child chain. It includes the ID of the child chain, the address of the validator, and the amount of stake slashed. - -## Functions - -### registerChildChain() - -```solidity -function registerChildChain(address manager) external returns (uint256 id); -``` - -This function is called to register a new child chain with the StakeManager contract. It associates the child chain with its manager contract. - -#### Parameters: - -`manager`: The address of the manager contract for the child chain. - -### stakeFor() - -```solidity -function releaseStakeOf(address validator, uint256 amount) external; -``` - -This function is called by a validator to stake for a child chain. It adds the specified amount of stake for the given child chain. - -#### Parameters: - -- `id`: The ID of the child chain. -- `amount`: The amount of stake to be added. - -### releaseStakeOf() - -```solidity -function releaseStakeOf(address validator, uint256 amount) external; -``` - -This function is called by the child manager contract to release a validator's stake. It releases the specified amount of stake for the given validator. - -#### Parameters: - -- `validator`: The address of the validator. -- `amount`: The amount of stake to be released. - -### withdrawStake() - -```solidity -function withdrawStake(address to, uint256 amount) external; -``` - -This function allows a validator to withdraw their released stake. It transfers the specified amount of released stake to the specified recipient address. - -#### Parameters: - -- `to`: The address where the withdrawn stake will be sent. -- `amount`: The amount of released stake to be withdrawn. - -### slashStakeOf() - -```solidity -function slashStakeOf(address validator, uint256 amount) external; -``` - -This function is called by the child manager contract to slash a validator's stake. It slashes the specified amount of stake for the given validator, and the manager contract collects the slashed amount. - -#### Parameters: - -- `validator`: The address of the validator. -- `amount`: The amount of stake to be slashed. - -### withdrawableStake() - -```solidity -function withdrawableStake(address validator) external view returns (uint256 amount); -``` - -This function returns the amount of stake that a validator can withdraw. It represents the released stake that is available for withdrawal. - -#### Parameters: - -`validator`: The address of the validator. - -#### Returns: - -`amount`: The amount of stake that the validator can withdraw. - -### totalStake() - -```solidity -function totalStake() external view returns (uint256 amount); -``` - -This function returns the total amount of stake staked for all child chains. - -#### Returns: - -`amount`: The total amount of stake staked for all child chains. - -### totalStakeOfChild() - -```solidity -function totalStakeOfChild(uint256 id) external view returns (uint256 amount); -``` - -This function returns the total amount of stake staked for a specific child chain. - -#### Parameters: - -`id`: The ID of the child chain. - -#### Returns: - -`amount`: The total amount of stake staked for the specified child chain. - -### totalStakeOf() - -```solidity -function totalStakeOf(address validator) external view returns (uint256 amount); -``` - -This function returns the total amount of stake staked by a validator for all child chains. - -#### Parameters: - -`validator`: The address of the validator. - -#### Returns: - -`amount`: The total amount of stake staked by the specified validator. - -### stakeOf() - -```solidity -function stakeOf(address validator, uint256 id) external view returns (uint256 amount); -``` - -This function returns the amount of stake staked by a validator for a specific child chain. - -#### Parameters: - -- `validator`: The address of the validator. -- `id`: The ID of the child chain. - -#### Returns: - -`amount`: The amount of stake staked by the specified validator for the specified child chain. - -### managerOf() - -```solidity -function managerOf(uint256 id) external view returns (ISupernetManager manager); -``` - -This function returns the child chain manager contract for a specific child chain. - -#### Parameters: - -`id`: The ID of the child chain. - -#### Returns: - -`manager`: The address of the child chain manager contract. - -### idFor() - -```solidity -function idFor(address manager) external view returns (uint256 id); -``` - -This function returns the child chain ID associated with a specific child chain manager contract. - -#### Parameters: - -`manager`: The address of the child chain manager contract. - -#### Returns: - -`id`: The ID of the child chain associated with the specified manager contract. diff --git a/docs/docs/interfaces/staking/supernet-manager.md b/docs/docs/interfaces/staking/supernet-manager.md deleted file mode 100644 index 04aa3bf..0000000 --- a/docs/docs/interfaces/staking/supernet-manager.md +++ /dev/null @@ -1,28 +0,0 @@ -The `SupernetManager` contract is an abstract contract for managing Edge-powered chains. It serves as a base contract that should be implemented with custom desired functionality. - -## Functions - -### onInit() - -```solidity -function onInit(uint256 id) external; -``` - -This function is called when a new childchain is registered. It allows the implementing contract to perform initialization logic when a new child chain is added to the Edge-powered chain. - -#### Parameters: - -`id`: The ID of the newly registered child chain. - -### onStake() - -```solidity -function onStake(address validator, uint256 amount) external; -``` - -This function is called when a validator stakes. It allows the implementing contract to perform additional logic when a validator stakes for a child chain in the Edge-powered chain. - -### Parameters: - -- `validator`: The address of the validator who stakes. -- `amount`: The amount of stake being staked by the validator. diff --git a/docs/docs/interfaces/validators/validator-set-base.md b/docs/docs/interfaces/validators/validator-set-base.md deleted file mode 100644 index eb31531..0000000 --- a/docs/docs/interfaces/validators/validator-set-base.md +++ /dev/null @@ -1,68 +0,0 @@ -The `IChildValidatorSetBase` interface is part of the childchain. It handles validator registration, stake storage, and reward distribution. This user guide will explain the key components and functions of the interface. - -## Structs - -### InitStruct - -InitStruct is used during the initialization of the contract. - -- `epochReward` (uint256): The reward per epoch. -- `minStake` (uint256): The minimum amount a validator must stake. -- `minDelegation` (uint256): The minimum amount for delegating MATIC tokens. -- `epochSize` (uint256): The size of an epoch. - -### ValidatorInit - -ValidatorInit is used when initializing a validator. - -- `addr` (address): The validator's address. -- `pubkey` (uint256[4]): The validator's public BLS key. -- `signature` (uint256[2]): The validator's signature. -- `stake` (uint256): The amount staked by the validator. - -### DoubleSignerSlashingInput - -DoubleSignerSlashingInput represents the information about double signers to be slashed along with signatures and bitmap. - -- `epochId` (uint256): The ID of the epoch. -- `eventRoot` (bytes32): The event root. -- `currentValidatorSetHash` (bytes32): The current validator set hash. -- `nextValidatorSetHash` (bytes32): The next validator set hash. -- `blockHash` (bytes32): The block hash. -- `bitmap` (bytes): The bitmap. -- `signature` (bytes): The signature. - -## Functions - -### commitEpoch - -Commits an epoch to the contract. Called by the Edge client. - -- `id` (uint256): The ID of the epoch to be committed. -- `epoch` (Epoch): The epoch data to be committed. -- `uptime` (Uptime): The uptime data for the epoch being committed. - -### commitEpochWithDoubleSignerSlashing - -Commits an epoch and slashes double signers. Called by the Edge client. - -- `curEpochId` (uint256): The ID of the epoch to be committed. -- `blockNumber` (uint256): The block number at which the double signer occurred. -- `pbftRound` (uint256): The round number at which the double signing occurred. -- `epoch` (Epoch): The epoch data to be committed. -- `uptime` (Uptime): The uptime data for the epoch being committed. -- `inputs` (DoubleSignerSlashingInput[]): Information about double signers to be slashed along with signatures and bitmap. - -### getCurrentValidatorSet - -Returns the addresses of active validators in the current epoch, sorted by total stake (self-stake + delegation). - -### getEpochByBlock - -Looks up an epoch by block number in O(log n) time. - -- `blockNumber` (uint256): The block number. - -### totalActiveStake - -Calculates the total stake of active validators (self-stake + delegation). diff --git a/docs/docs/operate/benchmarks.md b/docs/docs/operate/benchmarks.md deleted file mode 100644 index c5fa617..0000000 --- a/docs/docs/operate/benchmarks.md +++ /dev/null @@ -1,108 +0,0 @@ -This document presents a summary of performance benchmarks for Edge production releases. - -## Summary of Test Results - -### v1.0.0-rc - -| Transaction Type | TPS Sent | TPS Mined | Gas per Second | Gas per Transaction | Instance Type(s) | -|------------------|----------|-----------|----------------|---------------------|------------------------------| -| EOA to EOA | 2,600 | 2,442 | 51,282,000 | 21,000 | x2iezn.2xlarge | -| ERC20 | 1,300 | 591 | 21,696,201 | 36,711 | x2iezn.2xlarge | -| ERC721 | 800 | 558 | 32,642,442 | 58,499 | x2iezn.2xlarge | - -### v1.0.0 - -| Transaction Type | TPS Sent | TPS Mined | Gas per Second | Gas per Transaction | Instance Type(s) | -|------------------|----------|-----------|----------------|---------------------|------------------------------| -| EOA to EOA | 2,475 | 2,459 | 51,639,000 | 21,000 | x2iezn.2xlarge | -| ERC20 | 550 | 680 | 24,963,480 | 36,711 | x2iezn.2xlarge | -| ERC721 | 550 | 649 | 37,965,851 | 58,499 | x2iezn.2xlarge | - -### v1.1.0 - -| Transaction Type | TPS Sent | TPS Mined | Gas per Second | Gas per Transaction | Instance Type(s) | -|------------------|----------|-----------|----------------|---------------------|------------------------------| -| EOA to EOA | 2,475 | 2,396 | 50,316,000 | 21,000 | x2iezn.2xlarge | -| ERC20 | 550 | 653 | 23,972,283 | 36,711 | x2iezn.2xlarge | -| ERC721 | 550 | 621 | 36,327,879 | 58,499 | x2iezn.2xlarge | - -### v1.3.0 - -| Transaction Type | TPS Sent | TPS Mined | Gas per Second | Gas per Transaction | Instance Type(s) | -|------------------|----------|-----------|----------------|---------------------|------------------------------| -| EOA to EOA | 3,000 | 2,577 | 54,117,000 | 21,000 | x2iezn.2xlarge | -| ERC20 | 820 | 813 | 23,005,250 | 28,297 | x2iezn.2xlarge | -| ERC721 | 750 | 746 | 37,393,367 | 50,125 | x2iezn.2xlarge | - -## Test Environment - -The performance tests were conducted in a controlled environment to ensure accuracy and consistency in the results. The environment setup includes the following components: - -### Network Configuration - -- Network: XGRChain -- Consensus Algorithm: PolyBFT - -### Instance Types - -The tests utilized various Amazon Web Services (AWS) instance types to evaluate the impact of varying compute resources on network performance: - -- **t2.xlarge** -- **t2.micro** -- **c5.2xlarge** -- **c6a.48xlarge** -- **x2iezn.2xlarge** -- **c6a.xlarge** - -
-General instance specifications - -- **t2.xlarge** - - vCPU: 4 - - Memory: 16 GiB - - Network Performance: Up to 5 Gigabit - - EBS-Optimized: Up to 2,750 Mbps -- **t2.micro** - - vCPU: 1 - - Memory: 1 GiB - - Network Performance: Low to Moderate - - EBS-Optimized: Not available -- **c5.2xlarge** - - vCPU: 8 - - Memory: 16 GiB - - Network Performance: Up to 10 Gigabit - - EBS-Optimized: Up to 3,500 Mbps -- **c6a.48xlarge** - - vCPU: 192 - - Memory: 768 GiB - - Network Performance: 50 Gigabit - - EBS-Optimized: 14,000 Mbps -- **x2iezn.2xlarge** - - vCPU: 8 - - Memory: 64 GiB - - Network Performance: Up to 25 Gigabit - - EBS-Optimized: Up to 3,500 Mbps -- **c6a.xlarge** - - vCPU: 4 - - Memory: 16 GiB - - Network Performance: Up to 10 Gigabit - - EBS-Optimized: Up to 4,750 Mbps - -
- -### Transaction Types - -The tests were performed using three different types of transactions to assess the network's capability to handle various use cases: - -- **EOA to EOA**: Representing simple value transfers between user accounts. -- **ERC20**: Token transfers, simulating the exchange of tokens on the network. -- **ERC721**: Non-fungible token (NFT) transfers representing the exchange of unique digital assets. - -### Performance Metrics - -The following key performance metrics were considered during the tests: - -- **Transactions per second (TPS) sent**: The number of transactions submitted to the network per second. -- **Transactions per second (TPS) mined**: The number of transactions successfully processed and included in the blockchain per second. -- **Gas per transaction**: The amount of gas consumed by each transaction, representing the computational cost. -- **Gas per second**: The total amount consumed per second indicates the network's overall computational capacity. diff --git a/docs/docs/operate/deploy/access-control/allowlist-general.md b/docs/docs/operate/deploy/access-control/allowlist-general.md deleted file mode 100644 index b1396f9..0000000 --- a/docs/docs/operate/deploy/access-control/allowlist-general.md +++ /dev/null @@ -1,216 +0,0 @@ - -## Understanding ACL and Address Roles - -ACLs or Access Control Lists are a way of managing permissions in your Edge-powered chain. In this context, an ACL is essentially a list of addresses and their corresponding roles. - -:::info Keep in mind - -- **Enabling Lists**: Allowlists and blocklists are enabled or disabled exclusively during network initialization through the genesis command. Changes to the configuration cannot be made dynamically. -- **Admin Role**: To enable a list, an admin role must be set in the genesis command. The admin manages the list and can only be specified during the network's initial setup. -- **Exclusive Enablement**: It is not valid to enable both allowlists and blocklists for a given list type. If both lists are set, the allowlist takes precedence, and the blocklist is ignored. -- **System Transaction Address**: The system transaction address (0xffffFFFfFFffffffffffffffFfFFFfffFFFfFFfE) is excluded from allowlist and blocklist validation. It is always allowed to perform actions and is not subject to list checks. -- **Impact on Validators and System Transactions**: The impact of allowlists and blocklists on validators and system transactions can vary depending on network implementation. - -::: - -## ABI Specification - -### Overview - -Below is an overview of the ABI for the ACL in Edge: - -```shell -function setAdmin(address) -function setEnabled(address) -function setNone(address) -function readAddressList(address) returns (uint256) -``` - -### Functions - -**Roles can be one of three types:** - -- `NoRole`: The address has no permissions. -- `EnabledRole`: The address has some permissions. -- `AdminRole`: The address has all permissions and can change the roles of other addresses. - -**For more information about how ACLs work in Edge, check out the overview guide [here](../../../design/runtime/allowlist.md).** - -```go -NoRole Role = Role(types.StringToHash("...")) -EnabledRole Role = Role(types.StringToHash("...")) -AdminRole Role = Role(types.StringToHash("...")) -``` - -- **Function Signatures**: The module provides functions to set or query roles: - - Set an address as an admin. - - Enable an address. - - Remove any role from an address. - - Read the role of an address. - -```go -SetAdminFunc = abi.MustNewMethod("function setAdmin(address)") -SetEnabledFunc = abi.MustNewMethod("function setEnabled(address)") -SetNoneFunc = abi.MustNewMethod("function setNone(address)") -ReadAddressListFunc = abi.MustNewMethod("function readAddressList(address) returns (uint256)") -``` - -### Key Functionalities - -- **Creating an AddressList**: An instance of the AddressList is created with a reference to the state and the contract's address. - -```go -func NewAddressList(state stateRef, addr types.Address) *AddressList {...} -``` - -- **Running the Contract**: The `Run` function decodes the input to determine the function being called and executes it. - -```go -func (a *AddressList) Run(c *runtime.Contract, host runtime.Host, _ *chain.ForksInTime) *runtime.ExecutionResult {...} -``` - -- **Setting and Getting Roles**: The module provides functions to assign a role to an address and to fetch the role of a given address. - -```go -func (a *AddressList) SetRole(addr types.Address, role Role) {...} -func (a *AddressList) GetRole(addr types.Address) Role {...} -``` - -### How It Works - -1. A call to the `AddressList` triggers the `Run` function. -2. The function decodes the input to identify the function being called. -3. If querying a role, the role of the provided address is returned. -4. For modifying roles, checks are in place to ensure: - - The caller has enough gas. - - The call isn't static (read-only). - - Only admins can modify roles. - - Admins can't remove their own admin role. - -## Interacting with an ACL - -Edge ACLs are implemented as precompiles, which are built-in contracts within the Edge client. You can interact with these ACL precompiles using libraries like ether.js and web3.js. - -To interact with the ACL precompiles using an external library or client, follow these steps: - -1. Obtain the ABI (Application Binary Interface) for the specific ACL precompile you want to interact with. The ABI contains the definitions of the precompile's functions, including their parameters and return types. - -2. Create a contract instance for the ACL precompile using the ABI and the provider connected to the Edge-powered chain. - -3. Use the contract instance to call the functions defined in the precompile's ABI. These functions allow you to manage the ACL by adding or removing accounts, modifying roles, or performing other ACL-related operations. - -## Example Interaction with ethers.js - -### Prerequisites - -- Install ethers.js in your project using npm or yarn: `npm i --save ethers`. -- Ensure you have a wallet and some gas for transaction fees. -- Obtain the address and ABI of the ACL smart contract you want to interact with. - -:::note - -- These operations should be performed by an account with the `AdminRole`. -- Make sure to replace the placeholders with your actual values. -- The await keyword must be used in an async function. -- Be mindful of transaction fees (gas costs) when interacting with the network. - -::: - -### Sample Workflow - -Create a contract instance for the ACL precompile using the ABI and the provider connected to the network. -Please note that these examples are provided as guidance and assume the usage of ether.js, with Alice and Bob used as placeholders for specific agents. - -```javascript -const ethers = require('ethers'); - -// Connect to the provider (e.g., local node, Infura, Alchemy, etc.) -const provider = new ethers.providers.JsonRpcProvider('https://rpc-endpoint.io'); - -const ACLInterface = [{...}]; // Replace with the ABI of the Access List precompile - -// Contract Deployer Allow List -const contractDeployerAlowListAddress = '0xContractDeployerAllowListAddress'; -const contractDeployerAllowList = new ethers.Contract(contractDeployerAddress, ACLInterface, provider); - -// Transactions Allow List -const transactionsAllowListAddress = '0xTransactionsAllowListAddress'; -const transactionsAllowList = new ethers.Contract(transactionsAllowListAddress, ACLInterface, provider); - -// Transactions Block List -const transactionsBlockListAddress = '0xTransactionsBlockListAddress'; -const transactionsBlockList = new ethers.Contract(transactionsBlockListAddress, ACLInterface, provider); - -// Bridge Allow List -const bridgeAllowListAddress = '0xBridgeAllowListAddress'; -const bridgeAllowList = new ethers.Contract(bridgeAllowListAddress, ACLInterface, provider); - -// Bridge Block List -const bridgeBlockListAddress = '0xBridgeBlockListAddress'; -const bridgeBlockList = new ethers.Contract(bridgeBlockListAddress, ACLInterface, provider); -``` - -#### Interact with the ContractDeployer ACL - -```javascript -// Example interaction with the Contract Deployer ACL - -const addrAlice = '0xAliceAddress'; // Replace with Alice's address -const addrBob = '0xBobAddress'; // Replace with Bob's address - -// Add Alice's address to the contract deployer allowlist -const allowlistContractDeployerTx1 = contractDeployerAllowList.setEnabled(addrAlice); -allowlistContractDeployerTx1.wait(); - -// Remove Alice's address from the contract deployer allowlist -const allowlistContractDeployerTx2 = contractDeployerAllowList.setNone(addrAlice); -allowlistContractDeployerTx2.wait(); - -// Add Bob's address to the contract deployer allowlist -const allowlistContractDeployerTx3 = contractDeployerAllowList.setEnabled(addrBob); -allowlistContractDeployerTx3.wait(); - -// Remove Bob's address from the contract deployer allowlist -const allowlistContractDeployerTx4 = contractDeployerAllowList.setNone(addrBob); -allowlistContractDeployerTx4.wait(); -``` - -#### Interact with Transactions ACL - -```javascript -// Add Bob's address to the transaction allowlist -const allowlistTxTx1 = transactionsAllowList.setEnabled(addrBob); -allowlistTxTx1.wait(); - -// Remove Bob's address from the transaction allowlist -const allowlistTxTx2 = transactionsAllowList.setNone(addrBob); -allowlistTxTx2.wait(); - -// Add Alice's address to the transaction blocklist -const blocklistTxTx1 = transactionsBlockList.setEnabled(addrAlice); -blocklistTxTx1.wait(); - -// Remove Alice's address from the transaction blocklist -const blocklistTxTx2 = transactionsBlockList.setNone(addrAlice); -blocklistTxTx2.wait(); -``` - -#### Interact with the Bridge ACL - -```javascript -// Add Alice's address to the bridge allowlist -const allowlistBridgeTx1 = bridgeAllowList.setEnabled(addrAlice); -allowlistBridgeTx1.wait(); - -// Remove Alice's address from the bridge allowlist -const allowlistBridgeTx2 = bridgeAllowList.setNone(addrAlice); -allowlistBridgeTx2.wait(); - -// Add Alice's address to the bridge blocklist -const blocklistBridgeTx1 = bridgeBlockList.setEnabled(addrAlice); -blocklistBridgeTx1.wait(); - -// Remove Alice's address from the bridge blocklist -const blocklistBridgeTx2 = bridgeBlockList.setNone(addrAlice); -blocklistBridgeTx2.wait(); -``` diff --git a/docs/docs/operate/deploy/genesis-validators.md b/docs/docs/operate/deploy/genesis-validators.md deleted file mode 100644 index 227837b..0000000 --- a/docs/docs/operate/deploy/genesis-validators.md +++ /dev/null @@ -1,138 +0,0 @@ -In this section, we'll look at how to configure the initial rootchain validator set through allowlisting and by staking. - -## 1. Allowlist validators on the rootchain - -The `CustomSupernetManager` contract on the rootchain is responsible for managing the PolyBFT network. - -Before validators can be registered on the `CustomSupernetManager` contract on the rootchain, they need to be allowlisted by the deployer of the `CustomSupernetManager` contract. Validators can register themselves, or a registrator can register them on their behalf. Once registered, validators can stake and start validating transactions. - -This can be done using the `xgrchain polybft whitelist-validators` command. The deployer can specify the hex-encoded private key of the `CustomSupernetManager` contract deployer or use the `--data-dir` flag if they have initialized their secrets. - -
-Flags ↓ - -| Flag | Description | Example | -| -----------------| ------------------------------------------------------------------------------------------------| ------------------------------------------- | -| `--private-key` | Hex-encoded private key of the account that deploys the SupernetManager contract | `--private-key ` | -| `--addresses` | Comma-separated list of hex-encoded addresses of validators to be whitelisted | `--addresses 0x8a98f47a9820e3f3a6C16f44194F1d7eCCe3A110,0x8a98f47a9820e3f3a6C16f44194F1d7eCCe3A110` | -| --supernet-manager| Address of the SupernetManager contract on the rootchain | `--supernet-manager 0x3c6f8c6Fd90b2Bee1E78E2B2D1e7aB6cFf9Dc113` | -| `--data-dir` | Directory for the XGRChain data if the local FS is used | `--data-dir ./xgrchain/data` | -| `--jsonrpc` | JSON-RPC interface | `--jsonrpc 0.0.0.0:8545` | -| `--config` | Path to the SecretsManager config file. If omitted, the local FS secrets manager is used | `--config /path/to/config/file.yaml` | - -
- -In the following example command, we are using a placeholder private key for the `CustomSupernetManager` contract deployer. - -> If running the demo Geth instance, the test account private key has been hardcoded: `aa75e9a7d427efc732f8e4f1a5b7646adcc61fd5bae40f80d13c8419c9f43d6d`. - -The `--addresses` flag is a comma-separated list of the first two validators generated earlier. The `--supernet-manager` flag specifies the actual `CustomSupernetManager` contract address that was deployed. - -```bash -./xgrchain polybft whitelist-validators \ - --private-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --addresses 0x61324166B0202DB1E7502924326262274Fa4358F,0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570 \ - --supernet-manager 0x75aA024A2292A3FD3C17d67b54B3d00435437246 -``` - -## 2. Register validators on the rootchain - -Each validator needs to register themselves on the `CustomSupernetManager` contract. This is done using the `xgrchain polybft register-validator` command. **Note that this command is for testing purposes only.** - -
-Flags ↓ - -| Flag | Description | Example | -| -----------------------------| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | -| `--config` | Path to the SecretsManager config file. If omitted, the local FS secrets manager is used. | `--config /path/to/config/file.yaml` | -| `--data-dir` | The directory path where the new validator key is stored. | `--data-dir /path/to/validator1` | | -| `--jsonrpc` | The JSON-RPC interface. Default is `0.0.0.0:8545`. | `--jsonrpc 0.0.0.0:8545` | -| `--supernet-manager` | Address of the SupernetManager contract on the rootchain. | `--supernet-manager 0x75aA024A2292A3FD3C17d67b54B3d00435437246` | - -
- -```bash -./xgrchain polybft register-validator --data-dir ./test-chain-1 \ - --supernet-manager $(cat genesis.json | jq -r '.params.engine.polybft.bridge.customSupernetManagerAddr') -``` - -## 3. Initial staking on the rootchain - -Each validator needs to perform initial staking on the rootchain `StakeManager` contract. This is done using the `xgrchain polybft stake` command. **Note that this command is for testing purposes only.** - -
-Flags ↓ - -|| Flag | Description | Example | -| -----------------------------| --------------------------------------------------------------------------------- | ---------------------------------------- | -| `--amount ` | The amount to stake | `--amount 5000000000000000000` | -| `--supernet-id` | The ID of the supernet provided by stake manager on supernet registration | `--chain-id 100` | -| `--config ` | The path to the SecretsManager config file | `--config /path/to/config/file.yaml` | -| `--data-dir` | The directory for the XGRChain data | `--data-dir ./xgrchain/data` | -| `--jsonrpc` | The JSON-RPC interface | `--jsonrpc 0.0.0.0:8545` | -| `--stake-token ` | The address of ERC20 Token used for staking on rootchain | `--native-root-token 0x` | -| `--stake-manager` | The address of the stake manager contract | `--stake-manager 0x` | - -
- -In the following example command, we use the validator key and the rootchain `StakeManager` contract address that was generated earlier. We also set the staking amount to `1000000000000000000` which is equivalent to 1 token. The `--stake-token` flag is used to specify the address of the native token of the rootchain. - -:::info Staking requirement: wrapping a non-ERC-20 token - -Edge allow for the customization of the gas token and mandate the use of ERC-20 tokens for staking instead of the rootchain's native token. - -When performing rootchain staking on the Polygon PoS Mainnet, [WMATIC](https://polygonscan.com/token/0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270?a=0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45) (wrapped MATIC) is the required token. This is due to the ERC-20 standard requirement for staking, which MATIC doesn't meet. - -WMATIC is deployed at `0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270`. - -This principle also applies to the Mumbai Testnet, where wrapped test MATIC must be used instead of test MATIC. - -If you currently hold MATIC tokens, you can convert them to WMATIC through various methods. One common method is to use a decentralized exchange (DEX) like Uniswap, where you can swap your MATIC tokens for WMATIC. **Always ensure you're using a reputable platform for this conversion and double-check that the contract address for WMATIC is correct.** - -
-Obtaining native root token address - -For example, if you are using the Mumbai test network, you can obtain the address of the MATIC testnet token by sending a POST request to the Mumbai network's JSON-RPC endpoint: - -```bash -curl \ - -X POST \ - -H "Content-Type: application/json" \ - --data '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"","data":"0x06fdde03"},"latest"],"id":1}' -``` - -
- -::: - -```bash -./xgrchain polybft stake \ - --data-dir ./test-chain-1 \ - --supernet-id $(cat genesis.json | jq -r '.params.engine.polybft.supernetID') \ - --amount 1000000000000000000 \ - --stake-manager $(cat genesis.json | jq -r '.params.engine.polybft.bridge.stakeManagerAddr') \ - --stake-token $(cat genesis.json | jq -r '.params.engine.polybft.bridge.stakeTokenAddr') \ -``` - -## 4. Finalize validator set on the rootchain - -After all validators from the genesis block have performed initial staking on the rootchain, the final step required before starting the chain is to finalize the genesis validator set on the `SupernetManager` contract on the rootchain. This can be done using the `xgrchain polybft supernet` command. - -The deployer of the `SupernetManager` contract can specify their hex-encoded private key or use the `--data-dir` flag if they have initialized their secrets. If the `--enable-staking` flag is provided, validators will be able to continue staking on the rootchain. If not, genesis validators will not be able to update their stake or unstake, nor will newly registered validators after genesis be able to stake tokens on the rootchain. The enabling of staking can be done through this command or later after the Edge-powered chain starts. - -In the following example command, we use a placeholder hex-encoded private key of the `SupernetManager` contract deployer. The addresses of the `SupernetManager` and `StakeManager` contracts are the addresses that were generated earlier. We also use the `--finalize-genesis-set` and `--enable-staking` flags to enable staking and finalize the genesis state. - -```bash -./xgrchain polybft supernet - --private-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --genesis /path/to/genesis/file \ - --supernet-manager $(cat genesis.json | jq -r '.params.engine.polybft.bridge.customSupernetManagerAddr') \ - --stake-manager $(cat genesis.json | jq -r '.params.engine.polybft.bridge.stakeManagerAddr') \ - --finalize-genesis-set --enable-staking -``` - -## 5. Next Steps - -With all the necessary configurations in place for the Edge-powered chain, we are ready to proceed with starting the chain. - -Navigate to the [Start Your Chain](start-chain.md) deployment guide, which will provide you with instructions on how to initiate and launch the chain. diff --git a/docs/docs/operate/deploy/genesis.md b/docs/docs/operate/deploy/genesis.md deleted file mode 100644 index a4236b3..0000000 --- a/docs/docs/operate/deploy/genesis.md +++ /dev/null @@ -1,557 +0,0 @@ - -In this section, we'll walk through how to configure the initial childchain state by generating a new genesis file. - -## 1. Overview - -The genesis file is a critical component in setting up a blockchain network, containing the initial validator set, genesis block, and other essential parameters that define the network's behavior. The initial validator set is responsible for bootstrapping the consensus mechanism, allowing the blockchain to function and reach consensus on new blocks. - -Edge allow for customizable parameters such as the block gas limit, epoch size, and block rewards, which enable network operators to tailor the network to specific requirements. Additionally, Edge support allowlists and blocklists for transactions and validators, providing an extra layer of control and security to the network. These lists can be used to restrict or permit specific addresses, ensuring only authorized parties can participate in the network or execute transactions. - -To create the chain configuration, we use the `xgrchain genesis` command, which generates the genesis file. - -
-Common Flags ↓ - -| Flag | Description | Example | -|--------------------------------------------|-----------------------------------------------------------|--------------------------------------------------| -| `--block-gas-limit uint` | The maximum amount of gas used by all transactions in a block (default 5242880) | `--block-gas-limit 10000000` | -| `--block-time duration` | The predefined period which determines block creation frequency (default 2s) | `--block-time 5s` | -| `--block-time-drift uint` | Configuration for block time drift value (in seconds) (default 10) | | -| `--block-tracker-poll-interval duration` | Interval (number of seconds) at which block tracker polls for latest block at rootchain (default 1s) | | -| `--bootnode stringArray` | MultiAddr URL for p2p discovery bootstrap. This flag can be used multiple times | `--bootnode /ip4/127.0.0.1/tcp/30301/p2p/QmSomeNodeId` | -| `--burn-contract string` | The burn contract block and address (format: `:
[: destination]`) | `--burn-contract 100:0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--chain-id uint` | The ID of the chain (default 100) | `--chain-id 1234` | -| `--consensus string` | The consensus protocol to be used (default "polybft") | `--consensus ibft` | -| `--dir string` | The directory for the XGRChain genesis data (default "./genesis.json") | `--dir ./genesis_data` | -| `--epoch-reward uint` | Reward size for block sealing (default 1) | `--epoch-reward 1000000000000000000` | -| `--epoch-size uint` | The epoch size for the chain (default 100000) | `--epoch-size 100` | -| `--ibft-validator stringArray` | Addresses to be used as IBFT validators, can be used multiple times. Needs to be present if ibft-validators-prefix-path is omitted | `--ibft-validator 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--ibft-validator-type string` | The type of validators in IBFT (default "bls") | `--ibft-validator-type ecdsa` | -| `--ibft-validators-prefix-path string` | Prefix path for validator folder directory. Needs to be present if ibft-validator is omitted | `--ibft-validator-prefix-path ./validators` | -| `--max-validator-count uint` | The maximum number of validators in the validator set for PoS (default 9007199254740990) | `--max-validator-count 100` | -| `--min-validator-count uint` | The minimum number of validators in the validator set for PoS (default 1) | `--min-validator-count 4` | -| `--name string` | The name for the chain (default "xgrchain") | `--name "My XGRChain"` | -| `--native-token-config string` | Native token configuration, provided in the following format: | `--native-token-config "MyToken:MTK:18:true/false"` | -| `--pos` | The flag indicating that the client should use Proof of Stake IBFT. Defaults to Proof of Authority if flag is not provided or false | `--is-pos true` | -| `--premine stringArray` | The premined accounts and balances (format: `
[:]`). Default premined balance: 1000000000000000000000000 | `--premine 0x742d35Cc6634C0532925a3b844Bc454e4438f44e:1000000000000000000` | -| `--proxy-contracts-admin string` | Admin for proxy contracts | | -| `--reward-token-code string` | Hex encoded reward token byte code | `--reward-token-code 0x606060...` | -| `--reward-wallet string` | Configuration of reward wallet in format | `--reward-wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e:1000000000000000000` | -| `--sprint-size uint` | The number of block included into a sprint (default 5) | `--sprint-size 10` | -| `--trieroot string` | Trie root from the corresponding triedb | `--trie-root 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef` | -| `--validators stringArray` | Validators defined by user (format: `::`) | `--validators /ip4/127.0.0.1/tcp/30301/p2p/...` | -| `--validators-path string` | Root path containing polybft validators secrets (default "./") | `--validators-path ./validators` | -| `--validators-prefix string` | Folder prefix names for polybft validators secrets (default "test-chain-") | `--validators-prefix polybft-` | - -
- -:::caution Must enable ACLs before launching the network - -Keep in mind that allowlists must be enabled prior to launching the network. After the network is started, configuration of the allowlist will no longer be possible. The access control process will be initiated by the initial allowlisted addresses. - -::: - -
-Access Control List Flags ↓ - -Contract deployer: - -| Flag | Description | Example | -|--------------------------------------------|-----------------------------------------------------------|--------------------------------------------------| -| `--contract-deployer-allow-list-admin stringArray` | List of addresses to use as admin accounts in the contract deployer allow list | `--contract-deployer-allow-list-admin 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--contract-deployer-allow-list-enabled stringArray` | List of addresses to enable by default in the contract deployer allow list | `--contract-deployer-allow-list-enabled 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--contract-deployer-block-list-admin stringArray` | List of addresses to use as admin accounts in the contract deployer block list | `--contract-deployer-block-list-admin 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--contract-deployer-block-list-enabled stringArray` | List of addresses to enable by default in the contract deployer block list | `--contract-deployer-block-list-enabled 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | - -Transactions: - -| Flag | Description | Example | -|--------------------------------------------|-----------------------------------------------------------|--------------------------------------------------| -| `--transactions-allow-list-admin stringArray` | List of addresses to use as admin accounts in the transactions allow list | `--transactions-allow-list-admin 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--transactions-allow-list-enabled stringArray` | List of addresses to enable by default in the transactions allow list | `--transactions-allow-list-enabled 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--transactions-block-list-admin stringArray` | List of addresses to use as admin accounts in the transactions block list | `--transactions-block-list-admin 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--transactions-block-list-enabled stringArray` | List of addresses to enable by default in the transactions block list | `--transactions-block-list-enabled 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | - -Bridge: - -| Flag | Description | Example | -|--------------------------------------------|-----------------------------------------------------------|--------------------------------------------------| -| `--bridge-allow-list-admin stringArray` | List of addresses to use as admin accounts in the bridge allow list | `--bridge-allow-list-admin 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--bridge-allow-list-enabled stringArray` | List of addresses to enable by default in the bridge allow list | `--bridge-allow-list-enabled 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--bridge-block-list-admin stringArray` | List of addresses to use as admin accounts in the bridge block list | `--bridge-block-list-admin 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | -| `--bridge-block-list-enabled stringArray` | List of addresses to enable by default in the bridge block list | `--bridge-block-list-enabled 0x742d35Cc6634C0532925a3b844Bc454e4438f44e` | - -
- -:::note Base Fee Adjustments and Network Stability - -The `--base-fee-change-denom` parameter represents the value that bounds the amount the base fee can change between blocks. This ensures that the base fee doesn't fluctuate too wildly from one block to the next, providing stability and predictability in transaction costs for users. While dynamic adjustments to the base fee can help in managing network congestion, it's essential to strike a balance to maintain user trust and consistent transaction costs. - -::: - -:::note ACL gas cost considerations - -While the use of alternative ACL-enabled contracts, such as bridge ACLs, offers finer control over cross-chain interactions, these contracts also result in increased gas consumption for transactions. As you weigh the benefits of enhanced security, keep in mind that security measures can often come with higher costs. - -::: - -## 2. Deployment Considerations - -| Consideration | Description | Details | -| --- | --- | --- | -| **Difference between `chain-id` and `supernet-id`** | - `chain-id`: Unique identifier for a childchain.
- `supernet-id`: Identifier populated during registration with `StakeManager`. | Users can assign a custom `chain-id` via the genesis command. The `supernet-id` value is derived from the `rootchain deploy` command. | -| **Create a Native Token and Premine** | Configure the native token and premine specific accounts. | - `--premine`: Specify premined accounts and balances.
- `--native-token-config`: Configure the native token's details.
- `--owner` (Note): For mintable native tokens, designates permissions. | -| **Enable EIP1559** | Enable the London hard fork with specific configurations. | As of version 1.3.0, the `--genesis-base-fee` flag is not exposed. However, you can manually tweak `baseFee` and `baseFeeEM` in the `genesis.json` and restart the node for changes to take effect. | -| **Contract Upgradability via Proxy Contracts** | Use proxy contracts for flexible and controlled upgrades. | - **Genesis Initialization**: Use `--proxy-contracts-admin` to specify upgrade permissions.
- **Rootchain Deployment**: Uses `--proxy-contracts-admin` to define contract address while being able to upgrade logic.
- **Stake Manager Deployment**: Uses `--proxy-contracts-admin` to define proxy admin for Staking Manager contract. | - -## 3. Specify Validator Set & Generate Genesis - -There are two ways to specify the initial validator set: - -- **Single-Host Validator Setup**: All validator information is present in the local storage of a single host. In this case, you can provide the directory using the `--validators-path` flag and the validator folder prefix names using the `--validators-prefix` flag. To enable reward distribution, you must define a reward wallet address and its balance using the `--reward-wallet` flag. The wallet address is used to distribute reward tokens from that address to validators that signed blocks in that epoch. -- **Multi-Host Validator Setup**: Validator information is scattered across multiple hosts. In this case, you can supply the necessary information using the `--validators` flag. - - - - - - - - - - - -In the following example command, we will set the block gas limit to `10,000,000` and the epoch size to `10` using the `--block-gas-limit` and `--epoch-size` flags, respectively. - -We will also specify the consensus mechanism as PolyBFT using the `--consensus` flag. - -To enable reward distribution, we will define a reward wallet address and its balance using the `--reward-wallet` flag (for this example, we use the first validator as the reward wallet). - -In addition, we can provide the directory where the validator information is stored using the `--validators-path` flag and the prefix for the validator folder names using the `--validators-prefix` flag. - -We also add the `--transactions-allow-list-admin` flag to specify the admin addresses for the transactions allowlist, and the `--transactions-allow-list-enabled` flag to specify the addresses that will be enabled by default in the transactions allowlist, using the first and second validator nodes. - -**You can customize the initial chain state using the flags listed above.** - -```bash -./xgrchain genesis --block-gas-limit 10000000 --epoch-size 10 \ - --proxy-contracts-admin 0x61324166B0202DB1E7502924326262274Fa4358F \ - --validators-path ./ --validators-prefix test-chain- \ - --consensus polybft \ - --reward-wallet 0x61324166B0202DB1E7502924326262274Fa4358F:1000000 \ - --transactions-allow-list-admin 0x61324166B0202DB1E7502924326262274Fa4358F,0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570 \ - --transactions-allow-list-enabled 0x61324166B0202DB1E7502924326262274Fa4358F,0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570 \ - --premine 0x0:1000000000000000000000 -``` - -By customizing these flags, we can tailor the network to meet our specific requirements. Remember to consider the impact of these parameters carefully, as they can significantly affect the network's performance, security, and scalability. - -
-Genesis output example ↓ - -#### Output: - -```bash -[GENESIS VALIDATORS] -Address=0x61324166B0202DB1E7502924326262274Fa4358F; Balance=1000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8; BLS Key=06d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca; -Address=0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570; Balance=1000000000000000000000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX; BLS Key=0601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f; -Address=0x9aBb8441A12d4FD8D505C3fc50cDdc45E0df2b1e; Balance=1000000000000000000000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30303/p2p/16Uiu2HAmGskf5sZ514Ab4SHTPuw8RRBQudyrU211wn3P1knRz9Ed; BLS Key=17c26d9d91dddc3c1318b20a1ddb3322ea1f4e4415c27e9011d706e7407eed672837173d1909cbff6ccdfd110af3b18bdfea878e8120fdb5bae70dc7a044a2f40aa8f118b41704896f474f80fff52d9047fa8e4a464ac86f9d05a0220975d8440e20c6307d866137053cabd4baf6ba84bfa4a22f5f9297c1bfc2380c23535210; -Address=0xCaB5AAC79Bebe326e0c80d72b5662E73f5D8ea56; Balance=1000000000000000000000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30304/p2p/16Uiu2HAm42EFMhJPGcMRFHPaWWxBzoEsWRbGxJnBHMu4VFojg99U; BLS Key=1d7bb7d44a2f0ebeae2f4380f88188080de34635d78a36647f0704c7b70de7291e2e3b9a1ef699a078c6cd9bb816ea2917c2c2fc699c6248f1f7812a167caf7e15361ec16df56d194768d57c79897c681c96f4321651464f7b577d08083d8b67213a1e29dc8495d8389e6cbd85fdd738c402a1801198b57b302e0e00dfaf1247;[GENESIS SUCCESS] - -Genesis written to ./genesis.json -``` - -#### genesis.json: - -```json -{ - "name": "xgrchain", - "genesis": { - "nonce": "0x0000000000000000", - "timestamp": "0x0", - "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000f90305f90299f90294f8a39461324166b0202db1e7502924326262274fa4358fb88006d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca8ad3c21bcecceda100000001f8a394fe5e166ba5ea50c04fca00b07b59966e6c2e9570b8800601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f8ad3c21bcecceda100000001f8a3949abb8441a12d4fd8d505c3fc50cddc45e0df2b1eb88017c26d9d91dddc3c1318b20a1ddb3322ea1f4e4415c27e9011d706e7407eed672837173d1909cbff6ccdfd110af3b18bdfea878e8120fdb5bae70dc7a044a2f40aa8f118b41704896f474f80fff52d9047fa8e4a464ac86f9d05a0220975d8440e20c6307d866137053cabd4baf6ba84bfa4a22f5f9297c1bfc2380c235352108ad3c21bcecceda100000001f8a394cab5aac79bebe326e0c80d72b5662e73f5d8ea56b8801d7bb7d44a2f0ebeae2f4380f88188080de34635d78a36647f0704c7b70de7291e2e3b9a1ef699a078c6cd9bb816ea2917c2c2fc699c6248f1f7812a167caf7e15361ec16df56d194768d57c79897c681c96f4321651464f7b577d08083d8b67213a1e29dc8495d8389e6cbd85fdd738c402a1801198b57b302e0e00dfaf12478ad3c21bcecceda100000001c080c0c0f8658080a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000", - "gasLimit": "0x989680", - "difficulty": "0x0", - "mixHash": "0xadce6e5230abe012342a44e4e9b6d05997d6f015387ae0e59be924afc7ec70c1", - "coinbase": "0x0000000000000000000000000000000000000000", - "alloc": { - "0x0000000000000000000000000000000000000101": { - "code": "0x608060405234801561001057600080fd5b50600436106101b05760003560e01c806370a08231116100ef578063ce513b6f11610092578063ce513b6f14610398578063dd62ed3e146103ab578063e0563ab1146103be578063ea0fee4f146103c7578063eacdc5ff146103cf578063eeb49945146103d8578063f3f43703146103eb578063fd242c14146103fe57600080fd5b806370a08231146102e7578063947287cf146102fa57806395d89b411461030357806397e5230d1461030b578063981b24d014610315578063a457c2d714610328578063a9059cbb1461033b578063c6b61e4c1461034e57600080fd5b8063395093511161015757806339509351146102735780633b878c22146102865780633ccfd60b1461028f5780633fd50001146102975780634ee2cd7e146102aa57806351351d53146102bd57806361cc2763146102cb57806362656003146102de57600080fd5b806306fdde03146101b5578063095ea7b3146101d35780630f50287c146101f657806318160ddd1461020b57806323b872dd1461021d578063284017f5146102305780632e17de7814610251578063313ce56714610264575b600080fd5b6101bd610411565b6040516101ca91906119ba565b60405180910390f35b6101e66101e13660046119e2565b6104a3565b60405190151581526020016101ca565b610209610204366004611a0e565b6104bd565b005b6035545b6040519081526020016101ca565b6101e661022b366004611a46565b61074f565b61023961202081565b6040516001600160a01b0390911681526020016101ca565b61020961025f366004611a87565b610773565b604051601281526020016101ca565b6101e66102813660046119e2565b61078a565b61023961101081565b6102096107ac565b61020f6102a5366004611a87565b6108bd565b61020f6102b83660046119e2565b6108de565b6102396002600160a01b0381565b6102096102d9366004611b10565b6108f1565b61020f60cc5481565b61020f6102f5366004611c29565b610b1f565b61020f61520881565b6101bd610b3a565b61020f620249f081565b61020f610323366004611a87565b610b49565b6101e66103363660046119e2565b610b54565b6101e66103493660046119e2565b610bcf565b61037d61035c366004611a87565b60ce6020526000908152604090208054600182015460029092015490919083565b604080519384526020840192909252908201526060016101ca565b61020f6103a6366004611c29565b610bdd565b61020f6103b9366004611c46565b610c0b565b61023961203081565b61020f600181565b61020f60cd5481565b6102096103e6366004611c7f565b610c36565b61020f6103f9366004611c29565b610d08565b61020f61040c366004611a87565b610d2f565b60606036805461042090611d08565b80601f016020809104026020016040519081016040528092919081815260200182805461044c90611d08565b80156104995780601f1061046e57610100808354040283529160200191610499565b820191906000526020600020905b81548152906001019060200180831161047c57829003601f168201915b5050505050905090565b6000336104b1818585610d79565b60019150505b92915050565b336002600160a01b03146105065760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b60cd80546000918261051783611d58565b9190505590508083146105625760405162461bcd60e51b815260206004820152601360248201527215539156141150d5115117d15413d0d217d251606a1b60448201526064016104fd565b81356020830135116105ac5760405162461bcd60e51b81526020600482015260136024820152721393d7d09313d0d2d4d7d0d3d3535255151151606a1b60448201526064016104fd565b60cc546105be83356020850135611d71565b6105c9906001611d84565b6105d39190611dad565b1561062e5760405162461bcd60e51b815260206004820152602560248201527f45504f43485f4d5553545f42455f444956495349424c455f42595f45504f43486044820152645f53495a4560d81b60648201526084016104fd565b813560ce600061063f600185611d71565b815260200190815260200160002060010154600161065d9190611d84565b146106a05760405162461bcd60e51b8152602060048201526013602482015272494e56414c49445f53544152545f424c4f434b60681b60448201526064016104fd565b600081815260ce6020526040902082906106d182828135815560208201356001820155604082013560028201555050565b505060cf80546001810182556000919091526020838101357facb8d954e2cfef495862221e91bd7523613cf8808827cb33edfe4904cc51bf299092018290556040805190850135815284359186917f0ce8712c4dee4bd5a691f0bc1c39594671591e77395f8ebf6a3fb5f63fbea66a910160405180910390a4505050565b60003361075d858285610e9e565b610768858585610f12565b506001949350505050565b61077d33826110b6565b61078733826111e1565b50565b6000336104b181858561079d8383610c0b565b6107a79190611d84565b610d79565b33600090815260d06020526040812060cd5490919081906107ce90849061125a565b808555604051828152919350915033907f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b659060200160405180910390a260c95460cb54604080517f8ca9a95e41b5eece253c93f5b31eed1253aed6b145d8a6e14d913fdf8e7322936020820152338183015260608082018790528251808303909101815260808201928390526316f1983160e01b9092526001600160a01b03938416936316f198319361088693911691608401611dc1565b600060405180830381600087803b1580156108a057600080fd5b505af11580156108b4573d6000803e3d6000fd5b50505050505050565b60cf81815481106108cd57600080fd5b600091825260209091200154905081565b60006108ea83836112cc565b9392505050565b600054610100900460ff16158080156109115750600054600160ff909116105b8061092b5750303b15801561092b575060005460ff166001145b61098e5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016104fd565b6000805460ff1916600117905580156109b1576000805461ff0019166101001790555b6109fb6040518060400160405280600c81526020016b15985b1a59185d1bdc94d95d60a21b815250604051806040016040528060048152602001631594d15560e21b815250611315565b60c980546001600160a01b038089166001600160a01b03199283161790925560ca805488841690831617905560cb80549287169290911691909117905560cc83905560005b8251811015610a9557610a8d838281518110610a5e57610a5e611de5565b602002602001015160000151848381518110610a7c57610a7c611de5565b60200260200101516020015161134a565b600101610a40565b5060cf80546001818101835560009283527facb8d954e2cfef495862221e91bd7523613cf8808827cb33edfe4904cc51bf299091019190915560cd558015610b17576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b6001600160a01b031660009081526033602052604090205490565b60606037805461042090611d08565b60006104b782611354565b60003381610b628286610c0b565b905083811015610bc25760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084016104fd565b6107688286868403610d79565b6000336104b1818585610f12565b60cd546001600160a01b038216600090815260d0602052604081209091610c04919061125a565b5092915050565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b60ca546001600160a01b031633148015610c5d575060cb546001600160a01b038481169116145b610c9a5760405162461bcd60e51b815260206004820152600e60248201526d24a72b20a624a22fa9a2a72222a960911b60448201526064016104fd565b7f1bcc0f4c3fad314e585165815f94ecca9b96690a26d6417d7876448a9a867a69610cc9602060008486611dfb565b610cd291611e25565b03610d0257600080610ce78360208187611dfb565b810190610cf491906119e2565b91509150610b17828261134a565b50505050565b60cd546001600160a01b038216600090815260d06020526040812090916104b7919061137f565b600081815260ce60205260408120600101548015610d7057600083815260ce6020526040902054610d609082611d71565b610d6b906001611d84565b6108ea565b60009392505050565b6001600160a01b038316610ddb5760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016104fd565b6001600160a01b038216610e3c5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016104fd565b6001600160a01b0383811660008181526034602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6000610eaa8484610c0b565b90506000198114610d025781811015610f055760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000060448201526064016104fd565b610d028484848403610d79565b6001600160a01b038316610f765760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b60648201526084016104fd565b6001600160a01b038216610fd85760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016104fd565b610fe383838361141d565b6001600160a01b0383166000908152603360205260409020548181101561105b5760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b60648201526084016104fd565b6001600160a01b038085166000818152603360205260408082208686039055928616808252908390208054860190559151600080516020611fd6833981519152906110a99086815260200190565b60405180910390a3610d02565b6001600160a01b0382166111165760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016104fd565b6111228260008361141d565b6001600160a01b038216600090815260336020526040902054818110156111965760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b60648201526084016104fd565b6001600160a01b0383166000818152603360209081526040808320868603905560358054879003905551858152919291600080516020611fd68339815191529101610e91565b505050565b61121381600160cd546111f49190611d84565b6001600160a01b038516600090815260d0602052604090209190611486565b816001600160a01b03167f655c1cd0236fb6dc4916f34c8ff10e3b18fcaea5b344dfc16c36fbb1bdfc5df28260405161124e91815260200190565b60405180910390a25050565b81546000905b83600101548110156112c5576000818152600285016020908152604091829020825180840190935280548352600101549082018190528410156112a357506112c5565b80516112af9084611d84565b92505080806112bd90611d58565b915050611260565b9250929050565b6001600160a01b0382166000908152606560205260408120819081906112f39085906115b1565b915091508161130a5761130585610b1f565b61130c565b805b95945050505050565b600054610100900460ff1661133c5760405162461bcd60e51b81526004016104fd90611e43565b611346828261169f565b5050565b61134682826116df565b60008060006113648460666115b1565b915091508161137557603554611377565b805b949350505050565b60018201546000908082036113985760009150506104b7565b60006113a5600183611d71565b90505b845481106114155760008181526002860160209081526040918290208251808401909352805483526001015490820181905285106113e65750611415565b80516113f29085611d84565b9350816000036114025750611415565b508061140d81611e8e565b9150506113a8565b505092915050565b6001600160a01b038316158061143a57506001600160a01b038216155b61147b5760405162461bcd60e51b81526020600482015260126024820152712a2920a729a322a92fa327a92124a22222a760711b60448201526064016104fd565b6111dc83838361179a565b8160000361149657611496611ea5565b825460018401548181036114ed576040805180820182528581526020808201868152600085815260028a0190925292812091518255915160019182015586018054916114e183611d58565b91905055505050505050565b600060028601816114ff600185611d71565b81526020019081526020016000206001015490508084101561152357611523611ea5565b83811015611572576040805180820182528681526020808201878152600086815260028b01909252928120915182559151600191820155870180549161156883611d58565b9190505550610b17565b84600287016000611584600186611d71565b815260200190815260200160002060000160008282546115a49190611d84565b9091555050505050505050565b600080600084116115fd5760405162461bcd60e51b815260206004820152601660248201527504552433230536e617073686f743a20696420697320360541b60448201526064016104fd565b60cd5484111561164f5760405162461bcd60e51b815260206004820152601d60248201527f4552433230536e617073686f743a206e6f6e6578697374656e7420696400000060448201526064016104fd565b600061165b84866117e2565b845490915081036116735760008092509250506112c5565b600184600101828154811061168a5761168a611de5565b906000526020600020015492509250506112c5565b600054610100900460ff166116c65760405162461bcd60e51b81526004016104fd90611e43565b60366116d28382611f01565b5060376111dc8282611f01565b6001600160a01b0382166117355760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016104fd565b6117416000838361141d565b80603560008282546117539190611d84565b90915550506001600160a01b038216600081815260336020908152604080832080548601905551848152600080516020611fd6833981519152910160405180910390a35050565b6001600160a01b0383166117b9576117b18261188f565b6111dc6118b9565b6001600160a01b0382166117d0576117b18361188f565b6117d98361188f565b6111dc8261188f565b815460009081036117f5575060006104b7565b82546000905b8082101561184257600061180f83836118c9565b6000878152602090209091508590820154111561182e5780915061183c565b611839816001611d84565b92505b506117fb565b60008211801561186e57508361186b8661185d600186611d71565b600091825260209091200190565b54145b156118875761187e600183611d71565b925050506104b7565b5090506104b7565b6001600160a01b0381166000908152606560205260409020610787906118b483610b1f565b6118e4565b6118c760666118b460355490565b565b60006118d86002848418611fc1565b6108ea90848416611d84565b60006118ef60cd5490565b9050806118fb8461192f565b10156111dc578254600180820185556000858152602080822090930193909355938401805494850181558252902090910155565b8054600090810361194257506000919050565b8154829061195290600190611d71565b8154811061196257611962611de5565b90600052602060002001549050919050565b6000815180845260005b8181101561199a5760208185018101518683018201520161197e565b506000602082860101526020601f19601f83011685010191505092915050565b6020815260006108ea6020830184611974565b6001600160a01b038116811461078757600080fd5b600080604083850312156119f557600080fd5b8235611a00816119cd565b946020939093013593505050565b6000808284036080811215611a2257600080fd5b833592506060601f1982011215611a3857600080fd5b506020830190509250929050565b600080600060608486031215611a5b57600080fd5b8335611a66816119cd565b92506020840135611a76816119cd565b929592945050506040919091013590565b600060208284031215611a9957600080fd5b5035919050565b634e487b7160e01b600052604160045260246000fd5b6040805190810167ffffffffffffffff81118282101715611ad957611ad9611aa0565b60405290565b604051601f8201601f1916810167ffffffffffffffff81118282101715611b0857611b08611aa0565b604052919050565b600080600080600060a08688031215611b2857600080fd5b8535611b33816119cd565b9450602086810135611b44816119cd565b9450604087810135611b55816119cd565b945060608801359350608088013567ffffffffffffffff80821115611b7957600080fd5b818a0191508a601f830112611b8d57600080fd5b813581811115611b9f57611b9f611aa0565b611bad858260051b01611adf565b818152858101925060069190911b83018501908c821115611bcd57600080fd5b928501925b81841015611c165784848e031215611bea5760008081fd5b611bf2611ab6565b8435611bfd816119cd565b8152848701358782015283529284019291850191611bd2565b8096505050505050509295509295909350565b600060208284031215611c3b57600080fd5b81356108ea816119cd565b60008060408385031215611c5957600080fd5b8235611c64816119cd565b91506020830135611c74816119cd565b809150509250929050565b60008060008060608587031215611c9557600080fd5b843593506020850135611ca7816119cd565b9250604085013567ffffffffffffffff80821115611cc457600080fd5b818701915087601f830112611cd857600080fd5b813581811115611ce757600080fd5b886020828501011115611cf957600080fd5b95989497505060200194505050565b600181811c90821680611d1c57607f821691505b602082108103611d3c57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b600060018201611d6a57611d6a611d42565b5060010190565b818103818111156104b7576104b7611d42565b808201808211156104b7576104b7611d42565b634e487b7160e01b600052601260045260246000fd5b600082611dbc57611dbc611d97565b500690565b6001600160a01b038316815260406020820181905260009061137790830184611974565b634e487b7160e01b600052603260045260246000fd5b60008085851115611e0b57600080fd5b83861115611e1857600080fd5b5050820193919092039150565b803560208310156104b757600019602084900360031b1b1692915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b600081611e9d57611e9d611d42565b506000190190565b634e487b7160e01b600052600160045260246000fd5b601f8211156111dc57600081815260208120601f850160051c81016020861015611ee25750805b601f850160051c820191505b81811015610b1757828155600101611eee565b815167ffffffffffffffff811115611f1b57611f1b611aa0565b611f2f81611f298454611d08565b84611ebb565b602080601f831160018114611f645760008415611f4c5750858301515b600019600386901b1c1916600185901b178555610b17565b600085815260208120601f198616915b82811015611f9357888601518255948401946001909101908401611f74565b5085821015611fb15787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b600082611fd057611fd0611d97565b50049056feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220ceae916e2fad24f9aaa4340b6994418d32d33c6ae1f266c50dd4ec5ccbdbce2764736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000000102": { - "code": "0x608060405234801561001057600080fd5b506004361061009e5760003560e01c806391ec2d2b1161006657806391ec2d2b1461013b578063a850a9091461015b578063d58e77331461016e578063e242cce914610181578063ebbdac911461019457600080fd5b8063115000fe146100a3578063247dd9fb146100cb5780633e5476ce146100de5780638669026f146101085780639141376314610128575b600080fd5b6100b66100b1366004612708565b6101a7565b60405190151581526020015b60405180910390f35b6100b66100d9366004612785565b61030e565b6100f16100ec366004612841565b6103b8565b6040805192151583529015156020830152016100c2565b61011b6101163660046128ce565b61079f565b6040516100c29190612957565b6100f1610136366004612988565b6108bb565b61014e6101493660046128ce565b610d5c565b6040516100c29190612a86565b61011b6101693660046128ce565b610ff8565b61011b61017c366004612aa0565b6111d4565b6100b661018f366004612785565b6115aa565b6100f16101a2366004612ab9565b611609565b600081516020830151600080516020612d63833981519152828309600080516020612d638339815191528283098182830101600080516020612d638339815191528283840108600080516020612d638339815191528682600080516020612d6383398151915203860109935050600080516020612d638339815191528483600080516020612d63833981519152038301099150600080516020612d638339815191527f2b149d40ceb8aaae81be18991be06ac3b5b4c5e559dbefa33267e6dc24a138e584089450600080516020612d638339815191527e9713b03af0fed4cd2cafadeed8fdf4a74fa084e52d1852e4a2bd0685c315d2830893506040870151925060608701519150600080516020612d638339815191528083600080516020612d63833981519152038508600080516020612d63833981519152848608099050600080516020612d63833981519152828460011b0994149290931491909116949350505050565b8051600090600080516020612d6383398151915211158061034157506020820151600080516020612d6383398151915211155b1561034e57506000919050565b60405163e242cce960e01b8152309063e242cce990610371908590600401612957565b602060405180830381865afa15801561038e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103b29190612b1c565b92915050565b60008083806103e25760405162461bcd60e51b81526004016103d990612b3e565b60405180910390fd5b60006103ef826001612b95565b6103fa906006612ba8565b90506000816001600160401b038111156104165761041661269a565b60405190808252806020026020018201604052801561043f578160200160208202803683370190505b50905088600060200201358160008151811061045d5761045d612b06565b602090810291909101015288600160200201358160018151811061048357610483612b06565b602002602001018181525050600080516020612d43833981519152816002815181106104b1576104b1612b06565b602002602001018181525050600080516020612d23833981519152816003815181106104df576104df612b06565b602002602001018181525050600080516020612d838339815191528160048151811061050d5761050d612b06565b602002602001018181525050600080516020612da38339815191528160058151811061053b5761053b612b06565b60200260200101818152505060005b8381101561075a57863582610560836006612ba8565b61056b906006612b95565b8151811061057b5761057b612b06565b602090810291909101015286600160200201358261059a836006612ba8565b6105a5906007612b95565b815181106105b5576105b5612b06565b6020026020010181815250508888828181106105d3576105d3612b06565b9050608002016001600481106105eb576105eb612b06565b6020020135826105fc836006612ba8565b610607906008612b95565b8151811061061757610617612b06565b60200260200101818152505088888281811061063557610635612b06565b90506080020160006004811061064d5761064d612b06565b60200201358261065e836006612ba8565b610669906009612b95565b8151811061067957610679612b06565b60200260200101818152505088888281811061069757610697612b06565b9050608002016003600481106106af576106af612b06565b6020020135826106c0836006612ba8565b6106cb90600a612b95565b815181106106db576106db612b06565b6020026020010181815250508888828181106106f9576106f9612b06565b90506080020160026004811061071157610711612b06565b602002013582610722836006612ba8565b61072d90600b612b95565b8151811061073d5761073d612b06565b60209081029190910101528061075281612bbf565b91505061054a565b50610763612640565b602081602085026020850160085afa945084610789576000809550955050505050610796565b5115159450600193505050505b94509492505050565b6107a761265e565b6040516391ec2d2b60e01b815260009030906391ec2d2b906107cf9087908790600401612bd8565b600060405180830381865afa1580156107ec573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526108149190810190612bf9565b9050600080600080601885016001600160c01b0381511693506030860190506001600160c01b038151169450600080516020612d6383398151915285600080516020612d63833981519152600160c01b870908604887015160608801516001600160c01b0390811697501694509250600080516020612d6383398151915290508481600160c01b860908604080518082019091529283526020830152509695505050505050565b60008084806108dc5760405162461bcd60e51b81526004016103d990612b3e565b8084146109495760405162461bcd60e51b815260206004820152603560248201527f424c533a206e756d626572206f66207075626c6963206b65797320616e64206d604482015274195cdcd859d95cc81b5d5cdd08189948195c5d585b605a1b60648201526084016103d9565b6000610956826001612b95565b610961906006612ba8565b90506000816001600160401b0381111561097d5761097d61269a565b6040519080825280602002602001820160405280156109a6578160200160208202803683370190505b5090508960006020020135816000815181106109c4576109c4612b06565b60209081029190910101528960016020020135816001815181106109ea576109ea612b06565b602002602001018181525050600080516020612d4383398151915281600281518110610a1857610a18612b06565b602002602001018181525050600080516020612d2383398151915281600381518110610a4657610a46612b06565b602002602001018181525050600080516020612d8383398151915281600481518110610a7457610a74612b06565b602002602001018181525050600080516020612da383398151915281600581518110610aa257610aa2612b06565b60200260200101818152505060005b83811015610d1657878782818110610acb57610acb612b06565b905060400201600060028110610ae357610ae3612b06565b602002013582610af4836006612ba8565b610aff906006612b95565b81518110610b0f57610b0f612b06565b602002602001018181525050878782818110610b2d57610b2d612b06565b905060400201600160028110610b4557610b45612b06565b602002013582610b56836006612ba8565b610b61906007612b95565b81518110610b7157610b71612b06565b602002602001018181525050898982818110610b8f57610b8f612b06565b905060800201600160048110610ba757610ba7612b06565b602002013582610bb8836006612ba8565b610bc3906008612b95565b81518110610bd357610bd3612b06565b602002602001018181525050898982818110610bf157610bf1612b06565b905060800201600060048110610c0957610c09612b06565b602002013582610c1a836006612ba8565b610c25906009612b95565b81518110610c3557610c35612b06565b602002602001018181525050898982818110610c5357610c53612b06565b905060800201600360048110610c6b57610c6b612b06565b602002013582610c7c836006612ba8565b610c8790600a612b95565b81518110610c9757610c97612b06565b602002602001018181525050898982818110610cb557610cb5612b06565b905060800201600260048110610ccd57610ccd612b06565b602002013582610cde836006612ba8565b610ce990600b612b95565b81518110610cf957610cf9612b06565b602090810291909101015280610d0e81612bbf565b915050610ab1565b50610d1f612640565b602081602085026020850160085afa945084610d45576000809550955050505050610d52565b5115159450600193505050505b9550959350505050565b80516060906000610d6e826020612b95565b610d79906040612b95565b610d84906004612b95565b6001600160401b03811115610d9b57610d9b61269a565b6040519080825280601f01601f191660200182016040528015610dc5576020820181803683370190505b5060408051606080825260808201909252919250600091906020820181803683370190505090506060820160005b84811015610e0d5760208188018101518383015201610df3565b5083016000815360010160608153600101600081536001810187905260210160208153506000600283604051610e439190612c6f565b602060405180830381855afa158015610e60573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610e839190612c8b565b9050600060429450848452816020850152600160408501536041840188905260206061850153600284604051610eb99190612c6f565b602060405180830381855afa158015610ed6573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610ef99190612c8b565b905080602084015280821880602086015250600260408501536041840188905260206061850153600284604051610f309190612c6f565b602060405180830381855afa158015610f4d573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610f709190612c8b565b905080604084015280821880602086015250600360408501536041840188905260206061850153600284604051610fa79190612c6f565b602060405180830381855afa158015610fc4573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610fe79190612c8b565b606084015250909695505050505050565b61100061265e565b604051638669026f60e01b81526000903090638669026f906110289087908790600401612bd8565b6040805180830381865afa158015611044573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110689190612ca4565b805160405163d58e773360e01b81526004810191909152909150600090309063d58e7733906024016040805180830381865afa1580156110ac573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110d09190612ca4565b602083015160405163d58e773360e01b81526004810191909152909150600090309063d58e7733906024016040805180830381865afa158015611117573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061113b9190612ca4565b905061114561267c565b825181526020808401518282015282516040808401919091529083015160608301526000908460808460066107d05a03fa9050808061118057fe5b50806111c85760405162461bcd60e51b8152602060048201526017602482015276109314ce88189b881859190818d85b1b0819985a5b1959604a1b60448201526064016103d9565b50919695505050505050565b6111dc61265e565b600080516020612d6383398151915282106112455760405162461bcd60e51b815260206004820152602360248201527f6d6170546f506f696e7446543a20696e76616c6964206669656c6420656c656d604482015262195b9d60ea1b60648201526084016103d9565b81600061125182611790565b9150506000600080516020612d638339815191528061127257611272612cf9565b8384099050600080516020612d638339815191526004820890506000600080516020612d6383398151915277b3c4d79d41a91759a9e4c7e359b6b89eaec68e62effffffd850990506000600080516020612d6383398151915283830990506112d9816117b9565b9050600080516020612d638339815191528283099150600080516020612d638339815191528183099150600080516020612d638339815191528286099150600080516020612d6383398151915261133e83600080516020612d63833981519152612d0f565b7759e26bcea0d48bacd4f263f1acdb5c4f5763473177fffffe089450600080516020612d638339815191528586099150600080516020612d638339815191528583099150600080516020612d6383398151915260038308915060006113a283611790565b909350905080156113ea57846113cd576113ca83600080516020612d63833981519152612d0f565b92505b505060408051808201909152938452602084015250909392505050565b600080516020612d638339815191526001870861141590600080516020612d63833981519152612d0f565b9550600080516020612d638339815191528687099250600080516020612d638339815191528684099250600080516020612d6383398151915260038408925061145d83611790565b9093509050801561148557846113cd576113ca83600080516020612d63833981519152612d0f565b600080516020612d638339815191528485099550600080516020612d638339815191528687099550600080516020612d638339815191528287099550600080516020612d638339815191528287099550600080516020612d63833981519152600187089550600080516020612d638339815191528687099250600080516020612d638339815191528684099250600080516020612d6383398151915260038408925061153083611790565b90935090508061158d5760405162461bcd60e51b815260206004820152602260248201527f424c533a20626164206674206d617070696e6720696d706c656d656e7461746960448201526137b760f11b60648201526084016103d9565b846113cd576113ca83600080516020612d63833981519152612d0f565b600081516020830151600080516020612d63833981519152828309600080516020612d638339815191528382099050600080516020612d63833981519152600382089050600080516020612d6383398151915282830914949350505050565b60008060006040518061018001604052808760006002811061162d5761162d612b06565b602002013581526020018760016002811061164a5761164a612b06565b60200201358152602001600080516020612d438339815191528152602001600080516020612d238339815191528152602001600080516020612d838339815191528152602001600080516020612da38339815191528152602001856000600281106116b7576116b7612b06565b60200201358152602001856001600281106116d4576116d4612b06565b60200201358152602001866001600481106116f1576116f1612b06565b602002013581526020018660006004811061170e5761170e612b06565b602002013581526020018660036004811061172b5761172b612b06565b602002013581526020018660026004811061174857611748612b06565b602002013590529050611759612640565b60006020826101808560085afa90508061177c5760008094509450505050611788565b50511515925060019150505b935093915050565b60008061179c836117c4565b915082600080516020612d63833981519152838409149050915091565b60006103b282611ef9565b6000600080516020612d638339815191528083840991508083830981838209828283098385830984848309858484098684850997508684840987858409945087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087838a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985050868889099750868889099750868889099750868889099750868889099750868889099750868489099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868689099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868189099750508587880996508587880996508587880996508585880996508587880996508587880996508587880996508585880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508587880996508581880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508584880996508587880996508587880996508587880996508587880996508587880996508581880996505050505050808283099392505050565b6000600080516020612d638339815191528083840991508083830981838209828283098385830984848309858484098684850997508684840987858409945087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087838a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985050868889099750868889099750868889099750868889099750868889099750868889099750868489099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868689099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868189099750508587880996508587880996508587880996508585880996508587880996508587880996508587880996508585880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508587880996508581880996505050838586099450838586099450838586099450838586099450838186099450508284850993508284850993508284850993508281850993508284850993508284850993508285850993508284850993508284850993508284850993508284850993508284850993508284850993508281850995945050505050565b60405180602001604052806001906020820280368337509192915050565b60405180604001604052806002906020820280368337509192915050565b60405180608001604052806004906020820280368337509192915050565b634e487b7160e01b600052604160045260246000fd5b604080519081016001600160401b03811182821017156126d2576126d261269a565b60405290565b604051601f8201601f191681016001600160401b03811182821017156127005761270061269a565b604052919050565b60006080828403121561271a57600080fd5b82601f83011261272957600080fd5b604051608081018181106001600160401b038211171561274b5761274b61269a565b60405280608084018581111561276057600080fd5b845b8181101561277a578035835260209283019201612762565b509195945050505050565b60006040828403121561279757600080fd5b82601f8301126127a657600080fd5b6127ae6126b0565b8060408401858111156127c057600080fd5b845b818110156127da5780358452602093840193016127c2565b509095945050505050565b80604081018310156103b257600080fd5b60008083601f84011261280857600080fd5b5081356001600160401b0381111561281f57600080fd5b6020830191508360208260071b850101111561283a57600080fd5b9250929050565b60008060008060a0858703121561285757600080fd5b61286186866127e5565b935060408501356001600160401b0381111561287c57600080fd5b612888878288016127f6565b909450925061289c905086606087016127e5565b905092959194509250565b60006001600160401b038211156128c0576128c061269a565b50601f01601f191660200190565b600080604083850312156128e157600080fd5b8235915060208301356001600160401b038111156128fe57600080fd5b8301601f8101851361290f57600080fd5b803561292261291d826128a7565b6126d8565b81815286602083850101111561293757600080fd5b816020840160208301376000602083830101528093505050509250929050565b60408101818360005b600281101561297f578151835260209283019290910190600101612960565b50505092915050565b6000806000806000608086880312156129a057600080fd5b6129aa87876127e5565b945060408601356001600160401b03808211156129c657600080fd5b6129d289838a016127f6565b909650945060608801359150808211156129eb57600080fd5b818801915088601f8301126129ff57600080fd5b813581811115612a0e57600080fd5b8960208260061b8501011115612a2357600080fd5b9699959850939650602001949392505050565b60005b83811015612a51578181015183820152602001612a39565b50506000910152565b60008151808452612a72816020860160208601612a36565b601f01601f19169290920160200192915050565b602081526000612a996020830184612a5a565b9392505050565b600060208284031215612ab257600080fd5b5035919050565b60008060006101008486031215612acf57600080fd5b612ad985856127e5565b925060c0840185811115612aec57600080fd5b604085019250612afc86826127e5565b9150509250925092565b634e487b7160e01b600052603260045260246000fd5b600060208284031215612b2e57600080fd5b81518015158114612a9957600080fd5b60208082526021908201527f424c533a206e756d626572206f66207075626c6963206b6579206973207a65726040820152606f60f81b606082015260800190565b634e487b7160e01b600052601160045260246000fd5b808201808211156103b2576103b2612b7f565b80820281158282048414176103b2576103b2612b7f565b600060018201612bd157612bd1612b7f565b5060010190565b828152604060208201526000612bf16040830184612a5a565b949350505050565b600060208284031215612c0b57600080fd5b81516001600160401b03811115612c2157600080fd5b8201601f81018413612c3257600080fd5b8051612c4061291d826128a7565b818152856020838501011115612c5557600080fd5b612c66826020830160208601612a36565b95945050505050565b60008251612c81818460208701612a36565b9190910192915050565b600060208284031215612c9d57600080fd5b5051919050565b600060408284031215612cb657600080fd5b82601f830112612cc557600080fd5b612ccd6126b0565b806040840185811115612cdf57600080fd5b845b818110156127da578051845260209384019301612ce1565b634e487b7160e01b600052601260045260246000fd5b818103818111156103b2576103b2612b7f56fe1800deef121f1e76426a00665e5c4479674322d4f75edadd46debd5cd992f6ed198e9393920d483a7260bfb731fb5d25f1aa493335a9e71297e485b7aef312c230644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47275dc4a288d1afb3cbb1ac09187524c7db36395df7be3b99e673b13a075a65ec1d9befcd05a5323e6da4d435f3b617cdb3af83285c2df711ef39c01571827f9da264697066735822122085f910855a39dd4d2f9582253d737b6f9c450d7d8e7383f636149d598d69b6ac64736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000000103": { - "code": "0x73000000000000000000000000000000000000000030146080604052600080fdfea26469706673582212209ebefbbe674f8f0780cb158df4fa624dc1694693fcb1c5952691eb2a55c6f0aa64736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000000105": { - "code": "0x608060405234801561001057600080fd5b50600436106100d55760003560e01c8063947287cf11610087578063947287cf14610183578063972398b61461018c57806397e5230d1461019f57806399248ea7146101a9578063b66ceef6146101c2578063c885bc58146101d5578063cf756fdf146101dd578063e0563ab1146101f057600080fd5b806307358b99146100da57806322009af61461010d578063284017f51461011657806331d7a262146101375780633b878c221461015757806351351d53146101605780638a9cd82d1461016e575b600080fd5b6100fa6100e8366004610b1d565b60366020526000908152604090205481565b6040519081526020015b60405180910390f35b6100fa60355481565b61011f61202081565b6040516001600160a01b039091168152602001610104565b6100fa610145366004610b52565b60376020526000908152604090205481565b61011f61101081565b61011f6002600160a01b0381565b61018161017c366004610b74565b6101f9565b005b6100fa61520881565b60345461011f906001600160a01b031681565b6100fa620249f081565b60325461011f906201000090046001600160a01b031681565b60335461011f906001600160a01b031681565b610181610658565b6101816101eb366004610bf3565b61068e565b61011f61203081565b336002600160a01b03146102425760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b6000838152603660205260409020541561029e5760405162461bcd60e51b815260206004820152601a60248201527f5245574152445f414c52454144595f44495354524942555445440000000000006044820152606401610239565b603454604051633f490b0560e21b8152600481018590526000916001600160a01b03169063fd242c1490602401602060405180830381865afa1580156102e8573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061030c9190610c3e565b9050806000036103545760405162461bcd60e51b8152602060048201526013602482015272115413d0d217d393d517d0d3d3535255151151606a1b6044820152606401610239565b60345460408051636265600360e01b815290516000926001600160a01b03169163626560039160048083019260209291908290030181865afa15801561039e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103c29190610c3e565b905060006103d1826064610c6d565b836035546103df9190610c6d565b6103ea906064610c6d565b6103f49190610c8a565b603454604051630981b24d60e41b8152600481018990529192506000916001600160a01b039091169063981b24d090602401602060405180830381865afa158015610443573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104679190610c3e565b9050846000805b828110156105f857600089898381811061048a5761048a610cac565b9050604002018036038101906104a09190610cc2565b905087816020015111156104f65760405162461bcd60e51b815260206004820152601b60248201527f5349474e45445f424c4f434b535f455843454544535f544f54414c00000000006044820152606401610239565b603454815160405163277166bf60e11b81526001600160a01b039182166004820152602481018e90526000929190911690634ee2cd7e90604401602060405180830381865afa15801561054d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105719190610c3e565b9050600061057f8a88610c6d565b602084015161058e848b610c6d565b6105989190610c6d565b6105a29190610c8a565b83516001600160a01b03166000908152603760205260408120805492935083929091906105d0908490610d27565b909155506105e090508186610d27565b945050505080806105f090610d3a565b91505061046e565b506000898152603660205260409020819055610613816107f1565b887feaf3d57629d9b1ce95715ccd98d6f5bf48023be1d5a06e09f64ab7f6d8be01d58260405161064591815260200190565b60405180910390a2505050505050505050565b3360008181526037602052604081208054919055603254909161068b916201000090046001600160a01b03169083610815565b50565b603254610100900460ff16158080156106ae5750603254600160ff909116105b806106c85750303b1580156106c8575060325460ff166001145b61072b5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610239565b6032805460ff19166001179055801561074e576032805461ff0019166101001790555b603280546001600160a01b03808816620100000262010000600160b01b031990921691909117909155603380548683166001600160a01b0319918216179091556034805492861692909116919091179055603582905580156107ea576032805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b60335460325461068b916001600160a01b036201000090920482169116308461087d565b6040516001600160a01b03831660248201526044810182905261087890849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b0319909316929092179091526108bb565b505050565b6040516001600160a01b03808516602483015283166044820152606481018290526108b59085906323b872dd60e01b90608401610841565b50505050565b6000610910826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b031661098d9092919063ffffffff16565b805190915015610878578080602001905181019061092e9190610d53565b6108785760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610239565b606061099c84846000856109a4565b949350505050565b606082471015610a055760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610239565b600080866001600160a01b03168587604051610a219190610d99565b60006040518083038185875af1925050503d8060008114610a5e576040519150601f19603f3d011682016040523d82523d6000602084013e610a63565b606091505b5091509150610a7487838387610a7f565b979650505050505050565b60608315610aee578251600003610ae7576001600160a01b0385163b610ae75760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610239565b508161099c565b61099c8383815115610b035781518083602001fd5b8060405162461bcd60e51b81526004016102399190610db5565b600060208284031215610b2f57600080fd5b5035919050565b80356001600160a01b0381168114610b4d57600080fd5b919050565b600060208284031215610b6457600080fd5b610b6d82610b36565b9392505050565b600080600060408486031215610b8957600080fd5b83359250602084013567ffffffffffffffff80821115610ba857600080fd5b818601915086601f830112610bbc57600080fd5b813581811115610bcb57600080fd5b8760208260061b8501011115610be057600080fd5b6020830194508093505050509250925092565b60008060008060808587031215610c0957600080fd5b610c1285610b36565b9350610c2060208601610b36565b9250610c2e60408601610b36565b9396929550929360600135925050565b600060208284031215610c5057600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b8082028115828204841417610c8457610c84610c57565b92915050565b600082610ca757634e487b7160e01b600052601260045260246000fd5b500490565b634e487b7160e01b600052603260045260246000fd5b600060408284031215610cd457600080fd5b6040516040810181811067ffffffffffffffff82111715610d0557634e487b7160e01b600052604160045260246000fd5b604052610d1183610b36565b8152602083013560208201528091505092915050565b80820180821115610c8457610c84610c57565b600060018201610d4c57610d4c610c57565b5060010190565b600060208284031215610d6557600080fd5b81518015158114610b6d57600080fd5b60005b83811015610d90578181015183820152602001610d78565b50506000910152565b60008251610dab818460208701610d75565b9190910192915050565b6020815260008251806020840152610dd4816040850160208701610d75565b601f01601f1916919091016040019291505056fea2646970667358221220c7e8b508ebaffb4eaa11ba374acb0ddc2570f6351d83600979bf1f82d7cec70564736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001001": { - "code": "0x608060405234801561001057600080fd5b50600436106100e05760003560e01c80639017c127116100875780639017c127146101de578063947287cf146101f157806397e5230d146101fa578063ad240c2a14610204578063c59a18f71461020d578063c6df461714610220578063e0563ab114610233578063eb70ef441461023c57600080fd5b8063196f1b2d146100e557806323e281cf1461010b578063284017f5146101145780633b878c221461013557806349ce89971461013e57806350d5b95b1461018857806351351d531461019d578063544c5e0f146101ab575b600080fd5b6100f86100f3366004610e88565b610271565b6040519081526020015b60405180910390f35b6100f860325481565b61011d61202081565b6040516001600160a01b039091168152602001610102565b61011d61101081565b61016d61014c366004610e88565b60356020526000908152604090208054600182015460029092015490919083565b60408051938452602084019290925290820152606001610102565b61019b610196366004610eec565b6102f0565b005b61011d6002600160a01b0381565b6101ce6101b9366004610e88565b60346020526000908152604090205460ff1681565b6040519015158152602001610102565b61019b6101ec366004610f5b565b6103b7565b6100f861520881565b6100f8620249f081565b6100f860335481565b6100f861021b366004610e88565b610557565b61019b61022e366004611007565b610578565b61011d61203081565b61024f61024a366004610e88565b61075c565b6040805182518152602080840151908201529181015190820152606001610102565b60008060358161028260368661081f565b81526020810191909152604001600020600201549050806102ea5760405162461bcd60e51b815260206004820152601d60248201527f537461746552656365697665723a204e4f5f524f4f545f464f525f494400000060448201526064015b60405180910390fd5b92915050565b60006102fc823561075c565b805190915061036c906103109084356110a5565b8251602084015161032191906110a5565b61032c9060016110b8565b83604001518787876040516020016103449190611110565b604051602081830303815290604052805190602001206108cc9095949392919063ffffffff16565b6103a85760405162461bcd60e51b815260206004820152600d60248201526c24a72b20a624a22fa82927a7a360991b60448201526064016102e1565b6103b182610a68565b50505050565b8281811461041a5760405162461bcd60e51b815260206004820152602a60248201527f537461746552656365697665723a20554e4d4154434845445f4c454e4754485f604482015269504152414d455445525360b01b60648201526084016102e1565b60005b8181101561054f57600061045485858481811061043c5761043c6111ac565b905060200281019061044e91906111c2565b3561075c565b905060006105088260000151878786818110610472576104726111ac565b905060200281019061048491906111c2565b61048f9190356110a5565b835160208501516104a091906110a5565b6104ab9060016110b8565b84604001518b8b888181106104c2576104c26111ac565b90506020028101906104d491906111e2565b8b8b8a8181106104e6576104e66111ac565b90506020028101906104f891906111c2565b6040516020016103449190611110565b90508061051957505060010161041d565b61054586868581811061052e5761052e6111ac565b905060200281019061054091906111c2565b610a68565b505060010161041d565b505050505050565b6036818154811061056757600080fd5b600091825260209091200154905081565b336002600160a01b03146105bc5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016102e1565b6033546105ca9060016110b8565b85351461060c5760405162461bcd60e51b815260206004820152601060248201526f1253959053125117d4d510549517d25160821b60448201526064016102e1565b8435602086013510156106525760405162461bcd60e51b815260206004820152600e60248201526d1253959053125117d1539117d25160921b60448201526064016102e1565b60408051863560208083019190915287013581830152908601356060820152610697906080016040516020818303038152906040528051906020012085858585610c83565b603280548691603591600091826106ad8361122b565b90915550815260208082019290925260409081016000208335815591830135600183015582013560028201555050603680546001810182556000919091526020868101357f4a11f94e20a93c79f6ec743a1954ec4fc2c08429ae2122118bf234b2185c81b89092018290556033829055604080519088013581528735917f11efd893530b26afc66d488ff54cb15df117cb6e0e4a08c6dcb166d766c3bf3b910160405180910390a35050505050565b604080516060810182526000808252602082018190529181018290529061078460368461081f565b60365490915081036107e45760405162461bcd60e51b815260206004820152602360248201527f537461746552656365697665723a204e4f5f434f4d4d49544d454e545f464f5260448201526217d25160ea1b60648201526084016102e1565b600090815260356020908152604091829020825160608101845281548152600182015492810192909252600201549181019190915292915050565b81546000908103610832575060006102ea565b82546000905b8082101561087f57600061084c8383610d87565b6000878152602090209091508590820154111561086b57809150610879565b6108768160016110b8565b92505b50610838565b6000821180156108ab5750836108a88661089a6001866110a5565b600091825260209091200190565b54145b156108c4576108bb6001836110a5565b925050506102ea565b509392505050565b6000816108da866001610da9565b811461091f5760405162461bcd60e51b81526020600482015260146024820152730929cac82989288bea0a49e9e8cbe988a9c8ea8960631b60448201526064016102e1565b8587106109635760405162461bcd60e51b81526020600482015260126024820152710929cac82989288be988a828cbe929c888ab60731b60448201526064016102e1565b8761099f5760405162461bcd60e51b815260206004820152600c60248201526b24a72b20a624a22fa622a0a360a11b60448201526064016102e1565b8760005b82811015610a595760008686838181106109bf576109bf6111ac565b90506020020135905060028a6109d5919061125a565b600003610a0d576040805160208101859052908101829052606001604051602081830303815290604052805190602001209250610a3a565b60408051602081018390529081018490526060016040516020818303038152906040528051906020012092505b610a4560028b61126e565b99505080610a529061122b565b90506109a3565b50909414979650505050505050565b803560009081526034602052604090205460ff1615610ad85760405162461bcd60e51b815260206004820152602660248201527f537461746552656365697665723a2053544154455f53594e435f49535f50524f60448201526510d154d4d15160d21b60648201526084016102e1565b610ae86060820160408301611282565b6001600160a01b03163b600003610b3c576040805160208082526000908201819052918335917f31c652130602f3ce96ceaf8a4c2b8b49f049166c6fcf2eb31943a75ec7c936ae910160405180910390a350565b8035600090815260346020526040808220805460ff191660011790558190610b6a9060608501908501611282565b6001600160a01b03168335610b856040860160208701611282565b610b92606087018761129d565b604051602401610ba594939291906112e3565b60408051601f198184030181529181526020820180516001600160e01b031663eeb4994560e01b17905251610bda919061133c565b6000604051808303816000865af19150503d8060008114610c17576040519150601f19603f3d011682016040523d82523d6000602084013e610c1c565b606091505b509150915081610c3f5782356000908152603460205260409020805460ff191690555b81151583600001357f31c652130602f3ce96ceaf8a4c2b8b49f049166c6fcf2eb31943a75ec7c936ae83604051610c76919061134e565b60405180910390a3505050565b6000806120306001600160a01b0316620249f08888888888604051602001610caf959493929190611381565b60408051601f1981840301815290829052610cc99161133c565b6000604051808303818686fa925050503d8060008114610d05576040519150601f19603f3d011682016040523d82523d6000602084013e610d0a565b606091505b5091509150600081806020019051810190610d2591906113ba565b9050828015610d315750805b610d7d5760405162461bcd60e51b815260206004820152601d60248201527f5349474e41545552455f564552494649434154494f4e5f4641494c454400000060448201526064016102e1565b5050505050505050565b6000610d96600284841861126e565b610da2908484166110b8565b9392505050565b600080610db584610df4565b90506001836002811115610dcb57610dcb6113dc565b148015610ddb575083816001901b105b610de6576000610de9565b60015b60ff16019392505050565b600080608083901c15610e0957608092831c92015b604083901c15610e1b57604092831c92015b602083901c15610e2d57602092831c92015b601083901c15610e3f57601092831c92015b600883901c15610e5157600892831c92015b600483901c15610e6357600492831c92015b600283901c15610e7557600292831c92015b600183901c156102ea5760010192915050565b600060208284031215610e9a57600080fd5b5035919050565b60008083601f840112610eb357600080fd5b5081356001600160401b03811115610eca57600080fd5b6020830191508360208260051b8501011115610ee557600080fd5b9250929050565b600080600060408486031215610f0157600080fd5b83356001600160401b0380821115610f1857600080fd5b610f2487838801610ea1565b90955093506020860135915080821115610f3d57600080fd5b50840160808187031215610f5057600080fd5b809150509250925092565b60008060008060408587031215610f7157600080fd5b84356001600160401b0380821115610f8857600080fd5b610f9488838901610ea1565b90965094506020870135915080821115610fad57600080fd5b50610fba87828801610ea1565b95989497509550505050565b60008083601f840112610fd857600080fd5b5081356001600160401b03811115610fef57600080fd5b602083019150836020828501011115610ee557600080fd5b600080600080600085870360a081121561102057600080fd5b606081121561102e57600080fd5b5085945060608601356001600160401b038082111561104c57600080fd5b61105889838a01610fc6565b9096509450608088013591508082111561107157600080fd5b5061107e88828901610fc6565b969995985093965092949392505050565b634e487b7160e01b600052601160045260246000fd5b818103818111156102ea576102ea61108f565b808201808211156102ea576102ea61108f565b80356001600160a01b03811681146110e257600080fd5b919050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60208152813560208201526000611129602084016110cb565b60018060a01b03808216604085015280611145604087016110cb565b16606085015250506060830135601e1984360301811261116457600080fd5b83016020810190356001600160401b0381111561118057600080fd5b80360382131561118f57600080fd5b6080808501526111a360a0850182846110e7565b95945050505050565b634e487b7160e01b600052603260045260246000fd5b60008235607e198336030181126111d857600080fd5b9190910192915050565b6000808335601e198436030181126111f957600080fd5b8301803591506001600160401b0382111561121357600080fd5b6020019150600581901b3603821315610ee557600080fd5b60006001820161123d5761123d61108f565b5060010190565b634e487b7160e01b600052601260045260246000fd5b60008261126957611269611244565b500690565b60008261127d5761127d611244565b500490565b60006020828403121561129457600080fd5b610da2826110cb565b6000808335601e198436030181126112b457600080fd5b8301803591506001600160401b038211156112ce57600080fd5b602001915036819003821315610ee557600080fd5b8481526001600160a01b038416602082015260606040820181905260009061130e90830184866110e7565b9695505050505050565b60005b8381101561133357818101518382015260200161131b565b50506000910152565b600082516111d8818460208701611318565b602081526000825180602084015261136d816040850160208701611318565b601f01601f19169190910160400192915050565b85815260606020820152600061139b6060830186886110e7565b82810360408401526113ae8185876110e7565b98975050505050505050565b6000602082840312156113cc57600080fd5b81518015158114610da257600080fd5b634e487b7160e01b600052602160045260246000fdfea2646970667358221220f4843af5244f1ef6b01f5d8fdd49e8f0e76508652a929df5979a03cb0156a6e864736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001002": { - "code": "0x608060405234801561001057600080fd5b50600436106100415760003560e01c806316f198311461004657806361bc221a1461005b578063a6f9885c14610076575b600080fd5b61005961005436600461017a565b61007f565b005b61006460005481565b60405190815260200160405180910390f35b61006461080081565b6001600160a01b0383166100cd5760405162461bcd60e51b815260206004820152601060248201526f24a72b20a624a22fa922a1a2a4ab22a960811b60448201526064015b60405180910390fd5b6108008111156101145760405162461bcd60e51b815260206004820152601260248201527108ab0868a8a88a6be9a82b0be988a9c8ea8960731b60448201526064016100c4565b826001600160a01b0316336001600160a01b031660008081546101369061020b565b9190508190557fedaf3c471ebd67d60c29efe34b639ede7d6a1d92eaeb3f503e784971e67118a5858560405161016d929190610232565b60405180910390a4505050565b60008060006040848603121561018f57600080fd5b83356001600160a01b03811681146101a657600080fd5b9250602084013567ffffffffffffffff808211156101c357600080fd5b818601915086601f8301126101d757600080fd5b8135818111156101e657600080fd5b8760208285010111156101f857600080fd5b6020830194508093505050509250925092565b60006001820161022b57634e487b7160e01b600052601160045260246000fd5b5060010190565b60208152816020820152818360408301376000818301604090810191909152601f909201601f1916010191905056fea26469706673582212207637618450354edc5d98998425a0a6500ada60d0a9d2cdc5b2045e291fd737f264736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001003": { - "code": "0x608060405234801561001057600080fd5b50600436106101215760003560e01c806340c10f19116100ad578063a457c2d711610071578063a457c2d71461028b578063a9059cbb1461029e578063dd62ed3e146102b1578063e6198705146102c4578063f6d2ee86146102d557600080fd5b806340c10f191461021f57806370a082311461023257806395d89b411461025b5780639b77ef11146102635780639dc29fac1461027857600080fd5b80631f2d0065116100f45780631f2d00651461018c57806323b872dd146101b15780632d0335ab146101c4578063313ce567146101ed578063395093511461020c57600080fd5b806306fdde0314610126578063095ea7b3146101445780630c53c51c1461016757806318160ddd1461017a575b600080fd5b61012e6102e8565b60405161013b91906113b6565b60405180910390f35b6101576101523660046113ec565b61037a565b604051901515815260200161013b565b61012e610175366004611470565b61039e565b603c545b60405190815260200161013b565b606d546001600160a01b03165b6040516001600160a01b03909116815260200161013b565b6101576101bf3660046114e6565b610681565b61017e6101d2366004611522565b6001600160a01b031660009081526006602052604090205490565b606d54600160a01b900460ff1660405160ff909116815260200161013b565b61015761021a3660046113ec565b6106af565b61015761022d3660046113ec565b6106db565b61017e610240366004611522565b6001600160a01b03166000908152603a602052604090205490565b61012e61071b565b61027661027136600461153d565b61072a565b005b6101576102863660046113ec565b610751565b6101576102993660046113ec565b610788565b6101576102ac3660046113ec565b61080e565b61017e6102bf366004611556565b610826565b606c546001600160a01b0316610199565b6102766102e3366004611589565b610851565b6060603d80546102f79061160d565b80601f01602080910402602001604051908101604052809291908181526020018280546103239061160d565b80156103705780601f1061034557610100808354040283529160200191610370565b820191906000526020600020905b81548152906001019060200180831161035357829003601f168201915b5050505050905090565b600080610385610ad1565b9050610392818585610ae0565b60019150505b92915050565b606060006103e187878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610c0592505050565b90506001600160e01b031960003581169082160361046c5760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f6400000060648201526084015b60405180910390fd5b604080516060810182526001600160a01b038a16600081815260066020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506104dd8982888888610c20565b6105335760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b6064820152608401610463565b600660008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d60405160200161058893929190611647565b60408051601f19818403018152908290526105a29161166d565b6000604051808303816000865af19150503d80600081146105df576040519150601f19603f3d011682016040523d82523d6000602084013e6105e4565b606091505b5091509150816106365760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c000000006044820152606401610463565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c60405161066b9493929190611689565b60405180910390a19a9950505050505050505050565b60008061068c610ad1565b9050610699858285610cfc565b6106a4858585610d76565b506001949350505050565b6000806106ba610ad1565b90506103928185856106cc8589610826565b6106d691906116d5565b610ae0565b606c546000906001600160a01b031633146107085760405162461bcd60e51b8152600401610463906116f6565b6107128383610f0f565b50600192915050565b6060603e80546102f79061160d565b33600090815260066020526040812080548392906107499084906116d5565b909155505050565b606c546000906001600160a01b0316331461077e5760405162461bcd60e51b8152600401610463906116f6565b6107128383610fbf565b600080610793610ad1565b905060006107a18286610826565b9050838110156108015760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610463565b6106a48286868403610ae0565b600080610819610ad1565b9050610392818585610d76565b6001600160a01b039182166000908152603b6020908152604080832093909416825291909152205490565b600754610100900460ff16158080156108715750600754600160ff909116105b8061088b5750303b15801561088b575060075460ff166001145b6108ee5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610463565b6007805460ff191660011790558015610911576007805461ff0019166101001790555b6001600160a01b0387161580159061092857508415155b801561093357508215155b61097f5760405162461bcd60e51b815260206004820152601e60248201527f4368696c6445524332303a204241445f494e495449414c495a4154494f4e00006044820152606401610463565b606d805460ff8416600160a01b026001600160a81b03199091166001600160a01b038a1617179055606c80546001600160a01b03191633179055604080516020601f8801819004810282018101909252868152610a2a91889088908190840183828082843760009201919091525050604080516020601f8a0181900481028201810190925288815292508891508790819084018382808284376000920191909152506110de92505050565b610a8286868080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506040805180820190915260018152603160f81b6020820152915061110f9050565b8015610ac8576007805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050565b6000610adb61117b565b905090565b6001600160a01b038316610b425760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610463565b6001600160a01b038216610ba35760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610463565b6001600160a01b038381166000818152603b602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b60008151600003610c1857506000919050565b506020015190565b6000806001610c36610c31886111d7565b611254565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015610c84573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116610cdb5760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b6044820152606401610463565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6000610d088484610826565b90506000198114610d705781811015610d635760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610463565b610d708484848403610ae0565b50505050565b6001600160a01b038316610dda5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610463565b6001600160a01b038216610e3c5760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610463565b6001600160a01b0383166000908152603a602052604090205481811015610eb45760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610463565b6001600160a01b038085166000818152603a602052604080822086860390559286168082529083902080548601905591516000805160206118ec83398151915290610f029086815260200190565b60405180910390a3610d70565b6001600160a01b038216610f655760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610463565b80603c6000828254610f7791906116d5565b90915550506001600160a01b0382166000818152603a60209081526040808320805486019055518481526000805160206118ec833981519152910160405180910390a35b5050565b6001600160a01b03821661101f5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610463565b6001600160a01b0382166000908152603a6020526040902054818110156110935760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610463565b6001600160a01b0383166000818152603a602090815260408083208686039055603c80548790039055518581529192916000805160206118ec8339815191529101610bf8565b505050565b600754610100900460ff166111055760405162461bcd60e51b815260040161046390611739565b610fbb82826112a2565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f61115d8184846112e2565b600055600280546001600160a01b0319163017905560055550505050565b60003033036111d157600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506111d49050565b50335b90565b60006040518060800160405280604381526020016118a96043913980516020918201208351848301516040808701518051908601209051611237950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b600061039861126161132b565b8360405161190160f01b6020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b600754610100900460ff166112c95760405162461bcd60e51b815260040161046390611739565b603d6112d583826117e8565b50603e6110d982826117e8565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b6002546000906001600160a01b031630148015611349575060015446145b15611355575060005490565b610adb6005546003546004546112e2565b60005b83811015611381578181015183820152602001611369565b50506000910152565b600081518084526113a2816020860160208601611366565b601f01601f19169290920160200192915050565b6020815260006113c9602083018461138a565b9392505050565b80356001600160a01b03811681146113e757600080fd5b919050565b600080604083850312156113ff57600080fd5b611408836113d0565b946020939093013593505050565b60008083601f84011261142857600080fd5b50813567ffffffffffffffff81111561144057600080fd5b60208301915083602082850101111561145857600080fd5b9250929050565b803560ff811681146113e757600080fd5b60008060008060008060a0878903121561148957600080fd5b611492876113d0565b9550602087013567ffffffffffffffff8111156114ae57600080fd5b6114ba89828a01611416565b90965094505060408701359250606087013591506114da6080880161145f565b90509295509295509295565b6000806000606084860312156114fb57600080fd5b611504846113d0565b9250611512602085016113d0565b9150604084013590509250925092565b60006020828403121561153457600080fd5b6113c9826113d0565b60006020828403121561154f57600080fd5b5035919050565b6000806040838503121561156957600080fd5b611572836113d0565b9150611580602084016113d0565b90509250929050565b600080600080600080608087890312156115a257600080fd5b6115ab876113d0565b9550602087013567ffffffffffffffff808211156115c857600080fd5b6115d48a838b01611416565b909750955060408901359150808211156115ed57600080fd5b506115fa89828a01611416565b90945092506114da90506060880161145f565b600181811c9082168061162157607f821691505b60208210810361164157634e487b7160e01b600052602260045260246000fd5b50919050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b6000825161167f818460208701611366565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b8082018082111561039857634e487b7160e01b600052601160045260246000fd5b60208082526023908201527f4368696c6445524332303a204f6e6c79207072656469636174652063616e2063604082015262185b1b60ea1b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f8211156110d957600081815260208120601f850160051c810160208610156117c15750805b601f850160051c820191505b818110156117e0578281556001016117cd565b505050505050565b815167ffffffffffffffff81111561180257611802611784565b61181681611810845461160d565b8461179a565b602080601f83116001811461184b57600084156118335750858301515b600019600386901b1c1916600185901b1785556117e0565b600085815260208120601f198616915b8281101561187a5788860151825594840194600190910190840161185b565b50858210156118985787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fe4d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa264697066735822122061cd8aae15b13c732c17323e6cfe2f585db1ab74b2c3384cbb12626088d7caa964736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001004": { - "code": "0x608060405234801561001057600080fd5b50600436106101165760003560e01c806397e5230d116100a2578063d41f177111610071578063d41f17711461023d578063e0563ab114610264578063eeb499451461026d578063f3fef3a314610280578063f64512551461029357600080fd5b806397e5230d146101e6578063b1768065146101f0578063b68ad1e414610217578063c3b35a7e1461022a57600080fd5b80633b878c22116100e95780633b878c221461017c57806351351d531461018557806371cf93b7146101935780637efab4f5146101a6578063947287cf146101cf57600080fd5b806305dc2e8f1461011b5780631459457a1461014b5780631bc114ba14610160578063284017f514610173575b600080fd5b60345461012e906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b61015e610159366004610f98565b6102ba565b005b60335461012e906001600160a01b031681565b61012e61202081565b61012e61101081565b61012e6002600160a01b0381565b60355461012e906001600160a01b031681565b61012e6101b4366004611009565b6037602052600090815260409020546001600160a01b031681565b6101d861520881565b604051908152602001610142565b6101d8620249f081565b6101d87f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60365461012e906001600160a01b031681565b61015e61023836600461102d565b61055a565b6101d87f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61012e61203081565b61015e61027b36600461106e565b61056a565b61015e61028e3660046110f7565b61073e565b6101d87f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b336002600160a01b03146103035760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b600054610100900460ff16158080156103235750600054600160ff909116105b8061033d5750303b15801561033d575060005460ff166001145b6103a05760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016102fa565b6000805460ff1916600117905580156103c3576000805461ff0019166101001790555b6001600160a01b038616158015906103e357506001600160a01b03851615155b80156103f757506001600160a01b03841615155b801561040b57506001600160a01b03831615155b6104675760405162461bcd60e51b815260206004820152602760248201527f4368696c6445524332305072656469636174653a204241445f494e495449414c60448201526624ad20aa24a7a760c91b60648201526084016102fa565b603380546001600160a01b03199081166001600160a01b03898116919091179092556034805482168884161790556035805482168784161790556036805490911685831617905582161561050c576001600160a01b03821660008181526037602052604080822080546001600160a01b03191661101090811790915590519092917f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d91a35b8015610552576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b61056583838361074d565b505050565b6034546001600160a01b031633146105d55760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f53544154455f6044820152672922a1a2a4ab22a960c11b60648201526084016102fa565b6035546001600160a01b038481169116146106435760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f524f4f545f50604482015267524544494341544560c01b60648201526084016102fa565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f821610672602060008486611123565b61067b9161114d565b0361069a576106956106908260208186611123565b610ac3565b610738565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6106c9602060008486611123565b6106d29161114d565b036106e1576106958282610d6e565b60405162461bcd60e51b815260206004820152602660248201527f4368696c6445524332305072656469636174653a20494e56414c49445f5349476044820152654e415455524560d01b60648201526084016102fa565b50505050565b61074982338361074d565b5050565b826001600160a01b03163b6000036107b15760405162461bcd60e51b815260206004820152602160248201527f4368696c6445524332305072656469636174653a204e4f545f434f4e545241436044820152601560fa1b60648201526084016102fa565b6000836001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107f1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610815919061116b565b6001600160a01b038181166000908152603760205260409020549192508581169116146108545760405162461bcd60e51b81526004016102fa90611188565b6001600160a01b03811661086a5761086a6111cb565b306001600160a01b0316846001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156108b2573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906108d6919061116b565b6001600160a01b0316146108ec576108ec6111cb565b604051632770a7eb60e21b81526001600160a01b03851690639dc29fac9061091a90339086906004016111e1565b6020604051808303816000875af1158015610939573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061095d91906111fa565b6109a95760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204255524e5f4641494c454460448201526064016102fa565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610a349391169160c401611262565b600060405180830381600087803b158015610a4e57600080fd5b505af1158015610a62573d6000803e3d6000fd5b50505050826001600160a01b0316846001600160a01b0316826001600160a01b03167fa0923f060a16fc784558d43de424ffde7b01643de5e5d335851b9df94c76bb273386604051610ab59291906111e1565b60405180910390a450505050565b6000808080610ad48587018761128e565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610b175760405162461bcd60e51b81526004016102fa90611188565b806001600160a01b03163b600003610b3157610b316111cb565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b71573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b95919061116b565b9050856001600160a01b0316816001600160a01b031614610bb857610bb86111cb565b6001600160a01b038116610bce57610bce6111cb565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c16573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c3a919061116b565b6001600160a01b031614610c5057610c506111cb565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610c7e90879087906004016111e1565b6020604051808303816000875af1158015610c9d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610cc191906111fa565b610d0d5760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204d494e545f4641494c454460448201526064016102fa565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fdf34f3a3ed8bedc14a4b284ebaee5374d55b64bac6a84c270dabe8fd6b4cdafd8887604051610d5c9291906111e1565b60405180910390a45050505050505050565b6000808080610d7f85870187611382565b92975090955093509150506001600160a01b038416610da057610da06111cb565b6001600160a01b038481166000908152603760205260409020541615610dc857610dc86111cb565b6036546040516bffffffffffffffffffffffff19606087901b166020820152600091610e18916001600160a01b039091169060340160405160208183030381529060405280519060200120610ee3565b6001600160a01b038681166000908152603760205260409081902080546001600160a01b031916928416928317905551637b69774360e11b81529192509063f6d2ee8690610e7090889088908890889060040161140f565b600060405180830381600087803b158015610e8a57600080fd5b505af1158015610e9e573d6000803e3d6000fd5b50506040516001600160a01b038085169350881691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a350505050505050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116610f7a5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016102fa565b92915050565b6001600160a01b0381168114610f9557600080fd5b50565b600080600080600060a08688031215610fb057600080fd5b8535610fbb81610f80565b94506020860135610fcb81610f80565b93506040860135610fdb81610f80565b92506060860135610feb81610f80565b91506080860135610ffb81610f80565b809150509295509295909350565b60006020828403121561101b57600080fd5b813561102681610f80565b9392505050565b60008060006060848603121561104257600080fd5b833561104d81610f80565b9250602084013561105d81610f80565b929592945050506040919091013590565b6000806000806060858703121561108457600080fd5b84359350602085013561109681610f80565b9250604085013567ffffffffffffffff808211156110b357600080fd5b818701915087601f8301126110c757600080fd5b8135818111156110d657600080fd5b8860208285010111156110e857600080fd5b95989497505060200194505050565b6000806040838503121561110a57600080fd5b823561111581610f80565b946020939093013593505050565b6000808585111561113357600080fd5b8386111561114057600080fd5b5050820193919092039150565b80356020831015610f7a57600019602084900360031b1b1692915050565b60006020828403121561117d57600080fd5b815161102681610f80565b60208082526023908201527f4368696c6445524332305072656469636174653a20554e4d41505045445f544f60408201526225a2a760e91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b60006020828403121561120c57600080fd5b8151801515811461102657600080fd5b6000815180845260005b8181101561124257602081850181015186830182015201611226565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b03831681526040602082018190526000906112869083018461121c565b949350505050565b600080600080608085870312156112a457600080fd5b84356112af81610f80565b935060208501356112bf81610f80565b925060408501356112cf81610f80565b9396929550929360600135925050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261130657600080fd5b813567ffffffffffffffff80821115611321576113216112df565b604051601f8301601f19908116603f01168101908282118183101715611349576113496112df565b8160405283815286602085880101111561136257600080fd5b836020870160208301376000602085830101528094505050505092915050565b600080600080600060a0868803121561139a57600080fd5b8535945060208601356113ac81610f80565b9350604086013567ffffffffffffffff808211156113c957600080fd5b6113d589838a016112f5565b945060608801359150808211156113eb57600080fd5b506113f8888289016112f5565b925050608086013560ff81168114610ffb57600080fd5b6001600160a01b03851681526080602082018190526000906114339083018661121c565b8281036040840152611445818661121c565b91505060ff831660608301529594505050505056fea2646970667358221220040c22d73fe8215d2218893f5a7f6ab5ca23133aaf1f7ef7a037b72f1d8fea6d64736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001005": { - "code": "0x608060405234801561001057600080fd5b506004361061014d5760003560e01c806370a08231116100c3578063a22cb4651161007c578063a22cb465146102dd578063b2dc5dc3146102f0578063b88d4fde14610303578063c87b56dd14610316578063e619870514610329578063e985e9c51461033a57600080fd5b806370a08231146102765780637c88e3d914610289578063906571471461029c57806395d89b41146102af5780639b77ef11146102b75780639dc29fac146102ca57600080fd5b80631f2d0065116101155780631f2d0065146101e257806323b872dd146101f35780632d0335ab1461020657806340c10f191461023d57806342842e0e146102505780636352211e1461026357600080fd5b806301ffc9a71461015257806306fdde031461017a578063081812fc1461018f578063095ea7b3146101ba5780630c53c51c146101cf575b600080fd5b610165610160366004611a8c565b61034d565b60405190151581526020015b60405180910390f35b61018261039f565b6040516101719190611af9565b6101a261019d366004611b0c565b610431565b6040516001600160a01b039091168152602001610171565b6101cd6101c8366004611b41565b610458565b005b6101826101dd366004611bb3565b610584565b609f546001600160a01b03166101a2565b6101cd610201366004611c32565b610862565b61022f610214366004611c6e565b6001600160a01b031660009081526006602052604090205490565b604051908152602001610171565b61016561024b366004611b41565b61089a565b6101cd61025e366004611c32565b6108da565b6101a2610271366004611b0c565b6108f5565b61022f610284366004611c6e565b61092a565b610165610297366004611ccd565b6109b0565b6101cd6102aa366004611d38565b610a97565b610182610d05565b6101cd6102c5366004611b0c565b610d14565b6101656102d8366004611b41565b610d3b565b6101cd6102eb366004611db8565b610daa565b6101656102fe366004611df4565b610dc0565b6101cd610311366004611e5c565b610e6d565b610182610324366004611b0c565b610eac565b609e546001600160a01b03166101a2565b610165610348366004611f37565b610f20565b60006001600160e01b031982166380ac58cd60e01b148061037e57506001600160e01b03198216635b5e139f60e01b145b8061039957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6060606c80546103ae90611f6a565b80601f01602080910402602001604051908101604052809291908181526020018280546103da90611f6a565b80156104275780601f106103fc57610100808354040283529160200191610427565b820191906000526020600020905b81548152906001019060200180831161040a57829003601f168201915b5050505050905090565b600061043c82610f4e565b506000908152607060205260409020546001600160a01b031690565b6000610463826108f5565b9050806001600160a01b0316836001600160a01b0316036104d55760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084015b60405180910390fd5b806001600160a01b03166104e7610f76565b6001600160a01b03161480610503575061050381610348610f76565b6105755760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c00000060648201526084016104cc565b61057f8383610f85565b505050565b606060006105c787878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610ff392505050565b90506001600160e01b031960003581169082160361064d5760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f6400000060648201526084016104cc565b604080516060810182526001600160a01b038a16600081815260066020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506106be898288888861100e565b6107145760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b60648201526084016104cc565b600660008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d60405160200161076993929190611fa4565b60408051601f198184030181529082905261078391611fca565b6000604051808303816000865af19150503d80600081146107c0576040519150601f19603f3d011682016040523d82523d6000602084013e6107c5565b606091505b5091509150816108175760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c0000000060448201526064016104cc565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c60405161084c9493929190611fe6565b60405180910390a19a9950505050505050505050565b61087361086d610f76565b826110ea565b61088f5760405162461bcd60e51b81526004016104cc90612032565b61057f838383611148565b609e546000906001600160a01b031633146108c75760405162461bcd60e51b81526004016104cc9061207f565b6108d1838361129a565b50600192915050565b61057f83838360405180602001604052806000815250610e6d565b6000818152606e60205260408120546001600160a01b0316806103995760405162461bcd60e51b81526004016104cc906120c3565b60006001600160a01b0382166109945760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b60648201526084016104cc565b506001600160a01b03166000908152606f602052604090205490565b609e546000906001600160a01b031633146109dd5760405162461bcd60e51b81526004016104cc9061207f565b83828114610a2d5760405162461bcd60e51b815260206004820152601f60248201527f4368696c644552433732313a204172726179206c656e206d69736d617463680060448201526064016104cc565b60005b81811015610a8857610a80878783818110610a4d57610a4d6120f5565b9050602002016020810190610a629190611c6e565b868684818110610a7457610a746120f5565b9050602002013561129a565b600101610a30565b5060019150505b949350505050565b600754610100900460ff1615808015610ab75750600754600160ff909116105b80610ad15750303b158015610ad1575060075460ff166001145b610b345760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016104cc565b6007805460ff191660011790558015610b57576007805461ff0019166101001790555b6001600160a01b03861615801590610b6e57508315155b8015610b7957508115155b610bc55760405162461bcd60e51b815260206004820152601f60248201527f4368696c644552433732313a2042616420696e697469616c697a6174696f6e0060448201526064016104cc565b609f80546001600160a01b0388166001600160a01b031991821617909155609e805490911633179055604080516020601f8701819004810282018101909252858152610c5f91879087908190840183828082843760009201919091525050604080516020601f890181900481028201810190925287815292508791508690819084018382808284376000920191909152506112b492505050565b610cb785858080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506040805180820190915260018152603160f81b602082015291506112e59050565b8015610cfd576007805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b6060606d80546103ae90611f6a565b3360009081526006602052604081208054839290610d3390849061210b565b909155505050565b609e546000906001600160a01b03163314610d685760405162461bcd60e51b81526004016104cc9061207f565b610d71826108f5565b6001600160a01b0316836001600160a01b031614610da15760405162461bcd60e51b81526004016104cc9061212c565b6108d182611351565b610dbc610db5610f76565b83836113d4565b5050565b609e546000906001600160a01b03163314610ded5760405162461bcd60e51b81526004016104cc9061207f565b8160005b81811015610e61576000858583818110610e0d57610e0d6120f5565b905060200201359050610e1f816108f5565b6001600160a01b0316876001600160a01b031614610e4f5760405162461bcd60e51b81526004016104cc9061212c565b610e5881611351565b50600101610df1565b50600195945050505050565b610e7e610e78610f76565b836110ea565b610e9a5760405162461bcd60e51b81526004016104cc90612032565b610ea68484848461149e565b50505050565b6060610eb782610f4e565b6000610ece60408051602081019091526000815290565b90506000815111610eee5760405180602001604052806000815250610f19565b80610ef8846114d1565b604051602001610f09929190612161565b6040516020818303038152906040525b9392505050565b6001600160a01b03918216600090815260716020908152604080832093909416825291909152205460ff1690565b610f5781611563565b610f735760405162461bcd60e51b81526004016104cc906120c3565b50565b6000610f80611580565b905090565b600081815260706020526040902080546001600160a01b0319166001600160a01b0384169081179091558190610fba826108f5565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000815160000361100657506000919050565b506020015190565b600080600161102461101f886115dc565b611659565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015611072573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166110c95760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b60448201526064016104cc565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6000806110f6836108f5565b9050806001600160a01b0316846001600160a01b0316148061111d575061111d8185610f20565b80610a8f5750836001600160a01b031661113684610431565b6001600160a01b031614949350505050565b826001600160a01b031661115b826108f5565b6001600160a01b0316146111815760405162461bcd60e51b81526004016104cc90612190565b6001600160a01b0382166111e35760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b60648201526084016104cc565b826001600160a01b03166111f6826108f5565b6001600160a01b03161461121c5760405162461bcd60e51b81526004016104cc90612190565b600081815260706020908152604080832080546001600160a01b03199081169091556001600160a01b03878116808652606f8552838620805460001901905590871680865283862080546001019055868652606e909452828520805490921684179091559051849360008051602061244c83398151915291a4505050565b610dbc8282604051806020016040528060008152506116a7565b600754610100900460ff166112db5760405162461bcd60e51b81526004016104cc906121d5565b610dbc82826116da565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f61133381848461171a565b600055600280546001600160a01b0319163017905560055550505050565b600061135c826108f5565b9050611367826108f5565b600083815260706020908152604080832080546001600160a01b03199081169091556001600160a01b038516808552606f84528285208054600019019055878552606e9093528184208054909116905551929350849260008051602061244c833981519152908390a45050565b816001600160a01b0316836001600160a01b0316036114315760405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b60448201526064016104cc565b6001600160a01b03838116600081815260716020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6114a9848484611148565b6114b584848484611763565b610ea65760405162461bcd60e51b81526004016104cc90612220565b606060006114de83611868565b60010190506000816001600160401b038111156114fd576114fd611e46565b6040519080825280601f01601f191660200182016040528015611527576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461153157509392505050565b6000908152606e60205260409020546001600160a01b0316151590565b60003033036115d657600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506115d99050565b50335b90565b6000604051806080016040528060438152602001612409604391398051602091820120835184830151604080870151805190860120905161163c950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b6000610399611666611940565b8360405161190160f01b6020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b6116b1838361197b565b6116be6000848484611763565b61057f5760405162461bcd60e51b81526004016104cc90612220565b600754610100900460ff166117015760405162461bcd60e51b81526004016104cc906121d5565b606c61170d83826122b8565b50606d61057f82826122b8565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b60006001600160a01b0384163b1561186057836001600160a01b031663150b7a0261178c610f76565b8786866040518563ffffffff1660e01b81526004016117ae9493929190612377565b6020604051808303816000875af19250505080156117e9575060408051601f3d908101601f191682019092526117e6918101906123b4565b60015b611846573d808015611817576040519150601f19603f3d011682016040523d82523d6000602084013e61181c565b606091505b50805160000361183e5760405162461bcd60e51b81526004016104cc90612220565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050610a8f565b506001610a8f565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b83106118a75772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef810000000083106118d3576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc1000083106118f157662386f26fc10000830492506010015b6305f5e1008310611909576305f5e100830492506008015b612710831061191d57612710830492506004015b6064831061192f576064830492506002015b600a83106103995760010192915050565b6002546000906001600160a01b03163014801561195e575060015446145b1561196a575060005490565b610f8060055460035460045461171a565b6001600160a01b0382166119d15760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f206164647265737360448201526064016104cc565b6119da81611563565b156119f75760405162461bcd60e51b81526004016104cc906123d1565b611a0081611563565b15611a1d5760405162461bcd60e51b81526004016104cc906123d1565b6001600160a01b0382166000818152606f6020908152604080832080546001019055848352606e90915280822080546001600160a01b03191684179055518392919060008051602061244c833981519152908290a45050565b6001600160e01b031981168114610f7357600080fd5b600060208284031215611a9e57600080fd5b8135610f1981611a76565b60005b83811015611ac4578181015183820152602001611aac565b50506000910152565b60008151808452611ae5816020860160208601611aa9565b601f01601f19169290920160200192915050565b602081526000610f196020830184611acd565b600060208284031215611b1e57600080fd5b5035919050565b80356001600160a01b0381168114611b3c57600080fd5b919050565b60008060408385031215611b5457600080fd5b611b5d83611b25565b946020939093013593505050565b60008083601f840112611b7d57600080fd5b5081356001600160401b03811115611b9457600080fd5b602083019150836020828501011115611bac57600080fd5b9250929050565b60008060008060008060a08789031215611bcc57600080fd5b611bd587611b25565b955060208701356001600160401b03811115611bf057600080fd5b611bfc89828a01611b6b565b9096509450506040870135925060608701359150608087013560ff81168114611c2457600080fd5b809150509295509295509295565b600080600060608486031215611c4757600080fd5b611c5084611b25565b9250611c5e60208501611b25565b9150604084013590509250925092565b600060208284031215611c8057600080fd5b610f1982611b25565b60008083601f840112611c9b57600080fd5b5081356001600160401b03811115611cb257600080fd5b6020830191508360208260051b8501011115611bac57600080fd5b60008060008060408587031215611ce357600080fd5b84356001600160401b0380821115611cfa57600080fd5b611d0688838901611c89565b90965094506020870135915080821115611d1f57600080fd5b50611d2c87828801611c89565b95989497509550505050565b600080600080600060608688031215611d5057600080fd5b611d5986611b25565b945060208601356001600160401b0380821115611d7557600080fd5b611d8189838a01611b6b565b90965094506040880135915080821115611d9a57600080fd5b50611da788828901611b6b565b969995985093965092949392505050565b60008060408385031215611dcb57600080fd5b611dd483611b25565b915060208301358015158114611de957600080fd5b809150509250929050565b600080600060408486031215611e0957600080fd5b611e1284611b25565b925060208401356001600160401b03811115611e2d57600080fd5b611e3986828701611c89565b9497909650939450505050565b634e487b7160e01b600052604160045260246000fd5b60008060008060808587031215611e7257600080fd5b611e7b85611b25565b9350611e8960208601611b25565b92506040850135915060608501356001600160401b0380821115611eac57600080fd5b818701915087601f830112611ec057600080fd5b813581811115611ed257611ed2611e46565b604051601f8201601f19908116603f01168101908382118183101715611efa57611efa611e46565b816040528281528a6020848701011115611f1357600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b60008060408385031215611f4a57600080fd5b611f5383611b25565b9150611f6160208401611b25565b90509250929050565b600181811c90821680611f7e57607f821691505b602082108103611f9e57634e487b7160e01b600052602260045260246000fd5b50919050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b60008251611fdc818460208701611aa9565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b6020808252602d908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526c1c881bdc88185c1c1c9bdd9959609a1b606082015260800190565b60208082526024908201527f4368696c644552433732313a204f6e6c79207072656469636174652063616e2060408201526318d85b1b60e21b606082015260800190565b602080825260189082015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604082015260600190565b634e487b7160e01b600052603260045260246000fd5b8082018082111561039957634e487b7160e01b600052601160045260246000fd5b6020808252818101527f4368696c644552433732313a204f6e6c79206f776e65722063616e206275726e604082015260600190565b60008351612173818460208801611aa9565b835190830190612187818360208801611aa9565b01949350505050565b60208082526025908201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060408201526437bbb732b960d91b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b601f82111561057f57600081815260208120601f850160051c810160208610156122995750805b601f850160051c820191505b81811015610cfd578281556001016122a5565b81516001600160401b038111156122d1576122d1611e46565b6122e5816122df8454611f6a565b84612272565b602080601f83116001811461231a57600084156123025750858301515b600019600386901b1c1916600185901b178555610cfd565b600085815260208120601f198616915b828110156123495788860151825594840194600190910190840161232a565b50858210156123675787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b03858116825284166020820152604081018390526080606082018190526000906123aa90830184611acd565b9695505050505050565b6000602082840312156123c657600080fd5b8151610f1981611a76565b6020808252601c908201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060408201526060019056fe4d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220ea3c02b950248f82ca74449c170966a8d3ba41ec46257d49989e4be74e94e63864736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001006": { - "code": "0x608060405234801561001057600080fd5b50600436106101375760003560e01c8063b68ad1e4116100b8578063e0563ab11161007c578063e0563ab1146102c0578063eeb49945146102c9578063f3fef3a3146102dc578063f6451255146102ef578063f691325c14610316578063f8c8765e1461032957600080fd5b8063b68ad1e414610225578063c3b35a7e14610238578063c5ac2b1c1461024b578063d41f177114610272578063d7c9e3ec1461029957600080fd5b80636f33e695116100ff5780636f33e6951461019f5780637efab4f5146101b4578063947287cf146101dd57806397e5230d146101f4578063b1768065146101fe57600080fd5b806305dc2e8f1461013c5780631bc114ba1461016c578063284017f51461017f5780633b878c221461018857806351351d5314610191575b600080fd5b60345461014f906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b60335461014f906001600160a01b031681565b61014f61202081565b61014f61101081565b61014f6002600160a01b0381565b6101b26101ad366004611617565b61033c565b005b61014f6101c2366004611699565b6037602052600090815260409020546001600160a01b031681565b6101e661520881565b604051908152602001610163565b6101e6620249f081565b6101e67f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60365461014f906001600160a01b031681565b6101b26102463660046116bd565b610350565b6101e67faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6101e67f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101e67f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61014f61203081565b6101b26102d73660046116fe565b610360565b6101b26102ea366004611786565b610583565b6101e67f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b60355461014f906001600160a01b031681565b6101b26103373660046117b2565b610592565b61034985858585856107d1565b5050505050565b61035b838383610b35565b505050565b6034546001600160a01b031633146103d15760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f53544154456044820152682fa922a1a2a4ab22a960b91b60648201526084015b60405180910390fd5b6035546001600160a01b038481169116146104405760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f524f4f545f60448201526850524544494341544560b81b60648201526084016103c8565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82161046f60206000848661180e565b61047891611838565b036104975761049261048d826020818661180e565b610e3e565b61057d565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d186104c660206000848661180e565b6104cf91611838565b036104de5761049282826110b4565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61050d60206000848661180e565b61051691611838565b0361052557610492828261131a565b60405162461bcd60e51b815260206004820152602760248201527f4368696c644552433732315072656469636174653a20494e56414c49445f5349604482015266474e415455524560c81b60648201526084016103c8565b50505050565b61058e823383610b35565b5050565b336002600160a01b03146105d65760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016103c8565b600054610100900460ff16158080156105f65750600054600160ff909116105b806106105750303b158015610610575060005460ff166001145b6106735760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103c8565b6000805460ff191660011790558015610696576000805461ff0019166101001790555b6001600160a01b038516158015906106b657506001600160a01b03841615155b80156106ca57506001600160a01b03831615155b80156106de57506001600160a01b03821615155b61073b5760405162461bcd60e51b815260206004820152602860248201527f4368696c644552433732315072656469636174653a204241445f494e495449416044820152672624ad20aa24a7a760c11b60648201526084016103c8565b603380546001600160a01b038088166001600160a01b031992831617909255603480548784169083161790556035805486841690831617905560368054928516929091169190911790558015610349576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b846107db81611488565b6107f75760405162461bcd60e51b81526004016103c890611856565b6000866001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610837573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061085b9190611898565b6001600160a01b0381811660009081526037602052604090205491925088811691161461089a5760405162461bcd60e51b81526004016103c8906118b5565b6001600160a01b0381166108b0576108b06118f9565b306001600160a01b0316876001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156108f8573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061091c9190611898565b6001600160a01b031614610932576109326118f9565b84831461098d5760405162461bcd60e51b8152602060048201526024808201527f4368696c644552433732315072656469636174653a20494e56414c49445f4c4560448201526309c8ea8960e31b60648201526084016103c8565b60405163b2dc5dc360e01b81526001600160a01b0388169063b2dc5dc3906109bd90339088908890600401611941565b6020604051808303816000875af11580156109dc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a00919061196f565b610a1c5760405162461bcd60e51b81526004016103c890611991565b6033546035546040516001600160a01b03928316926316f19831921690610a73907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908d908d908d908d90602001611a1b565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610a9f929190611ab5565b600060405180830381600087803b158015610ab957600080fd5b505af1158015610acd573d6000803e3d6000fd5b50505050336001600160a01b0316876001600160a01b0316826001600160a01b03167fa80bc76d6e1849a9088a9c00a2aeaa54eeb78f15565a18da3e8873438976f52289898989604051610b249493929190611ae1565b60405180910390a450505050505050565b82610b3f81611488565b610b5b5760405162461bcd60e51b81526004016103c890611856565b6000846001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b9b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bbf9190611898565b6001600160a01b03818116600090815260376020526040902054919250868116911614610bfe5760405162461bcd60e51b81526004016103c8906118b5565b6001600160a01b038116610c1457610c146118f9565b306001600160a01b0316856001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c5c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c809190611898565b6001600160a01b031614610c9657610c966118f9565b604051632770a7eb60e21b81526001600160a01b03861690639dc29fac90610cc49033908790600401611b13565b6020604051808303816000875af1158015610ce3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d07919061196f565b610d235760405162461bcd60e51b81526004016103c890611991565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152888116608083015260a08083018990528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610dae9391169160c401611ab5565b600060405180830381600087803b158015610dc857600080fd5b505af1158015610ddc573d6000803e3d6000fd5b50505050836001600160a01b0316856001600160a01b0316826001600160a01b03167f1e0ef6131232b1090efc3ec1cf7b53aa17f4b7cd8a4f9e033b49ee237379b0133387604051610e2f929190611b13565b60405180910390a45050505050565b6000808080610e4f85870187611b2c565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610e925760405162461bcd60e51b81526004016103c8906118b5565b610e9b81611488565b610ea757610ea76118f9565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ee7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f0b9190611898565b9050856001600160a01b0316816001600160a01b031614610f2e57610f2e6118f9565b6001600160a01b038116610f4457610f446118f9565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f8c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fb09190611898565b6001600160a01b031614610fc657610fc66118f9565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610ff49087908790600401611b13565b6020604051808303816000875af1158015611013573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611037919061196f565b6110535760405162461bcd60e51b81526004016103c890611b7d565b836001600160a01b0316826001600160a01b0316876001600160a01b03167f37589fd8c906c19ea68eeb7e6b3e03efc06ff8aa4b1830588eba75f4375b161188876040516110a2929190611b13565b60405180910390a45050505050505050565b60008080806110c585870187611c92565b6001600160a01b0380851660009081526037602052604090205494995092975090955093501690508061110a5760405162461bcd60e51b81526004016103c8906118b5565b61111381611488565b61111f5761111f6118f9565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561115f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111839190611898565b9050856001600160a01b0316816001600160a01b0316146111a6576111a66118f9565b6001600160a01b0381166111bc576111bc6118f9565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015611204573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112289190611898565b6001600160a01b03161461123e5761123e6118f9565b604051637c88e3d960e01b81526001600160a01b03831690637c88e3d99061126c9087908790600401611d84565b6020604051808303816000875af115801561128b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112af919061196f565b6112cb5760405162461bcd60e51b81526004016103c890611b7d565b846001600160a01b0316826001600160a01b0316876001600160a01b03167fc1b1a5c1b97cc8e5ac82b47496f5ebdadf9c7d119b30a116e2bdafd56f6ed47587876040516110a2929190611d84565b6000808061132a84860186611e77565b91955093509150506001600160a01b038316611348576113486118f9565b6001600160a01b038381166000908152603760205260409020541615611370576113706118f9565b6036546040516bffffffffffffffffffffffff19606086901b1660208201526000916113c0916001600160a01b03909116906034016040516020818303038152906040528051906020012061151d565b6001600160a01b038581166000908152603760205260409081902080546001600160a01b031916928416928317905551639065714760e01b81529192509063906571479061141690879087908790600401611ef6565b600060405180830381600087803b15801561143057600080fd5b505af1158015611444573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a3505050505050565b6000816001600160a01b03163b6000036114a457506000919050565b6040516301ffc9a760e01b81526380ac58cd60e01b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa92505050801561150b575060408051601f3d908101601f191682019092526115089181019061196f565b60015b61151757506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b0381166115175760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016103c8565b6001600160a01b03811681146115c957600080fd5b50565b60008083601f8401126115de57600080fd5b5081356001600160401b038111156115f557600080fd5b6020830191508360208260051b850101111561161057600080fd5b9250929050565b60008060008060006060868803121561162f57600080fd5b853561163a816115b4565b945060208601356001600160401b038082111561165657600080fd5b61166289838a016115cc565b9096509450604088013591508082111561167b57600080fd5b50611688888289016115cc565b969995985093965092949392505050565b6000602082840312156116ab57600080fd5b81356116b6816115b4565b9392505050565b6000806000606084860312156116d257600080fd5b83356116dd816115b4565b925060208401356116ed816115b4565b929592945050506040919091013590565b6000806000806060858703121561171457600080fd5b843593506020850135611726816115b4565b925060408501356001600160401b038082111561174257600080fd5b818701915087601f83011261175657600080fd5b81358181111561176557600080fd5b88602082850101111561177757600080fd5b95989497505060200194505050565b6000806040838503121561179957600080fd5b82356117a4816115b4565b946020939093013593505050565b600080600080608085870312156117c857600080fd5b84356117d3816115b4565b935060208501356117e3816115b4565b925060408501356117f3816115b4565b91506060850135611803816115b4565b939692955090935050565b6000808585111561181e57600080fd5b8386111561182b57600080fd5b5050820193919092039150565b8035602083101561151757600019602084900360031b1b1692915050565b60208082526022908201527f4368696c644552433732315072656469636174653a204e4f545f434f4e54524160408201526110d560f21b606082015260800190565b6000602082840312156118aa57600080fd5b81516116b6816115b4565b60208082526024908201527f4368696c644552433732315072656469636174653a20554e4d41505045445f5460408201526327a5a2a760e11b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561192857600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b0384168152604060208201819052600090611966908301848661190f565b95945050505050565b60006020828403121561198157600080fd5b815180151581146116b657600080fd5b60208082526021908201527f4368696c644552433732315072656469636174653a204255524e5f4641494c456040820152601160fa1b606082015260800190565b8183526000602080850194508260005b85811015611a105781356119f5816115b4565b6001600160a01b0316875295820195908201906001016119e2565b509495945050505050565b8781526001600160a01b0387811660208301528616604082015260a060608201819052600090611a4e90830186886119d2565b8281036080840152611a6181858761190f565b9a9950505050505050505050565b6000815180845260005b81811015611a9557602081850181015186830182015201611a79565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611ad990830184611a6f565b949350505050565b604081526000611af56040830186886119d2565b8281036020840152611b0881858761190f565b979650505050505050565b6001600160a01b03929092168252602082015260400190565b60008060008060808587031215611b4257600080fd5b8435611b4d816115b4565b93506020850135611b5d816115b4565b92506040850135611b6d816115b4565b9396929550929360600135925050565b60208082526021908201527f4368696c644552433732315072656469636174653a204d494e545f4641494c456040820152601160fa1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611bfc57611bfc611bbe565b604052919050565b60006001600160401b03821115611c1d57611c1d611bbe565b5060051b60200190565b600082601f830112611c3857600080fd5b81356020611c4d611c4883611c04565b611bd4565b82815260059290921b84018101918181019086841115611c6c57600080fd5b8286015b84811015611c875780358352918301918301611c70565b509695505050505050565b600080600080600060a08688031215611caa57600080fd5b85359450602080870135611cbd816115b4565b94506040870135611ccd816115b4565b935060608701356001600160401b0380821115611ce957600080fd5b818901915089601f830112611cfd57600080fd5b8135611d0b611c4882611c04565b81815260059190911b8301840190848101908c831115611d2a57600080fd5b938501935b82851015611d51578435611d42816115b4565b82529385019390850190611d2f565b965050506080890135925080831115611d6957600080fd5b5050611d7788828901611c27565b9150509295509295909350565b604080825283519082018190526000906020906060840190828701845b82811015611dc65781516001600160a01b031684529284019290840190600101611da1565b5050508381038285015284518082528583019183019060005b81811015611dfb57835183529284019291840191600101611ddf565b5090979650505050505050565b600082601f830112611e1957600080fd5b81356001600160401b03811115611e3257611e32611bbe565b611e45601f8201601f1916602001611bd4565b818152846020838601011115611e5a57600080fd5b816020850160208301376000918101602001919091529392505050565b60008060008060808587031215611e8d57600080fd5b843593506020850135611e9f816115b4565b925060408501356001600160401b0380821115611ebb57600080fd5b611ec788838901611e08565b93506060870135915080821115611edd57600080fd5b50611eea87828801611e08565b91505092959194509250565b6001600160a01b0384168152606060208201819052600090611f1a90830185611a6f565b8281036040840152611f2c8185611a6f565b969550505050505056fea26469706673582212208eba5121cb4876752d628bd2b54f4310ad4179b29208ae7a3ec4d01fd9c07df564736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001007": { - "code": "0x608060405234801561001057600080fd5b50600436106101155760003560e01c806357128683116100a2578063e619870511610071578063e619870514610278578063e985e9c514610289578063f242432a146102c5578063f399e22e146102d8578063f5298aca146102eb57600080fd5b8063571286831461022c5780636b20c4541461023f5780639b77ef1114610252578063a22cb4651461026557600080fd5b8063156e29f6116100e9578063156e29f6146101965780631f2d0065146101a95780632d0335ab146101ce5780632eb2c2d6146101f75780634e1273f41461020c57600080fd5b8062fdd58e1461011a57806301ffc9a7146101405780630c53c51c146101635780630e89341c14610183575b600080fd5b61012d610128366004611cee565b6102fe565b6040519081526020015b60405180910390f35b61015361014e366004611d2e565b610399565b6040519015158152602001610137565b610176610171366004611d93565b6103e9565b6040516101379190611e62565b610176610191366004611e75565b6106c7565b6101536101a4366004611e8e565b61075b565b609f546001600160a01b03165b6040516001600160a01b039091168152602001610137565b61012d6101dc366004611ec1565b6001600160a01b031660009081526006602052604090205490565b61020a610205366004612025565b6107ad565b005b61021f61021a3660046120ce565b61080b565b60405161013791906121d3565b61015361023a36600461222a565b610934565b61015361024d3660046122c3565b610a4f565b61020a610260366004611e75565b610af6565b61020a610273366004612343565b610b1d565b609e546001600160a01b03166101b6565b61015361029736600461237f565b6001600160a01b039182166000908152606d6020908152604080832093909416825291909152205460ff1690565b61020a6102d33660046123b2565b610b33565b61020a6102e6366004612416565b610b8a565b6101536102f9366004611e8e565b610d9e565b60006001600160a01b03831661036e5760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b506000818152606c602090815260408083206001600160a01b03861684529091529020545b92915050565b60006001600160e01b03198216636cdb3d1360e11b14806103ca57506001600160e01b031982166303a24d0760e21b145b8061039357506301ffc9a760e01b6001600160e01b0319831614610393565b6060600061042c87878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610dd692505050565b90506001600160e01b03196000358116908216036104b25760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f640000006064820152608401610365565b604080516060810182526001600160a01b038a16600081815260066020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506105238982888888610df1565b6105795760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b6064820152608401610365565b600660008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d6040516020016105ce93929190612468565b60408051601f19818403018152908290526105e89161248e565b6000604051808303816000865af19150503d8060008114610625576040519150601f19603f3d011682016040523d82523d6000602084013e61062a565b606091505b50915091508161067c5760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c000000006044820152606401610365565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c6040516106b194939291906124aa565b60405180910390a19a9950505050505050505050565b6060606e80546106d6906124f6565b80601f0160208091040260200160405190810160405280929190818152602001828054610702906124f6565b801561074f5780601f106107245761010080835404028352916020019161074f565b820191906000526020600020905b81548152906001019060200180831161073257829003601f168201915b50505050509050919050565b609e546000906001600160a01b031633146107885760405162461bcd60e51b815260040161036590612530565b6107a384848460405180602001604052806000815250610ecd565b5060019392505050565b6107b5610fdc565b6001600160a01b0316856001600160a01b031614806107db57506107db85610297610fdc565b6107f75760405162461bcd60e51b815260040161036590612575565b6108048585858585610feb565b5050505050565b606081518351146108705760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b6064820152608401610365565b600083516001600160401b0381111561088b5761088b611edc565b6040519080825280602002602001820160405280156108b4578160200160208202803683370190505b50905060005b845181101561092c576108ff8582815181106108d8576108d86125c3565b60200260200101518583815181106108f2576108f26125c3565b60200260200101516102fe565b828281518110610911576109116125c3565b6020908102919091010152610925816125ef565b90506108ba565b509392505050565b609e546000906001600160a01b031633146109615760405162461bcd60e51b815260040161036590612530565b85848114801561097057508083145b6109bc5760405162461bcd60e51b815260206004820181905260248201527f4368696c64455243313135353a206172726179206c656e206d69736d617463686044820152606401610365565b60005b81811015610a4057610a388989838181106109dc576109dc6125c3565b90506020020160208101906109f19190611ec1565b888884818110610a0357610a036125c3565b90506020020135878785818110610a1c57610a1c6125c3565b9050602002013560405180602001604052806000815250610ecd565b6001016109bf565b50600198975050505050505050565b609e546000906001600160a01b03163314610a7c5760405162461bcd60e51b815260040161036590612530565b610aea8686868080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525050604080516020808a0282810182019093528982529093508992508891829185019084908082843760009201919091525061119592505050565b50600195945050505050565b3360009081526006602052604081208054839290610b15908490612608565b909155505050565b610b2f610b28610fdc565b838361132c565b5050565b610b3b610fdc565b6001600160a01b0316856001600160a01b03161480610b615750610b6185610297610fdc565b610b7d5760405162461bcd60e51b815260040161036590612575565b610804858585858561140c565b600754610100900460ff1615808015610baa5750600754600160ff909116105b80610bc45750303b158015610bc4575060075460ff166001145b610c275760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610365565b6007805460ff191660011790558015610c4a576007805461ff0019166101001790555b6001600160a01b038416610ca05760405162461bcd60e51b815260206004820181905260248201527f4368696c64455243313135353a204241445f494e495449414c495a4154494f4e6044820152606401610365565b609f80546001600160a01b0386166001600160a01b031991821617909155609e805490911633179055604080516020601f8501819004810282018101909252838152610d0691859085908190840183828082843760009201919091525061153392505050565b610d52610d1b856001600160a01b0316611566565b604051602001610d2b919061261b565b60408051601f1981840301815282820190915260018252603160f81b60208301529061157c565b8015610d98576007805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050565b609e546000906001600160a01b03163314610dcb5760405162461bcd60e51b815260040161036590612530565b6107a38484846115e8565b60008151600003610de957506000919050565b506020015190565b6000806001610e07610e02886116e8565b611765565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015610e55573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116610eac5760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b6044820152606401610365565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6001600160a01b038416610f2d5760405162461bcd60e51b815260206004820152602160248201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736044820152607360f81b6064820152608401610365565b6000610f37610fdc565b90506000610f44856117b3565b90506000610f51856117b3565b90506000868152606c602090815260408083206001600160a01b038b16845290915281208054879290610f85908490612608565b909155505060408051878152602081018790526001600160a01b03808a169260009291871691600080516020612b0c833981519152910160405180910390a4610fd3836000898989896117fe565b50505050505050565b6000610fe6611959565b905090565b815183511461100c5760405162461bcd60e51b815260040161036590612650565b6001600160a01b0384166110325760405162461bcd60e51b815260040161036590612698565b600061103c610fdc565b905060005b845181101561112757600085828151811061105e5761105e6125c3565b60200260200101519050600085838151811061107c5761107c6125c3565b6020908102919091018101516000848152606c835260408082206001600160a01b038e1683529093529190912054909150818110156110cd5760405162461bcd60e51b8152600401610365906126dd565b6000838152606c602090815260408083206001600160a01b038e8116855292528083208585039055908b1682528120805484929061110c908490612608565b9250508190555050505080611120906125ef565b9050611041565b50846001600160a01b0316866001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb8787604051611177929190612727565b60405180910390a461118d8187878787876119b5565b505050505050565b6001600160a01b0383166111bb5760405162461bcd60e51b815260040161036590612755565b80518251146111dc5760405162461bcd60e51b815260040161036590612650565b60006111e6610fdc565b604080516020810190915260009052905060005b83518110156112bf576000848281518110611217576112176125c3565b602002602001015190506000848381518110611235576112356125c3565b6020908102919091018101516000848152606c835260408082206001600160a01b038c1683529093529190912054909150818110156112865760405162461bcd60e51b815260040161036590612798565b6000928352606c602090815260408085206001600160a01b038b16865290915290922091039055806112b7816125ef565b9150506111fa565b5060006001600160a01b0316846001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb8686604051611310929190612727565b60405180910390a4604080516020810190915260009052610d98565b816001600160a01b0316836001600160a01b03160361139f5760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b6064820152608401610365565b6001600160a01b038381166000818152606d6020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6001600160a01b0384166114325760405162461bcd60e51b815260040161036590612698565b600061143c610fdc565b90506000611449856117b3565b90506000611456856117b3565b90506000868152606c602090815260408083206001600160a01b038c1684529091529020548581101561149b5760405162461bcd60e51b8152600401610365906126dd565b6000878152606c602090815260408083206001600160a01b038d8116855292528083208985039055908a168252812080548892906114da908490612608565b909155505060408051888152602081018890526001600160a01b03808b16928c82169291881691600080516020612b0c833981519152910160405180910390a4611528848a8a8a8a8a6117fe565b505050505050505050565b600754610100900460ff1661155a5760405162461bcd60e51b8152600401610365906127dc565b61156381611a70565b50565b60606103936001600160a01b0383166014611aa0565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f6115ca818484611c42565b600055600280546001600160a01b0319163017905560055550505050565b6001600160a01b03831661160e5760405162461bcd60e51b815260040161036590612755565b6000611618610fdc565b90506000611625846117b3565b90506000611632846117b3565b6040805160208082018352600091829052888252606c81528282206001600160a01b038b16835290522054909150848110156116805760405162461bcd60e51b815260040161036590612798565b6000868152606c602090815260408083206001600160a01b038b81168086529184528285208a8703905582518b81529384018a9052909290881691600080516020612b0c833981519152910160405180910390a4604080516020810190915260009052610fd3565b6000604051806080016040528060438152602001612b2c6043913980516020918201208351848301516040808701518051908601209051611748950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b6000610393611772611c8b565b8360405161190160f01b6020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b604080516001808252818301909252606091600091906020808301908036833701905050905082816000815181106117ed576117ed6125c3565b602090810291909101015292915050565b6001600160a01b0384163b1561118d5760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e61906118429089908990889088908890600401612827565b6020604051808303816000875af192505050801561187d575060408051601f3d908101601f1916820190925261187a9181019061286c565b60015b61192957611889612889565b806308c379a0036118c2575061189d6128a4565b806118a857506118c4565b8060405162461bcd60e51b81526004016103659190611e62565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b6064820152608401610365565b6001600160e01b0319811663f23a6e6160e01b14610fd35760405162461bcd60e51b81526004016103659061292d565b60003033036119af57600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506119b29050565b50335b90565b6001600160a01b0384163b1561118d5760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906119f99089908990889088908890600401612975565b6020604051808303816000875af1925050508015611a34575060408051601f3d908101601f19168201909252611a319181019061286c565b60015b611a4057611889612889565b6001600160e01b0319811663bc197c8160e01b14610fd35760405162461bcd60e51b81526004016103659061292d565b600754610100900460ff16611a975760405162461bcd60e51b8152600401610365906127dc565b61156381611cc6565b60606000611aaf8360026129d3565b611aba906002612608565b6001600160401b03811115611ad157611ad1611edc565b6040519080825280601f01601f191660200182016040528015611afb576020820181803683370190505b509050600360fc1b81600081518110611b1657611b166125c3565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110611b4557611b456125c3565b60200101906001600160f81b031916908160001a9053506000611b698460026129d3565b611b74906001612608565b90505b6001811115611bec576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110611ba857611ba86125c3565b1a60f81b828281518110611bbe57611bbe6125c3565b60200101906001600160f81b031916908160001a90535060049490941c93611be5816129ea565b9050611b77565b508315611c3b5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610365565b9392505050565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b6002546000906001600160a01b031630148015611ca9575060015446145b15611cb5575060005490565b610fe6600554600354600454611c42565b606e610b2f8282612a4c565b80356001600160a01b0381168114611ce957600080fd5b919050565b60008060408385031215611d0157600080fd5b611d0a83611cd2565b946020939093013593505050565b6001600160e01b03198116811461156357600080fd5b600060208284031215611d4057600080fd5b8135611c3b81611d18565b60008083601f840112611d5d57600080fd5b5081356001600160401b03811115611d7457600080fd5b602083019150836020828501011115611d8c57600080fd5b9250929050565b60008060008060008060a08789031215611dac57600080fd5b611db587611cd2565b955060208701356001600160401b03811115611dd057600080fd5b611ddc89828a01611d4b565b9096509450506040870135925060608701359150608087013560ff81168114611e0457600080fd5b809150509295509295509295565b60005b83811015611e2d578181015183820152602001611e15565b50506000910152565b60008151808452611e4e816020860160208601611e12565b601f01601f19169290920160200192915050565b602081526000611c3b6020830184611e36565b600060208284031215611e8757600080fd5b5035919050565b600080600060608486031215611ea357600080fd5b611eac84611cd2565b95602085013595506040909401359392505050565b600060208284031215611ed357600080fd5b611c3b82611cd2565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b0381118282101715611f1757611f17611edc565b6040525050565b60006001600160401b03821115611f3757611f37611edc565b5060051b60200190565b600082601f830112611f5257600080fd5b81356020611f5f82611f1e565b604051611f6c8282611ef2565b83815260059390931b8501820192828101915086841115611f8c57600080fd5b8286015b84811015611fa75780358352918301918301611f90565b509695505050505050565b600082601f830112611fc357600080fd5b81356001600160401b03811115611fdc57611fdc611edc565b604051611ff3601f8301601f191660200182611ef2565b81815284602083860101111561200857600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a0868803121561203d57600080fd5b61204686611cd2565b945061205460208701611cd2565b935060408601356001600160401b038082111561207057600080fd5b61207c89838a01611f41565b9450606088013591508082111561209257600080fd5b61209e89838a01611f41565b935060808801359150808211156120b457600080fd5b506120c188828901611fb2565b9150509295509295909350565b600080604083850312156120e157600080fd5b82356001600160401b03808211156120f857600080fd5b818501915085601f83011261210c57600080fd5b8135602061211982611f1e565b6040516121268282611ef2565b83815260059390931b850182019282810191508984111561214657600080fd5b948201945b8386101561216b5761215c86611cd2565b8252948201949082019061214b565b9650508601359250508082111561218157600080fd5b5061218e85828601611f41565b9150509250929050565b600081518084526020808501945080840160005b838110156121c8578151875295820195908201906001016121ac565b509495945050505050565b602081526000611c3b6020830184612198565b60008083601f8401126121f857600080fd5b5081356001600160401b0381111561220f57600080fd5b6020830191508360208260051b8501011115611d8c57600080fd5b6000806000806000806060878903121561224357600080fd5b86356001600160401b038082111561225a57600080fd5b6122668a838b016121e6565b9098509650602089013591508082111561227f57600080fd5b61228b8a838b016121e6565b909650945060408901359150808211156122a457600080fd5b506122b189828a016121e6565b979a9699509497509295939492505050565b6000806000806000606086880312156122db57600080fd5b6122e486611cd2565b945060208601356001600160401b038082111561230057600080fd5b61230c89838a016121e6565b9096509450604088013591508082111561232557600080fd5b50612332888289016121e6565b969995985093965092949392505050565b6000806040838503121561235657600080fd5b61235f83611cd2565b91506020830135801515811461237457600080fd5b809150509250929050565b6000806040838503121561239257600080fd5b61239b83611cd2565b91506123a960208401611cd2565b90509250929050565b600080600080600060a086880312156123ca57600080fd5b6123d386611cd2565b94506123e160208701611cd2565b9350604086013592506060860135915060808601356001600160401b0381111561240a57600080fd5b6120c188828901611fb2565b60008060006040848603121561242b57600080fd5b61243484611cd2565b925060208401356001600160401b0381111561244f57600080fd5b61245b86828701611d4b565b9497909650939450505050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b600082516124a0818460208701611e12565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b600181811c9082168061250a57607f821691505b60208210810361252a57634e487b7160e01b600052602260045260246000fd5b50919050565b60208082526025908201527f4368696c64455243313135353a204f6e6c79207072656469636174652063616e6040820152640818d85b1b60da1b606082015260800190565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b600060018201612601576126016125d9565b5060010190565b80820180821115610393576103936125d9565b6c4368696c64455243313135352d60981b81526000825161264381600d850160208701611e12565b91909101600d0192915050565b60208082526028908201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206040820152670dad2e6dac2e8c6d60c31b606082015260800190565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b60408152600061273a6040830185612198565b828103602084015261274c8185612198565b95945050505050565b60208082526023908201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260408201526265737360e81b606082015260800190565b60208082526024908201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604082015263616e636560e01b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061286190830184611e36565b979650505050505050565b60006020828403121561287e57600080fd5b8151611c3b81611d18565b600060033d11156119b25760046000803e5060005160e01c90565b600060443d10156128b25790565b6040516003193d81016004833e81513d6001600160401b0381602484011181841117156128e157505050505090565b82850191508151818111156128f95750505050505090565b843d87010160208285010111156129135750505050505090565b61292260208286010187611ef2565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b6001600160a01b0386811682528516602082015260a0604082018190526000906129a190830186612198565b82810360608401526129b38186612198565b905082810360808401526129c78185611e36565b98975050505050505050565b8082028115828204841417610393576103936125d9565b6000816129f9576129f96125d9565b506000190190565b601f821115612a4757600081815260208120601f850160051c81016020861015612a285750805b601f850160051c820191505b8181101561118d57828155600101612a34565b505050565b81516001600160401b03811115612a6557612a65611edc565b612a7981612a7384546124f6565b84612a01565b602080601f831160018114612aae5760008415612a965750858301515b600019600386901b1c1916600185901b17855561118d565b600085815260208120601f198616915b82811015612add57888601518255948401946001909101908401612abe565b5085821015612afb5787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fec3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f624d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529a2646970667358221220cf72cc6dfec7557a549ae9a9c0f6f7dbddd3c040da94b9a82892a238de95698864736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001008": { - "code": "0x608060405234801561001057600080fd5b50600436106101375760003560e01c8063b1768065116100b8578063d41f17711161007c578063d41f177114610298578063d7c9e3ec146102bf578063e0563ab1146102e6578063eeb49945146102ef578063f645125514610302578063f8c8765e1461032957600080fd5b8063b176806514610211578063b5c5f67214610238578063b68ad1e41461024b578063b8cd3ec01461025e578063c5ac2b1c1461027157600080fd5b806351351d53116100ff57806351351d53146101a45780637efab4f5146101b257806386937eb4146101db578063947287cf146101f057806397e5230d1461020757600080fd5b8063051eb2e21461013c57806305dc2e8f1461016c5780631bc114ba1461017f578063284017f5146101925780633b878c221461019b575b600080fd5b60355461014f906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b60345461014f906001600160a01b031681565b60335461014f906001600160a01b031681565b61014f61202081565b61014f61101081565b61014f6002600160a01b0381565b61014f6101c03660046115f0565b6037602052600090815260409020546001600160a01b031681565b6101ee6101e936600461165f565b61033c565b005b6101f961520881565b604051908152602001610163565b6101f9620249f081565b6101f97f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b6101ee61024636600461170b565b610354565b60365461014f906001600160a01b031681565b6101ee61026c366004611740565b610365565b6101f97faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6101f97f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101f97f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61014f61203081565b6101ee6102fd366004611786565b610377565b6101f97f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6101ee61033736600461180e565b610597565b61034b878787878787876107d8565b50505050505050565b61036083338484610b57565b505050565b61037184848484610b57565b50505050565b6034546001600160a01b031633146103e95760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f5354415460448201526922afa922a1a2a4ab22a960b11b60648201526084015b60405180910390fd5b6035546001600160a01b038481169116146104595760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f524f4f546044820152695f50524544494341544560b01b60648201526084016103e0565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82161048860206000848661186a565b61049191611894565b036104b0576104ab6104a6826020818661186a565b610e6c565b610371565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d186104df60206000848661186a565b6104e891611894565b036104f7576104ab82826110d7565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61052660206000848661186a565b61052f91611894565b0361053e576104ab8282611344565b60405162461bcd60e51b815260206004820152602860248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f5360448201526749474e415455524560c01b60648201526084016103e0565b336002600160a01b03146105db5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016103e0565b600054610100900460ff16158080156105fb5750600054600160ff909116105b806106155750303b158015610615575060005460ff166001145b6106785760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103e0565b6000805460ff19166001179055801561069b576000805461ff0019166101001790555b6001600160a01b038516158015906106bb57506001600160a01b03841615155b80156106cf57506001600160a01b03831615155b80156106e357506001600160a01b03821615155b6107415760405162461bcd60e51b815260206004820152602960248201527f4368696c64455243313135355072656469636174653a204241445f494e49544960448201526820a624ad20aa24a7a760b91b60648201526084016103e0565b603380546001600160a01b038088166001600160a01b0319928316179092556034805487841690831617905560358054868416908316179055603680549285169290911691909117905580156107d1576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b866107e2816114ac565b6107fe5760405162461bcd60e51b81526004016103e0906118b2565b6000886001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561083e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061086291906118f5565b6001600160a01b038181166000908152603760205260409020549192508a81169116146108a15760405162461bcd60e51b81526004016103e090611912565b6001600160a01b0381166108b7576108b7611957565b306001600160a01b0316896001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156108ff573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061092391906118f5565b6001600160a01b03161461093957610939611957565b868514801561094757508483145b6109a15760405162461bcd60e51b815260206004820152602560248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f4c60448201526408a9c8ea8960db1b60648201526084016103e0565b604051631ac8311560e21b81526001600160a01b038a1690636b20c454906109d59033908a908a908a908a9060040161199f565b6020604051808303816000875af11580156109f4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a1891906119e3565b610a345760405162461bcd60e51b81526004016103e090611a05565b6033546035546040516001600160a01b03928316926316f19831921690610a8f907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908f908f908f908f908f908f90602001611a90565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610abb929190611b41565b600060405180830381600087803b158015610ad557600080fd5b505af1158015610ae9573d6000803e3d6000fd5b50505050336001600160a01b0316896001600160a01b0316826001600160a01b03167f7a10660242ca367951ff3777cdb3c2a761e3ccad204bac118501e24693f3683d8b8b8b8b8b8b604051610b4496959493929190611b6d565b60405180910390a4505050505050505050565b83610b61816114ac565b610b7d5760405162461bcd60e51b81526004016103e0906118b2565b6000856001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610bbd573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610be191906118f5565b6001600160a01b03818116600090815260376020526040902054919250878116911614610c205760405162461bcd60e51b81526004016103e090611912565b6001600160a01b038116610c3657610c36611957565b306001600160a01b0316866001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c7e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ca291906118f5565b6001600160a01b031614610cb857610cb8611957565b604051637a94c56560e11b81526001600160a01b0387169063f5298aca90610ce890339088908890600401611bb6565b6020604051808303816000875af1158015610d07573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d2b91906119e3565b610d475760405162461bcd60e51b81526004016103e090611a05565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152898116608083015260a0820189905260c08083018990528351808403909101815260e08301938490526316f1983160e01b909352938416936316f1983193610dd99391169160e401611b41565b600060405180830381600087803b158015610df357600080fd5b505af1158015610e07573d6000803e3d6000fd5b50505050846001600160a01b0316866001600160a01b0316826001600160a01b03167f2ca9093e8b5356801039806c6a08003e5b7013fb8ae48f720fc90fc1c1a8bec2338888604051610e5c93929190611bb6565b60405180910390a4505050505050565b600080808080610e7e86880188611bd7565b6001600160a01b03808616600090815260376020526040902054959a50939850919650945092501680610ec35760405162461bcd60e51b81526004016103e090611912565b610ecc816114ac565b610ed857610ed8611957565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f18573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f3c91906118f5565b9050866001600160a01b0316816001600160a01b031614610f5f57610f5f611957565b6001600160a01b038116610f7557610f75611957565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610fbd573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fe191906118f5565b6001600160a01b031614610ff757610ff7611957565b604051630ab714fb60e11b81526001600160a01b0383169063156e29f69061102790889088908890600401611bb6565b6020604051808303816000875af1158015611046573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061106a91906119e3565b6110865760405162461bcd60e51b81526004016103e090611c32565b846001600160a01b0316826001600160a01b0316886001600160a01b03167f2930d932c1cccd6add2e0e2d706ede9015db8a194405f2a3e1783703515e104f898888604051610b4493929190611bb6565b6000808080806110e986880188611d48565b6001600160a01b03808616600090815260376020526040902054959b5093995091975095509350169050806111305760405162461bcd60e51b81526004016103e090611912565b611139816114ac565b61114557611145611957565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015611185573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111a991906118f5565b9050866001600160a01b0316816001600160a01b0316146111cc576111cc611957565b6001600160a01b0381166111e2576111e2611957565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561122a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061124e91906118f5565b6001600160a01b03161461126457611264611957565b604051635712868360e01b81526001600160a01b0383169063571286839061129490889088908890600401611e8d565b6020604051808303816000875af11580156112b3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112d791906119e3565b6112f35760405162461bcd60e51b81526004016103e090611c32565b856001600160a01b0316826001600160a01b0316886001600160a01b03167f17304b99f8dfa5a2b8dd5695d82f9947c2abfbc9cb64bab610b9a1a0feadb9a0888888604051610b4493929190611e8d565b60008061135383850185611f02565b9093509150506001600160a01b03821661136f5761136f611957565b6001600160a01b03828116600090815260376020526040902054161561139757611397611957565b6036546040516bffffffffffffffffffffffff19606085901b1660208201526000916113e7916001600160a01b039091169060340160405160208183030381529060405280519060200120611541565b6001600160a01b038481166000908152603760205260409081902080546001600160a01b0319169284169283179055516379ccf11760e11b81529192509063f399e22e9061143b9086908690600401611b41565b600060405180830381600087803b15801561145557600080fd5b505af1158015611469573d6000803e3d6000fd5b50506040516001600160a01b038085169350861691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a35050505050565b6000816001600160a01b03163b6000036114c857506000919050565b6040516301ffc9a760e01b8152636cdb3d1360e11b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa92505050801561152f575060408051601f3d908101601f1916820190925261152c918101906119e3565b60015b61153b57506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b03811661153b5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016103e0565b6001600160a01b03811681146115ed57600080fd5b50565b60006020828403121561160257600080fd5b813561160d816115d8565b9392505050565b60008083601f84011261162657600080fd5b5081356001600160401b0381111561163d57600080fd5b6020830191508360208260051b850101111561165857600080fd5b9250929050565b60008060008060008060006080888a03121561167a57600080fd5b8735611685816115d8565b965060208801356001600160401b03808211156116a157600080fd5b6116ad8b838c01611614565b909850965060408a01359150808211156116c657600080fd5b6116d28b838c01611614565b909650945060608a01359150808211156116eb57600080fd5b506116f88a828b01611614565b989b979a50959850939692959293505050565b60008060006060848603121561172057600080fd5b833561172b816115d8565b95602085013595506040909401359392505050565b6000806000806080858703121561175657600080fd5b8435611761816115d8565b93506020850135611771816115d8565b93969395505050506040820135916060013590565b6000806000806060858703121561179c57600080fd5b8435935060208501356117ae816115d8565b925060408501356001600160401b03808211156117ca57600080fd5b818701915087601f8301126117de57600080fd5b8135818111156117ed57600080fd5b8860208285010111156117ff57600080fd5b95989497505060200194505050565b6000806000806080858703121561182457600080fd5b843561182f816115d8565b9350602085013561183f816115d8565b9250604085013561184f816115d8565b9150606085013561185f816115d8565b939692955090935050565b6000808585111561187a57600080fd5b8386111561188757600080fd5b5050820193919092039150565b8035602083101561153b57600019602084900360031b1b1692915050565b60208082526023908201527f4368696c64455243313135355072656469636174653a204e4f545f434f4e54526040820152621050d560ea1b606082015260800190565b60006020828403121561190757600080fd5b815161160d816115d8565b60208082526025908201527f4368696c64455243313135355072656469636174653a20554e4d41505045445f6040820152642a27a5a2a760d91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561198657600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b03861681526060602082018190526000906119c4908301868861196d565b82810360408401526119d781858761196d565b98975050505050505050565b6000602082840312156119f557600080fd5b8151801515811461160d57600080fd5b60208082526022908201527f4368696c64455243313135355072656469636174653a204255524e5f4641494c604082015261115160f21b606082015260800190565b8183526000602080850194508260005b85811015611a85578135611a6a816115d8565b6001600160a01b031687529582019590820190600101611a57565b509495945050505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090611ac3908301888a611a47565b8281036080840152611ad681878961196d565b905082810360a0840152611aeb81858761196d565b9c9b505050505050505050505050565b6000815180845260005b81811015611b2157602081850181015186830182015201611b05565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611b6590830184611afb565b949350505050565b606081526000611b8160608301888a611a47565b8281036020840152611b9481878961196d565b90508281036040840152611ba981858761196d565b9998505050505050505050565b6001600160a01b039390931683526020830191909152604082015260600190565b600080600080600060a08688031215611bef57600080fd5b8535611bfa816115d8565b94506020860135611c0a816115d8565b93506040860135611c1a816115d8565b94979396509394606081013594506080013592915050565b60208082526022908201527f4368696c64455243313135355072656469636174653a204d494e545f4641494c604082015261115160f21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611cb257611cb2611c74565b604052919050565b60006001600160401b03821115611cd357611cd3611c74565b5060051b60200190565b600082601f830112611cee57600080fd5b81356020611d03611cfe83611cba565b611c8a565b82815260059290921b84018101918181019086841115611d2257600080fd5b8286015b84811015611d3d5780358352918301918301611d26565b509695505050505050565b60008060008060008060c08789031215611d6157600080fd5b86359550602080880135611d74816115d8565b95506040880135611d84816115d8565b945060608801356001600160401b0380821115611da057600080fd5b818a0191508a601f830112611db457600080fd5b8135611dc2611cfe82611cba565b81815260059190911b8301840190848101908d831115611de157600080fd5b938501935b82851015611e08578435611df9816115d8565b82529385019390850190611de6565b9750505060808a0135925080831115611e2057600080fd5b611e2c8b848c01611cdd565b945060a08a0135925080831115611e4257600080fd5b5050611e5089828a01611cdd565b9150509295509295509295565b600081518084526020808501945080840160005b83811015611a8557815187529582019590820190600101611e71565b606080825284519082018190526000906020906080840190828801845b82811015611ecf5781516001600160a01b031684529284019290840190600101611eaa565b50505083810382850152611ee38187611e5d565b9150508281036040840152611ef88185611e5d565b9695505050505050565b600080600060608486031215611f1757600080fd5b83359250602080850135611f2a816115d8565b925060408501356001600160401b0380821115611f4657600080fd5b818701915087601f830112611f5a57600080fd5b813581811115611f6c57611f6c611c74565b611f7e601f8201601f19168501611c8a565b91508082528884828501011115611f9457600080fd5b8084840185840137600084828401015250809350505050925092509256fea26469706673582212200c4c5c9b53a533081213342cd86f6dcc2549159a1a5ec39ac85621bb137a4c8f64736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001010": { - "code": "0x608060405234801561001057600080fd5b50600436106101425760003560e01c806370a08231116100b85780639dc29fac1161007c5780639dc29fac14610278578063a457c2d71461028b578063a9059cbb1461029e578063dd62ed3e146102b1578063e0563ab1146102c4578063e6198705146102cd57600080fd5b806370a082311461022d5780638420ce9914610248578063947287cf1461025d57806395d89b411461026657806397e5230d1461026e57600080fd5b8063284017f51161010a578063284017f5146101d2578063313ce567146101db57806339509351146101f05780633b878c221461020357806340c10f191461020c57806351351d531461021f57600080fd5b806306fdde0314610147578063095ea7b31461016557806318160ddd146101885780631f2d00651461019a57806323b872dd146101bf575b600080fd5b61014f6102de565b60405161015c9190610cfd565b60405180910390f35b610178610173366004610d4c565b610370565b604051901515815260200161015c565b6034545b60405190815260200161015c565b6036546001600160a01b03165b6040516001600160a01b03909116815260200161015c565b6101786101cd366004610d76565b61038a565b6101a761202081565b60395460405160ff909116815260200161015c565b6101786101fe366004610d4c565b6103ae565b6101a761101081565b61017861021a366004610d4c565b6103d0565b6101a76002600160a01b0381565b61018c61023b366004610db2565b6001600160a01b03163190565b61025b610256366004610e1d565b610419565b005b61018c61520881565b61014f6105c8565b61018c620249f081565b610178610286366004610d4c565b6105d7565b610178610299366004610d4c565b61060e565b6101786102ac366004610d4c565b610689565b61018c6102bf366004610ec8565b610697565b6101a761203081565b6035546001600160a01b03166101a7565b6060603780546102ed90610efb565b80601f016020809104026020016040519081016040528092919081815260200182805461031990610efb565b80156103665780601f1061033b57610100808354040283529160200191610366565b820191906000526020600020905b81548152906001019060200180831161034957829003601f168201915b5050505050905090565b60003361037e8185856106c2565b60019150505b92915050565b6000336103988582856107e6565b6103a3858585610860565b506001949350505050565b60003361037e8185856103c18383610697565b6103cb9190610f4b565b6106c2565b6035546000906001600160a01b031633146104065760405162461bcd60e51b81526004016103fd90610f5e565b60405180910390fd5b6104108383610a25565b50600192915050565b600054610100900460ff16158080156104395750600054600160ff909116105b806104535750303b158015610453575060005460ff166001145b6104b65760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103fd565b6000805460ff1916600117905580156104d9576000805461ff0019166101001790555b336002600160a01b031461051d5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016103fd565b603580546001600160a01b03808b166001600160a01b03199283161790925560368054928a1692909116919091179055603761055a868883611007565b506038610568848683611007565b506039805460ff191660ff841617905580156105be576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b6060603880546102ed90610efb565b6035546000906001600160a01b031633146106045760405162461bcd60e51b81526004016103fd90610f5e565b6104108383610b7f565b6000338161061c8286610697565b90508381101561067c5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084016103fd565b6103a382868684036106c2565b60003361037e818585610860565b6001600160a01b03918216600090815260336020908152604080832093909416825291909152205490565b6001600160a01b0383166107245760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016103fd565b6001600160a01b0382166107855760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016103fd565b6001600160a01b0383811660008181526033602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b60006107f28484610697565b9050600019811461085a578181101561084d5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000060448201526064016103fd565b61085a84848484036106c2565b50505050565b6001600160a01b0383166108c45760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b60648201526084016103fd565b6001600160a01b0382166109265760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016103fd565b6000806120206001600160a01b031685858560405160200161094a939291906110c8565b60408051601f1981840301815290829052610964916110ec565b6000604051808303816000865af19150503d80600081146109a1576040519150601f19603f3d011682016040523d82523d6000602084013e6109a6565b606091505b50915091508180156109c75750808060200190518101906109c79190611108565b6109e35760405162461bcd60e51b81526004016103fd9061112a565b836001600160a01b0316856001600160a01b031660008051602061116e83398151915285604051610a1691815260200190565b60405180910390a35050505050565b6001600160a01b038216610a7b5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016103fd565b8060346000828254610a8d9190610f4b565b9091555050604051600090819061202090610ab0908390879087906020016110c8565b60408051601f1981840301815290829052610aca916110ec565b6000604051808303816000865af19150503d8060008114610b07576040519150601f19603f3d011682016040523d82523d6000602084013e610b0c565b606091505b5091509150818015610b2d575080806020019051810190610b2d9190611108565b610b495760405162461bcd60e51b81526004016103fd9061112a565b6040518381526001600160a01b0385169060009060008051602061116e833981519152906020015b60405180910390a350505050565b6001600160a01b038216610bdf5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016103fd565b8060346000828254610bf1919061115a565b9091555050604051600090819061202090610c14908690849087906020016110c8565b60408051601f1981840301815290829052610c2e916110ec565b6000604051808303816000865af19150503d8060008114610c6b576040519150601f19603f3d011682016040523d82523d6000602084013e610c70565b606091505b5091509150818015610c91575080806020019051810190610c919190611108565b610cad5760405162461bcd60e51b81526004016103fd9061112a565b6040518381526000906001600160a01b0386169060008051602061116e83398151915290602001610b71565b60005b83811015610cf4578181015183820152602001610cdc565b50506000910152565b6020815260008251806020840152610d1c816040850160208701610cd9565b601f01601f19169190910160400192915050565b80356001600160a01b0381168114610d4757600080fd5b919050565b60008060408385031215610d5f57600080fd5b610d6883610d30565b946020939093013593505050565b600080600060608486031215610d8b57600080fd5b610d9484610d30565b9250610da260208501610d30565b9150604084013590509250925092565b600060208284031215610dc457600080fd5b610dcd82610d30565b9392505050565b60008083601f840112610de657600080fd5b50813567ffffffffffffffff811115610dfe57600080fd5b602083019150836020828501011115610e1657600080fd5b9250929050565b600080600080600080600060a0888a031215610e3857600080fd5b610e4188610d30565b9650610e4f60208901610d30565b9550604088013567ffffffffffffffff80821115610e6c57600080fd5b610e788b838c01610dd4565b909750955060608a0135915080821115610e9157600080fd5b50610e9e8a828b01610dd4565b909450925050608088013560ff81168114610eb857600080fd5b8091505092959891949750929550565b60008060408385031215610edb57600080fd5b610ee483610d30565b9150610ef260208401610d30565b90509250929050565b600181811c90821680610f0f57607f821691505b602082108103610f2f57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b8082018082111561038457610384610f35565b60208082526024908201527f4e617469766545524332303a204f6e6c79207072656469636174652063616e2060408201526318d85b1b60e21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f82111561100257600081815260208120601f850160051c81016020861015610fdf5750805b601f850160051c820191505b81811015610ffe57828155600101610feb565b5050505b505050565b67ffffffffffffffff83111561101f5761101f610fa2565b6110338361102d8354610efb565b83610fb8565b6000601f841160018114611067576000851561104f5750838201355b600019600387901b1c1916600186901b1783556110c1565b600083815260209020601f19861690835b828110156110985786850135825560209485019460019092019101611078565b50868210156110b55760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b600082516110fe818460208701610cd9565b9190910192915050565b60006020828403121561111a57600080fd5b81518015158114610dcd57600080fd5b60208082526016908201527514149150d3d35412531157d0d0531317d1905253115160521b604082015260600190565b8181038181111561038457610384610f3556feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa264697066735822122020d4a9c065f722d638ec115bf32ed1a8620dca26d052147ca0029d6b7b9aec9d64736f6c63430008130033", - "balance": "0x0" - }, - "0x61324166B0202DB1E7502924326262274Fa4358F": { - "balance": "0xf4240" - }, - "0x9aBb8441A12d4FD8D505C3fc50cDdc45E0df2b1e": { - "balance": "0xd3c21bcecceda1000000" - }, - "0xCaB5AAC79Bebe326e0c80d72b5662E73f5D8ea56": { - "balance": "0xd3c21bcecceda1000000" - }, - "0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570": { - "balance": "0xd3c21bcecceda1000000" - } - }, - "number": "0x0", - "gasUsed": "0x70000", - "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000", - "baseFee": "0x0", - "baseFeeEM": "0x0" - }, - "params": { - "forks": { - "homestead": 0, - "byzantium": 0, - "constantinople": 0, - "petersburg": 0, - "istanbul": 0, - "EIP150": 0, - "EIP158": 0, - "EIP155": 0 - }, - "chainID": 0, - "engine": { - "polybft": { - "initialValidatorSet": [ - { - "address": "0x61324166B0202DB1E7502924326262274Fa4358F", - "blsKey": "06d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca", - "balance": "0xf4240", - "stake": "0xd3c21bcecceda1000000", - "multiAddr": "/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8" - }, - { - "address": "0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570", - "blsKey": "0601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f", - "balance": "0xd3c21bcecceda1000000", - "stake": "0xd3c21bcecceda1000000", - "multiAddr": "/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX" - }, - { - "address": "0x9aBb8441A12d4FD8D505C3fc50cDdc45E0df2b1e", - "blsKey": "17c26d9d91dddc3c1318b20a1ddb3322ea1f4e4415c27e9011d706e7407eed672837173d1909cbff6ccdfd110af3b18bdfea878e8120fdb5bae70dc7a044a2f40aa8f118b41704896f474f80fff52d9047fa8e4a464ac86f9d05a0220975d8440e20c6307d866137053cabd4baf6ba84bfa4a22f5f9297c1bfc2380c23535210", - "balance": "0xd3c21bcecceda1000000", - "stake": "0xd3c21bcecceda1000000", - "multiAddr": "/ip4/127.0.0.1/tcp/30303/p2p/16Uiu2HAmGskf5sZ514Ab4SHTPuw8RRBQudyrU211wn3P1knRz9Ed" - }, - { - "address": "0xCaB5AAC79Bebe326e0c80d72b5662E73f5D8ea56", - "blsKey": "1d7bb7d44a2f0ebeae2f4380f88188080de34635d78a36647f0704c7b70de7291e2e3b9a1ef699a078c6cd9bb816ea2917c2c2fc699c6248f1f7812a167caf7e15361ec16df56d194768d57c79897c681c96f4321651464f7b577d08083d8b67213a1e29dc8495d8389e6cbd85fdd738c402a1801198b57b302e0e00dfaf1247", - "balance": "0xd3c21bcecceda1000000", - "stake": "0xd3c21bcecceda1000000", - "multiAddr": "/ip4/127.0.0.1/tcp/30304/p2p/16Uiu2HAm42EFMhJPGcMRFHPaWWxBzoEsWRbGxJnBHMu4VFojg99U" - } - ], - "bridge": null, - "epochSize": 10, - "epochReward": 1, - "sprintSize": 5, - "blockTime": "2s", - "governance": "0x61324166B0202DB1E7502924326262274Fa4358F", - "mintableNative": false, - "nativeTokenConfig": { - "name": "XGR", - "symbol": "WMATIC", - "decimals": 18 - }, - "initialTrieRoot": "0x0000000000000000000000000000000000000000000000000000000000000000", - "maxValidatorSetSize": 9007199254740990, - "rewardConfig": { - "rewardTokenAddress": "0x0000000000000000000000000000000000001010", - "rewardWalletAddress": "0x61324166B0202DB1E7502924326262274Fa4358F", - "rewardWalletAmount": "0xf4240" - } - } - }, - "blockGasTarget": 0, - "transactionsAllowList": { - "adminAddresses": [ - "0x061324166B0202Db1E7502924326262274fa4358" - ], - "enabledAddresses": [ - "0x061324166B0202Db1E7502924326262274fa4358" - ] - }, - "burnContract": null - }, - "bootnodes": [ - "/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8", - "/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX", - "/ip4/127.0.0.1/tcp/30303/p2p/16Uiu2HAmGskf5sZ514Ab4SHTPuw8RRBQudyrU211wn3P1knRz9Ed", - "/ip4/127.0.0.1/tcp/30304/p2p/16Uiu2HAm42EFMhJPGcMRFHPaWWxBzoEsWRbGxJnBHMu4VFojg99U" - ] -} -``` - -
- - - - - - - -When setting up the initial chain state for a multiple-host validator setup, you'll need to specify the validator information using the `--validators` flag in the following format: `:::`. - -This follows the [libp2p multiaddr format](../../design/libp2p.md): ``. - -In this example, we will designate the first and second nodes as bootnodes for all other nodes. Nodes connecting to node 1 or 2 will receive information on how to connect to each other through the mutually contacted bootnode. For the ports, we will use `30301` for the first node and `30302` for the second node. Since we are running on localhost, it is safe to assume that the `ip_address` is `127.0.0.1`. If you are not running on your localhost, please update accordingly. - -After assembly, the multiaddr connection string for node 1 and 2 will look something like this: - -- Node 1: `/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8` -- Node 2: `/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX` - -In the following example command, we will set the block gas limit to `10,000,000` and the epoch size to `10` using the `--block-gas-limit` and `--epoch-size` flags, respectively. - -We will also specify the consensus mechanism as PolyBFT using the `--consensus` flag. - -To enable reward distribution, we will define a reward wallet address and its balance using the `--reward-wallet` flag (for this example, we use the first validator as the reward wallet). - -In addition, we can provide the directory where the validator information is stored using the `--validators-path` flag and the prefix for the validator folder names using the `--validators-prefix` flag. - -We also add the `--transactions-allow-list-admin` flag to specify the admin addresses for the transactions allowlist, and the `--transactions-allow-list-enabled` flag to specify the addresses that will be enabled by default in the transactions allowlist, using the first and second validator nodes. - -**You can customize the initial chain state using the flags listed above.** - -```bash -./xgrchain genesis --block-gas-limit 10000000 --epoch-size 10 \ - --proxy-contracts-admin 0x61324166B0202DB1E7502924326262274Fa4358F \ - --validators "/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8:0x61324166B0202DB1E7502924326262274Fa4358F:06d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca" \ - --validators "/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX:0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570:0601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f" \ - --consensus polybft \ - --reward-wallet 0x61324166B0202DB1E7502924326262274Fa4358F:1000000 \ - --transactions-allow-list-admin 0x61324166B0202DB1E7502924326262274Fa4358F,0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570 \ - --transactions-allow-list-enabled 0x61324166B0202DB1E7502924326262274Fa4358F,0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570 \ - --premine 0x0:1000000000000000000000 -``` - -By customizing these flags, we can tailor the network to meet our specific requirements. Remember to consider the impact of these parameters carefully, as they can significantly affect the network's performance, security, and scalability. - -
-Genesis output example - -#### Output: - -```bash -[GENESIS VALIDATORS] -Address=0x61324166B0202DB1E7502924326262274Fa4358F; Balance=1000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8; BLS Key=06d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca; -Address=0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570; Balance=1000000000000000000000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX; BLS Key=0601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f; - -[GENESIS SUCCESS] - -Genesis written to ./genesis.json -``` - -#### genesis.json example: - -```json -{ - "name": "xgrchain", - "genesis": { - "nonce": "0x0000000000000000", - "timestamp": "0x0", - "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000f901bbf9014ff9014af8a39461324166b0202db1e7502924326262274fa4358fb88006d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca8ad3c21bcecceda100000001f8a394fe5e166ba5ea50c04fca00b07b59966e6c2e9570b8800601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f8ad3c21bcecceda100000001c080c0c0f8658080a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000", - "gasLimit": "0x989680", - "difficulty": "0x0", - "mixHash": "0xadce6e5230abe012342a44e4e9b6d05997d6f015387ae0e59be924afc7ec70c1", - "coinbase": "0x0000000000000000000000000000000000000000", - "alloc": { - "0x0000000000000000000000000000000000000101": { - "code": "0x608060405234801561001057600080fd5b50600436106101b05760003560e01c806370a08231116100ef578063ce513b6f11610092578063ce513b6f14610398578063dd62ed3e146103ab578063e0563ab1146103be578063ea0fee4f146103c7578063eacdc5ff146103cf578063eeb49945146103d8578063f3f43703146103eb578063fd242c14146103fe57600080fd5b806370a08231146102e7578063947287cf146102fa57806395d89b411461030357806397e5230d1461030b578063981b24d014610315578063a457c2d714610328578063a9059cbb1461033b578063c6b61e4c1461034e57600080fd5b8063395093511161015757806339509351146102735780633b878c22146102865780633ccfd60b1461028f5780633fd50001146102975780634ee2cd7e146102aa57806351351d53146102bd57806361cc2763146102cb57806362656003146102de57600080fd5b806306fdde03146101b5578063095ea7b3146101d35780630f50287c146101f657806318160ddd1461020b57806323b872dd1461021d578063284017f5146102305780632e17de7814610251578063313ce56714610264575b600080fd5b6101bd610411565b6040516101ca91906119ba565b60405180910390f35b6101e66101e13660046119e2565b6104a3565b60405190151581526020016101ca565b610209610204366004611a0e565b6104bd565b005b6035545b6040519081526020016101ca565b6101e661022b366004611a46565b61074f565b61023961202081565b6040516001600160a01b0390911681526020016101ca565b61020961025f366004611a87565b610773565b604051601281526020016101ca565b6101e66102813660046119e2565b61078a565b61023961101081565b6102096107ac565b61020f6102a5366004611a87565b6108bd565b61020f6102b83660046119e2565b6108de565b6102396002600160a01b0381565b6102096102d9366004611b10565b6108f1565b61020f60cc5481565b61020f6102f5366004611c29565b610b1f565b61020f61520881565b6101bd610b3a565b61020f620249f081565b61020f610323366004611a87565b610b49565b6101e66103363660046119e2565b610b54565b6101e66103493660046119e2565b610bcf565b61037d61035c366004611a87565b60ce6020526000908152604090208054600182015460029092015490919083565b604080519384526020840192909252908201526060016101ca565b61020f6103a6366004611c29565b610bdd565b61020f6103b9366004611c46565b610c0b565b61023961203081565b61020f600181565b61020f60cd5481565b6102096103e6366004611c7f565b610c36565b61020f6103f9366004611c29565b610d08565b61020f61040c366004611a87565b610d2f565b60606036805461042090611d08565b80601f016020809104026020016040519081016040528092919081815260200182805461044c90611d08565b80156104995780601f1061046e57610100808354040283529160200191610499565b820191906000526020600020905b81548152906001019060200180831161047c57829003601f168201915b5050505050905090565b6000336104b1818585610d79565b60019150505b92915050565b336002600160a01b03146105065760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b60cd80546000918261051783611d58565b9190505590508083146105625760405162461bcd60e51b815260206004820152601360248201527215539156141150d5115117d15413d0d217d251606a1b60448201526064016104fd565b81356020830135116105ac5760405162461bcd60e51b81526020600482015260136024820152721393d7d09313d0d2d4d7d0d3d3535255151151606a1b60448201526064016104fd565b60cc546105be83356020850135611d71565b6105c9906001611d84565b6105d39190611dad565b1561062e5760405162461bcd60e51b815260206004820152602560248201527f45504f43485f4d5553545f42455f444956495349424c455f42595f45504f43486044820152645f53495a4560d81b60648201526084016104fd565b813560ce600061063f600185611d71565b815260200190815260200160002060010154600161065d9190611d84565b146106a05760405162461bcd60e51b8152602060048201526013602482015272494e56414c49445f53544152545f424c4f434b60681b60448201526064016104fd565b600081815260ce6020526040902082906106d182828135815560208201356001820155604082013560028201555050565b505060cf80546001810182556000919091526020838101357facb8d954e2cfef495862221e91bd7523613cf8808827cb33edfe4904cc51bf299092018290556040805190850135815284359186917f0ce8712c4dee4bd5a691f0bc1c39594671591e77395f8ebf6a3fb5f63fbea66a910160405180910390a4505050565b60003361075d858285610e9e565b610768858585610f12565b506001949350505050565b61077d33826110b6565b61078733826111e1565b50565b6000336104b181858561079d8383610c0b565b6107a79190611d84565b610d79565b33600090815260d06020526040812060cd5490919081906107ce90849061125a565b808555604051828152919350915033907f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b659060200160405180910390a260c95460cb54604080517f8ca9a95e41b5eece253c93f5b31eed1253aed6b145d8a6e14d913fdf8e7322936020820152338183015260608082018790528251808303909101815260808201928390526316f1983160e01b9092526001600160a01b03938416936316f198319361088693911691608401611dc1565b600060405180830381600087803b1580156108a057600080fd5b505af11580156108b4573d6000803e3d6000fd5b50505050505050565b60cf81815481106108cd57600080fd5b600091825260209091200154905081565b60006108ea83836112cc565b9392505050565b600054610100900460ff16158080156109115750600054600160ff909116105b8061092b5750303b15801561092b575060005460ff166001145b61098e5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016104fd565b6000805460ff1916600117905580156109b1576000805461ff0019166101001790555b6109fb6040518060400160405280600c81526020016b15985b1a59185d1bdc94d95d60a21b815250604051806040016040528060048152602001631594d15560e21b815250611315565b60c980546001600160a01b038089166001600160a01b03199283161790925560ca805488841690831617905560cb80549287169290911691909117905560cc83905560005b8251811015610a9557610a8d838281518110610a5e57610a5e611de5565b602002602001015160000151848381518110610a7c57610a7c611de5565b60200260200101516020015161134a565b600101610a40565b5060cf80546001818101835560009283527facb8d954e2cfef495862221e91bd7523613cf8808827cb33edfe4904cc51bf299091019190915560cd558015610b17576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b6001600160a01b031660009081526033602052604090205490565b60606037805461042090611d08565b60006104b782611354565b60003381610b628286610c0b565b905083811015610bc25760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084016104fd565b6107688286868403610d79565b6000336104b1818585610f12565b60cd546001600160a01b038216600090815260d0602052604081209091610c04919061125a565b5092915050565b6001600160a01b03918216600090815260346020908152604080832093909416825291909152205490565b60ca546001600160a01b031633148015610c5d575060cb546001600160a01b038481169116145b610c9a5760405162461bcd60e51b815260206004820152600e60248201526d24a72b20a624a22fa9a2a72222a960911b60448201526064016104fd565b7f1bcc0f4c3fad314e585165815f94ecca9b96690a26d6417d7876448a9a867a69610cc9602060008486611dfb565b610cd291611e25565b03610d0257600080610ce78360208187611dfb565b810190610cf491906119e2565b91509150610b17828261134a565b50505050565b60cd546001600160a01b038216600090815260d06020526040812090916104b7919061137f565b600081815260ce60205260408120600101548015610d7057600083815260ce6020526040902054610d609082611d71565b610d6b906001611d84565b6108ea565b60009392505050565b6001600160a01b038316610ddb5760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016104fd565b6001600160a01b038216610e3c5760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016104fd565b6001600160a01b0383811660008181526034602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b6000610eaa8484610c0b565b90506000198114610d025781811015610f055760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000060448201526064016104fd565b610d028484848403610d79565b6001600160a01b038316610f765760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b60648201526084016104fd565b6001600160a01b038216610fd85760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016104fd565b610fe383838361141d565b6001600160a01b0383166000908152603360205260409020548181101561105b5760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b60648201526084016104fd565b6001600160a01b038085166000818152603360205260408082208686039055928616808252908390208054860190559151600080516020611fd6833981519152906110a99086815260200190565b60405180910390a3610d02565b6001600160a01b0382166111165760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016104fd565b6111228260008361141d565b6001600160a01b038216600090815260336020526040902054818110156111965760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b60648201526084016104fd565b6001600160a01b0383166000818152603360209081526040808320868603905560358054879003905551858152919291600080516020611fd68339815191529101610e91565b505050565b61121381600160cd546111f49190611d84565b6001600160a01b038516600090815260d0602052604090209190611486565b816001600160a01b03167f655c1cd0236fb6dc4916f34c8ff10e3b18fcaea5b344dfc16c36fbb1bdfc5df28260405161124e91815260200190565b60405180910390a25050565b81546000905b83600101548110156112c5576000818152600285016020908152604091829020825180840190935280548352600101549082018190528410156112a357506112c5565b80516112af9084611d84565b92505080806112bd90611d58565b915050611260565b9250929050565b6001600160a01b0382166000908152606560205260408120819081906112f39085906115b1565b915091508161130a5761130585610b1f565b61130c565b805b95945050505050565b600054610100900460ff1661133c5760405162461bcd60e51b81526004016104fd90611e43565b611346828261169f565b5050565b61134682826116df565b60008060006113648460666115b1565b915091508161137557603554611377565b805b949350505050565b60018201546000908082036113985760009150506104b7565b60006113a5600183611d71565b90505b845481106114155760008181526002860160209081526040918290208251808401909352805483526001015490820181905285106113e65750611415565b80516113f29085611d84565b9350816000036114025750611415565b508061140d81611e8e565b9150506113a8565b505092915050565b6001600160a01b038316158061143a57506001600160a01b038216155b61147b5760405162461bcd60e51b81526020600482015260126024820152712a2920a729a322a92fa327a92124a22222a760711b60448201526064016104fd565b6111dc83838361179a565b8160000361149657611496611ea5565b825460018401548181036114ed576040805180820182528581526020808201868152600085815260028a0190925292812091518255915160019182015586018054916114e183611d58565b91905055505050505050565b600060028601816114ff600185611d71565b81526020019081526020016000206001015490508084101561152357611523611ea5565b83811015611572576040805180820182528681526020808201878152600086815260028b01909252928120915182559151600191820155870180549161156883611d58565b9190505550610b17565b84600287016000611584600186611d71565b815260200190815260200160002060000160008282546115a49190611d84565b9091555050505050505050565b600080600084116115fd5760405162461bcd60e51b815260206004820152601660248201527504552433230536e617073686f743a20696420697320360541b60448201526064016104fd565b60cd5484111561164f5760405162461bcd60e51b815260206004820152601d60248201527f4552433230536e617073686f743a206e6f6e6578697374656e7420696400000060448201526064016104fd565b600061165b84866117e2565b845490915081036116735760008092509250506112c5565b600184600101828154811061168a5761168a611de5565b906000526020600020015492509250506112c5565b600054610100900460ff166116c65760405162461bcd60e51b81526004016104fd90611e43565b60366116d28382611f01565b5060376111dc8282611f01565b6001600160a01b0382166117355760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016104fd565b6117416000838361141d565b80603560008282546117539190611d84565b90915550506001600160a01b038216600081815260336020908152604080832080548601905551848152600080516020611fd6833981519152910160405180910390a35050565b6001600160a01b0383166117b9576117b18261188f565b6111dc6118b9565b6001600160a01b0382166117d0576117b18361188f565b6117d98361188f565b6111dc8261188f565b815460009081036117f5575060006104b7565b82546000905b8082101561184257600061180f83836118c9565b6000878152602090209091508590820154111561182e5780915061183c565b611839816001611d84565b92505b506117fb565b60008211801561186e57508361186b8661185d600186611d71565b600091825260209091200190565b54145b156118875761187e600183611d71565b925050506104b7565b5090506104b7565b6001600160a01b0381166000908152606560205260409020610787906118b483610b1f565b6118e4565b6118c760666118b460355490565b565b60006118d86002848418611fc1565b6108ea90848416611d84565b60006118ef60cd5490565b9050806118fb8461192f565b10156111dc578254600180820185556000858152602080822090930193909355938401805494850181558252902090910155565b8054600090810361194257506000919050565b8154829061195290600190611d71565b8154811061196257611962611de5565b90600052602060002001549050919050565b6000815180845260005b8181101561199a5760208185018101518683018201520161197e565b506000602082860101526020601f19601f83011685010191505092915050565b6020815260006108ea6020830184611974565b6001600160a01b038116811461078757600080fd5b600080604083850312156119f557600080fd5b8235611a00816119cd565b946020939093013593505050565b6000808284036080811215611a2257600080fd5b833592506060601f1982011215611a3857600080fd5b506020830190509250929050565b600080600060608486031215611a5b57600080fd5b8335611a66816119cd565b92506020840135611a76816119cd565b929592945050506040919091013590565b600060208284031215611a9957600080fd5b5035919050565b634e487b7160e01b600052604160045260246000fd5b6040805190810167ffffffffffffffff81118282101715611ad957611ad9611aa0565b60405290565b604051601f8201601f1916810167ffffffffffffffff81118282101715611b0857611b08611aa0565b604052919050565b600080600080600060a08688031215611b2857600080fd5b8535611b33816119cd565b9450602086810135611b44816119cd565b9450604087810135611b55816119cd565b945060608801359350608088013567ffffffffffffffff80821115611b7957600080fd5b818a0191508a601f830112611b8d57600080fd5b813581811115611b9f57611b9f611aa0565b611bad858260051b01611adf565b818152858101925060069190911b83018501908c821115611bcd57600080fd5b928501925b81841015611c165784848e031215611bea5760008081fd5b611bf2611ab6565b8435611bfd816119cd565b8152848701358782015283529284019291850191611bd2565b8096505050505050509295509295909350565b600060208284031215611c3b57600080fd5b81356108ea816119cd565b60008060408385031215611c5957600080fd5b8235611c64816119cd565b91506020830135611c74816119cd565b809150509250929050565b60008060008060608587031215611c9557600080fd5b843593506020850135611ca7816119cd565b9250604085013567ffffffffffffffff80821115611cc457600080fd5b818701915087601f830112611cd857600080fd5b813581811115611ce757600080fd5b886020828501011115611cf957600080fd5b95989497505060200194505050565b600181811c90821680611d1c57607f821691505b602082108103611d3c57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b600060018201611d6a57611d6a611d42565b5060010190565b818103818111156104b7576104b7611d42565b808201808211156104b7576104b7611d42565b634e487b7160e01b600052601260045260246000fd5b600082611dbc57611dbc611d97565b500690565b6001600160a01b038316815260406020820181905260009061137790830184611974565b634e487b7160e01b600052603260045260246000fd5b60008085851115611e0b57600080fd5b83861115611e1857600080fd5b5050820193919092039150565b803560208310156104b757600019602084900360031b1b1692915050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b600081611e9d57611e9d611d42565b506000190190565b634e487b7160e01b600052600160045260246000fd5b601f8211156111dc57600081815260208120601f850160051c81016020861015611ee25750805b601f850160051c820191505b81811015610b1757828155600101611eee565b815167ffffffffffffffff811115611f1b57611f1b611aa0565b611f2f81611f298454611d08565b84611ebb565b602080601f831160018114611f645760008415611f4c5750858301515b600019600386901b1c1916600185901b178555610b17565b600085815260208120601f198616915b82811015611f9357888601518255948401946001909101908401611f74565b5085821015611fb15787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b600082611fd057611fd0611d97565b50049056feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220ceae916e2fad24f9aaa4340b6994418d32d33c6ae1f266c50dd4ec5ccbdbce2764736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000000102": { - "code": "0x608060405234801561001057600080fd5b506004361061009e5760003560e01c806391ec2d2b1161006657806391ec2d2b1461013b578063a850a9091461015b578063d58e77331461016e578063e242cce914610181578063ebbdac911461019457600080fd5b8063115000fe146100a3578063247dd9fb146100cb5780633e5476ce146100de5780638669026f146101085780639141376314610128575b600080fd5b6100b66100b1366004612708565b6101a7565b60405190151581526020015b60405180910390f35b6100b66100d9366004612785565b61030e565b6100f16100ec366004612841565b6103b8565b6040805192151583529015156020830152016100c2565b61011b6101163660046128ce565b61079f565b6040516100c29190612957565b6100f1610136366004612988565b6108bb565b61014e6101493660046128ce565b610d5c565b6040516100c29190612a86565b61011b6101693660046128ce565b610ff8565b61011b61017c366004612aa0565b6111d4565b6100b661018f366004612785565b6115aa565b6100f16101a2366004612ab9565b611609565b600081516020830151600080516020612d63833981519152828309600080516020612d638339815191528283098182830101600080516020612d638339815191528283840108600080516020612d638339815191528682600080516020612d6383398151915203860109935050600080516020612d638339815191528483600080516020612d63833981519152038301099150600080516020612d638339815191527f2b149d40ceb8aaae81be18991be06ac3b5b4c5e559dbefa33267e6dc24a138e584089450600080516020612d638339815191527e9713b03af0fed4cd2cafadeed8fdf4a74fa084e52d1852e4a2bd0685c315d2830893506040870151925060608701519150600080516020612d638339815191528083600080516020612d63833981519152038508600080516020612d63833981519152848608099050600080516020612d63833981519152828460011b0994149290931491909116949350505050565b8051600090600080516020612d6383398151915211158061034157506020820151600080516020612d6383398151915211155b1561034e57506000919050565b60405163e242cce960e01b8152309063e242cce990610371908590600401612957565b602060405180830381865afa15801561038e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103b29190612b1c565b92915050565b60008083806103e25760405162461bcd60e51b81526004016103d990612b3e565b60405180910390fd5b60006103ef826001612b95565b6103fa906006612ba8565b90506000816001600160401b038111156104165761041661269a565b60405190808252806020026020018201604052801561043f578160200160208202803683370190505b50905088600060200201358160008151811061045d5761045d612b06565b602090810291909101015288600160200201358160018151811061048357610483612b06565b602002602001018181525050600080516020612d43833981519152816002815181106104b1576104b1612b06565b602002602001018181525050600080516020612d23833981519152816003815181106104df576104df612b06565b602002602001018181525050600080516020612d838339815191528160048151811061050d5761050d612b06565b602002602001018181525050600080516020612da38339815191528160058151811061053b5761053b612b06565b60200260200101818152505060005b8381101561075a57863582610560836006612ba8565b61056b906006612b95565b8151811061057b5761057b612b06565b602090810291909101015286600160200201358261059a836006612ba8565b6105a5906007612b95565b815181106105b5576105b5612b06565b6020026020010181815250508888828181106105d3576105d3612b06565b9050608002016001600481106105eb576105eb612b06565b6020020135826105fc836006612ba8565b610607906008612b95565b8151811061061757610617612b06565b60200260200101818152505088888281811061063557610635612b06565b90506080020160006004811061064d5761064d612b06565b60200201358261065e836006612ba8565b610669906009612b95565b8151811061067957610679612b06565b60200260200101818152505088888281811061069757610697612b06565b9050608002016003600481106106af576106af612b06565b6020020135826106c0836006612ba8565b6106cb90600a612b95565b815181106106db576106db612b06565b6020026020010181815250508888828181106106f9576106f9612b06565b90506080020160026004811061071157610711612b06565b602002013582610722836006612ba8565b61072d90600b612b95565b8151811061073d5761073d612b06565b60209081029190910101528061075281612bbf565b91505061054a565b50610763612640565b602081602085026020850160085afa945084610789576000809550955050505050610796565b5115159450600193505050505b94509492505050565b6107a761265e565b6040516391ec2d2b60e01b815260009030906391ec2d2b906107cf9087908790600401612bd8565b600060405180830381865afa1580156107ec573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526108149190810190612bf9565b9050600080600080601885016001600160c01b0381511693506030860190506001600160c01b038151169450600080516020612d6383398151915285600080516020612d63833981519152600160c01b870908604887015160608801516001600160c01b0390811697501694509250600080516020612d6383398151915290508481600160c01b860908604080518082019091529283526020830152509695505050505050565b60008084806108dc5760405162461bcd60e51b81526004016103d990612b3e565b8084146109495760405162461bcd60e51b815260206004820152603560248201527f424c533a206e756d626572206f66207075626c6963206b65797320616e64206d604482015274195cdcd859d95cc81b5d5cdd08189948195c5d585b605a1b60648201526084016103d9565b6000610956826001612b95565b610961906006612ba8565b90506000816001600160401b0381111561097d5761097d61269a565b6040519080825280602002602001820160405280156109a6578160200160208202803683370190505b5090508960006020020135816000815181106109c4576109c4612b06565b60209081029190910101528960016020020135816001815181106109ea576109ea612b06565b602002602001018181525050600080516020612d4383398151915281600281518110610a1857610a18612b06565b602002602001018181525050600080516020612d2383398151915281600381518110610a4657610a46612b06565b602002602001018181525050600080516020612d8383398151915281600481518110610a7457610a74612b06565b602002602001018181525050600080516020612da383398151915281600581518110610aa257610aa2612b06565b60200260200101818152505060005b83811015610d1657878782818110610acb57610acb612b06565b905060400201600060028110610ae357610ae3612b06565b602002013582610af4836006612ba8565b610aff906006612b95565b81518110610b0f57610b0f612b06565b602002602001018181525050878782818110610b2d57610b2d612b06565b905060400201600160028110610b4557610b45612b06565b602002013582610b56836006612ba8565b610b61906007612b95565b81518110610b7157610b71612b06565b602002602001018181525050898982818110610b8f57610b8f612b06565b905060800201600160048110610ba757610ba7612b06565b602002013582610bb8836006612ba8565b610bc3906008612b95565b81518110610bd357610bd3612b06565b602002602001018181525050898982818110610bf157610bf1612b06565b905060800201600060048110610c0957610c09612b06565b602002013582610c1a836006612ba8565b610c25906009612b95565b81518110610c3557610c35612b06565b602002602001018181525050898982818110610c5357610c53612b06565b905060800201600360048110610c6b57610c6b612b06565b602002013582610c7c836006612ba8565b610c8790600a612b95565b81518110610c9757610c97612b06565b602002602001018181525050898982818110610cb557610cb5612b06565b905060800201600260048110610ccd57610ccd612b06565b602002013582610cde836006612ba8565b610ce990600b612b95565b81518110610cf957610cf9612b06565b602090810291909101015280610d0e81612bbf565b915050610ab1565b50610d1f612640565b602081602085026020850160085afa945084610d45576000809550955050505050610d52565b5115159450600193505050505b9550959350505050565b80516060906000610d6e826020612b95565b610d79906040612b95565b610d84906004612b95565b6001600160401b03811115610d9b57610d9b61269a565b6040519080825280601f01601f191660200182016040528015610dc5576020820181803683370190505b5060408051606080825260808201909252919250600091906020820181803683370190505090506060820160005b84811015610e0d5760208188018101518383015201610df3565b5083016000815360010160608153600101600081536001810187905260210160208153506000600283604051610e439190612c6f565b602060405180830381855afa158015610e60573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610e839190612c8b565b9050600060429450848452816020850152600160408501536041840188905260206061850153600284604051610eb99190612c6f565b602060405180830381855afa158015610ed6573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610ef99190612c8b565b905080602084015280821880602086015250600260408501536041840188905260206061850153600284604051610f309190612c6f565b602060405180830381855afa158015610f4d573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610f709190612c8b565b905080604084015280821880602086015250600360408501536041840188905260206061850153600284604051610fa79190612c6f565b602060405180830381855afa158015610fc4573d6000803e3d6000fd5b5050506040513d601f19601f82011682018060405250810190610fe79190612c8b565b606084015250909695505050505050565b61100061265e565b604051638669026f60e01b81526000903090638669026f906110289087908790600401612bd8565b6040805180830381865afa158015611044573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110689190612ca4565b805160405163d58e773360e01b81526004810191909152909150600090309063d58e7733906024016040805180830381865afa1580156110ac573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906110d09190612ca4565b602083015160405163d58e773360e01b81526004810191909152909150600090309063d58e7733906024016040805180830381865afa158015611117573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061113b9190612ca4565b905061114561267c565b825181526020808401518282015282516040808401919091529083015160608301526000908460808460066107d05a03fa9050808061118057fe5b50806111c85760405162461bcd60e51b8152602060048201526017602482015276109314ce88189b881859190818d85b1b0819985a5b1959604a1b60448201526064016103d9565b50919695505050505050565b6111dc61265e565b600080516020612d6383398151915282106112455760405162461bcd60e51b815260206004820152602360248201527f6d6170546f506f696e7446543a20696e76616c6964206669656c6420656c656d604482015262195b9d60ea1b60648201526084016103d9565b81600061125182611790565b9150506000600080516020612d638339815191528061127257611272612cf9565b8384099050600080516020612d638339815191526004820890506000600080516020612d6383398151915277b3c4d79d41a91759a9e4c7e359b6b89eaec68e62effffffd850990506000600080516020612d6383398151915283830990506112d9816117b9565b9050600080516020612d638339815191528283099150600080516020612d638339815191528183099150600080516020612d638339815191528286099150600080516020612d6383398151915261133e83600080516020612d63833981519152612d0f565b7759e26bcea0d48bacd4f263f1acdb5c4f5763473177fffffe089450600080516020612d638339815191528586099150600080516020612d638339815191528583099150600080516020612d6383398151915260038308915060006113a283611790565b909350905080156113ea57846113cd576113ca83600080516020612d63833981519152612d0f565b92505b505060408051808201909152938452602084015250909392505050565b600080516020612d638339815191526001870861141590600080516020612d63833981519152612d0f565b9550600080516020612d638339815191528687099250600080516020612d638339815191528684099250600080516020612d6383398151915260038408925061145d83611790565b9093509050801561148557846113cd576113ca83600080516020612d63833981519152612d0f565b600080516020612d638339815191528485099550600080516020612d638339815191528687099550600080516020612d638339815191528287099550600080516020612d638339815191528287099550600080516020612d63833981519152600187089550600080516020612d638339815191528687099250600080516020612d638339815191528684099250600080516020612d6383398151915260038408925061153083611790565b90935090508061158d5760405162461bcd60e51b815260206004820152602260248201527f424c533a20626164206674206d617070696e6720696d706c656d656e7461746960448201526137b760f11b60648201526084016103d9565b846113cd576113ca83600080516020612d63833981519152612d0f565b600081516020830151600080516020612d63833981519152828309600080516020612d638339815191528382099050600080516020612d63833981519152600382089050600080516020612d6383398151915282830914949350505050565b60008060006040518061018001604052808760006002811061162d5761162d612b06565b602002013581526020018760016002811061164a5761164a612b06565b60200201358152602001600080516020612d438339815191528152602001600080516020612d238339815191528152602001600080516020612d838339815191528152602001600080516020612da38339815191528152602001856000600281106116b7576116b7612b06565b60200201358152602001856001600281106116d4576116d4612b06565b60200201358152602001866001600481106116f1576116f1612b06565b602002013581526020018660006004811061170e5761170e612b06565b602002013581526020018660036004811061172b5761172b612b06565b602002013581526020018660026004811061174857611748612b06565b602002013590529050611759612640565b60006020826101808560085afa90508061177c5760008094509450505050611788565b50511515925060019150505b935093915050565b60008061179c836117c4565b915082600080516020612d63833981519152838409149050915091565b60006103b282611ef9565b6000600080516020612d638339815191528083840991508083830981838209828283098385830984848309858484098684850997508684840987858409945087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087838a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985050868889099750868889099750868889099750868889099750868889099750868889099750868489099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868689099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868189099750508587880996508587880996508587880996508585880996508587880996508587880996508587880996508585880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508587880996508581880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508584880996508587880996508587880996508587880996508587880996508587880996508581880996505050505050808283099392505050565b6000600080516020612d638339815191528083840991508083830981838209828283098385830984848309858484098684850997508684840987858409945087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087878a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a09985087898a09985087898a09985087898a09985087838a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087828a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087848a09985087898a09985087898a09985087898a09985087898a09985087898a09985087868a09985087898a09985087898a099850878a8a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087898a09985087818a09985050868889099750868889099750868889099750868889099750868889099750868889099750868489099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868889099750868989099750868889099750868889099750868889099750868889099750868889099750868689099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868889099750868189099750508587880996508587880996508587880996508585880996508587880996508587880996508587880996508585880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508587880996508583880996508587880996508587880996508587880996508587880996508581880996505050838586099450838586099450838586099450838586099450838186099450508284850993508284850993508284850993508281850993508284850993508284850993508285850993508284850993508284850993508284850993508284850993508284850993508284850993508281850995945050505050565b60405180602001604052806001906020820280368337509192915050565b60405180604001604052806002906020820280368337509192915050565b60405180608001604052806004906020820280368337509192915050565b634e487b7160e01b600052604160045260246000fd5b604080519081016001600160401b03811182821017156126d2576126d261269a565b60405290565b604051601f8201601f191681016001600160401b03811182821017156127005761270061269a565b604052919050565b60006080828403121561271a57600080fd5b82601f83011261272957600080fd5b604051608081018181106001600160401b038211171561274b5761274b61269a565b60405280608084018581111561276057600080fd5b845b8181101561277a578035835260209283019201612762565b509195945050505050565b60006040828403121561279757600080fd5b82601f8301126127a657600080fd5b6127ae6126b0565b8060408401858111156127c057600080fd5b845b818110156127da5780358452602093840193016127c2565b509095945050505050565b80604081018310156103b257600080fd5b60008083601f84011261280857600080fd5b5081356001600160401b0381111561281f57600080fd5b6020830191508360208260071b850101111561283a57600080fd5b9250929050565b60008060008060a0858703121561285757600080fd5b61286186866127e5565b935060408501356001600160401b0381111561287c57600080fd5b612888878288016127f6565b909450925061289c905086606087016127e5565b905092959194509250565b60006001600160401b038211156128c0576128c061269a565b50601f01601f191660200190565b600080604083850312156128e157600080fd5b8235915060208301356001600160401b038111156128fe57600080fd5b8301601f8101851361290f57600080fd5b803561292261291d826128a7565b6126d8565b81815286602083850101111561293757600080fd5b816020840160208301376000602083830101528093505050509250929050565b60408101818360005b600281101561297f578151835260209283019290910190600101612960565b50505092915050565b6000806000806000608086880312156129a057600080fd5b6129aa87876127e5565b945060408601356001600160401b03808211156129c657600080fd5b6129d289838a016127f6565b909650945060608801359150808211156129eb57600080fd5b818801915088601f8301126129ff57600080fd5b813581811115612a0e57600080fd5b8960208260061b8501011115612a2357600080fd5b9699959850939650602001949392505050565b60005b83811015612a51578181015183820152602001612a39565b50506000910152565b60008151808452612a72816020860160208601612a36565b601f01601f19169290920160200192915050565b602081526000612a996020830184612a5a565b9392505050565b600060208284031215612ab257600080fd5b5035919050565b60008060006101008486031215612acf57600080fd5b612ad985856127e5565b925060c0840185811115612aec57600080fd5b604085019250612afc86826127e5565b9150509250925092565b634e487b7160e01b600052603260045260246000fd5b600060208284031215612b2e57600080fd5b81518015158114612a9957600080fd5b60208082526021908201527f424c533a206e756d626572206f66207075626c6963206b6579206973207a65726040820152606f60f81b606082015260800190565b634e487b7160e01b600052601160045260246000fd5b808201808211156103b2576103b2612b7f565b80820281158282048414176103b2576103b2612b7f565b600060018201612bd157612bd1612b7f565b5060010190565b828152604060208201526000612bf16040830184612a5a565b949350505050565b600060208284031215612c0b57600080fd5b81516001600160401b03811115612c2157600080fd5b8201601f81018413612c3257600080fd5b8051612c4061291d826128a7565b818152856020838501011115612c5557600080fd5b612c66826020830160208601612a36565b95945050505050565b60008251612c81818460208701612a36565b9190910192915050565b600060208284031215612c9d57600080fd5b5051919050565b600060408284031215612cb657600080fd5b82601f830112612cc557600080fd5b612ccd6126b0565b806040840185811115612cdf57600080fd5b845b818110156127da578051845260209384019301612ce1565b634e487b7160e01b600052601260045260246000fd5b818103818111156103b2576103b2612b7f56fe1800deef121f1e76426a00665e5c4479674322d4f75edadd46debd5cd992f6ed198e9393920d483a7260bfb731fb5d25f1aa493335a9e71297e485b7aef312c230644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47275dc4a288d1afb3cbb1ac09187524c7db36395df7be3b99e673b13a075a65ec1d9befcd05a5323e6da4d435f3b617cdb3af83285c2df711ef39c01571827f9da264697066735822122085f910855a39dd4d2f9582253d737b6f9c450d7d8e7383f636149d598d69b6ac64736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000000103": { - "code": "0x73000000000000000000000000000000000000000030146080604052600080fdfea26469706673582212209ebefbbe674f8f0780cb158df4fa624dc1694693fcb1c5952691eb2a55c6f0aa64736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000000105": { - "code": "0x608060405234801561001057600080fd5b50600436106100d55760003560e01c8063947287cf11610087578063947287cf14610183578063972398b61461018c57806397e5230d1461019f57806399248ea7146101a9578063b66ceef6146101c2578063c885bc58146101d5578063cf756fdf146101dd578063e0563ab1146101f057600080fd5b806307358b99146100da57806322009af61461010d578063284017f51461011657806331d7a262146101375780633b878c221461015757806351351d53146101605780638a9cd82d1461016e575b600080fd5b6100fa6100e8366004610b1d565b60366020526000908152604090205481565b6040519081526020015b60405180910390f35b6100fa60355481565b61011f61202081565b6040516001600160a01b039091168152602001610104565b6100fa610145366004610b52565b60376020526000908152604090205481565b61011f61101081565b61011f6002600160a01b0381565b61018161017c366004610b74565b6101f9565b005b6100fa61520881565b60345461011f906001600160a01b031681565b6100fa620249f081565b60325461011f906201000090046001600160a01b031681565b60335461011f906001600160a01b031681565b610181610658565b6101816101eb366004610bf3565b61068e565b61011f61203081565b336002600160a01b03146102425760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b6000838152603660205260409020541561029e5760405162461bcd60e51b815260206004820152601a60248201527f5245574152445f414c52454144595f44495354524942555445440000000000006044820152606401610239565b603454604051633f490b0560e21b8152600481018590526000916001600160a01b03169063fd242c1490602401602060405180830381865afa1580156102e8573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061030c9190610c3e565b9050806000036103545760405162461bcd60e51b8152602060048201526013602482015272115413d0d217d393d517d0d3d3535255151151606a1b6044820152606401610239565b60345460408051636265600360e01b815290516000926001600160a01b03169163626560039160048083019260209291908290030181865afa15801561039e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103c29190610c3e565b905060006103d1826064610c6d565b836035546103df9190610c6d565b6103ea906064610c6d565b6103f49190610c8a565b603454604051630981b24d60e41b8152600481018990529192506000916001600160a01b039091169063981b24d090602401602060405180830381865afa158015610443573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104679190610c3e565b9050846000805b828110156105f857600089898381811061048a5761048a610cac565b9050604002018036038101906104a09190610cc2565b905087816020015111156104f65760405162461bcd60e51b815260206004820152601b60248201527f5349474e45445f424c4f434b535f455843454544535f544f54414c00000000006044820152606401610239565b603454815160405163277166bf60e11b81526001600160a01b039182166004820152602481018e90526000929190911690634ee2cd7e90604401602060405180830381865afa15801561054d573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105719190610c3e565b9050600061057f8a88610c6d565b602084015161058e848b610c6d565b6105989190610c6d565b6105a29190610c8a565b83516001600160a01b03166000908152603760205260408120805492935083929091906105d0908490610d27565b909155506105e090508186610d27565b945050505080806105f090610d3a565b91505061046e565b506000898152603660205260409020819055610613816107f1565b887feaf3d57629d9b1ce95715ccd98d6f5bf48023be1d5a06e09f64ab7f6d8be01d58260405161064591815260200190565b60405180910390a2505050505050505050565b3360008181526037602052604081208054919055603254909161068b916201000090046001600160a01b03169083610815565b50565b603254610100900460ff16158080156106ae5750603254600160ff909116105b806106c85750303b1580156106c8575060325460ff166001145b61072b5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610239565b6032805460ff19166001179055801561074e576032805461ff0019166101001790555b603280546001600160a01b03808816620100000262010000600160b01b031990921691909117909155603380548683166001600160a01b0319918216179091556034805492861692909116919091179055603582905580156107ea576032805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b60335460325461068b916001600160a01b036201000090920482169116308461087d565b6040516001600160a01b03831660248201526044810182905261087890849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b0319909316929092179091526108bb565b505050565b6040516001600160a01b03808516602483015283166044820152606481018290526108b59085906323b872dd60e01b90608401610841565b50505050565b6000610910826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b031661098d9092919063ffffffff16565b805190915015610878578080602001905181019061092e9190610d53565b6108785760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610239565b606061099c84846000856109a4565b949350505050565b606082471015610a055760405162461bcd60e51b815260206004820152602660248201527f416464726573733a20696e73756666696369656e742062616c616e636520666f6044820152651c8818d85b1b60d21b6064820152608401610239565b600080866001600160a01b03168587604051610a219190610d99565b60006040518083038185875af1925050503d8060008114610a5e576040519150601f19603f3d011682016040523d82523d6000602084013e610a63565b606091505b5091509150610a7487838387610a7f565b979650505050505050565b60608315610aee578251600003610ae7576001600160a01b0385163b610ae75760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610239565b508161099c565b61099c8383815115610b035781518083602001fd5b8060405162461bcd60e51b81526004016102399190610db5565b600060208284031215610b2f57600080fd5b5035919050565b80356001600160a01b0381168114610b4d57600080fd5b919050565b600060208284031215610b6457600080fd5b610b6d82610b36565b9392505050565b600080600060408486031215610b8957600080fd5b83359250602084013567ffffffffffffffff80821115610ba857600080fd5b818601915086601f830112610bbc57600080fd5b813581811115610bcb57600080fd5b8760208260061b8501011115610be057600080fd5b6020830194508093505050509250925092565b60008060008060808587031215610c0957600080fd5b610c1285610b36565b9350610c2060208601610b36565b9250610c2e60408601610b36565b9396929550929360600135925050565b600060208284031215610c5057600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b8082028115828204841417610c8457610c84610c57565b92915050565b600082610ca757634e487b7160e01b600052601260045260246000fd5b500490565b634e487b7160e01b600052603260045260246000fd5b600060408284031215610cd457600080fd5b6040516040810181811067ffffffffffffffff82111715610d0557634e487b7160e01b600052604160045260246000fd5b604052610d1183610b36565b8152602083013560208201528091505092915050565b80820180821115610c8457610c84610c57565b600060018201610d4c57610d4c610c57565b5060010190565b600060208284031215610d6557600080fd5b81518015158114610b6d57600080fd5b60005b83811015610d90578181015183820152602001610d78565b50506000910152565b60008251610dab818460208701610d75565b9190910192915050565b6020815260008251806020840152610dd4816040850160208701610d75565b601f01601f1916919091016040019291505056fea2646970667358221220c7e8b508ebaffb4eaa11ba374acb0ddc2570f6351d83600979bf1f82d7cec70564736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001001": { - "code": "0x608060405234801561001057600080fd5b50600436106100e05760003560e01c80639017c127116100875780639017c127146101de578063947287cf146101f157806397e5230d146101fa578063ad240c2a14610204578063c59a18f71461020d578063c6df461714610220578063e0563ab114610233578063eb70ef441461023c57600080fd5b8063196f1b2d146100e557806323e281cf1461010b578063284017f5146101145780633b878c221461013557806349ce89971461013e57806350d5b95b1461018857806351351d531461019d578063544c5e0f146101ab575b600080fd5b6100f86100f3366004610e88565b610271565b6040519081526020015b60405180910390f35b6100f860325481565b61011d61202081565b6040516001600160a01b039091168152602001610102565b61011d61101081565b61016d61014c366004610e88565b60356020526000908152604090208054600182015460029092015490919083565b60408051938452602084019290925290820152606001610102565b61019b610196366004610eec565b6102f0565b005b61011d6002600160a01b0381565b6101ce6101b9366004610e88565b60346020526000908152604090205460ff1681565b6040519015158152602001610102565b61019b6101ec366004610f5b565b6103b7565b6100f861520881565b6100f8620249f081565b6100f860335481565b6100f861021b366004610e88565b610557565b61019b61022e366004611007565b610578565b61011d61203081565b61024f61024a366004610e88565b61075c565b6040805182518152602080840151908201529181015190820152606001610102565b60008060358161028260368661081f565b81526020810191909152604001600020600201549050806102ea5760405162461bcd60e51b815260206004820152601d60248201527f537461746552656365697665723a204e4f5f524f4f545f464f525f494400000060448201526064015b60405180910390fd5b92915050565b60006102fc823561075c565b805190915061036c906103109084356110a5565b8251602084015161032191906110a5565b61032c9060016110b8565b83604001518787876040516020016103449190611110565b604051602081830303815290604052805190602001206108cc9095949392919063ffffffff16565b6103a85760405162461bcd60e51b815260206004820152600d60248201526c24a72b20a624a22fa82927a7a360991b60448201526064016102e1565b6103b182610a68565b50505050565b8281811461041a5760405162461bcd60e51b815260206004820152602a60248201527f537461746552656365697665723a20554e4d4154434845445f4c454e4754485f604482015269504152414d455445525360b01b60648201526084016102e1565b60005b8181101561054f57600061045485858481811061043c5761043c6111ac565b905060200281019061044e91906111c2565b3561075c565b905060006105088260000151878786818110610472576104726111ac565b905060200281019061048491906111c2565b61048f9190356110a5565b835160208501516104a091906110a5565b6104ab9060016110b8565b84604001518b8b888181106104c2576104c26111ac565b90506020028101906104d491906111e2565b8b8b8a8181106104e6576104e66111ac565b90506020028101906104f891906111c2565b6040516020016103449190611110565b90508061051957505060010161041d565b61054586868581811061052e5761052e6111ac565b905060200281019061054091906111c2565b610a68565b505060010161041d565b505050505050565b6036818154811061056757600080fd5b600091825260209091200154905081565b336002600160a01b03146105bc5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016102e1565b6033546105ca9060016110b8565b85351461060c5760405162461bcd60e51b815260206004820152601060248201526f1253959053125117d4d510549517d25160821b60448201526064016102e1565b8435602086013510156106525760405162461bcd60e51b815260206004820152600e60248201526d1253959053125117d1539117d25160921b60448201526064016102e1565b60408051863560208083019190915287013581830152908601356060820152610697906080016040516020818303038152906040528051906020012085858585610c83565b603280548691603591600091826106ad8361122b565b90915550815260208082019290925260409081016000208335815591830135600183015582013560028201555050603680546001810182556000919091526020868101357f4a11f94e20a93c79f6ec743a1954ec4fc2c08429ae2122118bf234b2185c81b89092018290556033829055604080519088013581528735917f11efd893530b26afc66d488ff54cb15df117cb6e0e4a08c6dcb166d766c3bf3b910160405180910390a35050505050565b604080516060810182526000808252602082018190529181018290529061078460368461081f565b60365490915081036107e45760405162461bcd60e51b815260206004820152602360248201527f537461746552656365697665723a204e4f5f434f4d4d49544d454e545f464f5260448201526217d25160ea1b60648201526084016102e1565b600090815260356020908152604091829020825160608101845281548152600182015492810192909252600201549181019190915292915050565b81546000908103610832575060006102ea565b82546000905b8082101561087f57600061084c8383610d87565b6000878152602090209091508590820154111561086b57809150610879565b6108768160016110b8565b92505b50610838565b6000821180156108ab5750836108a88661089a6001866110a5565b600091825260209091200190565b54145b156108c4576108bb6001836110a5565b925050506102ea565b509392505050565b6000816108da866001610da9565b811461091f5760405162461bcd60e51b81526020600482015260146024820152730929cac82989288bea0a49e9e8cbe988a9c8ea8960631b60448201526064016102e1565b8587106109635760405162461bcd60e51b81526020600482015260126024820152710929cac82989288be988a828cbe929c888ab60731b60448201526064016102e1565b8761099f5760405162461bcd60e51b815260206004820152600c60248201526b24a72b20a624a22fa622a0a360a11b60448201526064016102e1565b8760005b82811015610a595760008686838181106109bf576109bf6111ac565b90506020020135905060028a6109d5919061125a565b600003610a0d576040805160208101859052908101829052606001604051602081830303815290604052805190602001209250610a3a565b60408051602081018390529081018490526060016040516020818303038152906040528051906020012092505b610a4560028b61126e565b99505080610a529061122b565b90506109a3565b50909414979650505050505050565b803560009081526034602052604090205460ff1615610ad85760405162461bcd60e51b815260206004820152602660248201527f537461746552656365697665723a2053544154455f53594e435f49535f50524f60448201526510d154d4d15160d21b60648201526084016102e1565b610ae86060820160408301611282565b6001600160a01b03163b600003610b3c576040805160208082526000908201819052918335917f31c652130602f3ce96ceaf8a4c2b8b49f049166c6fcf2eb31943a75ec7c936ae910160405180910390a350565b8035600090815260346020526040808220805460ff191660011790558190610b6a9060608501908501611282565b6001600160a01b03168335610b856040860160208701611282565b610b92606087018761129d565b604051602401610ba594939291906112e3565b60408051601f198184030181529181526020820180516001600160e01b031663eeb4994560e01b17905251610bda919061133c565b6000604051808303816000865af19150503d8060008114610c17576040519150601f19603f3d011682016040523d82523d6000602084013e610c1c565b606091505b509150915081610c3f5782356000908152603460205260409020805460ff191690555b81151583600001357f31c652130602f3ce96ceaf8a4c2b8b49f049166c6fcf2eb31943a75ec7c936ae83604051610c76919061134e565b60405180910390a3505050565b6000806120306001600160a01b0316620249f08888888888604051602001610caf959493929190611381565b60408051601f1981840301815290829052610cc99161133c565b6000604051808303818686fa925050503d8060008114610d05576040519150601f19603f3d011682016040523d82523d6000602084013e610d0a565b606091505b5091509150600081806020019051810190610d2591906113ba565b9050828015610d315750805b610d7d5760405162461bcd60e51b815260206004820152601d60248201527f5349474e41545552455f564552494649434154494f4e5f4641494c454400000060448201526064016102e1565b5050505050505050565b6000610d96600284841861126e565b610da2908484166110b8565b9392505050565b600080610db584610df4565b90506001836002811115610dcb57610dcb6113dc565b148015610ddb575083816001901b105b610de6576000610de9565b60015b60ff16019392505050565b600080608083901c15610e0957608092831c92015b604083901c15610e1b57604092831c92015b602083901c15610e2d57602092831c92015b601083901c15610e3f57601092831c92015b600883901c15610e5157600892831c92015b600483901c15610e6357600492831c92015b600283901c15610e7557600292831c92015b600183901c156102ea5760010192915050565b600060208284031215610e9a57600080fd5b5035919050565b60008083601f840112610eb357600080fd5b5081356001600160401b03811115610eca57600080fd5b6020830191508360208260051b8501011115610ee557600080fd5b9250929050565b600080600060408486031215610f0157600080fd5b83356001600160401b0380821115610f1857600080fd5b610f2487838801610ea1565b90955093506020860135915080821115610f3d57600080fd5b50840160808187031215610f5057600080fd5b809150509250925092565b60008060008060408587031215610f7157600080fd5b84356001600160401b0380821115610f8857600080fd5b610f9488838901610ea1565b90965094506020870135915080821115610fad57600080fd5b50610fba87828801610ea1565b95989497509550505050565b60008083601f840112610fd857600080fd5b5081356001600160401b03811115610fef57600080fd5b602083019150836020828501011115610ee557600080fd5b600080600080600085870360a081121561102057600080fd5b606081121561102e57600080fd5b5085945060608601356001600160401b038082111561104c57600080fd5b61105889838a01610fc6565b9096509450608088013591508082111561107157600080fd5b5061107e88828901610fc6565b969995985093965092949392505050565b634e487b7160e01b600052601160045260246000fd5b818103818111156102ea576102ea61108f565b808201808211156102ea576102ea61108f565b80356001600160a01b03811681146110e257600080fd5b919050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60208152813560208201526000611129602084016110cb565b60018060a01b03808216604085015280611145604087016110cb565b16606085015250506060830135601e1984360301811261116457600080fd5b83016020810190356001600160401b0381111561118057600080fd5b80360382131561118f57600080fd5b6080808501526111a360a0850182846110e7565b95945050505050565b634e487b7160e01b600052603260045260246000fd5b60008235607e198336030181126111d857600080fd5b9190910192915050565b6000808335601e198436030181126111f957600080fd5b8301803591506001600160401b0382111561121357600080fd5b6020019150600581901b3603821315610ee557600080fd5b60006001820161123d5761123d61108f565b5060010190565b634e487b7160e01b600052601260045260246000fd5b60008261126957611269611244565b500690565b60008261127d5761127d611244565b500490565b60006020828403121561129457600080fd5b610da2826110cb565b6000808335601e198436030181126112b457600080fd5b8301803591506001600160401b038211156112ce57600080fd5b602001915036819003821315610ee557600080fd5b8481526001600160a01b038416602082015260606040820181905260009061130e90830184866110e7565b9695505050505050565b60005b8381101561133357818101518382015260200161131b565b50506000910152565b600082516111d8818460208701611318565b602081526000825180602084015261136d816040850160208701611318565b601f01601f19169190910160400192915050565b85815260606020820152600061139b6060830186886110e7565b82810360408401526113ae8185876110e7565b98975050505050505050565b6000602082840312156113cc57600080fd5b81518015158114610da257600080fd5b634e487b7160e01b600052602160045260246000fdfea2646970667358221220f4843af5244f1ef6b01f5d8fdd49e8f0e76508652a929df5979a03cb0156a6e864736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001002": { - "code": "0x608060405234801561001057600080fd5b50600436106100415760003560e01c806316f198311461004657806361bc221a1461005b578063a6f9885c14610076575b600080fd5b61005961005436600461017a565b61007f565b005b61006460005481565b60405190815260200160405180910390f35b61006461080081565b6001600160a01b0383166100cd5760405162461bcd60e51b815260206004820152601060248201526f24a72b20a624a22fa922a1a2a4ab22a960811b60448201526064015b60405180910390fd5b6108008111156101145760405162461bcd60e51b815260206004820152601260248201527108ab0868a8a88a6be9a82b0be988a9c8ea8960731b60448201526064016100c4565b826001600160a01b0316336001600160a01b031660008081546101369061020b565b9190508190557fedaf3c471ebd67d60c29efe34b639ede7d6a1d92eaeb3f503e784971e67118a5858560405161016d929190610232565b60405180910390a4505050565b60008060006040848603121561018f57600080fd5b83356001600160a01b03811681146101a657600080fd5b9250602084013567ffffffffffffffff808211156101c357600080fd5b818601915086601f8301126101d757600080fd5b8135818111156101e657600080fd5b8760208285010111156101f857600080fd5b6020830194508093505050509250925092565b60006001820161022b57634e487b7160e01b600052601160045260246000fd5b5060010190565b60208152816020820152818360408301376000818301604090810191909152601f909201601f1916010191905056fea26469706673582212207637618450354edc5d98998425a0a6500ada60d0a9d2cdc5b2045e291fd737f264736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001003": { - "code": "0x608060405234801561001057600080fd5b50600436106101215760003560e01c806340c10f19116100ad578063a457c2d711610071578063a457c2d71461028b578063a9059cbb1461029e578063dd62ed3e146102b1578063e6198705146102c4578063f6d2ee86146102d557600080fd5b806340c10f191461021f57806370a082311461023257806395d89b411461025b5780639b77ef11146102635780639dc29fac1461027857600080fd5b80631f2d0065116100f45780631f2d00651461018c57806323b872dd146101b15780632d0335ab146101c4578063313ce567146101ed578063395093511461020c57600080fd5b806306fdde0314610126578063095ea7b3146101445780630c53c51c1461016757806318160ddd1461017a575b600080fd5b61012e6102e8565b60405161013b91906113b6565b60405180910390f35b6101576101523660046113ec565b61037a565b604051901515815260200161013b565b61012e610175366004611470565b61039e565b603c545b60405190815260200161013b565b606d546001600160a01b03165b6040516001600160a01b03909116815260200161013b565b6101576101bf3660046114e6565b610681565b61017e6101d2366004611522565b6001600160a01b031660009081526006602052604090205490565b606d54600160a01b900460ff1660405160ff909116815260200161013b565b61015761021a3660046113ec565b6106af565b61015761022d3660046113ec565b6106db565b61017e610240366004611522565b6001600160a01b03166000908152603a602052604090205490565b61012e61071b565b61027661027136600461153d565b61072a565b005b6101576102863660046113ec565b610751565b6101576102993660046113ec565b610788565b6101576102ac3660046113ec565b61080e565b61017e6102bf366004611556565b610826565b606c546001600160a01b0316610199565b6102766102e3366004611589565b610851565b6060603d80546102f79061160d565b80601f01602080910402602001604051908101604052809291908181526020018280546103239061160d565b80156103705780601f1061034557610100808354040283529160200191610370565b820191906000526020600020905b81548152906001019060200180831161035357829003601f168201915b5050505050905090565b600080610385610ad1565b9050610392818585610ae0565b60019150505b92915050565b606060006103e187878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610c0592505050565b90506001600160e01b031960003581169082160361046c5760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f6400000060648201526084015b60405180910390fd5b604080516060810182526001600160a01b038a16600081815260066020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506104dd8982888888610c20565b6105335760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b6064820152608401610463565b600660008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d60405160200161058893929190611647565b60408051601f19818403018152908290526105a29161166d565b6000604051808303816000865af19150503d80600081146105df576040519150601f19603f3d011682016040523d82523d6000602084013e6105e4565b606091505b5091509150816106365760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c000000006044820152606401610463565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c60405161066b9493929190611689565b60405180910390a19a9950505050505050505050565b60008061068c610ad1565b9050610699858285610cfc565b6106a4858585610d76565b506001949350505050565b6000806106ba610ad1565b90506103928185856106cc8589610826565b6106d691906116d5565b610ae0565b606c546000906001600160a01b031633146107085760405162461bcd60e51b8152600401610463906116f6565b6107128383610f0f565b50600192915050565b6060603e80546102f79061160d565b33600090815260066020526040812080548392906107499084906116d5565b909155505050565b606c546000906001600160a01b0316331461077e5760405162461bcd60e51b8152600401610463906116f6565b6107128383610fbf565b600080610793610ad1565b905060006107a18286610826565b9050838110156108015760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b6064820152608401610463565b6106a48286868403610ae0565b600080610819610ad1565b9050610392818585610d76565b6001600160a01b039182166000908152603b6020908152604080832093909416825291909152205490565b600754610100900460ff16158080156108715750600754600160ff909116105b8061088b5750303b15801561088b575060075460ff166001145b6108ee5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610463565b6007805460ff191660011790558015610911576007805461ff0019166101001790555b6001600160a01b0387161580159061092857508415155b801561093357508215155b61097f5760405162461bcd60e51b815260206004820152601e60248201527f4368696c6445524332303a204241445f494e495449414c495a4154494f4e00006044820152606401610463565b606d805460ff8416600160a01b026001600160a81b03199091166001600160a01b038a1617179055606c80546001600160a01b03191633179055604080516020601f8801819004810282018101909252868152610a2a91889088908190840183828082843760009201919091525050604080516020601f8a0181900481028201810190925288815292508891508790819084018382808284376000920191909152506110de92505050565b610a8286868080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506040805180820190915260018152603160f81b6020820152915061110f9050565b8015610ac8576007805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050505050565b6000610adb61117b565b905090565b6001600160a01b038316610b425760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b6064820152608401610463565b6001600160a01b038216610ba35760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b6064820152608401610463565b6001600160a01b038381166000818152603b602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92591015b60405180910390a3505050565b60008151600003610c1857506000919050565b506020015190565b6000806001610c36610c31886111d7565b611254565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015610c84573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116610cdb5760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b6044820152606401610463565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6000610d088484610826565b90506000198114610d705781811015610d635760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e63650000006044820152606401610463565b610d708484848403610ae0565b50505050565b6001600160a01b038316610dda5760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b6064820152608401610463565b6001600160a01b038216610e3c5760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b6064820152608401610463565b6001600160a01b0383166000908152603a602052604090205481811015610eb45760405162461bcd60e51b815260206004820152602660248201527f45524332303a207472616e7366657220616d6f756e7420657863656564732062604482015265616c616e636560d01b6064820152608401610463565b6001600160a01b038085166000818152603a602052604080822086860390559286168082529083902080548601905591516000805160206118ec83398151915290610f029086815260200190565b60405180910390a3610d70565b6001600160a01b038216610f655760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f2061646472657373006044820152606401610463565b80603c6000828254610f7791906116d5565b90915550506001600160a01b0382166000818152603a60209081526040808320805486019055518481526000805160206118ec833981519152910160405180910390a35b5050565b6001600160a01b03821661101f5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b6064820152608401610463565b6001600160a01b0382166000908152603a6020526040902054818110156110935760405162461bcd60e51b815260206004820152602260248201527f45524332303a206275726e20616d6f756e7420657863656564732062616c616e604482015261636560f01b6064820152608401610463565b6001600160a01b0383166000818152603a602090815260408083208686039055603c80548790039055518581529192916000805160206118ec8339815191529101610bf8565b505050565b600754610100900460ff166111055760405162461bcd60e51b815260040161046390611739565b610fbb82826112a2565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f61115d8184846112e2565b600055600280546001600160a01b0319163017905560055550505050565b60003033036111d157600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506111d49050565b50335b90565b60006040518060800160405280604381526020016118a96043913980516020918201208351848301516040808701518051908601209051611237950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b600061039861126161132b565b8360405161190160f01b6020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b600754610100900460ff166112c95760405162461bcd60e51b815260040161046390611739565b603d6112d583826117e8565b50603e6110d982826117e8565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b6002546000906001600160a01b031630148015611349575060015446145b15611355575060005490565b610adb6005546003546004546112e2565b60005b83811015611381578181015183820152602001611369565b50506000910152565b600081518084526113a2816020860160208601611366565b601f01601f19169290920160200192915050565b6020815260006113c9602083018461138a565b9392505050565b80356001600160a01b03811681146113e757600080fd5b919050565b600080604083850312156113ff57600080fd5b611408836113d0565b946020939093013593505050565b60008083601f84011261142857600080fd5b50813567ffffffffffffffff81111561144057600080fd5b60208301915083602082850101111561145857600080fd5b9250929050565b803560ff811681146113e757600080fd5b60008060008060008060a0878903121561148957600080fd5b611492876113d0565b9550602087013567ffffffffffffffff8111156114ae57600080fd5b6114ba89828a01611416565b90965094505060408701359250606087013591506114da6080880161145f565b90509295509295509295565b6000806000606084860312156114fb57600080fd5b611504846113d0565b9250611512602085016113d0565b9150604084013590509250925092565b60006020828403121561153457600080fd5b6113c9826113d0565b60006020828403121561154f57600080fd5b5035919050565b6000806040838503121561156957600080fd5b611572836113d0565b9150611580602084016113d0565b90509250929050565b600080600080600080608087890312156115a257600080fd5b6115ab876113d0565b9550602087013567ffffffffffffffff808211156115c857600080fd5b6115d48a838b01611416565b909750955060408901359150808211156115ed57600080fd5b506115fa89828a01611416565b90945092506114da90506060880161145f565b600181811c9082168061162157607f821691505b60208210810361164157634e487b7160e01b600052602260045260246000fd5b50919050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b6000825161167f818460208701611366565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b8082018082111561039857634e487b7160e01b600052601160045260246000fd5b60208082526023908201527f4368696c6445524332303a204f6e6c79207072656469636174652063616e2063604082015262185b1b60ea1b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f8211156110d957600081815260208120601f850160051c810160208610156117c15750805b601f850160051c820191505b818110156117e0578281556001016117cd565b505050505050565b815167ffffffffffffffff81111561180257611802611784565b61181681611810845461160d565b8461179a565b602080601f83116001811461184b57600084156118335750858301515b600019600386901b1c1916600185901b1785556117e0565b600085815260208120601f198616915b8281101561187a5788860151825594840194600190910190840161185b565b50858210156118985787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fe4d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa264697066735822122061cd8aae15b13c732c17323e6cfe2f585db1ab74b2c3384cbb12626088d7caa964736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001004": { - "code": "0x608060405234801561001057600080fd5b50600436106101165760003560e01c806397e5230d116100a2578063d41f177111610071578063d41f17711461023d578063e0563ab114610264578063eeb499451461026d578063f3fef3a314610280578063f64512551461029357600080fd5b806397e5230d146101e6578063b1768065146101f0578063b68ad1e414610217578063c3b35a7e1461022a57600080fd5b80633b878c22116100e95780633b878c221461017c57806351351d531461018557806371cf93b7146101935780637efab4f5146101a6578063947287cf146101cf57600080fd5b806305dc2e8f1461011b5780631459457a1461014b5780631bc114ba14610160578063284017f514610173575b600080fd5b60345461012e906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b61015e610159366004610f98565b6102ba565b005b60335461012e906001600160a01b031681565b61012e61202081565b61012e61101081565b61012e6002600160a01b0381565b60355461012e906001600160a01b031681565b61012e6101b4366004611009565b6037602052600090815260409020546001600160a01b031681565b6101d861520881565b604051908152602001610142565b6101d8620249f081565b6101d87f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60365461012e906001600160a01b031681565b61015e61023836600461102d565b61055a565b6101d87f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b61012e61203081565b61015e61027b36600461106e565b61056a565b61015e61028e3660046110f7565b61073e565b6101d87f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b336002600160a01b03146103035760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064015b60405180910390fd5b600054610100900460ff16158080156103235750600054600160ff909116105b8061033d5750303b15801561033d575060005460ff166001145b6103a05760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016102fa565b6000805460ff1916600117905580156103c3576000805461ff0019166101001790555b6001600160a01b038616158015906103e357506001600160a01b03851615155b80156103f757506001600160a01b03841615155b801561040b57506001600160a01b03831615155b6104675760405162461bcd60e51b815260206004820152602760248201527f4368696c6445524332305072656469636174653a204241445f494e495449414c60448201526624ad20aa24a7a760c91b60648201526084016102fa565b603380546001600160a01b03199081166001600160a01b03898116919091179092556034805482168884161790556035805482168784161790556036805490911685831617905582161561050c576001600160a01b03821660008181526037602052604080822080546001600160a01b03191661101090811790915590519092917f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d91a35b8015610552576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b61056583838361074d565b505050565b6034546001600160a01b031633146105d55760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f53544154455f6044820152672922a1a2a4ab22a960c11b60648201526084016102fa565b6035546001600160a01b038481169116146106435760405162461bcd60e51b815260206004820152602860248201527f4368696c6445524332305072656469636174653a204f4e4c595f524f4f545f50604482015267524544494341544560c01b60648201526084016102fa565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f821610672602060008486611123565b61067b9161114d565b0361069a576106956106908260208186611123565b610ac3565b610738565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad6106c9602060008486611123565b6106d29161114d565b036106e1576106958282610d6e565b60405162461bcd60e51b815260206004820152602660248201527f4368696c6445524332305072656469636174653a20494e56414c49445f5349476044820152654e415455524560d01b60648201526084016102fa565b50505050565b61074982338361074d565b5050565b826001600160a01b03163b6000036107b15760405162461bcd60e51b815260206004820152602160248201527f4368696c6445524332305072656469636174653a204e4f545f434f4e545241436044820152601560fa1b60648201526084016102fa565b6000836001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa1580156107f1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610815919061116b565b6001600160a01b038181166000908152603760205260409020549192508581169116146108545760405162461bcd60e51b81526004016102fa90611188565b6001600160a01b03811661086a5761086a6111cb565b306001600160a01b0316846001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156108b2573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906108d6919061116b565b6001600160a01b0316146108ec576108ec6111cb565b604051632770a7eb60e21b81526001600160a01b03851690639dc29fac9061091a90339086906004016111e1565b6020604051808303816000875af1158015610939573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061095d91906111fa565b6109a95760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204255524e5f4641494c454460448201526064016102fa565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152878116608083015260a08083018890528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610a349391169160c401611262565b600060405180830381600087803b158015610a4e57600080fd5b505af1158015610a62573d6000803e3d6000fd5b50505050826001600160a01b0316846001600160a01b0316826001600160a01b03167fa0923f060a16fc784558d43de424ffde7b01643de5e5d335851b9df94c76bb273386604051610ab59291906111e1565b60405180910390a450505050565b6000808080610ad48587018761128e565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610b175760405162461bcd60e51b81526004016102fa90611188565b806001600160a01b03163b600003610b3157610b316111cb565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b71573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b95919061116b565b9050856001600160a01b0316816001600160a01b031614610bb857610bb86111cb565b6001600160a01b038116610bce57610bce6111cb565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c16573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c3a919061116b565b6001600160a01b031614610c5057610c506111cb565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610c7e90879087906004016111e1565b6020604051808303816000875af1158015610c9d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610cc191906111fa565b610d0d5760405162461bcd60e51b815260206004820181905260248201527f4368696c6445524332305072656469636174653a204d494e545f4641494c454460448201526064016102fa565b836001600160a01b0316826001600160a01b0316876001600160a01b03167fdf34f3a3ed8bedc14a4b284ebaee5374d55b64bac6a84c270dabe8fd6b4cdafd8887604051610d5c9291906111e1565b60405180910390a45050505050505050565b6000808080610d7f85870187611382565b92975090955093509150506001600160a01b038416610da057610da06111cb565b6001600160a01b038481166000908152603760205260409020541615610dc857610dc86111cb565b6036546040516bffffffffffffffffffffffff19606087901b166020820152600091610e18916001600160a01b039091169060340160405160208183030381529060405280519060200120610ee3565b6001600160a01b038681166000908152603760205260409081902080546001600160a01b031916928416928317905551637b69774360e11b81529192509063f6d2ee8690610e7090889088908890889060040161140f565b600060405180830381600087803b158015610e8a57600080fd5b505af1158015610e9e573d6000803e3d6000fd5b50506040516001600160a01b038085169350881691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a350505050505050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b038116610f7a5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016102fa565b92915050565b6001600160a01b0381168114610f9557600080fd5b50565b600080600080600060a08688031215610fb057600080fd5b8535610fbb81610f80565b94506020860135610fcb81610f80565b93506040860135610fdb81610f80565b92506060860135610feb81610f80565b91506080860135610ffb81610f80565b809150509295509295909350565b60006020828403121561101b57600080fd5b813561102681610f80565b9392505050565b60008060006060848603121561104257600080fd5b833561104d81610f80565b9250602084013561105d81610f80565b929592945050506040919091013590565b6000806000806060858703121561108457600080fd5b84359350602085013561109681610f80565b9250604085013567ffffffffffffffff808211156110b357600080fd5b818701915087601f8301126110c757600080fd5b8135818111156110d657600080fd5b8860208285010111156110e857600080fd5b95989497505060200194505050565b6000806040838503121561110a57600080fd5b823561111581610f80565b946020939093013593505050565b6000808585111561113357600080fd5b8386111561114057600080fd5b5050820193919092039150565b80356020831015610f7a57600019602084900360031b1b1692915050565b60006020828403121561117d57600080fd5b815161102681610f80565b60208082526023908201527f4368696c6445524332305072656469636174653a20554e4d41505045445f544f60408201526225a2a760e91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b6001600160a01b03929092168252602082015260400190565b60006020828403121561120c57600080fd5b8151801515811461102657600080fd5b6000815180845260005b8181101561124257602081850181015186830182015201611226565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b03831681526040602082018190526000906112869083018461121c565b949350505050565b600080600080608085870312156112a457600080fd5b84356112af81610f80565b935060208501356112bf81610f80565b925060408501356112cf81610f80565b9396929550929360600135925050565b634e487b7160e01b600052604160045260246000fd5b600082601f83011261130657600080fd5b813567ffffffffffffffff80821115611321576113216112df565b604051601f8301601f19908116603f01168101908282118183101715611349576113496112df565b8160405283815286602085880101111561136257600080fd5b836020870160208301376000602085830101528094505050505092915050565b600080600080600060a0868803121561139a57600080fd5b8535945060208601356113ac81610f80565b9350604086013567ffffffffffffffff808211156113c957600080fd5b6113d589838a016112f5565b945060608801359150808211156113eb57600080fd5b506113f8888289016112f5565b925050608086013560ff81168114610ffb57600080fd5b6001600160a01b03851681526080602082018190526000906114339083018661121c565b8281036040840152611445818661121c565b91505060ff831660608301529594505050505056fea2646970667358221220040c22d73fe8215d2218893f5a7f6ab5ca23133aaf1f7ef7a037b72f1d8fea6d64736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001005": { - "code": "0x608060405234801561001057600080fd5b506004361061014d5760003560e01c806370a08231116100c3578063a22cb4651161007c578063a22cb465146102dd578063b2dc5dc3146102f0578063b88d4fde14610303578063c87b56dd14610316578063e619870514610329578063e985e9c51461033a57600080fd5b806370a08231146102765780637c88e3d914610289578063906571471461029c57806395d89b41146102af5780639b77ef11146102b75780639dc29fac146102ca57600080fd5b80631f2d0065116101155780631f2d0065146101e257806323b872dd146101f35780632d0335ab1461020657806340c10f191461023d57806342842e0e146102505780636352211e1461026357600080fd5b806301ffc9a71461015257806306fdde031461017a578063081812fc1461018f578063095ea7b3146101ba5780630c53c51c146101cf575b600080fd5b610165610160366004611a8c565b61034d565b60405190151581526020015b60405180910390f35b61018261039f565b6040516101719190611af9565b6101a261019d366004611b0c565b610431565b6040516001600160a01b039091168152602001610171565b6101cd6101c8366004611b41565b610458565b005b6101826101dd366004611bb3565b610584565b609f546001600160a01b03166101a2565b6101cd610201366004611c32565b610862565b61022f610214366004611c6e565b6001600160a01b031660009081526006602052604090205490565b604051908152602001610171565b61016561024b366004611b41565b61089a565b6101cd61025e366004611c32565b6108da565b6101a2610271366004611b0c565b6108f5565b61022f610284366004611c6e565b61092a565b610165610297366004611ccd565b6109b0565b6101cd6102aa366004611d38565b610a97565b610182610d05565b6101cd6102c5366004611b0c565b610d14565b6101656102d8366004611b41565b610d3b565b6101cd6102eb366004611db8565b610daa565b6101656102fe366004611df4565b610dc0565b6101cd610311366004611e5c565b610e6d565b610182610324366004611b0c565b610eac565b609e546001600160a01b03166101a2565b610165610348366004611f37565b610f20565b60006001600160e01b031982166380ac58cd60e01b148061037e57506001600160e01b03198216635b5e139f60e01b145b8061039957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6060606c80546103ae90611f6a565b80601f01602080910402602001604051908101604052809291908181526020018280546103da90611f6a565b80156104275780601f106103fc57610100808354040283529160200191610427565b820191906000526020600020905b81548152906001019060200180831161040a57829003601f168201915b5050505050905090565b600061043c82610f4e565b506000908152607060205260409020546001600160a01b031690565b6000610463826108f5565b9050806001600160a01b0316836001600160a01b0316036104d55760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084015b60405180910390fd5b806001600160a01b03166104e7610f76565b6001600160a01b03161480610503575061050381610348610f76565b6105755760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c00000060648201526084016104cc565b61057f8383610f85565b505050565b606060006105c787878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610ff392505050565b90506001600160e01b031960003581169082160361064d5760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f6400000060648201526084016104cc565b604080516060810182526001600160a01b038a16600081815260066020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506106be898288888861100e565b6107145760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b60648201526084016104cc565b600660008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d60405160200161076993929190611fa4565b60408051601f198184030181529082905261078391611fca565b6000604051808303816000865af19150503d80600081146107c0576040519150601f19603f3d011682016040523d82523d6000602084013e6107c5565b606091505b5091509150816108175760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c0000000060448201526064016104cc565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c60405161084c9493929190611fe6565b60405180910390a19a9950505050505050505050565b61087361086d610f76565b826110ea565b61088f5760405162461bcd60e51b81526004016104cc90612032565b61057f838383611148565b609e546000906001600160a01b031633146108c75760405162461bcd60e51b81526004016104cc9061207f565b6108d1838361129a565b50600192915050565b61057f83838360405180602001604052806000815250610e6d565b6000818152606e60205260408120546001600160a01b0316806103995760405162461bcd60e51b81526004016104cc906120c3565b60006001600160a01b0382166109945760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b60648201526084016104cc565b506001600160a01b03166000908152606f602052604090205490565b609e546000906001600160a01b031633146109dd5760405162461bcd60e51b81526004016104cc9061207f565b83828114610a2d5760405162461bcd60e51b815260206004820152601f60248201527f4368696c644552433732313a204172726179206c656e206d69736d617463680060448201526064016104cc565b60005b81811015610a8857610a80878783818110610a4d57610a4d6120f5565b9050602002016020810190610a629190611c6e565b868684818110610a7457610a746120f5565b9050602002013561129a565b600101610a30565b5060019150505b949350505050565b600754610100900460ff1615808015610ab75750600754600160ff909116105b80610ad15750303b158015610ad1575060075460ff166001145b610b345760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016104cc565b6007805460ff191660011790558015610b57576007805461ff0019166101001790555b6001600160a01b03861615801590610b6e57508315155b8015610b7957508115155b610bc55760405162461bcd60e51b815260206004820152601f60248201527f4368696c644552433732313a2042616420696e697469616c697a6174696f6e0060448201526064016104cc565b609f80546001600160a01b0388166001600160a01b031991821617909155609e805490911633179055604080516020601f8701819004810282018101909252858152610c5f91879087908190840183828082843760009201919091525050604080516020601f890181900481028201810190925287815292508791508690819084018382808284376000920191909152506112b492505050565b610cb785858080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250506040805180820190915260018152603160f81b602082015291506112e59050565b8015610cfd576007805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b505050505050565b6060606d80546103ae90611f6a565b3360009081526006602052604081208054839290610d3390849061210b565b909155505050565b609e546000906001600160a01b03163314610d685760405162461bcd60e51b81526004016104cc9061207f565b610d71826108f5565b6001600160a01b0316836001600160a01b031614610da15760405162461bcd60e51b81526004016104cc9061212c565b6108d182611351565b610dbc610db5610f76565b83836113d4565b5050565b609e546000906001600160a01b03163314610ded5760405162461bcd60e51b81526004016104cc9061207f565b8160005b81811015610e61576000858583818110610e0d57610e0d6120f5565b905060200201359050610e1f816108f5565b6001600160a01b0316876001600160a01b031614610e4f5760405162461bcd60e51b81526004016104cc9061212c565b610e5881611351565b50600101610df1565b50600195945050505050565b610e7e610e78610f76565b836110ea565b610e9a5760405162461bcd60e51b81526004016104cc90612032565b610ea68484848461149e565b50505050565b6060610eb782610f4e565b6000610ece60408051602081019091526000815290565b90506000815111610eee5760405180602001604052806000815250610f19565b80610ef8846114d1565b604051602001610f09929190612161565b6040516020818303038152906040525b9392505050565b6001600160a01b03918216600090815260716020908152604080832093909416825291909152205460ff1690565b610f5781611563565b610f735760405162461bcd60e51b81526004016104cc906120c3565b50565b6000610f80611580565b905090565b600081815260706020526040902080546001600160a01b0319166001600160a01b0384169081179091558190610fba826108f5565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000815160000361100657506000919050565b506020015190565b600080600161102461101f886115dc565b611659565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015611072573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b0381166110c95760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b60448201526064016104cc565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6000806110f6836108f5565b9050806001600160a01b0316846001600160a01b0316148061111d575061111d8185610f20565b80610a8f5750836001600160a01b031661113684610431565b6001600160a01b031614949350505050565b826001600160a01b031661115b826108f5565b6001600160a01b0316146111815760405162461bcd60e51b81526004016104cc90612190565b6001600160a01b0382166111e35760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b60648201526084016104cc565b826001600160a01b03166111f6826108f5565b6001600160a01b03161461121c5760405162461bcd60e51b81526004016104cc90612190565b600081815260706020908152604080832080546001600160a01b03199081169091556001600160a01b03878116808652606f8552838620805460001901905590871680865283862080546001019055868652606e909452828520805490921684179091559051849360008051602061244c83398151915291a4505050565b610dbc8282604051806020016040528060008152506116a7565b600754610100900460ff166112db5760405162461bcd60e51b81526004016104cc906121d5565b610dbc82826116da565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f61133381848461171a565b600055600280546001600160a01b0319163017905560055550505050565b600061135c826108f5565b9050611367826108f5565b600083815260706020908152604080832080546001600160a01b03199081169091556001600160a01b038516808552606f84528285208054600019019055878552606e9093528184208054909116905551929350849260008051602061244c833981519152908390a45050565b816001600160a01b0316836001600160a01b0316036114315760405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b60448201526064016104cc565b6001600160a01b03838116600081815260716020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6114a9848484611148565b6114b584848484611763565b610ea65760405162461bcd60e51b81526004016104cc90612220565b606060006114de83611868565b60010190506000816001600160401b038111156114fd576114fd611e46565b6040519080825280601f01601f191660200182016040528015611527576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a850494508461153157509392505050565b6000908152606e60205260409020546001600160a01b0316151590565b60003033036115d657600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506115d99050565b50335b90565b6000604051806080016040528060438152602001612409604391398051602091820120835184830151604080870151805190860120905161163c950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b6000610399611666611940565b8360405161190160f01b6020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b6116b1838361197b565b6116be6000848484611763565b61057f5760405162461bcd60e51b81526004016104cc90612220565b600754610100900460ff166117015760405162461bcd60e51b81526004016104cc906121d5565b606c61170d83826122b8565b50606d61057f82826122b8565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b60006001600160a01b0384163b1561186057836001600160a01b031663150b7a0261178c610f76565b8786866040518563ffffffff1660e01b81526004016117ae9493929190612377565b6020604051808303816000875af19250505080156117e9575060408051601f3d908101601f191682019092526117e6918101906123b4565b60015b611846573d808015611817576040519150601f19603f3d011682016040523d82523d6000602084013e61181c565b606091505b50805160000361183e5760405162461bcd60e51b81526004016104cc90612220565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050610a8f565b506001610a8f565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b83106118a75772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef810000000083106118d3576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc1000083106118f157662386f26fc10000830492506010015b6305f5e1008310611909576305f5e100830492506008015b612710831061191d57612710830492506004015b6064831061192f576064830492506002015b600a83106103995760010192915050565b6002546000906001600160a01b03163014801561195e575060015446145b1561196a575060005490565b610f8060055460035460045461171a565b6001600160a01b0382166119d15760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f206164647265737360448201526064016104cc565b6119da81611563565b156119f75760405162461bcd60e51b81526004016104cc906123d1565b611a0081611563565b15611a1d5760405162461bcd60e51b81526004016104cc906123d1565b6001600160a01b0382166000818152606f6020908152604080832080546001019055848352606e90915280822080546001600160a01b03191684179055518392919060008051602061244c833981519152908290a45050565b6001600160e01b031981168114610f7357600080fd5b600060208284031215611a9e57600080fd5b8135610f1981611a76565b60005b83811015611ac4578181015183820152602001611aac565b50506000910152565b60008151808452611ae5816020860160208601611aa9565b601f01601f19169290920160200192915050565b602081526000610f196020830184611acd565b600060208284031215611b1e57600080fd5b5035919050565b80356001600160a01b0381168114611b3c57600080fd5b919050565b60008060408385031215611b5457600080fd5b611b5d83611b25565b946020939093013593505050565b60008083601f840112611b7d57600080fd5b5081356001600160401b03811115611b9457600080fd5b602083019150836020828501011115611bac57600080fd5b9250929050565b60008060008060008060a08789031215611bcc57600080fd5b611bd587611b25565b955060208701356001600160401b03811115611bf057600080fd5b611bfc89828a01611b6b565b9096509450506040870135925060608701359150608087013560ff81168114611c2457600080fd5b809150509295509295509295565b600080600060608486031215611c4757600080fd5b611c5084611b25565b9250611c5e60208501611b25565b9150604084013590509250925092565b600060208284031215611c8057600080fd5b610f1982611b25565b60008083601f840112611c9b57600080fd5b5081356001600160401b03811115611cb257600080fd5b6020830191508360208260051b8501011115611bac57600080fd5b60008060008060408587031215611ce357600080fd5b84356001600160401b0380821115611cfa57600080fd5b611d0688838901611c89565b90965094506020870135915080821115611d1f57600080fd5b50611d2c87828801611c89565b95989497509550505050565b600080600080600060608688031215611d5057600080fd5b611d5986611b25565b945060208601356001600160401b0380821115611d7557600080fd5b611d8189838a01611b6b565b90965094506040880135915080821115611d9a57600080fd5b50611da788828901611b6b565b969995985093965092949392505050565b60008060408385031215611dcb57600080fd5b611dd483611b25565b915060208301358015158114611de957600080fd5b809150509250929050565b600080600060408486031215611e0957600080fd5b611e1284611b25565b925060208401356001600160401b03811115611e2d57600080fd5b611e3986828701611c89565b9497909650939450505050565b634e487b7160e01b600052604160045260246000fd5b60008060008060808587031215611e7257600080fd5b611e7b85611b25565b9350611e8960208601611b25565b92506040850135915060608501356001600160401b0380821115611eac57600080fd5b818701915087601f830112611ec057600080fd5b813581811115611ed257611ed2611e46565b604051601f8201601f19908116603f01168101908382118183101715611efa57611efa611e46565b816040528281528a6020848701011115611f1357600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b60008060408385031215611f4a57600080fd5b611f5383611b25565b9150611f6160208401611b25565b90509250929050565b600181811c90821680611f7e57607f821691505b602082108103611f9e57634e487b7160e01b600052602260045260246000fd5b50919050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b60008251611fdc818460208701611aa9565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b6020808252602d908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526c1c881bdc88185c1c1c9bdd9959609a1b606082015260800190565b60208082526024908201527f4368696c644552433732313a204f6e6c79207072656469636174652063616e2060408201526318d85b1b60e21b606082015260800190565b602080825260189082015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604082015260600190565b634e487b7160e01b600052603260045260246000fd5b8082018082111561039957634e487b7160e01b600052601160045260246000fd5b6020808252818101527f4368696c644552433732313a204f6e6c79206f776e65722063616e206275726e604082015260600190565b60008351612173818460208801611aa9565b835190830190612187818360208801611aa9565b01949350505050565b60208082526025908201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060408201526437bbb732b960d91b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b601f82111561057f57600081815260208120601f850160051c810160208610156122995750805b601f850160051c820191505b81811015610cfd578281556001016122a5565b81516001600160401b038111156122d1576122d1611e46565b6122e5816122df8454611f6a565b84612272565b602080601f83116001811461231a57600084156123025750858301515b600019600386901b1c1916600185901b178555610cfd565b600085815260208120601f198616915b828110156123495788860151825594840194600190910190840161232a565b50858210156123675787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6001600160a01b03858116825284166020820152604081018390526080606082018190526000906123aa90830184611acd565b9695505050505050565b6000602082840312156123c657600080fd5b8151610f1981611a76565b6020808252601c908201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060408201526060019056fe4d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa2646970667358221220ea3c02b950248f82ca74449c170966a8d3ba41ec46257d49989e4be74e94e63864736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001006": { - "code": "0x608060405234801561001057600080fd5b50600436106101375760003560e01c8063b68ad1e4116100b8578063e0563ab11161007c578063e0563ab1146102c0578063eeb49945146102c9578063f3fef3a3146102dc578063f6451255146102ef578063f691325c14610316578063f8c8765e1461032957600080fd5b8063b68ad1e414610225578063c3b35a7e14610238578063c5ac2b1c1461024b578063d41f177114610272578063d7c9e3ec1461029957600080fd5b80636f33e695116100ff5780636f33e6951461019f5780637efab4f5146101b4578063947287cf146101dd57806397e5230d146101f4578063b1768065146101fe57600080fd5b806305dc2e8f1461013c5780631bc114ba1461016c578063284017f51461017f5780633b878c221461018857806351351d5314610191575b600080fd5b60345461014f906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b60335461014f906001600160a01b031681565b61014f61202081565b61014f61101081565b61014f6002600160a01b0381565b6101b26101ad366004611617565b61033c565b005b61014f6101c2366004611699565b6037602052600090815260409020546001600160a01b031681565b6101e661520881565b604051908152602001610163565b6101e6620249f081565b6101e67f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b60365461014f906001600160a01b031681565b6101b26102463660046116bd565b610350565b6101e67faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6101e67f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101e67f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61014f61203081565b6101b26102d73660046116fe565b610360565b6101b26102ea366004611786565b610583565b6101e67f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b60355461014f906001600160a01b031681565b6101b26103373660046117b2565b610592565b61034985858585856107d1565b5050505050565b61035b838383610b35565b505050565b6034546001600160a01b031633146103d15760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f53544154456044820152682fa922a1a2a4ab22a960b91b60648201526084015b60405180910390fd5b6035546001600160a01b038481169116146104405760405162461bcd60e51b815260206004820152602960248201527f4368696c644552433732315072656469636174653a204f4e4c595f524f4f545f60448201526850524544494341544560b81b60648201526084016103c8565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82161046f60206000848661180e565b61047891611838565b036104975761049261048d826020818661180e565b610e3e565b61057d565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d186104c660206000848661180e565b6104cf91611838565b036104de5761049282826110b4565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61050d60206000848661180e565b61051691611838565b0361052557610492828261131a565b60405162461bcd60e51b815260206004820152602760248201527f4368696c644552433732315072656469636174653a20494e56414c49445f5349604482015266474e415455524560c81b60648201526084016103c8565b50505050565b61058e823383610b35565b5050565b336002600160a01b03146105d65760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016103c8565b600054610100900460ff16158080156105f65750600054600160ff909116105b806106105750303b158015610610575060005460ff166001145b6106735760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103c8565b6000805460ff191660011790558015610696576000805461ff0019166101001790555b6001600160a01b038516158015906106b657506001600160a01b03841615155b80156106ca57506001600160a01b03831615155b80156106de57506001600160a01b03821615155b61073b5760405162461bcd60e51b815260206004820152602860248201527f4368696c644552433732315072656469636174653a204241445f494e495449416044820152672624ad20aa24a7a760c11b60648201526084016103c8565b603380546001600160a01b038088166001600160a01b031992831617909255603480548784169083161790556035805486841690831617905560368054928516929091169190911790558015610349576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b846107db81611488565b6107f75760405162461bcd60e51b81526004016103c890611856565b6000866001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610837573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061085b9190611898565b6001600160a01b0381811660009081526037602052604090205491925088811691161461089a5760405162461bcd60e51b81526004016103c8906118b5565b6001600160a01b0381166108b0576108b06118f9565b306001600160a01b0316876001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156108f8573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061091c9190611898565b6001600160a01b031614610932576109326118f9565b84831461098d5760405162461bcd60e51b8152602060048201526024808201527f4368696c644552433732315072656469636174653a20494e56414c49445f4c4560448201526309c8ea8960e31b60648201526084016103c8565b60405163b2dc5dc360e01b81526001600160a01b0388169063b2dc5dc3906109bd90339088908890600401611941565b6020604051808303816000875af11580156109dc573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a00919061196f565b610a1c5760405162461bcd60e51b81526004016103c890611991565b6033546035546040516001600160a01b03928316926316f19831921690610a73907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908d908d908d908d90602001611a1b565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610a9f929190611ab5565b600060405180830381600087803b158015610ab957600080fd5b505af1158015610acd573d6000803e3d6000fd5b50505050336001600160a01b0316876001600160a01b0316826001600160a01b03167fa80bc76d6e1849a9088a9c00a2aeaa54eeb78f15565a18da3e8873438976f52289898989604051610b249493929190611ae1565b60405180910390a450505050505050565b82610b3f81611488565b610b5b5760405162461bcd60e51b81526004016103c890611856565b6000846001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610b9b573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bbf9190611898565b6001600160a01b03818116600090815260376020526040902054919250868116911614610bfe5760405162461bcd60e51b81526004016103c8906118b5565b6001600160a01b038116610c1457610c146118f9565b306001600160a01b0316856001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c5c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c809190611898565b6001600160a01b031614610c9657610c966118f9565b604051632770a7eb60e21b81526001600160a01b03861690639dc29fac90610cc49033908790600401611b13565b6020604051808303816000875af1158015610ce3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d07919061196f565b610d235760405162461bcd60e51b81526004016103c890611991565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152888116608083015260a08083018990528351808403909101815260c08301938490526316f1983160e01b909352938416936316f1983193610dae9391169160c401611ab5565b600060405180830381600087803b158015610dc857600080fd5b505af1158015610ddc573d6000803e3d6000fd5b50505050836001600160a01b0316856001600160a01b0316826001600160a01b03167f1e0ef6131232b1090efc3ec1cf7b53aa17f4b7cd8a4f9e033b49ee237379b0133387604051610e2f929190611b13565b60405180910390a45050505050565b6000808080610e4f85870187611b2c565b6001600160a01b0380851660009081526037602052604090205494985092965090945092501680610e925760405162461bcd60e51b81526004016103c8906118b5565b610e9b81611488565b610ea757610ea76118f9565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610ee7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f0b9190611898565b9050856001600160a01b0316816001600160a01b031614610f2e57610f2e6118f9565b6001600160a01b038116610f4457610f446118f9565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f8c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fb09190611898565b6001600160a01b031614610fc657610fc66118f9565b6040516340c10f1960e01b81526001600160a01b038316906340c10f1990610ff49087908790600401611b13565b6020604051808303816000875af1158015611013573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611037919061196f565b6110535760405162461bcd60e51b81526004016103c890611b7d565b836001600160a01b0316826001600160a01b0316876001600160a01b03167f37589fd8c906c19ea68eeb7e6b3e03efc06ff8aa4b1830588eba75f4375b161188876040516110a2929190611b13565b60405180910390a45050505050505050565b60008080806110c585870187611c92565b6001600160a01b0380851660009081526037602052604090205494995092975090955093501690508061110a5760405162461bcd60e51b81526004016103c8906118b5565b61111381611488565b61111f5761111f6118f9565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561115f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111839190611898565b9050856001600160a01b0316816001600160a01b0316146111a6576111a66118f9565b6001600160a01b0381166111bc576111bc6118f9565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015611204573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112289190611898565b6001600160a01b03161461123e5761123e6118f9565b604051637c88e3d960e01b81526001600160a01b03831690637c88e3d99061126c9087908790600401611d84565b6020604051808303816000875af115801561128b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112af919061196f565b6112cb5760405162461bcd60e51b81526004016103c890611b7d565b846001600160a01b0316826001600160a01b0316876001600160a01b03167fc1b1a5c1b97cc8e5ac82b47496f5ebdadf9c7d119b30a116e2bdafd56f6ed47587876040516110a2929190611d84565b6000808061132a84860186611e77565b91955093509150506001600160a01b038316611348576113486118f9565b6001600160a01b038381166000908152603760205260409020541615611370576113706118f9565b6036546040516bffffffffffffffffffffffff19606086901b1660208201526000916113c0916001600160a01b03909116906034016040516020818303038152906040528051906020012061151d565b6001600160a01b038581166000908152603760205260409081902080546001600160a01b031916928416928317905551639065714760e01b81529192509063906571479061141690879087908790600401611ef6565b600060405180830381600087803b15801561143057600080fd5b505af1158015611444573d6000803e3d6000fd5b50506040516001600160a01b038085169350871691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a3505050505050565b6000816001600160a01b03163b6000036114a457506000919050565b6040516301ffc9a760e01b81526380ac58cd60e01b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa92505050801561150b575060408051601f3d908101601f191682019092526115089181019061196f565b60015b61151757506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b0381166115175760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016103c8565b6001600160a01b03811681146115c957600080fd5b50565b60008083601f8401126115de57600080fd5b5081356001600160401b038111156115f557600080fd5b6020830191508360208260051b850101111561161057600080fd5b9250929050565b60008060008060006060868803121561162f57600080fd5b853561163a816115b4565b945060208601356001600160401b038082111561165657600080fd5b61166289838a016115cc565b9096509450604088013591508082111561167b57600080fd5b50611688888289016115cc565b969995985093965092949392505050565b6000602082840312156116ab57600080fd5b81356116b6816115b4565b9392505050565b6000806000606084860312156116d257600080fd5b83356116dd816115b4565b925060208401356116ed816115b4565b929592945050506040919091013590565b6000806000806060858703121561171457600080fd5b843593506020850135611726816115b4565b925060408501356001600160401b038082111561174257600080fd5b818701915087601f83011261175657600080fd5b81358181111561176557600080fd5b88602082850101111561177757600080fd5b95989497505060200194505050565b6000806040838503121561179957600080fd5b82356117a4816115b4565b946020939093013593505050565b600080600080608085870312156117c857600080fd5b84356117d3816115b4565b935060208501356117e3816115b4565b925060408501356117f3816115b4565b91506060850135611803816115b4565b939692955090935050565b6000808585111561181e57600080fd5b8386111561182b57600080fd5b5050820193919092039150565b8035602083101561151757600019602084900360031b1b1692915050565b60208082526022908201527f4368696c644552433732315072656469636174653a204e4f545f434f4e54524160408201526110d560f21b606082015260800190565b6000602082840312156118aa57600080fd5b81516116b6816115b4565b60208082526024908201527f4368696c644552433732315072656469636174653a20554e4d41505045445f5460408201526327a5a2a760e11b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561192857600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b0384168152604060208201819052600090611966908301848661190f565b95945050505050565b60006020828403121561198157600080fd5b815180151581146116b657600080fd5b60208082526021908201527f4368696c644552433732315072656469636174653a204255524e5f4641494c456040820152601160fa1b606082015260800190565b8183526000602080850194508260005b85811015611a105781356119f5816115b4565b6001600160a01b0316875295820195908201906001016119e2565b509495945050505050565b8781526001600160a01b0387811660208301528616604082015260a060608201819052600090611a4e90830186886119d2565b8281036080840152611a6181858761190f565b9a9950505050505050505050565b6000815180845260005b81811015611a9557602081850181015186830182015201611a79565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611ad990830184611a6f565b949350505050565b604081526000611af56040830186886119d2565b8281036020840152611b0881858761190f565b979650505050505050565b6001600160a01b03929092168252602082015260400190565b60008060008060808587031215611b4257600080fd5b8435611b4d816115b4565b93506020850135611b5d816115b4565b92506040850135611b6d816115b4565b9396929550929360600135925050565b60208082526021908201527f4368696c644552433732315072656469636174653a204d494e545f4641494c456040820152601160fa1b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611bfc57611bfc611bbe565b604052919050565b60006001600160401b03821115611c1d57611c1d611bbe565b5060051b60200190565b600082601f830112611c3857600080fd5b81356020611c4d611c4883611c04565b611bd4565b82815260059290921b84018101918181019086841115611c6c57600080fd5b8286015b84811015611c875780358352918301918301611c70565b509695505050505050565b600080600080600060a08688031215611caa57600080fd5b85359450602080870135611cbd816115b4565b94506040870135611ccd816115b4565b935060608701356001600160401b0380821115611ce957600080fd5b818901915089601f830112611cfd57600080fd5b8135611d0b611c4882611c04565b81815260059190911b8301840190848101908c831115611d2a57600080fd5b938501935b82851015611d51578435611d42816115b4565b82529385019390850190611d2f565b965050506080890135925080831115611d6957600080fd5b5050611d7788828901611c27565b9150509295509295909350565b604080825283519082018190526000906020906060840190828701845b82811015611dc65781516001600160a01b031684529284019290840190600101611da1565b5050508381038285015284518082528583019183019060005b81811015611dfb57835183529284019291840191600101611ddf565b5090979650505050505050565b600082601f830112611e1957600080fd5b81356001600160401b03811115611e3257611e32611bbe565b611e45601f8201601f1916602001611bd4565b818152846020838601011115611e5a57600080fd5b816020850160208301376000918101602001919091529392505050565b60008060008060808587031215611e8d57600080fd5b843593506020850135611e9f816115b4565b925060408501356001600160401b0380821115611ebb57600080fd5b611ec788838901611e08565b93506060870135915080821115611edd57600080fd5b50611eea87828801611e08565b91505092959194509250565b6001600160a01b0384168152606060208201819052600090611f1a90830185611a6f565b8281036040840152611f2c8185611a6f565b969550505050505056fea26469706673582212208eba5121cb4876752d628bd2b54f4310ad4179b29208ae7a3ec4d01fd9c07df564736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001007": { - "code": "0x608060405234801561001057600080fd5b50600436106101155760003560e01c806357128683116100a2578063e619870511610071578063e619870514610278578063e985e9c514610289578063f242432a146102c5578063f399e22e146102d8578063f5298aca146102eb57600080fd5b8063571286831461022c5780636b20c4541461023f5780639b77ef1114610252578063a22cb4651461026557600080fd5b8063156e29f6116100e9578063156e29f6146101965780631f2d0065146101a95780632d0335ab146101ce5780632eb2c2d6146101f75780634e1273f41461020c57600080fd5b8062fdd58e1461011a57806301ffc9a7146101405780630c53c51c146101635780630e89341c14610183575b600080fd5b61012d610128366004611cee565b6102fe565b6040519081526020015b60405180910390f35b61015361014e366004611d2e565b610399565b6040519015158152602001610137565b610176610171366004611d93565b6103e9565b6040516101379190611e62565b610176610191366004611e75565b6106c7565b6101536101a4366004611e8e565b61075b565b609f546001600160a01b03165b6040516001600160a01b039091168152602001610137565b61012d6101dc366004611ec1565b6001600160a01b031660009081526006602052604090205490565b61020a610205366004612025565b6107ad565b005b61021f61021a3660046120ce565b61080b565b60405161013791906121d3565b61015361023a36600461222a565b610934565b61015361024d3660046122c3565b610a4f565b61020a610260366004611e75565b610af6565b61020a610273366004612343565b610b1d565b609e546001600160a01b03166101b6565b61015361029736600461237f565b6001600160a01b039182166000908152606d6020908152604080832093909416825291909152205460ff1690565b61020a6102d33660046123b2565b610b33565b61020a6102e6366004612416565b610b8a565b6101536102f9366004611e8e565b610d9e565b60006001600160a01b03831661036e5760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b506000818152606c602090815260408083206001600160a01b03861684529091529020545b92915050565b60006001600160e01b03198216636cdb3d1360e11b14806103ca57506001600160e01b031982166303a24d0760e21b145b8061039357506301ffc9a760e01b6001600160e01b0319831614610393565b6060600061042c87878080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610dd692505050565b90506001600160e01b03196000358116908216036104b25760405162461bcd60e51b815260206004820152603d60248201527f66756e6374696f6e5369676e61747572652063616e206e6f74206265206f662060448201527f657865637574654d6574615472616e73616374696f6e206d6574686f640000006064820152608401610365565b604080516060810182526001600160a01b038a16600081815260066020908152848220548452808401929092528351601f8b0183900483028101830185528a815290938301918b908b9081908401838280828437600092019190915250505091525090506105238982888888610df1565b6105795760405162461bcd60e51b815260206004820152602160248201527f5369676e657220616e64207369676e617475726520646f206e6f74206d6174636044820152600d60fb1b6064820152608401610365565b600660008a6001600160a01b03166001600160a01b031681526020019081526020016000206000815460010191905081905550600080306001600160a01b03168a8a8d6040516020016105ce93929190612468565b60408051601f19818403018152908290526105e89161248e565b6000604051808303816000865af19150503d8060008114610625576040519150601f19603f3d011682016040523d82523d6000602084013e61062a565b606091505b50915091508161067c5760405162461bcd60e51b815260206004820152601c60248201527f46756e6374696f6e2063616c6c206e6f74207375636365737366756c000000006044820152606401610365565b7f5845892132946850460bff5a0083f71031bc5bf9aadcd40f1de79423eac9b10b8b338c8c6040516106b194939291906124aa565b60405180910390a19a9950505050505050505050565b6060606e80546106d6906124f6565b80601f0160208091040260200160405190810160405280929190818152602001828054610702906124f6565b801561074f5780601f106107245761010080835404028352916020019161074f565b820191906000526020600020905b81548152906001019060200180831161073257829003601f168201915b50505050509050919050565b609e546000906001600160a01b031633146107885760405162461bcd60e51b815260040161036590612530565b6107a384848460405180602001604052806000815250610ecd565b5060019392505050565b6107b5610fdc565b6001600160a01b0316856001600160a01b031614806107db57506107db85610297610fdc565b6107f75760405162461bcd60e51b815260040161036590612575565b6108048585858585610feb565b5050505050565b606081518351146108705760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b6064820152608401610365565b600083516001600160401b0381111561088b5761088b611edc565b6040519080825280602002602001820160405280156108b4578160200160208202803683370190505b50905060005b845181101561092c576108ff8582815181106108d8576108d86125c3565b60200260200101518583815181106108f2576108f26125c3565b60200260200101516102fe565b828281518110610911576109116125c3565b6020908102919091010152610925816125ef565b90506108ba565b509392505050565b609e546000906001600160a01b031633146109615760405162461bcd60e51b815260040161036590612530565b85848114801561097057508083145b6109bc5760405162461bcd60e51b815260206004820181905260248201527f4368696c64455243313135353a206172726179206c656e206d69736d617463686044820152606401610365565b60005b81811015610a4057610a388989838181106109dc576109dc6125c3565b90506020020160208101906109f19190611ec1565b888884818110610a0357610a036125c3565b90506020020135878785818110610a1c57610a1c6125c3565b9050602002013560405180602001604052806000815250610ecd565b6001016109bf565b50600198975050505050505050565b609e546000906001600160a01b03163314610a7c5760405162461bcd60e51b815260040161036590612530565b610aea8686868080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525050604080516020808a0282810182019093528982529093508992508891829185019084908082843760009201919091525061119592505050565b50600195945050505050565b3360009081526006602052604081208054839290610b15908490612608565b909155505050565b610b2f610b28610fdc565b838361132c565b5050565b610b3b610fdc565b6001600160a01b0316856001600160a01b03161480610b615750610b6185610297610fdc565b610b7d5760405162461bcd60e51b815260040161036590612575565b610804858585858561140c565b600754610100900460ff1615808015610baa5750600754600160ff909116105b80610bc45750303b158015610bc4575060075460ff166001145b610c275760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610365565b6007805460ff191660011790558015610c4a576007805461ff0019166101001790555b6001600160a01b038416610ca05760405162461bcd60e51b815260206004820181905260248201527f4368696c64455243313135353a204241445f494e495449414c495a4154494f4e6044820152606401610365565b609f80546001600160a01b0386166001600160a01b031991821617909155609e805490911633179055604080516020601f8501819004810282018101909252838152610d0691859085908190840183828082843760009201919091525061153392505050565b610d52610d1b856001600160a01b0316611566565b604051602001610d2b919061261b565b60408051601f1981840301815282820190915260018252603160f81b60208301529061157c565b8015610d98576007805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b50505050565b609e546000906001600160a01b03163314610dcb5760405162461bcd60e51b815260040161036590612530565b6107a38484846115e8565b60008151600003610de957506000919050565b506020015190565b6000806001610e07610e02886116e8565b611765565b6040805160008152602081018083529290925260ff861690820152606081018790526080810186905260a0016020604051602081039080840390855afa158015610e55573d6000803e3d6000fd5b5050604051601f1901519150506001600160a01b038116610eac5760405162461bcd60e51b8152602060048201526011602482015270496e76616c6964207369676e617475726560781b6044820152606401610365565b866001600160a01b0316816001600160a01b03161491505095945050505050565b6001600160a01b038416610f2d5760405162461bcd60e51b815260206004820152602160248201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736044820152607360f81b6064820152608401610365565b6000610f37610fdc565b90506000610f44856117b3565b90506000610f51856117b3565b90506000868152606c602090815260408083206001600160a01b038b16845290915281208054879290610f85908490612608565b909155505060408051878152602081018790526001600160a01b03808a169260009291871691600080516020612b0c833981519152910160405180910390a4610fd3836000898989896117fe565b50505050505050565b6000610fe6611959565b905090565b815183511461100c5760405162461bcd60e51b815260040161036590612650565b6001600160a01b0384166110325760405162461bcd60e51b815260040161036590612698565b600061103c610fdc565b905060005b845181101561112757600085828151811061105e5761105e6125c3565b60200260200101519050600085838151811061107c5761107c6125c3565b6020908102919091018101516000848152606c835260408082206001600160a01b038e1683529093529190912054909150818110156110cd5760405162461bcd60e51b8152600401610365906126dd565b6000838152606c602090815260408083206001600160a01b038e8116855292528083208585039055908b1682528120805484929061110c908490612608565b9250508190555050505080611120906125ef565b9050611041565b50846001600160a01b0316866001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb8787604051611177929190612727565b60405180910390a461118d8187878787876119b5565b505050505050565b6001600160a01b0383166111bb5760405162461bcd60e51b815260040161036590612755565b80518251146111dc5760405162461bcd60e51b815260040161036590612650565b60006111e6610fdc565b604080516020810190915260009052905060005b83518110156112bf576000848281518110611217576112176125c3565b602002602001015190506000848381518110611235576112356125c3565b6020908102919091018101516000848152606c835260408082206001600160a01b038c1683529093529190912054909150818110156112865760405162461bcd60e51b815260040161036590612798565b6000928352606c602090815260408085206001600160a01b038b16865290915290922091039055806112b7816125ef565b9150506111fa565b5060006001600160a01b0316846001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb8686604051611310929190612727565b60405180910390a4604080516020810190915260009052610d98565b816001600160a01b0316836001600160a01b03160361139f5760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b6064820152608401610365565b6001600160a01b038381166000818152606d6020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6001600160a01b0384166114325760405162461bcd60e51b815260040161036590612698565b600061143c610fdc565b90506000611449856117b3565b90506000611456856117b3565b90506000868152606c602090815260408083206001600160a01b038c1684529091529020548581101561149b5760405162461bcd60e51b8152600401610365906126dd565b6000878152606c602090815260408083206001600160a01b038d8116855292528083208985039055908a168252812080548892906114da908490612608565b909155505060408051888152602081018890526001600160a01b03808b16928c82169291881691600080516020612b0c833981519152910160405180910390a4611528848a8a8a8a8a6117fe565b505050505050505050565b600754610100900460ff1661155a5760405162461bcd60e51b8152600401610365906127dc565b61156381611a70565b50565b60606103936001600160a01b0383166014611aa0565b815160208084019190912082519183019190912060038290556004819055466001557f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f6115ca818484611c42565b600055600280546001600160a01b0319163017905560055550505050565b6001600160a01b03831661160e5760405162461bcd60e51b815260040161036590612755565b6000611618610fdc565b90506000611625846117b3565b90506000611632846117b3565b6040805160208082018352600091829052888252606c81528282206001600160a01b038b16835290522054909150848110156116805760405162461bcd60e51b815260040161036590612798565b6000868152606c602090815260408083206001600160a01b038b81168086529184528285208a8703905582518b81529384018a9052909290881691600080516020612b0c833981519152910160405180910390a4604080516020810190915260009052610fd3565b6000604051806080016040528060438152602001612b2c6043913980516020918201208351848301516040808701518051908601209051611748950193845260208401929092526001600160a01b03166040830152606082015260800190565b604051602081830303815290604052805190602001209050919050565b6000610393611772611c8b565b8360405161190160f01b6020820152602281018390526042810182905260009060620160405160208183030381529060405280519060200120905092915050565b604080516001808252818301909252606091600091906020808301908036833701905050905082816000815181106117ed576117ed6125c3565b602090810291909101015292915050565b6001600160a01b0384163b1561118d5760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e61906118429089908990889088908890600401612827565b6020604051808303816000875af192505050801561187d575060408051601f3d908101601f1916820190925261187a9181019061286c565b60015b61192957611889612889565b806308c379a0036118c2575061189d6128a4565b806118a857506118c4565b8060405162461bcd60e51b81526004016103659190611e62565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b6064820152608401610365565b6001600160e01b0319811663f23a6e6160e01b14610fd35760405162461bcd60e51b81526004016103659061292d565b60003033036119af57600080368080601f0160208091040260200160405190810160405280939291908181526020018383808284376000920191909152505050503601516001600160a01b031691506119b29050565b50335b90565b6001600160a01b0384163b1561118d5760405163bc197c8160e01b81526001600160a01b0385169063bc197c81906119f99089908990889088908890600401612975565b6020604051808303816000875af1925050508015611a34575060408051601f3d908101601f19168201909252611a319181019061286c565b60015b611a4057611889612889565b6001600160e01b0319811663bc197c8160e01b14610fd35760405162461bcd60e51b81526004016103659061292d565b600754610100900460ff16611a975760405162461bcd60e51b8152600401610365906127dc565b61156381611cc6565b60606000611aaf8360026129d3565b611aba906002612608565b6001600160401b03811115611ad157611ad1611edc565b6040519080825280601f01601f191660200182016040528015611afb576020820181803683370190505b509050600360fc1b81600081518110611b1657611b166125c3565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110611b4557611b456125c3565b60200101906001600160f81b031916908160001a9053506000611b698460026129d3565b611b74906001612608565b90505b6001811115611bec576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110611ba857611ba86125c3565b1a60f81b828281518110611bbe57611bbe6125c3565b60200101906001600160f81b031916908160001a90535060049490941c93611be5816129ea565b9050611b77565b508315611c3b5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610365565b9392505050565b6040805160208101859052908101839052606081018290524660808201523060a082015260009060c0016040516020818303038152906040528051906020012090509392505050565b6002546000906001600160a01b031630148015611ca9575060015446145b15611cb5575060005490565b610fe6600554600354600454611c42565b606e610b2f8282612a4c565b80356001600160a01b0381168114611ce957600080fd5b919050565b60008060408385031215611d0157600080fd5b611d0a83611cd2565b946020939093013593505050565b6001600160e01b03198116811461156357600080fd5b600060208284031215611d4057600080fd5b8135611c3b81611d18565b60008083601f840112611d5d57600080fd5b5081356001600160401b03811115611d7457600080fd5b602083019150836020828501011115611d8c57600080fd5b9250929050565b60008060008060008060a08789031215611dac57600080fd5b611db587611cd2565b955060208701356001600160401b03811115611dd057600080fd5b611ddc89828a01611d4b565b9096509450506040870135925060608701359150608087013560ff81168114611e0457600080fd5b809150509295509295509295565b60005b83811015611e2d578181015183820152602001611e15565b50506000910152565b60008151808452611e4e816020860160208601611e12565b601f01601f19169290920160200192915050565b602081526000611c3b6020830184611e36565b600060208284031215611e8757600080fd5b5035919050565b600080600060608486031215611ea357600080fd5b611eac84611cd2565b95602085013595506040909401359392505050565b600060208284031215611ed357600080fd5b611c3b82611cd2565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b0381118282101715611f1757611f17611edc565b6040525050565b60006001600160401b03821115611f3757611f37611edc565b5060051b60200190565b600082601f830112611f5257600080fd5b81356020611f5f82611f1e565b604051611f6c8282611ef2565b83815260059390931b8501820192828101915086841115611f8c57600080fd5b8286015b84811015611fa75780358352918301918301611f90565b509695505050505050565b600082601f830112611fc357600080fd5b81356001600160401b03811115611fdc57611fdc611edc565b604051611ff3601f8301601f191660200182611ef2565b81815284602083860101111561200857600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a0868803121561203d57600080fd5b61204686611cd2565b945061205460208701611cd2565b935060408601356001600160401b038082111561207057600080fd5b61207c89838a01611f41565b9450606088013591508082111561209257600080fd5b61209e89838a01611f41565b935060808801359150808211156120b457600080fd5b506120c188828901611fb2565b9150509295509295909350565b600080604083850312156120e157600080fd5b82356001600160401b03808211156120f857600080fd5b818501915085601f83011261210c57600080fd5b8135602061211982611f1e565b6040516121268282611ef2565b83815260059390931b850182019282810191508984111561214657600080fd5b948201945b8386101561216b5761215c86611cd2565b8252948201949082019061214b565b9650508601359250508082111561218157600080fd5b5061218e85828601611f41565b9150509250929050565b600081518084526020808501945080840160005b838110156121c8578151875295820195908201906001016121ac565b509495945050505050565b602081526000611c3b6020830184612198565b60008083601f8401126121f857600080fd5b5081356001600160401b0381111561220f57600080fd5b6020830191508360208260051b8501011115611d8c57600080fd5b6000806000806000806060878903121561224357600080fd5b86356001600160401b038082111561225a57600080fd5b6122668a838b016121e6565b9098509650602089013591508082111561227f57600080fd5b61228b8a838b016121e6565b909650945060408901359150808211156122a457600080fd5b506122b189828a016121e6565b979a9699509497509295939492505050565b6000806000806000606086880312156122db57600080fd5b6122e486611cd2565b945060208601356001600160401b038082111561230057600080fd5b61230c89838a016121e6565b9096509450604088013591508082111561232557600080fd5b50612332888289016121e6565b969995985093965092949392505050565b6000806040838503121561235657600080fd5b61235f83611cd2565b91506020830135801515811461237457600080fd5b809150509250929050565b6000806040838503121561239257600080fd5b61239b83611cd2565b91506123a960208401611cd2565b90509250929050565b600080600080600060a086880312156123ca57600080fd5b6123d386611cd2565b94506123e160208701611cd2565b9350604086013592506060860135915060808601356001600160401b0381111561240a57600080fd5b6120c188828901611fb2565b60008060006040848603121561242b57600080fd5b61243484611cd2565b925060208401356001600160401b0381111561244f57600080fd5b61245b86828701611d4b565b9497909650939450505050565b8284823760609190911b6bffffffffffffffffffffffff19169101908152601401919050565b600082516124a0818460208701611e12565b9190910192915050565b6001600160a01b0385811682528416602082015260606040820181905281018290526000828460808401376000608084840101526080601f19601f850116830101905095945050505050565b600181811c9082168061250a57607f821691505b60208210810361252a57634e487b7160e01b600052602260045260246000fd5b50919050565b60208082526025908201527f4368696c64455243313135353a204f6e6c79207072656469636174652063616e6040820152640818d85b1b60da1b606082015260800190565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b600060018201612601576126016125d9565b5060010190565b80820180821115610393576103936125d9565b6c4368696c64455243313135352d60981b81526000825161264381600d850160208701611e12565b91909101600d0192915050565b60208082526028908201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206040820152670dad2e6dac2e8c6d60c31b606082015260800190565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b60408152600061273a6040830185612198565b828103602084015261274c8185612198565b95945050505050565b60208082526023908201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260408201526265737360e81b606082015260800190565b60208082526024908201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604082015263616e636560e01b606082015260800190565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6001600160a01b03868116825285166020820152604081018490526060810183905260a06080820181905260009061286190830184611e36565b979650505050505050565b60006020828403121561287e57600080fd5b8151611c3b81611d18565b600060033d11156119b25760046000803e5060005160e01c90565b600060443d10156128b25790565b6040516003193d81016004833e81513d6001600160401b0381602484011181841117156128e157505050505090565b82850191508151818111156128f95750505050505090565b843d87010160208285010111156129135750505050505090565b61292260208286010187611ef2565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b6001600160a01b0386811682528516602082015260a0604082018190526000906129a190830186612198565b82810360608401526129b38186612198565b905082810360808401526129c78185611e36565b98975050505050505050565b8082028115828204841417610393576103936125d9565b6000816129f9576129f96125d9565b506000190190565b601f821115612a4757600081815260208120601f850160051c81016020861015612a285750805b601f850160051c820191505b8181101561118d57828155600101612a34565b505050565b81516001600160401b03811115612a6557612a65611edc565b612a7981612a7384546124f6565b84612a01565b602080601f831160018114612aae5760008415612a965750858301515b600019600386901b1c1916600185901b17855561118d565b600085815260208120601f198616915b82811015612add57888601518255948401946001909101908401612abe565b5085821015612afb5787850151600019600388901b60f8161c191681555b5050505050600190811b0190555056fec3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f624d6574615472616e73616374696f6e2875696e74323536206e6f6e63652c616464726573732066726f6d2c62797465732066756e6374696f6e5369676e617475726529a2646970667358221220cf72cc6dfec7557a549ae9a9c0f6f7dbddd3c040da94b9a82892a238de95698864736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001008": { - "code": "0x608060405234801561001057600080fd5b50600436106101375760003560e01c8063b1768065116100b8578063d41f17711161007c578063d41f177114610298578063d7c9e3ec146102bf578063e0563ab1146102e6578063eeb49945146102ef578063f645125514610302578063f8c8765e1461032957600080fd5b8063b176806514610211578063b5c5f67214610238578063b68ad1e41461024b578063b8cd3ec01461025e578063c5ac2b1c1461027157600080fd5b806351351d53116100ff57806351351d53146101a45780637efab4f5146101b257806386937eb4146101db578063947287cf146101f057806397e5230d1461020757600080fd5b8063051eb2e21461013c57806305dc2e8f1461016c5780631bc114ba1461017f578063284017f5146101925780633b878c221461019b575b600080fd5b60355461014f906001600160a01b031681565b6040516001600160a01b0390911681526020015b60405180910390f35b60345461014f906001600160a01b031681565b60335461014f906001600160a01b031681565b61014f61202081565b61014f61101081565b61014f6002600160a01b0381565b61014f6101c03660046115f0565b6037602052600090815260409020546001600160a01b031681565b6101ee6101e936600461165f565b61033c565b005b6101f961520881565b604051908152602001610163565b6101f9620249f081565b6101f97f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286981565b6101ee61024636600461170b565b610354565b60365461014f906001600160a01b031681565b6101ee61026c366004611740565b610365565b6101f97faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d1881565b6101f97f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82181565b6101f97f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed281565b61014f61203081565b6101ee6102fd366004611786565b610377565b6101f97f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad81565b6101ee61033736600461180e565b610597565b61034b878787878787876107d8565b50505050505050565b61036083338484610b57565b505050565b61037184848484610b57565b50505050565b6034546001600160a01b031633146103e95760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f5354415460448201526922afa922a1a2a4ab22a960b11b60648201526084015b60405180910390fd5b6035546001600160a01b038481169116146104595760405162461bcd60e51b815260206004820152602a60248201527f4368696c64455243313135355072656469636174653a204f4e4c595f524f4f546044820152695f50524544494341544560b01b60648201526084016103e0565b7f87a7811f4bfedea3d341ad165680ae306b01aaeacc205d227629cf157dd9f82161048860206000848661186a565b61049191611894565b036104b0576104ab6104a6826020818661186a565b610e6c565b610371565b7faf50c8eab81226bc79eee3a10e3fe25db1a2be7241130e392b0675df839b6d186104df60206000848661186a565b6104e891611894565b036104f7576104ab82826110d7565b7f2cef46a936bdc5b7e6e8c71aa04560c41cf7d88bb26901a7e7f4936ff02accad61052660206000848661186a565b61052f91611894565b0361053e576104ab8282611344565b60405162461bcd60e51b815260206004820152602860248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f5360448201526749474e415455524560c01b60648201526084016103e0565b336002600160a01b03146105db5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016103e0565b600054610100900460ff16158080156105fb5750600054600160ff909116105b806106155750303b158015610615575060005460ff166001145b6106785760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103e0565b6000805460ff19166001179055801561069b576000805461ff0019166101001790555b6001600160a01b038516158015906106bb57506001600160a01b03841615155b80156106cf57506001600160a01b03831615155b80156106e357506001600160a01b03821615155b6107415760405162461bcd60e51b815260206004820152602960248201527f4368696c64455243313135355072656469636174653a204241445f494e49544960448201526820a624ad20aa24a7a760b91b60648201526084016103e0565b603380546001600160a01b038088166001600160a01b0319928316179092556034805487841690831617905560358054868416908316179055603680549285169290911691909117905580156107d1576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050565b866107e2816114ac565b6107fe5760405162461bcd60e51b81526004016103e0906118b2565b6000886001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa15801561083e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061086291906118f5565b6001600160a01b038181166000908152603760205260409020549192508a81169116146108a15760405162461bcd60e51b81526004016103e090611912565b6001600160a01b0381166108b7576108b7611957565b306001600160a01b0316896001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa1580156108ff573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061092391906118f5565b6001600160a01b03161461093957610939611957565b868514801561094757508483145b6109a15760405162461bcd60e51b815260206004820152602560248201527f4368696c64455243313135355072656469636174653a20494e56414c49445f4c60448201526408a9c8ea8960db1b60648201526084016103e0565b604051631ac8311560e21b81526001600160a01b038a1690636b20c454906109d59033908a908a908a908a9060040161199f565b6020604051808303816000875af11580156109f4573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a1891906119e3565b610a345760405162461bcd60e51b81526004016103e090611a05565b6033546035546040516001600160a01b03928316926316f19831921690610a8f907f5fb452c5a8f2b7c7ef2984e2f1063c7ee9b80b110cdc98ccb98f6654e10b5ed290869033908f908f908f908f908f908f90602001611a90565b6040516020818303038152906040526040518363ffffffff1660e01b8152600401610abb929190611b41565b600060405180830381600087803b158015610ad557600080fd5b505af1158015610ae9573d6000803e3d6000fd5b50505050336001600160a01b0316896001600160a01b0316826001600160a01b03167f7a10660242ca367951ff3777cdb3c2a761e3ccad204bac118501e24693f3683d8b8b8b8b8b8b604051610b4496959493929190611b6d565b60405180910390a4505050505050505050565b83610b61816114ac565b610b7d5760405162461bcd60e51b81526004016103e0906118b2565b6000856001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610bbd573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610be191906118f5565b6001600160a01b03818116600090815260376020526040902054919250878116911614610c205760405162461bcd60e51b81526004016103e090611912565b6001600160a01b038116610c3657610c36611957565b306001600160a01b0316866001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c7e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ca291906118f5565b6001600160a01b031614610cb857610cb8611957565b604051637a94c56560e11b81526001600160a01b0387169063f5298aca90610ce890339088908890600401611bb6565b6020604051808303816000875af1158015610d07573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d2b91906119e3565b610d475760405162461bcd60e51b81526004016103e090611a05565b603354603554604080517f7a8dc26796a1e50e6e190b70259f58f6a4edd5b22280ceecc82b687b8e98286960208201526001600160a01b0385811682840152336060830152898116608083015260a0820189905260c08083018990528351808403909101815260e08301938490526316f1983160e01b909352938416936316f1983193610dd99391169160e401611b41565b600060405180830381600087803b158015610df357600080fd5b505af1158015610e07573d6000803e3d6000fd5b50505050846001600160a01b0316866001600160a01b0316826001600160a01b03167f2ca9093e8b5356801039806c6a08003e5b7013fb8ae48f720fc90fc1c1a8bec2338888604051610e5c93929190611bb6565b60405180910390a4505050505050565b600080808080610e7e86880188611bd7565b6001600160a01b03808616600090815260376020526040902054959a50939850919650945092501680610ec35760405162461bcd60e51b81526004016103e090611912565b610ecc816114ac565b610ed857610ed8611957565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f18573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f3c91906118f5565b9050866001600160a01b0316816001600160a01b031614610f5f57610f5f611957565b6001600160a01b038116610f7557610f75611957565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa158015610fbd573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610fe191906118f5565b6001600160a01b031614610ff757610ff7611957565b604051630ab714fb60e11b81526001600160a01b0383169063156e29f69061102790889088908890600401611bb6565b6020604051808303816000875af1158015611046573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061106a91906119e3565b6110865760405162461bcd60e51b81526004016103e090611c32565b846001600160a01b0316826001600160a01b0316886001600160a01b03167f2930d932c1cccd6add2e0e2d706ede9015db8a194405f2a3e1783703515e104f898888604051610b4493929190611bb6565b6000808080806110e986880188611d48565b6001600160a01b03808616600090815260376020526040902054959b5093995091975095509350169050806111305760405162461bcd60e51b81526004016103e090611912565b611139816114ac565b61114557611145611957565b6000816001600160a01b0316631f2d00656040518163ffffffff1660e01b8152600401602060405180830381865afa158015611185573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906111a991906118f5565b9050866001600160a01b0316816001600160a01b0316146111cc576111cc611957565b6001600160a01b0381166111e2576111e2611957565b306001600160a01b0316826001600160a01b031663e61987056040518163ffffffff1660e01b8152600401602060405180830381865afa15801561122a573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061124e91906118f5565b6001600160a01b03161461126457611264611957565b604051635712868360e01b81526001600160a01b0383169063571286839061129490889088908890600401611e8d565b6020604051808303816000875af11580156112b3573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112d791906119e3565b6112f35760405162461bcd60e51b81526004016103e090611c32565b856001600160a01b0316826001600160a01b0316886001600160a01b03167f17304b99f8dfa5a2b8dd5695d82f9947c2abfbc9cb64bab610b9a1a0feadb9a0888888604051610b4493929190611e8d565b60008061135383850185611f02565b9093509150506001600160a01b03821661136f5761136f611957565b6001600160a01b03828116600090815260376020526040902054161561139757611397611957565b6036546040516bffffffffffffffffffffffff19606085901b1660208201526000916113e7916001600160a01b039091169060340160405160208183030381529060405280519060200120611541565b6001600160a01b038481166000908152603760205260409081902080546001600160a01b0319169284169283179055516379ccf11760e11b81529192509063f399e22e9061143b9086908690600401611b41565b600060405180830381600087803b15801561145557600080fd5b505af1158015611469573d6000803e3d6000fd5b50506040516001600160a01b038085169350861691507f46bd56f98e1b14fd35691959270a6e1edf7cb8fcd489e0f9dda89e46c0d1ff0d90600090a35050505050565b6000816001600160a01b03163b6000036114c857506000919050565b6040516301ffc9a760e01b8152636cdb3d1360e11b60048201526001600160a01b038316906301ffc9a790602401602060405180830381865afa92505050801561152f575060408051601f3d908101601f1916820190925261152c918101906119e3565b60015b61153b57506000919050565b92915050565b6000763d602d80600a3d3981f3363d3d373d3d3d363d730000008360601b60e81c176000526e5af43d82803e903d91602b57fd5bf38360781b1760205281603760096000f590506001600160a01b03811661153b5760405162461bcd60e51b8152602060048201526017602482015276115490cc4c4d8dce8818dc99585d194c8819985a5b1959604a1b60448201526064016103e0565b6001600160a01b03811681146115ed57600080fd5b50565b60006020828403121561160257600080fd5b813561160d816115d8565b9392505050565b60008083601f84011261162657600080fd5b5081356001600160401b0381111561163d57600080fd5b6020830191508360208260051b850101111561165857600080fd5b9250929050565b60008060008060008060006080888a03121561167a57600080fd5b8735611685816115d8565b965060208801356001600160401b03808211156116a157600080fd5b6116ad8b838c01611614565b909850965060408a01359150808211156116c657600080fd5b6116d28b838c01611614565b909650945060608a01359150808211156116eb57600080fd5b506116f88a828b01611614565b989b979a50959850939692959293505050565b60008060006060848603121561172057600080fd5b833561172b816115d8565b95602085013595506040909401359392505050565b6000806000806080858703121561175657600080fd5b8435611761816115d8565b93506020850135611771816115d8565b93969395505050506040820135916060013590565b6000806000806060858703121561179c57600080fd5b8435935060208501356117ae816115d8565b925060408501356001600160401b03808211156117ca57600080fd5b818701915087601f8301126117de57600080fd5b8135818111156117ed57600080fd5b8860208285010111156117ff57600080fd5b95989497505060200194505050565b6000806000806080858703121561182457600080fd5b843561182f816115d8565b9350602085013561183f816115d8565b9250604085013561184f816115d8565b9150606085013561185f816115d8565b939692955090935050565b6000808585111561187a57600080fd5b8386111561188757600080fd5b5050820193919092039150565b8035602083101561153b57600019602084900360031b1b1692915050565b60208082526023908201527f4368696c64455243313135355072656469636174653a204e4f545f434f4e54526040820152621050d560ea1b606082015260800190565b60006020828403121561190757600080fd5b815161160d816115d8565b60208082526025908201527f4368696c64455243313135355072656469636174653a20554e4d41505045445f6040820152642a27a5a2a760d91b606082015260800190565b634e487b7160e01b600052600160045260246000fd5b81835260006001600160fb1b0383111561198657600080fd5b8260051b80836020870137939093016020019392505050565b6001600160a01b03861681526060602082018190526000906119c4908301868861196d565b82810360408401526119d781858761196d565b98975050505050505050565b6000602082840312156119f557600080fd5b8151801515811461160d57600080fd5b60208082526022908201527f4368696c64455243313135355072656469636174653a204255524e5f4641494c604082015261115160f21b606082015260800190565b8183526000602080850194508260005b85811015611a85578135611a6a816115d8565b6001600160a01b031687529582019590820190600101611a57565b509495945050505050565b8981526001600160a01b0389811660208301528816604082015260c060608201819052600090611ac3908301888a611a47565b8281036080840152611ad681878961196d565b905082810360a0840152611aeb81858761196d565b9c9b505050505050505050505050565b6000815180845260005b81811015611b2157602081850181015186830182015201611b05565b506000602082860101526020601f19601f83011685010191505092915050565b6001600160a01b0383168152604060208201819052600090611b6590830184611afb565b949350505050565b606081526000611b8160608301888a611a47565b8281036020840152611b9481878961196d565b90508281036040840152611ba981858761196d565b9998505050505050505050565b6001600160a01b039390931683526020830191909152604082015260600190565b600080600080600060a08688031215611bef57600080fd5b8535611bfa816115d8565b94506020860135611c0a816115d8565b93506040860135611c1a816115d8565b94979396509394606081013594506080013592915050565b60208082526022908201527f4368696c64455243313135355072656469636174653a204d494e545f4641494c604082015261115160f21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b0381118282101715611cb257611cb2611c74565b604052919050565b60006001600160401b03821115611cd357611cd3611c74565b5060051b60200190565b600082601f830112611cee57600080fd5b81356020611d03611cfe83611cba565b611c8a565b82815260059290921b84018101918181019086841115611d2257600080fd5b8286015b84811015611d3d5780358352918301918301611d26565b509695505050505050565b60008060008060008060c08789031215611d6157600080fd5b86359550602080880135611d74816115d8565b95506040880135611d84816115d8565b945060608801356001600160401b0380821115611da057600080fd5b818a0191508a601f830112611db457600080fd5b8135611dc2611cfe82611cba565b81815260059190911b8301840190848101908d831115611de157600080fd5b938501935b82851015611e08578435611df9816115d8565b82529385019390850190611de6565b9750505060808a0135925080831115611e2057600080fd5b611e2c8b848c01611cdd565b945060a08a0135925080831115611e4257600080fd5b5050611e5089828a01611cdd565b9150509295509295509295565b600081518084526020808501945080840160005b83811015611a8557815187529582019590820190600101611e71565b606080825284519082018190526000906020906080840190828801845b82811015611ecf5781516001600160a01b031684529284019290840190600101611eaa565b50505083810382850152611ee38187611e5d565b9150508281036040840152611ef88185611e5d565b9695505050505050565b600080600060608486031215611f1757600080fd5b83359250602080850135611f2a816115d8565b925060408501356001600160401b0380821115611f4657600080fd5b818701915087601f830112611f5a57600080fd5b813581811115611f6c57611f6c611c74565b611f7e601f8201601f19168501611c8a565b91508082528884828501011115611f9457600080fd5b8084840185840137600084828401015250809350505050925092509256fea26469706673582212200c4c5c9b53a533081213342cd86f6dcc2549159a1a5ec39ac85621bb137a4c8f64736f6c63430008130033", - "balance": "0x0" - }, - "0x0000000000000000000000000000000000001010": { - "code": "0x608060405234801561001057600080fd5b50600436106101425760003560e01c806370a08231116100b85780639dc29fac1161007c5780639dc29fac14610278578063a457c2d71461028b578063a9059cbb1461029e578063dd62ed3e146102b1578063e0563ab1146102c4578063e6198705146102cd57600080fd5b806370a082311461022d5780638420ce9914610248578063947287cf1461025d57806395d89b411461026657806397e5230d1461026e57600080fd5b8063284017f51161010a578063284017f5146101d2578063313ce567146101db57806339509351146101f05780633b878c221461020357806340c10f191461020c57806351351d531461021f57600080fd5b806306fdde0314610147578063095ea7b31461016557806318160ddd146101885780631f2d00651461019a57806323b872dd146101bf575b600080fd5b61014f6102de565b60405161015c9190610cfd565b60405180910390f35b610178610173366004610d4c565b610370565b604051901515815260200161015c565b6034545b60405190815260200161015c565b6036546001600160a01b03165b6040516001600160a01b03909116815260200161015c565b6101786101cd366004610d76565b61038a565b6101a761202081565b60395460405160ff909116815260200161015c565b6101786101fe366004610d4c565b6103ae565b6101a761101081565b61017861021a366004610d4c565b6103d0565b6101a76002600160a01b0381565b61018c61023b366004610db2565b6001600160a01b03163190565b61025b610256366004610e1d565b610419565b005b61018c61520881565b61014f6105c8565b61018c620249f081565b610178610286366004610d4c565b6105d7565b610178610299366004610d4c565b61060e565b6101786102ac366004610d4c565b610689565b61018c6102bf366004610ec8565b610697565b6101a761203081565b6035546001600160a01b03166101a7565b6060603780546102ed90610efb565b80601f016020809104026020016040519081016040528092919081815260200182805461031990610efb565b80156103665780601f1061033b57610100808354040283529160200191610366565b820191906000526020600020905b81548152906001019060200180831161034957829003601f168201915b5050505050905090565b60003361037e8185856106c2565b60019150505b92915050565b6000336103988582856107e6565b6103a3858585610860565b506001949350505050565b60003361037e8185856103c18383610697565b6103cb9190610f4b565b6106c2565b6035546000906001600160a01b031633146104065760405162461bcd60e51b81526004016103fd90610f5e565b60405180910390fd5b6104108383610a25565b50600192915050565b600054610100900460ff16158080156104395750600054600160ff909116105b806104535750303b158015610453575060005460ff166001145b6104b65760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b60648201526084016103fd565b6000805460ff1916600117905580156104d9576000805461ff0019166101001790555b336002600160a01b031461051d5760405163973d02cb60e01b815260206004820152600a60248201526914d654d5115350d0531360b21b60448201526064016103fd565b603580546001600160a01b03808b166001600160a01b03199283161790925560368054928a1692909116919091179055603761055a868883611007565b506038610568848683611007565b506039805460ff191660ff841617905580156105be576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050565b6060603880546102ed90610efb565b6035546000906001600160a01b031633146106045760405162461bcd60e51b81526004016103fd90610f5e565b6104108383610b7f565b6000338161061c8286610697565b90508381101561067c5760405162461bcd60e51b815260206004820152602560248201527f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f77604482015264207a65726f60d81b60648201526084016103fd565b6103a382868684036106c2565b60003361037e818585610860565b6001600160a01b03918216600090815260336020908152604080832093909416825291909152205490565b6001600160a01b0383166107245760405162461bcd60e51b8152602060048201526024808201527f45524332303a20617070726f76652066726f6d20746865207a65726f206164646044820152637265737360e01b60648201526084016103fd565b6001600160a01b0382166107855760405162461bcd60e51b815260206004820152602260248201527f45524332303a20617070726f766520746f20746865207a65726f206164647265604482015261737360f01b60648201526084016103fd565b6001600160a01b0383811660008181526033602090815260408083209487168084529482529182902085905590518481527f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a3505050565b60006107f28484610697565b9050600019811461085a578181101561084d5760405162461bcd60e51b815260206004820152601d60248201527f45524332303a20696e73756666696369656e7420616c6c6f77616e636500000060448201526064016103fd565b61085a84848484036106c2565b50505050565b6001600160a01b0383166108c45760405162461bcd60e51b815260206004820152602560248201527f45524332303a207472616e736665722066726f6d20746865207a65726f206164604482015264647265737360d81b60648201526084016103fd565b6001600160a01b0382166109265760405162461bcd60e51b815260206004820152602360248201527f45524332303a207472616e7366657220746f20746865207a65726f206164647260448201526265737360e81b60648201526084016103fd565b6000806120206001600160a01b031685858560405160200161094a939291906110c8565b60408051601f1981840301815290829052610964916110ec565b6000604051808303816000865af19150503d80600081146109a1576040519150601f19603f3d011682016040523d82523d6000602084013e6109a6565b606091505b50915091508180156109c75750808060200190518101906109c79190611108565b6109e35760405162461bcd60e51b81526004016103fd9061112a565b836001600160a01b0316856001600160a01b031660008051602061116e83398151915285604051610a1691815260200190565b60405180910390a35050505050565b6001600160a01b038216610a7b5760405162461bcd60e51b815260206004820152601f60248201527f45524332303a206d696e7420746f20746865207a65726f20616464726573730060448201526064016103fd565b8060346000828254610a8d9190610f4b565b9091555050604051600090819061202090610ab0908390879087906020016110c8565b60408051601f1981840301815290829052610aca916110ec565b6000604051808303816000865af19150503d8060008114610b07576040519150601f19603f3d011682016040523d82523d6000602084013e610b0c565b606091505b5091509150818015610b2d575080806020019051810190610b2d9190611108565b610b495760405162461bcd60e51b81526004016103fd9061112a565b6040518381526001600160a01b0385169060009060008051602061116e833981519152906020015b60405180910390a350505050565b6001600160a01b038216610bdf5760405162461bcd60e51b815260206004820152602160248201527f45524332303a206275726e2066726f6d20746865207a65726f206164647265736044820152607360f81b60648201526084016103fd565b8060346000828254610bf1919061115a565b9091555050604051600090819061202090610c14908690849087906020016110c8565b60408051601f1981840301815290829052610c2e916110ec565b6000604051808303816000865af19150503d8060008114610c6b576040519150601f19603f3d011682016040523d82523d6000602084013e610c70565b606091505b5091509150818015610c91575080806020019051810190610c919190611108565b610cad5760405162461bcd60e51b81526004016103fd9061112a565b6040518381526000906001600160a01b0386169060008051602061116e83398151915290602001610b71565b60005b83811015610cf4578181015183820152602001610cdc565b50506000910152565b6020815260008251806020840152610d1c816040850160208701610cd9565b601f01601f19169190910160400192915050565b80356001600160a01b0381168114610d4757600080fd5b919050565b60008060408385031215610d5f57600080fd5b610d6883610d30565b946020939093013593505050565b600080600060608486031215610d8b57600080fd5b610d9484610d30565b9250610da260208501610d30565b9150604084013590509250925092565b600060208284031215610dc457600080fd5b610dcd82610d30565b9392505050565b60008083601f840112610de657600080fd5b50813567ffffffffffffffff811115610dfe57600080fd5b602083019150836020828501011115610e1657600080fd5b9250929050565b600080600080600080600060a0888a031215610e3857600080fd5b610e4188610d30565b9650610e4f60208901610d30565b9550604088013567ffffffffffffffff80821115610e6c57600080fd5b610e788b838c01610dd4565b909750955060608a0135915080821115610e9157600080fd5b50610e9e8a828b01610dd4565b909450925050608088013560ff81168114610eb857600080fd5b8091505092959891949750929550565b60008060408385031215610edb57600080fd5b610ee483610d30565b9150610ef260208401610d30565b90509250929050565b600181811c90821680610f0f57607f821691505b602082108103610f2f57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b8082018082111561038457610384610f35565b60208082526024908201527f4e617469766545524332303a204f6e6c79207072656469636174652063616e2060408201526318d85b1b60e21b606082015260800190565b634e487b7160e01b600052604160045260246000fd5b601f82111561100257600081815260208120601f850160051c81016020861015610fdf5750805b601f850160051c820191505b81811015610ffe57828155600101610feb565b5050505b505050565b67ffffffffffffffff83111561101f5761101f610fa2565b6110338361102d8354610efb565b83610fb8565b6000601f841160018114611067576000851561104f5750838201355b600019600387901b1c1916600186901b1783556110c1565b600083815260209020601f19861690835b828110156110985786850135825560209485019460019092019101611078565b50868210156110b55760001960f88860031b161c19848701351681555b505060018560011b0183555b5050505050565b6001600160a01b039384168152919092166020820152604081019190915260600190565b600082516110fe818460208701610cd9565b9190910192915050565b60006020828403121561111a57600080fd5b81518015158114610dcd57600080fd5b60208082526016908201527514149150d3d35412531157d0d0531317d1905253115160521b604082015260600190565b8181038181111561038457610384610f3556feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa264697066735822122020d4a9c065f722d638ec115bf32ed1a8620dca26d052147ca0029d6b7b9aec9d64736f6c63430008130033", - "balance": "0x0" - }, - "0x61324166B0202DB1E7502924326262274Fa4358F": { - "balance": "0xf4240" - }, - "0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570": { - "balance": "0xd3c21bcecceda1000000" - } - }, - "number": "0x0", - "gasUsed": "0x70000", - "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000", - "baseFee": "0x0", - "baseFeeEM": "0x0" - }, - "params": { - "forks": { - "homestead": 0, - "byzantium": 0, - "constantinople": 0, - "petersburg": 0, - "istanbul": 0, - "EIP150": 0, - "EIP158": 0, - "EIP155": 0 - }, - "chainID": 0, - "engine": { - "polybft": { - "initialValidatorSet": [ - { - "address": "0x61324166B0202DB1E7502924326262274Fa4358F", - "blsKey": "06d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca", - "balance": "0xf4240", - "stake": "0xd3c21bcecceda1000000", - "multiAddr": "/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8" - }, - { - "address": "0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570", - "blsKey": "0601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f", - "balance": "0xd3c21bcecceda1000000", - "stake": "0xd3c21bcecceda1000000", - "multiAddr": "/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX" - } - ], - "bridge": null, - "epochSize": 10, - "epochReward": 1, - "sprintSize": 5, - "blockTime": "2s", - "governance": "0x61324166B0202DB1E7502924326262274Fa4358F", - "mintableNative": false, - "nativeTokenConfig": { - "name": "XGR", - "symbol": "WMATIC", - "decimals": 18 - }, - "initialTrieRoot": "0x0000000000000000000000000000000000000000000000000000000000000000", - "maxValidatorSetSize": 9007199254740990, - "rewardConfig": { - "rewardTokenAddress": "0x0000000000000000000000000000000000001010", - "rewardWalletAddress": "0x61324166B0202DB1E7502924326262274Fa4358F", - "rewardWalletAmount": "0xf4240" - } - } - }, - "blockGasTarget": 0, - "transactionsAllowList": { - "adminAddresses": [ - "0x061324166B0202Db1E7502924326262274fa4358" - ], - "enabledAddresses": [ - "0x061324166B0202Db1E7502924326262274fa4358" - ] - }, - "burnContract": null - }, - "bootnodes": [ - "/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8", - "/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX" - ] -} -``` - -
- - - - -## 4. Next Steps - -With a **genesis.json** file containing the initial chain state, validator nodes, and chain admins for your new childchain instance, you are ready to proceed. - -To configure the associated rootchain of the Edge-powered chain and deploy the essential rootchain core contracts, navigate to the [Rootchain Deployment guide](rootchain-config.md). diff --git a/docs/docs/operate/deploy/index.md b/docs/docs/operate/deploy/index.md deleted file mode 100644 index e6e2ca7..0000000 --- a/docs/docs/operate/deploy/index.md +++ /dev/null @@ -1,164 +0,0 @@ -This serves as an index for the Edge deployment guides. -The guides explain the end-to-end process for setting up and deploying a local Edge-powered chain. - -## Prerequisites - -Before diving into any of the tutorials, make sure your environment meets the necessary prerequisites. They can be found **[here](../system.md)**. - -### Before starting - -!!! info "Don't use the develop branch for deployments" - - Please ensure that you are not running on the `develop` branch, which is the active development branch and include changes that are still being tested and not compatible with the current process. - - Instead, use the [latest release](../install.md) for deployments. - -!!! caution "Key management and secure values" - When passing values, it is important to keep sensitive values like private keys and API keys secure. - - The sample commands provided in this guide use sample private keys for demonstration purposes only, in order to show the format and expected value of the parameter. It is important to note that hardcoding or directly passing private keys should never be done in a development or production environment. - -!!! info - Here are some options for securely storing and retrieving private keys ↓ - - - **Environment Variables:** You can store the private key as an environment variable and access it in your code. For example, in Linux, you can set an environment variable like this: `export PRIVATE_KEY="my_private_key"`. Then, in your code, you can retrieve the value of the environment variable using `os.Getenv("PRIVATE_KEY")`. - - - **Configuration Files:** You can store the private key in a configuration file and read it in your session. Be sure to keep the configuration file in a secure location and restrict access to it. - - - **Vaults and Key Management Systems:** If you are working with sensitive data, you might consider using a vault or key management system like a keystore to store your private keys. These systems provide additional layers of security and can help ensure that your private keys are kept safe. - - - -Regardless of how a private key is stored and retrieved, it's important to keep it secure and not expose it unnecessarily. - - -## What you'll learn - -In this tutorial, you will learn how to set up and initialize an Edge-powered chain with multiple nodes. You will learn the complete end-to-end genesis workflow of building an Edge-powered chain, including: - -- Generating private keys for PolyBFT nodes. -- Deploying and initializing rootchain contracts. -- Configuring the rootchain by allowlisting and registering validators, performing initial staking, and finalizing the validator set. -- Generating the genesis file and chain configuration. -- Funding validators on the rootchain. -- Running an (Edge) cluster consisting of multiple PolyBFT nodes. - -By the end of this tutorial, you will have a fully functional Edge test network that can be used to process transactions with high throughput and low latency. - -## What you'll do - -The deployment guides will cover the steps outlined below. If you are deploying an Edge-powered chain for the first time, please navigate each section in order. - -1. [Spawn a New Edge-powered chain](local-chain.md) -2. [Configure Your New Edge-powered chain](genesis.md) -3. [Configure the Rootchain](rootchain-config.md) -4. [Configure the Initial Validator Set](genesis-validators.md) -5. [Start Your New Edge-powered chain](start-chain.md) - -
-Fast-track guide ↓ - -**Here's the fast-track guide if you're looking for a quick guide on the essential commands needed to set up a local Edge-powered chain.** - -1. Init secrets: - - ```bash - ./xgrchain polybft-secrets --data-dir test-chain- --num 4 - ``` - -2. Create chain configuration: - - Single host: - - ```bash - ./xgrchain genesis --block-gas-limit 10000000 --epoch-size 10 [--validators-path ./] [--validators-prefix test-chain-] [--consensus polybft] [--reward-wallet address:amount] - - Multi-host: - - ```bash - ./xgrchain genesis --block-gas-limit 10000000 --epoch-size 10 --validators /ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmV5hqAp77untfJRorxqKmyUxgaVn8YHFjBJm9gKMms3mr:0xDcBe0024206ec42b0Ef4214Ac7B71aeae1A11af0:1cf134e02c6b2afb2ceda50bf2c9a01da367ac48f7783ee6c55444e1cab418ec0f52837b90a4d8cf944814073fc6f2bd96f35366a3846a8393e3cb0b19197cde23e2b40c6401fa27ff7d0c36779d9d097d1393cab6fc1d332f92fb3df850b78703b2989d567d1344e219f0667a1863f52f7663092276770cf513f9704b5351c4:11b18bde524f4b02258a8d196b687f8d8e9490d536718666dc7babca14eccb631c238fb79aa2b44a5a4dceccad2dd797f537008dda185d952226a814c1acf7c2] - ``` - -3. Deploy and initialize rootchain contracts: - - [FOR GETH ONLY] Start rootchain server: - - ```bash - ./xgrchain rootchain server - ``` - - ```bash - ./xgrchain rootchain deploy --deployer-key [--genesis ./genesis.json] [--json-rpc http://127.0.0.1:8545] [--test] - ``` - -4. Fund validators on rootchain: - - ```bash - ./xgrchain rootchain fund --data-dir ./test-chain-1 - ``` - -5. Allowlist validators on rootchain: - - ```bash - ./xgrchain polybft whitelist-validators --private-key --addresses --supernet-manager - ``` - -6. Register validators on rootchain: - - ```bash - ./xgrchain polybft register-validator --data-dir ./test-chain-1 --supernet-manager - ``` - -7. Initial staking on rootchain: - - ```bash - ./xgrchain polybft stake --data-dir ./test-chain-1 --chain-id --amount --stake-manager --native-root-token - ``` - -8. Finalize genesis validator set on rootchain: - - ```bash - ./xgrchain polybft supernet --private-key \ - --genesis \ - --supernet-manager \ - --stake-manager \ - --finalize-genesis --enable-staking - ``` - -9. Run (child chain) cluster: - - ```bash - ./xgrchain server --data-dir ./test-chain-1 --chain genesis.json --grpc-address :5001 --libp2p :30301 --jsonrpc :10001 \ - --seal --log-level DEBUG - - ./xgrchain server --data-dir ./test-chain-2 --chain genesis.json --grpc-address :5002 --libp2p :30302 --jsonrpc :10002 \ - --seal --log-level DEBUG - - ./xgrchain server --data-dir ./test-chain-3 --chain genesis.json --grpc-address :5003 --libp2p :30303 --jsonrpc :10003 \ - --seal --log-level DEBUG - - ./xgrchain server --data-dir ./test-chain-4 --chain genesis.json --grpc-address :5004 --libp2p :30304 --jsonrpc :10004 \ - --seal --log-level DEBUG - ``` - - Starting node in relayer mode: - - ```bash - ./xgrchain server --data-dir ./test-chain-1 --chain genesis.json --grpc-address :5001 --libp2p :30301 --jsonrpc :10001 \ - --seal --log-level DEBUG --relayer - ``` - -
- -## Cloud Deployments - -!!! caution "Content disclaimer" - - Please view the third-party content disclaimer [here]/disclaimer/). - - -| Platform | Guide | -| --- | --- | -| Amazon Web Services | To set up a devnet on AWS, you can refer to the AWS deployment guide available [here](https://github.com/maticnetwork/terraform-polygon-supernets). The guide provides comprehensive instructions on how to use Terraform to set up a Virtual Private Cloud (VPC), subnets, security groups, and EC2 instances, followed by instructions on configuring nodes using Ansible. | -| Microsoft Azure | To set up a devnet on Azure, you can refer to the Azure deployment guide available [here](https://github.com/caleteeter/polygon-azure). This repository offers an Azure template that can be deployed through the Azure and Bicep CLI, or directly through the "Deploy to Azure" button. Additionally, the deployment can be viewed via the "Visualize" button available in the repository. | -| Google Cloud Platform | To set up a devnet on GCP, you can refer to the GCP deployment guide available [here](https://github.com/IntellectEU/gcp-polygon-supernets). The guide provides comprehensive instructions on how to use Terraform to set up a Virtual Private Cloud (VPC), subnets, firewall rules, the Service Account and GCE instances, followed by instructions on configuring nodes using Ansible. | diff --git a/docs/docs/operate/deploy/local-chain.md b/docs/docs/operate/deploy/local-chain.md deleted file mode 100644 index 3a7d556..0000000 --- a/docs/docs/operate/deploy/local-chain.md +++ /dev/null @@ -1,140 +0,0 @@ -In this section, we'll prepare initiate a new chain with PolyBFT consensus and prepare the initial Edge nodes. - -## 1. Generate Keys - -To initialize PolyBFT consensus, we need to generate the necessary secrets for each node. - -The `xgrchain polybft-secrets` command is used to generate account secrets for validators. The command initializes private keys for the consensus client (validators + networking) to a Secrets Manager config file. - -
-Flags ↓ - -| Flag | Description | Example | -|-----------------|-----------------------------------------------------------------------------------------------------------|----------------------------| -| `--account` | The flag indicating whether a new account is created (default true). | | -| `--config` | The path to the SecretsManager config file. If omitted, the local FS secrets manager is used. | `--config /path/to/config` | -| `--data-dir` | The directory for the XGRChain data if the local FS is used. | `--data-dir /path/to/dir` | -| `--insecure` | The flag indicating whether the secrets stored on the local storage should be encrypted. | | -| `--network` | The flag indicating whether a new Network key is created (default true). | | -| `--num` | The flag indicating how many secrets should be created, only for the local FS (default 1). | `--num 4` | -| `--output` | The flag indicating to output existing secrets. | `--output` | -| `--private` | The flag indicating whether the private key is printed. | `--private` | - -
- - ```bash - ./xgrchain polybft-secrets --insecure --data-dir test-chain- --num 4 - ``` - -
-Output example ↓ - -```bash -[WARNING: INSECURE LOCAL SECRETS - SHOULD NOT BE RUN IN PRODUCTION] - -[SECRETS GENERATED] -network-key, validator-key, validator-bls-key - -[SECRETS INIT] -Public key (address) = 0x61324166B0202DB1E7502924326262274Fa4358F -BLS Public key = 06d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca -Node ID = 16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8 - -[WARNING: INSECURE LOCAL SECRETS - SHOULD NOT BE RUN IN PRODUCTION] - -[SECRETS GENERATED] -network-key, validator-key, validator-bls-key - -[SECRETS INIT] -Public key (address) = 0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570 -BLS Public key = 0601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f -Node ID = 16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX - -[WARNING: INSECURE LOCAL SECRETS - SHOULD NOT BE RUN IN PRODUCTION] - -[SECRETS GENERATED] -network-key, validator-key, validator-bls-key - -[SECRETS INIT] -Public key (address) = 0x9aBb8441A12d4FD8D505C3fc50cDdc45E0df2b1e -BLS Public key = 17c26d9d91dddc3c1318b20a1ddb3322ea1f4e4415c27e9011d706e7407eed672837173d1909cbff6ccdfd110af3b18bdfea878e8120fdb5bae70dc7a044a2f40aa8f118b41704896f474f80fff52d9047fa8e4a464ac86f9d05a0220975d8440e20c6307d866137053cabd4baf6ba84bfa4a22f5f9297c1bfc2380c23535210 -Node ID = 16Uiu2HAmGskf5sZ514Ab4SHTPuw8RRBQudyrU211wn3P1knRz9Ed - -[WARNING: INSECURE LOCAL SECRETS - SHOULD NOT BE RUN IN PRODUCTION] - -[SECRETS GENERATED] -network-key, validator-key, validator-bls-key - -[SECRETS INIT] -Public key (address) = 0xCaB5AAC79Bebe326e0c80d72b5662E73f5D8ea56 -BLS Public key = 1d7bb7d44a2f0ebeae2f4380f88188080de34635d78a36647f0704c7b70de7291e2e3b9a1ef699a078c6cd9bb816ea2917c2c2fc699c6248f1f7812a167caf7e15361ec16df56d194768d57c79897c681c96f4321651464f7b577d08083d8b67213a1e29dc8495d8389e6cbd85fdd738c402a1801198b57b302e0e00dfaf1247 -Node ID = 16Uiu2HAm42EFMhJPGcMRFHPaWWxBzoEsWRbGxJnBHMu4VFojg99U -``` - -
- -:::info Example with AWS Secrets - -### Prerequisites - -1. You need to have [AWS CLI](https://aws.amazon.com/cli/) installed and configured on your machine. -2. An [AWS SSO account](https://aws.amazon.com/iam/identity-center/) with the right permissions to access the SSM Parameter Store is required. - -### Step 1: AWS SSO Login - -The first step is to log in to your AWS SSO account. In your terminal, run the following command: - -```bash -aws sso login -``` - -Follow the prompts to complete the login process. - -### Step 2: Create Config.json File - -Next, create a config.json file within your xgrchain directory with the following contents: - -```json -{ - "Type": "aws-ssm", - "Name": "validator1", - "Extra": { - "region": "us-west-2", - "ssm-parameter-path": "/test" - } -} -``` - -Ensure to replace the "Name" value with the name you wish to use for your validator, and the "ssm-parameter-path" with the path in AWS SSM Parameter Store where your parameters will be stored. - -### Step 3: Run the Secret Generation Command - -To generate the necessary secrets for your validator node, run the polybft-secrets command. In your terminal, input: - -```bash -go run main.go polybft-secrets --config config.json -``` - -This will generate the secrets and store them in the AWS SSM Parameter Store as defined in your config.json file. - -### Step 4: Check Outputs in AWS SSM Parameter Store - -Check your AWS SSM Parameter Store to verify that the secrets have been generated successfully. This can be done via the AWS console. - -> Note: In this tutorial, the example shown generated the following secrets: network-key, validator-key, and validator-bls-key. Your output will also show the public key (address), BLS public key, and Node ID. - -::: - -### Understand the Generated Secrets - -The generated secrets include the following information for each validator node: - -- **ECDSA Private and Public Keys**: These keys are used to sign and verify transactions on the blockchain. -- **BLS Private and Public Keys**: These keys are used in the Byzantine fault-tolerant (BFT) consensus protocol to aggregate and verify signatures efficiently. -- **P2P Networking Node ID**: This is a unique identifier for each validator node in the network, allowing them to establish and maintain connections with other nodes. - -> The secrets output can be retrieved again if needed by running the following command: `./xgrchain polybft-secrets --data-dir test-chain-X/` - -## 2. Next Steps - -As the next step, navigate to the [Configure a New Childchain](genesis.md) deployment guide. This will enable you to generate a new genesis file and define the initial validator set, facilitating the setup and configuration of the childchain's initial state. diff --git a/docs/docs/operate/deploy/rootchain-config.md b/docs/docs/operate/deploy/rootchain-config.md deleted file mode 100644 index 484953b..0000000 --- a/docs/docs/operate/deploy/rootchain-config.md +++ /dev/null @@ -1,652 +0,0 @@ -In this section, we'll configure the associated rootchain of the Edge-powered chain and deploy the necessary rootchain core contracts. - -After generating the initial chain state for your Edge-powered chain, the next step is to connect and initialize the rootchain contracts. This can be done using either a demo Geth instance or any EVM-compatible rootchain. The demo Geth instance is a local instance of a Geth node running in development mode, which simulates the Ethereum network and is **only intended for testing purposes**. - -## 1. Deploy and Initialize Rootchain Contracts - - - - - - - - - - - -### i. Start the Geth Node - -The `xgrchain` rootchain server command starts an ethereum/client-go container, which runs a new Geth node. -To do this, open a new terminal session and run: - - ```bash - ./xgrchain rootchain server - ``` - -
-Output example ↓ - -You should see output similar to the following, indicating that the rootchain server is now running: - - ```bash - {"status":"Pulling from xgrnetwork/go-ethereum-console","id":"latest"} - {"status":"Digest: sha256:6aad124b6775b96d05c94850dcafde45911f7bb2b473328dc4a792b1ffb2bdb6"} - {"status":"Status: Image is up to date for ghcr.io/xgrnetwork/go-ethereum-console:latest"} - INFO [05-04|09:48:51.496] Starting Geth in ephemeral dev mode... - WARN [05-04|09:48:51.498] You are running Geth in --dev mode. Please note the following: - - 1. This mode is only intended for fast, iterative development without assumptions on - security or persistence. - 2. The database is created in memory unless specified otherwise. Therefore, shutting down - your computer or losing power will wipe your entire block data and chain state for - your dev environment. - 3. A random, pre-allocated developer account will be available and unlocked as - eth.coinbase, which can be used for testing. The random dev account is temporary, - stored on a ramdisk, and will be lost if your machine is restarted. - 4. Mining is enabled by default. However, the client will only seal blocks if transactions - are pending in the mempool. The miner's minimum accepted gas price is 1. - 5. Networking is disabled; there is no listen-address, the maximum number of peers is set - to 0, and discovery is disabled. - - INFO [05-04|09:48:51.515] Maximum peer count ETH=50 LES=0 total=50 - INFO [05-04|09:48:51.524] Smartcard socket not found, disabling err="stat /run/pcscd/pcscd.comm: no such file or directory" - INFO [05-04|09:48:51.576] Set global gas cap cap=50,000,000 - INFO [05-04|09:48:52.676] Using developer account address=0xd8aC7c1C8A8F34392aD45C250489DeE5D1dC5F51 - INFO [05-04|09:48:52.682] Allocated cache and file handles database=/eth1data/geth/chaindata cache=512.00MiB handles=524,288 - INFO [05-04|09:48:52.807] Opened ancient database database=/eth1data/geth/chaindata/ancient/chain readonly=false - INFO [05-04|09:48:52.824] Allocated trie memory caches clean=154.00MiB dirty=256.00MiB - INFO [05-04|09:48:52.827] Allocated cache and file handles database=/eth1data/geth/chaindata cache=512.00MiB handles=524,288 - INFO [05-04|09:48:52.987] Opened ancient database database=/eth1data/geth/chaindata/ancient/chain readonly=false - INFO [05-04|09:48:53.003] Initialising Ethereum protocol network=1337 dbversion= - INFO [05-04|09:48:53.005] Writing custom genesis block - INFO [05-04|09:48:53.018] Persisted trie from memory database nodes=12 size=1.82KiB time=2.892875ms gcnodes=0 gcsize=0.00B gctime=0s livenodes=1 livesize=0.00B - INFO [05-04|09:48:53.029] - INFO [05-04|09:48:53.029] --------------------------------------------------------------------------------------------------------------------------------------------------------- - INFO [05-04|09:48:53.030] Chain ID: 1337 (unknown) - INFO [05-04|09:48:53.030] Consensus: Clique (proof-of-authority) - INFO [05-04|09:48:53.030] - INFO [05-04|09:48:53.030] Pre-Merge hard forks: - INFO [05-04|09:48:53.031] - Homestead: 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/homestead.md) - INFO [05-04|09:48:53.031] - Tangerine Whistle (EIP 150): 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/tangerine-whistle.md) - INFO [05-04|09:48:53.031] - Spurious Dragon/1 (EIP 155): 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/spurious-dragon.md) - INFO [05-04|09:48:53.031] - Spurious Dragon/2 (EIP 158): 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/spurious-dragon.md) - INFO [05-04|09:48:53.032] - Byzantium: 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/byzantium.md) - INFO [05-04|09:48:53.032] - Constantinople: 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/constantinople.md) - INFO [05-04|09:48:53.032] - Petersburg: 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/petersburg.md) - INFO [05-04|09:48:53.032] - Istanbul: 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/istanbul.md) - INFO [05-04|09:48:53.032] - Muir Glacier: 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/muir-glacier.md) - INFO [05-04|09:48:53.033] - Berlin: 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/berlin.md) - INFO [05-04|09:48:53.033] - London: 0 (https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/london.md) - INFO [05-04|09:48:53.033] - INFO [05-04|09:48:53.033] The Merge is not yet available for this network! - INFO [05-04|09:48:53.033] - Hard-fork specification: https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/paris.md - INFO [05-04|09:48:53.034] --------------------------------------------------------------------------------------------------------------------------------------------------------- - INFO [05-04|09:48:53.034] - INFO [05-04|09:48:53.039] Loaded most recent local header number=0 hash=368c9f..43bc46 td=1 age=54y1mo1w - INFO [05-04|09:48:53.040] Loaded most recent local full block number=0 hash=368c9f..43bc46 td=1 age=54y1mo1w - INFO [05-04|09:48:53.040] Loaded most recent local fast block number=0 hash=368c9f..43bc46 td=1 age=54y1mo1w - WARN [05-04|09:48:53.043] Failed to load snapshot err="missing or corrupted snapshot" - INFO [05-04|09:48:53.045] Rebuilding state snapshot - INFO [05-04|09:48:53.048] Resuming state snapshot generation root=1e8d18..71da09 accounts=0 slots=0 storage=0.00B dangling=0 elapsed=2.311ms - INFO [05-04|09:48:53.060] Regenerated local transaction journal transactions=0 accounts=0 - INFO [05-04|09:48:53.064] Generated state snapshot accounts=10 slots=0 storage=412.00B dangling=0 elapsed=18.140ms - INFO [05-04|09:48:53.066] Gasprice oracle is ignoring threshold set threshold=2 - WARN [05-04|09:48:53.071] Error reading unclean shutdown markers error="leveldb: not found" - WARN [05-04|09:48:53.072] Engine API enabled protocol=eth - WARN [05-04|09:48:53.072] Engine API started but chain not configured for merge yet - INFO [05-04|09:48:53.073] Stored checkpoint snapshot to disk number=0 hash=368c9f..43bc46 - INFO [05-04|09:48:53.076] Starting peer-to-peer node instance=Geth/v1.11.0-unstable-b590faff-20221007/linux-amd64/go1.18.6 - WARN [05-04|09:48:53.077] P2P server will be useless, neither dialing nor listening - INFO [05-04|09:48:53.137] New local node record seq=1,683,193,733,117 id=bb78e0f3d24eccb1 ip=127.0.0.1 udp=0 tcp=0 - INFO [05-04|09:48:53.145] Started P2P networking self=enode://d1a6c5a13a7469707feec8af30254f4fba1035fee47c56514790020dacbcbaeace23943e0838e7dd6555f6f723cf1d4c9ff3a00ebdf2bb796c71787fbd6407cc@127.0.0.1:0 - INFO [05-04|09:48:53.151] IPC endpoint opened url=/eth1data/geth.ipc - INFO [05-04|09:48:53.159] Generated JWT secret path=/eth1data/geth/jwtsecret - INFO [05-04|09:48:53.163] HTTP server started endpoint=[::]:8545 auth=false prefix= cors= vhosts=localhost - INFO [05-04|09:48:53.163] WebSocket enabled url=ws://[::]:8546 - INFO [05-04|09:48:53.168] WebSocket enabled url=ws://127.0.0.1:8551 - INFO [05-04|09:48:53.168] HTTP server started endpoint=127.0.0.1:8551 auth=true prefix= cors=localhost vhosts=localhost - INFO [05-04|09:48:53.174] Transaction pool price threshold updated price=0 - INFO [05-04|09:48:53.175] Updated mining threads threads=0 - INFO [05-04|09:48:53.175] Transaction pool price threshold updated price=1 - INFO [05-04|09:48:53.175] Etherbase automatically configured address=0xd8aC7c1C8A8F34392aD45C250489DeE5D1dC5F51 - INFO [05-04|09:48:53.179] Commit new sealing work number=1 sealhash=c40800..8372ed uncles=0 txs=0 gas=0 fees=0 elapsed=2.295ms - INFO [05-04|09:48:53.180] Commit new sealing work number=1 sealhash=c40800..8372ed uncles=0 txs=0 gas=0 fees=0 elapsed=3.644ms - INFO [05-04|09:48:53.185] Successfully sealed new block number=1 sealhash=c40800..8372ed hash=75c2e6..45c554 elapsed=6.768ms - ``` - -
- -This will start the rootchain server on the default JSON-RPC port of `8545`. - -### ii. Deploy StakeManager Contract - -:::caution - -If you have already deployed the StakeManager, you may skip the step and move onto [Deploy rootchain contracts](#deploy-rootchain-contracts). - -::: - -If the `StakeManager` hasn't been deployed to the rootchain, you need to carry out this step. This command also contains a test flag. This flag is strictly for testing purposes, and its usage results in deploying a mock ERC-20 token that will serve for staking. - - ```bash - ./xgrchain polybft stake-manager-deploy \ - --proxy-contracts-admin 0xaddressOfProxyContractsAdmin \ - --private-key \ - --genesis ./genesis.json \ - --jsonrpc http://127.0.0.1:8545 \ - --stake-token 0xaddressOfStakeToken \ - --test - ``` - -
-Flags ↓ - -| Flag | Description | Example | -|------------------------------|-------------------------------------------------------------------------------|-------------------------------------------------| -| `--config` | The path to the SecretsManager config file. If omitted, the local FS secrets manager is used. | `--config /path/to/config` | -| `--data-dir` | The directory for the XGRChain data if the local FS is used. | `--data-dir test-chain-` | -| `--genesis` | Genesis file path, which contains chain configuration. | `--genesis ./genesis.json` | -| `-h, --help` | Help for stake-manager-deploy. | | -| `--jsonrpc` | The JSON-RPC interface. | `--jsonrpc http://0.0.0.0:8545` | -| `--private-key` | Hex-encoded private key of the account which executes rootchain commands. | `--private-key ` | -| `--proxy-contracts-admin` | Admin for proxy contracts. | `--proxy-contracts-admin ` | -| `--stake-token` | Address of ERC20 token used for staking on rootchain. | `--stake-token ` | -| `--test` | Indicates if the command is run in test mode. If test mode is used, the contract will be deployed using a test account, and a test stake ERC20 token will be deployed for staking. | `--test` | - -
- -## 2. Deployment Considerations - -To deploy the rootchain contracts, we use the `xgrchain rootchain deploy` command. Before deployment, consider the following actions: - -### i. Funding Required for Nodes - -Before initializing the contracts on the rootchain, we need to make sure that the nodes are funded with sufficient funds to cover the gas cost of deploying the contracts. Otherwise, the initialization process may fail due to a lack of funds. - -Note that the demo server already funds the default test account. If you're not omitting `--deployer-key`, ensure that you pass the correct key; otherwise, you may encounter an error due to insufficient funds, such as the following: - -```bash -failed to deploy rootchain contracts: {"code":-32000,"message":"INTERNAL_ERROR: insufficient funds"} -``` - -You can also create a rootchain wallet and fund the nodes by using `polygon-cli`. -Follow the steps outlined [here](https://github.com/maticnetwork/polygon-cli). - -### ii. Using an Existing ERC-20 as the Native Gas Token - -If you already have an ERC-20 token deployed on the rootchain that you want to use as the gas token, you can specify its address using the `--erc20-token` flag when deploying the rootchain contracts. For example: - -
-Example ↓ - -```bash -./xgrchain rootchain deploy \ - --genesis ./genesis.json \ - --json-rpc http://127.0.0.1:8545 \ - --erc20-token -``` - -
- -Replace `` with the address of your existing ERC-20 token on the rootchain. - -To deposit a desired amount and mint it on the childchain, please refer to the guidelines outlined in the deposit guide [here](transfers/deposit.md). - -### iii. Proxy Contract Admin - -The introduction of the proxy contract admin in v1.3 brings about new considerations for deployment and contract interaction. - -### Issue with Proxy Contract Fallback - -A notable issue arises when the proxy contract's admin attempts to fallback to the proxy target. Specifically, the initialization on the StakeManager seems to be invoked using the admin account, which is set by the `--proxy-contracts-admin` flag. - -> According to the design of the [TransparentUpgradeableProxy](https://docs.openzeppelin.com/contracts/4.x/api/proxy#TransparentUpgradeableProxy), the admin account for the proxy contract is prohibited from calling any function on the implementation contract. This design choice ensures that the admin account's privileges are strictly limited to administrative tasks, preventing potential misuse or unintended interactions. - -### Recommendations - -1. **Exclusive Use of Admin Account**: Ensure that the address specified in the `--proxy-contracts-admin` flag is used exclusively for administrative functions. This includes tasks such as updating the implementation contract address and modifying the admin. - -2. **Avoid Using Admin as Deployer**: Ensure that the address used in the `--proxy-contracts-admin` flag is not employed as a contract deployer. This is especially important in cases like the stake manager deployment. - -3. **Restricted Function Calls**: The admin account should never be used to invoke any function on the implementation contract. This restriction is in line with the design of the `TransparentUpgradeableProxy` and ensures that the admin account remains solely for administrative tasks. - -## 3. Deploy Rootchain Contracts - -Using the `--deployer-key` flag, you will need to replace `` with the hex-encoded private key of the deployer account that will be used to deploy the smart contracts. If you omit the `--deployer-key` option, the default account in your local client will be used. - -> The user is responsible for providing the deployer key, which should correspond to an address with sufficient funds for deployment. It is recommended to ensure the account is pre-funded before initiating the deployment process. - -To run the deployment in test mode and use the test account provided by the Geth dev instance as the depositor, add the `--test` flag. In this case, you may omit the `--deployer-key` flag, and the default test account will be used as the depositor. - -
-Flags ↓ - -| Flag | Description | Example | -|------------------------------|-------------------------------------------------------------------------------|-------------------------------------------------| -| `--deployer-key` | Hex-encoded private key of the account which deploys rootchain contracts | `--deployer-key ` | -| `--erc20-token` | Existing root chain root native token address | `--erc20-token ` | -| `--genesis` | Genesis file path, which contains chain configuration (default "./genesis.json") | `--genesis ./genesis.json` | -| `-h, --help` | Help for deploy | | -| `--json-rpc` | The JSON RPC rootchain IP address (default "http://127.0.0.1:8545") | `--json-rpc http://127.0.0.1:8545` | -| `--proxy-contracts-admin` | Admin for proxy contracts | `--proxy-contracts-admin ` | -| `--stake-manager` | Address of stake manager contract | `--stake-manager ` | -| `--stake-token` | Address of ERC20 token used for staking on rootchain | `--stake-token ` | -| `--test` | Indicates whether rootchain contracts deployer is hardcoded test account | `--test` | - -
- - ```bash - ./xgrchain rootchain deploy \ - --deployer-key \ - --stake-manager \ - --stake-token 0xaddressOfStakeToken \ - --proxy-contracts-admin 0xaddressOfProxyContractsAdmin \ - --genesis ./genesis.json \ - --json-rpc http://127.0.0.1:8545 \ - --test - ``` - -The above example will get the `stake-manager` and `stake-token` addresses directly from the `genesis.json` file. - -
-Core contract deployment output example - -```bash -[ROOTCHAIN - CONTRACTS DEPLOYMENT] started... Rootchain JSON RPC address http://127.0.0.1:8545. - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC20 -Contract (address) = 0x6FE03c2768C9d800AF3Dedf1878b5687FE120a27 -Transaction (hash) = 0x5c77b2fbc658c97ceba964efd512f6fb01224ca0f81b6f97fbc0f258c7ae3b2b - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC721 -Contract (address) = 0x3d46A809D5767B81a8836f0E79145ba615A2Dd61 -Transaction (hash) = 0xdb3051d76de9296e3e2f8e723b85bc679e183bdbd47820506af61828bec17da3 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC1155 -Contract (address) = 0x72E1C51FE6dABF2e3d5701170cf5aD3620E6B8ba -Transaction (hash) = 0x99f8897fe1d921b58aac44fef3d35e986186dee8d2ea8f06b55ca3c5e775c431 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = StateSender -Contract (address) = 0x436604426F31A05f905C64edc973E575BdB46471 -Transaction (hash) = 0xcb1d9674f1c928527a470d74532a6fe1e755e64909c8ecd5cce014d7330fb500 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = CheckpointManager -Contract (address) = 0x947a581B2713F58A8145201DA41BCb6aAE90196B -Transaction (hash) = 0xf6bb5054971c0d0a135ae63767a39d4cd6f1401a961e6abcfca47351576a1235 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = BLS -Contract (address) = 0x1BfAdFDc7554f618665e3EAE7C22DE2B5ab54786 -Transaction (hash) = 0xecad816ee9c8cee2bf646dd077ca26ac9d07f1593967c3b94ff7fa1110e0cd73 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = BN256G2 -Contract (address) = 0x22C246401ed6e52C525644659C5304aed63516C7 -Transaction (hash) = 0xf220bb6dcd40eef63df0517cb4ed768dfcb5f432644937b7dcaedcc7b4b5342e - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = ExitHelper -Contract (address) = 0x88d3678C1e99Fc0b699fCA4cf2BC1c2C75C7f272 -Transaction (hash) = 0xa77415d8d06f6fd0973cd844ba67582afd34808c9943a9c2f8305a4f53ea66de - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC20Predicate -Contract (address) = 0xB3A64e1ffB0867E93665Da1052b3dbAb427A538C -Transaction (hash) = 0xdada762e15613a41b3cd37bc8f1c6750d2498f9bd743769549e8b4b6fbba07e1 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = ERC20Template -Contract (address) = 0xaCB3Eb2f3c167B56410F0351B6C6EBac9256f553 -Transaction (hash) = 0xb53e9bc41aca03ea51cd82de944bd84618c25976b475bba9615eef2bf449c5d3 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC721Predicate -Contract (address) = 0xA1DFe8536732EB98BBCA36A7f97C72e3395EaB8E -Transaction (hash) = 0x4ee43d7754f03e4322ac8eb29bfd2c8410e837f42a786ae0f13f6aee4795c815 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = ERC721Template -Contract (address) = 0x8d83F76FB303d30d35E1A8FAafB69294C8bD4069 -Transaction (hash) = 0x242d30e721e5a9a4324f92e5874a62de6bc65089b51013a4fbac6033cdf2a6fc - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC1155Predicate -Contract (address) = 0x0e3C79887960455083c5F063035C723c61906811 -Transaction (hash) = 0x89013a2cfe0c68b73c226cb917822159ae68167b1f8a178e1e63dd8077e245d0 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = ERC1155Template -Contract (address) = 0x7e5BB8F3721C594Af6aB04D5bDf5C52742F37403 -Transaction (hash) = 0x3415e2fb208fb0307746d3a0a35794a5de759fd77109d6a043dea7420c8da230 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = StakeManager -Contract (address) = 0x811068e4106f7A70D443684FF4927eC3940439Ec -Transaction (hash) = 0xe7ab6d4e5002a84b168b195affbf9cdf7bc1f67d05bbeb78e62e4517393626d7 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = CustomSupernetManager -Contract (address) = 0x75aA024A2292A3FD3C17d67b54B3d00435437246 -Transaction (hash) = 0xbe80f099313c6505176a6bc888062ccb124deb83f2e413b0bf076ae5d6b9f6e5 - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] StakeManager contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] CustomSupernetManager contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] [VALIDATORS] -Address=0x61324166B0202DB1E7502924326262274Fa4358F; Balance=1000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8; BLS Key=06d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca; -Address=0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570; Balance=1000000000000000000000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX; BLS Key=0601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f; -[ROOTCHAIN - CONTRACTS DEPLOYMENT] Validators hash: 0x9d31cd8a803b09a9c5e054301977b1f5b758c56f811351e937a0a3792e2ef8b1 -[ROOTCHAIN - CONTRACTS DEPLOYMENT] CheckpointManager contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] ExitHelper contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] RootERC20Predicate contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] RootERC721Predicate contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] RootERC1155Predicate contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] finished. All contracts are successfully deployed and initialized. -``` - -
- - - - - - - -### i. Deploy StakeManager Contract - -:::caution - -If you have already deployed the StakeManager, you may skip the step and move onto [Deploy rootchain contracts](#deploy-rootchain-contracts). - -::: - -This command includes a test flag, which is intended solely for testing scenarios. When this flag is used, a mock ERC-20 token is deployed for staking. However, in non-testing environments, remember to specify the `stake-token` flag with the address of the token that's already deployed on the rootchain and will be used for staking. - - ```bash - ./xgrchain polybft stake-manager-deploy \ - --proxy-contracts-admin 0xaddressOfProxyContractsAdmin \ - --deployer-key \ - --genesis ./genesis.json \ - --jsonrpc http://127.0.0.1:8545 \ - --stake-token 0xaddressOfStakeToken \ - --test - ``` - -
-Flags ↓ - -| Flag | Description | Example | -|-----------------|--------------------------------------------------------------------------------------------------------|---------| -| `--config` | Path to the SecretsManager config file, if omitted, the local FS secrets manager is used | | -| `--data-dir` | Directory for the XGRChain data if the local FS is used | | -| `--genesis` | Genesis file path, which contains chain configuration (default "./genesis.json") | | -| `--jsonrpc` | The JSON-RPC interface (default "0.0.0.0:8545") | | -| `--private-key` | Hex-encoded private key of the account which executes rootchain commands | | -| `--stake-token` | Address of ERC20 token used for staking on rootchain | | -| `--test` | Contract will be deployed using test account and a test stake ERC20 token will be deployed for staking | | - -
- -## 2. Deployment Considerations - -To deploy the rootchain contracts, we use the `xgrchain rootchain deploy` command. Before deployment, consider the following actions: - -### i. Funding Required for Nodes - -Before initializing the contracts on the rootchain, we need to make sure that the nodes are funded with sufficient funds to cover the gas cost of deploying the contracts. Otherwise, the initialization process may fail due to a lack of funds. - -Note that the demo server already funds the default test account. If you're not omitting `--deployer-key`, ensure that you pass the correct key; otherwise, you may encounter an error due to insufficient funds, such as the following: - -```bash -failed to deploy rootchain contracts: {"code":-32000,"message":"INTERNAL_ERROR: insufficient funds"} -``` - -You can also create a rootchain wallet and fund the nodes by using `polygon-cli`. -Follow the steps outlined [here](https://github.com/maticnetwork/polygon-cli). - -### ii. Using an Existing ERC-20 as the Native Gas Token - -If you already have an ERC-20 token deployed on the rootchain that you want to use as the gas token, you can specify its address using the `--erc20-token` flag when deploying the rootchain contracts. For example: - -
-Example ↓ - -```bash -./xgrchain rootchain deploy \ - --genesis ./genesis.json \ - --json-rpc http://127.0.0.1:8545 \ - --erc20-token -``` - -
- -Replace `` with the address of your existing ERC-20 token on the rootchain. - -To deposit a desired amount and mint it on the childchain, please refer to the guidelines outlined in the deposit guide [here](transfers/deposit.md). - -## 3. Deploy Rootchain Contracts - -Using the `--deployer-key` flag, you will need to replace `` with the hex-encoded private key of the deployer account that will be used to deploy the smart contracts. If you omit the `--deployer-key` option, the default account in your local client will be used. - -You also need to specify the path to the genesis file using the `--genesis` option, and the endpoint for the JSON-RPC endpoint for the rootchain using the `--json-rpc` option. - -
-Flags ↓ - -| Flag | Description | Example | -|-----------------------|--------------------------------------------------------------------------|-----------------------------------------------| -| `--deployer-key` | Hex encoded private key of the account which deploys rootchain contracts | `--deployer-key ` | -| `--json-rpc` | The JSON RPC rootchain IP address (e.g. http://127.0.0.1:8545) | `--json-rpc http://127.0.0.1:8545` | -| `--genesis` | Genesis file path that contains chain configuration | `--genesis ./genesis.json` | -| `--erc20-token` | Existing rootchain ERC-20 token address | `--erc20-token ` | -| `--stake-manager` | Address of stake manager contract | `--stake-manager ` | -| `--stake-token` | Address of ERC20 token used for staking on rootchain | `--stake-token ` | -| `--test` | Indicates whether rootchain contracts deployer is hardcoded test account | `--test` | - -
- -```bash -./xgrchain rootchain deploy \ - --deployer-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --genesis ./genesis.json \ - --json-rpc http://127.0.0.1:8545 \ -``` - -
-Core contract deployment output example ↓ - -```bash -[ROOTCHAIN - CONTRACTS DEPLOYMENT] started... Rootchain JSON RPC address http://127.0.0.1:8545. - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC20 -Contract (address) = 0x6FE03c2768C9d800AF3Dedf1878b5687FE120a27 -Transaction (hash) = 0x5c77b2fbc658c97ceba964efd512f6fb01224ca0f81b6f97fbc0f258c7ae3b2b - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC721 -Contract (address) = 0x3d46A809D5767B81a8836f0E79145ba615A2Dd61 -Transaction (hash) = 0xdb3051d76de9296e3e2f8e723b85bc679e183bdbd47820506af61828bec17da3 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC1155 -Contract (address) = 0x72E1C51FE6dABF2e3d5701170cf5aD3620E6B8ba -Transaction (hash) = 0x99f8897fe1d921b58aac44fef3d35e986186dee8d2ea8f06b55ca3c5e775c431 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = StateSender -Contract (address) = 0x436604426F31A05f905C64edc973E575BdB46471 -Transaction (hash) = 0xcb1d9674f1c928527a470d74532a6fe1e755e64909c8ecd5cce014d7330fb500 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = CheckpointManager -Contract (address) = 0x947a581B2713F58A8145201DA41BCb6aAE90196B -Transaction (hash) = 0xf6bb5054971c0d0a135ae63767a39d4cd6f1401a961e6abcfca47351576a1235 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = BLS -Contract (address) = 0x1BfAdFDc7554f618665e3EAE7C22DE2B5ab54786 -Transaction (hash) = 0xecad816ee9c8cee2bf646dd077ca26ac9d07f1593967c3b94ff7fa1110e0cd73 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = BN256G2 -Contract (address) = 0x22C246401ed6e52C525644659C5304aed63516C7 -Transaction (hash) = 0xf220bb6dcd40eef63df0517cb4ed768dfcb5f432644937b7dcaedcc7b4b5342e - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = ExitHelper -Contract (address) = 0x88d3678C1e99Fc0b699fCA4cf2BC1c2C75C7f272 -Transaction (hash) = 0xa77415d8d06f6fd0973cd844ba67582afd34808c9943a9c2f8305a4f53ea66de - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC20Predicate -Contract (address) = 0xB3A64e1ffB0867E93665Da1052b3dbAb427A538C -Transaction (hash) = 0xdada762e15613a41b3cd37bc8f1c6750d2498f9bd743769549e8b4b6fbba07e1 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = ERC20Template -Contract (address) = 0xaCB3Eb2f3c167B56410F0351B6C6EBac9256f553 -Transaction (hash) = 0xb53e9bc41aca03ea51cd82de944bd84618c25976b475bba9615eef2bf449c5d3 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC721Predicate -Contract (address) = 0xA1DFe8536732EB98BBCA36A7f97C72e3395EaB8E -Transaction (hash) = 0x4ee43d7754f03e4322ac8eb29bfd2c8410e837f42a786ae0f13f6aee4795c815 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = ERC721Template -Contract (address) = 0x8d83F76FB303d30d35E1A8FAafB69294C8bD4069 -Transaction (hash) = 0x242d30e721e5a9a4324f92e5874a62de6bc65089b51013a4fbac6033cdf2a6fc - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = RootERC1155Predicate -Contract (address) = 0x0e3C79887960455083c5F063035C723c61906811 -Transaction (hash) = 0x89013a2cfe0c68b73c226cb917822159ae68167b1f8a178e1e63dd8077e245d0 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = ERC1155Template -Contract (address) = 0x7e5BB8F3721C594Af6aB04D5bDf5C52742F37403 -Transaction (hash) = 0x3415e2fb208fb0307746d3a0a35794a5de759fd77109d6a043dea7420c8da230 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = StakeManager -Contract (address) = 0x811068e4106f7A70D443684FF4927eC3940439Ec -Transaction (hash) = 0xe7ab6d4e5002a84b168b195affbf9cdf7bc1f67d05bbeb78e62e4517393626d7 - - -[ROOTCHAIN - DEPLOY CONTRACT] -Name = CustomSupernetManager -Contract (address) = 0x75aA024A2292A3FD3C17d67b54B3d00435437246 -Transaction (hash) = 0xbe80f099313c6505176a6bc888062ccb124deb83f2e413b0bf076ae5d6b9f6e5 - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] StakeManager contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] CustomSupernetManager contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] [VALIDATORS] -Address=0x61324166B0202DB1E7502924326262274Fa4358F; Balance=1000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmMYyzK7c649Tnn6XdqFLP7fpPB2QWdck1Ee9vj5a7Nhg8; BLS Key=06d8d9e6af67c28e85ac400b72c2e635e83234f8a380865e050a206554049a222c4792120d84977a6ca669df56ff3a1cf1cfeccddb650e7aacff4ed6c1d4e37b055858209f80117b3c0a6e7a28e456d4caf2270f430f9df2ba37221f23e9bbd313c9ef488e1849cc5c40d18284d019dde5ed86770309b9c24b70ceff6167a6ca; -Address=0xFE5E166BA5EA50c04fCa00b07b59966E6C2E9570; Balance=1000000000000000000000000; P2P Multi addr=/ip4/127.0.0.1/tcp/30302/p2p/16Uiu2HAmLXVapjR2Yx3B1taCmHnckQ1ph2xrawBjW2kvSErps9CX; BLS Key=0601da8856a6d3d3bb0f3bcbb90ea7b8c0db8271b9203e6123c6804aa3fc5f810be33287968ca1af2be11839516850a6ffef2337d99e679b7531efbbea2e3bf727a053c0cbede71da3d5f489b6ad862ccd8bb0bfb7fa379e3395d3b1142594a73020e87d63c298a3a4eba0ace65727f8659bab6389b9448b72512db72bbe937f; -[ROOTCHAIN - CONTRACTS DEPLOYMENT] Validators hash: 0x9d31cd8a803b09a9c5e054301977b1f5b758c56f811351e937a0a3792e2ef8b1 -[ROOTCHAIN - CONTRACTS DEPLOYMENT] CheckpointManager contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] ExitHelper contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] RootERC20Predicate contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] RootERC721Predicate contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] RootERC1155Predicate contract is initialized - -[ROOTCHAIN - CONTRACTS DEPLOYMENT] finished. All contracts are successfully deployed and initialized. -``` - -
- - - - -## 4. Funding Validators on the Rootchain - -Before deploying validator nodes on the Edge-powered chain, we need to ensure that the validators have sufficient funds on the rootchain network. It's crucial to have enough funds in the validator account, as they need to cover the gas fees associated with their transactions on the rootchain. - -To fund the validators' accounts on the rootchain, we use the `xgrchain rootchain fund` command. When executed with the appropriate flags, it will: - -1. Retrieve the validator account from the secrets manager. -2. Send a transaction to fund the validator account on the rootchain with a value of 10,000 $token (the network's native token). -3. Repeat steps 1 and 2 for each validator. - -**It's important to note that this command is also for testing purposes only.** - -In a production environment, you would need to ensure that the validators have sufficient funds on the rootchain network to cover the gas fees associated with their transactions. - -Here's an example of how to fund a validator account (replace address value with your own): - - ```bash - ./xgrchain rootchain fund --addresses 0x77C1eedFf656477462ce16084fE5Dc7F8a2507B9 --amounts 1000000000000000000 - ``` - -
-Funding output example ↓ - - ```bash - [ROOTCHAIN FUND] - Validator (address) = 0x77C1eedFf656477462ce16084fE5Dc7F8a2507B9 - Transaction (hash) = 0x294952b29e3e8ba15fefe28934090dc0d249d71d48c6b19ebe534840703030a9 - Is minted = false - ``` - -
- -## 5. Next Steps - -Now that we have successfully configured the initial setup of your Edge-powered chain, including both the childchain and rootchain, we can proceed to the next crucial step: rootchain staking and allowlisting through the configuration of the initial validator set. - -To accomplish this, navigate to the [Configure the Initial Validator Set](genesis-validators.md) deployment guide. diff --git a/docs/docs/operate/deploy/staking/stake.md b/docs/docs/operate/deploy/staking/stake.md deleted file mode 100644 index 40e33aa..0000000 --- a/docs/docs/operate/deploy/staking/stake.md +++ /dev/null @@ -1,75 +0,0 @@ -In this section, we'll walkthrough how to stake WMATIC on the associated rootchain. - -## i. Initial Staking on the Rootchain - -Each validator needs to perform initial staking on the rootchain `StakeManager` contract. This is done using the `xgrchain root stake` command. **Note that this command is for testing purposes only.** - -
-Flags ↓ - -|| Flag | Description | Example | -| -----------------------------| --------------------------------------------------------------------------------- | ---------------------------------------- | -| `--amount ` | The amount to stake | `--amount 5000000000000000000` | -| `--supernet-id` | The ID of the supernet provided by stake manager on supernet registration | `--chain-id 100` | -| `--config ` | The path to the SecretsManager config file | `--config /path/to/config/file.yaml` | -| `--data-dir` | The directory for the XGRChain data | `--data-dir ./xgrchain/data` | -| `--jsonrpc` | The JSON-RPC interface | `--jsonrpc 0.0.0.0:8545` | -| `--stake-token ` | The address of ERC20 Token used for staking on rootchain | `--native-root-token 0x` | -| `--stake-manager` | The address of the stake manager contract | `--stake-manager 0x` | - -
- -In the following example command, we use the validator key and the rootchain `StakeManager` contract address that was generated earlier. We also set the staking amount to `1000000000000000000` which is equivalent to 1 token. The `--native-root-token` flag is used to specify the address of the native token of the rootchain. - -:::info Staking requirement: wrapping a non-ERC-20 token - -Edge allows for the customization of the gas token and mandate the use of ERC-20 tokens for staking instead of the rootchain's native token. - -When performing rootchain staking on the Polygon PoS Mainnet, [WMATIC](https://polygonscan.com/token/0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270?a=0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45) (wrapped MATIC) is the required token. This is due to the ERC-20 standard requirement for staking, which MATIC doesn't meet. - -WMATIC is deployed at `0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270`. - -This principle also applies to the Mumbai Testnet, where wrapped test MATIC must be used instead of test MATIC. - -If you currently hold MATIC tokens, you can convert them to WMATIC through various methods. One common method is to use a decentralized exchange (DEX) like Uniswap, where you can swap your MATIC tokens for WMATIC. **Always ensure you're using a reputable platform for this conversion and double-check that the contract address for WMATIC is correct to ensure the security of your tokens.** - -
-Obtaining native root token address - -For example, if you are using the Mumbai test network, you can obtain the address of the MATIC testnet token by sending a GET request to the Mumbai network's JSON-RPC endpoint: - -```bash -curl \ --X POST \ --H "Content-Type: application/json" \ ---data '{"jsonrpc":"2.0","method":"eth_contractAddress","params":["MaticToken"],"id":1}' -``` - -
- -::: - -```bash -./xgrchain polybft stake \ ---data-dir ./test-chain-1 \ ---chain-id 100 \ ---amount 1000000000000000000 \ ---stake-manager 0x6ceCFe1Db48Ab97fA89b06Df6Bd0bBdE6E64e6F7 \ ---native-root-token 0x559Dd13d8A3CAb3Ff127c408f2A08A8a2AEfC56c -``` - -## ii. Finalize Validator Set on the Rootchain - -After all validators from the genesis block have performed initial staking on the rootchain, the final step required before starting the chain is to finalize the genesis validator set on the `SupernetManager` contract on the rootchain. This can be done using the `xgrchain polybft supernet` command. - -The deployer of the `SupernetManager` contract can specify their hex-encoded private key or use the `--data-dir` flag if they have initialized their secrets. If the `--enable-staking` flag is provided, validators will be able to continue staking on the rootchain. If not, genesis validators will not be able to update their stake or unstake, nor will newly registered validators after genesis be able to stake tokens on the rootchain. The enabling of staking can be done through this command or later after the chain starts. - -In the following example command, we use a placeholder hex-encoded private key of the `SupernetManager` contract deployer. The addresses of the `SupernetManager` and `StakeManager` contracts are the addresses that were generated earlier. We also use the `--finalize-genesis` and `--enable-staking` flags to enable staking and finalize the genesis state. - -```bash - ./xgrchain polybft supernet --private-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --genesis /path/to/genesis/file \ - --supernet-manager 0x75aA024A2292A3FD3C17d67b54B3d00435437246 \ - --stake-manager 0x811068e4106f7A70D443684FF4927eC3940439Ec \ - --finalize-genesis --enable-staking -``` diff --git a/docs/docs/operate/deploy/staking/unstake.md b/docs/docs/operate/deploy/staking/unstake.md deleted file mode 100644 index 9a0773d..0000000 --- a/docs/docs/operate/deploy/staking/unstake.md +++ /dev/null @@ -1,137 +0,0 @@ -In this section, we'll go over how to unstake a validator's staked tokens and withdraw them to an external address. - -## Unstake - -:::info Check validator information - -First, check your validator information by running the `xgrchain polybft validator-info` command. - -
-Flags ↓ - -| Flag | Description | Example | -|------|-------------|---------| -| `--chain-id` | ID of Supernet | `137` | -| `--config` | The path to the SecretsManager config file, if omitted, the local FS secrets manager is used | `/path/to/config.yaml` | -| `--data-dir` | The directory for the XGRChain data if the local FS is used | `/path/to/data/dir` | -| `-h`, `--help` | Help for validator-info | | -| `--jsonrpc` | The JSON-RPC interface (default "0.0.0.0:8545") | `http://localhost:8545` | -| `--stake-manager` | Address of stake manager contract | `0x123...` | -| `--supernet-manager` | Address of manager contract | `0x456...` | - -
- -```bash -./xgrchain polybft validator-info --data-dir ./test-chain-1 -``` - -This will show you information about your validator account, including the staked amount. - -::: - -To unstake, use the `xgrchain polybft unstake` command. - -
-Flags ↓ - -| Flag | Description | Example | -|---------------------|------------------------------------------------------------|---------------------------------------| -| --amount | Amount to unstake from validator | --amount 1000 | -| --config | Path to the SecretsManager config file | --config /path/to/config/file | -| --data-dir | Directory for the XGRChain data if the local FS is used | --data-dir /path/to/data/dir | -| --jsonrpc | JSON-RPC interface | --jsonrpc 0.0.0.0:8545 | - -
- -```bash -./xgrchain polybft unstake \ - --account-dir \ - --jsonrpc \ - --amount -``` - -## Withdraw - -Once you have successfully unstaked, you will need to withdraw your unstaked tokens from the Edge-powered chain to the rootchain. To do so, use the `xgrchain polybft withdraw-child` command. - -
-Flags ↓ - -| Flag | Description | Example | -|------|-------------|---------| -| `--config` | The path to the SecretsManager config file, if omitted, the local FS secrets manager is used | `~/secrets.json` | -| `--data-dir` | The directory for the XGRChain data if the local FS is used | `~/xgrchain/data` | -| `--jsonrpc` | The JSON-RPC interface (default "0.0.0.0:8545") | `127.0.0.1:8545` | - -
- -```bash -./xgrchain polybft withdraw-child \ - --account-dir \ - --jsonrpc -``` - -This command will bridge the unstaked amount to the rootchain (`StakeManager`), where the given amount of tokens will become released on the given contract. - -#### Wait for Checkpoint - -Next, you will need to wait for the exit event (bridge event) to be included in a checkpoint. -You can confirm that the checkpoint has been successfully processed by checking the processed checkpoints on a blockchain explorer. - -### Send an Exit Transaction - -Once the exit event has been included in a checkpoint, you can send an exit transaction to execute the transaction on the rootchain. To do so, use the `xgrchain bridge exit` command. - -
-Flags ↓ - -| Flag | Description | Example | -|----------------------|---------------------------------------------------------------------|--------------------------------------| -| --child-json-rpc | The JSON RPC Supernet endpoint. | --child-json-rpc=http://127.0.0.1:9545 | -| --exit-helper | Address of ExitHelper smart contract on rootchain. | --exit-helper= | -| --exit-id | Supernet exit event ID. | --exit-id= | -| --root-json-rpc | The JSON RPC rootchain endpoint. | --root-json-rpc=http://127.0.0.1:8545 | -| --sender-key | Hex encoded private key of the account which sends exit transaction to the rootchain. | --sender-key= | -| --test | Test indicates whether exit transaction sender is hardcoded test account. | --test | - -
- - ```bash - ./xgrchain bridge exit \ - --sender-key \ - --exit-helper \ - --exit-id \ - --root-json-rpc \ - --child-json-rpc - ``` - -This will trigger the withdrawal of the specified amount of tokens from the rootchain. - -### Withdraw from Root - -Finally, you can withdraw your tokens from the rootchain to your address by using the `xgrchain polybft withdraw-root` command. - -
-Flags ↓ - -| Flag | Description | Example | -|------------------------|-----------------------------------------|------------------------------------| -| --amount | amount to withdraw | --amount 1000000000000000000 | -| --config | path to the SecretsManager config file | --config /path/to/config | -| --data-dir | directory for the XGRChain data | --data-dir /path/to/data/dir | -| --jsonrpc | JSON-RPC interface | --jsonrpc 0.0.0.0:8545 | -| --stake-manager | address of stake manager contract | --stake-manager 0x123abc | -| --to | address where to withdraw | --to 0x456def | - -
- - ```bash - ./xgrchain polybft withdraw-root \ - --account-dir \ - --to \ - --amount \ - --stake-manager \ - --jsonrpc - ``` - -This will transfer your withdrawn tokens back to the specified withdrawal address. diff --git a/docs/docs/operate/deploy/start-chain.md b/docs/docs/operate/deploy/start-chain.md deleted file mode 100644 index 7c58360..0000000 --- a/docs/docs/operate/deploy/start-chain.md +++ /dev/null @@ -1,70 +0,0 @@ - -To run an Edge cluster, we use the `xgrchain server` command with the following options: - -
-Flags ↓ - -| Flag | Description | Example | -|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------| -| `--access-control-allow-origins` | The CORS header indicating whether any JSON-RPC response can be shared with the specified origin. | `--access-control-allow-origins "*"` | -| `--block-gas-target` | The target block gas limit for the chain. | `--block-gas-target "0x0"` | -| `--chain` | The genesis file used for starting the chain. | `--chain "./genesis.json"` | -| `--config` | The path to the CLI config. | `--config "/path/to/config.json"` | -| `--data-dir` | The data directory used for storing XGRChain client data. | `--data-dir "/path/to/data-dir"` | -| `--dns` | The host DNS address which can be used by a remote peer for connection. | `--dns "example.com"` | -| `--grpc-address` | The GRPC interface. | `--grpc-address "127.0.0.1:9632"` | -| `--json-rpc-batch-request-limit` | Max length to be considered when handling JSON-RPC batch requests. | `--json-rpc-batch-request-limit 20` | -| `--json-rpc-block-range-limit` | Max block range to be considered when executing JSON-RPC requests that consider fromBlock/toBlock values. | `--json-rpc-block-range-limit 1000` | -| `--jsonrpc` | The JSON-RPC interface. | `--jsonrpc "0.0.0.0:8545"` | -| `--libp2p` | The address and port for the libp2p service. | `--libp2p "127.0.0.1:1478"` | -| `--log-level` | The log level for console output. | `--log-level "INFO"` | -| `--log-to` | Write all logs to the file at specified location instead of writing them to console. |` --log-to "/path/to/log-file.log"` | -| `--max-enqueued` | Maximum number of enqueued transactions per account. | `--max-enqueued 128` | -| `--max-inbound-peers` | The client's max number of inbound peers allowed. | `--max-inbound-peers 32` | -| `--max-outbound-peers` | The client's max number of outbound peers allowed. | `--max-outbound-peers 8` | -| `--max-peers` | The client's max number of peers allowed. | `--max-peers 40` | -| `--max-slots` | Maximum slots in the pool. | `--max-slots 4096` | -| `--nat` | The external IP address without port, as can be seen by peers. | `--nat "203.0.113.1"` | -| `--no-discover` | Prevent the client from discovering other peers. | `--no-discover` | -| `--num-block-confirmations` | Minimal number of child blocks required for the parent block to be considered final. | `--num-block-confirmations 64` | -| `--price-limit` | The minimum gas price limit to enforce for acceptance into the pool. | `--price-limit 0` | -| `--prometheus` | The address and port for the Prometheus instrumentation service. If only port is defined, it will bind to all available network interfaces. |`--prometheus 0.0.0.0:9090` | -| `--relayer` | Start the state sync relayer service. PolyBFT only. | | -| `--restore` | The path to the archive blockchain data to restore on initialization. | `--restore /path/to/archive` | -| `--seal` | The flag indicating that the client should seal blocks. | | -| `--secrets-config` | The path to the SecretsManager config file. Used for Hashicorp Vault. If omitted, the local FS secrets manager is used. | `--secrets-config /path/to/secrets/config` | - -
- - ```bash - ./xgrchain server --data-dir ./test-chain-1 --chain genesis.json --grpc-address :5001 --libp2p :30301 --jsonrpc :10001 --seal --log-level DEBUG - - ./xgrchain server --data-dir ./test-chain-2 --chain genesis.json --grpc-address :5002 --libp2p :30302 --jsonrpc :10002 --seal --log-level DEBUG - - ./xgrchain server --data-dir ./test-chain-3 --chain genesis.json --grpc-address :5003 --libp2p :30303 --jsonrpc :10003 --seal --log-level DEBUG - - ./xgrchain server --data-dir ./test-chain-4 --chain genesis.json --grpc-address :5004 --libp2p :30304 --jsonrpc :10004 --seal --log-level DEBUG - ``` - -
-Dialing output example - - ```bash - [ROOTCHAIN FUND] - Validator (address) = 0x0D09C4A285fdde3D6e5aD5DE819E3478554646D3 - Transaction (hash) = 0xb587d3fa31f8bc59ecc807145d95d76a454967e28223d0f3b82abdd6bd84c043 - - [ROOTCHAIN FUND] - Validator (address) = 0x30aC45469E94DE3645Eb4D8Ce102a3092ee76157 - Transaction (hash) = 0x3e9b26da5e89aa8ca2b4935ce35ddedc1f8d9b37c56d5eb0f040787aa84a3bcb - - [ROOTCHAIN FUND] - Validator (address) = 0x9E1bFa593cAcD77BfcF9a8Dda0462da251566ae0 - Transaction (hash) = 0x1aa158ed2ba1e8ec98b1f4fd649c9a499b72c58a48b1a1dd9978ee16cc7fb741 - - [ROOTCHAIN FUND] - Validator (address) = 0x82e3D3e4222Cc872C5552363c86287B796312E27 - Transaction (hash) = 0xd51e7f8b69071f88b5f7870c31c6942ed78c5c48f88594ed135f096b5f17a540 - ``` - -
diff --git a/docs/docs/operate/deploy/transfers/deposit.md b/docs/docs/operate/deploy/transfers/deposit.md deleted file mode 100644 index 6ce0301..0000000 --- a/docs/docs/operate/deploy/transfers/deposit.md +++ /dev/null @@ -1,217 +0,0 @@ - -## Prerequisites - -You'll need to have a successful bridge deployment to make any cross-chain transactions. If you haven't done so already, check out the local deployment guide [here](../local-chain.md). - -:::caution Key management and secure values -When passing values to run transactions, it is important to keep sensitive values like private keys and API keys secure. - -The sample commands provided in this guide use sample private keys for demonstration purposes only, in order to show the format and expected value of the parameter. It is important to note that hardcoding or directly passing private keys should never be done in a development or production environment. - -
-Here are some options for securely storing and retrieving private keys ↓ - -- **Environment Variables:** You can store the private key as an environment variable and access it in your code. For example, in Linux, you can set an environment variable like this: `export PRIVATE_KEY="my_private_key"`. Then, in your code, you can retrieve the value of the environment variable using `os.Getenv("PRIVATE_KEY")`. - -- **Configuration Files:** You can store the private key in a configuration file and read it in your session. Be sure to keep the configuration file in a secure location and restrict access to it. - -- **Vaults and Key Management Systems:** If you are working with sensitive data, you might consider using a vault or key management system like a keystore to store your private keys. These systems provide additional layers of security and can help ensure that your private keys are kept safe. - -
- -Regardless of how a private key is stored and retrieved, it's important to keep it secure and not expose it unnecessarily. - -::: - -### Depositing from the Rootchain - -
- bridge -
- -### Depositing from the Childchain - -
- bridge -
- -For a detailed understanding of how bridging works, please refer to the sequence diagrams available [here](https://github.com/xgr-network/xgr-node/blob/develop/docs/bridge/sequences.md). - - - - - - - - - - - - - - - -This command deposits ERC-20 tokens from a rootchain to a Edge-powered chain. - -- Replace `hex_encoded_depositor_private_key` with the private key of the account that will be depositing the tokens. -- Replace `receivers_addresses` with a comma-separated list of Ethereum addresses that will receive the tokens. -- Replace `amounts` with a comma-separated list of token amounts to be deposited for each receiver. -- Replace `root_erc20_token_address` with the address of the ERC-20 token contract on the rootchain. -- Replace `root_erc20_predicate_address` with the address of the ERC-20 predicate contract on the rootchain. -- Replace `root_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the rootchain. -- Replace `minter-key` with the private key of the minter account. If the private key is provided, tokens are minted to the sender account prior to depositing them. - -```bash -./xgrchain bridge deposit-erc20 \ - --sender-key \ - --receivers \ - --amounts \ - --root-token \ - --root-predicate \ - --json-rpc - --minter-key -``` - -
-Example ↓ - -In this example, we're depositing ERC-20 tokens to a test Edge instance: - -- We're using a private key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. -- We're depositing tokens to two receiver addresses: `0x1111111111111111111111111111111111111111` and `0x2222222222222222222222222222222222222222`. -- We're depositing `100` tokens to the first receiver and `200` tokens to the second receiver. -- The address of the ERC-20 token contract on the rootchain is `0x123456789abcdef0123456789abcdef01234567`. -- The address of the ERC-20 predicate contract on the rootchain is `0x23456789abcdef0123456789abcdef012345678`. -- The JSON-RPC endpoint for the rootchain is `http://root-chain-json-rpc-endpoint.com:8545`. -- We're using a minter key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. - -```bash -./xgrchain bridge deposit-erc20 \ - --sender-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --receivers 0x1111111111111111111111111111111111111111,0x2222222222222222222222222222222222222222 \ - --amounts 100,200 \ - --root-token 0x123456789abcdef0123456789abcdef01234567 \ - --root-predicate 0x23456789abcdef0123456789abcdef012345678 \ - --json-rpc http://root-chain-json-rpc-endpoint.com:8545 - --minter-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef -``` - -
- - - - - - - - -This command deposits ERC-721 tokens from a rootchain to a Edge-powered chain. - -- Replace `hex_encoded_depositor_private_key` with the private key of the account that will be depositing the tokens. -- Replace `receivers_addresses` with a comma-separated list of Ethereum addresses that will receive the tokens. -- Replace `token_ids` with a comma-separated list of token IDs that will be sent to the receivers' accounts. -- Replace `root_erc721_token_address` with the address of the ERC-721 token contract on the rootchain. -- Replace `root_erc721_predicate_address` with the address of the ERC-721 predicate contract on the rootchain. -- Replace `root_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the rootchain. -- Replace `minter-key` with the private key of the minter account. If the private key is provided, tokens are minted to the sender account prior to depositing them. - -```bash -./xgrchain bridge deposit-erc721 \ - --sender-key \ - --receivers \ - --token-ids \ - --root-token \ - --root-predicate \ - --json-rpc - --minter-key -``` - -
-Example ↓ - -In this example, we're depositing ERC-721 tokens to a test Edge instance: - -- We're using a private key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. -- We're depositing tokens with IDs `123` and `456` to two receiver addresses: `0x1111111111111111111111111111111111111111` and `0x2222222222222222222222222222222222222222`. -- The address of the ERC-721 token contract on the rootchain is `0x0123456789abcdef0123456789abcdef01234567`. -- The address of the ERC-721 predicate contract on the rootchain is `0x0123456789abcdef0123456789abcdef01234568`. -- The JSON-RPC endpoint for the rootchain is `https://rpc-mainnet.maticvigil.com`. -- We're using a minter key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. - -```bash -./xgrchain bridge deposit-erc721 \ - --sender-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --receivers 0x1111111111111111111111111111111111111111,0x2222222222222222222222222222222222222222 \ - --token-ids 123,456 \ - --root-token 0x0123456789abcdef0123456789abcdef01234567 \ - --root-predicate 0x0123456789abcdef0123456789abcdef01234568 \ - --json-rpc https://rpc-mainnet.maticvigil.com - --minter-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef -``` -
- - - - - - - - -This command deposits ERC-1155 tokens from the rootchain to the Edge-powered chain. - -- Replace `depositor_private_key` with the private key of the account that will be depositing the tokens. -- Replace `receivers_addresses` with a comma-separated list of Ethereum addresses that will receive the tokens. -- Replace `amounts` with a comma-separated list of token amounts to be deposited for each receiver. -- Replace `token_ids` with a comma-separated list of token IDs to be deposited. -- Replace `root_erc1155_token_address` with the address of the ERC-1155 token contract on the rootchain. -- Replace `root_erc1155_predicate_address` with the address of the ERC-1155 predicate contract on the rootchain. -- Replace `root_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the rootchain. -- Replace `minter-key` with the private key of the minter account. If the private key is provided, tokens are minted to the sender account prior to depositing them. - -```bash -./xgrchain bridge deposit-erc1155 \ - --sender-key \ - --receivers \ - --amounts \ - --token-ids \ - --root-token \ - --root-predicate \ - --json-rpc - --minter-key -``` - -
-Example ↓ - -In this example, we're depositing ERC-1155 tokens to a test Edge instance: - -- We're using a private key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. -- We're depositing tokens to two receiver addresses: `0x0123456789abcdef0123456789abcdef01234567` and `0x89abcdef0123456789abcdef0123456789abcdef`. -- We're depositing `10` tokens to the first receiver and `20` tokens to the second receiver. -- The address of the ERC-1155 token contract on the rootchain is `0x0123456789abcdef0123456789abcdef01234567`. -- The address of the ERC-1155 predicate contract on the rootchain is `0x89abcdef0123456789abcdef0123456789abcdef`. -- The JSON-RPC endpoint for the rootchain is `http://localhost:8545`. -- We're using a minter key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. - -```bash -./xgrchain bridge deposit-erc1155 \ - --sender-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --receivers 0x0123456789abcdef0123456789abcdef01234567,0x89abcdef0123456789abcdef0123456789abcdef \ - --amounts 10,20 \ - --token-ids 1,2 \ - --root-token 0x0123456789abcdef0123456789abcdef01234567 \ - --root-predicate 0x89abcdef0123456789abcdef0123456789abcdef \ - --json-rpc http://localhost:8545 - --minter-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef -``` - -
- - diff --git a/docs/docs/operate/deploy/transfers/withdraw.md b/docs/docs/operate/deploy/transfers/withdraw.md deleted file mode 100644 index e6c5c51..0000000 --- a/docs/docs/operate/deploy/transfers/withdraw.md +++ /dev/null @@ -1,322 +0,0 @@ -## Prerequisites - -You'll need to have a successful bridge deployment to make any cross-chain transactions. If you haven't done so already, check out the local deployment guide [here](../local-chain.md). - -:::caution Key management and secure values -When passing values to run transactions, it is important to keep sensitive values like private keys and API keys secure. - -The sample commands provided in this guide use sample private keys for demonstration purposes only, in order to show the format and expected value of the parameter. It is important to note that hardcoding or directly passing private keys should never be done in a development or production environment. - -
-Here are some options for securely storing and retrieving private keys ↓ - -- **Environment Variables:** You can store the private key as an environment variable and access it in your code. For example, in Linux, you can set an environment variable like this: `export PRIVATE_KEY="my_private_key"`. Then, in your code, you can retrieve the value of the environment variable using `os.Getenv("PRIVATE_KEY")`. - -- **Configuration Files:** You can store the private key in a configuration file and read it in your session. Be sure to keep the configuration file in a secure location and restrict access to it. - -- **Vaults and Key Management Systems:** If you are working with sensitive data, you might consider using a vault or key management system like a keystore to store your private keys. These systems provide additional layers of security and can help ensure that your private keys are kept safe. - -
- -Regardless of how a private key is stored and retrieved, it's important to keep it secure and not expose it unnecessarily. - -::: - -### Withdrawing from the Rootchain - -
- bridge -
- -### Withdrawing from the Childchain - -
- bridge -
- -For a detailed understanding of how bridging works, please refer to the sequence diagrams available [here](https://github.com/xgr-network/xgr-node/blob/develop/docs/bridge/sequences.md). - - - - - - - - - - - - - - - -## Withdraw - -This command withdraws ERC-20 tokens from an Edge-powered chain to a rootchain. - -- Replace `hex_encoded_txn_sender_private_key` with the private key of the account that will be sending the transaction. -- Replace `receivers_addresses` with a comma-separated list of Ethereum addresses that will receive the tokens. -- Replace `amounts` with a comma-separated list of token amounts to be withdrawn for each receiver. -- Replace `child_erc20_predicate_address` with the address of the ERC-20 predicate contract on the Edge-powered chain. -- Replace `child_erc20_token_address` with the address of the ERC-20 token contract on the Edge-powered chain (optional, only required if the token is not a default ERC-20 token). -- Replace `child_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the Edge-powered chain. - -```bash - ./xgrchain bridge withdraw-erc20 \ - --sender-key \ - --receivers \ - --amounts \ - --child-predicate \ - --child-token \ - --json-rpc -``` - -
-Example ↓ - -- We're using a private key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. -- We're withdrawing tokens from two receiver addresses: `0x1111111111111111111111111111111111111111` and `0x2222222222222222222222222222222222222222`. -- We're withdrawing `100` tokens from the first receiver and `200` tokens from the second receiver. -- The address of the ERC-20 predicate contract on the Edge-powered chain is `0x3456789abcdef0123456789abcdef0123456789`. -- The address of the ERC-20 token contract on the Edge-powered chain is `0x456789abcdef0123456789abcdef0123456789`. -- The JSON-RPC endpoint for the Edge-powered chain is `http://json-rpc-endpoint.com:8545`. - -```bash -./xgrchain bridge withdraw-erc20 \ - --sender-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --receivers 0x1111111111111111111111111111111111111111,0x2222222222222222222222222222222222222222 \ - --amounts 100,200 \ - --child-predicate 0x3456789abcdef0123456789abcdef0123456789 \ - --child-token 0x456789abcdef0123456789abcdef0123456789 \ - --json-rpc http://json-rpc-endpoint.com:8545 -``` - -
- -## Exit - -This command sends an exit transaction to the `ExitHelper` contract on the rootchain for a token that was deposited on the Edge-powered chain. It basically finalizes a withdrawal (initiated on the Edge-powered chain) and transfers assets to receiving address on a rootchain. - -- Replace `hex_encoded_txn_sender_private_key` with the private key of the account that will send the exit transaction. -- Replace `exit_helper_address` with the address of the `ExitHelper` contract on the rootchain. -- Replace `exit_id` with the ID of the exit event. -- Replace `root_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the rootchain. -- Replace `child_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the Edge-powered chain. - -```bash -./xgrchain bridge exit \ - --sender-key \ - --exit-helper \ - --exit-id \ - --root-json-rpc \ - --child-json-rpc -``` - -
-Example ↓ - -In this example, we're sending an exit transaction on a test Edge instance: - -- We're using a private key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. -- The address of the `ExitHelper` contract on the rootchain is `0x123456789abcdef0123456789abcdef01234567`. -- The ID of the exit event is `42`. -- The JSON-RPC endpoint for the rootchain is `http://root-chain-json-rpc-endpoint.com:8545`, and the JSON-RPC endpoint for the Edge-powered chain is `http://json-rpc-endpoint.com:8545`. - -```bash -./xgrchain bridge exit \ - --sender-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --exit-helper 0x123456789abcdef0123456789abcdef01234567 \ - --exit-id 42 \ - --root-json-rpc http://root-chain-json-rpc-endpoint.com:8545 \ - --child-json-rpc http://json-rpc-endpoint.com:8545 -``` - -
- - - - - - - - - -## Withdraw - -This command withdraws ERC-721 tokens from an Edge-powered chain to a rootchain. - -- Replace `hex_encoded_sender_private_key` with the private key of the account that will initiate the withdrawal. -- Replace `receivers_addresses` with a comma-separated list of Ethereum addresses that will receive the withdrawn tokens on the rootchain. -- Replace `token_ids` with a comma-separated list of token IDs to be withdrawn. -- Replace `child_predicate_address` with the address of the predicate contract on the Edge-powered chain that holds the tokens being withdrawn. -- Replace `child_token_address` with the address of the ERC-721 token contract on the Edge-powered chain that holds the tokens being withdrawn. -- Replace `child_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the Edge-powered chain. - -```bash -./xgrchain bridge withdraw-erc721 \ - --sender-key \ - --receivers \ - --token-ids \ - --child-predicate \ - --child-token \ - --jsonrpc -``` - -
-Example ↓ - -In this example, we're withdrawing ERC-721 tokens from a test Edge instance: - -- We're using a private key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. -- We're withdrawing tokens with IDs `123` and `456`. -- The address of the ERC-721 Edge-powered chain predicate contract is `0x23456789abcdef0123456789abcdef012345678`. -- The address of the ERC-721 Edge-powered chain token contract is `0x3456789abcdef0123456789abcdef012345678`. -- The JSON-RPC endpoint for the Edge-powered chain is `http://json-rpc-endpoint.com:8545`. - -
- -## Exit - -This command sends an exit transaction to the `ExitHelper` contract on the rootchain for a token that was deposited on the Edge-powered chain. It basically finalizes a withdrawal (initiated on the Edge-powered chain) and transfers assets to receiving address on a rootchain. - -- Replace `hex_encoded_txn_sender_private_key` with the private key of the account that will send the exit transaction. -- Replace `exit_helper_address` with the address of the `ExitHelper` contract on the rootchain. -- Replace `exit_id` with the ID of the exit event. -- Replace `root_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the rootchain. -- Replace `child_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the Edge-powered chain. - -```bash -./xgrchain bridge exit \ - --sender-key \ - --exit-helper \ - --exit-id \ - --root-json-rpc \ - --child-json-rpc -``` - -
-Example ↓ - -In this example, we're sending an exit transaction on a test Edge instance: - -- We're using a private key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. -- The address of the `ExitHelper` contract on the rootchain is `0x123456789abcdef0123456789abcdef01234567`. -- The ID of the exit event is `42`. -- The JSON-RPC endpoint for the rootchain is `http://root-chain-json-rpc-endpoint.com:8545`, and the JSON-RPC endpoint for the Edge-powered chain is `http://json-rpc-endpoint.com:8545`. - -```bash -./xgrchain bridge exit \ - --sender-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --exit-helper 0x123456789abcdef0123456789abcdef01234567 \ - --exit-id 42 \ - --root-json-rpc http://root-chain-json-rpc-endpoint.com:8545 \ - --child-json-rpc http://json-rpc-endpoint.com:8545 -``` - -
- - - - - - - - - -## Withdraw - -This command withdraws ERC-1155 tokens from the Edge-powered chain to the rootchain. - -- Replace `hex_encoded_withdrawer_private_key` with the private key of the account that will be withdrawing the tokens. -- Replace `receivers_addresses` with a comma-separated list of Ethereum addresses that will receive the tokens. -- Replace `amounts` with a comma-separated list of token amounts to be withdrawn for each receiver. -- Replace `token_ids` with a comma-separated list of token IDs to be withdrawn. -- Replace `root_erc1155_token_address` with the address of the ERC-1155 token contract on the rootchain. -- Replace `root_erc1155_predicate_address` with the address of the ERC-1155 predicate contract on the rootchain. -- Replace `child_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the Edge-powered chain. - -```bash -./xgrchain bridge withdraw-erc1155 \ - --sender-key \ - --receivers \ - --amounts \ - --token-ids \ - --root-token \ - --root-predicate \ - --json-rpc -``` - -
-Example ↓ - -In this example, we're withdrawing ERC-1155 tokens from a test Edge instance to the rootchain: - -- We're using a private key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. -- We're withdrawing tokens to a single receiver address: `0x1111111111111111111111111111111111111111`. -- We're withdrawing `100` tokens with ID `1`. -- The address of the ERC-1155 token contract on the rootchain is `0x123456789abcdef0123456789abcdef01234567`. -- The address of the ERC-1155 predicate contract on the rootchain is `0x23456789abcdef0123456789abcdef012345678`. -- The JSON-RPC endpoint for the Edge-powered chain is `http://json-rpc-endpoint.com:8545`. - -```bash -./xgrchain bridge withdraw-erc1155 \ - --sender-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --receivers 0x1111111111111111111111111111111111111111 \ - --amounts 100 \ - --token-ids 1 \ - --root-token 0x123456789abcdef0123456789abcdef01234567 \ - --root-predicate 0x23456789abcdef0123456789abcdef012345678 \ - --json-rpc http://json-rpc-endpoint.com:8545 -``` - -
- -## Exit - -This command sends an exit transaction to the `ExitHelper` contract on the rootchain for a token that was deposited on the Edge-powered chain. It basically finalizes a withdrawal (initiated on the Edge-powered chain) and transfers assets to receiving address on a rootchain. - -- Replace `hex_encoded_txn_sender_private_key` with the private key of the account that will send the exit transaction. -- Replace `exit_helper_address` with the address of the `ExitHelper` contract on the rootchain. -- Replace `exit_id` with the ID of the exit event. -- Replace `root_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the rootchain. -- Replace `child_chain_json_rpc_endpoint` with the JSON-RPC endpoint of the Edge-powered chain. - -```bash -./xgrchain bridge exit \ - --sender-key \ - --exit-helper \ - --exit-id \ - --root-json-rpc \ - --child-json-rpc -``` - -
-Example ↓ - -In this example, we're sending an exit transaction on a test Edge instance: - -- We're using a private key of `0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef`. -- The address of the `ExitHelper` contract on the rootchain is `0x123456789abcdef0123456789abcdef01234567`. -- The ID of the exit event is `42`. -- The JSON-RPC endpoint for the rootchain is `http://root-chain-json-rpc-endpoint.com:8545`, and the JSON-RPC endpoint for the Edge-powered chain is `http://json-rpc-endpoint.com:8545`. - -```bash -./xgrchain bridge exit \ - --sender-key 0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \ - --exit-helper 0x123456789abcdef0123456789abcdef01234567 \ - --exit-id 42 \ - --root-json-rpc http://root-chain-json-rpc-endpoint.com:8545 \ - --child-json-rpc http://json-rpc-endpoint.com:8545 -``` - -
- - - diff --git a/docs/docs/operate/deploy/upgrades/hardfork.md b/docs/docs/operate/deploy/upgrades/hardfork.md deleted file mode 100644 index 01453ce..0000000 --- a/docs/docs/operate/deploy/upgrades/hardfork.md +++ /dev/null @@ -1,185 +0,0 @@ - -Drawing from a real-world example, this guide delves into the process of introducing a new feature via a hardfork in an Edge-powered chain, utilizing a fork manager to manage the activation and behavior of the fork. - -## 1. Adding Fields - -Add the `ExtraData` field to Extra. Before block 100, the field will be ignored. After block 100, it will be used. Your Extra struct should look like this: - -```go -type Extra struct { - Validators *validator.ValidatorSetDelta - Parent *Signature - Committed *Signature - Checkpoint *CheckpointData - ExtraData []byte // NewField - BlockNumber uint64 // field used by forking manager -} -``` - -The `ExtraData` field is a byte slice (`[]byte`), which can hold any kind of data. - -## 2. Implement Extra.Marshal() Behavior - -The marshaling process will need to account for the ExtraData field after block 100. - -```go -type ExtraHandlerNewField struct { -} - -// MarshalRLPWith defines the marshal function implementation for Extra -func (e *ExtraHandlerNewField) MarshalRLPWith(extra *Extra, ar *fastrlp.Arena) *fastrlp.Value { - vv := extraMarshalBaseFields(extra, ar, ar.NewArray()) - vv.Set(ar.NewBytes(extra.ExtraData)) - return vv -} -``` - -This code creates a new type `ExtraHandlerNewField` which has a method `MarshalRLPWith`. This method handles the marshaling of the `Extra` struct and specifically takes into account the `ExtraData` field. - -## 3. Register the Fork in chain/params.go - -`chain/params.go` is where the details about the fork are specified, such as its name, when it is activated, and how to determine its activity at a given block. - -### 3.1 Define the Fork’s Name - -We first define a constant string to represent the name of the fork. - -```go -const ( -... - NewFieldForkName = "newFieldFork" -) -``` - -### 3.2 Add the Fork as a Supported Fork - -We then include the fork in the `ForksInTime` struct to mark it as a supported fork. - -```go -type ForksInTime struct { -... - NewFieldFork bool -} -``` - -### 3.3 Include the Fork into the genesis.json - -Next, we include the fork in the `genesis.json`. - -```go -var AllForksEnabled = &Forks{ -... - NewFieldForkName: NewFork(0), -} -``` - -### 3.4 Add Support to Read if the Fork is Active at the Current Block - -Finally, we add the ability to read if the fork is active at a specific block. - -```go -func (f *Forks) At(block uint64) ForksInTime { - return ForksInTime{ -... - NewFieldFork: f.IsActive(NewFieldForkName, block), - } -} -``` - -## 4. Register Fork Handlers - -Fork handlers are the functions that are run when a fork becomes active. Here, we register a handler for our new fork, as well as a default handler for blocks before the fork. - -``` -func (f *Forks) At(block uint64) ForksInTime { - return ForksInTime{ -... - NewFieldFork: f.IsActive(NewFieldForkName, block), - } -} -``` - -## 5. Fork Management - -In the `chain/params.go` file, define the parameters related to the fork. They should always be pointer values. For example: - -```go -type ForkParams struct { - MaxValidatorSetSize *uint64 `json:"maxValidatorSetSize,omitempty"` - ... -} -``` - -These parameters represent new rules or behaviors to be introduced. - -## 6. Configuring the Fork in genesis.json - -In the genesis.json file, specify all available forks and their parameters. For instance: - -```json -"forks": { - "EIP150": { - "block": 0 - }, - ... - "myFork": { - "block": 10, - "params": { - "maxValidatorSetSize": 20 - } - }, -} -``` - -Here, a new fork named `myFork` is added with specific parameters and values. For this fork, `maxValidatorSetSize` will be 20. - -## 7. Accessing and Using Fork Parameters in Code - -You can access these parameters in the code using the fork manager. For example: - -```go -maxValidatorSetSize := 100 // default value -ps := forkmanager.GetInstance().GetParam(blockNumber) -if ps != nil { - maxValidatorSetSize = ps.MaxValidatorSetSize -} -``` - -For `blockNumber` < 10, `maxValidatorSetSize` will be set to 100. For `blockNumber` >= 10, the `maxValidatorSetSize` will be 20, the value specified for the `myFork` fork. - -## 8. Setting Default Parameter Values - -If you don't want to use if statements in the code and always want to have default values for the parameters, change the consensus factory method defined in `server/builtin.go`: - -```go -func ForkManagerInitialParamsFactory(config *chain.Chain) (*chain.ForkParams, error) { - pbftConfig, err := GetPolyBFTConfig(config) - if err != nil { - return nil, err - } -​ - return &chain.ForkParams{ - MaxValidatorSetSize: &pbftConfig.MaxValidatorSetSize, - ... - }, nil -} -``` - -Each fork doesn't need to specify all parameters, only the ones that have changed between forks. Other parameters take the value from the previous fork. - -## 9. Network Upgrade - -The introduction of a hard fork necessitates an upgrade process across the network. Nodes need to update their software to incorporate the new fork code, and the new `ExtraData` field becomes active upon reaching the designated block height. Here's an example of the step-by-step process that follows the example used above: - -1. **Generate New Genesis File**: Create a new genesis.json using the updated Edge implementation that includes the fork. -2. **Edit Activation Block**: Set the fork's activation block to 100 in the genesis.json file, as in "MyFirstForkName": 100. -3. **Distribute Genesis File**: Share the updated genesis.json file with all network nodes. - - For a step-by-step guide on generating a new genesis file, please consult the chain configuration deployment guide - [here](../genesis.md). - -4. **Stop Client**: Pause the Edge client on all network nodes before block 100. -5. **Replace Files**: Replace the existing genesis.json and Edge files with the updated versions. -6. **Restart Edge**: Restart the Edge client to apply the hard fork updates. - -Remember, communication with network participants about the specific process and timeline is crucial for a successful upgrade. diff --git a/docs/docs/operate/deploy/upgrades/v1.1.md b/docs/docs/operate/deploy/upgrades/v1.1.md deleted file mode 100644 index 51a88f6..0000000 --- a/docs/docs/operate/deploy/upgrades/v1.1.md +++ /dev/null @@ -1,95 +0,0 @@ -The Edge v1.1 release includes crucial adjustments through two hard forks: `quorumcalcalignment` and `txHashWithType`. -This guide provides details on these changes and the requirements for implementing this upgrade. - -While these are important changes at the technical level, they **do not affect the user experience** and **user data remains unaltered**. -It's also important to note that the upgrade process will involve some downtime as the nodes need to be stopped, updated, and then restarted. - -## Node Upgrade Process - -Follow these steps to upgrade your nodes and implement the hard forks: - -1. **Stop the node(s).** The ideal scenario would be to halt all nodes simultaneously, but if that isn't feasible, ensure at least the majority are stopped around the same time. - -2. **Update the binaries.** Replace the old Edge binary with the new one which incorporates the necessary changes for both the `quorumcalcalignment` and `txHashWithType` forks. - - > For different methods on downloading the latest release, check out the installation guide available [here](../../install.md). - -3. **Update the `genesis.json` file.** Include both the new forks in the `genesis.json` file and specify a block from which each becomes active. The block number for each fork should be greater than the current maximum block number across all nodes. - - Here's an example: - - ```json - "params": { - "forks": { - "txHashWithType": { - "block": 100 - }, - "quorumcalcalignment": { - "block": 120 - }, - ... - } - } - ``` - -4. **Restart the nodes.** Once the binary and `genesis.json` are updated, the node can be restarted. - -## Understanding the Forks - -### `quorumcalcalignment` - -This fork corrects the calculation of the quorum, aligning it with the IBFT paper. This prevents issues that arise when there are a number of validators divisible by 3. - -### `txHashWithType` - -This fork introduces dynamic fee transaction hash calculations that include the transaction type and the correct chainID. The new binary includes a new transaction hash calculation algorithm but will also support the old one until the fork block. Consequently, the hash calculation algorithm will now depend on the block number. - -> Note: It's crucial to ensure no dynamic fee transactions from the block occur when the node is restarted until the `txHashWithType` fork block. The new binary will reject all dynamic fee transactions received from json-rpc or gossip until the fork block is reached. - -Please follow these guidelines carefully to ensure a successful transition while upgrading to Edge v1.1. - -## Additional Details on Quorum Calculation Discrepancy - -Before the Edge v1.1 release, the quorum was calculated by taking the ceiling of `(2*totalVotingPower)/3`, deviating from the specifications of the IBFT paper. With total voting power of 6, where each validator has one token staked, the calculation resulted in: - -`CEILING(2*6/3) = 4 -> 2 faulty -> INCORRECT` - -The correct formula, per the IBFT paper, should be: - -`FLOOR(2*6/3) + 1 = 5 -> 1 faulty -> CORRECT` - -This discrepancy arose between the core contracts and the client side of quorum calculations. - -**Core Contract Side:** The calculation is: `aggVotingPower > ((2 * totalVotingPower) / 3)` -[Reference CheckpointManager.sol](https://github.com/xgr-network/core-contracts/blob/2de13ae801cb2e9b50bce7f062b5a86dcbd149dc/contracts/root/CheckpointManager.sol#L197) - -**Client Side:** The calculation is: `aggVotingPower >= math.Ceil(2 * totalVotingPower) / 3)` -[Reference validator_set.go](https://github.com/xgr-network/xgr-node/blob/develop/consensus/polybft/validator/validator_set.go#L113) - -The client side equation adheres to the IBFT paper's specifications: [arxiv.org/pdf/1909.10194.pdf](https://arxiv.org/pdf/1909.10194.pdf) (page 7, lines 2 and 4) - -### Core Issue - -Problems arise when the number of validators can be divided by 3 (such as 6, 9, 12, etc.). For instance, given 6 validators each with voting powers equal to 1, and 4 out of 6 validators have voted (`aggVotingPower = 4`): - -- The **Core Contract** will check: `4 > (2 * 6)/3 β†’ 4 > 4 β†’ false` -- The **Client Side** will check: `4 >= math.Ceil((2 * 6)/3) β†’ 4 >= 4 β†’ true` - -In this case, the client side reaches the quorum, but the core contract does not. This inconsistency prevents the checkpoint from passing, causing the bridging from the edge to rootchain to halt. The `quorumcalcalignment` hard fork resolves this issue. - -## Additional Details on Transaction Hash Fork - `txHashWithType` - -The `txHashWithType` fork is implemented to enhance dynamic fee transaction hash calculations, including the transaction type and the correct chainID. - -After implementing this fork, the new binary includes a revised transaction hash calculation algorithm, while still supporting the old one until the fork block. As a result, the hash calculation algorithm depends on the block number, i.e., the block number determines which hash algorithmβ€”old or newβ€”should be used. - -For instance, if we call `tx.ComputeHash(blockNumber)` for a dynamic fee `tx`, we get: - -- For block number < 100, the old hash without the type -- For block number >= 100, the new hash with the type and the correct chain ID - -A transaction hash is computed as soon as a transaction enters a node's transaction pool. At that point, the latest block number from the blockchain is used for hash calculation. Later, if the transaction is needed, it's read from storage, deserialized, and the hash is recalculated using the block number of the block containing the transaction. - -Given this, it's crucial to ensure that no dynamic fee transactions from the block occur when the node is restarted until the `txHashWithType` fork block. The new binary rejects all dynamic fee transactions received from json-rpc or gossip until the fork block is reached. - -> Note: Select a sufficiently large block number for the `txHashWithType` fork to prevent dynamic fee transactions with old hashes from being included in blocks after the fork block. After replacing the new binary, updating `genesis.json`, and restarting the node, there will be a period during which the node won't be able to accept new dynamic fee transactions either from json-rpc or gossip. Ensure enough "room" between the latest block synced/validated and the fork block on the node. diff --git a/docs/docs/operate/install.md b/docs/docs/operate/install.md deleted file mode 100644 index 8eb4a25..0000000 --- a/docs/docs/operate/install.md +++ /dev/null @@ -1,41 +0,0 @@ -!!! tip - - We recommend using the pre-built releases and verifying the provided checksums for security. - - The Docker image is also a convenient option for containerized deployment. Building from source provides greater flexibility, but requires a [suitable development environment](system.md). - -## Pre-built releases - -To access the pre-built releases, visit the [GitHub releases page](https://github.com/xgr-network/xgr-node/releases). -The client provides cross-compiled AMD64/ARM64 binaries for Darwin and Linux. - -!!! info "Latest release: 1.3.0" - - **The latest stable test release is [v1.3.0](https://github.com/xgr-network/xgr-node/releases/tag/v1.3.0).** - -## Docker image - -To use Docker, you will need to have it installed on your system. If you haven't already installed Docker, you can follow the instructions on the -[official Docker website](https://www.docker.com/) for your operating system. - -You can access the official XGRChain Docker images hosted under the [xgr-network registry](https://hub.docker.com/r/xgrnetwork/xgrchain) using the following command: - - ```bash - docker pull xgrnetwork/xgrchain:latest - ``` - -## Build from source - -> Before getting started, ensure you have [Go](https://go.dev/) installed on your system (version >= 1.15 and <= 1.19). -> Compatibility is being worked on for other versions and will be available in the near future. - -> To install Go, run the following command in your CLI (we are using 1.18 in this example): `sudo apt-get install golang-1.18`. -> Or, use a package manager like [Snapcraft](https://snapcraft.io/go) for Linux, [Homebrew](https://formulae.brew.sh/formula/go) for Mac, and [Chocolatey](https://community.chocolatey.org/packages/golang) for Windows. - -Use the following commands to clone the XGRChain repository and build from source: - - ```bash - git clone https://github.com/xgr-network/xgr-node.git - cd xgrchain/ - go build -o xgrchain . - ``` diff --git a/docs/docs/operate/param-reference.md b/docs/docs/operate/param-reference.md deleted file mode 100644 index 6d65c64..0000000 --- a/docs/docs/operate/param-reference.md +++ /dev/null @@ -1,153 +0,0 @@ - -Configuration parameters are crucial for setting up and operating a Edge-powered chain. You can configure these parameters using the genesis and server commands. Before running these commands, it is essential to generate keys using the polybft-secrets command. - -For information on the available configuration flags and their descriptions for customizing the genesis configuration of an Edge-powered chain, refer to the categorized tabs below. - - - - - - - - - -## PolyBFT Configuration Parameter Reference - -| Parameter | Description | Default Value | Mandatory | -| :-------- | :--------------------------------------------------------------- | :------------ | :-------- | -| `--account` | The flag indicating whether a new account is created | TRUE | NO | -| `--config string` | The path to the SecretsManager config file | "" | NO | -| `--data-dir string` | The directory for the XGRChain data if the local FS is used | "" | YES | -| `--insecure` | The flag indicating whether the secrets stored locally are encrypted | FALSE | NO | -| `--network` | The flag indicating whether a new Network key is created | TRUE | NO | -| `--num int` | The number of secrets to be created (only for local FS) | 1 | NO | -| `--output` | The flag indicating whether to output existing secrets | FALSE | NO | -| `--private` | The flag indicating whether the private key is printed | FALSE | NO | - -:::info Mutually Exclusive Paramaters - -- `--config` and `--data-dir`: These flags are mutually exclusive. Use either `--config` to specify the path to the SecretsManager config file or `--data-dir` to set the directory for the XGRChain data if the local FS is used. - -- `--num` and `--config`: These flags are mutually exclusive. Set `--num` to define the number of secrets to be created (only for local FS) or use `--config` to provide the SecretsManager config file path. - -::: - - - - - - - - - -## Genesis Configuration Parameter Reference - -| Parameter | Description | Default Value | Mandatory | Example | Reconfigurable at Runtime | -| :-------- | :---------- | :------------ | :-------- | :------ | :----------------------- | -| `--block-tracker-poll-interval` | Interval (number of seconds) at which block tracker polls for latest block at rootchain. | 1s | NO | `genesis --block-tracker-poll-interval "1s"` | NO | -| `--bridge-allow-list-admin` | List of addresses to use as admin accounts in the bridge allow list. | []string{} | NO | `genesis --bridge-allow-list-admin "0x2f82ad5785F6f3Fd242e7EC7a03c2cDfBA6cC6D1"` | NO | -| `--bridge-allow-list-enabled` | List of addresses to enable by default in the bridge allow list. | []string{} | NO | `genesis --bridge-allow-list-enabled "0xbB39871E4e399b22428FdfA9E4e4Ca67842EA8Cd"` | NO | -| `--bridge-block-list-admin` | List of addresses to use as admin accounts in the bridge block list. | N/A | NO | `genesis --bridge-block-list-admin "0xAddress1"` | NO | -| `--bridge-block-list-enabled` | List of addresses to enable by default in the bridge block list. | N/A | NO | `genesis --bridge-block-list-enabled "0xAddress2"` | NO | -| `--chain-id` | The ID of the chain. | 100 | NO | `genesis --chain-id "100"` | NO | -| `--contract-deployer-allow-list-admin` | List of addresses to use as admin accounts in the contract deployer allow list. | N/A | NO | `genesis --contract-deployer-allow-list-admin "0xAddress3"` | NO | -| `--contract-deployer-allow-list-enabled` | List of addresses to enable by default in the contract deployer allow list. | N/A | NO | `genesis --contract-deployer-allow-list-enabled "0xAddress4"` | NO | -| `--contract-deployer-block-list-admin` | List of addresses to use as admin accounts in the contract deployer block list. | N/A | NO | `genesis --contract-deployer-block-list-admin "0xAddress5"` | NO | -| `--contract-deployer-block-list-enabled` | List of addresses to enable by default in the contract deployer block list. | N/A | NO | `genesis --contract-deployer-block-list-enabled "0xAddress6"` | NO | -| `--ibft-validator` | Addresses to be used as IBFT validators. | N/A | NO | `genesis --ibft-validator "0xAddress7"` | NO | -| `--ibft-validator-type` | The type of validators in IBFT. | "bls" | NO | `genesis --ibft-validator-type "bls"` | NO | -| `--ibft-validators-prefix-path` | Prefix path for validator folder directory. | N/A | NO | `genesis --ibft-validators-prefix-path "/path/to/validators"` | NO | -| `--max-validator-count` | The maximum number of validators in the validator set for PoS. | 9007199254740990 | NO | `genesis --max-validator-count "9007199254740990"` | NO | -| `--min-validator-count` | The minimum number of validators in the validator set for PoS. | 1 | NO | `genesis --min-validator-count "1"` | NO | -| `--pos` | Flag indicating use of Proof of Stake IBFT. | N/A | NO | `genesis --pos` | NO | -| `--proxy-contracts-admin` | Admin for proxy contracts. | N/A | NO | `genesis --proxy-contracts-admin "0xAddress8"` | NO | -| `--reward-token-code` | Hex encoded reward token byte code. | N/A | NO | `genesis --reward-token-code "0xHexCode"` | NO | -| `--transactions-allow-list-admin` | List of addresses to use as admin accounts in the transactions allow list. | N/A | NO | `genesis --transactions-allow-list-admin "0xAddress9"` | NO | -| `--transactions-allow-list-enabled` | List of addresses to enable by default in the transactions allow list. | N/A | NO | `genesis --transactions-allow-list-enabled "0xAddress10"` | NO | -| `--transactions-block-list-admin` | List of addresses to use as admin accounts in the transactions block list. | N/A | NO | `genesis --transactions-block-list-admin "0xAddress11"` | NO | -| `--transactions-block-list-enabled` | List of addresses to enable by default in the transactions block list. | N/A | NO | `genesis --transactions-block-list-enabled "0xAddress12"` | NO | -| `--block-gas-limit` | The maximum amount of gas used by all transactions in a block | 5242880 | NO | `genesis --block-gas-limit "10000000"` | NO | -| `--block-time` | The predefined period which determines block creation frequency | 2s | NO | `genesis --block-time "10s"` | NO | -| `--block-time-drift` | Configuration for block time drift value (in seconds). Defines the time slot in which a new block can be created | 10 | NO | `genesis --block-time-drift "20"` | NO | -| `--bootnode` | MultiAddr URL for p2p discovery bootstrap. This flag can be used multiple times. | N/A | NO | `genesis --bootnode "/ip4/127.0.0.1/tcp/30301/p2p/16Uiu2HAmBW3zAvTEHGj5DDygJ5AzuvaRdY5wtSLNmkvXfaQensBu"` | NO | -| `--burn-contract` | The burn contract blocks and addresses (format: [block]:[address]) | []string{} | NO | `genesis --burn-contract "0:0x0000000000000000000000000000000000000000"` | NO | -| `--consensus` | The consensus protocol to be used | "polybft" | NO | `genesis --consensus polybft` | NO | -| `--dir` | Represents the file path for the genesis data | "./genesis.json" | NO | `genesis --dir "/data/genesis.json"` | NO | -| `--epoch-reward` | Reward size for block sealing | 1 | NO | `genesis --epoch-reward "10"` | NO | -| `--epoch-size` | The epoch size for the chain | 100000 | NO | `genesis --epoch-size "10"` | NO | -| `--name` | The name for the chain | "xgrchain" | NO | `genesis --name "test-chain"` | NO | -| `--premine` | The premined accounts and balances | []string{} | NO | `genesis --premine 0x85da99c8a7c2c95964c8efd687e95e632fc533d6:1000000000000000000000` | NO | -| `--sprint-size` | The number of blocks included into a sprint | 5 | NO | `genesis --sprint-size "2"` | NO | -| `--trieroot` | Trie root from the corresponding triedb | "" | NO | `genesis --trieroot "0xabc123"` | NO | -| `--validators` | Initial validator addresses for the chain | []string{} | YES | `genesis --validators "0x9c106ada8a2a36a9de8d67b347c07156033882e0"` | NO | -| `--validators-path` | Root path containing polybft validators' secrets | "./" | NO | `genesis --validators-path "/data/validators"` | NO | -| `--validators-secret` | Validators secrets | []string{} | NO | `genesis --validators-secret "0x0101010101010101010101010101010101010101010101010101010101010101"` | NO | - -:::info Mutually Exclusive Paramaters - -- `--validators`: Validators defined by the user (format: `::`). If this flag is set, the entire multi address must be specified. If not set, validators configuration will be read from `--validators-path`. -- `--validators-path`: Root path containing polybft validators' secrets. If `--validators` flag is not specified, validators' configuration will be read from this path. -- `--validators-prefix`: Folder prefix names for polybft validators' secrets. If `--validators` flag is set, this prefix will be used for folder names. - -::: - - - - - - - - - -## Server Configuration Parameter Reference - -| Parameter | Description | Default Value | Mandatory | Example | Reconfigurable at Runtime | -| :-------- | :---------- | :------------ | :-------- | :------ | :----------------------- | -| `--grpc-address` string | The address of the GRPC interface. | "127.0.0.1:9632" | NO | Command: server Flag: --grpc-address β€œ0.0.0.0:10000” | NO | -| `--jsonrpc` string | The address of the JSON-RPC interface. | "0.0.0.0:8545" | NO | Command: server Flag: --jsonrpc β€œ0.0.0.0:10002” | NO | -| `--log-level` string | The log level for the console output. | β€œINFO” | NO | Command: server Flag: --log-level β€œDEBUG” | NO | -| `--chain` string | The genesis file used for starting the chain. The genesis file is generated by running the genesis CLI command. | "./genesis.json" | NO | Command: server Flag: --chain β€œgenesis.json” | NO | -| `--config` string | The path to the CLI config. Supported extensions are: .json, .hcl, .yaml and .yml. If this flag is set, other flags will be overridden. If some value that will be overridden is not specified in a config file, default value for that parameter is used. | β€œβ€ | NO | Command: server Flag: --config β€œconfig.json” | NO | -| `--data-dir` string | The data directory used for storing XGRChain client data. | β€œβ€ | YES | Command: server Flag:--data-dir β€œ./test-chain-1” | NO | -| `--libp2p` string | The address and port for the libp2p service. | β€œ127.0.0.1:1478” | NO | Command: server Flag: --libp2p β€œ0.0.0.0:30301” | NO | -| `--prometheus` string | The address and port for the prometheus instrumentation service (address:port). If only port is defined (:port) it will bind to 0.0.0.0:port. | β€œβ€ | NO | Command: server Flag: --prometheus β€œ0.0.0.0:5001” | NO | -| `--nat` string | The external IP address without port, as can be seen by peers. The string specidied can be in IPv4 dotted decimal ("192.0.2.1"), IPv6 ("2001:db8::68"), or IPv4-mapped IPv6 ("::ffff:192.0.2.1") form. | β€œβ€ | NO | Command: server Flag:--nat "192.0.2.1" | NO | -| `--dns` string | The host DNS address which can be used by a remote peer for connection. | β€œβ€ | NO | Command: server Flag: --dns "www.example.com" | NO | -| `--block-gas-target` string | The target block gas limit for the chain. If omitted, the value of the parent block is used which will be the value set by the `--block-gas-limit` flag of the genesis command. If this flag is set, the block fill take block gas limit of the parent block and increment it by small delta (parentGasLimit /1024). If the block gas target is reached that the value of it will be set as a gas limit for the current block. | 0x0 | NO | Command: server Flag: --block-gas-target β€œ10000000” | YES, this parameter can be changed by stopping the node and then starting it again with the server command and specifying --block-gas-target flag providing the new value e.g. --block-gas-target β€œ60000000” | -| `--secrets-config` string | The path to the SecretsManager config file. Used for Hashicorp Vault. If omitted, the local FS secrets manager is used. | β€œβ€ | NO | Command: server Flag: --secret-config β€œhashicorp.json” | NO | -| `--restore` string | The path to the archive blockchain data to restore on initialization. | β€œβ€ | NO | Command: server Flag: --restore | NO | -| `--seal` | The flag indicating that the client should seal blocks. | TRUE | NO | Command: server Flag: --seal | NO | -| `--no-discover` | Prevent the client from discovering other peers. | FALSE | NO | Command: server Flag: --no-discover | NO | -| `--max-peers` int | The client's max number of peers allowed. | 40 | NO | Command: server Flag: --max-peers β€œ70” | NO | -| `--max-inbound-peers` int | The client's max number of inbound peers allowed. | 32 | NO | Command: server Flag:--max-inbound-peers β€œ50” | NO | -| `--max-outbound-peers` int | The client's max number of outbound peers allowed. | 8 | NO | Command: server Flag: --max-outbound-peers β€œ20” | NO | -| `--price-limit` uint | The minimum gas price limit to enforce for acceptance into the pool. | 0 | NO | Command: server Flag: --price-limit β€œ1” | YES, this parameter can be changed by stopping the node and then starting it again with the server command and specifying --price-limit flag providing the new value e.g. --price-limit β€œ5” | -| `--max-slots` uint | Maximum slots in the transaction pool. When the maximum capacity is reached, transaction is not stored in the pool. One transaction occupies txSize/32kB number of slots. If e.g. --max-slots is 5, and there are tx1 which has 2kB and tx2 which has 33kB, that means that 3 slots are occupied and there are 2 free slots left. This parameter refers to the enqueued and promoted transactions in the pool. | 4096 | NO | Command: server Flag: --max-slots β€œ100000” | NO | -| `--max-enqueued` uint | Maximum number of enqueued transactions in the pool per account. | 128 | NO | Command: server Flag: --max-enqueued β€œ200” | NO | -| `--access-control-allow-origins` stringArray | The CORS(cross origin resource sharing) header indicating whether any JSON-RPC response can be shared with the specified origin. | []string{"*"} | NO | Command: server Flag: --access-control-allow-origins β€œhttps://foo.example” | NO | -| `--json-rpc-batch-request-limit` uint | Max length to be considered when handling json-rpc batch requests, value of 0 disables it. | 20 | NO | Command: server Flag: --json-rpc-batch-request-limit | NO | -| `--json-rpc-block-range-limit` uint | Max block range to be considered when executing json-rpc requests that consider fromBlock/toBlock values (e.g. eth_getLogs), value of 0 disables it. | 1000 | NO | Command: server Flag: --json-rpc-block-range-limit β€œ2000” | NO | -| `--log-to` string | Write all logs to the file at specified location instead of writing them to console. | β€œβ€ | NO | Command: server Flag: --log-to β€œedge-log.log” | NO | -| `--relayer` | Start the state sync relayer service. | FALSE | NO | Command: server Flag: --relayer | NO | -| `--num-block-confirmations` uint | Minimal number of child blocks required for the parent block to be considered final. This parameter is used by the event Tracker when reading logs from the parent chain. | 64 | NO | Command: server Flag: --num-block-confirmations β€œ2” | NO | -| `--concurrent-requests-debug` uint | Maximal number of concurrent requests for debug endpoints. | 32 | NO | `server --concurrent-requests-debug "50"` | NO | -| `--websocket-read-limit` uint | Maximum size in bytes for a message read from the peer by websocket. | 8192 | NO | `server --websocket-read-limit "16384"` | NO | -| `--relayer-poll-interval` duration | Interval (number of seconds) at which relayer's tracker polls for latest block at childchain. | 1s | NO | `server --relayer-poll-interval "2s"` | NO | -| `--metrics-interval` duration | The interval (in seconds) at which special metrics are generated. A value of zero means the metrics are disabled. | 8s | NO | `server --metrics-interval "10s"` | NO | - -:::info Mutually Exclusive Paramaters - -- `--max-inbound-peers`: The client's maximum number of inbound peers allowed. Default value is 32. -- `--max-outbound-peers`: The client's maximum number of outbound peers allowed. Default value is 8. - -::: - - - diff --git a/docs/docs/operate/system.md b/docs/docs/operate/system.md deleted file mode 100644 index 045b9dc..0000000 --- a/docs/docs/operate/system.md +++ /dev/null @@ -1,38 +0,0 @@ -## Minimum Hardware Configuration - -!!! tip "Hardware environment tips" - - While we do not favor any operating system, more secure and stable Linux server distributions (like CentOS) should be preferred over desktop operating systems (like Mac OS and Windows). - - The minimum storage requirements will change over time as the network grows. It is recommended to use more than the minimum requirements to run a robust full node. - -This is the minimum hardware configuration required to set up a Edge-powered chain: - -| Component | Minimum Requirement | Recommended | -| --------- | ------------------- | ----------- | -| Processor | 4-core CPU | 8-core CPU | -| Memory | 8 GB RAM | 16 GB RAM | -| Storage | 200 GB SSD | 1 TB SSD | -| Network | High-speed internet connection | Dedicated server with gigabit connection | - -> Note that these minimum requirements are based on the x2iezn.2xlarge instance type used in the [performance tests](benchmarks.md), which demonstrated satisfactory performance. However, for better performance and higher transaction throughput, consider using more powerful hardware configurations, such as those equivalent to x2iezn.4xlarge or x2iezn.8xlarge instance types. - -## Prerequisites - -Before starting any of the tutorials, you should understand the basics of blockchain technology and be familiar with command-line interfaces. It would help if you also had the `xgrchain` binary installed on your machine. Check out the [installation guide](install.md) for more information if you haven't already. - -Ensure you have the following system prerequisites: - -| Prerequisite | Description | -| --- | --- | -| Golang (v1.15-1.19) | Install Go using CLI or package manager like [Snapcraft](https://snapcraft.io/go) for Linux, [Homebrew](https://formulae.brew.sh/formula/go) for Mac, or [Chocolatey](https://community.chocolatey.org/packages/golang) for Windows. Compatibility for other versions coming soon. | -| Docker | Required to run the geth instance. Follow [official Docker documentation](https://www.docker.com/) for installation instructions. | -| Internet connection | Stable internet connection required. | -| Network security | Ensure that network ports used by XGRChain are not blocked by firewalls or other security measures. | -| Operating system | Ensure that the latest security patches and updates are installed. | - -!!! caution "Solidity v0.8.19 or earlier recommended" - - [Solidity v0.8.20](https://blog.soliditylang.org/2023/05/10/solidity-0.8.20-release-announcement/) introduces new features, including the implementation of `PUSH0` opcode, which is not yet supported in Edge. If you decide to use v0.8.20, ensure that you set your EVM version to "Paris" in the framework you use to deploy your contracts. - - For now, we recommend using Solidity v0.8.19 or earlier. diff --git a/docs/docs/quickstart.md b/docs/docs/quickstart.md deleted file mode 100644 index 735078d..0000000 --- a/docs/docs/quickstart.md +++ /dev/null @@ -1,347 +0,0 @@ -Before proceeding, ensure that your system meets the necessary [system requirements](operate/system.md). - -To access the pre-built releases, visit the [GitHub releases page](https://github.com/xgr-network/xgr-node/releases). The client provides cross-compiled AMD64/ARM64 binaries for Darwin and Linux. - -To locally run the Edge test environment, run the following command from the project's root: - - ```bash - ./scripts/cluster polybft - ``` - -**That's it! You should have successfully been able to start a local Edge-powered chain just by running the script.** - -> - Stop the network: "CTRL/Command C" or `./scripts/cluster polybft stop`. -> - Destroy the network: `./scripts/cluster polybft destroy`. - - -## Deployment script details - -The script is available under the "scripts" directory of the client. -These are the optional configuration parameters you can pass to the script: - -### Flags - -| Flag | Description | Default Value | -|------|-------------|---------------| -| --block-gas-limit | Maximum gas allowed for a block. | 10000000 | -| --premine | Address and amount of tokens to premine in the genesis block. | 0x85da99c8a7c2c95964c8efd687e95e632fc533d6:1000000000000000000000 | -| --epoch-size | Number of blocks per epoch. | 10 | -| --data-dir | Directory to store chain data. | test-chain- | -| --num | Number of nodes in the network. | 4 | -| --bootnode | Bootstrap node address in multiaddress format. | /ip4/127.0.0.1/tcp/30301/p2p/... | -| --insecure | Disable TLS. | | -| --log-level | Logging level for validators. | INFO | -| --seal | Enable block sealing. | | -| --help | Print usage information. | | - -After running the command, the test network will be initialized with PolyBFT consensus engine and the genesis file will be created. Then, the four validators will start running, and their log outputs will be displayed in the terminal. - -By default, this will start an Edge network with PolyBFT consensus engine, four validators, and premine of 1 billion tokens at address `0x85da99c8a7c2c95964c8efd687e95e632fc533d6`. - -The nodes will continue to run until stopped manually. To stop the network, open a new session and use the following command, or, simply press "CTRL/Command C" in the CLI: - - ```bash - ./scripts/cluster polybft stop - ``` - -If you want to destroy the environment, use the following command: - - ```bash - ./scripts/cluster polybft destroy - ``` - -### Explanation of the deployment script - -The deployment script is a wrapper script for starting an Edge test network with PolyBFT consensus engine. -It offers the following functionality: - -- Initialize the network with either IBFT or PolyBFT consensus engine. -- Create the genesis file for the test network. -- Start the validators on four separate ports. -- Write the logs to separate log files for each validator. -- Stop and destroy the environment when no longer needed. -- The script also allows you to choose between running the environment from a local binary or a Docker container. - -## Deployment script - -
-Click to open - -```sh -#!/usr/bin/env bash - -dp_error_flag=0 - -# Check if jq is installed -if [[ "$1" == "polybft" ]] && ! command -v jq >/dev/null 2>&1; then - echo "jq is not installed." - echo "Manual installation instructions: Visit https://jqlang.github.io/jq/ for more information." - dp_error_flag=1 -fi - -# Check if curl is installed -if [[ "$1" == "polybft" ]] && ! command -v curl >/dev/null 2>&1; then - echo "curl is not installed." - echo "Manual installation instructions: Visit https://everything.curl.dev/get/ for more information." - dp_error_flag=1 -fi - -# Check if docker-compose is installed -if [[ "$2" == "--docker" ]] && ! command -v docker-compose >/dev/null 2>&1; then - echo "docker-compose is not installed." - echo "Manual installation instructions: Visit https://docs.docker.com/compose/install/ for more information." - dp_error_flag=1 -fi - -# Stop script if any of the dependencies have failed -if [[ "$dp_error_flag" -eq 1 ]]; then - echo "Missing dependencies. Please install them and run the script again." - exit 1 -fi - -function showhelp(){ - echo "Usage: cluster {consensus} [{command}] [{flags}]" - echo "Consensus:" - echo " ibft Start Supernets test environment locally with ibft consensus" - echo " polybft Start Supernets test environment locally with polybft consensus" - echo "Commands:" - echo " stop Stop the running environment" - echo " destroy Destroy the running environment" - echo " write-logs Writes STDOUT and STDERR output to log file. Not applicable when using --docker flag." - echo "Flags:" - echo " --docker Run using Docker (requires docker-compose)." - echo " --help Display this help information" - echo "Examples:" - echo " cluster polybft -- Run the script with the polybft consensus" - echo " cluster polybft --docker -- Run the script with the polybft consensus using docker" - echo " cluster polybft stop -- Stop the running environment" -} - -function initIbftConsensus() { - echo "Running with ibft consensus" - ./xgrchain secrets init --insecure --data-dir test-chain- --num 4 - - node1_id=$(./xgrchain secrets output --data-dir test-chain-1 | grep Node | head -n 1 | awk -F ' ' '{print $4}') - node2_id=$(./xgrchain secrets output --data-dir test-chain-2 | grep Node | head -n 1 | awk -F ' ' '{print $4}') - - genesis_params="--consensus ibft --ibft-validators-prefix-path test-chain- \ - --bootnode /ip4/127.0.0.1/tcp/30301/p2p/$node1_id \ - --bootnode /ip4/127.0.0.1/tcp/30302/p2p/$node2_id" -} - -function initPolybftConsensus() { - echo "Running with polybft consensus" - genesis_params="--consensus polybft" - - address1=$(./xgrchain polybft-secrets --insecure --data-dir test-chain-1 | grep Public | head -n 1 | awk -F ' ' '{print $5}') - address2=$(./xgrchain polybft-secrets --insecure --data-dir test-chain-2 | grep Public | head -n 1 | awk -F ' ' '{print $5}') - address3=$(./xgrchain polybft-secrets --insecure --data-dir test-chain-3 | grep Public | head -n 1 | awk -F ' ' '{print $5}') - address4=$(./xgrchain polybft-secrets --insecure --data-dir test-chain-4 | grep Public | head -n 1 | awk -F ' ' '{print $5}') -} - -function createGenesis() { - ./xgrchain genesis $genesis_params \ - --block-gas-limit 10000000 \ - --premine 0x85da99c8a7c2c95964c8efd687e95e632fc533d6:1000000000000000000000 \ - --premine 0x0000000000000000000000000000000000000000 \ - --epoch-size 10 \ - --reward-wallet 0xDEADBEEF:1000000 \ - --native-token-config "XGR:XGR:18:true:$address1" \ - --burn-contract 0:0x0000000000000000000000000000000000000000 \ - --proxy-contracts-admin 0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed -} - -function initRootchain() { - echo "Initializing rootchain" - - if [ "$1" == "write-logs" ]; then - echo "Writing rootchain server logs to the file..." - ./xgrchain rootchain server 2>&1 | tee ./rootchain-server.log & - else - ./xgrchain rootchain server >/dev/null & - fi - - set +e - while true; do - if curl -sSf -o /dev/null http://127.0.0.1:8545; then - break - fi - sleep 1 - done - set -e - - proxyContractsAdmin=0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed - - ./xgrchain polybft stake-manager-deploy \ - --jsonrpc http://127.0.0.1:8545 \ - --proxy-contracts-admin ${proxyContractsAdmin} \ - --test - - stakeManagerAddr=$(cat genesis.json | jq -r '.params.engine.polybft.bridge.stakeManagerAddr') - stakeToken=$(cat genesis.json | jq -r '.params.engine.polybft.bridge.stakeTokenAddr') - - ./xgrchain rootchain deploy \ - --stake-manager ${stakeManagerAddr} \ - --stake-token ${stakeToken} \ - --proxy-contracts-admin ${proxyContractsAdmin} \ - --test - - customSupernetManagerAddr=$(cat genesis.json | jq -r '.params.engine.polybft.bridge.customSupernetManagerAddr') - supernetID=$(cat genesis.json | jq -r '.params.engine.polybft.supernetID') - - ./xgrchain rootchain fund \ - --stake-token ${stakeToken} \ - --mint \ - --addresses ${address1},${address2},${address3},${address4} \ - --amounts 1000000000000000000000000,1000000000000000000000000,1000000000000000000000000,1000000000000000000000000 - - ./xgrchain polybft whitelist-validators \ - --addresses ${address1},${address2},${address3},${address4} \ - --supernet-manager ${customSupernetManagerAddr} \ - --private-key aa75e9a7d427efc732f8e4f1a5b7646adcc61fd5bae40f80d13c8419c9f43d6d \ - --jsonrpc http://127.0.0.1:8545 - - counter=1 - while [ $counter -le 4 ]; do - echo "Registering validator: ${counter}" - - ./xgrchain polybft register-validator \ - --supernet-manager ${customSupernetManagerAddr} \ - --data-dir test-chain-${counter} \ - --jsonrpc http://127.0.0.1:8545 - - ./xgrchain polybft stake \ - --data-dir test-chain-${counter} \ - --amount 1000000000000000000000000 \ - --supernet-id ${supernetID} \ - --stake-manager ${stakeManagerAddr} \ - --stake-token ${stakeToken} \ - --jsonrpc http://127.0.0.1:8545 - - ((counter++)) - done - - ./xgrchain polybft supernet \ - --private-key aa75e9a7d427efc732f8e4f1a5b7646adcc61fd5bae40f80d13c8419c9f43d6d \ - --supernet-manager ${customSupernetManagerAddr} \ - --stake-manager ${stakeManagerAddr} \ - --finalize-genesis-set \ - --enable-staking \ - --jsonrpc http://127.0.0.1:8545 -} - -function startServerFromBinary() { - if [ "$1" == "write-logs" ]; then - echo "Writing validators logs to the files..." - ./xgrchain server --data-dir ./test-chain-1 --chain genesis.json \ - --grpc-address :10000 --libp2p :30301 --jsonrpc :10002 --relayer \ - --num-block-confirmations 2 --seal --log-level DEBUG 2>&1 | tee ./validator-1.log & - ./xgrchain server --data-dir ./test-chain-2 --chain genesis.json \ - --grpc-address :20000 --libp2p :30302 --jsonrpc :20002 \ - --num-block-confirmations 2 --seal --log-level DEBUG 2>&1 | tee ./validator-2.log & - ./xgrchain server --data-dir ./test-chain-3 --chain genesis.json \ - --grpc-address :30000 --libp2p :30303 --jsonrpc :30002 \ - --num-block-confirmations 2 --seal --log-level DEBUG 2>&1 | tee ./validator-3.log & - ./xgrchain server --data-dir ./test-chain-4 --chain genesis.json \ - --grpc-address :40000 --libp2p :30304 --jsonrpc :40002 \ - --num-block-confirmations 2 --seal --log-level DEBUG 2>&1 | tee ./validator-4.log & - wait - else - ./xgrchain server --data-dir ./test-chain-1 --chain genesis.json \ - --grpc-address :10000 --libp2p :30301 --jsonrpc :10002 --relayer \ - --num-block-confirmations 2 --seal --log-level DEBUG & - ./xgrchain server --data-dir ./test-chain-2 --chain genesis.json \ - --grpc-address :20000 --libp2p :30302 --jsonrpc :20002 \ - --num-block-confirmations 2 --seal --log-level DEBUG & - ./xgrchain server --data-dir ./test-chain-3 --chain genesis.json \ - --grpc-address :30000 --libp2p :30303 --jsonrpc :30002 \ - --num-block-confirmations 2 --seal --log-level DEBUG & - ./xgrchain server --data-dir ./test-chain-4 --chain genesis.json \ - --grpc-address :40000 --libp2p :30304 --jsonrpc :40002 \ - --num-block-confirmations 2 --seal --log-level DEBUG & - wait - fi -} - -function startServerFromDockerCompose() { - if [ "$1" != "polybft" ]; then - export EDGE_CONSENSUS="$1" - fi - - docker-compose -f ./docker/local/docker-compose.yml up -d --build -} - -function destroyDockerEnvironment() { - docker-compose -f ./docker/local/docker-compose.yml down -v -} - -function stopDockerEnvironment() { - docker-compose -f ./docker/local/docker-compose.yml stop -} - -set -e - -# Show help if help flag is entered or no arguments are provided -if [[ "$1" == "--help" ]] || [[ $# -eq 0 ]]; then - showhelp - exit 0 -fi - -# Reset test-dirs -rm -rf test-chain-* -rm -f genesis.json - -# Build binary -go build -o xgrchain . - -# If --docker flag is set run docker environment otherwise run from binary -case "$2" in -"--docker") - # cluster {consensus} --docker destroy - if [ "$3" == "destroy" ]; then - destroyDockerEnvironment - echo "Docker $1 environment destroyed!" - exit 0 - # cluster {consensus} --docker stop - elif [ "$3" == "stop" ]; then - stopDockerEnvironment - echo "Docker $1 environment stopped!" - exit 0 - fi - - # cluster {consensus} --docker - echo "Running $1 docker environment..." - startServerFromDockerCompose $1 - echo "Docker $1 environment deployed." - exit 0 - ;; -# cluster {consensus} -*) - echo "Running $1 environment from local binary..." - # Initialize ibft or polybft consensus - if [ "$1" == "ibft" ]; then - # Initialize ibft consensus - initIbftConsensus - # Create genesis file and start the server from binary - createGenesis - startServerFromBinary $2 - exit 0 - elif [ "$1" == "polybft" ]; then - # Initialize polybft consensus - initPolybftConsensus - # Create genesis file and start the server from binary - createGenesis - initRootchain $2 - startServerFromBinary $2 - exit 0 - else - echo "Unsupported consensus mode. Supported modes are: ibft and polybft." - showhelp - exit 1 - fi - ;; -esac -``` - -
-
diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml deleted file mode 100644 index e6d788f..0000000 --- a/docs/mkdocs.yml +++ /dev/null @@ -1,119 +0,0 @@ -site_name: XGRChain docs - -theme: - name: material - palette: - scheme: slate - -nav: - - What is Edge: index.md - - Quickstart: quickstart.md - - System design: - - Overview: design/overview.md - - Consensus: - - Consensus protocol: design/consensus/polybft/protocol.md - - Polygon Byzantine Fault Tolerance (PolyBFT): design/consensus/polybft/overview.md - - Istanbul Byzantine Fault Tolerance (IBFT) 2.0: design/consensus/polybft/ibft.md - - Bridge: - - Overview: design/bridge/overview.md - - StateSyncs: design/bridge/statesync.md - - Checkpoints: design/bridge/checkpoint.md - - Assets: - - ERC-20: design/bridge/assets/erc/erc20.md - - ERC-721: design/bridge/assets/erc/erc721.md - - ERC-1155: design/bridge/assets/erc/erc1155.md - - Sequences: design/bridge/sequences.md - - Networking: design/libp2p.md - - Runtime: - - Overview: design/runtime/overview.md - - Access control list: design/runtime/allowlist.md - - Blockchain: design/blockchain.md - - MemoryPool: design/mempool.md - - Transaction pool: design/txpool.md - - Transaction relayer: design/txrelayer.md - - JSON-RPC: design/jsonrpc.md - - GRPC: design/grpc.md - - Build an Edge-powered chain: - - Prepare your environment: - - System requirements: operate/system.md - - Install binaries: operate/install.md - - Deploy a chain: - - Get started: operate/deploy/index.md - - How to spawn a new child chain: operate/deploy/local-chain.md - - How to configure a new child chain: operate/deploy/genesis.md - - How to configure the rootchain: operate/deploy/rootchain-config.md - - How to configure the initial validator set: operate/deploy/genesis-validators.md - - How to start your chain: operate/deploy/start-chain.md - - Operate your chain: - - Access control: - - How to add and remove accounts: operate/deploy/access-control/allowlist-general.md - - Staking: - - How to stake: operate/deploy/staking/stake.md - - How to unstake: operate/deploy/staking/unstake.md - - Transfers: - - How to deposit (rootchain->childchain): operate/deploy/transfers/deposit.md - - How to withdrw (childchain->rootchain): operate/deploy/transfers/withdraw.md - - Upgrade your chain: - - Upgrade using hardfork: operate/deploy/upgrades/hardfork.md - - Edge v1.1 upgrade requirements: operate/deploy/upgrades/v1.1.md - - Reference: - #- Contracts: - # - Checkpoint manager: contracts/checkpoint-manager.md - # - Exit helper: contracts/exit-helper.md - # - Reward pool: contracts/reward-pool.md - # - State receiver: contracts/state-receiver.md - # - State sender: contracts/state-sender.md - # - Validator set: contracts/validator-set.md - # - Withdrawal queue: contracts/withdrawal-queue.md - - Config parameter reference: operate/param-reference.md - - Smart contract interfaces: - - ERC20: - - NativeERC20: interfaces/erc20/native-erc20.md - - ChildERC20Predicate: interfaces/erc20/childerc20-predicate.md - - ChildERC20: interfaces/erc20/childerc20.md - - RootERC20Predicate: interfaces/erc20/rooterc20-predicate.md - - ERC721: - - ChildERC721: interfaces/erc721/childerc721.md - - ChildERC721Predicate: interfaces/erc721/childerc721-predicate.md - - RootERC721Predicate: interfaces/erc721/rooterc721-predicate.md - - ERC1155: - - ChildERC1155: interfaces/erc1155/childerc1155.md - - ChildERC1155Predicate: interfaces/erc1155/childerc1155-predicate.md - - RootERC1155Predicate: interfaces/erc1155/rooterc1155-predicate.md - - EIP1559Burn: interfaces/eip1559.md - - Network: - - CheckpointManager: interfaces/network/checkpoint-manager.md - - ExitHelper: interfaces/network/exit-helper.md - - StateReceiver: interfaces/network/state-receiver.md - - StateSender: interfaces/network/state-sender.md - - Validators: - - ValidatorSetBase: interfaces/validators/validator-set-base.md - - Staking: - - StakeManager: interfaces/staking/stake-manager.md - - SupernetManager: interfaces/staking/supernet-manager.md - - CustomSupernetManager: interfaces/staking/custom-supernet-manager.md - - Cryptography: - - BLS: interfaces/cryptography/bls.md - - BN256G2: interfaces/cryptography/bn256g2.md - - RPC APIs: - - Ethereum: api/json-rpc-eth.md - - Net: api/json-rpc-net.md - - Web3: api/json-rpc-web3.md - - TxPool: api/json-rpc-txpool.md - - Debug: api/json-rpc-debug.md - - Bridge: api/json-rpc-bridge.md - - Performance benchmarks: operate/benchmarks.md - - Disclaimer: disclaimer.md - - - - -markdown_extensions: - - admonition - - pymdownx.details - - pymdownx.superfences - - pymdownx.tabbed - - -validation: - absolute_links: warn \ No newline at end of file diff --git a/docs/requirements.txt b/docs/requirements.txt deleted file mode 100644 index 8610e1c..0000000 --- a/docs/requirements.txt +++ /dev/null @@ -1,4 +0,0 @@ -mkdocs-material==9.4.8 -markdown-include==0.8.1 -mkdocs-git-revision-date-localized-plugin==1.2.1 -mkdocs-open-in-new-tab==1.0.3 diff --git a/docs/run.sh b/docs/run.sh deleted file mode 100644 index 2d247d0..0000000 --- a/docs/run.sh +++ /dev/null @@ -1,8 +0,0 @@ -#!/usr/bin/env bash -set -euo pipefail - -virtualenv venv -source venv/bin/activate -pip3 install -r requirements.txt -mkdocs serve --strict - diff --git a/e2e-polybft/e2e/README.md b/e2e-polybft/e2e/README.md deleted file mode 100644 index c54bb35..0000000 --- a/e2e-polybft/e2e/README.md +++ /dev/null @@ -1,22 +0,0 @@ - -# End-to-End testing - -The implemented E2E tests start a local instance of Polybft consensus protocol. - -As such, they require the binary 'xgrchain' to be available in the $PATH variable. - -## Step 1: Build the xgrchain - -```bash -go build -race -o artifacts/xgrchain . && mv artifacts/xgrchain $GOPATH/bin -``` - -In this case we expect that $GOPATH is set and $GOPATH/bin is defined in $PATH as it is required for a complete Go installation. - -## Step 2: Run the tests - -```bash -export E2E_TESTS=TRUE && go test -v ./e2e-polybft/e2e/... -``` - -To enable logs in the e2e test set `E2E_LOGS=true`. diff --git a/e2e-polybft/e2e/acls_test.go b/e2e-polybft/e2e/acls_test.go deleted file mode 100644 index 92656f8..0000000 --- a/e2e-polybft/e2e/acls_test.go +++ /dev/null @@ -1,415 +0,0 @@ -package e2e - -import ( - "fmt" - "math/big" - "testing" - - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo/wallet" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - "github.com/xgr-network/xgr-node/helper/hex" - "github.com/xgr-network/xgr-node/state/runtime/addresslist" - "github.com/xgr-network/xgr-node/types" -) - -// Contract used as bytecode - -/* -pragma solidity ^0.8; -pragma experimental ABIEncoderV2; - -contract Sample { - address public constant allowListContractsAddr = 0x0200000000000000000000000000000000000000; - - function readAddressList(address addr) public returns (uint256) { - (bool success, bytes memory returnData) = allowListContractsAddr.call(abi.encodeWithSignature("readAddressList(address)", addr)); - (uint256 val) = abi.decode(returnData, (uint256)); - return val; - } -} -*/ - -func TestE2E_AllowList_ContractDeployment(t *testing.T) { - // create two accounts, one for an admin sender and a second - // one for a non-enabled account that will switch on-off between - // both enabled and non-enabled roles. - admin, _ := wallet.GenerateKey() - target, _ := wallet.GenerateKey() - - adminAddr := types.Address(admin.Address()) - targetAddr := types.Address(target.Address()) - - otherAddr := types.Address{0x1} - - cluster := framework.NewTestCluster(t, 5, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, adminAddr)), - framework.WithPremine(adminAddr, targetAddr), - framework.WithContractDeployerAllowListAdmin(adminAddr), - framework.WithContractDeployerAllowListEnabled(otherAddr), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - // bytecode for an empty smart contract - bytecode, err := hex.DecodeString("608060405234801561001057600080fd5b506103db806100206000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80635e9f13f81461003b578063d78bca6914610059575b600080fd5b610043610089565b6040516100509190610217565b60405180910390f35b610073600480360381019061006e9190610263565b6100a1565b60405161008091906102a9565b60405180910390f35b73020000000000000000000000000000000000000081565b600080600073020000000000000000000000000000000000000073ffffffffffffffffffffffffffffffffffffffff16846040516024016100e29190610217565b6040516020818303038152906040527fd78bca69000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19166020820180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff838183161783525050505060405161016c9190610335565b6000604051808303816000865af19150503d80600081146101a9576040519150601f19603f3d011682016040523d82523d6000602084013e6101ae565b606091505b50915091506000818060200190518101906101c99190610378565b9050809350505050919050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000610201826101d6565b9050919050565b610211816101f6565b82525050565b600060208201905061022c6000830184610208565b92915050565b600080fd5b610240816101f6565b811461024b57600080fd5b50565b60008135905061025d81610237565b92915050565b60006020828403121561027957610278610232565b5b60006102878482850161024e565b91505092915050565b6000819050919050565b6102a381610290565b82525050565b60006020820190506102be600083018461029a565b92915050565b600081519050919050565b600081905092915050565b60005b838110156102f85780820151818401526020810190506102dd565b60008484015250505050565b600061030f826102c4565b61031981856102cf565b93506103298185602086016102da565b80840191505092915050565b60006103418284610304565b915081905092915050565b61035581610290565b811461036057600080fd5b50565b6000815190506103728161034c565b92915050565b60006020828403121561038e5761038d610232565b5b600061039c84828501610363565b9150509291505056fea264697066735822122035f391b5c3dbf9a5e31072167a4ada71e9ba762650849f6320bc6150fa45aa9564736f6c63430008110033") - require.NoError(t, err) - - { - // Step 0. Check the role of both accounts - expectRole(t, cluster, contracts.AllowListContractsAddr, adminAddr, addresslist.AdminRole) - expectRole(t, cluster, contracts.AllowListContractsAddr, targetAddr, addresslist.NoRole) - expectRole(t, cluster, contracts.AllowListContractsAddr, otherAddr, addresslist.EnabledRole) - } - - { - // Step 1. 'targetAddr' can send a normal transaction (non-contract creation). - err := cluster.Transfer(t, target, types.ZeroAddress, big.NewInt(1)).Wait() - require.NoError(t, err) - } - - var proxyContract types.Address - - { - // Step 2. 'targetAddr' **cannot** deploy a contract because it is not whitelisted. - // (The transaction does not fail but the contract is not deployed and all gas - // for the transaction is consumed) - deployTxn := cluster.Deploy(t, target, bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Reverted()) - require.False(t, cluster.ExistsCode(t, deployTxn.Receipt().ContractAddress)) - } - - { - // Step 3. 'adminAddr' can create contracts - deployTxn := cluster.Deploy(t, admin, bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Succeed()) - require.True(t, cluster.ExistsCode(t, deployTxn.Receipt().ContractAddress)) - - proxyContract = types.Address(deployTxn.Receipt().ContractAddress) - } - - { - // Step 4. 'adminAddr' sends a transaction to enable 'targetAddr'. - input, _ := addresslist.SetEnabledFunc.Encode([]interface{}{targetAddr}) - - adminSetTxn := cluster.MethodTxn(t, admin, contracts.AllowListContractsAddr, input) - require.NoError(t, adminSetTxn.Wait()) - expectRole(t, cluster, contracts.AllowListContractsAddr, targetAddr, addresslist.EnabledRole) - } - - { - // Step 5. 'targetAddr' can create contracts now. - deployTxn := cluster.Deploy(t, target, bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Succeed()) - require.True(t, cluster.ExistsCode(t, deployTxn.Receipt().ContractAddress)) - } - - { - // Step 6. 'targetAddr' cannot enable other accounts since it is not an admin - // (The transaction fails) - input, _ := addresslist.SetEnabledFunc.Encode([]interface{}{types.ZeroAddress}) - - adminSetFailTxn := cluster.MethodTxn(t, target, contracts.AllowListContractsAddr, input) - require.NoError(t, adminSetFailTxn.Wait()) - require.True(t, adminSetFailTxn.Failed()) - expectRole(t, cluster, contracts.AllowListContractsAddr, types.ZeroAddress, addresslist.NoRole) - } - - { - // Step 7. Call a proxy contract that can call the allow list - resp := cluster.Call(t, proxyContract, addresslist.ReadAddressListFunc, adminAddr) - - role, ok := resp["0"].(*big.Int) - require.True(t, ok) - require.Equal(t, role.Uint64(), addresslist.AdminRole.Uint64()) - } -} - -func TestE2E_BlockList_ContractDeployment(t *testing.T) { - // create two accounts, one for an admin sender and a second - // one for a non-enabled account that will switch on-off between - // both enabled and non-enabled roles. - admin, _ := wallet.GenerateKey() - target, _ := wallet.GenerateKey() - - adminAddr := types.Address(admin.Address()) - targetAddr := types.Address(target.Address()) - - otherAddr := types.Address{0x1} - - cluster := framework.NewTestCluster(t, 5, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, adminAddr)), - framework.WithPremine(adminAddr, targetAddr), - framework.WithContractDeployerBlockListAdmin(adminAddr), - framework.WithContractDeployerBlockListEnabled(otherAddr), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - // bytecode for an empty smart contract - bytecode, err := hex.DecodeString("608060405234801561001057600080fd5b506103db806100206000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80635e9f13f81461003b578063d78bca6914610059575b600080fd5b610043610089565b6040516100509190610217565b60405180910390f35b610073600480360381019061006e9190610263565b6100a1565b60405161008091906102a9565b60405180910390f35b73020000000000000000000000000000000000000081565b600080600073020000000000000000000000000000000000000073ffffffffffffffffffffffffffffffffffffffff16846040516024016100e29190610217565b6040516020818303038152906040527fd78bca69000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19166020820180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff838183161783525050505060405161016c9190610335565b6000604051808303816000865af19150503d80600081146101a9576040519150601f19603f3d011682016040523d82523d6000602084013e6101ae565b606091505b50915091506000818060200190518101906101c99190610378565b9050809350505050919050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000610201826101d6565b9050919050565b610211816101f6565b82525050565b600060208201905061022c6000830184610208565b92915050565b600080fd5b610240816101f6565b811461024b57600080fd5b50565b60008135905061025d81610237565b92915050565b60006020828403121561027957610278610232565b5b60006102878482850161024e565b91505092915050565b6000819050919050565b6102a381610290565b82525050565b60006020820190506102be600083018461029a565b92915050565b600081519050919050565b600081905092915050565b60005b838110156102f85780820151818401526020810190506102dd565b60008484015250505050565b600061030f826102c4565b61031981856102cf565b93506103298185602086016102da565b80840191505092915050565b60006103418284610304565b915081905092915050565b61035581610290565b811461036057600080fd5b50565b6000815190506103728161034c565b92915050565b60006020828403121561038e5761038d610232565b5b600061039c84828501610363565b9150509291505056fea264697066735822122035f391b5c3dbf9a5e31072167a4ada71e9ba762650849f6320bc6150fa45aa9564736f6c63430008110033") - require.NoError(t, err) - - { - // Step 0. Check the role of accounts - expectRole(t, cluster, contracts.BlockListContractsAddr, adminAddr, addresslist.AdminRole) - expectRole(t, cluster, contracts.BlockListContractsAddr, targetAddr, addresslist.NoRole) - expectRole(t, cluster, contracts.BlockListContractsAddr, otherAddr, addresslist.EnabledRole) - } - - { - // Step 1. 'targetAddr' can send a normal transaction (non-contract creation). - err := cluster.Transfer(t, target, types.ZeroAddress, big.NewInt(1)).Wait() - require.NoError(t, err) - } - - { - // Step 2. 'targetAddr' **can** deploy a contract because it is not blacklisted. - deployTxn := cluster.Deploy(t, target, bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Succeed()) - require.True(t, cluster.ExistsCode(t, deployTxn.Receipt().ContractAddress)) - } - - { - // Step 3. 'adminAddr' can create contracts - deployTxn := cluster.Deploy(t, admin, bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Succeed()) - require.True(t, cluster.ExistsCode(t, deployTxn.Receipt().ContractAddress)) - } - - { - // Step 4. 'adminAddr' sends a transaction to enable 'targetAddr'. - input, _ := addresslist.SetEnabledFunc.Encode([]interface{}{targetAddr}) - - adminSetTxn := cluster.MethodTxn(t, admin, contracts.BlockListContractsAddr, input) - require.NoError(t, adminSetTxn.Wait()) - expectRole(t, cluster, contracts.BlockListContractsAddr, targetAddr, addresslist.EnabledRole) - } - - { - // Step 5. 'targetAddr' **cannot** create contracts now as it's now blacklisted. - deployTxn := cluster.Deploy(t, target, bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Reverted()) - require.False(t, cluster.ExistsCode(t, deployTxn.Receipt().ContractAddress)) - } - - { - // Step 6. 'targetAddr' cannot enable other accounts since it is not an admin - // (The transaction fails) - input, _ := addresslist.SetEnabledFunc.Encode([]interface{}{types.ZeroAddress}) - - adminSetFailTxn := cluster.MethodTxn(t, target, contracts.BlockListContractsAddr, input) - require.NoError(t, adminSetFailTxn.Wait()) - require.True(t, adminSetFailTxn.Failed()) - expectRole(t, cluster, contracts.BlockListContractsAddr, types.ZeroAddress, addresslist.NoRole) - } -} - -func TestE2E_AllowList_Transactions(t *testing.T) { - // create two accounts, one for an admin sender and a second - // one for a non-enabled account that will switch on-off between - // both enabled and non-enabled roles. - admin, _ := wallet.GenerateKey() - target, _ := wallet.GenerateKey() - other, _ := wallet.GenerateKey() - - adminAddr := types.Address(admin.Address()) - targetAddr := types.Address(target.Address()) - otherAddr := types.Address(other.Address()) - - cluster := framework.NewTestCluster(t, 5, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, adminAddr)), - framework.WithPremine(adminAddr, targetAddr, otherAddr), - framework.WithTransactionsAllowListAdmin(adminAddr), - framework.WithTransactionsAllowListEnabled(otherAddr), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - // bytecode for an empty smart contract - bytecode, _ := hex.DecodeString("608060405234801561001057600080fd5b506103db806100206000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80635e9f13f81461003b578063d78bca6914610059575b600080fd5b610043610089565b6040516100509190610217565b60405180910390f35b610073600480360381019061006e9190610263565b6100a1565b60405161008091906102a9565b60405180910390f35b73020000000000000000000000000000000000000081565b600080600073020000000000000000000000000000000000000073ffffffffffffffffffffffffffffffffffffffff16846040516024016100e29190610217565b6040516020818303038152906040527fd78bca69000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19166020820180517bffffffffffffffffffffffffffffffffffffffffffffffffffffffff838183161783525050505060405161016c9190610335565b6000604051808303816000865af19150503d80600081146101a9576040519150601f19603f3d011682016040523d82523d6000602084013e6101ae565b606091505b50915091506000818060200190518101906101c99190610378565b9050809350505050919050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000610201826101d6565b9050919050565b610211816101f6565b82525050565b600060208201905061022c6000830184610208565b92915050565b600080fd5b610240816101f6565b811461024b57600080fd5b50565b60008135905061025d81610237565b92915050565b60006020828403121561027957610278610232565b5b60006102878482850161024e565b91505092915050565b6000819050919050565b6102a381610290565b82525050565b60006020820190506102be600083018461029a565b92915050565b600081519050919050565b600081905092915050565b60005b838110156102f85780820151818401526020810190506102dd565b60008484015250505050565b600061030f826102c4565b61031981856102cf565b93506103298185602086016102da565b80840191505092915050565b60006103418284610304565b915081905092915050565b61035581610290565b811461036057600080fd5b50565b6000815190506103728161034c565b92915050565b60006020828403121561038e5761038d610232565b5b600061039c84828501610363565b9150509291505056fea264697066735822122035f391b5c3dbf9a5e31072167a4ada71e9ba762650849f6320bc6150fa45aa9564736f6c63430008110033") - - { - // Step 0. Check the role of both accounts - expectRole(t, cluster, contracts.AllowListTransactionsAddr, adminAddr, addresslist.AdminRole) - expectRole(t, cluster, contracts.AllowListTransactionsAddr, targetAddr, addresslist.NoRole) - expectRole(t, cluster, contracts.AllowListTransactionsAddr, otherAddr, addresslist.EnabledRole) - } - - { - // Step 1. 'otherAddr' can send a normal transaction (non-contract creation). - otherTxn := cluster.Transfer(t, other, types.ZeroAddress, big.NewInt(1)) - require.NoError(t, otherTxn.Wait()) - require.True(t, otherTxn.Succeed()) - } - - { - // Step 2. 'targetAddr' **cannot** send a normal transaction because it is not whitelisted. - targetTxn := cluster.Transfer(t, target, types.ZeroAddress, big.NewInt(1)) - require.NoError(t, targetTxn.Wait()) - require.True(t, targetTxn.Reverted()) - } - - { - // Step 2.5. 'targetAddr' **cannot** deploy a contract because it is not whitelisted. - // (The transaction does not fail but the contract is not deployed and all gas - // for the transaction is consumed) - deployTxn := cluster.Deploy(t, target, bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Reverted()) - require.False(t, cluster.ExistsCode(t, deployTxn.Receipt().ContractAddress)) - } - - { - // Step 3. 'adminAddr' sends a transaction to enable 'targetAddr'. - input, _ := addresslist.SetEnabledFunc.Encode([]interface{}{targetAddr}) - - adminSetTxn := cluster.MethodTxn(t, admin, contracts.AllowListTransactionsAddr, input) - require.NoError(t, adminSetTxn.Wait()) - expectRole(t, cluster, contracts.AllowListTransactionsAddr, targetAddr, addresslist.EnabledRole) - } - - { - // Step 4. 'targetAddr' **can** send a normal transaction because it is whitelisted. - targetTxn := cluster.Transfer(t, target, types.ZeroAddress, big.NewInt(1)) - require.NoError(t, targetTxn.Wait()) - require.True(t, targetTxn.Succeed()) - } - - { - // Step 5. 'targetAddr' cannot enable other accounts since it is not an admin - // (The transaction fails) - input, _ := addresslist.SetEnabledFunc.Encode([]interface{}{types.ZeroAddress}) - - adminSetFailTxn := cluster.MethodTxn(t, target, contracts.AllowListTransactionsAddr, input) - require.NoError(t, adminSetFailTxn.Wait()) - require.True(t, adminSetFailTxn.Failed()) - expectRole(t, cluster, contracts.AllowListTransactionsAddr, types.ZeroAddress, addresslist.NoRole) - } - - { - // Step 6. 'adminAddr' sends a transaction to disable himself. - input, _ := addresslist.SetNoneFunc.Encode([]interface{}{adminAddr}) - - noneSetTxn := cluster.MethodTxn(t, admin, contracts.AllowListTransactionsAddr, input) - require.NoError(t, noneSetTxn.Wait()) - require.True(t, noneSetTxn.Failed()) - expectRole(t, cluster, contracts.AllowListTransactionsAddr, adminAddr, addresslist.AdminRole) - } -} - -func TestE2E_BlockList_Transactions(t *testing.T) { - // create two accounts, one for an admin sender and a second - // one for a non-enabled account that will switch on-off between - // both enabled and non-enabled roles. - admin, _ := wallet.GenerateKey() - target, _ := wallet.GenerateKey() - other, _ := wallet.GenerateKey() - - adminAddr := types.Address(admin.Address()) - targetAddr := types.Address(target.Address()) - otherAddr := types.Address(other.Address()) - - cluster := framework.NewTestCluster(t, 5, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, adminAddr)), - framework.WithPremine(adminAddr, targetAddr, otherAddr), - framework.WithTransactionsBlockListAdmin(adminAddr), - framework.WithTransactionsBlockListEnabled(otherAddr), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - { - // Step 0. Check the role of both accounts - expectRole(t, cluster, contracts.BlockListTransactionsAddr, adminAddr, addresslist.AdminRole) - expectRole(t, cluster, contracts.BlockListTransactionsAddr, targetAddr, addresslist.NoRole) - expectRole(t, cluster, contracts.BlockListTransactionsAddr, otherAddr, addresslist.EnabledRole) - } - - { - // Step 1. 'otherAddr' **cannot** send a normal transaction (non-contract creation) because it is blacklisted. - otherTxn := cluster.Transfer(t, other, types.ZeroAddress, big.NewInt(1)) - require.NoError(t, otherTxn.Wait()) - require.True(t, otherTxn.Reverted()) - } - - { - // Step 2. 'targetAddr' **can** send a normal transaction because it is not blacklisted. - targetTxn := cluster.Transfer(t, target, types.ZeroAddress, big.NewInt(1)) - require.NoError(t, targetTxn.Wait()) - require.True(t, targetTxn.Succeed()) - } - - { - // Step 3. 'targetAddr' cannot enable other accounts since it is not an admin - // (The transaction fails) - input, _ := addresslist.SetEnabledFunc.Encode([]interface{}{types.ZeroAddress}) - - adminSetFailTxn := cluster.MethodTxn(t, target, contracts.BlockListTransactionsAddr, input) - require.NoError(t, adminSetFailTxn.Wait()) - require.True(t, adminSetFailTxn.Failed()) - expectRole(t, cluster, contracts.BlockListTransactionsAddr, types.ZeroAddress, addresslist.NoRole) - } - - { - // Step 4. 'adminAddr' sends a transaction to enable 'targetAddr'. - input, _ := addresslist.SetEnabledFunc.Encode([]interface{}{targetAddr}) - - adminSetTxn := cluster.MethodTxn(t, admin, contracts.BlockListTransactionsAddr, input) - require.NoError(t, adminSetTxn.Wait()) - expectRole(t, cluster, contracts.BlockListTransactionsAddr, targetAddr, addresslist.EnabledRole) - } - - { - // Step 5. 'targetAddr' **cannot** send a normal transaction because it is blacklisted. - targetTxn := cluster.Transfer(t, target, types.ZeroAddress, big.NewInt(1)) - require.NoError(t, targetTxn.Wait()) - require.True(t, targetTxn.Reverted()) - } -} - -func TestE2E_AddressLists_Bridge(t *testing.T) { - // create two accounts, one for an admin sender and a second - // one for a non-enabled account that will switch on-off between - // both enabled and non-enabled roles. - admin, _ := wallet.GenerateKey() - target, _ := wallet.GenerateKey() - other, _ := wallet.GenerateKey() - - adminAddr := types.Address(admin.Address()) - targetAddr := types.Address(target.Address()) - otherAddr := types.Address(other.Address()) - - cluster := framework.NewTestCluster(t, 5, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, adminAddr)), - framework.WithPremine(adminAddr, targetAddr, otherAddr), - framework.WithBridgeAllowListAdmin(adminAddr), - framework.WithBridgeAllowListEnabled(otherAddr), - framework.WithBridgeBlockListAdmin(adminAddr), - framework.WithBridgeBlockListEnabled(otherAddr), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - { - // Step 0. Check the role of both accounts - expectRole(t, cluster, contracts.AllowListBridgeAddr, adminAddr, addresslist.AdminRole) - expectRole(t, cluster, contracts.AllowListBridgeAddr, targetAddr, addresslist.NoRole) - expectRole(t, cluster, contracts.AllowListBridgeAddr, otherAddr, addresslist.EnabledRole) - expectRole(t, cluster, contracts.BlockListBridgeAddr, adminAddr, addresslist.AdminRole) - expectRole(t, cluster, contracts.BlockListBridgeAddr, targetAddr, addresslist.NoRole) - expectRole(t, cluster, contracts.BlockListBridgeAddr, otherAddr, addresslist.EnabledRole) - } -} diff --git a/e2e-polybft/e2e/bridge_test.go b/e2e-polybft/e2e/bridge_test.go deleted file mode 100644 index 73bac8c..0000000 --- a/e2e-polybft/e2e/bridge_test.go +++ /dev/null @@ -1,1840 +0,0 @@ -package e2e - -import ( - "encoding/hex" - "fmt" - "math/big" - "path" - "strings" - "testing" - "time" - - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/wallet" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/bridge/common" - "github.com/xgr-network/xgr-node/command/genesis" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - helperCommon "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/state/runtime/addresslist" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -const ( - chainConfigFileName = "genesis.json" -) - -func TestE2E_Bridge_Transfers(t *testing.T) { - const ( - transfersCount = 5 - amount = 100 - numBlockConfirmations = 2 - // make epoch size long enough, so that all exit events are processed within the same epoch - epochSize = 30 - sprintSize = uint64(5) - numberOfAttempts = 7 - stateSyncedLogsCount = 1 - ) - - receiversAddrs := make([]types.Address, transfersCount) - receivers := make([]string, transfersCount) - amounts := make([]string, transfersCount) - receiverKeys := make([]string, transfersCount) - - for i := 0; i < transfersCount; i++ { - key, err := wallet.GenerateKey() - require.NoError(t, err) - - rawKey, err := key.MarshallPrivateKey() - require.NoError(t, err) - - receiverKeys[i] = hex.EncodeToString(rawKey) - receiversAddrs[i] = types.Address(key.Address()) - receivers[i] = types.Address(key.Address()).String() - amounts[i] = fmt.Sprintf("%d", amount) - - t.Logf("Receiver#%d=%s\n", i+1, receivers[i]) - } - - cluster := framework.NewTestCluster(t, 5, - framework.WithTestRewardToken(), - framework.WithNumBlockConfirmations(numBlockConfirmations), - framework.WithEpochSize(epochSize)) - defer cluster.Stop() - - cluster.WaitForReady(t) - - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - validatorSrv := cluster.Servers[0] - senderAccount, err := sidechain.GetAccountFromDir(validatorSrv.DataDir()) - require.NoError(t, err) - - childEthEndpoint := validatorSrv.JSONRPC().Eth() - - // bridge some tokens for first validator to child chain - tokensToDeposit := ethgo.Ether(10) - - require.NoError(t, cluster.Bridge.Deposit( - common.ERC20, - polybftCfg.Bridge.RootNativeERC20Addr, - polybftCfg.Bridge.RootERC20PredicateAddr, - rootHelper.TestAccountPrivKey, - senderAccount.Address().String(), - tokensToDeposit.String(), - "", - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false), - ) - - // wait for a couple of sprints - finalBlockNum := 5 * sprintSize - require.NoError(t, cluster.WaitForBlock(finalBlockNum, 2*time.Minute)) - - // the transaction is processed and there should be a success event - var stateSyncedResult contractsapi.StateSyncResultEvent - - logs, err := getFilteredLogs(stateSyncedResult.Sig(), 0, finalBlockNum, childEthEndpoint) - require.NoError(t, err) - - // assert that all deposits are executed successfully - checkStateSyncResultLogs(t, logs, stateSyncedLogsCount) - - // check validator balance got increased by deposited amount - balance, err := childEthEndpoint.GetBalance(ethgo.Address(senderAccount.Address()), ethgo.Latest) - require.NoError(t, err) - // because we premined validators - expectedBalance := new(big.Int).Add(tokensToDeposit, command.DefaultPremineBalance) - require.Equal(t, expectedBalance, balance) - - t.Run("bridge ERC 20 tokens", func(t *testing.T) { - // DEPOSIT ERC20 TOKENS - // send a few transactions to the bridge - require.NoError(t, cluster.Bridge.Deposit( - common.ERC20, - polybftCfg.Bridge.RootNativeERC20Addr, - polybftCfg.Bridge.RootERC20PredicateAddr, - rootHelper.TestAccountPrivKey, - strings.Join(receivers[:], ","), - strings.Join(amounts[:], ","), - "", - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false, - )) - - finalBlockNum := 10 * sprintSize - // wait for a couple of sprints - require.NoError(t, cluster.WaitForBlock(finalBlockNum, 2*time.Minute)) - - // the transactions are processed and there should be a success events - logs, err := getFilteredLogs(stateSyncedResult.Sig(), 0, finalBlockNum, childEthEndpoint) - require.NoError(t, err) - - // assert that all deposits are executed successfully - checkStateSyncResultLogs(t, logs, transfersCount+1) // because of the first deposit for the first validator - - // check receivers balances got increased by deposited amount - for _, receiver := range receivers { - balance, err := childEthEndpoint.GetBalance(ethgo.Address(types.StringToAddress(receiver)), ethgo.Latest) - require.NoError(t, err) - require.Equal(t, big.NewInt(amount), balance) - } - - t.Log("Deposits were successfully processed") - - // WITHDRAW ERC20 TOKENS - rootchainTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - senderAccount, err := sidechain.GetAccountFromDir(validatorSrv.DataDir()) - require.NoError(t, err) - - t.Logf("Withdraw sender: %s\n", senderAccount.Ecdsa.Address()) - - rawKey, err := senderAccount.Ecdsa.MarshallPrivateKey() - require.NoError(t, err) - - // send withdraw transaction - err = cluster.Bridge.Withdraw( - common.ERC20, - hex.EncodeToString(rawKey), - strings.Join(receivers[:], ","), - strings.Join(amounts[:], ","), - "", - validatorSrv.JSONRPCAddr(), - contracts.ChildERC20PredicateContract, - contracts.NativeERC20TokenContract, - false) - require.NoError(t, err) - - currentBlock, err := childEthEndpoint.GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - currentExtra, err := polybft.GetIbftExtra(currentBlock.ExtraData) - require.NoError(t, err) - - t.Logf("Latest block number: %d, epoch number: %d\n", currentBlock.Number, currentExtra.Checkpoint.EpochNumber) - - currentEpoch := currentExtra.Checkpoint.EpochNumber - - exitHelper := polybftCfg.Bridge.ExitHelperAddr - childJSONRPC := validatorSrv.JSONRPCAddr() - - successfullExitTransactions := make([]bool, transfersCount) - - for i := 0; i < numberOfAttempts; i++ { - t.Log("Number of attempts: ", i+1) - - require.NoError(t, waitForRootchainEpoch(currentEpoch+uint64(i), 3*time.Minute, - rootchainTxRelayer, polybftCfg.Bridge.CheckpointManagerAddr)) - - for exitEventID := uint64(1); exitEventID <= transfersCount; exitEventID++ { - if successfullExitTransactions[exitEventID-1] { - continue - } - - // send exit transaction to exit helper - if err = cluster.Bridge.SendExitTransaction(exitHelper, exitEventID, childJSONRPC); err == nil { - successfullExitTransactions[exitEventID-1] = true - - continue - } - - if i == numberOfAttempts-1 { - require.NoError(t, err) - } - } - - allExitsSuccessfull := true - for _, isSuccessfull := range successfullExitTransactions { - if !isSuccessfull { - allExitsSuccessfull = false - - break - } - } - - if allExitsSuccessfull { - break - } - } - - // assert that receiver's balances on RootERC20 smart contract are expected - for _, receiver := range receivers { - balance := erc20BalanceOf(t, types.StringToAddress(receiver), - polybftCfg.Bridge.RootNativeERC20Addr, rootchainTxRelayer) - require.Equal(t, big.NewInt(amount), balance) - } - }) - - t.Run("multiple deposit batches per epoch", func(t *testing.T) { - const ( - depositsSubset = 1 - ) - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithClient(validatorSrv.JSONRPC())) - require.NoError(t, err) - - lastCommittedIDMethod := contractsapi.StateReceiver.Abi.GetMethod("lastCommittedId") - lastCommittedIDInput, err := lastCommittedIDMethod.Encode([]interface{}{}) - require.NoError(t, err) - - // check that we submitted the minimal commitment to smart contract - commitmentIDRaw, err := txRelayer.Call(ethgo.ZeroAddress, ethgo.Address(contracts.StateReceiverContract), lastCommittedIDInput) - require.NoError(t, err) - - initialCommittedID, err := helperCommon.ParseUint64orHex(&commitmentIDRaw) - require.NoError(t, err) - - initialBlockNum, err := childEthEndpoint.BlockNumber() - require.NoError(t, err) - - // wait for next sprint block as the starting point, - // in order to be able to make assertions against blocks offsetted by sprints - initialBlockNum = initialBlockNum + sprintSize - (initialBlockNum % sprintSize) - require.NoError(t, cluster.WaitForBlock(initialBlockNum, 1*time.Minute)) - - // send two transactions to the bridge so that we have a minimal commitment - require.NoError(t, cluster.Bridge.Deposit( - common.ERC20, - polybftCfg.Bridge.RootNativeERC20Addr, - polybftCfg.Bridge.RootERC20PredicateAddr, - rootHelper.TestAccountPrivKey, - strings.Join(receivers[:depositsSubset], ","), - strings.Join(amounts[:depositsSubset], ","), - "", - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false), - ) - - // wait for a few more sprints - midBlockNumber := initialBlockNum + 2*sprintSize - require.NoError(t, cluster.WaitForBlock(midBlockNumber, 2*time.Minute)) - - // check that we submitted the minimal commitment to smart contract - commitmentIDRaw, err = txRelayer.Call(ethgo.ZeroAddress, - ethgo.Address(contracts.StateReceiverContract), lastCommittedIDInput) - require.NoError(t, err) - - lastCommittedID, err := helperCommon.ParseUint64orHex(&commitmentIDRaw) - require.NoError(t, err) - require.Equal(t, initialCommittedID+depositsSubset, lastCommittedID) - - // send some more transactions to the bridge to build another commitment in epoch - require.NoError(t, cluster.Bridge.Deposit( - common.ERC20, - polybftCfg.Bridge.RootNativeERC20Addr, - polybftCfg.Bridge.RootERC20PredicateAddr, - rootHelper.TestAccountPrivKey, - strings.Join(receivers[depositsSubset:], ","), - strings.Join(amounts[depositsSubset:], ","), - "", - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false), - ) - - finalBlockNum := midBlockNumber + 5*sprintSize - // wait for a few more sprints - require.NoError(t, cluster.WaitForBlock(midBlockNumber+5*sprintSize, 3*time.Minute)) - - // check that we submitted the minimal commitment to smart contract - commitmentIDRaw, err = txRelayer.Call(ethgo.ZeroAddress, ethgo.Address(contracts.StateReceiverContract), lastCommittedIDInput) - require.NoError(t, err) - - // check that the second (larger commitment) was also submitted in epoch - lastCommittedID, err = helperCommon.ParseUint64orHex(&commitmentIDRaw) - require.NoError(t, err) - require.Equal(t, initialCommittedID+uint64(transfersCount), lastCommittedID) - - // the transactions are mined and state syncs should be executed by the relayer - // and there should be a success events - logs, err := getFilteredLogs(stateSyncedResult.Sig(), initialBlockNum, finalBlockNum, childEthEndpoint) - require.NoError(t, err) - - // assert that all state syncs are executed successfully - checkStateSyncResultLogs(t, logs, transfersCount) - }) - - t.Run("non native ERC20 deposit and withdraw", func(t *testing.T) { - rootchainTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - childchainTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithClient(validatorSrv.JSONRPC())) - require.NoError(t, err) - - // Deploy ERC20 contract to the rootchain - rootchainDeployer, err := rootHelper.DecodePrivateKey("") - require.NoError(t, err) - - txn := ðgo.Transaction{To: nil, Input: contractsapi.RootERC20.Bytecode} - receipt, err := rootchainTxRelayer.SendTransaction(txn, rootchainDeployer) - require.NoError(t, err) - require.NotNil(t, receipt) - require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) - - rootTokenAddr := receipt.ContractAddress - - t.Log("Rootchain token address:", rootTokenAddr) - - // wait for next sprint block as the starting point, - // in order to be able to make assertions against blocks offsetted by sprints - initialBlockNum, err := childEthEndpoint.BlockNumber() - require.NoError(t, err) - - initialBlockNum = initialBlockNum + sprintSize - (initialBlockNum % sprintSize) - require.NoError(t, cluster.WaitForBlock(initialBlockNum, 1*time.Minute)) - - t.Log("Initial block number:", initialBlockNum) - - // send a few transactions to the bridge - require.NoError(t, cluster.Bridge.Deposit( - common.ERC20, - types.Address(rootTokenAddr), - polybftCfg.Bridge.RootERC20PredicateAddr, - rootHelper.TestAccountPrivKey, - strings.Join(receivers[:], ","), - strings.Join(amounts[:], ","), - "", - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false, - )) - - // wait for a few more sprints - finalBlockNumber := initialBlockNum + 10*sprintSize - require.NoError(t, cluster.WaitForBlock(finalBlockNumber, 2*time.Minute)) - - t.Log("Final block number:", finalBlockNumber) - - // the transactions are processed and there should be a success events - logs, err := getFilteredLogs(stateSyncedResult.Sig(), initialBlockNum, finalBlockNumber, childEthEndpoint) - require.NoError(t, err) - - // assert that all deposits are executed successfully - // map token action is executed along with the first deposit transaction - checkStateSyncResultLogs(t, logs, transfersCount+1) - - // retrieve child token address - childTokenAddr := getChildToken( - t, - contractsapi.ChildERC20Predicate.Abi, - contracts.ChildERC20PredicateContract, - types.Address(rootTokenAddr), - childchainTxRelayer, - ) - - t.Log("Childchain token address:", childTokenAddr) - - // check receivers balances got increased by deposited amount - for _, receiver := range receiversAddrs { - balance := erc20BalanceOf(t, receiver, childTokenAddr, childchainTxRelayer) - require.Equal(t, big.NewInt(int64(amount)), balance) - } - - t.Log("Deposits were successfully processed") - - // get initial exit id - initialExitEventID := getLastExitEventID(t, childchainTxRelayer) - - // WITHDRAW ERC20 TOKENS - for i, receiverKey := range receiverKeys { - t.Logf("Withdraw to: %s\n", receivers[i]) - - require.NoError(t, cluster.Bridge.Withdraw( - common.ERC20, - receiverKey, - receivers[i], - amounts[i], - "", - validatorSrv.JSONRPCAddr(), - contracts.ChildERC20PredicateContract, - childTokenAddr, - false, - )) - } - - currentBlock, err := childEthEndpoint.GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - currentExtra, err := polybft.GetIbftExtra(currentBlock.ExtraData) - require.NoError(t, err) - - t.Logf("Latest block number: %d, epoch number: %d\n", currentBlock.Number, currentExtra.Checkpoint.EpochNumber) - - require.NoError(t, waitForRootchainEpoch( - currentExtra.Checkpoint.EpochNumber+1, - 3*time.Minute, - rootchainTxRelayer, - polybftCfg.Bridge.CheckpointManagerAddr, - )) - - exitHelper := polybftCfg.Bridge.ExitHelperAddr - childJSONRPC := validatorSrv.JSONRPCAddr() - - initialExitEventID++ - for i := initialExitEventID; i < initialExitEventID+transfersCount; i++ { - // send exit transaction to exit helper - err = cluster.Bridge.SendExitTransaction(exitHelper, i, childJSONRPC) - require.NoError(t, err) - } - - // assert that receiver's balances on RootERC20 smart contract are expected - for _, receiver := range receivers { - balance := erc20BalanceOf(t, types.StringToAddress(receiver), types.Address(rootTokenAddr), rootchainTxRelayer) - require.Equal(t, big.NewInt(amount), balance) - } - }) -} - -func TestE2E_Bridge_ERC721Transfer(t *testing.T) { - const ( - transfersCount = 4 - epochSize = 5 - numberOfAttempts = 4 - stateSyncedLogsCount = 2 - ) - - minter, err := wallet.GenerateKey() - require.NoError(t, err) - - receiverKeys := make([]string, transfersCount) - receivers := make([]string, transfersCount) - receiversAddrs := make([]types.Address, transfersCount) - tokenIDs := make([]string, transfersCount) - - for i := 0; i < transfersCount; i++ { - key, err := wallet.GenerateKey() - require.NoError(t, err) - - rawKey, err := key.MarshallPrivateKey() - require.NoError(t, err) - - receiverKeys[i] = hex.EncodeToString(rawKey) - receivers[i] = types.Address(key.Address()).String() - receiversAddrs[i] = types.Address(key.Address()) - tokenIDs[i] = fmt.Sprintf("%d", i) - - t.Logf("Receiver#%d=%s\n", i+1, receivers[i]) - } - - cluster := framework.NewTestCluster(t, 5, - framework.WithEpochSize(epochSize), - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, minter.Address())), - framework.WithPremine(types.Address(minter.Address())), - framework.WithPremine(receiversAddrs...)) - defer cluster.Stop() - - cluster.WaitForReady(t) - - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - rootchainTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - rootchainDeployer, err := rootHelper.DecodePrivateKey("") - require.NoError(t, err) - - // deploy root ERC 721 token - deployTxn := ðgo.Transaction{To: nil, Input: contractsapi.RootERC721.Bytecode} - receipt, err := rootchainTxRelayer.SendTransaction(deployTxn, rootchainDeployer) - require.NoError(t, err) - - rootERC721Addr := receipt.ContractAddress - - // DEPOSIT ERC721 TOKENS - // send a few transactions to the bridge - require.NoError( - t, - cluster.Bridge.Deposit( - common.ERC721, - types.Address(rootERC721Addr), - polybftCfg.Bridge.RootERC721PredicateAddr, - rootHelper.TestAccountPrivKey, - strings.Join(receivers[:], ","), - "", - strings.Join(tokenIDs[:], ","), - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false), - ) - - // wait for a few more sprints - require.NoError(t, cluster.WaitForBlock(50, 4*time.Minute)) - - validatorSrv := cluster.Servers[0] - childEthEndpoint := validatorSrv.JSONRPC().Eth() - - // the transactions are processed and there should be a success events - var stateSyncedResult contractsapi.StateSyncResultEvent - - for i := 0; i < numberOfAttempts; i++ { - logs, err := getFilteredLogs(stateSyncedResult.Sig(), 0, uint64(50+i*epochSize), childEthEndpoint) - require.NoError(t, err) - - if len(logs) == stateSyncedLogsCount || i == numberOfAttempts-1 { - // assert that all deposits are executed successfully. - // All deposits are sent using a single transaction, so arbitrary message bridge emits two state sync events: - // MAP_TOKEN_SIG and DEPOSIT_BATCH_SIG state sync events - checkStateSyncResultLogs(t, logs, stateSyncedLogsCount) - - break - } - - require.NoError(t, cluster.WaitForBlock(uint64(50+(i+1)*epochSize), 1*time.Minute)) - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithClient(validatorSrv.JSONRPC())) - require.NoError(t, err) - - // retrieve child token address (from both chains, and assert they are the same) - l1ChildTokenAddr := getChildToken(t, contractsapi.RootERC721Predicate.Abi, polybftCfg.Bridge.RootERC721PredicateAddr, - types.Address(rootERC721Addr), rootchainTxRelayer) - l2ChildTokenAddr := getChildToken(t, contractsapi.ChildERC721Predicate.Abi, contracts.ChildERC721PredicateContract, - types.Address(rootERC721Addr), txRelayer) - - t.Log("L1 child token", l1ChildTokenAddr) - t.Log("L2 child token", l2ChildTokenAddr) - require.Equal(t, l1ChildTokenAddr, l2ChildTokenAddr) - - for i, receiver := range receiversAddrs { - owner := erc721OwnerOf(t, big.NewInt(int64(i)), l2ChildTokenAddr, txRelayer) - require.Equal(t, receiver, owner) - } - - t.Log("Deposits were successfully processed") - - // WITHDRAW ERC721 TOKENS - for i, receiverKey := range receiverKeys { - // send withdraw transactions - err = cluster.Bridge.Withdraw( - common.ERC721, - receiverKey, - receivers[i], - "", - tokenIDs[i], - validatorSrv.JSONRPCAddr(), - contracts.ChildERC721PredicateContract, - l2ChildTokenAddr, - false) - require.NoError(t, err) - } - - currentBlock, err := childEthEndpoint.GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - currentExtra, err := polybft.GetIbftExtra(currentBlock.ExtraData) - require.NoError(t, err) - - t.Logf("Latest block number: %d, epoch number: %d\n", currentBlock.Number, currentExtra.Checkpoint.EpochNumber) - - currentEpoch := currentExtra.Checkpoint.EpochNumber - require.NoError(t, waitForRootchainEpoch(currentEpoch, 3*time.Minute, rootchainTxRelayer, polybftCfg.Bridge.CheckpointManagerAddr)) - - exitHelper := polybftCfg.Bridge.ExitHelperAddr - childJSONRPC := validatorSrv.JSONRPCAddr() - - for exitEventID := uint64(1); exitEventID <= transfersCount; exitEventID++ { - // send exit transaction to exit helper - err = cluster.Bridge.SendExitTransaction(exitHelper, exitEventID, childJSONRPC) - require.NoError(t, err) - } - - // assert that owners of given token ids are the accounts on the root chain ERC 721 token - for i, receiver := range receiversAddrs { - owner := erc721OwnerOf(t, big.NewInt(int64(i)), types.Address(rootERC721Addr), rootchainTxRelayer) - require.Equal(t, receiver, owner) - } -} - -func TestE2E_Bridge_ERC1155Transfer(t *testing.T) { - const ( - transfersCount = 5 - amount = 100 - epochSize = 5 - numberOfAttempts = 4 - stateSyncedLogsCount = 2 - ) - - minter, err := wallet.GenerateKey() - require.NoError(t, err) - - receiverKeys := make([]string, transfersCount) - receivers := make([]string, transfersCount) - receiversAddrs := make([]types.Address, transfersCount) - amounts := make([]string, transfersCount) - tokenIDs := make([]string, transfersCount) - - for i := 0; i < transfersCount; i++ { - key, err := wallet.GenerateKey() - require.NoError(t, err) - - rawKey, err := key.MarshallPrivateKey() - require.NoError(t, err) - - receiverKeys[i] = hex.EncodeToString(rawKey) - receivers[i] = types.Address(key.Address()).String() - receiversAddrs[i] = types.Address(key.Address()) - amounts[i] = fmt.Sprintf("%d", amount) - tokenIDs[i] = fmt.Sprintf("%d", i+1) - - t.Logf("Receiver#%d=%s\n", i+1, receivers[i]) - } - - cluster := framework.NewTestCluster(t, 5, - framework.WithNumBlockConfirmations(0), - framework.WithEpochSize(epochSize), - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, minter.Address())), - framework.WithPremine(types.Address(minter.Address())), - framework.WithPremine(receiversAddrs...)) - defer cluster.Stop() - - cluster.WaitForReady(t) - - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - rootchainTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - rootchainDeployer, err := rootHelper.DecodePrivateKey("") - require.NoError(t, err) - - // deploy root ERC 1155 token - deployTxn := ðgo.Transaction{To: nil, Input: contractsapi.RootERC1155.Bytecode} - receipt, err := rootchainTxRelayer.SendTransaction(deployTxn, rootchainDeployer) - require.NoError(t, err) - - rootERC1155Addr := receipt.ContractAddress - - // DEPOSIT ERC1155 TOKENS - // send a few transactions to the bridge - require.NoError( - t, - cluster.Bridge.Deposit( - common.ERC1155, - types.Address(rootERC1155Addr), - polybftCfg.Bridge.RootERC1155PredicateAddr, - rootHelper.TestAccountPrivKey, - strings.Join(receivers[:], ","), - strings.Join(amounts[:], ","), - strings.Join(tokenIDs[:], ","), - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false), - ) - - // wait for a few more sprints - require.NoError(t, cluster.WaitForBlock(50, 4*time.Minute)) - - validatorSrv := cluster.Servers[0] - childEthEndpoint := validatorSrv.JSONRPC().Eth() - - // the transactions are processed and there should be a success events - var stateSyncedResult contractsapi.StateSyncResultEvent - - for i := 0; i < numberOfAttempts; i++ { - logs, err := getFilteredLogs(stateSyncedResult.Sig(), 0, uint64(50+i*epochSize), childEthEndpoint) - require.NoError(t, err) - - if len(logs) == stateSyncedLogsCount || i == numberOfAttempts-1 { - // assert that all deposits are executed successfully. - // All deposits are sent using a single transaction, so arbitrary message bridge emits two state sync events: - // MAP_TOKEN_SIG and DEPOSIT_BATCH_SIG state sync events - checkStateSyncResultLogs(t, logs, stateSyncedLogsCount) - - break - } - - require.NoError(t, cluster.WaitForBlock(uint64(50+(i+1)*epochSize), 1*time.Minute)) - } - - txRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithClient(validatorSrv.JSONRPC())) - require.NoError(t, err) - - // retrieve child token address - l1ChildTokenAddr := getChildToken(t, contractsapi.RootERC1155Predicate.Abi, polybftCfg.Bridge.RootERC1155PredicateAddr, - types.Address(rootERC1155Addr), rootchainTxRelayer) - l2ChildTokenAddr := getChildToken(t, contractsapi.ChildERC1155Predicate.Abi, contracts.ChildERC1155PredicateContract, - types.Address(rootERC1155Addr), txRelayer) - - t.Log("L1 child token", l1ChildTokenAddr) - t.Log("L2 child token", l2ChildTokenAddr) - require.Equal(t, l1ChildTokenAddr, l2ChildTokenAddr) - - // check receivers balances got increased by deposited amount - for i, receiver := range receivers { - balanceOfFn := &contractsapi.BalanceOfChildERC1155Fn{ - Account: types.StringToAddress(receiver), - ID: big.NewInt(int64(i + 1)), - } - - balanceInput, err := balanceOfFn.EncodeAbi() - require.NoError(t, err) - - balanceRaw, err := txRelayer.Call(ethgo.ZeroAddress, ethgo.Address(l2ChildTokenAddr), balanceInput) - require.NoError(t, err) - - balance, err := helperCommon.ParseUint256orHex(&balanceRaw) - require.NoError(t, err) - require.Equal(t, big.NewInt(int64(amount)), balance) - } - - t.Log("Deposits were successfully processed") - - // WITHDRAW ERC1155 TOKENS - senderAccount, err := sidechain.GetAccountFromDir(cluster.Servers[0].DataDir()) - require.NoError(t, err) - - t.Logf("Withdraw sender: %s\n", senderAccount.Ecdsa.Address()) - - for i, receiverKey := range receiverKeys { - // send withdraw transactions - err = cluster.Bridge.Withdraw( - common.ERC1155, - receiverKey, - receivers[i], - amounts[i], - tokenIDs[i], - validatorSrv.JSONRPCAddr(), - contracts.ChildERC1155PredicateContract, - l2ChildTokenAddr, - false) - require.NoError(t, err) - } - - currentBlock, err := childEthEndpoint.GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - currentExtra, err := polybft.GetIbftExtra(currentBlock.ExtraData) - require.NoError(t, err) - - currentEpoch := currentExtra.Checkpoint.EpochNumber - t.Logf("Latest block number: %d, epoch number: %d\n", currentBlock.Number, currentExtra.Checkpoint.EpochNumber) - - require.NoError(t, waitForRootchainEpoch(currentEpoch, 3*time.Minute, - rootchainTxRelayer, polybftCfg.Bridge.CheckpointManagerAddr)) - - exitHelper := polybftCfg.Bridge.ExitHelperAddr - childJSONRPC := validatorSrv.JSONRPCAddr() - - for exitEventID := uint64(1); exitEventID <= transfersCount; exitEventID++ { - // send exit transaction to exit helper - err = cluster.Bridge.SendExitTransaction(exitHelper, exitEventID, childJSONRPC) - require.NoError(t, err) - } - - // assert that receiver's balances on RootERC1155 smart contract are expected - for i, receiver := range receivers { - balanceOfFn := &contractsapi.BalanceOfRootERC1155Fn{ - Account: types.StringToAddress(receiver), - ID: big.NewInt(int64(i + 1)), - } - - balanceInput, err := balanceOfFn.EncodeAbi() - require.NoError(t, err) - - balanceRaw, err := rootchainTxRelayer.Call(ethgo.ZeroAddress, rootERC1155Addr, balanceInput) - require.NoError(t, err) - - balance, err := helperCommon.ParseUint256orHex(&balanceRaw) - require.NoError(t, err) - require.Equal(t, big.NewInt(amount), balance) - } -} - -func TestE2E_Bridge_ChildChainMintableTokensTransfer(t *testing.T) { - const ( - transfersCount = uint64(4) - amount = 100 - // make epoch size long enough, so that all exit events are processed within the same epoch - epochSize = 30 - sprintSize = uint64(5) - numberOfAttempts = 4 - ) - - // init private keys and amounts - depositorKeys := make([]string, transfersCount) - depositors := make([]types.Address, transfersCount) - amounts := make([]string, transfersCount) - funds := make([]*big.Int, transfersCount) - singleToken := ethgo.Ether(1) - - admin, err := wallet.GenerateKey() - require.NoError(t, err) - - adminAddr := types.Address(admin.Address()) - - for i := uint64(0); i < transfersCount; i++ { - key, err := wallet.GenerateKey() - require.NoError(t, err) - - rawKey, err := key.MarshallPrivateKey() - require.NoError(t, err) - - depositorKeys[i] = hex.EncodeToString(rawKey) - depositors[i] = types.Address(key.Address()) - funds[i] = singleToken - amounts[i] = fmt.Sprintf("%d", amount) - - t.Logf("Depositor#%d=%s\n", i+1, depositors[i]) - } - - // setup cluster - cluster := framework.NewTestCluster(t, 5, - framework.WithNumBlockConfirmations(0), - framework.WithEpochSize(epochSize), - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, adminAddr)), - framework.WithBridgeBlockListAdmin(adminAddr), - framework.WithPremine(append(depositors, adminAddr)...)) //nolint:makezero - defer cluster.Stop() - - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - validatorSrv := cluster.Servers[0] - childEthEndpoint := validatorSrv.JSONRPC().Eth() - - // fund accounts on rootchain - require.NoError(t, validatorSrv.RootchainFundFor(depositors, funds, polybftCfg.Bridge.StakeTokenAddr)) - - cluster.WaitForReady(t) - - rootchainTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - childchainTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithClient(validatorSrv.JSONRPC())) - require.NoError(t, err) - - var mintableTokenMapped contractsapi.MintableTokenMappedEvent - - t.Run("bridge native tokens", func(t *testing.T) { - // rootToken represents deposit token (basically native mintable token from the Supernets) - rootToken := contracts.NativeERC20TokenContract - - // block list first depositor - setAccessListRole(t, cluster, contracts.BlockListBridgeAddr, depositors[0], addresslist.EnabledRole, admin) - - // try sending a single native token deposit transaction - // it should fail, because first depositor is added to bridge transactions block list - err = cluster.Bridge.Deposit( - common.ERC20, - rootToken, - contracts.RootMintableERC20PredicateContract, - depositorKeys[0], - depositors[0].String(), - amounts[0], - "", - validatorSrv.JSONRPCAddr(), - "", - true) - require.Error(t, err) - - // remove first depositor from bridge transactions block list - setAccessListRole(t, cluster, contracts.BlockListBridgeAddr, depositors[0], addresslist.NoRole, admin) - - // allow list each depositor and make sure deposit is successfully executed - for i, key := range depositorKeys { - // make sure deposit is successfully executed - err = cluster.Bridge.Deposit( - common.ERC20, - rootToken, - contracts.RootMintableERC20PredicateContract, - key, - depositors[i].String(), - amounts[i], - "", - validatorSrv.JSONRPCAddr(), - "", - true) - require.NoError(t, err) - } - - latestBlock, err := childEthEndpoint.GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - extra, err := polybft.GetIbftExtra(latestBlock.ExtraData) - require.NoError(t, err) - - // wait for checkpoint to get submitted before invoking exit transactions - require.NoError(t, - waitForRootchainEpoch(extra.Checkpoint.EpochNumber, 2*time.Minute, rootchainTxRelayer, polybftCfg.Bridge.CheckpointManagerAddr)) - - // first exit event is mapping child token on a rootchain - // remaining ones are deposits - for exitEventID := uint64(1); exitEventID <= transfersCount+1; exitEventID++ { - require.NoError(t, - cluster.Bridge.SendExitTransaction(polybftCfg.Bridge.ExitHelperAddr, exitEventID, validatorSrv.JSONRPCAddr())) - } - - rootchainLatestBlock, err := rootchainTxRelayer.Client().Eth().BlockNumber() - require.NoError(t, err) - - // retrieve child mintable token address from both chains and make sure they are the same - l1ChildToken := getChildToken(t, contractsapi.ChildMintableERC20Predicate.Abi, polybftCfg.Bridge.ChildMintableERC20PredicateAddr, - rootToken, rootchainTxRelayer) - l2ChildToken := getChildToken(t, contractsapi.RootMintableERC20Predicate.Abi, contracts.RootMintableERC20PredicateContract, - rootToken, childchainTxRelayer) - - t.Log("L1 child token", l1ChildToken) - t.Log("L2 child token", l2ChildToken) - require.Equal(t, l1ChildToken, l2ChildToken) - - logs, err := getFilteredLogs(mintableTokenMapped.Sig(), 0, rootchainLatestBlock, rootchainTxRelayer.Client().Eth()) - require.NoError(t, err) - require.Len(t, logs, 1) - - // check that balances on rootchain have increased by deposited amounts - for _, depositor := range depositors { - balance := erc20BalanceOf(t, depositor, l1ChildToken, rootchainTxRelayer) - require.Equal(t, big.NewInt(amount), balance) - } - - balancesBefore := make([]*big.Int, transfersCount) - for i := uint64(0); i < transfersCount; i++ { - balancesBefore[i], err = childEthEndpoint.GetBalance(ethgo.Address(depositors[i]), ethgo.Latest) - require.NoError(t, err) - } - - // withdraw child token on the rootchain - for i, depositorKey := range depositorKeys { - err = cluster.Bridge.Withdraw( - common.ERC20, - depositorKey, - depositors[i].String(), - amounts[i], - "", - cluster.Bridge.JSONRPCAddr(), - polybftCfg.Bridge.ChildMintableERC20PredicateAddr, - l1ChildToken, - true) - require.NoError(t, err) - } - - allSuccessful := false - - for it := 0; it < numberOfAttempts && !allSuccessful; it++ { - blockNum, err := childEthEndpoint.BlockNumber() - require.NoError(t, err) - - // wait a couple of sprints to finalize state sync events - require.NoError(t, cluster.WaitForBlock(blockNum+3*sprintSize, 2*time.Minute)) - - allSuccessful = true - - // check that balances on the child chain are correct - for i, receiver := range depositors { - balance := erc20BalanceOf(t, receiver, contracts.NativeERC20TokenContract, childchainTxRelayer) - t.Log("Attempt", it+1, "Balance before", balancesBefore[i], "Balance after", balance) - if balance.Cmp(balancesBefore[i].Add(balancesBefore[i], big.NewInt(amount))) != 0 { - allSuccessful = false - - break - } - } - } - - require.True(t, allSuccessful) - }) - - t.Run("bridge ERC 721 tokens", func(t *testing.T) { - rootchainInitialBlock, err := rootchainTxRelayer.Client().Eth().BlockNumber() - require.NoError(t, err) - - // get initial exit id - initialExitEventID := getLastExitEventID(t, childchainTxRelayer) - - erc721DeployTxn := cluster.Deploy(t, admin, contractsapi.RootERC721.Bytecode) - require.NoError(t, erc721DeployTxn.Wait()) - require.True(t, erc721DeployTxn.Succeed()) - rootERC721Token := erc721DeployTxn.Receipt().ContractAddress - - for _, depositor := range depositors { - // mint all the depositors in advance - mintFn := &contractsapi.MintRootERC721Fn{To: depositor} - mintInput, err := mintFn.EncodeAbi() - require.NoError(t, err) - - mintTxn := cluster.MethodTxn(t, admin, types.Address(rootERC721Token), mintInput) - require.NoError(t, mintTxn.Wait()) - require.True(t, mintTxn.Succeed()) - - // add all depositors to bride block list - setAccessListRole(t, cluster, contracts.BlockListBridgeAddr, depositor, addresslist.EnabledRole, admin) - } - - // deposit should fail because depositors are in bridge block list - err = cluster.Bridge.Deposit( - common.ERC721, - types.Address(rootERC721Token), - contracts.RootMintableERC721PredicateContract, - depositorKeys[0], - depositors[0].String(), - "", - fmt.Sprintf("%d", 0), - validatorSrv.JSONRPCAddr(), - "", - true) - require.Error(t, err) - - for i, depositorKey := range depositorKeys { - // remove all depositors from the bridge block list - setAccessListRole(t, cluster, contracts.BlockListBridgeAddr, depositors[i], addresslist.NoRole, admin) - - // deposit (without minting, as it was already done beforehand) - err = cluster.Bridge.Deposit( - common.ERC721, - types.Address(rootERC721Token), - contracts.RootMintableERC721PredicateContract, - depositorKey, - depositors[i].String(), - "", - fmt.Sprintf("%d", i), - validatorSrv.JSONRPCAddr(), - "", - true) - require.NoError(t, err) - } - - childChainBlock, err := childEthEndpoint.GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - childChainBlockExtra, err := polybft.GetIbftExtra(childChainBlock.ExtraData) - require.NoError(t, err) - - // wait for checkpoint to be submitted - require.NoError(t, - waitForRootchainEpoch(childChainBlockExtra.Checkpoint.EpochNumber, 2*time.Minute, rootchainTxRelayer, polybftCfg.Bridge.CheckpointManagerAddr)) - - // first exit event is mapping child token on a rootchain - // remaining ones are the deposits - initialExitEventID++ - for i := initialExitEventID; i <= initialExitEventID+transfersCount; i++ { - require.NoError(t, - cluster.Bridge.SendExitTransaction(polybftCfg.Bridge.ExitHelperAddr, i, validatorSrv.JSONRPCAddr())) - } - - latestRootchainBlock, err := rootchainTxRelayer.Client().Eth().BlockNumber() - require.NoError(t, err) - - // retrieve child token addresses on both chains and make sure they are the same - l1ChildToken := getChildToken(t, contractsapi.ChildMintableERC721Predicate.Abi, polybftCfg.Bridge.ChildMintableERC721PredicateAddr, - types.Address(rootERC721Token), rootchainTxRelayer) - l2ChildToken := getChildToken(t, contractsapi.RootMintableERC721Predicate.Abi, contracts.RootMintableERC721PredicateContract, - types.Address(rootERC721Token), childchainTxRelayer) - - t.Log("L1 child token", l1ChildToken) - t.Log("L2 child token", l2ChildToken) - require.Equal(t, l1ChildToken, l2ChildToken) - - logs, err := getFilteredLogs(mintableTokenMapped.Sig(), rootchainInitialBlock, latestRootchainBlock, - rootchainTxRelayer.Client().Eth()) - require.NoError(t, err) - require.Len(t, logs, 1) - - // check owner on the rootchain - for i := uint64(0); i < transfersCount; i++ { - owner := erc721OwnerOf(t, new(big.Int).SetUint64(i), l1ChildToken, rootchainTxRelayer) - t.Log("ChildERC721 owner", owner) - require.Equal(t, depositors[i], owner) - } - - // withdraw tokens - for i, depositorKey := range depositorKeys { - err = cluster.Bridge.Withdraw( - common.ERC721, - depositorKey, - depositors[i].String(), - "", - fmt.Sprintf("%d", i), - cluster.Bridge.JSONRPCAddr(), - polybftCfg.Bridge.ChildMintableERC721PredicateAddr, - l1ChildToken, - true) - require.NoError(t, err) - } - - allSuccessful := false - - for it := 0; it < numberOfAttempts && !allSuccessful; it++ { - childChainBlockNum, err := childEthEndpoint.BlockNumber() - require.NoError(t, err) - - // wait for commitment execution - require.NoError(t, cluster.WaitForBlock(childChainBlockNum+3*sprintSize, 2*time.Minute)) - - allSuccessful = true - // check owners on the child chain - for i, receiver := range depositors { - owner := erc721OwnerOf(t, big.NewInt(int64(i)), types.Address(rootERC721Token), childchainTxRelayer) - t.Log("Attempt:", it+1, " Owner:", owner, " Receiver:", receiver) - if receiver != owner { - allSuccessful = false - - break - } - } - } - - require.True(t, allSuccessful) - }) -} - -func TestE2E_CheckpointSubmission(t *testing.T) { - // spin up a cluster with epoch size set to 5 blocks - cluster := framework.NewTestCluster(t, 5, framework.WithEpochSize(5), framework.WithTestRewardToken()) - defer cluster.Stop() - - // initialize tx relayer used to query CheckpointManager smart contract - rootChainRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - checkpointManagerAddr := ethgo.Address(polybftCfg.Bridge.CheckpointManagerAddr) - - testCheckpointBlockNumber := func(expectedCheckpointBlock uint64) (bool, error) { - actualCheckpointBlock, err := getCheckpointBlockNumber(rootChainRelayer, checkpointManagerAddr) - if err != nil { - return false, err - } - - t.Logf("Checkpoint block: %d\n", actualCheckpointBlock) - - return actualCheckpointBlock == expectedCheckpointBlock, nil - } - - // wait for a single epoch to be checkpointed - require.NoError(t, cluster.WaitForBlock(7, 30*time.Second)) - - // checking last checkpoint block before rootchain server stop - err = cluster.Bridge.WaitUntil(2*time.Second, 30*time.Second, func() (bool, error) { - return testCheckpointBlockNumber(5) - }) - require.NoError(t, err) - - // stop rootchain server - cluster.Bridge.Stop() - - // wait for a couple of epochs so that there are pending checkpoint (epoch-ending) blocks - require.NoError(t, cluster.WaitForBlock(21, 2*time.Minute)) - - // restart rootchain server - require.NoError(t, cluster.Bridge.Start()) - - // check if pending checkpoint blocks were submitted (namely the last checkpointed block must be block 20) - err = cluster.Bridge.WaitUntil(2*time.Second, 50*time.Second, func() (bool, error) { - return testCheckpointBlockNumber(20) - }) - require.NoError(t, err) -} - -func TestE2E_Bridge_ChangeVotingPower(t *testing.T) { - const ( - votingPowerChanges = 2 - epochSize = 5 - ) - - minter, err := wallet.GenerateKey() - require.NoError(t, err) - - cluster := framework.NewTestCluster(t, 5, - framework.WithEpochSize(epochSize), - framework.WithEpochReward(1000000), - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, minter.Address())), - framework.WithPremine(types.Address(minter.Address())), - ) - defer cluster.Stop() - - // load polybft config - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - validatorSecretFiles, err := genesis.GetValidatorKeyFiles(cluster.Config.TmpDir, cluster.Config.ValidatorPrefix) - require.NoError(t, err) - - votingPowerChangeValidators := make([]ethgo.Address, votingPowerChanges) - - for i := 0; i < votingPowerChanges; i++ { - validator, err := sidechain.GetAccountFromDir(path.Join(cluster.Config.TmpDir, validatorSecretFiles[i])) - require.NoError(t, err) - - votingPowerChangeValidators[i] = validator.Ecdsa.Address() - } - - // child chain tx relayer - childRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Servers[0].JSONRPCAddr())) - require.NoError(t, err) - - // root chain tx relayer - rootRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - // waiting two epochs, so that some rewards get accumulated - require.NoError(t, cluster.WaitForBlock(2*epochSize, 1*time.Minute)) - - queryValidators := func(handler func(idx int, validatorInfo *polybft.ValidatorInfo)) { - for i, validatorAddr := range votingPowerChangeValidators { - // query validator info - validatorInfo, err := sidechain.GetValidatorInfo( - validatorAddr, - polybftCfg.Bridge.CustomSupernetManagerAddr, - polybftCfg.Bridge.StakeManagerAddr, - polybftCfg.SupernetID, - rootRelayer, - childRelayer) - require.NoError(t, err) - - handler(i, validatorInfo) - } - } - - // validatorsMap holds only changed validators - validatorsMap := make(map[ethgo.Address]*polybft.ValidatorInfo, votingPowerChanges) - - queryValidators(func(idx int, validator *polybft.ValidatorInfo) { - t.Logf("[Validator#%d] Voting power (original)=%d, rewards=%d\n", - idx+1, validator.Stake, validator.WithdrawableRewards) - - validatorsMap[validator.Address] = validator - validatorSrv := cluster.Servers[idx] - - // fund validators (send accumulated rewards amount) - require.NoError(t, validatorSrv.RootchainFund(polybftCfg.Bridge.StakeTokenAddr, validator.WithdrawableRewards)) - - // stake previously funded amount - require.NoError(t, validatorSrv.Stake(polybftCfg, validator.WithdrawableRewards)) - }) - - queryValidators(func(idx int, validator *polybft.ValidatorInfo) { - t.Logf("[Validator#%d] Voting power (after stake)=%d\n", idx+1, validator.Stake) - - previousValidatorInfo := validatorsMap[validator.Address] - stakedAmount := new(big.Int).Add(previousValidatorInfo.WithdrawableRewards, previousValidatorInfo.Stake) - - // assert that total stake has increased by staked amount - require.Equal(t, stakedAmount, validator.Stake) - - validatorsMap[validator.Address] = validator - }) - - currentBlockNum, err := childRelayer.Client().Eth().BlockNumber() - require.NoError(t, err) - - // wait for next epoch-ending block as the starting point, - // in order to be able to easier track checkpoints submission - endOfEpochBlockNum := currentBlockNum + epochSize - (currentBlockNum % epochSize) - require.NoError(t, cluster.WaitForBlock(endOfEpochBlockNum, 1*time.Minute)) - - currentBlock, err := childRelayer.Client().Eth().GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - currentExtra, err := polybft.GetIbftExtra(currentBlock.ExtraData) - require.NoError(t, err) - - targetEpoch := currentExtra.Checkpoint.EpochNumber + 2 - require.NoError(t, waitForRootchainEpoch(targetEpoch, 2*time.Minute, - rootRelayer, polybftCfg.Bridge.CheckpointManagerAddr)) - - // make sure that correct validator set is submitted to the checkpoint manager - checkpointValidators, err := getCheckpointManagerValidators(rootRelayer, ethgo.Address(polybftCfg.Bridge.CheckpointManagerAddr)) - require.NoError(t, err) - - for _, checkpointValidator := range checkpointValidators { - if validator, ok := validatorsMap[checkpointValidator.Address]; ok { - require.Equal(t, validator.Stake, checkpointValidator.Stake) - } else { - require.Equal(t, command.DefaultPremineBalance, checkpointValidator.Stake) - } - } -} - -func TestE2E_Bridge_Transfers_AccessLists(t *testing.T) { - var ( - transfersCount = 5 - depositAmount = ethgo.Ether(5) - withdrawAmount = ethgo.Ether(1) - // make epoch size long enough, so that all exit events are processed within the same epoch - epochSize = 30 - sprintSize = uint64(5) - stateSyncedLogsCount = 1 - ) - - receivers := make([]string, transfersCount) - depositAmounts := make([]string, transfersCount) - withdrawAmounts := make([]string, transfersCount) - - admin, _ := wallet.GenerateKey() - adminAddr := types.Address(admin.Address()) - - cluster := framework.NewTestCluster(t, 5, - framework.WithNumBlockConfirmations(0), - framework.WithEpochSize(epochSize), - framework.WithTestRewardToken(), - framework.WithBridgeAllowListAdmin(adminAddr), - framework.WithBridgeBlockListAdmin(adminAddr), - framework.WithSecretsCallback(func(a []types.Address, tcc *framework.TestClusterConfig) { - for i := 0; i < len(a); i++ { - receivers[i] = a[i].String() - depositAmounts[i] = fmt.Sprintf("%d", depositAmount) - withdrawAmounts[i] = fmt.Sprintf("%d", withdrawAmount) - - t.Logf("Receiver#%d=%s\n", i+1, receivers[i]) - } - }), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - validatorSrv := cluster.Servers[0] - childEthEndpoint := validatorSrv.JSONRPC().Eth() - - var stateSyncedResult contractsapi.StateSyncResultEvent - - // fund admin on rootchain - require.NoError(t, cluster.Servers[0].RootchainFundFor([]types.Address{adminAddr}, []*big.Int{ethgo.Ether(10)}, - polybftCfg.Bridge.StakeTokenAddr)) - - adminBalanceOnChild := ethgo.Ether(5) - - // bridge some tokens for admin to child chain - require.NoError( - t, cluster.Bridge.Deposit( - common.ERC20, - polybftCfg.Bridge.RootNativeERC20Addr, - polybftCfg.Bridge.RootERC20PredicateAddr, - rootHelper.TestAccountPrivKey, - adminAddr.String(), - adminBalanceOnChild.String(), - "", - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false), - ) - - // wait for a couple of sprints - finalBlockNum := 5 * sprintSize - require.NoError(t, cluster.WaitForBlock(finalBlockNum, 2*time.Minute)) - - // the transaction is processed and there should be a success events - logs, err := getFilteredLogs(stateSyncedResult.Sig(), 0, finalBlockNum, childEthEndpoint) - require.NoError(t, err) - - // assert that all deposits are executed successfully - checkStateSyncResultLogs(t, logs, stateSyncedLogsCount) - - // check admin balance got increased by deposited amount - balance, err := childEthEndpoint.GetBalance(ethgo.Address(adminAddr), ethgo.Latest) - require.NoError(t, err) - require.Equal(t, adminBalanceOnChild, balance) - - t.Run("bridge native (ERC 20) tokens", func(t *testing.T) { - // DEPOSIT ERC20 TOKENS - // send a few transactions to the bridge - require.NoError( - t, - cluster.Bridge.Deposit( - common.ERC20, - polybftCfg.Bridge.RootNativeERC20Addr, - polybftCfg.Bridge.RootERC20PredicateAddr, - rootHelper.TestAccountPrivKey, - strings.Join(receivers[:], ","), - strings.Join(depositAmounts[:], ","), - "", - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false), - ) - - finalBlockNum := 10 * sprintSize - // wait for a couple of sprints - require.NoError(t, cluster.WaitForBlock(finalBlockNum, 2*time.Minute)) - - // the transactions are processed and there should be a success events - logs, err := getFilteredLogs(stateSyncedResult.Sig(), 0, finalBlockNum, childEthEndpoint) - require.NoError(t, err) - - // because of the admin deposit on child chain at the beginning - totalTransfers := transfersCount + 1 - - // assert that all deposits are executed successfully - checkStateSyncResultLogs(t, logs, totalTransfers) - - // check receivers balances got increased by deposited amount - // because we premined validators - expectedBalance := new(big.Int).Add(command.DefaultPremineBalance, depositAmount) - - for _, receiver := range receivers { - balance, err := childEthEndpoint.GetBalance(ethgo.Address(types.StringToAddress(receiver)), ethgo.Latest) - require.NoError(t, err) - require.Equal(t, expectedBalance, balance) - } - - t.Log("Deposits were successfully processed") - - // WITHDRAW ERC20 TOKENS - rootchainTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - senderAccount, err := sidechain.GetAccountFromDir(validatorSrv.DataDir()) - require.NoError(t, err) - - t.Logf("Withdraw sender: %s\n", senderAccount.Ecdsa.Address()) - - rawKey, err := senderAccount.Ecdsa.MarshallPrivateKey() - require.NoError(t, err) - - // send withdraw transaction. - // It should fail because sender is not allow-listed. - err = cluster.Bridge.Withdraw( - common.ERC20, - hex.EncodeToString(rawKey), - strings.Join(receivers[:], ","), - strings.Join(withdrawAmounts[:], ","), - "", - validatorSrv.JSONRPCAddr(), - contracts.ChildERC20PredicateContract, - contracts.NativeERC20TokenContract, - false) - require.Error(t, err) - - // add account to bridge allow list - setAccessListRole(t, cluster, contracts.AllowListBridgeAddr, senderAccount.Address(), addresslist.EnabledRole, admin) - - // try to withdraw again - err = cluster.Bridge.Withdraw( - common.ERC20, - hex.EncodeToString(rawKey), - strings.Join(receivers[:], ","), - strings.Join(withdrawAmounts[:], ","), - "", - validatorSrv.JSONRPCAddr(), - contracts.ChildERC20PredicateContract, - contracts.NativeERC20TokenContract, - false) - require.NoError(t, err) - - // add account to bridge block list - setAccessListRole(t, cluster, contracts.BlockListBridgeAddr, senderAccount.Address(), addresslist.EnabledRole, admin) - - // it should fail now because sender accont is in the block list - err = cluster.Bridge.Withdraw( - common.ERC20, - hex.EncodeToString(rawKey), - strings.Join(receivers[:], ","), - strings.Join(withdrawAmounts[:], ","), - "", - validatorSrv.JSONRPCAddr(), - contracts.ChildERC20PredicateContract, - contracts.NativeERC20TokenContract, - false) - require.ErrorContains(t, err, "failed to send withdraw transaction") - - currentBlock, err := childEthEndpoint.GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - currentExtra, err := polybft.GetIbftExtra(currentBlock.ExtraData) - require.NoError(t, err) - - t.Logf("Latest block number: %d, epoch number: %d\n", currentBlock.Number, currentExtra.Checkpoint.EpochNumber) - - currentEpoch := currentExtra.Checkpoint.EpochNumber - - require.NoError(t, waitForRootchainEpoch(currentEpoch, 3*time.Minute, - rootchainTxRelayer, polybftCfg.Bridge.CheckpointManagerAddr)) - - exitHelper := polybftCfg.Bridge.ExitHelperAddr - childJSONRPC := validatorSrv.JSONRPCAddr() - - oldBalances := map[types.Address]*big.Int{} - for _, receiver := range receivers { - balance := erc20BalanceOf(t, types.StringToAddress(receiver), polybftCfg.Bridge.RootNativeERC20Addr, rootchainTxRelayer) - oldBalances[types.StringToAddress(receiver)] = balance - } - - for exitEventID := uint64(1); exitEventID <= uint64(transfersCount); exitEventID++ { - // send exit transaction to exit helper - err = cluster.Bridge.SendExitTransaction(exitHelper, exitEventID, childJSONRPC) - require.NoError(t, err) - } - - // assert that receiver's balances on RootERC20 smart contract are expected - for _, receiver := range receivers { - balance := erc20BalanceOf(t, types.StringToAddress(receiver), polybftCfg.Bridge.RootNativeERC20Addr, rootchainTxRelayer) - require.Equal(t, oldBalances[types.StringToAddress(receiver)].Add( - oldBalances[types.StringToAddress(receiver)], withdrawAmount), balance) - } - }) -} - -func TestE2E_Bridge_Transfers_WithRootTrackerPollInterval(t *testing.T) { - var ( - numBlockConfirmations = uint64(2) - epochSize = 30 - sprintSize = uint64(5) - rootPollInterval = 5 * time.Second - numberOfAttempts = uint64(4) - stateSyncedLogsCount = 1 - ) - - cluster := framework.NewTestCluster(t, 5, - framework.WithEpochSize(epochSize), - framework.WithNumBlockConfirmations(numBlockConfirmations), - framework.WithRootTrackerPollInterval(rootPollInterval), - framework.WithTestRewardToken(), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - validatorSrv := cluster.Servers[0] - senderAccount, err := sidechain.GetAccountFromDir(validatorSrv.DataDir()) - require.NoError(t, err) - - childEthEndpoint := validatorSrv.JSONRPC().Eth() - - // bridge some tokens for first validator to child chain - tokensToDeposit := ethgo.Ether(10) - - require.NoError(t, cluster.Bridge.Deposit( - common.ERC20, - polybftCfg.Bridge.RootNativeERC20Addr, - polybftCfg.Bridge.RootERC20PredicateAddr, - rootHelper.TestAccountPrivKey, - senderAccount.Address().String(), - tokensToDeposit.String(), - "", - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false), - ) - - // wait for a couple of sprints - finalBlockNum := 5 * sprintSize - - // the transaction is processed and there should be a success event - var stateSyncedResult contractsapi.StateSyncResultEvent - - for i := uint64(0); i < numberOfAttempts; i++ { - logs, err := getFilteredLogs(stateSyncedResult.Sig(), 0, finalBlockNum+i*sprintSize, childEthEndpoint) - require.NoError(t, err) - - if len(logs) == stateSyncedLogsCount || i == numberOfAttempts-1 { - // assert that all deposits are executed successfully - checkStateSyncResultLogs(t, logs, stateSyncedLogsCount) - - break - } - - require.NoError(t, cluster.WaitForBlock(finalBlockNum+(i+1)*sprintSize, 2*time.Minute)) - } - - // check validator balance got increased by deposited amount - balance, err := childEthEndpoint.GetBalance(ethgo.Address(senderAccount.Address()), ethgo.Latest) - require.NoError(t, err) - - // because we premined the validators - expectedBalance := new(big.Int).Add(command.DefaultPremineBalance, tokensToDeposit) - require.Equal(t, expectedBalance, balance) -} - -func TestE2E_Bridge_NonMintableERC20Token_WithPremine(t *testing.T) { - var ( - numBlockConfirmations = uint64(2) - epochSize = 10 - sprintSize = uint64(5) - numberOfAttempts = uint64(4) - stateSyncedLogsCount = 2 - exitEventsCount = uint64(2) - tokensToTransfer = ethgo.Gwei(10) - bigZero = big.NewInt(0) - ) - - nonValidatorKey, err := wallet.GenerateKey() - require.NoError(t, err) - - nonValidatorKeyRaw, err := nonValidatorKey.MarshallPrivateKey() - require.NoError(t, err) - - // start cluster with default, non-mintable native erc20 root token - // with london fork enabled - cluster := framework.NewTestCluster(t, 5, - framework.WithEpochSize(epochSize), - framework.WithNumBlockConfirmations(numBlockConfirmations), - // this enables London (EIP-1559) fork - framework.WithBurnContract(&polybft.BurnContractInfo{ - BlockNumber: 0, - Address: types.StringToAddress("0xBurnContractAddress")}), - framework.WithTestRewardToken(), - framework.WithSecretsCallback(func(_ []types.Address, tcc *framework.TestClusterConfig) { - nonValidatorKeyString := hex.EncodeToString(nonValidatorKeyRaw) - - // do premine to a non validator address - tcc.Premine = append(tcc.Premine, - fmt.Sprintf("%s:%s:%s", - nonValidatorKey.Address(), - command.DefaultPremineBalance.String(), - nonValidatorKeyString)) - }), - ) - - rootchainTxRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - childEthEndpoint := cluster.Servers[0].JSONRPC().Eth() - - defer cluster.Stop() - - cluster.WaitForReady(t) - - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - checkBalancesFn := func(address types.Address, rootExpected, childExpected *big.Int) { - t.Log("Checking balance of native ERC20 token on root and child", "Address", address, - "Root expected", rootExpected, "Child Expected", childExpected) - - balance := erc20BalanceOf(t, address, - polybftCfg.Bridge.RootNativeERC20Addr, rootchainTxRelayer) - t.Log("Balance of native ERC20 token on root", balance, "Address", address) - require.Equal(t, rootExpected, balance) - - balance, err = childEthEndpoint.GetBalance(ethgo.Address(address), ethgo.Latest) - require.NoError(t, err) - t.Log("Balance of native ERC20 token on child", balance, "Address", address) - require.True(t, balance.Cmp(childExpected) >= 0) // because of London fork - } - - t.Run("check the balances at the beginning", func(t *testing.T) { - // check the balances on root and child at the beginning to see if they are as expected - checkBalancesFn(types.Address(nonValidatorKey.Address()), bigZero, command.DefaultPremineBalance) - - for _, server := range cluster.Servers { - validatorAccount, err := sidechain.GetAccountFromDir(server.DataDir()) - require.NoError(t, err) - - checkBalancesFn(validatorAccount.Address(), bigZero, command.DefaultPremineBalance) - } - }) - - // this test case will check first if they can withdraw some of the premined amount of non-mintable token - t.Run("Do a withdraw for premined validator address and premined non-validator address", func(t *testing.T) { - validatorSrv := cluster.Servers[1] - validatorAcc, err := sidechain.GetAccountFromDir(validatorSrv.DataDir()) - require.NoError(t, err) - - validatorRawKey, err := validatorAcc.Ecdsa.MarshallPrivateKey() - require.NoError(t, err) - - err = cluster.Bridge.Withdraw( - common.ERC20, - hex.EncodeToString(validatorRawKey), - validatorAcc.Address().String(), - tokensToTransfer.String(), - "", - validatorSrv.JSONRPCAddr(), - contracts.ChildERC20PredicateContract, - contracts.NativeERC20TokenContract, - false) - require.NoError(t, err) - - validatorBalanceAfterWithdraw, err := childEthEndpoint.GetBalance( - ethgo.Address(validatorAcc.Address()), ethgo.Latest) - require.NoError(t, err) - - err = cluster.Bridge.Withdraw( - common.ERC20, - hex.EncodeToString(nonValidatorKeyRaw), - nonValidatorKey.Address().String(), - tokensToTransfer.String(), - "", - validatorSrv.JSONRPCAddr(), - contracts.ChildERC20PredicateContract, - contracts.NativeERC20TokenContract, - false) - require.NoError(t, err) - - nonValidatorBalanceAfterWithdraw, err := childEthEndpoint.GetBalance( - nonValidatorKey.Address(), ethgo.Latest) - require.NoError(t, err) - - currentBlock, err := childEthEndpoint.GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - currentExtra, err := polybft.GetIbftExtra(currentBlock.ExtraData) - require.NoError(t, err) - - t.Logf("Latest block number: %d, epoch number: %d\n", currentBlock.Number, currentExtra.Checkpoint.EpochNumber) - - currentEpoch := currentExtra.Checkpoint.EpochNumber - - exitHelper := polybftCfg.Bridge.ExitHelperAddr - childJSONRPC := validatorSrv.JSONRPCAddr() - - successfulExitTransactions := make([]bool, exitEventsCount) - - for i := uint64(0); i < numberOfAttempts; i++ { - t.Log("Number of attempts: ", i+1) - - require.NoError(t, waitForRootchainEpoch(currentEpoch+i, 3*time.Minute, - rootchainTxRelayer, polybftCfg.Bridge.CheckpointManagerAddr)) - - for exitEventID := uint64(1); exitEventID <= exitEventsCount; exitEventID++ { - if successfulExitTransactions[exitEventID-1] { - continue - } - - // send exit transaction to exit helper - if err = cluster.Bridge.SendExitTransaction(exitHelper, exitEventID, childJSONRPC); err == nil { - successfulExitTransactions[exitEventID-1] = true - - continue - } - - if i == numberOfAttempts-1 { - require.NoError(t, err) - } - } - - allExitsSuccessfull := true - for _, isSuccessfull := range successfulExitTransactions { - if !isSuccessfull { - allExitsSuccessfull = false - - break - } - } - - if allExitsSuccessfull { - break - } - } - - // assert that receiver's balances on RootERC20 smart contract are expected - checkBalancesFn(validatorAcc.Address(), tokensToTransfer, validatorBalanceAfterWithdraw) - checkBalancesFn(types.Address(nonValidatorKey.Address()), tokensToTransfer, nonValidatorBalanceAfterWithdraw) - }) - - t.Run("Do a deposit to some validator and non-validator address", func(t *testing.T) { - validatorSrv := cluster.Servers[4] - validatorAcc, err := sidechain.GetAccountFromDir(validatorSrv.DataDir()) - require.NoError(t, err) - - require.NoError(t, cluster.Bridge.Deposit( - common.ERC20, - polybftCfg.Bridge.RootNativeERC20Addr, - polybftCfg.Bridge.RootERC20PredicateAddr, - rootHelper.TestAccountPrivKey, - strings.Join([]string{validatorAcc.Address().String(), nonValidatorKey.Address().String()}, ","), - strings.Join([]string{tokensToTransfer.String(), tokensToTransfer.String()}, ","), - "", - cluster.Bridge.JSONRPCAddr(), - rootHelper.TestAccountPrivKey, - false), - ) - - currentBlock, err := childEthEndpoint.GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - // wait for a couple of sprints - finalBlockNum := currentBlock.Number + 5*sprintSize - - // the transaction is processed and there should be a success event - var stateSyncedResult contractsapi.StateSyncResultEvent - - for i := uint64(0); i < numberOfAttempts; i++ { - logs, err := getFilteredLogs(stateSyncedResult.Sig(), 0, finalBlockNum+i*sprintSize, childEthEndpoint) - require.NoError(t, err) - - if len(logs) == stateSyncedLogsCount || i == numberOfAttempts-1 { - // assert that all deposits are executed successfully - checkStateSyncResultLogs(t, logs, stateSyncedLogsCount) - - break - } - - require.NoError(t, cluster.WaitForBlock(finalBlockNum+(i+1)*sprintSize, 2*time.Minute)) - } - }) -} diff --git a/e2e-polybft/e2e/burn_contract_test.go b/e2e-polybft/e2e/burn_contract_test.go deleted file mode 100644 index 04cb783..0000000 --- a/e2e-polybft/e2e/burn_contract_test.go +++ /dev/null @@ -1,38 +0,0 @@ -package e2e - -import ( - "testing" - - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/wallet" - - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - "github.com/xgr-network/xgr-node/types" -) - -func TestE2E_BurnContract_Deployed(t *testing.T) { - contractKey, _ := wallet.GenerateKey() - destinationKey, _ := wallet.GenerateKey() - - contractAddr := types.Address(contractKey.Address()) - destinationAddr := types.Address(destinationKey.Address()) - - cluster := framework.NewTestCluster(t, 5, - framework.WithTestRewardToken(), - framework.WithBurnContract(&polybft.BurnContractInfo{ - Address: contractAddr, - DestinationAddress: destinationAddr, - }), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - client := cluster.Servers[0].JSONRPC().Eth() - - // Get the code for the default deployed burn contract - code, err := client.GetCode(ethgo.Address(contractAddr), ethgo.Latest) - require.NoError(t, err) - require.NotEqual(t, code, "0x") -} diff --git a/e2e-polybft/e2e/consensus_test.go b/e2e-polybft/e2e/consensus_test.go deleted file mode 100644 index 8a86ee3..0000000 --- a/e2e-polybft/e2e/consensus_test.go +++ /dev/null @@ -1,749 +0,0 @@ -package e2e - -import ( - "fmt" - "math/big" - "path" - "strconv" - "sync" - "testing" - "time" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/ethgo/wallet" - - "github.com/xgr-network/xgr-node/command" - "github.com/xgr-network/xgr-node/command/genesis" - "github.com/xgr-network/xgr-node/command/sidechain" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -var uint256ABIType = abi.MustNewType("tuple(uint256)") - -func TestE2E_Consensus_Basic_WithNonValidators(t *testing.T) { - const ( - epochSize = 4 - validatorsNum = 5 - ) - - cluster := framework.NewTestCluster(t, validatorsNum, - framework.WithEpochSize(epochSize), - framework.WithNonValidators(2), - framework.WithTestRewardToken(), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - // initialize tx relayer - relayer, err := txrelayer.NewTxRelayer(txrelayer.WithClient(cluster.Servers[0].JSONRPC())) - require.NoError(t, err) - - // because we are pre-mining native tokens to validators - initialTotalSupply := new(big.Int).Mul(big.NewInt(validatorsNum), command.DefaultPremineBalance) - - // check if initial total supply of native ERC20 token is the same as expected - totalSupply := queryNativeERC20Metadata(t, "totalSupply", uint256ABIType, relayer) - require.True(t, initialTotalSupply.Cmp(totalSupply.(*big.Int)) == 0) //nolint:forcetypeassert - - t.Run("consensus protocol", func(t *testing.T) { - require.NoError(t, cluster.WaitForBlock(2*epochSize+1, 1*time.Minute)) - }) - - t.Run("sync protocol, drop single validator node", func(t *testing.T) { - // query the current block number, as it is a starting point for the test - currentBlockNum, err := cluster.Servers[0].JSONRPC().Eth().BlockNumber() - require.NoError(t, err) - - // stop one node - node := cluster.Servers[0] - node.Stop() - - // wait for 2 epochs to elapse, so that rest of the network progresses - require.NoError(t, cluster.WaitForBlock(currentBlockNum+2*epochSize, 2*time.Minute)) - - // start the node again - node.Start() - - // wait 2 more epochs to elapse and make sure that stopped node managed to catch up - require.NoError(t, cluster.WaitForBlock(currentBlockNum+4*epochSize, 2*time.Minute)) - }) - - t.Run("sync protocol, drop single non-validator node", func(t *testing.T) { - // query the current block number, as it is a starting point for the test - currentBlockNum, err := cluster.Servers[0].JSONRPC().Eth().BlockNumber() - require.NoError(t, err) - - // stop one non-validator node - node := cluster.Servers[6] - node.Stop() - - // wait for 2 epochs to elapse, so that rest of the network progresses - require.NoError(t, cluster.WaitForBlock(currentBlockNum+2*epochSize, 2*time.Minute)) - - // start the node again - node.Start() - - // wait 2 more epochs to elapse and make sure that stopped node managed to catch up - require.NoError(t, cluster.WaitForBlock(currentBlockNum+4*epochSize, 2*time.Minute)) - }) -} - -func TestE2E_Consensus_BulkDrop(t *testing.T) { - const ( - clusterSize = 5 - bulkToDrop = 4 - epochSize = 5 - ) - - cluster := framework.NewTestCluster(t, clusterSize, - framework.WithEpochSize(epochSize), - framework.WithBlockTime(time.Second), - framework.WithTestRewardToken(), - ) - defer cluster.Stop() - - // wait for cluster to start - cluster.WaitForReady(t) - - var wg sync.WaitGroup - // drop bulk of nodes from cluster - for i := 0; i < bulkToDrop; i++ { - node := cluster.Servers[i] - - wg.Add(1) - - go func(node *framework.TestServer) { - defer wg.Done() - node.Stop() - }(node) - } - - wg.Wait() - - // start dropped nodes again - for i := 0; i < bulkToDrop; i++ { - node := cluster.Servers[i] - node.Start() - } - - // wait to proceed to the 2nd epoch - require.NoError(t, cluster.WaitForBlock(epochSize+1, 2*time.Minute)) -} - -func TestE2E_Consensus_RegisterValidator(t *testing.T) { - const ( - validatorSetSize = 5 - epochSize = 5 - ) - - var ( - firstValidatorDataDir = fmt.Sprintf("test-chain-%d", validatorSetSize+1) // directory where the first validator secrets will be stored - secondValidatorDataDir = fmt.Sprintf("test-chain-%d", validatorSetSize+2) // directory where the second validator secrets will be stored - - initMinterBalance = ethgo.Ether(4e6) - premineBalance = ethgo.Ether(2e6) // 2M native tokens (so that we have enough balance to fund new validator) - ) - - minter, err := wallet.GenerateKey() - require.NoError(t, err) - - // start cluster with 'validatorSize' validators - cluster := framework.NewTestCluster(t, validatorSetSize, - framework.WithEpochSize(epochSize), - framework.WithEpochReward(int(ethgo.Ether(1).Uint64())), - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, minter.Address())), - framework.WithSecretsCallback(func(addresses []types.Address, config *framework.TestClusterConfig) { - config.Premine = append(config.Premine, fmt.Sprintf("%s:%s", minter.Address(), initMinterBalance)) - for _, a := range addresses { - config.Premine = append(config.Premine, fmt.Sprintf("%s:%s", a, premineBalance)) - } - }), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - // first validator is the owner of ChildValidator set smart contract - owner := cluster.Servers[0] - childChainRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(owner.JSONRPCAddr())) - require.NoError(t, err) - - rootChainRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - polybftConfig, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - // create the first account and extract the address - addrs, err := cluster.InitSecrets(firstValidatorDataDir, 1) - require.NoError(t, err) - - firstValidatorAddr := ethgo.Address(addrs[0]) - - // create the second account and extract the address - addrs, err = cluster.InitSecrets(secondValidatorDataDir, 1) - require.NoError(t, err) - - secondValidatorAddr := ethgo.Address(addrs[0]) - - // assert that accounts are created - validatorSecrets, err := genesis.GetValidatorKeyFiles(cluster.Config.TmpDir, cluster.Config.ValidatorPrefix) - require.NoError(t, err) - require.Equal(t, validatorSetSize+2, len(validatorSecrets)) - - // collect owners validator secrets - firstValidatorSecrets := validatorSecrets[validatorSetSize] - secondValidatorSecrets := validatorSecrets[validatorSetSize+1] - - genesisBlock, err := owner.JSONRPC().Eth().GetBlockByNumber(0, false) - require.NoError(t, err) - - _, err = polybft.GetIbftExtra(genesisBlock.ExtraData) - require.NoError(t, err) - - // owner whitelists both new validators - require.NoError(t, owner.WhitelistValidators([]string{ - firstValidatorAddr.String(), - secondValidatorAddr.String(), - }, polybftConfig.Bridge.CustomSupernetManagerAddr)) - - // set the initial balance of the new validators at the rootchain - initialBalance := ethgo.Ether(500) - - // fund first new validator - err = cluster.Bridge.FundValidators(polybftConfig.Bridge.StakeTokenAddr, - []string{path.Join(cluster.Config.TmpDir, firstValidatorSecrets)}, []*big.Int{initialBalance}) - require.NoError(t, err) - - // fund second new validator - err = cluster.Bridge.FundValidators(polybftConfig.Bridge.StakeTokenAddr, - []string{path.Join(cluster.Config.TmpDir, secondValidatorSecrets)}, []*big.Int{initialBalance}) - require.NoError(t, err) - - // first validator's balance to be received - firstBalance, err := rootChainRelayer.Client().Eth().GetBalance(firstValidatorAddr, ethgo.Latest) - require.NoError(t, err) - t.Logf("First validator balance=%d\n", firstBalance) - - // second validator's balance to be received - secondBalance, err := rootChainRelayer.Client().Eth().GetBalance(secondValidatorAddr, ethgo.Latest) - require.NoError(t, err) - t.Logf("Second validator balance=%d\n", secondBalance) - - // start the first and the second validator - cluster.InitTestServer(t, cluster.Config.ValidatorPrefix+strconv.Itoa(validatorSetSize+1), - cluster.Bridge.JSONRPCAddr(), framework.Validator) - - cluster.InitTestServer(t, cluster.Config.ValidatorPrefix+strconv.Itoa(validatorSetSize+2), - cluster.Bridge.JSONRPCAddr(), framework.Validator) - - // collect the first and the second validator from the cluster - firstValidator := cluster.Servers[validatorSetSize] - secondValidator := cluster.Servers[validatorSetSize+1] - - initialStake := ethgo.Ether(499) - - // register the first validator with stake - require.NoError(t, firstValidator.RegisterValidator(polybftConfig.Bridge.CustomSupernetManagerAddr)) - - // register the second validator without stake - require.NoError(t, secondValidator.RegisterValidator(polybftConfig.Bridge.CustomSupernetManagerAddr)) - - // stake manually for the first validator - require.NoError(t, firstValidator.Stake(polybftConfig, initialStake)) - - // stake manually for the second validator - require.NoError(t, secondValidator.Stake(polybftConfig, initialStake)) - - firstValidatorInfo, err := sidechain.GetValidatorInfo(firstValidatorAddr, - polybftConfig.Bridge.CustomSupernetManagerAddr, polybftConfig.Bridge.StakeManagerAddr, - polybftConfig.SupernetID, rootChainRelayer, childChainRelayer) - require.NoError(t, err) - require.True(t, firstValidatorInfo.IsActive) - require.True(t, firstValidatorInfo.Stake.Cmp(initialStake) == 0) - - secondValidatorInfo, err := sidechain.GetValidatorInfo(secondValidatorAddr, - polybftConfig.Bridge.CustomSupernetManagerAddr, polybftConfig.Bridge.StakeManagerAddr, - polybftConfig.SupernetID, rootChainRelayer, childChainRelayer) - require.NoError(t, err) - require.True(t, secondValidatorInfo.IsActive) - require.True(t, secondValidatorInfo.Stake.Cmp(initialStake) == 0) - - // wait for the stake to be bridged - require.NoError(t, cluster.WaitForBlock(polybftConfig.EpochSize*4, time.Minute)) - - checkpointManagerAddr := ethgo.Address(polybftConfig.Bridge.CheckpointManagerAddr) - - // check if the validators are added to active validator set - rootchainValidators := []*polybft.ValidatorInfo{} - err = cluster.Bridge.WaitUntil(time.Second, time.Minute, func() (bool, error) { - rootchainValidators, err = getCheckpointManagerValidators(rootChainRelayer, checkpointManagerAddr) - if err != nil { - return true, err - } - - return len(rootchainValidators) == validatorSetSize+2, nil - }) - - require.NoError(t, err) - require.Equal(t, validatorSetSize+2, len(rootchainValidators)) - - var ( - isFirstValidatorFound bool - isSecondValidatorFound bool - ) - - for _, v := range rootchainValidators { - if v.Address == firstValidatorAddr { - isFirstValidatorFound = true - } else if v.Address == secondValidatorAddr { - isSecondValidatorFound = true - } - } - - // new validators should be in the active validator set - require.True(t, isFirstValidatorFound) - require.True(t, isSecondValidatorFound) - - currentBlock, err := owner.JSONRPC().Eth().GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - // wait for couple of epochs to have some rewards accumulated - require.NoError(t, cluster.WaitForBlock(currentBlock.Number+(polybftConfig.EpochSize*2), time.Minute)) - - bigZero := big.NewInt(0) - - firstValidatorInfo, err = sidechain.GetValidatorInfo(firstValidatorAddr, - polybftConfig.Bridge.CustomSupernetManagerAddr, polybftConfig.Bridge.StakeManagerAddr, - polybftConfig.SupernetID, rootChainRelayer, childChainRelayer) - require.NoError(t, err) - require.True(t, firstValidatorInfo.IsActive) - require.True(t, firstValidatorInfo.WithdrawableRewards.Cmp(bigZero) > 0) - - secondValidatorInfo, err = sidechain.GetValidatorInfo(secondValidatorAddr, - polybftConfig.Bridge.CustomSupernetManagerAddr, polybftConfig.Bridge.StakeManagerAddr, - polybftConfig.SupernetID, rootChainRelayer, childChainRelayer) - require.NoError(t, err) - require.True(t, secondValidatorInfo.IsActive) - require.True(t, secondValidatorInfo.WithdrawableRewards.Cmp(bigZero) > 0) -} - -func TestE2E_Consensus_Validator_Unstake(t *testing.T) { - var ( - premineAmount = ethgo.Ether(10) - minterBalance = ethgo.Ether(1e6) - ) - - minter, err := wallet.GenerateKey() - require.NoError(t, err) - - cluster := framework.NewTestCluster(t, 5, - framework.WithEpochReward(int(ethgo.Ether(1).Uint64())), - framework.WithEpochSize(5), - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, minter.Address())), - framework.WithSecretsCallback(func(addresses []types.Address, config *framework.TestClusterConfig) { - config.Premine = append(config.Premine, fmt.Sprintf("%s:%d", minter.Address(), minterBalance)) - for _, a := range addresses { - config.Premine = append(config.Premine, fmt.Sprintf("%s:%d", a, premineAmount)) - config.StakeAmounts = append(config.StakeAmounts, new(big.Int).Set(premineAmount)) - } - }), - ) - - polybftCfg, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - srv := cluster.Servers[0] - - childChainRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(srv.JSONRPCAddr())) - require.NoError(t, err) - - rootChainRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - validatorAcc, err := sidechain.GetAccountFromDir(srv.DataDir()) - require.NoError(t, err) - - cluster.WaitForReady(t) - - initialValidatorBalance, err := srv.JSONRPC().Eth().GetBalance(validatorAcc.Ecdsa.Address(), ethgo.Latest) - require.NoError(t, err) - t.Logf("Balance (before unstake)=%d\n", initialValidatorBalance) - - validatorAddr := validatorAcc.Ecdsa.Address() - - // wait for some rewards to get accumulated - require.NoError(t, cluster.WaitForBlock(polybftCfg.EpochSize*3, time.Minute)) - - validatorInfo, err := sidechain.GetValidatorInfo(validatorAddr, - polybftCfg.Bridge.CustomSupernetManagerAddr, polybftCfg.Bridge.StakeManagerAddr, - polybftCfg.SupernetID, rootChainRelayer, childChainRelayer) - require.NoError(t, err) - require.True(t, validatorInfo.IsActive) - - initialStake := validatorInfo.Stake - t.Logf("Stake (before unstake)=%d\n", initialStake) - - reward := validatorInfo.WithdrawableRewards - t.Logf("Rewards=%d\n", reward) - require.Greater(t, reward.Uint64(), uint64(0)) - - // unstake entire balance (which should remove validator from the validator set in next epoch) - require.NoError(t, srv.Unstake(initialStake)) - - // wait for one epoch to withdraw from child - require.NoError(t, cluster.WaitForBlock(polybftCfg.EpochSize*4, time.Minute)) - - // withdraw from child - require.NoError(t, srv.WithdrawChildChain()) - - currentBlock, err := srv.JSONRPC().Eth().GetBlockByNumber(ethgo.Latest, false) - require.NoError(t, err) - - currentExtra, err := polybft.GetIbftExtra(currentBlock.ExtraData) - require.NoError(t, err) - - t.Logf("Latest block number: %d, epoch number: %d\n", currentBlock.Number, currentExtra.Checkpoint.EpochNumber) - - currentEpoch := currentExtra.Checkpoint.EpochNumber - - // wait for checkpoint to be submitted - require.NoError(t, waitForRootchainEpoch(currentEpoch, time.Minute, - rootChainRelayer, polybftCfg.Bridge.CheckpointManagerAddr)) - - exitEventID := uint64(1) - - // send exit transaction to exit helper - err = cluster.Bridge.SendExitTransaction(polybftCfg.Bridge.ExitHelperAddr, exitEventID, srv.JSONRPCAddr()) - require.NoError(t, err) - - // check that validator is no longer active (out of validator set) - validatorInfo, err = sidechain.GetValidatorInfo(validatorAddr, - polybftCfg.Bridge.CustomSupernetManagerAddr, polybftCfg.Bridge.StakeManagerAddr, - polybftCfg.SupernetID, rootChainRelayer, childChainRelayer) - require.NoError(t, err) - require.False(t, validatorInfo.IsActive) - require.True(t, validatorInfo.Stake.Cmp(big.NewInt(0)) == 0) - - t.Logf("Stake (after unstake)=%d\n", validatorInfo.Stake) - - balanceBeforeRewardsWithdraw, err := srv.JSONRPC().Eth().GetBalance(validatorAcc.Ecdsa.Address(), ethgo.Latest) - require.NoError(t, err) - t.Logf("Balance (before withdraw rewards)=%d\n", balanceBeforeRewardsWithdraw) - - // withdraw pending rewards - require.NoError(t, srv.WithdrawRewards()) - - newValidatorBalance, err := srv.JSONRPC().Eth().GetBalance(validatorAcc.Ecdsa.Address(), ethgo.Latest) - require.NoError(t, err) - t.Logf("Balance (after withdrawal of rewards)=%s\n", newValidatorBalance) - require.True(t, newValidatorBalance.Cmp(balanceBeforeRewardsWithdraw) > 0) - - l1Relayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - checkpointManagerAddr := ethgo.Address(polybftCfg.Bridge.CheckpointManagerAddr) - - // query rootchain validator set and make sure that validator which unstaked all the funds isn't present in validator set anymore - // (execute it multiple times if needed, because it is unknown in advance how much time it is going to take until checkpoint is submitted) - rootchainValidators := []*polybft.ValidatorInfo{} - err = cluster.Bridge.WaitUntil(time.Second, 10*time.Second, func() (bool, error) { - rootchainValidators, err = getCheckpointManagerValidators(l1Relayer, checkpointManagerAddr) - if err != nil { - return true, err - } - - return len(rootchainValidators) == 4, nil - }) - require.NoError(t, err) - require.Equal(t, 4, len(rootchainValidators)) - - for _, validator := range rootchainValidators { - if validator.Address == validatorAddr { - t.Fatalf("not expected to find validator %v in the current validator set", validator.Address) - } - } -} - -func TestE2E_Consensus_MintableERC20NativeToken(t *testing.T) { - const ( - validatorCount = 5 - epochSize = 5 - - tokenName = "Edge Coin" - tokenSymbol = "EDGE" - decimals = uint8(5) - ) - - validatorsAddrs := make([]types.Address, validatorCount) - initValidatorsBalance := ethgo.Ether(1) - initMinterBalance := ethgo.Ether(100000) - - minter, err := wallet.GenerateKey() - require.NoError(t, err) - - // because we are using native token as reward wallet, and it has default premine balance - initialTotalSupply := new(big.Int).Set(command.DefaultPremineBalance) - - cluster := framework.NewTestCluster(t, - validatorCount, - framework.WithNativeTokenConfig( - fmt.Sprintf("%s:%s:%d:true:%s", tokenName, tokenSymbol, decimals, minter.Address())), - framework.WithEpochSize(epochSize), - framework.WithSecretsCallback(func(addrs []types.Address, config *framework.TestClusterConfig) { - config.Premine = append(config.Premine, fmt.Sprintf("%s:%d", minter.Address(), initMinterBalance)) - initialTotalSupply.Add(initialTotalSupply, initMinterBalance) - - for i, addr := range addrs { - config.Premine = append(config.Premine, fmt.Sprintf("%s:%d", addr, initValidatorsBalance)) - config.StakeAmounts = append(config.StakeAmounts, new(big.Int).Set(initValidatorsBalance)) - validatorsAddrs[i] = addr - initialTotalSupply.Add(initialTotalSupply, initValidatorsBalance) - } - })) - defer cluster.Stop() - - targetJSONRPC := cluster.Servers[0].JSONRPC() - - cluster.WaitForReady(t) - - // initialize tx relayer - relayer, err := txrelayer.NewTxRelayer(txrelayer.WithClient(targetJSONRPC)) - require.NoError(t, err) - - // check are native token metadata correctly initialized - stringABIType := abi.MustNewType("tuple(string)") - uint8ABIType := abi.MustNewType("tuple(uint8)") - - totalSupply := queryNativeERC20Metadata(t, "totalSupply", uint256ABIType, relayer) - require.True(t, initialTotalSupply.Cmp(totalSupply.(*big.Int)) == 0) //nolint:forcetypeassert - - // check if initial total supply of native ERC20 token is the same as expected - name := queryNativeERC20Metadata(t, "name", stringABIType, relayer) - require.Equal(t, tokenName, name) - - symbol := queryNativeERC20Metadata(t, "symbol", stringABIType, relayer) - require.Equal(t, tokenSymbol, symbol) - - decimalsCount := queryNativeERC20Metadata(t, "decimals", uint8ABIType, relayer) - require.Equal(t, decimals, decimalsCount) - - // send mint transactions - mintFn, exists := contractsapi.NativeERC20Mintable.Abi.Methods["mint"] - require.True(t, exists) - - mintAmount := ethgo.Ether(10) - nativeTokenAddr := ethgo.Address(contracts.NativeERC20TokenContract) - - // make sure minter account can mint tokens - for _, addr := range validatorsAddrs { - balance, err := targetJSONRPC.Eth().GetBalance(ethgo.Address(addr), ethgo.Latest) - require.NoError(t, err) - t.Logf("Pre-mint balance: %v=%d\n", addr, balance) - - mintInput, err := mintFn.Encode([]interface{}{addr, mintAmount}) - require.NoError(t, err) - - receipt, err := relayer.SendTransaction( - ðgo.Transaction{ - To: &nativeTokenAddr, - Input: mintInput, - Type: ethgo.TransactionDynamicFee, - }, minter) - require.NoError(t, err) - require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) - - balance, err = targetJSONRPC.Eth().GetBalance(ethgo.Address(addr), ethgo.Latest) - require.NoError(t, err) - - t.Logf("Post-mint balance: %v=%d\n", addr, balance) - require.Equal(t, new(big.Int).Add(initValidatorsBalance, mintAmount), balance) - } - - // assert that minter balance remained the same - minterBalance, err := targetJSONRPC.Eth().GetBalance(minter.Address(), ethgo.Latest) - require.NoError(t, err) - require.Equal(t, initMinterBalance, minterBalance) - - // try sending mint transaction from non minter account and make sure it would fail - nonMinterAcc, err := sidechain.GetAccountFromDir(cluster.Servers[1].DataDir()) - require.NoError(t, err) - - mintInput, err := mintFn.Encode([]interface{}{validatorsAddrs[0], ethgo.Ether(1)}) - require.NoError(t, err) - - receipt, err := relayer.SendTransaction( - ðgo.Transaction{ - To: &nativeTokenAddr, - Input: mintInput, - Type: ethgo.TransactionDynamicFee, - }, nonMinterAcc.Ecdsa) - require.Error(t, err) - require.Nil(t, receipt) -} - -func TestE2E_Consensus_CustomRewardToken(t *testing.T) { - const epochSize = 5 - - cluster := framework.NewTestCluster(t, 5, - framework.WithEpochSize(epochSize), - framework.WithEpochReward(1000000), - framework.WithTestRewardToken(), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - // wait for couple of epochs to accumulate some rewards - require.NoError(t, cluster.WaitForBlock(epochSize*3, 3*time.Minute)) - - // first validator is the owner of ChildValidator set smart contract - owner := cluster.Servers[0] - childChainRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(owner.JSONRPCAddr())) - require.NoError(t, err) - - rootChainRelayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Bridge.JSONRPCAddr())) - require.NoError(t, err) - - polybftConfig, err := polybft.LoadPolyBFTConfig(path.Join(cluster.Config.TmpDir, chainConfigFileName)) - require.NoError(t, err) - - validatorAcc, err := sidechain.GetAccountFromDir(owner.DataDir()) - require.NoError(t, err) - - validatorInfo, err := sidechain.GetValidatorInfo(validatorAcc.Ecdsa.Address(), - polybftConfig.Bridge.CustomSupernetManagerAddr, polybftConfig.Bridge.StakeManagerAddr, - polybftConfig.SupernetID, rootChainRelayer, childChainRelayer) - t.Logf("[Validator#%v] Witdhrawable rewards=%d\n", validatorInfo.Address, validatorInfo.WithdrawableRewards) - - require.NoError(t, err) - require.True(t, validatorInfo.WithdrawableRewards.Cmp(big.NewInt(0)) > 0) -} - -// TestE2E_Consensus_EIP1559Check sends a legacy and a dynamic tx to the cluster -// and check if balance of sender, receiver, burn contract and miner is updates correctly -// in accordance with EIP-1559 specifications -func TestE2E_Consensus_EIP1559Check(t *testing.T) { - sender1, err := wallet.GenerateKey() - require.NoError(t, err) - - sender2, err := wallet.GenerateKey() - require.NoError(t, err) - - recipientKey, err := wallet.GenerateKey() - require.NoError(t, err) - - recipient := recipientKey.Address() - - // first account should have some matics premined - cluster := framework.NewTestCluster(t, 5, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, sender1.Address())), - framework.WithPremine(types.Address(sender1.Address()), types.Address(sender2.Address())), - framework.WithBurnContract(&polybft.BurnContractInfo{BlockNumber: 0, Address: types.ZeroAddress}), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - client := cluster.Servers[0].JSONRPC().Eth() - - waitUntilBalancesChanged := func(acct ethgo.Address, bal *big.Int) error { - err := cluster.WaitUntil(30*time.Second, 2*time.Second, func() bool { - balance, err := client.GetBalance(recipient, ethgo.Latest) - if err != nil { - return true - } - - return balance.Cmp(bal) > 0 - }) - - return err - } - - relayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Servers[0].JSONRPCAddr())) - require.NoError(t, err) - - // create and send tx - sendAmount := ethgo.Gwei(1) - - txn := []*ethgo.Transaction{ - { - Value: sendAmount, - To: &recipient, - Gas: 21000, - Nonce: uint64(0), - GasPrice: ethgo.Gwei(1).Uint64(), - }, - { - Value: sendAmount, - To: &recipient, - Gas: 21000, - Nonce: uint64(0), - Type: ethgo.TransactionDynamicFee, - MaxFeePerGas: ethgo.Gwei(1), - MaxPriorityFeePerGas: ethgo.Gwei(1), - }, - } - - initialMinerBalance := big.NewInt(0) - - var prevMiner ethgo.Address - - for i := 0; i < 2; i++ { - curTxn := txn[i] - - senderInitialBalance, _ := client.GetBalance(sender1.Address(), ethgo.Latest) - receiverInitialBalance, _ := client.GetBalance(recipient, ethgo.Latest) - burnContractInitialBalance, _ := client.GetBalance(ethgo.Address(types.ZeroAddress), ethgo.Latest) - - receipt, err := relayer.SendTransaction(curTxn, sender1) - require.NoError(t, err) - - // wait for balance to get changed - err = waitUntilBalancesChanged(recipient, receiverInitialBalance) - require.NoError(t, err) - - // Retrieve the transaction receipt - txReceipt, err := client.GetTransactionByHash(receipt.TransactionHash) - require.NoError(t, err) - - block, _ := client.GetBlockByHash(txReceipt.BlockHash, true) - finalMinerFinalBalance, _ := client.GetBalance(block.Miner, ethgo.Latest) - - if i == 0 { - prevMiner = block.Miner - } - - senderFinalBalance, _ := client.GetBalance(sender1.Address(), ethgo.Latest) - receiverFinalBalance, _ := client.GetBalance(recipient, ethgo.Latest) - burnContractFinalBalance, _ := client.GetBalance(ethgo.Address(types.ZeroAddress), ethgo.Latest) - - diffReciverBalance := new(big.Int).Sub(receiverFinalBalance, receiverInitialBalance) - assert.Equal(t, sendAmount, diffReciverBalance, "Receiver balance should be increased by send amount") - - if i == 1 && prevMiner != block.Miner { - initialMinerBalance = big.NewInt(0) - } - - diffBurnContractBalance := new(big.Int).Sub(burnContractFinalBalance, burnContractInitialBalance) - diffSenderBalance := new(big.Int).Sub(senderInitialBalance, senderFinalBalance) - diffMinerBalance := new(big.Int).Sub(finalMinerFinalBalance, initialMinerBalance) - - diffSenderBalance.Sub(diffSenderBalance, diffReciverBalance) - diffSenderBalance.Sub(diffSenderBalance, diffBurnContractBalance) - diffSenderBalance.Sub(diffSenderBalance, diffMinerBalance) - - assert.Zero(t, diffSenderBalance.Int64(), "Sender balance should be decreased by send amount + gas") - - initialMinerBalance = finalMinerFinalBalance - } -} diff --git a/e2e-polybft/e2e/helpers_test.go b/e2e-polybft/e2e/helpers_test.go deleted file mode 100644 index 0732205..0000000 --- a/e2e-polybft/e2e/helpers_test.go +++ /dev/null @@ -1,347 +0,0 @@ -package e2e - -import ( - "bytes" - "encoding/json" - "errors" - "fmt" - "io" - "math/big" - "net/http" - "testing" - "time" - - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/ethgo/jsonrpc" - - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi/artifact" - "github.com/xgr-network/xgr-node/contracts" - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/helper/hex" - "github.com/xgr-network/xgr-node/state/runtime/addresslist" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -// getCheckpointManagerValidators queries rootchain validator set on CheckpointManager contract -func getCheckpointManagerValidators(relayer txrelayer.TxRelayer, checkpointManagerAddr ethgo.Address) ([]*polybft.ValidatorInfo, error) { - validatorsCountRaw, err := ABICall(relayer, contractsapi.CheckpointManager, - checkpointManagerAddr, ethgo.ZeroAddress, "currentValidatorSetLength") - if err != nil { - return nil, err - } - - validatorsCount, err := common.ParseUint64orHex(&validatorsCountRaw) - if err != nil { - return nil, err - } - - currentValidatorSetMethod := contractsapi.CheckpointManager.Abi.GetMethod("currentValidatorSet") - validators := make([]*polybft.ValidatorInfo, validatorsCount) - - for i := 0; i < int(validatorsCount); i++ { - validatorRaw, err := ABICall(relayer, contractsapi.CheckpointManager, - checkpointManagerAddr, ethgo.ZeroAddress, "currentValidatorSet", i) - if err != nil { - return nil, err - } - - validatorSetRaw, err := hex.DecodeString(validatorRaw[2:]) - if err != nil { - return nil, err - } - - decodedResults, err := currentValidatorSetMethod.Outputs.Decode(validatorSetRaw) - if err != nil { - return nil, err - } - - results, ok := decodedResults.(map[string]interface{}) - if !ok { - return nil, errors.New("failed to decode validator") - } - - //nolint:forcetypeassert - validators[i] = &polybft.ValidatorInfo{ - Address: results["_address"].(ethgo.Address), - Stake: results["votingPower"].(*big.Int), - } - } - - return validators, nil -} - -func ABICall(relayer txrelayer.TxRelayer, artifact *artifact.Artifact, contractAddress ethgo.Address, senderAddr ethgo.Address, method string, params ...interface{}) (string, error) { - input, err := artifact.Abi.GetMethod(method).Encode(params) - if err != nil { - return "", err - } - - return relayer.Call(senderAddr, contractAddress, input) -} - -func ABITransaction(relayer txrelayer.TxRelayer, key ethgo.Key, artifact *artifact.Artifact, contractAddress ethgo.Address, method string, params ...interface{}) (*ethgo.Receipt, error) { - input, err := artifact.Abi.GetMethod(method).Encode(params) - if err != nil { - return nil, err - } - - return relayer.SendTransaction(ðgo.Transaction{ - To: &contractAddress, - Input: input, - }, key) -} - -func getExitProof(rpcAddress string, exitID uint64) (types.Proof, error) { - query := struct { - Jsonrpc string `json:"jsonrpc"` - Method string `json:"method"` - Params []string `json:"params"` - ID int `json:"id"` - }{ - "2.0", - "bridge_generateExitProof", - []string{fmt.Sprintf("0x%x", exitID)}, - 1, - } - - d, err := json.Marshal(query) - if err != nil { - return types.Proof{}, err - } - - resp, err := http.Post(rpcAddress, "application/json", bytes.NewReader(d)) - if err != nil { - return types.Proof{}, err - } - - s, err := io.ReadAll(resp.Body) - if err != nil { - return types.Proof{}, err - } - - rspProof := struct { - Result types.Proof `json:"result"` - }{} - - err = json.Unmarshal(s, &rspProof) - if err != nil { - return types.Proof{}, err - } - - return rspProof.Result, nil -} - -// checkStateSyncResultLogs is helper function which parses given StateSyncResultEvent event's logs, -// extracts status topic value and makes assertions against it. -func checkStateSyncResultLogs( - t *testing.T, - logs []*ethgo.Log, - expectedCount int, -) { - t.Helper() - require.Equal(t, expectedCount, len(logs)) - - var stateSyncResultEvent contractsapi.StateSyncResultEvent - for _, log := range logs { - doesMatch, err := stateSyncResultEvent.ParseLog(log) - require.NoError(t, err) - require.True(t, doesMatch) - - t.Logf("Block Number=%d, Decoded Log=%+v\n", log.BlockNumber, stateSyncResultEvent) - - require.True(t, stateSyncResultEvent.Status) - } -} - -// getCheckpointBlockNumber gets current checkpoint block number from checkpoint manager smart contract -func getCheckpointBlockNumber(l1Relayer txrelayer.TxRelayer, checkpointManagerAddr ethgo.Address) (uint64, error) { - checkpointBlockNumRaw, err := ABICall(l1Relayer, contractsapi.CheckpointManager, - checkpointManagerAddr, ethgo.ZeroAddress, "currentCheckpointBlockNumber") - if err != nil { - return 0, err - } - - actualCheckpointBlock, err := common.ParseUint64orHex(&checkpointBlockNumRaw) - if err != nil { - return 0, err - } - - return actualCheckpointBlock, nil -} - -// waitForRootchainEpoch blocks for some predefined timeout to reach target epoch -func waitForRootchainEpoch(targetEpoch uint64, timeout time.Duration, - rootchainTxRelayer txrelayer.TxRelayer, checkpointManager types.Address) error { - timer := time.NewTimer(timeout) - defer timer.Stop() - - ticker := time.NewTicker(time.Second) - defer ticker.Stop() - - for { - select { - case <-timer.C: - return errors.New("root chain hasn't progressed to the desired epoch") - case <-ticker.C: - } - - rootchainEpochRaw, err := ABICall(rootchainTxRelayer, contractsapi.CheckpointManager, - ethgo.Address(checkpointManager), ethgo.ZeroAddress, "currentEpoch") - if err != nil { - return err - } - - rootchainEpoch, err := common.ParseUint64orHex(&rootchainEpochRaw) - if err != nil { - return err - } - - if rootchainEpoch >= targetEpoch { - return nil - } - } -} - -// setAccessListRole sets access list role to appropriate access list precompile -func setAccessListRole(t *testing.T, cluster *framework.TestCluster, precompile, account types.Address, - role addresslist.Role, aclAdmin ethgo.Key) { - t.Helper() - - var updateRoleFn *abi.Method - - switch role { - case addresslist.AdminRole: - updateRoleFn = addresslist.SetAdminFunc - - break - case addresslist.EnabledRole: - updateRoleFn = addresslist.SetEnabledFunc - - break - case addresslist.NoRole: - updateRoleFn = addresslist.SetNoneFunc - - break - } - - input, err := updateRoleFn.Encode([]interface{}{account}) - require.NoError(t, err) - - enableSetTxn := cluster.MethodTxn(t, aclAdmin, precompile, input) - require.NoError(t, enableSetTxn.Wait()) - - expectRole(t, cluster, precompile, account, role) -} - -func expectRole(t *testing.T, cluster *framework.TestCluster, contract types.Address, addr types.Address, role addresslist.Role) { - t.Helper() - out := cluster.Call(t, contract, addresslist.ReadAddressListFunc, addr) - - num, ok := out["0"].(*big.Int) - if !ok { - t.Fatal("unexpected") - } - - require.Equal(t, role.Uint64(), num.Uint64()) -} - -// getFilteredLogs retrieves Ethereum logs, described by event signature within the block range -func getFilteredLogs(eventSig ethgo.Hash, startBlock, endBlock uint64, - ethEndpoint *jsonrpc.Eth) ([]*ethgo.Log, error) { - filter := ðgo.LogFilter{Topics: [][]*ethgo.Hash{{&eventSig}}} - - filter.SetFromUint64(startBlock) - filter.SetToUint64(endBlock) - - return ethEndpoint.GetLogs(filter) -} - -// erc20BalanceOf returns balance of given account on ERC 20 token -func erc20BalanceOf(t *testing.T, account types.Address, tokenAddr types.Address, relayer txrelayer.TxRelayer) *big.Int { - t.Helper() - - balanceOfFn := &contractsapi.BalanceOfRootERC20Fn{Account: account} - balanceOfInput, err := balanceOfFn.EncodeAbi() - require.NoError(t, err) - - balanceRaw, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(tokenAddr), balanceOfInput) - require.NoError(t, err) - balance, err := common.ParseUint256orHex(&balanceRaw) - require.NoError(t, err) - - return balance -} - -// erc721OwnerOf returns owner of given ERC 721 token -func erc721OwnerOf(t *testing.T, tokenID *big.Int, tokenAddr types.Address, relayer txrelayer.TxRelayer) types.Address { - t.Helper() - - ownerOfFn := &contractsapi.OwnerOfChildERC721Fn{TokenID: tokenID} - ownerOfInput, err := ownerOfFn.EncodeAbi() - require.NoError(t, err) - - ownerRaw, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(tokenAddr), ownerOfInput) - require.NoError(t, err) - - return types.StringToAddress(ownerRaw) -} - -// queryNativeERC20Metadata returns some meta data user requires from native erc20 token -func queryNativeERC20Metadata(t *testing.T, funcName string, abiType *abi.Type, relayer txrelayer.TxRelayer) interface{} { - t.Helper() - - valueHex, err := ABICall(relayer, contractsapi.NativeERC20Mintable, - ethgo.Address(contracts.NativeERC20TokenContract), - ethgo.ZeroAddress, funcName) - require.NoError(t, err) - - valueRaw, err := hex.DecodeHex(valueHex) - require.NoError(t, err) - - var decodedResult map[string]interface{} - - err = abiType.DecodeStruct(valueRaw, &decodedResult) - require.NoError(t, err) - - return decodedResult["0"] -} - -// getChildToken queries child token address for provided root token on the target predicate -func getChildToken(t *testing.T, predicateABI *abi.ABI, predicateAddr types.Address, - rootToken types.Address, relayer txrelayer.TxRelayer) types.Address { - t.Helper() - - rootToChildTokenFn, exists := predicateABI.Methods["rootTokenToChildToken"] - require.True(t, exists, "rootTokenToChildToken function is not found in the provided predicate ABI definition") - - input, err := rootToChildTokenFn.Encode([]interface{}{rootToken}) - require.NoError(t, err) - - childTokenRaw, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(predicateAddr), input) - require.NoError(t, err) - - return types.StringToAddress(childTokenRaw) -} - -func getLastExitEventID(t *testing.T, relayer txrelayer.TxRelayer) uint64 { - t.Helper() - - exitEventsCounterFn := contractsapi.L2StateSender.Abi.Methods["counter"] - - input, err := exitEventsCounterFn.Encode([]interface{}{}) - require.NoError(t, err) - - exitEventIDRaw, err := relayer.Call(ethgo.ZeroAddress, ethgo.Address(contracts.L2StateSenderContract), input) - require.NoError(t, err) - - exitEventID, err := common.ParseUint64orHex(&exitEventIDRaw) - require.NoError(t, err) - - return exitEventID -} diff --git a/e2e-polybft/e2e/jsonrpc_test.go b/e2e-polybft/e2e/jsonrpc_test.go deleted file mode 100644 index b8e6330..0000000 --- a/e2e-polybft/e2e/jsonrpc_test.go +++ /dev/null @@ -1,423 +0,0 @@ -package e2e - -import ( - "fmt" - "math/big" - "testing" - - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/jsonrpc" - "github.com/umbracle/ethgo/wallet" - - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - "github.com/xgr-network/xgr-node/helper/hex" - "github.com/xgr-network/xgr-node/state" - "github.com/xgr-network/xgr-node/types" -) - -var ( - one = big.NewInt(1) -) - -func TestE2E_JsonRPC(t *testing.T) { - acct, err := wallet.GenerateKey() - require.NoError(t, err) - - cluster := framework.NewTestCluster(t, 4, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, acct.Address())), - framework.WithPremine(types.Address(acct.Address())), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - jsonRPC := cluster.Servers[0].JSONRPC() - client := jsonRPC.Eth() - debug := jsonRPC.Debug() - - // Test eth_call with override in state diff - t.Run("eth_call state override", func(t *testing.T) { - deployTxn := cluster.Deploy(t, acct, contractsapi.TestSimple.Bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Succeed()) - - target := deployTxn.Receipt().ContractAddress - - input := contractsapi.TestSimple.Abi.GetMethod("getValue").ID() - - resp, err := client.Call(ðgo.CallMsg{To: &target, Data: input}, ethgo.Latest) - require.NoError(t, err) - require.Equal(t, "0x0000000000000000000000000000000000000000000000000000000000000000", resp) - - override := ðgo.StateOverride{ - target: ethgo.OverrideAccount{ - StateDiff: &map[ethgo.Hash]ethgo.Hash{ - // storage slot 0 stores the 'val' uint256 value - {0x0}: {0x3}, - }, - }, - } - - resp, err = client.Call(ðgo.CallMsg{To: &target, Data: input}, ethgo.Latest, override) - require.NoError(t, err) - - require.Equal(t, "0x0300000000000000000000000000000000000000000000000000000000000000", resp) - }) - - // Test eth_call with zero account balance - t.Run("eth_call with zero-balance account", func(t *testing.T) { - deployTxn := cluster.Deploy(t, acct, contractsapi.TestSimple.Bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Succeed()) - - target := deployTxn.Receipt().ContractAddress - - input := contractsapi.TestSimple.Abi.GetMethod("getValue").ID() - - acctZeroBalance, err := wallet.GenerateKey() - require.NoError(t, err) - - resp, err := client.Call(ðgo.CallMsg{ - From: acctZeroBalance.Address(), - To: &target, - Data: input, - }, ethgo.Latest) - require.NoError(t, err) - require.Equal(t, "0x0000000000000000000000000000000000000000000000000000000000000000", resp) - }) - - t.Run("eth_estimateGas", func(t *testing.T) { - deployTxn := cluster.Deploy(t, acct, contractsapi.TestSimple.Bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Succeed()) - - target := deployTxn.Receipt().ContractAddress - - input := contractsapi.TestSimple.Abi.GetMethod("getValue").ID() - - estimatedGas, err := client.EstimateGas(ðgo.CallMsg{ - From: acct.Address(), - To: &target, - Data: input, - }) - require.NoError(t, err) - require.Equal(t, uint64(0x56a3), estimatedGas) - }) - - t.Run("eth_estimateGas by zero-balance account", func(t *testing.T) { - deployTxn := cluster.Deploy(t, acct, contractsapi.TestSimple.Bytecode) - require.NoError(t, deployTxn.Wait()) - require.True(t, deployTxn.Succeed()) - - target := deployTxn.Receipt().ContractAddress - - input := contractsapi.TestSimple.Abi.GetMethod("getValue").ID() - - acctZeroBalance, err := wallet.GenerateKey() - require.NoError(t, err) - - resp, err := client.EstimateGas(ðgo.CallMsg{ - From: acctZeroBalance.Address(), - To: &target, - Data: input, - }) - require.NoError(t, err) - require.Equal(t, uint64(0x56a3), resp) - }) - - t.Run("eth_estimateGas by zero-balance account - simple value transfer", func(t *testing.T) { - acctZeroBalance, err := wallet.GenerateKey() - require.NoError(t, err) - - fundedAccountAddress := acct.Address() - nonFundedAccountAddress := acctZeroBalance.Address() - - estimateGasFn := func(value *big.Int) { - resp, err := client.EstimateGas(ðgo.CallMsg{ - From: nonFundedAccountAddress, - To: &fundedAccountAddress, - Value: value, - }) - - require.NoError(t, err) - require.Equal(t, state.TxGas, resp) - } - - estimateGasFn(ethgo.Gwei(1)) - - // transfer some funds to zero balance account - valueTransferTxn := cluster.SendTxn(t, acct, ðgo.Transaction{ - From: fundedAccountAddress, - To: &nonFundedAccountAddress, - Value: ethgo.Gwei(10), - }) - - require.NoError(t, valueTransferTxn.Wait()) - require.True(t, valueTransferTxn.Succeed()) - - // now call estimate gas again for the now funded account - estimateGasFn(ethgo.Gwei(1)) - }) - - t.Run("eth_getBalance", func(t *testing.T) { - key1, err := wallet.GenerateKey() - require.NoError(t, err) - - // Test. return zero if the account does not exist - balance1, err := client.GetBalance(key1.Address(), ethgo.Latest) - require.NoError(t, err) - require.Equal(t, balance1, big.NewInt(0)) - - // Test. return the balance of an account - newBalance := ethgo.Ether(1) - txn := cluster.Transfer(t, acct, types.Address(key1.Address()), newBalance) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - balance1, err = client.GetBalance(key1.Address(), ethgo.Latest) - require.NoError(t, err) - require.Equal(t, balance1, newBalance) - - // Test. return 0 if the balance of an existing account is empty - gasPrice, err := client.GasPrice() - require.NoError(t, err) - - toAddr := key1.Address() - - estimatedGas, err := client.EstimateGas(ðgo.CallMsg{ - From: acct.Address(), - To: &toAddr, - Value: newBalance, - }) - require.NoError(t, err) - txPrice := gasPrice * estimatedGas - // subtract gasPrice * estimatedGas from the balance and transfer the rest to the other account - // in order to leave no funds on the account - amountToSend := new(big.Int).Sub(newBalance, big.NewInt(int64(txPrice))) - targetAddr := acct.Address() - txn = cluster.SendTxn(t, key1, ðgo.Transaction{ - To: &targetAddr, - Value: amountToSend, - Gas: estimatedGas, - }) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - balance1, err = client.GetBalance(key1.Address(), ethgo.Latest) - require.NoError(t, err) - require.Equal(t, big.NewInt(0), balance1) - }) - - t.Run("eth_getTransactionCount", func(t *testing.T) { - key1, err := wallet.GenerateKey() - require.NoError(t, err) - - nonce, err := client.GetNonce(key1.Address(), ethgo.Latest) - require.Equal(t, uint64(0), nonce) - require.NoError(t, err) - - txn := cluster.Transfer(t, acct, types.Address(key1.Address()), big.NewInt(10000000000000000)) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - // Test. increase the nonce with new transactions - txn = cluster.Transfer(t, key1, types.ZeroAddress, big.NewInt(0)) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - nonce1, err := client.GetNonce(key1.Address(), ethgo.Latest) - require.NoError(t, err) - require.Equal(t, nonce1, uint64(1)) - - // Test. you can query the nonce at any block number in time - nonce1, err = client.GetNonce(key1.Address(), ethgo.BlockNumber(txn.Receipt().BlockNumber-1)) - require.NoError(t, err) - require.Equal(t, nonce1, uint64(0)) - - block, err := client.GetBlockByNumber(ethgo.BlockNumber(txn.Receipt().BlockNumber)-1, false) - require.NoError(t, err) - - _, err = client.GetNonce(key1.Address(), ethgo.BlockNumber(block.Number)) - require.NoError(t, err) - }) - - t.Run("eth_getStorageAt", func(t *testing.T) { - key1, err := wallet.GenerateKey() - require.NoError(t, err) - - txn := cluster.Transfer(t, acct, types.Address(key1.Address()), one) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - txn = cluster.Deploy(t, acct, contractsapi.TestSimple.Bytecode) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - target := txn.Receipt().ContractAddress - - resp, err := client.GetStorageAt(target, ethgo.Hash{}, ethgo.Latest) - require.NoError(t, err) - require.Equal(t, "0x0000000000000000000000000000000000000000000000000000000000000000", resp.String()) - - setValueFn := contractsapi.TestSimple.Abi.GetMethod("setValue") - - newVal := big.NewInt(1) - - input, err := setValueFn.Encode([]interface{}{newVal}) - require.NoError(t, err) - - txn = cluster.SendTxn(t, acct, ðgo.Transaction{Input: input, To: &target}) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - resp, err = client.GetStorageAt(target, ethgo.Hash{}, ethgo.Latest) - require.NoError(t, err) - require.Equal(t, "0x0000000000000000000000000000000000000000000000000000000000000001", resp.String()) - }) - - t.Run("eth_getCode", func(t *testing.T) { - // we use a predefined private key so that the deployed contract address is deterministic. - // Note that in order to work, this private key should only be used for this test. - priv, err := hex.DecodeString("2c15bd0dc992a47ca660983ae4b611f4ffb6178e14e04e2b34d153f3a74ce741") - require.NoError(t, err) - key1, err := wallet.NewWalletFromPrivKey(priv) - require.NoError(t, err) - - // fund the account so that it can deploy a contract - txn := cluster.Transfer(t, acct, types.Address(key1.Address()), big.NewInt(10000000000000000)) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - codeAddr := ethgo.HexToAddress("0xDBfca0c43cA12759256a7Dd587Dc4c6EEC1D89A5") - - // Test. We get empty code from an empty contract - code, err := client.GetCode(codeAddr, ethgo.Latest) - require.NoError(t, err) - require.Equal(t, code, "0x") - - txn = cluster.Deploy(t, key1, contractsapi.TestSimple.Bytecode) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - receipt := txn.Receipt() - - // Test. The deployed address is the one expected - require.Equal(t, codeAddr, receipt.ContractAddress) - - // Test. We can retrieve the code by address on latest, block number and block hash - cases := []ethgo.BlockNumberOrHash{ - ethgo.Latest, - ethgo.BlockNumber(receipt.BlockNumber), - } - for _, c := range cases { - code, err = client.GetCode(codeAddr, c) - require.NoError(t, err) - require.NotEqual(t, code, "0x") - } - - // Test. We can query in past state (when the code was empty) - code, err = client.GetCode(codeAddr, ethgo.BlockNumber(receipt.BlockNumber-1)) - require.NoError(t, err) - require.Equal(t, code, "0x") - - // Test. Query by pending should default to latest - code, err = client.GetCode(codeAddr, ethgo.Pending) - require.NoError(t, err) - require.NotEqual(t, code, "0x") - }) - - t.Run("eth_getBlockByHash", func(t *testing.T) { - key1, err := wallet.GenerateKey() - require.NoError(t, err) - txn := cluster.Transfer(t, acct, types.Address(key1.Address()), one) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - txReceipt := txn.Receipt() - - block, err := client.GetBlockByHash(txReceipt.BlockHash, false) - require.NoError(t, err) - require.Equal(t, txReceipt.BlockNumber, block.Number) - require.Equal(t, txReceipt.BlockHash, block.Hash) - }) - - t.Run("eth_getBlockByNumber", func(t *testing.T) { - key1, err := wallet.GenerateKey() - require.NoError(t, err) - txn := cluster.Transfer(t, acct, types.Address(key1.Address()), one) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - txReceipt := txn.Receipt() - - block, err := client.GetBlockByNumber(ethgo.BlockNumber(txReceipt.BlockNumber), false) - require.NoError(t, err) - require.Equal(t, txReceipt.BlockNumber, block.Number) - require.Equal(t, txReceipt.BlockHash, block.Hash) - }) - - t.Run("eth_getTransactionReceipt", func(t *testing.T) { - key1, err := wallet.GenerateKey() - require.NoError(t, err) - txn := cluster.Transfer(t, acct, types.Address(key1.Address()), one) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - // Test. We cannot retrieve a receipt of an empty hash - emptyReceipt, err := client.GetTransactionReceipt(ethgo.ZeroHash) - require.NoError(t, err) // Note that ethgo does not return an error when the item does not exists - require.Nil(t, emptyReceipt) - - // Test. We can retrieve the receipt by the hash - receipt, err := client.GetTransactionReceipt(txn.Receipt().TransactionHash) - require.NoError(t, err) - - // Test. The populated fields match with the block - block, err := client.GetBlockByHash(receipt.BlockHash, false) - require.NoError(t, err) - - require.Equal(t, receipt.TransactionHash, txn.Receipt().TransactionHash) - require.Equal(t, receipt.BlockNumber, block.Number) - require.Equal(t, receipt.BlockHash, block.Hash) - - // Test. The receipt of a deployed contract has the 'ContractAddress' field. - txn = cluster.Deploy(t, acct, contractsapi.TestSimple.Bytecode) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - require.NotEqual(t, txn.Receipt().ContractAddress, ethgo.ZeroAddress) - }) - - t.Run("eth_getTransactionByHash", func(t *testing.T) { - key1, err := wallet.GenerateKey() - require.NoError(t, err) - - // Test. We should be able to query the transaction by its hash - txn := cluster.Transfer(t, acct, types.Address(key1.Address()), one) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - ethTxn, err := client.GetTransactionByHash(txn.Receipt().TransactionHash) - require.NoError(t, err) - - // Test. The dynamic 'from' field is populated - require.NotEqual(t, ethTxn.From, ethgo.ZeroAddress) - }) - - t.Run("debug_traceTransaction", func(t *testing.T) { - key1, err := wallet.GenerateKey() - require.NoError(t, err) - - // Test. We should be able to query the transaction by its hash - txn := cluster.Transfer(t, acct, types.Address(key1.Address()), one) - require.NoError(t, txn.Wait()) - require.True(t, txn.Succeed()) - - txReceipt := txn.Receipt() - - // Use a wrapper function from "jsonrpc" package when the config is introduced. - trace, err := debug.TraceTransaction(txReceipt.TransactionHash, jsonrpc.TraceTransactionOptions{}) - require.NoError(t, err) - require.Equal(t, txReceipt.GasUsed, trace.Gas) - }) -} diff --git a/e2e-polybft/e2e/migration_test.go b/e2e-polybft/e2e/migration_test.go deleted file mode 100644 index 080ced9..0000000 --- a/e2e-polybft/e2e/migration_test.go +++ /dev/null @@ -1,210 +0,0 @@ -package e2e - -import ( - "os" - "path/filepath" - "testing" - "time" - - "github.com/syndtr/goleveldb/leveldb/opt" - - "github.com/stretchr/testify/require" - "github.com/syndtr/goleveldb/leveldb" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/wallet" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - frameworkpolybft "github.com/xgr-network/xgr-node/e2e-polybft/framework" - "github.com/xgr-network/xgr-node/e2e/framework" - "github.com/xgr-network/xgr-node/helper/common" - itrie "github.com/xgr-network/xgr-node/state/immutable-trie" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -func TestE2E_Migration(t *testing.T) { - userKey, _ := wallet.GenerateKey() - userAddr := userKey.Address() - userKey2, _ := wallet.GenerateKey() - userAddr2 := userKey2.Address() - - initialBalance := ethgo.Ether(10) - srvs := framework.NewTestServers(t, 1, func(config *framework.TestServerConfig) { - config.SetConsensus(framework.ConsensusDev) - config.Premine(types.Address(userAddr), initialBalance) - }) - srv := srvs[0] - - rpcClient := srv.JSONRPC() - - // Fetch the balances before sending - balanceSender, err := rpcClient.Eth().GetBalance( - userAddr, - ethgo.Latest, - ) - require.NoError(t, err) - require.Equal(t, balanceSender.Cmp(initialBalance), 0) - - balanceReceiver, err := rpcClient.Eth().GetBalance( - userAddr2, - ethgo.Latest, - ) - require.NoError(t, err) - - if balanceReceiver.Uint64() != 0 { - t.Fatal("balanceReceiver is not 0") - } - - relayer, err := txrelayer.NewTxRelayer(txrelayer.WithClient(rpcClient)) - require.NoError(t, err) - - //send transaction to user2 - sendAmount := ethgo.Gwei(10000) - receipt, err := relayer.SendTransaction(ðgo.Transaction{ - From: userAddr, - To: &userAddr2, - Gas: 1000000, - Value: sendAmount, - GasPrice: ethgo.Gwei(2).Uint64(), - }, userKey) - require.NoError(t, err) - require.NotNil(t, receipt) - - receipt, err = relayer.SendTransaction(ðgo.Transaction{ - From: userAddr, - Gas: 1000000, - GasPrice: ethgo.Gwei(2).Uint64(), - Input: contractsapi.TestWriteBlockMetadata.Bytecode, - }, userKey) - require.NoError(t, err) - require.NotNil(t, receipt) - require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) - - deployedContractBalance := receipt.ContractAddress - - initReceipt, err := ABITransaction(relayer, userKey, contractsapi.TestWriteBlockMetadata, receipt.ContractAddress, "init") - if err != nil { - t.Fatal(err) - } - - require.Equal(t, uint64(types.ReceiptSuccess), initReceipt.Status) - - // Fetch the balances after sending - balanceSender, err = rpcClient.Eth().GetBalance( - userAddr, - ethgo.Latest, - ) - require.NoError(t, err) - - balanceReceiver, err = rpcClient.Eth().GetBalance( - userAddr2, - ethgo.Latest, - ) - require.NoError(t, err) - require.Equal(t, sendAmount, balanceReceiver) - - block, err := rpcClient.Eth().GetBlockByNumber(ethgo.Latest, true) - if err != nil { - t.Fatal(err) - } - - stateRoot := block.StateRoot - - path := filepath.Join(srvs[0].Config.RootDir, "trie") - srvs[0].Stop() - //hack for db closing. leveldb allow only one connection - time.Sleep(time.Second) - - tmpDir := t.TempDir() - defer os.RemoveAll(tmpDir) - - err = frameworkpolybft.RunEdgeCommand([]string{ - "regenesis", - "--stateRoot", block.StateRoot.String(), - "--source-path", path, - "--target-path", tmpDir, - }, os.Stdout) - if err != nil { - t.Fatal(err) - } - - db, err := leveldb.OpenFile(tmpDir, &opt.Options{ReadOnly: true}) - if err != nil { - t.Fatal(err) - } - - stateStorageNew := itrie.NewKV(db) - - copiedStateRoot, err := itrie.HashChecker(block.StateRoot.Bytes(), stateStorageNew) - if err != nil { - t.Fatal(err) - } - - require.Equal(t, types.Hash(stateRoot), copiedStateRoot) - - err = db.Close() - if err != nil { - t.Fatal(err) - } - - cluster := frameworkpolybft.NewTestCluster(t, 7, - frameworkpolybft.WithNonValidators(2), - frameworkpolybft.WithValidatorSnapshot(5), - frameworkpolybft.WithTestRewardToken(), - frameworkpolybft.WithGenesisState(tmpDir, types.Hash(stateRoot)), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - senderBalanceAfterMigration, err := cluster.Servers[0].JSONRPC().Eth().GetBalance(userAddr, ethgo.Latest) - if err != nil { - t.Fatal(err) - } - - receiverBalanceAfterMigration, err := cluster.Servers[0].JSONRPC().Eth().GetBalance(userAddr2, ethgo.Latest) - if err != nil { - t.Fatal(err) - } - - require.Equal(t, balanceSender, senderBalanceAfterMigration) - require.Equal(t, balanceReceiver, receiverBalanceAfterMigration) - - deployedCode, err := cluster.Servers[0].JSONRPC().Eth().GetCode(deployedContractBalance, ethgo.Latest) - if err != nil { - t.Fatal(err) - } - - require.Equal(t, deployedCode, *common.EncodeBytes(contractsapi.TestWriteBlockMetadata.DeployedBytecode)) - require.NoError(t, cluster.WaitForBlock(10, 1*time.Minute)) - - //stop last node of validator and non-validator - cluster.Servers[4].Stop() - cluster.Servers[6].Stop() - - require.NoError(t, cluster.WaitForBlock(15, time.Minute)) - - //wait sync of that nodes - cluster.Servers[4].Start() - cluster.Servers[6].Start() - require.NoError(t, cluster.WaitForBlock(20, time.Minute)) - - //stop all nodes - for i := range cluster.Servers { - cluster.Servers[i].Stop() - } - - time.Sleep(time.Second) - - for i := range cluster.Servers { - cluster.Servers[i].Start() - } - - require.NoError(t, cluster.WaitForBlock(25, time.Minute)) - - // add new node - _, err = cluster.InitSecrets("test-chain-8", 1) - require.NoError(t, err) - - cluster.InitTestServer(t, "test-chain-8", cluster.Bridge.JSONRPCAddr(), frameworkpolybft.None) - require.NoError(t, cluster.WaitForBlock(33, time.Minute)) -} diff --git a/e2e-polybft/e2e/network_test.go b/e2e-polybft/e2e/network_test.go deleted file mode 100644 index 23c3a91..0000000 --- a/e2e-polybft/e2e/network_test.go +++ /dev/null @@ -1,38 +0,0 @@ -package e2e - -import ( - "context" - "testing" - "time" - - "github.com/stretchr/testify/assert" - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - "google.golang.org/protobuf/types/known/emptypb" -) - -func TestE2E_NetworkDiscoveryProtocol(t *testing.T) { - const ( - validatorCount = 5 - nonValidatorCount = 5 - // each node in cluster should find at least 2 more peers beside bootnode - atLeastPeers = 3 - testTimeout = time.Second * 60 - ) - - // create cluster - cluster := framework.NewTestCluster(t, validatorCount, - framework.WithTestRewardToken(), - framework.WithNonValidators(nonValidatorCount), - framework.WithBootnodeCount(1)) - defer cluster.Stop() - - ctx := context.Background() - - // wait for everyone to have at least 'atLeastPeers' peers - err := cluster.WaitForGeneric(testTimeout, func(ts *framework.TestServer) bool { - peerList, err := ts.Conn().PeersList(ctx, &emptypb.Empty{}) - - return err == nil && len(peerList.GetPeers()) >= atLeastPeers - }) - assert.NoError(t, err) -} diff --git a/e2e-polybft/e2e/txpool_test.go b/e2e-polybft/e2e/txpool_test.go deleted file mode 100644 index 66e065a..0000000 --- a/e2e-polybft/e2e/txpool_test.go +++ /dev/null @@ -1,325 +0,0 @@ -package e2e - -import ( - "fmt" - "math/big" - "sync" - "testing" - "time" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/jsonrpc" - "github.com/umbracle/ethgo/wallet" - - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -func TestE2E_TxPool_Transfer(t *testing.T) { - // premine an account in the genesis file - sender, err := wallet.GenerateKey() - require.NoError(t, err) - - cluster := framework.NewTestCluster(t, 5, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, sender.Address())), - framework.WithPremine(types.Address(sender.Address())), - framework.WithBurnContract(&polybft.BurnContractInfo{BlockNumber: 0, Address: types.ZeroAddress})) - defer cluster.Stop() - - cluster.WaitForReady(t) - - client := cluster.Servers[0].JSONRPC().Eth() - - sendAmount := 1 - num := 20 - - receivers := []ethgo.Address{} - - for i := 0; i < num; i++ { - key, err := wallet.GenerateKey() - require.NoError(t, err) - - receivers = append(receivers, key.Address()) - } - - var wg sync.WaitGroup - for i := 0; i < num; i++ { - wg.Add(1) - - go func(i int, to ethgo.Address) { - defer wg.Done() - - txn := ðgo.Transaction{ - From: sender.Address(), - To: &to, - Gas: 30000, // enough to send a transfer - Value: big.NewInt(int64(sendAmount)), - Nonce: uint64(i), - } - - // Send every second transaction as a dynamic fees one - if i%2 == 0 { - txn.Type = ethgo.TransactionDynamicFee - txn.MaxFeePerGas = big.NewInt(1000000000) - txn.MaxPriorityFeePerGas = big.NewInt(100000000) - } else { - txn.Type = ethgo.TransactionLegacy - txn.GasPrice = ethgo.Gwei(2).Uint64() - } - - sendTransaction(t, client, sender, txn) - }(i, receivers[i]) - } - - wg.Wait() - - err = cluster.WaitUntil(2*time.Minute, 2*time.Second, func() bool { - for _, receiver := range receivers { - balance, err := client.GetBalance(receiver, ethgo.Latest) - if err != nil { - return true - } - t.Logf("Balance %s %s", receiver, balance) - if balance.Uint64() != uint64(sendAmount) { - return false - } - } - - return true - }) - require.NoError(t, err) -} - -// First account send some amount to second one and then second one to third account -func TestE2E_TxPool_Transfer_Linear(t *testing.T) { - premine, err := wallet.GenerateKey() - require.NoError(t, err) - - // first account should have some matics premined - cluster := framework.NewTestCluster(t, 5, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, premine.Address())), - framework.WithPremine(types.Address(premine.Address())), - framework.WithBurnContract(&polybft.BurnContractInfo{BlockNumber: 0, Address: types.ZeroAddress}), - ) - defer cluster.Stop() - - cluster.WaitForReady(t) - - client := cluster.Servers[0].JSONRPC().Eth() - - waitUntilBalancesChanged := func(acct ethgo.Address) error { - err := cluster.WaitUntil(30*time.Second, 2*time.Second, func() bool { - balance, err := client.GetBalance(acct, ethgo.Latest) - if err != nil { - return true - } - - return balance.Cmp(big.NewInt(0)) > 0 - }) - - return err - } - - populateTxFees := func(txn *ethgo.Transaction, i int) { - if i%2 == 0 { - txn.Type = ethgo.TransactionDynamicFee - txn.MaxFeePerGas = big.NewInt(1000000000) - txn.MaxPriorityFeePerGas = big.NewInt(1000000000) - } else { - txn.Type = ethgo.TransactionLegacy - txn.GasPrice = ethgo.Gwei(1).Uint64() - } - } - - num := 4 - receivers := []*wallet.Key{ - premine, - } - - for i := 0; i < num-1; i++ { - key, err := wallet.GenerateKey() - assert.NoError(t, err) - - receivers = append(receivers, key) - } - - const sendAmount = 3000000 - - // We are going to fund the accounts in linear fashion: - // A (premined account) -> B -> C -> D -> E - // At the end, all of them (except the premined account) will have the same `sendAmount` - // of balance. - for i := 1; i < num; i++ { - // we have to send enough value to account `i` so that it has enough to fund - // its child i+1 (cover costs + send amounts). - // This means that since gasCost and sendAmount are fixed, account C must receive gasCost * 2 - // (to cover two more transfers C->D and D->E) + sendAmount * 3 (one bundle for each C,D and E). - recipient := receivers[i].Address() - txn := ðgo.Transaction{ - Value: big.NewInt(int64(sendAmount * (num - i))), - To: &recipient, - Gas: 21000, - } - - // Populate fees fields for the current transaction - populateTxFees(txn, i-1) - - // Add remaining fees to finish the cycle - gasCostTotal := new(big.Int).Mul(txCost(txn), new(big.Int).SetInt64(int64(num-i-1))) - txn.Value = txn.Value.Add(txn.Value, gasCostTotal) - - sendTransaction(t, client, receivers[i-1], txn) - - err := waitUntilBalancesChanged(receivers[i].Address()) - require.NoError(t, err) - } - - for i := 1; i < num; i++ { - balance, err := client.GetBalance(receivers[i].Address(), ethgo.Latest) - require.NoError(t, err) - require.Equal(t, uint64(sendAmount), balance.Uint64()) - } -} - -func TestE2E_TxPool_TransactionWithHeaderInstructions(t *testing.T) { - sidechainKey, err := wallet.GenerateKey() - require.NoError(t, err) - - cluster := framework.NewTestCluster(t, 4, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, sidechainKey.Address())), - framework.WithPremine(types.Address(sidechainKey.Address())), - ) - defer cluster.Stop() - - require.NoError(t, cluster.WaitForBlock(1, 20*time.Second)) - - relayer, err := txrelayer.NewTxRelayer(txrelayer.WithIPAddress(cluster.Servers[0].JSONRPCAddr())) - require.NoError(t, err) - - receipt, err := relayer.SendTransaction(ðgo.Transaction{Input: contractsapi.TestWriteBlockMetadata.Bytecode}, sidechainKey) - require.NoError(t, err) - require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) - - receipt, err = ABITransaction(relayer, sidechainKey, contractsapi.TestWriteBlockMetadata, receipt.ContractAddress, "init", []interface{}{}) - require.NoError(t, err) - require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) - - require.NoError(t, cluster.WaitForBlock(10, 1*time.Minute)) -} - -// TestE2E_TxPool_BroadcastTransactions sends several transactions (legacy and dynamic fees) to the cluster -// with the 1 amount of eth and checks that all cluster nodes have the recipient balance updated. -func TestE2E_TxPool_BroadcastTransactions(t *testing.T) { - var ( - sendAmount = ethgo.Ether(1) - ) - - const ( - txNum = 10 - ) - - // Create recipient key - key, err := wallet.GenerateKey() - assert.NoError(t, err) - - recipient := key.Address() - - t.Logf("Recipient %s\n", recipient) - - // Create pre-mined balance for sender - sender, err := wallet.GenerateKey() - require.NoError(t, err) - - // First account should have some matics premined - cluster := framework.NewTestCluster(t, 5, - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, sender.Address())), - framework.WithPremine(types.Address(sender.Address())), - framework.WithBurnContract(&polybft.BurnContractInfo{BlockNumber: 0, Address: types.ZeroAddress}), - ) - defer cluster.Stop() - - // Wait until the cluster is up and running - cluster.WaitForReady(t) - - client := cluster.Servers[0].JSONRPC().Eth() - - sentAmount := new(big.Int) - nonce := uint64(0) - - for i := 0; i < txNum; i++ { - txn := ðgo.Transaction{ - Value: sendAmount, - To: &recipient, - Gas: 21000, - Nonce: nonce, - } - - if i%2 == 0 { - txn.Type = ethgo.TransactionDynamicFee - txn.MaxFeePerGas = big.NewInt(1000000000) - txn.MaxPriorityFeePerGas = big.NewInt(100000000) - } else { - txn.Type = ethgo.TransactionLegacy - txn.GasPrice = ethgo.Gwei(2).Uint64() - } - - sendTransaction(t, client, sender, txn) - sentAmount = sentAmount.Add(sentAmount, txn.Value) - nonce++ - } - - // Wait until the balance has changed on all nodes in the cluster - err = cluster.WaitUntil(time.Minute, time.Second*3, func() bool { - for _, srv := range cluster.Servers { - balance, err := srv.WaitForNonZeroBalance(recipient, time.Second*10) - assert.NoError(t, err) - if balance != nil && balance.BitLen() > 0 { - assert.Equal(t, sentAmount, balance) - } else { - return false - } - } - - return true - }) - assert.NoError(t, err) -} - -// sendTransaction is a helper function which signs transaction with provided private key and sends it -func sendTransaction(t *testing.T, client *jsonrpc.Eth, sender *wallet.Key, txn *ethgo.Transaction) { - t.Helper() - - chainID, err := client.ChainID() - require.NoError(t, err) - - if txn.Type == ethgo.TransactionDynamicFee { - txn.ChainID = chainID - } - - signer := wallet.NewEIP155Signer(chainID.Uint64()) - signedTxn, err := signer.SignTx(txn, sender) - require.NoError(t, err) - - txnRaw, err := signedTxn.MarshalRLPTo(nil) - require.NoError(t, err) - - _, err = client.SendRawTransaction(txnRaw) - require.NoError(t, err) -} - -func txCost(t *ethgo.Transaction) *big.Int { - var factor *big.Int - - if t.Type == ethgo.TransactionDynamicFee { - factor = new(big.Int).Set(t.MaxFeePerGas) - } else { - factor = new(big.Int).SetUint64(t.GasPrice) - } - - return new(big.Int).Mul(factor, new(big.Int).SetUint64(t.Gas)) -} diff --git a/e2e-polybft/framework/node.go b/e2e-polybft/framework/node.go deleted file mode 100644 index 37241df..0000000 --- a/e2e-polybft/framework/node.go +++ /dev/null @@ -1,77 +0,0 @@ -package framework - -import ( - "io" - "os" - "os/exec" - "sync/atomic" -) - -type node struct { - shuttingDown atomic.Bool - cmd *exec.Cmd - doneCh chan struct{} - exitResult *exitResult -} - -func newNode(binary string, args []string, stdout io.Writer) (*node, error) { - cmd := exec.Command(binary, args...) - cmd.Stdout = stdout - cmd.Stderr = stdout - - if err := cmd.Start(); err != nil { - return nil, err - } - - n := &node{ - cmd: cmd, - doneCh: make(chan struct{}), - } - go n.run() - - return n, nil -} - -func (n *node) ExitResult() *exitResult { - return n.exitResult -} - -func (n *node) Wait() <-chan struct{} { - return n.doneCh -} - -func (n *node) run() { - err := n.cmd.Wait() - - n.exitResult = &exitResult{ - Signaled: n.IsShuttingDown(), - Err: err, - } - close(n.doneCh) - n.cmd = nil -} - -func (n *node) IsShuttingDown() bool { - return n.shuttingDown.Load() -} - -func (n *node) Stop() error { - if n.cmd == nil { - // the server is already stopped - return nil - } - - if err := n.cmd.Process.Signal(os.Interrupt); err != nil { - return err - } - - n.shuttingDown.Store(true) - <-n.Wait() - - return nil -} - -type exitResult struct { - Signaled bool - Err error -} diff --git a/e2e-polybft/framework/test-bridge.go b/e2e-polybft/framework/test-bridge.go deleted file mode 100644 index 4e562bf..0000000 --- a/e2e-polybft/framework/test-bridge.go +++ /dev/null @@ -1,680 +0,0 @@ -package framework - -import ( - "context" - "errors" - "fmt" - "math/big" - "path" - "strconv" - "strings" - "testing" - "time" - - "golang.org/x/sync/errgroup" - - "github.com/xgr-network/xgr-node/command" - bridgeCommon "github.com/xgr-network/xgr-node/command/bridge/common" - "github.com/xgr-network/xgr-node/command/genesis" - cmdHelper "github.com/xgr-network/xgr-node/command/helper" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/command/rootchain/server" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/types" -) - -type TestBridge struct { - t *testing.T - clusterConfig *TestClusterConfig - node *node -} - -func NewTestBridge(t *testing.T, clusterConfig *TestClusterConfig) (*TestBridge, error) { - t.Helper() - - bridge := &TestBridge{ - t: t, - clusterConfig: clusterConfig, - } - - err := bridge.Start() - if err != nil { - return nil, err - } - - return bridge, nil -} - -func (t *TestBridge) Start() error { - // Build arguments - args := []string{ - "rootchain", - "server", - "--data-dir", t.clusterConfig.Dir("test-rootchain"), - } - - stdout := t.clusterConfig.GetStdout("bridge") - - bridgeNode, err := newNode(t.clusterConfig.Binary, args, stdout) - if err != nil { - return err - } - - t.node = bridgeNode - - if err = server.PingServer(nil); err != nil { - return err - } - - return nil -} - -func (t *TestBridge) Stop() { - if err := t.node.Stop(); err != nil { - t.t.Error(err) - } - - t.node = nil -} - -func (t *TestBridge) JSONRPCAddr() string { - return fmt.Sprintf("http://%s:%d", hostIP, 8545) -} - -func (t *TestBridge) WaitUntil(pollFrequency, timeout time.Duration, handler func() (bool, error)) error { - timer := time.NewTimer(timeout) - defer timer.Stop() - - for { - select { - case <-timer.C: - return fmt.Errorf("timeout") - case <-time.After(pollFrequency): - } - - isConditionMet, err := handler() - if err != nil { - return err - } - - if isConditionMet { - return nil - } - } -} - -// Deposit function invokes bridge deposit of ERC tokens (from the root to the child chain) -// with given receivers, amounts and/or token ids -func (t *TestBridge) Deposit(token bridgeCommon.TokenType, rootTokenAddr, rootPredicateAddr types.Address, - senderKey, receivers, amounts, tokenIDs, jsonRPCAddr, minterKey string, childChainMintable bool) error { - args := []string{} - - if receivers == "" { - return errors.New("provide at least one receiver address value") - } - - if jsonRPCAddr == "" { - return errors.New("provide a JSON RPC endpoint URL") - } - - switch token { - case bridgeCommon.ERC20: - if amounts == "" { - return errors.New("provide at least one amount value") - } - - if tokenIDs != "" { - return errors.New("not expected to provide token ids for ERC 20 deposits") - } - - args = append(args, - "bridge", - "deposit-erc20", - "--root-token", rootTokenAddr.String(), - "--root-predicate", rootPredicateAddr.String(), - "--receivers", receivers, - "--amounts", amounts, - "--sender-key", senderKey, - "--minter-key", minterKey, - "--json-rpc", jsonRPCAddr) - - if childChainMintable { - args = append(args, "--child-chain-mintable") - } - - case bridgeCommon.ERC721: - if tokenIDs == "" { - return errors.New("provide at least one token id value") - } - - args = append(args, - "bridge", - "deposit-erc721", - "--root-token", rootTokenAddr.String(), - "--root-predicate", rootPredicateAddr.String(), - "--receivers", receivers, - "--token-ids", tokenIDs, - "--sender-key", senderKey, - "--minter-key", minterKey, - "--json-rpc", jsonRPCAddr) - - if childChainMintable { - args = append(args, "--child-chain-mintable") - } - - case bridgeCommon.ERC1155: - if amounts == "" { - return errors.New("provide at least one amount value") - } - - if tokenIDs == "" { - return errors.New("provide at least one token id value") - } - - args = append(args, - "bridge", - "deposit-erc1155", - "--root-token", rootTokenAddr.String(), - "--root-predicate", rootPredicateAddr.String(), - "--receivers", receivers, - "--amounts", amounts, - "--token-ids", tokenIDs, - "--sender-key", senderKey, - "--minter-key", minterKey, - "--json-rpc", jsonRPCAddr) - - if childChainMintable { - args = append(args, "--child-chain-mintable") - } - } - - return t.cmdRun(args...) -} - -// Withdraw function is used to invoke bridge withdrawals for any kind of ERC tokens (from the child to the root chain) -// with given receivers, amounts and/or token ids -func (t *TestBridge) Withdraw(token bridgeCommon.TokenType, - senderKey, receivers, amounts, tokenIDs, jsonRPCAddr string, - childPredicate, childToken types.Address, childChainMintable bool) error { - if senderKey == "" { - return errors.New("provide hex-encoded sender private key") - } - - if receivers == "" { - return errors.New("provide at least one receiver address value") - } - - if jsonRPCAddr == "" { - return errors.New("provide a JSON RPC endpoint URL") - } - - args := []string{} - - switch token { - case bridgeCommon.ERC20: - if amounts == "" { - return errors.New("provide at least one amount value") - } - - if tokenIDs != "" { - return errors.New("not expected to provide token ids for ERC 20 withdrawals") - } - - args = append(args, - "bridge", - "withdraw-erc20", - "--child-predicate", childPredicate.String(), - "--child-token", childToken.String(), - "--sender-key", senderKey, - "--receivers", receivers, - "--amounts", amounts, - "--json-rpc", jsonRPCAddr) - - if childChainMintable { - args = append(args, "--child-chain-mintable") - } - - case bridgeCommon.ERC721: - if tokenIDs == "" { - return errors.New("provide at least one token id value") - } - - args = append(args, - "bridge", - "withdraw-erc721", - "--child-predicate", childPredicate.String(), - "--child-token", childToken.String(), - "--sender-key", senderKey, - "--receivers", receivers, - "--token-ids", tokenIDs, - "--json-rpc", jsonRPCAddr) - - if childChainMintable { - args = append(args, "--child-chain-mintable") - } - - case bridgeCommon.ERC1155: - if amounts == "" { - return errors.New("provide at least one amount value") - } - - if tokenIDs == "" { - return errors.New("provide at least one token id value") - } - - args = append(args, - "bridge", - "withdraw-erc1155", - "--child-predicate", childPredicate.String(), - "--child-token", childToken.String(), - "--sender-key", senderKey, - "--receivers", receivers, - "--amounts", amounts, - "--token-ids", tokenIDs, - "--json-rpc", jsonRPCAddr) - - if childChainMintable { - args = append(args, "--child-chain-mintable") - } - } - - return t.cmdRun(args...) -} - -// SendExitTransaction sends exit transaction to the root chain -func (t *TestBridge) SendExitTransaction(exitHelper types.Address, exitID uint64, childJSONRPCAddr string) error { - if childJSONRPCAddr == "" { - return errors.New("provide a child chain JSON RPC endpoint URL") - } - - return t.cmdRun( - "bridge", - "exit", - "--exit-helper", exitHelper.String(), - "--exit-id", strconv.FormatUint(exitID, 10), - "--root-json-rpc", t.JSONRPCAddr(), - "--child-json-rpc", childJSONRPCAddr, - "--test", - ) -} - -// cmdRun executes arbitrary command from the given binary -func (t *TestBridge) cmdRun(args ...string) error { - return runCommand(t.clusterConfig.Binary, args, t.clusterConfig.GetStdout("bridge")) -} - -// deployRootchainContracts deploys and initializes rootchain contracts -func (t *TestBridge) deployRootchainContracts(genesisPath string) error { - polybftConfig, err := polybft.LoadPolyBFTConfig(genesisPath) - if err != nil { - return err - } - - args := []string{ - "rootchain", - "deploy", - "--stake-manager", polybftConfig.Bridge.StakeManagerAddr.String(), - "--stake-token", polybftConfig.Bridge.StakeTokenAddr.String(), - "--proxy-contracts-admin", t.clusterConfig.GetProxyContractsAdmin(), - "--genesis", genesisPath, - "--test", - } - - if err := t.cmdRun(args...); err != nil { - return fmt.Errorf("failed to deploy rootchain contracts: %w", err) - } - - return nil -} - -// fundAddressesOnRoot sends predefined amount of tokens to rootchain addresses -func (t *TestBridge) fundAddressesOnRoot(tokenConfig *polybft.TokenConfig, polybftConfig polybft.PolyBFTConfig) error { - validatorSecrets, err := genesis.GetValidatorKeyFiles(t.clusterConfig.TmpDir, t.clusterConfig.ValidatorPrefix) - if err != nil { - return fmt.Errorf("could not get validator secrets on initial rootchain funding of genesis validators: %w", err) - } - - // first fund validators - balances := make([]*big.Int, len(polybftConfig.InitialValidatorSet)) - secrets := make([]string, len(validatorSecrets)) - - for i, secret := range validatorSecrets { - secrets[i] = path.Join(t.clusterConfig.TmpDir, secret) - balances[i] = command.DefaultPremineBalance - } - - if err := t.FundValidators(polybftConfig.Bridge.StakeTokenAddr, - secrets, balances); err != nil { - return fmt.Errorf("failed to fund validators on the rootchain: %w", err) - } - - // then fund all other addresses if token is non-mintable - // so that they can do premine on SupernetMAnager - if tokenConfig.IsMintable || len(t.clusterConfig.Premine) == 0 { - return nil - } - - // non-validator addresses don't need to mint stake token, - // they only need to be funded with root token - args := []string{ - "rootchain", - "fund", - } - - for _, premineRaw := range t.clusterConfig.Premine { - premineInfo, err := cmdHelper.ParsePremineInfo(premineRaw) - if err != nil { - return err - } - - args = append(args, "--addresses", premineInfo.Address.String()) - args = append(args, "--amounts", command.DefaultPremineBalance.String()) // this is more than enough tokens - } - - if err := t.cmdRun(args...); err != nil { - return fmt.Errorf("failed to fund non-validator addresses on root: %w", err) - } - - return nil -} - -func (t *TestBridge) whitelistValidators(validatorAddresses []types.Address, - polybftConfig polybft.PolyBFTConfig) error { - addressesAsString := make([]string, len(validatorAddresses)) - for i := 0; i < len(validatorAddresses); i++ { - addressesAsString[i] = validatorAddresses[i].String() - } - - args := []string{ - "polybft", - "whitelist-validators", - "--addresses", strings.Join(addressesAsString, ","), - "--jsonrpc", t.JSONRPCAddr(), - "--supernet-manager", polybftConfig.Bridge.CustomSupernetManagerAddr.String(), - "--private-key", rootHelper.TestAccountPrivKey, - } - - if err := t.cmdRun(args...); err != nil { - return fmt.Errorf("failed to whitelist genesis validators on supernet manager: %w", err) - } - - return nil -} - -func (t *TestBridge) registerGenesisValidators(polybftConfig polybft.PolyBFTConfig) error { - validatorSecrets, err := genesis.GetValidatorKeyFiles(t.clusterConfig.TmpDir, t.clusterConfig.ValidatorPrefix) - if err != nil { - return fmt.Errorf("could not get validator secrets on whitelist of genesis validators: %w", err) - } - - g, ctx := errgroup.WithContext(context.Background()) - - for _, secret := range validatorSecrets { - secret := secret - - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - default: - args := []string{ - "polybft", - "register-validator", - "--jsonrpc", t.JSONRPCAddr(), - "--supernet-manager", polybftConfig.Bridge.CustomSupernetManagerAddr.String(), - "--" + polybftsecrets.AccountDirFlag, path.Join(t.clusterConfig.TmpDir, secret), - } - - if err := t.cmdRun(args...); err != nil { - return fmt.Errorf("failed to register genesis validator on supernet manager: %w", err) - } - - return nil - } - }) - } - - return g.Wait() -} - -func (t *TestBridge) initialStakingOfGenesisValidators(polybftConfig polybft.PolyBFTConfig) error { - validatorSecrets, err := genesis.GetValidatorKeyFiles(t.clusterConfig.TmpDir, t.clusterConfig.ValidatorPrefix) - if err != nil { - return fmt.Errorf("could not get validator secrets on initial staking of genesis validators: %w", err) - } - - g, ctx := errgroup.WithContext(context.Background()) - - for i, secret := range validatorSecrets { - secret := secret - i := i - - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - default: - args := []string{ - "polybft", - "stake", - "--jsonrpc", t.JSONRPCAddr(), - "--stake-manager", polybftConfig.Bridge.StakeManagerAddr.String(), - "--" + polybftsecrets.AccountDirFlag, path.Join(t.clusterConfig.TmpDir, secret), - "--amount", t.getStakeAmount(i).String(), - "--supernet-id", strconv.FormatInt(polybftConfig.SupernetID, 10), - "--stake-token", polybftConfig.Bridge.StakeTokenAddr.String(), - } - - if err := t.cmdRun(args...); err != nil { - return fmt.Errorf("failed to do initial staking for genesis validator on stake manager: %w", err) - } - - return nil - } - }) - } - - return g.Wait() -} - -func (t *TestBridge) getStakeAmount(validatorIndex int) *big.Int { - l := len(t.clusterConfig.StakeAmounts) - if l == 0 || l <= validatorIndex { - return command.DefaultStake - } - - return t.clusterConfig.StakeAmounts[validatorIndex] -} - -func (t *TestBridge) finalizeGenesis(genesisPath string, polybftConfig polybft.PolyBFTConfig) error { - args := []string{ - "polybft", - "supernet", - "--jsonrpc", t.JSONRPCAddr(), - "--private-key", rootHelper.TestAccountPrivKey, - "--genesis", genesisPath, - "--supernet-manager", polybftConfig.Bridge.CustomSupernetManagerAddr.String(), - "--finalize-genesis-set", - "--enable-staking", - } - - if err := t.cmdRun(args...); err != nil { - return fmt.Errorf("failed to finalize genesis validators on supernet manager: %w", err) - } - - return nil -} - -// FundValidators sends tokens to a rootchain validators -func (t *TestBridge) FundValidators(tokenAddress types.Address, secretsPaths []string, amounts []*big.Int) error { - if len(secretsPaths) != len(amounts) { - return errors.New("expected the same length of secrets paths and amounts") - } - - args := []string{ - "rootchain", - "fund", - "--stake-token", tokenAddress.String(), - "--mint", - } - - for i := 0; i < len(secretsPaths); i++ { - secretsManager, err := polybftsecrets.GetSecretsManager(secretsPaths[i], "", true) - if err != nil { - return err - } - - key, err := wallet.GetEcdsaFromSecret(secretsManager) - if err != nil { - return err - } - - args = append(args, "--addresses", key.Address().String()) - args = append(args, "--amounts", amounts[i].String()) - } - - if err := t.cmdRun(args...); err != nil { - return err - } - - return nil -} - -func (t *TestBridge) deployStakeManager(genesisPath string) error { - args := []string{ - "polybft", - "stake-manager-deploy", - "--jsonrpc", t.JSONRPCAddr(), - "--genesis", genesisPath, - "--proxy-contracts-admin", t.clusterConfig.GetProxyContractsAdmin(), - "--test", - } - - if err := t.cmdRun(args...); err != nil { - return fmt.Errorf("failed to deploy stake manager contract: %w", err) - } - - return nil -} - -func (t *TestBridge) mintNativeRootToken(validatorAddresses []types.Address, tokenConfig *polybft.TokenConfig, - polybftConfig polybft.PolyBFTConfig) error { - if tokenConfig.IsMintable { - // if token is mintable, it is premined in genesis command, - // so we just return here - return nil - } - - // if token is non-mintable, then to do premine we first need to mint those tokens - // to validators and other provided addresses - args := []string{ - "bridge", - "mint-erc20", - "--jsonrpc", t.JSONRPCAddr(), - "--erc20-token", polybftConfig.Bridge.RootNativeERC20Addr.String(), - } - - // mint something for every validator - for _, addr := range validatorAddresses { - args = append(args, "--addresses", addr.String()) - args = append(args, "--amounts", command.DefaultPremineBalance.String()) - } - - // mint something to others as well - for _, premineRaw := range t.clusterConfig.Premine { - premineInfo, err := cmdHelper.ParsePremineInfo(premineRaw) - if err != nil { - return err - } - - args = append(args, "--addresses", premineInfo.Address.String()) - args = append(args, "--amounts", premineInfo.Amount.String()) - } - - return t.cmdRun(args...) -} - -func (t *TestBridge) premineNativeRootToken(tokenConfig *polybft.TokenConfig, - polybftConfig polybft.PolyBFTConfig) error { - if tokenConfig.IsMintable { - // if token is mintable, it is premined in genesis command, - // so we just return here - return nil - } - - validatorSecrets, err := genesis.GetValidatorKeyFiles(t.clusterConfig.TmpDir, t.clusterConfig.ValidatorPrefix) - if err != nil { - return fmt.Errorf("could not get validator secrets on premining native root"+ - " token for genesis validators: %w", err) - } - - premineCmdArgs := func(secret, key string, amount *big.Int) error { - args := []string{ - "rootchain", - "premine", - "--jsonrpc", t.JSONRPCAddr(), - "--supernet-manager", polybftConfig.Bridge.CustomSupernetManagerAddr.String(), - "--amount", amount.String(), - "--erc20-token", polybftConfig.Bridge.RootNativeERC20Addr.String(), - "--root-erc20-predicate", polybftConfig.Bridge.RootERC20PredicateAddr.String(), - } - - if secret != "" { - args = append(args, "--"+polybftsecrets.AccountDirFlag, path.Join(t.clusterConfig.TmpDir, secret)) - } else { - args = append(args, "--private-key", key) - } - - return t.cmdRun(args...) - } - - g, ctx := errgroup.WithContext(context.Background()) - - // premine validators - for _, secret := range validatorSecrets { - secret := secret - - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - default: - if err := premineCmdArgs(secret, "", command.DefaultPremineBalance); err != nil { - return fmt.Errorf("failed to do premine of native root token for genesis validator: %w", - err) - } - - return nil - } - }) - } - - // now premine for other addresses - for _, premineRaw := range t.clusterConfig.Premine { - premineRaw := premineRaw - - g.Go(func() error { - select { - case <-ctx.Done(): - return ctx.Err() - default: - premineInfo, err := cmdHelper.ParsePremineInfo(premineRaw) - if err != nil { - return fmt.Errorf("failed to do premine of native root token for non-validator"+ - " account: %w. premine raw: %s", err, premineRaw) - } - - if err := premineCmdArgs("", premineInfo.Key, premineInfo.Amount); err != nil { - return fmt.Errorf("failed to do premine of native root token for "+ - "non-validator account: %w. premine raw: %s", err, premineRaw) - } - - return nil - } - }) - } - - return g.Wait() -} diff --git a/e2e-polybft/framework/test-cluster.go b/e2e-polybft/framework/test-cluster.go deleted file mode 100644 index fbc9d23..0000000 --- a/e2e-polybft/framework/test-cluster.go +++ /dev/null @@ -1,1102 +0,0 @@ -package framework - -import ( - "bytes" - "encoding/hex" - "fmt" - "io" - "math/big" - "os" - "os/exec" - "path" - "path/filepath" - "regexp" - "strconv" - "strings" - "sync" - "testing" - "time" - - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/abi" - "github.com/umbracle/ethgo/jsonrpc" - "github.com/umbracle/ethgo/wallet" - "github.com/xgr-network/xgr-node/command/genesis" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/contractsapi" - "github.com/xgr-network/xgr-node/helper/common" - "github.com/xgr-network/xgr-node/txrelayer" - "github.com/xgr-network/xgr-node/types" -) - -const ( - // envE2ETestsEnabled signal whether the e2e tests will run - envE2ETestsEnabled = "E2E_TESTS" - - // envLogsEnabled signal whether the output of the nodes get piped to a log file - envLogsEnabled = "E2E_LOGS" - - // envLogLevel specifies log level of each node - envLogLevel = "E2E_LOG_LEVEL" - - // envStdoutEnabled signal whether the output of the nodes get piped to stdout - envStdoutEnabled = "E2E_STDOUT" - - // prefix for validator directory - defaultValidatorPrefix = "test-chain-" - - // prefix for non validators directory - nonValidatorPrefix = "test-non-validator-" - - // NativeTokenMintableTestCfg is the test native token config for Supernets originated native tokens - NativeTokenMintableTestCfg = "Mintable Edge Coin:MEC:18:true:%s" //nolint:gosec -) - -type NodeType int - -const ( - None NodeType = 0 - Validator NodeType = 1 - Relayer NodeType = 2 -) - -func (nt NodeType) IsSet(value NodeType) bool { - return nt&value == value -} - -func (nt *NodeType) Append(value NodeType) { - *nt |= value -} - -var ( - startTime int64 - testRewardWalletAddr = types.StringToAddress("0xFFFFFFFF") - ProxyContractAdminAddr = "0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed" -) - -func init() { - startTime = time.Now().UTC().UnixMilli() -} - -func resolveBinary() string { - bin := os.Getenv("EDGE_BINARY") - if bin != "" { - return bin - } - // fallback - return "polygon-edge" -} - -type TestClusterConfig struct { - t *testing.T - - Name string - Premine []string // address[:amount] - StakeAmounts []*big.Int - BootnodeCount int - NonValidatorCount int - WithLogs bool - WithStdout bool - LogsDir string - TmpDir string - BlockGasLimit uint64 - BlockTime time.Duration - BurnContract *polybft.BurnContractInfo - ValidatorPrefix string - Binary string - ValidatorSetSize uint64 - EpochSize int - EpochReward int - NativeTokenConfigRaw string - SecretsCallback func([]types.Address, *TestClusterConfig) - - ContractDeployerAllowListAdmin []types.Address - ContractDeployerAllowListEnabled []types.Address - ContractDeployerBlockListAdmin []types.Address - ContractDeployerBlockListEnabled []types.Address - TransactionsAllowListAdmin []types.Address - TransactionsAllowListEnabled []types.Address - TransactionsBlockListAdmin []types.Address - TransactionsBlockListEnabled []types.Address - BridgeAllowListAdmin []types.Address - BridgeAllowListEnabled []types.Address - BridgeBlockListAdmin []types.Address - BridgeBlockListEnabled []types.Address - - NumBlockConfirmations uint64 - - InitialTrieDB string - InitialStateRoot types.Hash - - IsPropertyTest bool - TestRewardToken string - - RootTrackerPollInterval time.Duration - - ProxyContractsAdmin string - - logsDirOnce sync.Once -} - -func (c *TestClusterConfig) Dir(name string) string { - return filepath.Join(c.TmpDir, name) -} - -func (c *TestClusterConfig) GetStdout(name string, custom ...io.Writer) io.Writer { - writers := []io.Writer{} - - if c.WithLogs { - c.logsDirOnce.Do(func() { - c.initLogsDir() - }) - - f, err := os.OpenFile(filepath.Join(c.LogsDir, name+".log"), os.O_RDWR|os.O_APPEND|os.O_CREATE, 0600) - if err != nil { - c.t.Fatal(err) - } - - writers = append(writers, f) - - c.t.Cleanup(func() { - err = f.Close() - if err != nil { - c.t.Logf("Failed to close file. Error: %s", err) - } - }) - } - - if c.WithStdout { - writers = append(writers, os.Stdout) - } - - if len(custom) > 0 { - writers = append(writers, custom...) - } - - if len(writers) == 0 { - return io.Discard - } - - return io.MultiWriter(writers...) -} - -func (c *TestClusterConfig) initLogsDir() { - logsDir := path.Join("../..", fmt.Sprintf("e2e-logs-%d", startTime), c.t.Name()) - if c.IsPropertyTest { - // property tests run cluster multiple times, so each cluster run will be in the main folder - // e2e-logs-{someNumber}/NameOfPropertyTest/NameOfPropertyTest-{someNumber} - // to have a separation between logs of each cluster run - logsDir = path.Join(logsDir, fmt.Sprintf("%v-%d", c.t.Name(), time.Now().UTC().Unix())) - } - - if err := common.CreateDirSafe(logsDir, 0750); err != nil { - c.t.Fatal(err) - } - - c.t.Logf("logs enabled for e2e test: %s", logsDir) - c.LogsDir = logsDir -} - -func (c *TestClusterConfig) GetProxyContractsAdmin() string { - proxyAdminAddr := c.ProxyContractsAdmin - if proxyAdminAddr == "" { - proxyAdminAddr = ProxyContractAdminAddr - } - - return proxyAdminAddr -} - -type TestCluster struct { - Config *TestClusterConfig - Servers []*TestServer - Bridge *TestBridge - initialPort int64 - - once sync.Once - failCh chan struct{} - executionErr error - - sendTxnLock sync.Mutex -} - -type ClusterOption func(*TestClusterConfig) - -func WithPremine(addresses ...types.Address) ClusterOption { - return func(h *TestClusterConfig) { - for _, a := range addresses { - h.Premine = append(h.Premine, a.String()) - } - } -} - -func WithSecretsCallback(fn func([]types.Address, *TestClusterConfig)) ClusterOption { - return func(h *TestClusterConfig) { - h.SecretsCallback = fn - } -} - -func WithNonValidators(num int) ClusterOption { - return func(h *TestClusterConfig) { - h.NonValidatorCount = num - } -} - -func WithValidatorSnapshot(validatorsLen uint64) ClusterOption { - return func(h *TestClusterConfig) { - h.ValidatorSetSize = validatorsLen - } -} - -func WithGenesisState(databasePath string, stateRoot types.Hash) ClusterOption { - return func(h *TestClusterConfig) { - h.InitialTrieDB = databasePath - h.InitialStateRoot = stateRoot - } -} - -func WithBootnodeCount(cnt int) ClusterOption { - return func(h *TestClusterConfig) { - h.BootnodeCount = cnt - } -} - -func WithEpochSize(epochSize int) ClusterOption { - return func(h *TestClusterConfig) { - h.EpochSize = epochSize - } -} - -func WithEpochReward(epochReward int) ClusterOption { - return func(h *TestClusterConfig) { - h.EpochReward = epochReward - } -} - -func WithBlockTime(blockTime time.Duration) ClusterOption { - return func(h *TestClusterConfig) { - h.BlockTime = blockTime - } -} - -func WithBlockGasLimit(blockGasLimit uint64) ClusterOption { - return func(h *TestClusterConfig) { - h.BlockGasLimit = blockGasLimit - } -} - -func WithBurnContract(burnContract *polybft.BurnContractInfo) ClusterOption { - return func(h *TestClusterConfig) { - h.BurnContract = burnContract - } -} - -func WithNumBlockConfirmations(numBlockConfirmations uint64) ClusterOption { - return func(h *TestClusterConfig) { - h.NumBlockConfirmations = numBlockConfirmations - } -} - -func WithContractDeployerAllowListAdmin(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.ContractDeployerAllowListAdmin = append(h.ContractDeployerAllowListAdmin, addr) - } -} - -func WithContractDeployerAllowListEnabled(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.ContractDeployerAllowListEnabled = append(h.ContractDeployerAllowListEnabled, addr) - } -} - -func WithContractDeployerBlockListAdmin(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.ContractDeployerBlockListAdmin = append(h.ContractDeployerBlockListAdmin, addr) - } -} - -func WithContractDeployerBlockListEnabled(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.ContractDeployerBlockListEnabled = append(h.ContractDeployerBlockListEnabled, addr) - } -} - -func WithTransactionsAllowListAdmin(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.TransactionsAllowListAdmin = append(h.TransactionsAllowListAdmin, addr) - } -} - -func WithTransactionsAllowListEnabled(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.TransactionsAllowListEnabled = append(h.TransactionsAllowListEnabled, addr) - } -} - -func WithTransactionsBlockListAdmin(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.TransactionsBlockListAdmin = append(h.TransactionsBlockListAdmin, addr) - } -} - -func WithTransactionsBlockListEnabled(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.TransactionsBlockListEnabled = append(h.TransactionsBlockListEnabled, addr) - } -} - -func WithBridgeAllowListAdmin(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.BridgeAllowListAdmin = append(h.BridgeAllowListAdmin, addr) - } -} - -func WithBridgeAllowListEnabled(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.BridgeAllowListEnabled = append(h.BridgeAllowListEnabled, addr) - } -} - -func WithBridgeBlockListAdmin(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.BridgeBlockListAdmin = append(h.BridgeBlockListAdmin, addr) - } -} - -func WithBridgeBlockListEnabled(addr types.Address) ClusterOption { - return func(h *TestClusterConfig) { - h.BridgeBlockListEnabled = append(h.BridgeBlockListEnabled, addr) - } -} - -func WithPropertyTestLogging() ClusterOption { - return func(h *TestClusterConfig) { - h.IsPropertyTest = true - } -} - -func WithNativeTokenConfig(tokenConfigRaw string) ClusterOption { - return func(h *TestClusterConfig) { - h.NativeTokenConfigRaw = tokenConfigRaw - } -} - -func WithTestRewardToken() ClusterOption { - return func(h *TestClusterConfig) { - h.TestRewardToken = hex.EncodeToString(contractsapi.TestRewardToken.DeployedBytecode) - } -} - -func WithRootTrackerPollInterval(pollInterval time.Duration) ClusterOption { - return func(h *TestClusterConfig) { - h.RootTrackerPollInterval = pollInterval - } -} - -func WithProxyContractsAdmin(address string) ClusterOption { - return func(h *TestClusterConfig) { - h.ProxyContractsAdmin = address - } -} - -func isTrueEnv(e string) bool { - return strings.ToLower(os.Getenv(e)) == "true" -} - -func NewPropertyTestCluster(t *testing.T, validatorsCount int, opts ...ClusterOption) *TestCluster { - t.Helper() - - opts = append(opts, WithPropertyTestLogging()) - - return NewTestCluster(t, validatorsCount, opts...) -} - -func NewTestCluster(t *testing.T, validatorsCount int, opts ...ClusterOption) *TestCluster { - t.Helper() - - var err error - - config := &TestClusterConfig{ - t: t, - WithLogs: isTrueEnv(envLogsEnabled), - WithStdout: isTrueEnv(envStdoutEnabled), - Binary: resolveBinary(), - EpochSize: 10, - EpochReward: 1, - BlockGasLimit: 1e7, // 10M - StakeAmounts: []*big.Int{}, - } - - if config.ValidatorPrefix == "" { - config.ValidatorPrefix = defaultValidatorPrefix - } - - for _, opt := range opts { - opt(config) - } - - if !isTrueEnv(envE2ETestsEnabled) { - var testType string - if config.IsPropertyTest { - testType = "property" - } else { - testType = "integration" - } - - t.Skip(fmt.Sprintf("%s tests are disabled.", testType)) - } - - config.TmpDir, err = os.MkdirTemp("/tmp", "e2e-polybft-") - require.NoError(t, err) - - cluster := &TestCluster{ - Servers: []*TestServer{}, - Config: config, - initialPort: 30300, - failCh: make(chan struct{}), - once: sync.Once{}, - } - - // in case no validators are specified in opts, all nodes will be validators - if cluster.Config.ValidatorSetSize == 0 { - cluster.Config.ValidatorSetSize = uint64(validatorsCount) - } - - // run init accounts for validators - addresses, err := cluster.InitSecrets(cluster.Config.ValidatorPrefix, int(cluster.Config.ValidatorSetSize)) - require.NoError(t, err) - - if cluster.Config.SecretsCallback != nil { - cluster.Config.SecretsCallback(addresses, cluster.Config) - } - - if config.NonValidatorCount > 0 { - // run init accounts for non-validators - // we don't call secrets callback on non-validators, - // since we have nothing to premine nor stake for non validators - _, err = cluster.InitSecrets(nonValidatorPrefix, config.NonValidatorCount) - require.NoError(t, err) - } - - genesisPath := path.Join(config.TmpDir, "genesis.json") - - { - // run genesis configuration population - args := []string{ - "genesis", - "--validators-path", config.TmpDir, - "--validators-prefix", cluster.Config.ValidatorPrefix, - "--dir", genesisPath, - "--block-gas-limit", strconv.FormatUint(cluster.Config.BlockGasLimit, 10), - "--epoch-size", strconv.Itoa(cluster.Config.EpochSize), - "--epoch-reward", strconv.Itoa(cluster.Config.EpochReward), - "--premine", "0x0000000000000000000000000000000000000000", - "--reward-wallet", testRewardWalletAddr.String(), - "--trieroot", cluster.Config.InitialStateRoot.String(), - } - - if cluster.Config.BlockTime != 0 { - args = append(args, "--block-time", - cluster.Config.BlockTime.String()) - } - - if cluster.Config.RootTrackerPollInterval != 0 { - args = append(args, "--block-tracker-poll-interval", - cluster.Config.RootTrackerPollInterval.String()) - } - - if cluster.Config.TestRewardToken != "" { - args = append(args, "--reward-token-code", cluster.Config.TestRewardToken) - } - - // add optional genesis flags - if cluster.Config.NativeTokenConfigRaw != "" { - args = append(args, "--native-token-config", cluster.Config.NativeTokenConfigRaw) - } - - tokenConfig, err := polybft.ParseRawTokenConfig(cluster.Config.NativeTokenConfigRaw) - require.NoError(t, err) - - if len(cluster.Config.Premine) != 0 && tokenConfig.IsMintable { - // only add premine flags in genesis if token is mintable - for _, premine := range cluster.Config.Premine { - args = append(args, "--premine", premine) - } - } - - burnContract := cluster.Config.BurnContract - if burnContract != nil { - args = append(args, "--burn-contract", - fmt.Sprintf("%d:%s:%s", - burnContract.BlockNumber, burnContract.Address, burnContract.DestinationAddress)) - } - - validators, err := genesis.ReadValidatorsByPrefix( - cluster.Config.TmpDir, cluster.Config.ValidatorPrefix) - require.NoError(t, err) - - if cluster.Config.BootnodeCount > 0 { - bootNodesCnt := cluster.Config.BootnodeCount - if len(validators) < bootNodesCnt { - bootNodesCnt = len(validators) - } - - for i := 0; i < bootNodesCnt; i++ { - args = append(args, "--bootnode", validators[i].MultiAddr) - } - } - - if len(cluster.Config.ContractDeployerAllowListAdmin) != 0 { - args = append(args, "--contract-deployer-allow-list-admin", - strings.Join(sliceAddressToSliceString(cluster.Config.ContractDeployerAllowListAdmin), ",")) - } - - if len(cluster.Config.ContractDeployerAllowListEnabled) != 0 { - args = append(args, "--contract-deployer-allow-list-enabled", - strings.Join(sliceAddressToSliceString(cluster.Config.ContractDeployerAllowListEnabled), ",")) - } - - if len(cluster.Config.ContractDeployerBlockListAdmin) != 0 { - args = append(args, "--contract-deployer-block-list-admin", - strings.Join(sliceAddressToSliceString(cluster.Config.ContractDeployerBlockListAdmin), ",")) - } - - if len(cluster.Config.ContractDeployerBlockListEnabled) != 0 { - args = append(args, "--contract-deployer-block-list-enabled", - strings.Join(sliceAddressToSliceString(cluster.Config.ContractDeployerBlockListEnabled), ",")) - } - - if len(cluster.Config.TransactionsAllowListAdmin) != 0 { - args = append(args, "--transactions-allow-list-admin", - strings.Join(sliceAddressToSliceString(cluster.Config.TransactionsAllowListAdmin), ",")) - } - - if len(cluster.Config.TransactionsAllowListEnabled) != 0 { - args = append(args, "--transactions-allow-list-enabled", - strings.Join(sliceAddressToSliceString(cluster.Config.TransactionsAllowListEnabled), ",")) - } - - if len(cluster.Config.TransactionsBlockListAdmin) != 0 { - args = append(args, "--transactions-block-list-admin", - strings.Join(sliceAddressToSliceString(cluster.Config.TransactionsBlockListAdmin), ",")) - } - - if len(cluster.Config.TransactionsBlockListEnabled) != 0 { - args = append(args, "--transactions-block-list-enabled", - strings.Join(sliceAddressToSliceString(cluster.Config.TransactionsBlockListEnabled), ",")) - } - - if len(cluster.Config.BridgeAllowListAdmin) != 0 { - args = append(args, "--bridge-allow-list-admin", - strings.Join(sliceAddressToSliceString(cluster.Config.BridgeAllowListAdmin), ",")) - } - - if len(cluster.Config.BridgeAllowListEnabled) != 0 { - args = append(args, "--bridge-allow-list-enabled", - strings.Join(sliceAddressToSliceString(cluster.Config.BridgeAllowListEnabled), ",")) - } - - if len(cluster.Config.BridgeBlockListAdmin) != 0 { - args = append(args, "--bridge-block-list-admin", - strings.Join(sliceAddressToSliceString(cluster.Config.BridgeBlockListAdmin), ",")) - } - - if len(cluster.Config.BridgeBlockListEnabled) != 0 { - args = append(args, "--bridge-block-list-enabled", - strings.Join(sliceAddressToSliceString(cluster.Config.BridgeBlockListEnabled), ",")) - } - - proxyAdminAddr := cluster.Config.ProxyContractsAdmin - if proxyAdminAddr == "" { - proxyAdminAddr = ProxyContractAdminAddr - } - args = append(args, "--proxy-contracts-admin", proxyAdminAddr) - - // run genesis command with all the arguments - err = cluster.cmdRun(args...) - require.NoError(t, err) - } - - // start bridge - cluster.Bridge, err = NewTestBridge(t, cluster.Config) - require.NoError(t, err) - - // deploy stake manager contract - err = cluster.Bridge.deployStakeManager(genesisPath) - require.NoError(t, err) - - // deploy rootchain contracts - err = cluster.Bridge.deployRootchainContracts(genesisPath) - require.NoError(t, err) - - polybftConfig, err := polybft.LoadPolyBFTConfig(genesisPath) - require.NoError(t, err) - - tokenConfig, err := polybft.ParseRawTokenConfig(cluster.Config.NativeTokenConfigRaw) - require.NoError(t, err) - - // fund addresses on the rootchain - err = cluster.Bridge.fundAddressesOnRoot(tokenConfig, polybftConfig) - require.NoError(t, err) - - // whitelist genesis validators on the rootchain - err = cluster.Bridge.whitelistValidators(addresses, polybftConfig) - require.NoError(t, err) - - // register genesis validators on the rootchain - err = cluster.Bridge.registerGenesisValidators(polybftConfig) - require.NoError(t, err) - - // do initial staking for genesis validators on the rootchain - err = cluster.Bridge.initialStakingOfGenesisValidators(polybftConfig) - require.NoError(t, err) - - // add premine if token is non-mintable - err = cluster.Bridge.mintNativeRootToken(addresses, tokenConfig, polybftConfig) - require.NoError(t, err) - - err = cluster.Bridge.premineNativeRootToken(tokenConfig, polybftConfig) - require.NoError(t, err) - - // finalize genesis validators on the rootchain - err = cluster.Bridge.finalizeGenesis(genesisPath, polybftConfig) - require.NoError(t, err) - - for i := 1; i <= int(cluster.Config.ValidatorSetSize); i++ { - nodeType := Validator - if i == 1 { - nodeType.Append(Relayer) - } - - dir := cluster.Config.ValidatorPrefix + strconv.Itoa(i) - cluster.InitTestServer(t, dir, cluster.Bridge.JSONRPCAddr(), nodeType) - } - - for i := 1; i <= cluster.Config.NonValidatorCount; i++ { - dir := nonValidatorPrefix + strconv.Itoa(i) - cluster.InitTestServer(t, dir, cluster.Bridge.JSONRPCAddr(), None) - } - - return cluster -} - -func (c *TestCluster) InitTestServer(t *testing.T, - dataDir string, bridgeJSONRPC string, nodeType NodeType) { - t.Helper() - - logLevel := os.Getenv(envLogLevel) - - dataDir = c.Config.Dir(dataDir) - if c.Config.InitialTrieDB != "" { - err := CopyDir(c.Config.InitialTrieDB, filepath.Join(dataDir, "trie")) - if err != nil { - t.Fatal(err) - } - } - - srv := NewTestServer(t, c.Config, bridgeJSONRPC, func(config *TestServerConfig) { - config.DataDir = dataDir - config.Validator = nodeType.IsSet(Validator) - config.Chain = c.Config.Dir("genesis.json") - config.P2PPort = c.getOpenPort() - config.LogLevel = logLevel - config.Relayer = nodeType.IsSet(Relayer) - config.NumBlockConfirmations = c.Config.NumBlockConfirmations - config.BridgeJSONRPC = bridgeJSONRPC - }) - - // watch the server for stop signals. It is important to fix the specific - // 'node' reference since 'TestServer' creates a new one if restarted. - go func(node *node) { - <-node.Wait() - - if !node.ExitResult().Signaled { - c.Fail(fmt.Errorf("server at dir '%s' has stopped unexpectedly", dataDir)) - } - }(srv.node) - - c.Servers = append(c.Servers, srv) -} - -func (c *TestCluster) cmdRun(args ...string) error { - return runCommand(c.Config.Binary, args, c.Config.GetStdout(args[0])) -} - -func (c *TestCluster) Fail(err error) { - c.once.Do(func() { - c.executionErr = err - close(c.failCh) - }) -} - -func (c *TestCluster) Stop() { - if c.Bridge != nil { - c.Bridge.Stop() - } - - for _, srv := range c.Servers { - if srv.isRunning() { - srv.Stop() - } - } -} - -func (c *TestCluster) Stats(t *testing.T) { - t.Helper() - - for index, i := range c.Servers { - if !i.isRunning() { - continue - } - - num, err := i.JSONRPC().Eth().BlockNumber() - t.Log("Stats node", index, "err", err, "block", num, "validator", i.config.Validator) - } -} - -func (c *TestCluster) WaitUntil(timeout, pollFrequency time.Duration, handler func() bool) error { - timer := time.NewTimer(timeout) - defer timer.Stop() - - for { - select { - case <-timer.C: - return fmt.Errorf("timeout") - case <-c.failCh: - return c.executionErr - case <-time.After(pollFrequency): - } - - if handler() { - return nil - } - } -} - -func (c *TestCluster) WaitForReady(t *testing.T) { - t.Helper() - - require.NoError(t, c.WaitForBlock(1, time.Minute)) -} - -func (c *TestCluster) WaitForBlock(n uint64, timeout time.Duration) error { - timer := time.NewTimer(timeout) - - ok := false - for !ok { - select { - case <-timer.C: - return fmt.Errorf("wait for block timeout") - case <-time.After(2 * time.Second): - } - - ok = true - - for _, i := range c.Servers { - if !i.isRunning() { - continue - } - - num, err := i.JSONRPC().Eth().BlockNumber() - - if err != nil || num < n { - ok = false - - break - } - } - } - - return nil -} - -// WaitForGeneric waits until all running servers returns true from fn callback or timeout defined by dur occurs -func (c *TestCluster) WaitForGeneric(dur time.Duration, fn func(*TestServer) bool) error { - return c.WaitUntil(dur, 2*time.Second, func() bool { - for _, srv := range c.Servers { - // query only running servers - if srv.isRunning() && !fn(srv) { - return false - } - } - - return true - }) -} - -func (c *TestCluster) getOpenPort() int64 { - c.initialPort++ - - return c.initialPort -} - -// runCommand executes command with given arguments -func runCommand(binary string, args []string, stdout io.Writer) error { - var stdErr bytes.Buffer - - cmd := exec.Command(binary, args...) - cmd.Stderr = &stdErr - cmd.Stdout = stdout - - if err := cmd.Run(); err != nil { - if stdErr.Len() > 0 { - return fmt.Errorf("failed to execute command: %s", stdErr.String()) - } - - return fmt.Errorf("failed to execute command: %w", err) - } - - if stdErr.Len() > 0 { - return fmt.Errorf("error during command execution: %s", stdErr.String()) - } - - return nil -} - -// RunEdgeCommand - calls a command line edge function -func RunEdgeCommand(args []string, stdout io.Writer) error { - return runCommand(resolveBinary(), args, stdout) -} - -// InitSecrets initializes account(s) secrets with given prefix. -// (secrets are being stored in the temp directory created by given e2e test execution) -func (c *TestCluster) InitSecrets(prefix string, count int) ([]types.Address, error) { - var b bytes.Buffer - - args := []string{ - "polybft-secrets", - "--data-dir", path.Join(c.Config.TmpDir, prefix), - "--num", strconv.Itoa(count), - "--insecure", - } - stdOut := c.Config.GetStdout("polybft-secrets", &b) - - if err := runCommand(c.Config.Binary, args, stdOut); err != nil { - return nil, err - } - - re := regexp.MustCompile("\\(address\\) = 0x([a-fA-F0-9]+)") - parsed := re.FindAllStringSubmatch(b.String(), -1) - result := make([]types.Address, len(parsed)) - - for i, v := range parsed { - result[i] = types.StringToAddress(v[1]) - } - - return result, nil -} - -func (c *TestCluster) ExistsCode(t *testing.T, addr ethgo.Address) bool { - t.Helper() - - client, err := jsonrpc.NewClient(c.Servers[0].JSONRPCAddr()) - require.NoError(t, err) - - code, err := client.Eth().GetCode(addr, ethgo.Latest) - if err != nil { - return false - } - - return code != "0x" -} - -func (c *TestCluster) Call(t *testing.T, to types.Address, method *abi.Method, - args ...interface{}) map[string]interface{} { - t.Helper() - - client, err := jsonrpc.NewClient(c.Servers[0].JSONRPCAddr()) - require.NoError(t, err) - - input, err := method.Encode(args) - require.NoError(t, err) - - toAddr := ethgo.Address(to) - - msg := ðgo.CallMsg{ - To: &toAddr, - Data: input, - } - resp, err := client.Eth().Call(msg, ethgo.Latest) - require.NoError(t, err) - - data, err := hex.DecodeString(resp[2:]) - require.NoError(t, err) - - output, err := method.Decode(data) - require.NoError(t, err) - - return output -} - -func (c *TestCluster) Deploy(t *testing.T, sender ethgo.Key, bytecode []byte) *TestTxn { - t.Helper() - - return c.SendTxn(t, sender, ðgo.Transaction{From: sender.Address(), Input: bytecode}) -} - -func (c *TestCluster) Transfer(t *testing.T, sender ethgo.Key, target types.Address, value *big.Int) *TestTxn { - t.Helper() - - targetAddr := ethgo.Address(target) - - return c.SendTxn(t, sender, ðgo.Transaction{From: sender.Address(), To: &targetAddr, Value: value}) -} - -func (c *TestCluster) MethodTxn(t *testing.T, sender ethgo.Key, target types.Address, input []byte) *TestTxn { - t.Helper() - - targetAddr := ethgo.Address(target) - - return c.SendTxn(t, sender, ðgo.Transaction{From: sender.Address(), To: &targetAddr, Input: input}) -} - -// SendTxn sends a transaction -func (c *TestCluster) SendTxn(t *testing.T, sender ethgo.Key, txn *ethgo.Transaction) *TestTxn { - t.Helper() - - // since we might use get nonce to query the latest nonce and that value is only - // updated if the transaction is on the pool, it is recommended to lock the whole - // execution in case we send multiple transactions from the same account and we expect - // to get a sequential nonce order. - c.sendTxnLock.Lock() - defer c.sendTxnLock.Unlock() - - client, err := jsonrpc.NewClient(c.Servers[0].JSONRPCAddr()) - require.NoError(t, err) - - // initialize transaction values if not set - if txn.Nonce == 0 { - nonce, err := client.Eth().GetNonce(sender.Address(), ethgo.Latest) - require.NoError(t, err) - - txn.Nonce = nonce - } - - if txn.GasPrice == 0 { - gasPrice, err := client.Eth().GasPrice() - require.NoError(t, err) - - txn.GasPrice = gasPrice - } - - if txn.Gas == 0 { - callMsg := txrelayer.ConvertTxnToCallMsg(txn) - - gasLimit, err := client.Eth().EstimateGas(callMsg) - if err != nil { - // gas estimation can fail in case an account is not allow-listed - // (fallback it to default gas limit in that case) - txn.Gas = txrelayer.DefaultGasLimit - } else { - txn.Gas = gasLimit - } - } - - chainID, err := client.Eth().ChainID() - require.NoError(t, err) - - signer := wallet.NewEIP155Signer(chainID.Uint64()) - signedTxn, err := signer.SignTx(txn, sender) - require.NoError(t, err) - - txnRaw, err := signedTxn.MarshalRLPTo(nil) - require.NoError(t, err) - - hash, err := client.Eth().SendRawTransaction(txnRaw) - require.NoError(t, err) - - return &TestTxn{ - client: client.Eth(), - txn: txn, - hash: hash, - } -} - -type TestTxn struct { - client *jsonrpc.Eth - hash ethgo.Hash - txn *ethgo.Transaction - receipt *ethgo.Receipt -} - -// Txn returns the raw transaction that was sent -func (t *TestTxn) Txn() *ethgo.Transaction { - return t.txn -} - -// Receipt returns the receipt of the transaction -func (t *TestTxn) Receipt() *ethgo.Receipt { - return t.receipt -} - -// Succeed returns whether the transaction succeed and it was not reverted -func (t *TestTxn) Succeed() bool { - return t.receipt.Status == uint64(types.ReceiptSuccess) -} - -// Failed returns whether the transaction failed -func (t *TestTxn) Failed() bool { - return t.receipt.Status == uint64(types.ReceiptFailed) -} - -// Reverted returns whether the transaction failed and was reverted consuming -// all the gas from the call -func (t *TestTxn) Reverted() bool { - return t.receipt.Status == uint64(types.ReceiptFailed) && t.txn.Gas == t.receipt.GasUsed -} - -// Wait waits for the transaction to be executed -func (t *TestTxn) Wait() error { - tt := time.NewTimer(1 * time.Minute) - - for { - select { - case <-time.After(100 * time.Millisecond): - receipt, err := t.client.GetTransactionReceipt(t.hash) - if err != nil { - if err.Error() != "not found" { - return err - } - } - - if receipt != nil { - t.receipt = receipt - - return nil - } - - case <-tt.C: - return fmt.Errorf("timeout") - } - } -} - -func sliceAddressToSliceString(addrs []types.Address) []string { - res := make([]string, len(addrs)) - for indx, addr := range addrs { - res[indx] = addr.String() - } - - return res -} - -func CopyDir(source, destination string) error { - err := os.Mkdir(destination, 0755) - if err != nil { - return err - } - - return filepath.Walk(source, func(path string, info os.FileInfo, err error) error { - relPath := strings.Replace(path, source, "", 1) - if relPath == "" { - return nil - } - - data, err := os.ReadFile(filepath.Join(source, relPath)) - if err != nil { - return err - } - - return os.WriteFile(filepath.Join(destination, relPath), data, 0600) - }) -} diff --git a/e2e-polybft/framework/test-server.go b/e2e-polybft/framework/test-server.go deleted file mode 100644 index 2641437..0000000 --- a/e2e-polybft/framework/test-server.go +++ /dev/null @@ -1,385 +0,0 @@ -package framework - -import ( - "errors" - "fmt" - "math/big" - "os" - "strconv" - "strings" - "sync/atomic" - "testing" - "time" - - "github.com/google/uuid" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/jsonrpc" - "github.com/xgr-network/xgr-node/command/polybftsecrets" - rootHelper "github.com/xgr-network/xgr-node/command/rootchain/helper" - "github.com/xgr-network/xgr-node/consensus/polybft" - "github.com/xgr-network/xgr-node/consensus/polybft/validator" - "github.com/xgr-network/xgr-node/consensus/polybft/wallet" - "github.com/xgr-network/xgr-node/server/proto" - txpoolProto "github.com/xgr-network/xgr-node/txpool/proto" - "github.com/xgr-network/xgr-node/types" - "google.golang.org/grpc" -) - -type TestServerConfig struct { - Name string - JSONRPCPort int64 - GRPCPort int64 - P2PPort int64 - Validator bool - DataDir string - Chain string - LogLevel string - Relayer bool - NumBlockConfirmations uint64 - BridgeJSONRPC string -} - -type TestServerConfigCallback func(*TestServerConfig) - -const hostIP = "127.0.0.1" - -var initialPortForServer = int64(12000) - -func getOpenPortForServer() int64 { - return atomic.AddInt64(&initialPortForServer, 1) -} - -type TestServer struct { - t *testing.T - - address types.Address - clusterConfig *TestClusterConfig - config *TestServerConfig - node *node -} - -func (t *TestServer) GrpcAddr() string { - return fmt.Sprintf("%s:%d", hostIP, t.config.GRPCPort) -} - -func (t *TestServer) JSONRPCAddr() string { - return fmt.Sprintf("http://%s:%d", hostIP, t.config.JSONRPCPort) -} - -func (t *TestServer) BridgeJSONRPCAddr() string { - return t.config.BridgeJSONRPC -} - -func (t *TestServer) JSONRPC() *jsonrpc.Client { - clt, err := jsonrpc.NewClient(t.JSONRPCAddr()) - if err != nil { - t.t.Fatal(err) - } - - return clt -} - -func (t *TestServer) Conn() proto.SystemClient { - conn, err := grpc.Dial(t.GrpcAddr(), grpc.WithInsecure()) - if err != nil { - t.t.Fatal(err) - } - - return proto.NewSystemClient(conn) -} - -func (t *TestServer) DataDir() string { - return t.config.DataDir -} - -func (t *TestServer) TxnPoolOperator() txpoolProto.TxnPoolOperatorClient { - conn, err := grpc.Dial(t.GrpcAddr(), grpc.WithInsecure()) - if err != nil { - t.t.Fatal(err) - } - - return txpoolProto.NewTxnPoolOperatorClient(conn) -} - -func NewTestServer(t *testing.T, clusterConfig *TestClusterConfig, - bridgeJSONRPC string, callback TestServerConfigCallback) *TestServer { - t.Helper() - - config := &TestServerConfig{ - Name: uuid.New().String(), - JSONRPCPort: getOpenPortForServer(), - GRPCPort: getOpenPortForServer(), - P2PPort: getOpenPortForServer(), - BridgeJSONRPC: bridgeJSONRPC, - } - - if callback != nil { - callback(config) - } - - if config.DataDir == "" { - dataDir, err := os.MkdirTemp("/tmp", "edge-e2e-") - require.NoError(t, err) - - config.DataDir = dataDir - } - - secretsManager, err := polybftsecrets.GetSecretsManager(config.DataDir, "", true) - require.NoError(t, err) - - key, err := wallet.GetEcdsaFromSecret(secretsManager) - require.NoError(t, err) - - srv := &TestServer{ - t: t, - clusterConfig: clusterConfig, - address: types.Address(key.Address()), - config: config, - } - srv.Start() - - return srv -} - -func (t *TestServer) isRunning() bool { - return t.node != nil -} - -func (t *TestServer) Start() { - config := t.config - - // Build arguments - args := []string{ - "server", - // add data dir - "--" + polybftsecrets.AccountDirFlag, config.DataDir, - // add custom chain - "--chain", config.Chain, - // enable p2p port - "--libp2p", fmt.Sprintf(":%d", config.P2PPort), - // grpc port - "--grpc-address", fmt.Sprintf("localhost:%d", config.GRPCPort), - // enable jsonrpc - "--jsonrpc", fmt.Sprintf(":%d", config.JSONRPCPort), - // minimal number of child blocks required for the parent block to be considered final - "--num-block-confirmations", strconv.FormatUint(config.NumBlockConfirmations, 10), - } - - if len(config.LogLevel) > 0 { - args = append(args, "--log-level", config.LogLevel) - } else { - args = append(args, "--log-level", "DEBUG") - } - - if config.Relayer { - args = append(args, "--relayer") - } - - // Start the server - stdout := t.clusterConfig.GetStdout(t.config.Name) - - node, err := newNode(t.clusterConfig.Binary, args, stdout) - if err != nil { - t.t.Fatal(err) - } - - t.node = node -} - -func (t *TestServer) Stop() { - if err := t.node.Stop(); err != nil { - t.t.Fatal(err) - } - - t.node = nil -} - -// RootchainFund funds given validator account on the rootchain -func (t *TestServer) RootchainFund(stakeToken types.Address, amount *big.Int) error { - return t.RootchainFundFor([]types.Address{t.address}, []*big.Int{amount}, stakeToken) -} - -// RootchainFundFor funds given account on the rootchain -func (t *TestServer) RootchainFundFor(accounts []types.Address, amounts []*big.Int, stakeToken types.Address) error { - if len(accounts) != len(amounts) { - return errors.New("same size for accounts and amounts must be provided to the rootchain funding") - } - - args := []string{ - "rootchain", - "fund", - "--json-rpc", t.BridgeJSONRPCAddr(), - "--stake-token", stakeToken.String(), - "--mint", - } - - for i := 0; i < len(accounts); i++ { - args = append(args, "--addresses", accounts[i].String()) - args = append(args, "--amounts", amounts[i].String()) - } - - if err := runCommand(t.clusterConfig.Binary, args, t.clusterConfig.GetStdout("bridge")); err != nil { - acctAddrs := make([]string, len(accounts)) - for i, acc := range accounts { - acctAddrs[i] = acc.String() - } - - return fmt.Errorf("failed to fund accounts (%s) on the rootchain: %w", strings.Join(acctAddrs, ","), err) - } - - return nil -} - -// Stake stakes given amount to validator account encapsulated by given server instance -func (t *TestServer) Stake(polybftConfig polybft.PolyBFTConfig, amount *big.Int) error { - args := []string{ - "polybft", - "stake", - "--jsonrpc", t.BridgeJSONRPCAddr(), - "--stake-manager", polybftConfig.Bridge.StakeManagerAddr.String(), - "--" + polybftsecrets.AccountDirFlag, t.config.DataDir, - "--amount", amount.String(), - "--supernet-id", strconv.FormatInt(polybftConfig.SupernetID, 10), - "--stake-token", polybftConfig.Bridge.StakeTokenAddr.String(), - } - - return runCommand(t.clusterConfig.Binary, args, t.clusterConfig.GetStdout("stake")) -} - -// Unstake unstakes given amount from validator account encapsulated by given server instance -func (t *TestServer) Unstake(amount *big.Int) error { - args := []string{ - "polybft", - "unstake", - "--" + polybftsecrets.AccountDirFlag, t.config.DataDir, - "--jsonrpc", t.JSONRPCAddr(), - "--amount", amount.String(), - } - - return runCommand(t.clusterConfig.Binary, args, t.clusterConfig.GetStdout("unstake")) -} - -// RegisterValidator is a wrapper function which registers new validator on a root chain -func (t *TestServer) RegisterValidator(supernetManagerAddr types.Address) error { - args := []string{ - "polybft", - "register-validator", - "--jsonrpc", t.BridgeJSONRPCAddr(), - "--supernet-manager", supernetManagerAddr.String(), - "--" + polybftsecrets.AccountDirFlag, t.DataDir(), - } - - return runCommand(t.clusterConfig.Binary, args, t.clusterConfig.GetStdout("bridge")) -} - -// WhitelistValidators invokes whitelist-validators helper CLI command, -// that whitelists validators on the root chain -func (t *TestServer) WhitelistValidators(addresses []string, supernetManager types.Address) error { - args := []string{ - "polybft", - "whitelist-validators", - "--private-key", rootHelper.TestAccountPrivKey, - "--jsonrpc", t.BridgeJSONRPCAddr(), - "--supernet-manager", supernetManager.String(), - } - for _, addr := range addresses { - args = append(args, "--addresses", addr) - } - - return runCommand(t.clusterConfig.Binary, args, t.clusterConfig.GetStdout("bridge")) -} - -// WithdrawChildChain withdraws available balance from child chain -func (t *TestServer) WithdrawChildChain() error { - args := []string{ - "polybft", - "withdraw-child", - "--" + polybftsecrets.AccountDirFlag, t.config.DataDir, - "--jsonrpc", t.JSONRPCAddr(), - } - - return runCommand(t.clusterConfig.Binary, args, t.clusterConfig.GetStdout("withdraw-child")) -} - -// WithdrawRootChain withdraws available balance from root chain -func (t *TestServer) WithdrawRootChain(recipient string, amount *big.Int, - stakeManager ethgo.Address, bridgeJSONRPC string) error { - args := []string{ - "polybft", - "withdraw-root", - "--" + polybftsecrets.AccountDirFlag, t.config.DataDir, - "--to", recipient, - "--amount", amount.String(), - "--stake-manager", stakeManager.String(), - "--jsonrpc", bridgeJSONRPC, - } - - return runCommand(t.clusterConfig.Binary, args, t.clusterConfig.GetStdout("withdraw-root")) -} - -// WithdrawRewards withdraws pending rewards for given validator on RewardPool contract -func (t *TestServer) WithdrawRewards() error { - args := []string{ - "polybft", - "withdraw-rewards", - "--" + polybftsecrets.AccountDirFlag, t.config.DataDir, - "--jsonrpc", t.JSONRPCAddr(), - } - - return runCommand(t.clusterConfig.Binary, args, t.clusterConfig.GetStdout("withdraw-rewards")) -} - -// HasValidatorSealed checks whether given validator has signed at least single block for the given range of blocks -func (t *TestServer) HasValidatorSealed(firstBlock, lastBlock uint64, validators validator.AccountSet, - validatorAddr ethgo.Address) (bool, error) { - rpcClient := t.JSONRPC() - for i := firstBlock + 1; i <= lastBlock; i++ { - block, err := rpcClient.Eth().GetBlockByNumber(ethgo.BlockNumber(i), false) - if err != nil { - return false, err - } - - extra, err := polybft.GetIbftExtra(block.ExtraData) - if err != nil { - return false, err - } - - signers, err := validators.GetFilteredValidators(extra.Parent.Bitmap) - if err != nil { - return false, err - } - - if signers.ContainsAddress(types.Address(validatorAddr)) { - return true, nil - } - } - - return false, nil -} - -func (t *TestServer) WaitForNonZeroBalance(address ethgo.Address, dur time.Duration) (*big.Int, error) { - timer := time.NewTimer(dur) - defer timer.Stop() - - ticker := time.NewTicker(150 * time.Millisecond) - defer ticker.Stop() - - rpcClient := t.JSONRPC() - - for { - select { - case <-timer.C: - return nil, fmt.Errorf("timeout occurred while waiting for balance ") - case <-ticker.C: - balance, err := rpcClient.Eth().GetBalance(address, ethgo.Latest) - if err != nil { - return nil, fmt.Errorf("error getting balance") - } - - if balance.Cmp(big.NewInt(0)) == 1 { - return balance, nil - } - } - } -} diff --git a/e2e-polybft/grpc_validation_test.go b/e2e-polybft/grpc_validation_test.go deleted file mode 100644 index 476ce0e..0000000 --- a/e2e-polybft/grpc_validation_test.go +++ /dev/null @@ -1,46 +0,0 @@ -package e2e - -import ( - "context" - "testing" - "time" - - "github.com/stretchr/testify/require" - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - serverProto "github.com/xgr-network/xgr-node/server/proto" - txpoolProto "github.com/xgr-network/xgr-node/txpool/proto" - "google.golang.org/protobuf/types/known/emptypb" -) - -// Tests if interceptor triggers validation of grpc requests -func TestE2E_GRPCRequestValidationTriggering(t *testing.T) { - const ( - validatorCount = 5 - testTimeout = time.Second * 30 - ) - - // create cluster - cluster := framework.NewTestCluster(t, validatorCount, - framework.WithValidatorSnapshot(validatorCount)) - defer cluster.Stop() - - ctx := context.Background() - err := cluster.WaitUntil(testTimeout, 2*time.Second, func() bool { - peerList, err := cluster.Servers[0].Conn().PeersList(ctx, &emptypb.Empty{}) - - return err == nil && len(peerList.GetPeers()) > 0 - }) - require.NoError(t, err) - - // SystemService - // call PeersStatus with invalid data - _, err = cluster.Servers[0].Conn().PeersStatus(ctx, &serverProto.PeersStatusRequest{Id: "-1"}) - require.Error(t, err) - require.Contains(t, err.Error(), "request validation failed: invalid PeersStatusRequest.Id: value does not match regex pattern") - - //TxnPoolOperatorService - // call AddTxn with invalid data - _, err = cluster.Servers[0].TxnPoolOperator().AddTxn(ctx, &txpoolProto.AddTxnReq{Raw: nil, From: "12"}) - require.Error(t, err) - require.Contains(t, err.Error(), "request validation failed: invalid AddTxnReq.Raw: value is required; invalid AddTxnReq.From: value does not match regex pattern") -} diff --git a/e2e-polybft/property/property_test.go b/e2e-polybft/property/property_test.go deleted file mode 100644 index aee76ad..0000000 --- a/e2e-polybft/property/property_test.go +++ /dev/null @@ -1,135 +0,0 @@ -package property - -import ( - "fmt" - "math/big" - "path/filepath" - "sync" - "testing" - "time" - - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo/wallet" - "pgregory.net/rapid" - - "github.com/xgr-network/xgr-node/e2e-polybft/framework" - "github.com/xgr-network/xgr-node/types" -) - -func TestProperty_DifferentVotingPower(t *testing.T) { - const ( - blockTime = time.Second * 6 - maxStake = 20 - ) - - minter, err := wallet.GenerateKey() - require.NoError(t, err) - - rapid.Check(t, func(tt *rapid.T) { - var ( - numNodes = rapid.Uint64Range(5, 8).Draw(tt, "number of cluster nodes") - epochSize = rapid.OneOf(rapid.Just(4), rapid.Just(10)).Draw(tt, "epoch size") - numBlocks = rapid.Uint64Range(2, 5).Draw(tt, "number of blocks the cluster should mine") - ) - - stakes := make([]*big.Int, numNodes) - - // stake amount will determine validator's stake and therefore voting power - for i := range stakes { - stakes[i] = new(big.Int). - SetUint64(rapid.Uint64Range(1, maxStake). - Draw(tt, fmt.Sprintf("stake for node %d", i+1))) - } - - cluster := framework.NewPropertyTestCluster(t, int(numNodes), - framework.WithEpochSize(epochSize), - framework.WithBlockTime(blockTime), - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, minter.Address())), - framework.WithSecretsCallback(func(adresses []types.Address, config *framework.TestClusterConfig) { - for i := range adresses { - config.StakeAmounts = append(config.StakeAmounts, stakes[i]) - } - })) - defer cluster.Stop() - - t.Logf("Test %v, run with %d nodes, epoch size: %d. Number of blocks to mine: %d", - filepath.Base(cluster.Config.LogsDir), numNodes, epochSize, numBlocks) - - // wait for single epoch to process withdrawal - require.NoError(t, cluster.WaitForBlock(numBlocks, 2*blockTime*time.Duration(numBlocks))) - }) -} - -func TestProperty_DropValidators(t *testing.T) { - const ( - blockTime = time.Second * 4 - ) - - minter, err := wallet.GenerateKey() - require.NoError(t, err) - - rapid.Check(t, func(tt *rapid.T) { - var ( - numNodes = rapid.Uint64Range(5, 8).Draw(tt, "number of cluster nodes") - epochSize = rapid.OneOf(rapid.Just(4), rapid.Just(10)).Draw(tt, "epoch size") - ) - - cluster := framework.NewPropertyTestCluster(t, int(numNodes), - framework.WithEpochSize(epochSize), - framework.WithBlockTime(blockTime), - framework.WithNativeTokenConfig(fmt.Sprintf(framework.NativeTokenMintableTestCfg, minter.Address())), - framework.WithSecretsCallback(func(adresses []types.Address, config *framework.TestClusterConfig) { - for range adresses { - config.StakeAmounts = append(config.StakeAmounts, big.NewInt(20)) - } - })) - defer cluster.Stop() - - t.Logf("Test %v, run with %d nodes, epoch size: %d", - filepath.Base(cluster.Config.LogsDir), numNodes, epochSize) - - cluster.WaitForReady(t) - - // stop first validator, block production should continue - cluster.Servers[0].Stop() - activeValidator := cluster.Servers[numNodes-1] - currentBlock, err := activeValidator.JSONRPC().Eth().BlockNumber() - require.NoError(t, err) - require.NoError(t, cluster.WaitForBlock(currentBlock+1, 2*blockTime)) - - // drop all validator nodes, leaving one node alive - numNodesToDrop := int(numNodes - 1) - - var wg sync.WaitGroup - // drop bulk of nodes from cluster - for i := 1; i < numNodesToDrop; i++ { - node := cluster.Servers[i] - - wg.Add(1) - - go func(node *framework.TestServer) { - defer wg.Done() - node.Stop() - }(node) - } - - wg.Wait() - - // check that block production is stoped - currentBlock, err = activeValidator.JSONRPC().Eth().BlockNumber() - require.NoError(t, err) - oldBlockNumber := currentBlock - time.Sleep(2 * blockTime) - currentBlock, err = activeValidator.JSONRPC().Eth().BlockNumber() - require.NoError(t, err) - require.Equal(t, oldBlockNumber, currentBlock) - - // start dropped nodes again - for i := 0; i < numNodesToDrop; i++ { - node := cluster.Servers[i] - node.Start() - } - - require.NoError(t, cluster.WaitForBlock(oldBlockNumber+1, 3*blockTime)) - }) -} diff --git a/e2e/TEST_CATALOG.md b/e2e/TEST_CATALOG.md new file mode 100644 index 0000000..e3fbacf --- /dev/null +++ b/e2e/TEST_CATALOG.md @@ -0,0 +1,56 @@ +# E2E Test Catalog (XGR 2.0 / StakingV2) + +This catalog documents the currently maintained E2E test surface under `e2e/...` (including `e2e/framework`) for the current XGR 2.0 / StakingV2 stack. + +## Status legend + +| Status | Meaning | +|---|---| +| active | Production E2E test currently exercised in the repository. | +| skipped | Test exists but is intentionally skipped (`t.Skip(...)`). | +| framework-only | Verifies E2E harness behavior rather than chain domain logic. | +| diagnostics | Observation-oriented test; useful for behavior evidence, not always a strict product invariant in every path. | + +## Core chain / RPC / tx / sync + +Representative active coverage: + +- `e2e/discovery_test.go` β†’ peer discovery and convergence +- `e2e/jsonrpc_test.go` β†’ JSON-RPC baseline behavior +- `e2e/transaction_test.go` β†’ premine, transfer, IBFT transaction loop +- `e2e/txpool_test.go` β†’ txpool error codes, coalescing, pending retrieval +- `e2e/logs_test.go` β†’ filter creation and log/block retrieval +- `e2e/websocket_test.go` β†’ websocket RPC behavior +- `e2e/genesis_test.go` β†’ genesis gas limit and predeploy checks +- `e2e/ibft_test.go` β†’ IBFT transfer and fee-recipient semantics +- `e2e/syncer_test.go` β†’ cluster catch-up / block synchronization + +## XGR 2.0 / StakingV2 (selection, lifecycle, operations) + +Primary coverage areas: + +- Delegation pool defaults and open-flow (`pos_stakingv2_delegation_pool_test.go`) +- Validator lifecycle around min-stake, epoch gating, unstake/withdraw boundaries +- Delegator lifecycle (pool gating, active/inactive transitions, withdraw/exit) +- Tier transitions and fallbacks (Tier1 β†’ Tier2 β†’ Tier3 and recovery) +- Max-validator cap behavior and deterministic tie-breaking +- Small validator set liveness documentation (1/2/3 validators) +- Restart/resync behavior across Tier1/Tier2/Tier3 setups + +## Beacon recovery & diagnostics + +Beacon recovery diagnostics were removed from the maintained E2E surface because they exercised obsolete recovery-only paths. + + +## Intentionally skipped tests + +- `TestBroadcast` (`e2e/broadcast_test.go`): skipped because topology/connectivity timing assertions are currently unstable in the harness. +- `TestPoS_StakingV2_FilteringAndFallback` (`e2e/pos_stakingv2_filter_test.go`): skipped due to known CI flakiness from startup timing around initial Tier1 set size. + +## Framework-only tests + +Harness tests in `e2e/framework/*` verify server manager behavior and binary resolution logic. + +## Removed legacy tests + +Legacy Polygon-origin PoS test suites are intentionally removed from the active catalog and are no longer part of the current XGR 2.0/StakingV2 baseline. diff --git a/e2e/broadcast_test.go b/e2e/broadcast_test.go index a83d978..ba04039 100644 --- a/e2e/broadcast_test.go +++ b/e2e/broadcast_test.go @@ -17,7 +17,7 @@ import ( func TestBroadcast(t *testing.T) { // This test is not stable // Opened the ticket to check + fix it - t.Skip() + t.Skip("unstable topology timing in current harness; kept skipped until deterministic peer-connect assertions are implemented") testCases := []struct { name string diff --git a/e2e/framework/config.go b/e2e/framework/config.go index 54e4b86..d33ff02 100644 --- a/e2e/framework/config.go +++ b/e2e/framework/config.go @@ -61,8 +61,12 @@ type TestServerConfig struct { MaxValidatorCount uint64 // Max validator count BlockTime uint64 // Minimum block generation time (in s) IBFTBaseTimeout uint64 // Base Timeout in seconds for IBFT + MicroEpochSize uint64 // PoS micro-epoch size for uptime weighting + MicroEpochNominalWeight uint64 // PoS micro-epoch nominal weight units + MicroEpochDecayBps uint64 // PoS micro-epoch inactivity decay bps PredeployParams *PredeployParams BurnContracts map[uint64]types.Address + ExtraEnv map[string]string } func (t *TestServerConfig) SetPredeployParams(params *PredeployParams) { @@ -193,6 +197,12 @@ func (t *TestServerConfig) SetEpochSize(epochSize uint64) { t.EpochSize = epochSize } +func (t *TestServerConfig) SetMicroEpochConfig(size, nominalWeight, decayBps uint64) { + t.MicroEpochSize = size + t.MicroEpochNominalWeight = nominalWeight + t.MicroEpochDecayBps = decayBps +} + // SetMinValidatorCount sets the min validator count func (t *TestServerConfig) SetMinValidatorCount(val uint64) { t.MinValidatorCount = val @@ -217,3 +227,12 @@ func (t *TestServerConfig) SetLogsDir(dir string) { func (t *TestServerConfig) SetName(name string) { t.Name = name } + +// SetEnv sets an environment variable for the server process. +func (t *TestServerConfig) SetEnv(key, value string) { + if t.ExtraEnv == nil { + t.ExtraEnv = map[string]string{} + } + + t.ExtraEnv[key] = value +} diff --git a/e2e/framework/helper.go b/e2e/framework/helper.go index de775a2..2f84ac8 100644 --- a/e2e/framework/helper.go +++ b/e2e/framework/helper.go @@ -174,25 +174,58 @@ func UnstakeAmount( // GetStakedAmount is a helper function for getting the staked amount on the Staking SC func GetStakedAmount(from types.Address, rpcClient *jsonrpc.Client) (*big.Int, error) { stakedAmountMethod, ok := abis.StakingABI.Methods["stakedAmount"] + if ok { + toAddress := ethgo.Address(staking.AddrStakingContract) + selector := stakedAmountMethod.ID() + response, err := rpcClient.Eth().Call( + ðgo.CallMsg{ + From: ethgo.Address(from), + To: &toAddress, + Data: selector, + GasPrice: TestGasPriceUint64(), + Value: big.NewInt(0), + }, + ethgo.Latest, + ) + + if err != nil { + return nil, fmt.Errorf("unable to call Staking contract method stakedAmount, %w", err) + } + + bigResponse, decodeErr := common.ParseUint256orHex(&response) + if decodeErr != nil { + return nil, fmt.Errorf("unable to decode hex response") + } + + return bigResponse, nil + } + + return rpcClient.Eth().GetBalance(ethgo.Address(staking.AddrStakingContract), ethgo.Latest) +} + +func GetAccountStake(account types.Address, rpcClient *jsonrpc.Client) (*big.Int, error) { + accountStakeMethod, ok := abis.StakingABI.Methods["accountStake"] if !ok { - return nil, errors.New("stakedAmount method doesn't exist in Staking contract ABI") + return nil, errors.New("accountStake method doesn't exist in Staking contract ABI") + } + + input, err := accountStakeMethod.Encode([]interface{}{ethgo.Address(account)}) + if err != nil { + return nil, fmt.Errorf("unable to encode accountStake method input, %w", err) } toAddress := ethgo.Address(staking.AddrStakingContract) - selector := stakedAmountMethod.ID() response, err := rpcClient.Eth().Call( ðgo.CallMsg{ - From: ethgo.Address(from), To: &toAddress, - Data: selector, + Data: input, GasPrice: TestGasPriceUint64(), Value: big.NewInt(0), }, ethgo.Latest, ) - if err != nil { - return nil, fmt.Errorf("unable to call Staking contract method stakedAmount, %w", err) + return nil, fmt.Errorf("unable to call Staking contract method accountStake, %w", err) } bigResponse, decodeErr := common.ParseUint256orHex(&response) diff --git a/e2e/framework/ibft.go b/e2e/framework/ibft.go index 708e8e7..02df47b 100644 --- a/e2e/framework/ibft.go +++ b/e2e/framework/ibft.go @@ -30,8 +30,21 @@ func NewIBFTServersManager( numNodes int, ibftDirPrefix string, callback IBFTServerConfigCallback, +) *IBFTServersManager { + return NewIBFTServersManagerWithGenesisValidators(t, numNodes, numNodes, ibftDirPrefix, callback) +} + +func NewIBFTServersManagerWithGenesisValidators( + t *testing.T, + numNodes int, + numGenesisValidators int, + ibftDirPrefix string, + callback IBFTServerConfigCallback, ) *IBFTServersManager { t.Helper() + if numGenesisValidators > numNodes { + t.Fatalf("numGenesisValidators (%d) cannot exceed numNodes (%d)", numGenesisValidators, numNodes) + } dataDir, err := tempDir() if err != nil { @@ -77,7 +90,9 @@ func NewIBFTServersManager( srvs = append(srvs, srv) bootnodes = append(bootnodes, libp2pAddr) - genesisValidators = append(genesisValidators, res.Address) + if i < numGenesisValidators { + genesisValidators = append(genesisValidators, res.Address) + } } srv := srvs[0] @@ -133,6 +148,37 @@ func (m *IBFTServersManager) GetServer(i int) *TestServer { return m.servers[i] } +func (m *IBFTServersManager) StopServer(i int) { + srv := m.GetServer(i) + if srv == nil { + return + } + + srv.Stop() +} + +func (m *IBFTServersManager) ActiveServers(excluded ...int) []*TestServer { + if len(m.servers) == 0 { + return nil + } + + excludedSet := make(map[int]struct{}, len(excluded)) + for _, idx := range excluded { + excludedSet[idx] = struct{}{} + } + + active := make([]*TestServer, 0, len(m.servers)) + for idx, srv := range m.servers { + if _, skip := excludedSet[idx]; skip { + continue + } + + active = append(active, srv) + } + + return active +} + func initLogsDir(t *testing.T) (string, error) { t.Helper() logsDir := path.Join("..", fmt.Sprintf("e2e-logs-%d", startTime), t.Name()) diff --git a/e2e/framework/ibft_test.go b/e2e/framework/ibft_test.go new file mode 100644 index 0000000..b0547d9 --- /dev/null +++ b/e2e/framework/ibft_test.go @@ -0,0 +1,23 @@ +package framework + +import "testing" + +func TestIBFTServersManagerActiveServers(t *testing.T) { + t.Parallel() + + manager := &IBFTServersManager{ + servers: []*TestServer{{}, {}, {}, {}}, + } + + active := manager.ActiveServers(1, 3) + if len(active) != 2 { + t.Fatalf("expected 2 active servers, got %d", len(active)) + } +} + +func TestIBFTServersManagerStopServerOutOfRange(t *testing.T) { + t.Parallel() + + manager := &IBFTServersManager{servers: []*TestServer{}} + manager.StopServer(10) +} diff --git a/e2e/framework/slashing.go b/e2e/framework/slashing.go new file mode 100644 index 0000000..5d17fe9 --- /dev/null +++ b/e2e/framework/slashing.go @@ -0,0 +1,21 @@ +package framework + +// WaitForServersToSealExcept waits for a target block height on all IBFT servers +// except indexes explicitly excluded. Useful for jailing/slashing tests where one +// or more validators are intentionally kept offline. +func WaitForServersToSealExcept( + manager *IBFTServersManager, + desiredHeight uint64, + excluded ...int, +) []error { + if manager == nil { + return nil + } + + servers := manager.ActiveServers(excluded...) + if len(servers) == 0 { + return nil + } + + return WaitForServersToSeal(servers, desiredHeight) +} diff --git a/e2e/framework/testserver.go b/e2e/framework/testserver.go index 8e64913..caeb69a 100644 --- a/e2e/framework/testserver.go +++ b/e2e/framework/testserver.go @@ -368,7 +368,15 @@ func (t *TestServer) GenerateGenesis() error { cmd.Stdout = stdout cmd.Stderr = stdout - return cmd.Run() + if err := cmd.Run(); err != nil { + return err + } + + if err := t.patchMicroEpochGenesisConfig(); err != nil { + return err + } + + return nil } func (t *TestServer) GenesisPredeploy() error { @@ -407,7 +415,63 @@ func (t *TestServer) GenesisPredeploy() error { cmd.Stdout = stdout cmd.Stderr = stdout - return cmd.Run() + if err := cmd.Run(); err != nil { + return err + } + + if err := t.patchMicroEpochGenesisConfig(); err != nil { + return err + } + + return nil +} + +func (t *TestServer) patchMicroEpochGenesisConfig() error { + if t.Config.MicroEpochSize == 0 { + return nil + } + + genesisPath := filepath.Join(t.Config.RootDir, "genesis.json") + raw, err := os.ReadFile(genesisPath) + if err != nil { + return err + } + + var doc map[string]interface{} + if err := json.Unmarshal(raw, &doc); err != nil { + return err + } + + params, _ := doc["params"].(map[string]interface{}) + if params == nil { + params = map[string]interface{}{} + doc["params"] = params + } + engine, _ := params["engine"].(map[string]interface{}) + if engine == nil { + engine = map[string]interface{}{} + params["engine"] = engine + } + ibftCfg, _ := engine["ibft"].(map[string]interface{}) + if ibftCfg == nil { + ibftCfg = map[string]interface{}{} + engine["ibft"] = ibftCfg + } + + ibftCfg["microEpochSize"] = t.Config.MicroEpochSize + if t.Config.MicroEpochNominalWeight > 0 { + ibftCfg["microEpochNominalWeightUnits"] = t.Config.MicroEpochNominalWeight + } + if t.Config.MicroEpochDecayBps > 0 { + ibftCfg["microEpochInactivityDecayBps"] = t.Config.MicroEpochDecayBps + } + + out, err := json.MarshalIndent(doc, "", " ") + if err != nil { + return err + } + + return os.WriteFile(genesisPath, out, 0o644) } func (t *TestServer) Start(ctx context.Context) error { @@ -460,6 +524,10 @@ func (t *TestServer) Start(ctx context.Context) error { // Start the server t.cmd = exec.Command(resolveBinary(), args...) //nolint:gosec t.cmd.Dir = t.Config.RootDir + t.cmd.Env = os.Environ() + for k, v := range t.Config.ExtraEnv { + t.cmd.Env = append(t.cmd.Env, fmt.Sprintf("%s=%s", k, v)) + } stdout := t.GetStdout() t.cmd.Stdout = stdout diff --git a/e2e/poa_pos_cutover_boundary_test.go b/e2e/poa_pos_cutover_boundary_test.go new file mode 100644 index 0000000..6c7b144 --- /dev/null +++ b/e2e/poa_pos_cutover_boundary_test.go @@ -0,0 +1,78 @@ +package e2e + +import ( + "context" + "crypto/ecdsa" + "testing" + "time" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/consensus/ibft/fork" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/e2e/framework" + "github.com/xgr-network/xgr-node/types" +) + +func TestPoA_PoS_Cutover_FirstBoundaryDoesNotStall(t *testing.T) { + const ( + nodeCount = 4 + epochSize = uint64(50) + poSFrom = epochSize + poSDeployment = uint64(5) + premineEth = 7_000_000 + stakeEth = 2_000_000 + ) + nextBoundary := poSFrom + epochSize + + ibftManager := framework.NewIBFTServersManager( + t, + nodeCount, + "poa-pos-cutover-boundary-", + func(_ int, cfg *framework.TestServerConfig) { + cfg.SetBlockTime(1) + cfg.SetIBFTBaseTimeout(2) + cfg.SetEpochSize(epochSize) + cfg.PremineValidatorBalance(framework.EthToWei(premineEth)) + }, + ) + + require.NoError(t, ibftManager.GetServer(0).SwitchIBFTType(fork.PoS, poSFrom, nil, u64ptr(poSDeployment))) + + startCtx, startCancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer startCancel() + ibftManager.StartServers(startCtx) + + servers := ibftManager.ActiveServers() + require.Empty(t, framework.WaitForServersToSeal(servers, poSDeployment+1), "cluster must seal pre-cutover blocks before staking") + + addrs, keys := collectValidatorCredentials(t, ibftManager, nodeCount) + for i := 0; i < nodeCount; i++ { + require.NoError(t, framework.StakeAmount(addrs[i], keys[i], framework.EthToWei(stakeEth), ibftManager.GetServer(0))) + } + + require.Empty(t, framework.WaitForServersToSeal(servers, poSFrom-1), "cluster must reach the last pre-cutover block") + require.Empty(t, framework.WaitForServersToSeal(servers, poSFrom), "cluster must seal the cutover boundary block") + require.Empty(t, framework.WaitForServersToSeal(servers, poSFrom+3), "cluster must continue sealing after cutover boundary") + require.Empty(t, framework.WaitForServersToSeal(servers, nextBoundary), "cluster must seal the first normal post-cutover PoS boundary") + require.Empty(t, framework.WaitForServersToSeal(servers, nextBoundary+3), "cluster must keep sealing after the first normal post-cutover PoS boundary") + assertNoPermanentHeightDivergence(t, servers) +} + +func collectValidatorCredentials(t *testing.T, m *framework.IBFTServersManager, nodeCount int) ([]types.Address, []*ecdsa.PrivateKey) { + t.Helper() + + addrs := make([]types.Address, 0, nodeCount) + keys := make([]*ecdsa.PrivateKey, 0, nodeCount) + + for i := 0; i < nodeCount; i++ { + key, err := m.GetServer(i).Config.PrivateKey() + require.NoError(t, err) + + keys = append(keys, key) + addrs = append(addrs, crypto.PubKeyToAddress(&key.PublicKey)) + } + + return addrs, keys +} + +func u64ptr(v uint64) *uint64 { return &v } diff --git a/e2e/pos_micro_weight_decay_restore_test.go b/e2e/pos_micro_weight_decay_restore_test.go new file mode 100644 index 0000000..6abeaf1 --- /dev/null +++ b/e2e/pos_micro_weight_decay_restore_test.go @@ -0,0 +1,357 @@ +package e2e + +import ( + "context" + "crypto/ecdsa" + "encoding/json" + "fmt" + "strconv" + "strings" + "testing" + "time" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/e2e/framework" + "github.com/xgr-network/xgr-node/types" +) + +type posOverviewE2E struct { + BlockNumber uint64 `json:"blockNumber"` + MicroEpochSize uint64 `json:"microEpochSize"` + CurrentMicroEpoch uint64 `json:"currentMicroEpoch"` + CurrentEpoch uint64 `json:"currentEpoch"` + MicroEpochStart uint64 `json:"currentMicroEpochStartBlock"` + MicroEpochEnd uint64 `json:"currentMicroEpochEndBlock"` + Validators []struct { + Address types.Address `json:"address"` + CurrentlyValidating bool `json:"currentlyValidating"` + StakingActive bool `json:"stakingActive"` + MicroNominalWeight *uint64 `json:"microNominalWeight,omitempty"` + MicroEffectiveWeight *uint64 `json:"microEffectiveWeight,omitempty"` + MicroInactivity *uint64 `json:"microInactivity,omitempty"` + } `json:"validators"` +} + +type pollAttempt struct { + Overview *posOverviewE2E + Raw string + Err string +} + +func TestPoS_MicroWeightDecayAndRestore(t *testing.T) { + n := 4 + defaultBalance := framework.EthToWei(7_000_000) + stakeAmount := framework.EthToWei(3_000_000) + ibftManager := framework.NewIBFTServersManager(t, n, IBFTDirPrefix, func(_ int, config *framework.TestServerConfig) { + config.SetEpochSize(5) + config.SetMicroEpochConfig(8, 10_000, 9_000) + config.PremineValidatorBalance(defaultBalance) + config.SetIBFTPoS(true) + config.SetMinValidatorCount(3) + config.SetMaxValidatorCount(uint64(n)) + }) + t.Cleanup(func() { ibftManager.StopServers() }) + ctx, cancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer cancel() + ibftManager.StartServers(ctx) + + servers := make([]*framework.TestServer, 0, n) + keys := make([]*ecdsa.PrivateKey, 0, n) + addrs := make([]types.Address, 0, n) + for i := 0; i < n; i++ { + s := ibftManager.GetServer(i) + k, err := s.Config.PrivateKey() + require.NoError(t, err) + servers = append(servers, s) + keys = append(keys, k) + addrs = append(addrs, crypto.PubKeyToAddress(&k.PublicKey)) + require.NoError(t, framework.StakeAmount(addrs[i], keys[i], stakeAmount, s)) + } + require.Empty(t, framework.WaitForServersToSeal(servers, 20)) + + history := make([]pollAttempt, 0, 5) + appendHistory := func(a pollAttempt) { + history = append(history, a) + if len(history) > 5 { + history = history[1:] + } + } + logHistory := func() { + for i, h := range history { + if h.Overview == nil { + t.Logf("overview[%d] err=%s raw=%s", i, h.Err, h.Raw) + continue + } + o := h.Overview + t.Logf("overview[%d] block=%d validators=%d err=%s raw=%s", i, o.BlockNumber, len(o.Validators), h.Err, h.Raw) + for j, v := range o.Validators { + t.Logf("overview[%d].validator[%d] addr=%s stakingActive=%t currentlyValidating=%t microNominalWeight=%s microEffectiveWeight=%s microInactivity=%s", + i, j, v.Address.String(), v.StakingActive, v.CurrentlyValidating, optionalUint64(v.MicroNominalWeight), optionalUint64(v.MicroEffectiveWeight), optionalUint64(v.MicroInactivity)) + } + } + } + observerIdx := 0 + poll := func(pred func(posOverviewE2E) bool, timeout time.Duration) posOverviewE2E { + deadline := time.Now().Add(timeout) + for time.Now().Before(deadline) { + o, raw, err := getOverview(servers[observerIdx]) + if err != nil { + appendHistory(pollAttempt{Raw: raw, Err: err.Error()}) + time.Sleep(2 * time.Second) + continue + } + + appendHistory(pollAttempt{Overview: &o, Raw: raw}) + if pred(o) { + return o + } + time.Sleep(2 * time.Second) + } + logHistory() + require.FailNow(t, "timeout waiting for overview condition") + return posOverviewE2E{} + } + + initial := poll(func(o posOverviewE2E) bool { + if o.MicroEpochSize == 0 { + return false + } + overviewIndexByAddr := make(map[types.Address]int, len(o.Validators)) + for i, v := range o.Validators { + overviewIndexByAddr[v.Address] = i + } + missing := make([]types.Address, 0, len(addrs)) + for _, addr := range addrs { + idx, ok := overviewIndexByAddr[addr] + if !ok { + missing = append(missing, addr) + continue + } + v := o.Validators[idx] + if !v.CurrentlyValidating { + return false + } + if v.MicroNominalWeight == nil || *v.MicroNominalWeight == 0 || v.MicroEffectiveWeight == nil || *v.MicroEffectiveWeight != *v.MicroNominalWeight { + return false + } + if v.MicroInactivity != nil && *v.MicroInactivity != 0 { + return false + } + } + if len(missing) > 0 { + t.Logf("expected validators missing from overview: %v", missing) + return false + } + return true + }, 150*time.Second) + offlineIdx := -1 + for i := range addrs { + for _, v := range initial.Validators { + if v.Address == addrs[i] && v.StakingActive && v.CurrentlyValidating { + offlineIdx = i + break + } + } + if offlineIdx >= 0 { + break + } + } + if offlineIdx < 0 { + t.Skip("no active+currentlyValidating validator found for offline decay scenario") + } + offlineAddr := addrs[offlineIdx] + offlineStartEpoch := initial.CurrentMicroEpoch + observerIdx = 0 + if offlineIdx == observerIdx { + observerIdx = 1 + } + t.Logf("micro-overview offline node index=%d addr=%s observer node index=%d", offlineIdx, offlineAddr, observerIdx) + ibftManager.StopServer(offlineIdx) + + deactivated := poll(func(o posOverviewE2E) bool { + if o.CurrentMicroEpoch <= offlineStartEpoch { + return false + } + for _, v := range o.Validators { + if v.CurrentlyValidating { + if v.MicroNominalWeight == nil || *v.MicroNominalWeight == 0 || v.MicroEffectiveWeight == nil || v.MicroInactivity == nil { + return false + } + } + } + for _, v := range o.Validators { + if v.Address == offlineAddr { + t.Logf("deactivate-wait block=%d currentEpoch=%d microEpochSize=%d currentMicroEpoch=%d offlineAddr=%s stakingActive=%t currentlyValidating=%t microNominalWeight=%s microEffectiveWeight=%s microInactivity=%s", + o.BlockNumber, o.CurrentEpoch, o.MicroEpochSize, o.CurrentMicroEpoch, offlineAddr, v.StakingActive, v.CurrentlyValidating, optionalUint64(v.MicroNominalWeight), optionalUint64(v.MicroEffectiveWeight), optionalUint64(v.MicroInactivity)) + return !v.CurrentlyValidating || !v.StakingActive + } + } + return false + }, 120*time.Second) + + require.NoError(t, ibftManager.GetServer(offlineIdx).Start(context.Background())) + afterRestart := poll(func(o posOverviewE2E) bool { + if o.CurrentMicroEpoch <= deactivated.CurrentMicroEpoch { + return false + } + for _, v := range o.Validators { + if v.CurrentlyValidating { + if v.MicroNominalWeight == nil || *v.MicroNominalWeight == 0 || v.MicroEffectiveWeight == nil || v.MicroInactivity == nil { + return false + } + } + } + return true + }, 150*time.Second) + + heightBefore := afterRestart.BlockNumber + require.Eventually(t, func() bool { + h, err := servers[0].JSONRPC().Eth().BlockNumber() + return err == nil && h > heightBefore + }, 60*time.Second, 2*time.Second) +} + +func getOverview(srv *framework.TestServer) (posOverviewE2E, string, error) { + var out posOverviewE2E + var raw map[string]any + err := srv.JSONRPC().Call("eth_getPosValidatorsOverview", &raw, nil) + if err != nil { + return out, "", fmt.Errorf("overview call failed: %w", err) + } + rawJSON, _ := json.Marshal(raw) + blockNumber, err := parseHexUint64(raw, "blockNumber") + if err != nil { + return out, string(rawJSON), fmt.Errorf("decode blockNumber failed: %w", err) + } + microEpochSize, err := parseHexUint64(raw, "microEpochSize") + if err != nil { + return out, string(rawJSON), fmt.Errorf("decode microEpochSize failed: %w", err) + } + currentMicroEpoch, err := parseHexUint64(raw, "currentMicroEpoch") + if err != nil { + return out, string(rawJSON), fmt.Errorf("decode currentMicroEpoch failed: %w", err) + } + currentEpoch, err := parseHexUint64(raw, "currentEpoch") + if err != nil { + return out, string(rawJSON), fmt.Errorf("decode currentEpoch failed: %w", err) + } + microEpochStart, err := parseHexUint64(raw, "currentMicroEpochStartBlock") + if err != nil { + return out, string(rawJSON), fmt.Errorf("decode currentMicroEpochStartBlock failed: %w", err) + } + microEpochEnd, err := parseHexUint64(raw, "currentMicroEpochEndBlock") + if err != nil { + return out, string(rawJSON), fmt.Errorf("decode currentMicroEpochEndBlock failed: %w", err) + } + out.BlockNumber = blockNumber + out.MicroEpochSize = microEpochSize + out.CurrentMicroEpoch = currentMicroEpoch + out.CurrentEpoch = currentEpoch + out.MicroEpochStart = microEpochStart + out.MicroEpochEnd = microEpochEnd + + rawValidators, ok := raw["validators"].([]any) + if !ok { + return out, string(rawJSON), fmt.Errorf("decode validators failed: expected array, got %T", raw["validators"]) + } + out.Validators = make([]struct { + Address types.Address `json:"address"` + CurrentlyValidating bool `json:"currentlyValidating"` + StakingActive bool `json:"stakingActive"` + MicroNominalWeight *uint64 `json:"microNominalWeight,omitempty"` + MicroEffectiveWeight *uint64 `json:"microEffectiveWeight,omitempty"` + MicroInactivity *uint64 `json:"microInactivity,omitempty"` + }, 0, len(rawValidators)) + for i, rawValidator := range rawValidators { + vm, ok := rawValidator.(map[string]any) + if !ok { + return out, string(rawJSON), fmt.Errorf("decode validator[%d] failed: expected object, got %T", i, rawValidator) + } + var v struct { + Address types.Address `json:"address"` + CurrentlyValidating bool `json:"currentlyValidating"` + StakingActive bool `json:"stakingActive"` + MicroNominalWeight *uint64 `json:"microNominalWeight,omitempty"` + MicroEffectiveWeight *uint64 `json:"microEffectiveWeight,omitempty"` + MicroInactivity *uint64 `json:"microInactivity,omitempty"` + } + addressRaw, ok := vm["address"].(string) + if !ok { + return out, string(rawJSON), fmt.Errorf("decode validator[%d].address failed: expected string, got %T", i, vm["address"]) + } + v.Address = types.StringToAddress(addressRaw) + validating, ok := vm["currentlyValidating"].(bool) + if !ok { + return out, string(rawJSON), fmt.Errorf("decode validator[%d].currentlyValidating failed: expected bool, got %T", i, vm["currentlyValidating"]) + } + v.CurrentlyValidating = validating + if stakingActive, ok := vm["stakingActive"].(bool); ok { + v.StakingActive = stakingActive + } + v.MicroNominalWeight, err = parseOptionalHexUint64(vm, "microNominalWeight") + if err != nil { + return out, string(rawJSON), fmt.Errorf("decode validator[%d].microNominalWeight failed: %w", i, err) + } + v.MicroEffectiveWeight, err = parseOptionalHexUint64(vm, "microEffectiveWeight") + if err != nil { + return out, string(rawJSON), fmt.Errorf("decode validator[%d].microEffectiveWeight failed: %w", i, err) + } + v.MicroInactivity, err = parseOptionalHexUint64(vm, "microInactivity") + if err != nil { + return out, string(rawJSON), fmt.Errorf("decode validator[%d].microInactivity failed: %w", i, err) + } + out.Validators = append(out.Validators, v) + } + + return out, string(rawJSON), nil +} + +func parseHexUint64(m map[string]any, field string) (uint64, error) { + value, ok := m[field] + if !ok { + return 0, fmt.Errorf("missing field %q", field) + } + return decodeUint64(value) +} + +func parseOptionalHexUint64(m map[string]any, field string) (*uint64, error) { + value, ok := m[field] + if !ok || value == nil { + return nil, nil + } + v, err := decodeUint64(value) + if err != nil { + return nil, err + } + return &v, nil +} + +func decodeUint64(value any) (uint64, error) { + switch typed := value.(type) { + case string: + if strings.HasPrefix(typed, "0x") || strings.HasPrefix(typed, "0X") { + v, err := strconv.ParseUint(typed[2:], 16, 64) + if err != nil { + return 0, fmt.Errorf("invalid hex uint64 %q: %w", typed, err) + } + return v, nil + } + v, err := strconv.ParseUint(typed, 10, 64) + if err != nil { + return 0, fmt.Errorf("invalid decimal uint64 %q: %w", typed, err) + } + return v, nil + case float64: + return uint64(typed), nil + default: + return 0, fmt.Errorf("unsupported type %T", value) + } +} + +func optionalUint64(v *uint64) string { + if v == nil { + return "" + } + return strconv.FormatUint(*v, 10) +} diff --git a/e2e/pos_poa_switch_test.go b/e2e/pos_poa_switch_test.go deleted file mode 100644 index b7b1800..0000000 --- a/e2e/pos_poa_switch_test.go +++ /dev/null @@ -1,167 +0,0 @@ -package e2e - -import ( - "context" - "crypto/ecdsa" - "sync" - "testing" - "time" - - "github.com/stretchr/testify/assert" - "github.com/xgr-network/xgr-node/consensus/ibft/fork" - ibftOp "github.com/xgr-network/xgr-node/consensus/ibft/proto" - "github.com/xgr-network/xgr-node/crypto" - "github.com/xgr-network/xgr-node/e2e/framework" - "github.com/xgr-network/xgr-node/types" -) - -// Test scenario: -// PoA [0, 29] -// - Check validator set in each validator equals to genesis validator -// - 3 validators stake to the validator contract after contract deploys at block #10 -// PoS [30, ] -// - Check validator set in each validator has only 3 validators -func TestPoAPoSSwitch(t *testing.T) { - var ( - // switch configuration - posDeployContractAt = uint64(10) - posStartAt = uint64(30) - - defaultBalance = framework.EthToWei(1000) - stakeAmount = framework.EthToWei(5) - ) - - ibftManager := framework.NewIBFTServersManager( - t, - IBFTMinNodes, - IBFTDirPrefix, - func(i int, config *framework.TestServerConfig) { - config.PremineValidatorBalance(defaultBalance) - }) - - // Set switch configuration into genesis.json - err := ibftManager.GetServer(0).SwitchIBFTType(fork.PoS, posStartAt, nil, &posDeployContractAt) - assert.NoError(t, err) - - // Get server slice - servers := make([]*framework.TestServer, 0) - for i := 0; i < IBFTMinNodes; i++ { - servers = append(servers, ibftManager.GetServer(i)) - } - - // Get genesis validators - genesisValidatorKeys := make([]*ecdsa.PrivateKey, IBFTMinNodes) - genesisValidatorAddrs := make([]types.Address, IBFTMinNodes) - - for idx := 0; idx < IBFTMinNodes; idx++ { - validatorKey, err := ibftManager.GetServer(idx).Config.PrivateKey() - assert.NoError(t, err) - - validatorAddr := crypto.PubKeyToAddress(&validatorKey.PublicKey) - genesisValidatorKeys[idx] = validatorKey - genesisValidatorAddrs[idx] = validatorAddr - } - - // Start servers - ctx, cancel := context.WithTimeout(context.Background(), time.Minute) - defer cancel() - ibftManager.StartServers(ctx) - - // Test in PoA - validateSnapshot := func( - ctx context.Context, - srv *framework.TestServer, - height uint64, - expectedValidators []types.Address, - ) { - res, err := srv.IBFTOperator().GetSnapshot(ctx, &ibftOp.SnapshotReq{ - Number: height, - }) - assert.NoError(t, err) - - snapshotValidators := make([]types.Address, len(res.Validators)) - for idx, v := range res.Validators { - snapshotValidators[idx] = types.BytesToAddress(v.Data) - } - - assert.ElementsMatch(t, expectedValidators, snapshotValidators) - } - - // Check validator set in each validator - var wg sync.WaitGroup - for i := 0; i < IBFTMinNodes; i++ { - wg.Add(1) - - srv := ibftManager.GetServer(i) - - go func(srv *framework.TestServer) { - defer wg.Done() - - ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) - defer cancel() - - // every validator should have 4 validators in validator set - validateSnapshot(ctx, srv, 1, genesisValidatorAddrs) - }(srv) - } - wg.Wait() - - // Wait until the staking contract is deployed - waitErrors := framework.WaitForServersToSeal(servers, posDeployContractAt) - if len(waitErrors) != 0 { - t.Fatalf("Unable to wait for all nodes to seal blocks, %v", waitErrors) - } - - // Stake balance - // 4 genesis validators will stake but 1 gensis validator won't - numStakedValidators := 4 - wg = sync.WaitGroup{} - - for idx := 0; idx < numStakedValidators; idx++ { - wg.Add(1) - - srv := ibftManager.GetServer(idx) - key, addr := genesisValidatorKeys[idx], genesisValidatorAddrs[idx] - - go func(srv *framework.TestServer, key *ecdsa.PrivateKey, addr types.Address) { - defer wg.Done() - - err := framework.StakeAmount( - addr, - key, - stakeAmount, - srv, - ) - assert.NoError(t, err) - }(srv, key, addr) - } - wg.Wait() - - // Wait until PoS begins - waitErrors = framework.WaitForServersToSeal(servers, posStartAt) - if len(waitErrors) != 0 { - t.Fatalf("Unable to wait for all nodes to seal blocks, %v", waitErrors) - } - - expectedPoSValidators := genesisValidatorAddrs[:4] - - // Test in PoS - wg = sync.WaitGroup{} - - for i := 0; i < IBFTMinNodes; i++ { - wg.Add(1) - - srv := ibftManager.GetServer(i) - - go func(srv *framework.TestServer) { - defer wg.Done() - - ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) - defer cancel() - - // every validator should have only 4 validators in validator set - validateSnapshot(ctx, srv, posStartAt, expectedPoSValidators) - }(srv) - } - wg.Wait() -} diff --git a/e2e/pos_restart_resync_test.go b/e2e/pos_restart_resync_test.go new file mode 100644 index 0000000..9c3a0b3 --- /dev/null +++ b/e2e/pos_restart_resync_test.go @@ -0,0 +1,322 @@ +package e2e + +import ( + "context" + "crypto/ecdsa" + "fmt" + "math/big" + "testing" + "time" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/e2e/framework" + "github.com/xgr-network/xgr-node/types" +) + +func TestPoS_AllValidatorsStoppedAndRestarted_Tier1_ResumesDeterministically(t *testing.T) { + servers, _, addrs, manager := setupStakingV2Cluster(t, 4, 6, 3, 5) + + require.Empty(t, framework.WaitForServersToSeal(servers, 20)) + heightBeforeStop, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + + manager.StopServers() + + restartCtx, cancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer cancel() + manager.StartServers(restartCtx) + + require.Empty(t, framework.WaitForServersToSeal(servers, heightBeforeStop+5)) + assertNoPermanentHeightDivergence(t, servers) + + snap := mustGetLatestSnapshotValidators(t, servers[0]) + require.GreaterOrEqual(t, len(snap), 3) + for _, snapAddr := range snap { + assert.Contains(t, addrs, snapAddr) + } +} + +func TestPoS_AllValidatorsStoppedAndRestarted_Tier2_ResumesDeterministically(t *testing.T) { + servers, keys, addrs, manager := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + assertStakePreconditionsNoAutoStake(t, "tier2", servers[0], addrs[0], addrs[0], minStake) + assertStakePreconditionsNoAutoStake(t, "tier2", servers[1], addrs[1], addrs[1], minStake) + stakeAmountWithContext(t, "tier2", servers[0], addrs[0], keys[0], minStake) + stakeAmountWithContext(t, "tier2", servers[1], addrs[1], keys[1], minStake) + waitForNextEpochTransition(t, servers, 6) + + countTier1, countTier2, _ := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + require.Less(t, countTier1, uint64(3)) + require.GreaterOrEqual(t, countTier2, uint64(3)) + require.Contains(t, mustGetLatestSnapshotValidators(t, servers[0]), addrs[3]) + + heightBeforeStop, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + manager.StopServers() + + restartCtx, cancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer cancel() + manager.StartServers(restartCtx) + + require.Empty(t, framework.WaitForServersToSeal(servers, heightBeforeStop+5)) + assertNoPermanentHeightDivergence(t, servers) + + countTier1After, countTier2After, _ := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + require.Less(t, countTier1After, uint64(3)) + require.GreaterOrEqual(t, countTier2After, uint64(3)) + assert.Contains(t, mustGetLatestSnapshotValidators(t, servers[0]), addrs[3]) +} + +func TestPoS_AllValidatorsStoppedAndRestarted_Tier3_ResumesDeterministically(t *testing.T) { + servers, keys, addrs, manager := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + assertStakePreconditionsNoAutoStake(t, "tier3", servers[0], addrs[0], addrs[0], minStake) + assertStakePreconditionsNoAutoStake(t, "tier3", servers[1], addrs[1], addrs[1], minStake) + assertStakePreconditionsNoAutoStake(t, "tier3", servers[2], addrs[2], addrs[2], minStake) + stakeAmountWithContext(t, "tier3", servers[0], addrs[0], keys[0], minStake) + stakeAmountWithContext(t, "tier3", servers[1], addrs[1], keys[1], minStake) + stakeAmountWithContext(t, "tier3", servers[2], addrs[2], keys[2], minStake) + waitForNextEpochTransition(t, servers, 6) + + require.NoError(t, sendSetActiveTx(servers[1], addrs[1], keys[1], false)) + require.NoError(t, sendSetActiveTx(servers[2], addrs[2], keys[2], false)) + waitForNextEpochTransition(t, servers, 6) + + countTier1, countTier2, countTier3 := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + require.Less(t, countTier1, uint64(3)) + require.Less(t, countTier2, uint64(3)) + require.GreaterOrEqual(t, countTier3, uint64(3)) + require.Contains(t, mustGetLatestSnapshotValidators(t, servers[0]), addrs[1]) + + heightBeforeStop, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + manager.StopServers() + + restartCtx, cancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer cancel() + manager.StartServers(restartCtx) + + require.Empty(t, framework.WaitForServersToSeal(servers, heightBeforeStop+5)) + assertNoPermanentHeightDivergence(t, servers) + + countTier1After, countTier2After, countTier3After := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + require.Less(t, countTier1After, uint64(3)) + require.Less(t, countTier2After, uint64(3)) + require.GreaterOrEqual(t, countTier3After, uint64(3)) + assert.Contains(t, mustGetLatestSnapshotValidators(t, servers[0]), addrs[1]) +} + +func TestPoS_StoppedValidatorCatchesUpToRunningChain_DeterministicSnapshotAndTierCounts(t *testing.T) { + servers, keys, addrs, manager := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + assertStakePreconditionsNoAutoStake(t, "catchup", servers[0], addrs[0], addrs[0], minStake) + assertStakePreconditionsNoAutoStake(t, "catchup", servers[1], addrs[1], addrs[1], minStake) + assertStakePreconditionsNoAutoStake(t, "catchup", servers[2], addrs[2], addrs[2], minStake) + stakeAmountWithContext(t, "catchup", servers[0], addrs[0], keys[0], minStake) + stakeAmountWithContext(t, "catchup", servers[1], addrs[1], keys[1], minStake) + stakeAmountWithContext(t, "catchup", servers[2], addrs[2], keys[2], minStake) + waitForNextEpochTransition(t, servers, 6) + + offlineIdx := 3 + manager.StopServer(offlineIdx) + + activeServers := manager.ActiveServers(offlineIdx) + heightBeforeCatchup, err := activeServers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + require.Empty(t, framework.WaitForServersToSeal(activeServers, heightBeforeCatchup+8)) + + restartCtx, cancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer cancel() + require.NoError(t, manager.GetServer(offlineIdx).Start(restartCtx)) + require.NoError(t, manager.GetServer(offlineIdx).WaitForReady(restartCtx)) + + assert.Eventually(t, func() bool { + offlineHeight, offlineErr := servers[offlineIdx].JSONRPC().Eth().BlockNumber() + if offlineErr != nil { + return false + } + + for i := range servers { + if i == offlineIdx { + continue + } + h, err := servers[i].JSONRPC().Eth().BlockNumber() + if err != nil { + return false + } + if h > offlineHeight+1 { + return false + } + } + + return true + }, 2*time.Minute, time.Second) + + baselineSnap := mustGetLatestSnapshotValidators(t, servers[0]) + for i := 1; i < len(servers); i++ { + assert.ElementsMatch(t, baselineSnap, mustGetLatestSnapshotValidators(t, servers[i])) + } + + t1Baseline, t2Baseline, t3Baseline := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + t1Restarted, t2Restarted, t3Restarted := countSelectionTiersFromValidatorList(t, servers[offlineIdx], addrs[0], minStake) + assert.Equal(t, t1Baseline, t1Restarted) + assert.Equal(t, t2Baseline, t2Restarted) + assert.Equal(t, t3Baseline, t3Restarted) +} + +func assertNoPermanentHeightDivergence(t *testing.T, servers []*framework.TestServer) { + t.Helper() + + assert.Eventually(t, func() bool { + minHeight := uint64(^uint64(0)) + maxHeight := uint64(0) + + for _, srv := range servers { + h, err := srv.JSONRPC().Eth().BlockNumber() + if err != nil { + return false + } + if h < minHeight { + minHeight = h + } + if h > maxHeight { + maxHeight = h + } + } + + return maxHeight-minHeight <= 1 + }, 2*time.Minute, time.Second) +} + +type stakePreconditions struct { + blockNumber uint64 + balance *big.Int + accountStake *big.Int + validatorInfo *stakingValidatorInfo + thresholdMet bool + joinEffectiveAt *big.Int + diagnosticContext string +} + +func readStakePreconditions( + t *testing.T, + srv *framework.TestServer, + queryFrom types.Address, + validator types.Address, + contextLabel string, +) *stakePreconditions { + t.Helper() + + blockNumber, err := srv.JSONRPC().Eth().BlockNumber() + require.NoError(t, err, "failed to read block number (%s)", contextLabel) + + balance := framework.GetAccountBalance(t, validator, srv.JSONRPC()) + + accountStake, err := framework.GetAccountStake(validator, srv.JSONRPC()) + require.NoError(t, err, "failed to read accountStake (%s)", contextLabel) + + info, err := queryValidatorInfo(srv, queryFrom, validator) + require.NoError(t, err, "failed to read validatorInfo (%s)", contextLabel) + + thresholdMet, err := queryIsValidatorThresholdMet(srv, queryFrom, validator) + require.NoError(t, err, "failed to read isValidatorThresholdMet (%s)", contextLabel) + + joinEffectiveAt, err := queryJoinEffectiveAtBlock(srv, queryFrom, validator) + require.NoError(t, err, "failed to read joinEffectiveAtBlock (%s)", contextLabel) + + return &stakePreconditions{ + blockNumber: blockNumber, + balance: balance, + accountStake: accountStake, + validatorInfo: info, + thresholdMet: thresholdMet, + joinEffectiveAt: joinEffectiveAt, + diagnosticContext: contextLabel, + } +} + +func assertStakePreconditionsNoAutoStake( + t *testing.T, + testLabel string, + srv *framework.TestServer, + queryFrom types.Address, + validator types.Address, + minStake *big.Int, +) { + t.Helper() + + ctx := fmt.Sprintf("%s pre-stake validator=%s", testLabel, validator.String()) + pre := readStakePreconditions(t, srv, queryFrom, validator, ctx) + t.Logf( + "[%s] block=%d balance=%s accountStake=%s exists=%v active=%v thresholdMet=%v joinEffectiveAt=%s stakedAmount=%s deactivatedAt=%s minStake=%s", + ctx, + pre.blockNumber, + pre.balance.String(), + pre.accountStake.String(), + pre.validatorInfo.Exists, + pre.validatorInfo.Active, + pre.thresholdMet, + pre.joinEffectiveAt.String(), + pre.validatorInfo.StakedAmount.String(), + pre.validatorInfo.DeactivatedAtBlock.String(), + minStake.String(), + ) + + require.GreaterOrEqualf(t, pre.balance.Cmp(minStake), 0, "[%s] insufficient balance for stake", ctx) + require.Lessf(t, pre.accountStake.Cmp(minStake), 0, "[%s] account already has accountStake >= minStake before first stake", ctx) + require.Truef(t, pre.validatorInfo.Exists, "[%s] validator entry must exist before staking top-up", ctx) + require.Falsef(t, pre.thresholdMet, "[%s] threshold already met before first stake", ctx) +} + +func stakeAmountWithContext( + t *testing.T, + testLabel string, + srv *framework.TestServer, + validator types.Address, + key *ecdsa.PrivateKey, + amount *big.Int, +) { + t.Helper() + + ctx := fmt.Sprintf("%s stake validator=%s", testLabel, validator.String()) + pre := readStakePreconditions(t, srv, validator, validator, ctx+" pre") + err := framework.StakeAmount(validator, key, amount, srv) + if err == nil { + return + } + + post := readStakePreconditions(t, srv, validator, validator, ctx+" post") + require.FailNowf( + t, + "StakeAmount reverted", + "[%s] err=%v amount=%s pre{block=%d balance=%s accountStake=%s exists=%v active=%v thresholdMet=%v joinEffectiveAt=%s stakedAmount=%s deactivatedAt=%s} post{block=%d balance=%s accountStake=%s exists=%v active=%v thresholdMet=%v joinEffectiveAt=%s stakedAmount=%s deactivatedAt=%s}", + ctx, + err, + amount.String(), + pre.blockNumber, + pre.balance.String(), + pre.accountStake.String(), + pre.validatorInfo.Exists, + pre.validatorInfo.Active, + pre.thresholdMet, + pre.joinEffectiveAt.String(), + pre.validatorInfo.StakedAmount.String(), + pre.validatorInfo.DeactivatedAtBlock.String(), + post.blockNumber, + post.balance.String(), + post.accountStake.String(), + post.validatorInfo.Exists, + post.validatorInfo.Active, + post.thresholdMet, + post.joinEffectiveAt.String(), + post.validatorInfo.StakedAmount.String(), + post.validatorInfo.DeactivatedAtBlock.String(), + ) +} diff --git a/e2e/pos_smallset_notbetrieb_test.go b/e2e/pos_smallset_notbetrieb_test.go new file mode 100644 index 0000000..44d0676 --- /dev/null +++ b/e2e/pos_smallset_notbetrieb_test.go @@ -0,0 +1,59 @@ +package e2e + +import ( + "testing" + "time" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/e2e/framework" +) + +func TestPoS_3Validators_ClusterStillSeals(t *testing.T) { + // Liveness baseline (quorum): all selected validators online. + servers, _, _, _ := setupStakingV2Cluster(t, 3, 5, 1, 3) + require.Empty(t, framework.WaitForServersToSeal(servers, 14)) +} + +func TestPoS_3Validators_OneOfflineStallsAsExpected(t *testing.T) { + // This assertion is about quorum/liveness limits, not tier-based membership selection. + servers, _, _, manager := setupStakingV2Cluster(t, 3, 5, 1, 3) + + before, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + + manager.StopServer(2) + assert.Eventually(t, func() bool { + after, pollErr := servers[0].JSONRPC().Eth().BlockNumber() + return pollErr == nil && after == before + }, 5*time.Second, 500*time.Millisecond, "3-validator cluster should stall with one offline in this test profile") +} + +func TestPoS_2Validators_BehaviorDocumented(t *testing.T) { + // This assertion is about quorum/liveness limits, not tier-based membership selection. + servers, _, _, manager := setupStakingV2Cluster(t, 2, 5, 1, 2) + + require.Empty(t, framework.WaitForServersToSeal(servers, 10)) + + heightBeforeStop, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + manager.StopServer(1) + + assert.Eventually(t, func() bool { + heightAfterStop, pollErr := servers[0].JSONRPC().Eth().BlockNumber() + return pollErr == nil && heightAfterStop == heightBeforeStop + }, 5*time.Second, 500*time.Millisecond, "2-validator set should stall with one node offline") +} + +func TestPoS_1Validator_SingleNodeDeterministicBehavior(t *testing.T) { + servers, _, _, _ := setupStakingV2Cluster(t, 1, 5, 1, 1) + + require.Empty(t, framework.WaitForServersToSeal(servers, 10)) + + first, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + require.Empty(t, framework.WaitForServersToSeal(servers, first+5)) + second, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + assert.GreaterOrEqual(t, second, first+5) +} diff --git a/e2e/pos_stakingv2_delegation_lifecycle_e2e_test.go b/e2e/pos_stakingv2_delegation_lifecycle_e2e_test.go new file mode 100644 index 0000000..25dbb56 --- /dev/null +++ b/e2e/pos_stakingv2_delegation_lifecycle_e2e_test.go @@ -0,0 +1,1755 @@ +package e2e + +import ( + "context" + "crypto/ecdsa" + "errors" + "math/big" + "testing" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + "github.com/umbracle/ethgo" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/e2e/framework" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/helper/hex" + "github.com/xgr-network/xgr-node/types" +) + +type stakingStakerInfo struct { + Exists bool + Active bool + Amount *big.Int + JoinedAtBlock *big.Int + DeactivatedAtBlock *big.Int + Validator types.Address +} + +func TestPoS_StakingV2_ValidatorLifecycle_MinStakeAndWithdrawBoundaries(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 3, 5, 2, 4) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], addrs[0]) + require.NoError(t, err) + validatorThreshold, err := queryValidatorThreshold(servers[0], addrs[0]) + require.NoError(t, err) + + exactMinKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + exactMinAddr := crypto.PubKeyToAddress(&exactMinKey.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], exactMinAddr, new(big.Int).Mul(minSelfStake, big.NewInt(2))) + receipt, err := sendStakeTx(servers[0], exactMinAddr, exactMinKey, minSelfStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status, "stake exactly min should succeed") + + belowMinKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + belowMinAddr := crypto.PubKeyToAddress(&belowMinKey.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], belowMinAddr, new(big.Int).Mul(minSelfStake, big.NewInt(2))) + receipt, err = sendStakeTx(servers[0], belowMinAddr, belowMinKey, new(big.Int).Sub(minSelfStake, big.NewInt(1))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "stake below min should fail") + + joinKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + joinAddr := crypto.PubKeyToAddress(&joinKey.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], joinAddr, new(big.Int).Mul(validatorThreshold, big.NewInt(2))) + receipt, err = sendStakeTx(servers[0], joinAddr, joinKey, validatorThreshold) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + snapshotBeforeJoin := mustGetLatestSnapshotValidators(t, servers[0]) + require.NotContains(t, snapshotBeforeJoin, joinAddr, "join should not be consensus-effective in same epoch") + waitForNextEpochTransition(t, servers, 5) + snapshotAfterJoin := mustGetLatestSnapshotValidators(t, servers[0]) + require.Contains(t, snapshotAfterJoin, joinAddr, "join should be consensus-effective in next epoch") + + underMinKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + underMinAddr := crypto.PubKeyToAddress(&underMinKey.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], underMinAddr, new(big.Int).Mul(minSelfStake, big.NewInt(2))) + receipt, err = sendStakeTx(servers[0], underMinAddr, underMinKey, new(big.Int).Sub(minSelfStake, big.NewInt(1))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status) + underMinInfo, err := queryStakerInfo(servers[0], addrs[0], underMinAddr) + require.NoError(t, err) + require.False(t, underMinInfo.Exists) + receipt, err = sendSetActiveReceiptTx(servers[0], underMinAddr, underMinKey, true) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status) + + validatorAddr := addrs[0] + validatorKey := keys[0] + receipt, err = sendWithdrawTx(servers[0], validatorAddr, validatorKey, big.NewInt(1)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "withdraw while active must fail") + + waitUntilMidEpoch(t, servers[0], 5) + require.NoError(t, sendSetActiveTx(servers[0], validatorAddr, validatorKey, false)) + snapshotBeforeDeactivateBoundary := mustGetLatestSnapshotValidators(t, servers[0]) + require.Contains(t, snapshotBeforeDeactivateBoundary, validatorAddr, "deactivate should not remove validator in same epoch") + receipt, err = sendWithdrawTx(servers[0], validatorAddr, validatorKey, big.NewInt(1)) + require.NoError(t, err) + + waitForNextEpochTransition(t, servers, 5) + snapshotAfterDeactivateBoundary := mustGetLatestSnapshotValidators(t, servers[0]) + require.NotContains(t, snapshotAfterDeactivateBoundary, validatorAddr, "deactivate should be effective after epoch boundary") + receipt, err = sendWithdrawTx(servers[0], validatorAddr, validatorKey, big.NewInt(1)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + accountStake, err := framework.GetAccountStake(validatorAddr, servers[0].JSONRPC()) + require.NoError(t, err) + withdrawTooMuch := new(big.Int).Sub(accountStake, new(big.Int).Sub(minSelfStake, big.NewInt(1))) + receipt, err = sendWithdrawTx(servers[0], validatorAddr, validatorKey, withdrawTooMuch) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status) + + receipt, err = framework.UnstakeAmount(validatorAddr, validatorKey, servers[0]) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + waitForNextEpochTransition(t, servers, 5) + + info, err := queryValidatorInfo(servers[0], addrs[0], validatorAddr) + require.NoError(t, err) + require.False(t, info.Exists) + require.Zero(t, info.StakedAmount.Sign()) +} + +func TestPoS_StakingV2_DelegatorLifecycle_ActivationWithdrawAndExit(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 3, 5, 1, 3) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], addrs[0]) + require.NoError(t, err) + delegatorMinStake, err := queryDelegatorMinStake(servers[0], addrs[0]) + require.NoError(t, err) + + receipt, err := sendStakeTx(servers[0], addrs[0], keys[0], minSelfStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorAddr := crypto.PubKeyToAddress(&delegatorKey.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], delegatorAddr, new(big.Int).Mul(delegatorMinStake, big.NewInt(8))) + waitForNextEpochTransition(t, servers, 5) + + receipt, err = sendDelegateTx(servers[0], delegatorAddr, delegatorKey, addrs[0], delegatorMinStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "delegate on closed pool must fail") + + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], addrs[0], keys[0], true, new(big.Int).Mul(delegatorMinStake, big.NewInt(100)), 0)) + receipt, err = sendDelegateTx(servers[0], delegatorAddr, delegatorKey, addrs[0], new(big.Int).Sub(delegatorMinStake, big.NewInt(1))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "new delegation below min must fail") + + receipt, err = sendDelegateTx(servers[0], delegatorAddr, delegatorKey, addrs[0], delegatorMinStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + activeDelegated, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, 0, activeDelegated.Cmp(delegatorMinStake)) + + waitUntilMidEpoch(t, servers[0], 5) + require.NoError(t, sendSetDelegationActiveTx(servers[0], delegatorAddr, delegatorKey, addrs[0], false)) + waitForNextEpochTransition(t, servers, 5) + + beforeRaw, err := queryValidatorDelegatedStakeRaw(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + beforeActive, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + + addAmount := new(big.Int).Mul(delegatorMinStake, big.NewInt(2)) + receipt, err = sendDelegateTx(servers[0], delegatorAddr, delegatorKey, addrs[0], addAmount) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + afterRaw, err := queryValidatorDelegatedStakeRaw(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + afterActive, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + + require.Equal(t, 0, afterRaw.Cmp(new(big.Int).Add(beforeRaw, addAmount))) + require.Equal(t, 0, afterActive.Cmp(beforeActive), "inactive top-up must not increase active delegated") + + belowMinDelegatorKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + belowMinDelegatorAddr := crypto.PubKeyToAddress(&belowMinDelegatorKey.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], belowMinDelegatorAddr, new(big.Int).Mul(delegatorMinStake, big.NewInt(2))) + + receipt, err = sendDelegateTx(servers[0], belowMinDelegatorAddr, belowMinDelegatorKey, addrs[0], new(big.Int).Sub(delegatorMinStake, big.NewInt(1))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status) + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], belowMinDelegatorAddr, belowMinDelegatorKey, addrs[0], true) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "setDelegationActive(true) after below-min failed join must fail") + + receipt, err = sendDelegateTx(servers[0], delegatorAddr, delegatorKey, addrs[0], new(big.Int).Add(delegatorMinStake, big.NewInt(1))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorAddr, delegatorKey, addrs[0], true) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status, "setDelegationActive(true) in reactivation path must succeed") + + reactivatedInfo, err := queryStakerInfo(servers[0], addrs[0], delegatorAddr) + require.NoError(t, err) + require.True(t, reactivatedInfo.Active) + require.Zero(t, reactivatedInfo.DeactivatedAtBlock.Sign()) + + reactivatedDelegatedActive, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, 0, reactivatedDelegatedActive.Cmp(reactivatedInfo.Amount)) + + receipt, err = sendWithdrawDelegationReceiptTx(servers[0], delegatorAddr, delegatorKey, addrs[0], big.NewInt(1)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "withdraw while active must fail") + + require.NoError(t, sendSetDelegationActiveTx(servers[0], delegatorAddr, delegatorKey, addrs[0], false)) + + deactivatedInfo, err := queryStakerInfo(servers[0], addrs[0], delegatorAddr) + require.NoError(t, err) + require.False(t, deactivatedInfo.Active) + require.True(t, deactivatedInfo.DeactivatedAtBlock.Sign() > 0) + + receipt, err = sendWithdrawDelegationReceiptTx(servers[0], delegatorAddr, delegatorKey, addrs[0], big.NewInt(1)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "same-epoch withdraw after deactivate must fail") + + waitForNextEpochTransition(t, servers, 5) + + receipt, err = sendWithdrawDelegationReceiptTx(servers[0], delegatorAddr, delegatorKey, addrs[0], big.NewInt(1)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + info := &stakingStakerInfo{} + info, err = queryStakerInfo(servers[0], addrs[0], delegatorAddr) + require.NoError(t, err) + + withdrawBelowMin := new(big.Int).Sub(info.Amount, new(big.Int).Sub(delegatorMinStake, big.NewInt(1))) + receipt, err = sendWithdrawDelegationReceiptTx(servers[0], delegatorAddr, delegatorKey, addrs[0], withdrawBelowMin) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status) + + info, err = queryStakerInfo(servers[0], addrs[0], delegatorAddr) + require.NoError(t, err) + + receipt, err = sendWithdrawDelegationReceiptTx(servers[0], delegatorAddr, delegatorKey, addrs[0], new(big.Int).Set(info.Amount)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "full exit must use unstakeDelegation") + + countBefore, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + + receipt, err = sendUnstakeDelegationTx(servers[0], delegatorAddr, delegatorKey, addrs[0]) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + countAfter, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, countBefore-1, countAfter) + + info, err = queryStakerInfo(servers[0], addrs[0], delegatorAddr) + require.NoError(t, err) + assert.False(t, info.Exists) +} + +func TestPoS_StakingV2_EconomicConservation_FullLifecycle(t *testing.T) { + epochSize := uint64(5) + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, epochSize, 1, 4) + + validator := addrs[0] + validatorKey := keys[0] + knownStakers := append([]types.Address(nil), addrs...) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], validator) + require.NoError(t, err) + delegatorMinStake, err := queryDelegatorMinStake(servers[0], validator) + require.NoError(t, err) + + validatorInfo, err := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.True(t, validatorInfo.Exists) + + if validatorInfo.Amount.Cmp(minSelfStake) < 0 { + topUp := new(big.Int).Sub(minSelfStake, validatorInfo.Amount) + receipt, stakeErr := sendStakeTx(servers[0], validator, validatorKey, topUp) + require.NoError(t, stakeErr) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + } + + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], validator, validatorKey, true, new(big.Int).Mul(delegatorMinStake, big.NewInt(100)), 0)) + + delegatorAKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorA := crypto.PubKeyToAddress(&delegatorAKey.PublicKey) + knownStakers = append(knownStakers, delegatorA) + delegationA := new(big.Int).Mul(delegatorMinStake, big.NewInt(3)) + fundAccount(t, servers[0], validator, validatorKey, delegatorA, new(big.Int).Mul(delegatorMinStake, big.NewInt(10))) + + delegatorBKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorB := crypto.PubKeyToAddress(&delegatorBKey.PublicKey) + knownStakers = append(knownStakers, delegatorB) + delegationB := new(big.Int).Mul(delegatorMinStake, big.NewInt(2)) + fundAccount(t, servers[0], validator, validatorKey, delegatorB, new(big.Int).Mul(delegatorMinStake, big.NewInt(10))) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + rejectedDelegatorKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + rejectedDelegator := crypto.PubKeyToAddress(&rejectedDelegatorKey.PublicKey) + fundAccount(t, servers[0], validator, validatorKey, rejectedDelegator, new(big.Int).Mul(delegatorMinStake, big.NewInt(2))) + + assertRejectedStakingTxDoesNotChangeKnownStakes(t, servers[0], validator, knownStakers, epochSize, func() (*ethgo.Receipt, error) { + return sendDelegateTx(servers[0], rejectedDelegator, rejectedDelegatorKey, validator, new(big.Int).Sub(delegatorMinStake, big.NewInt(1))) + }, "below-min delegation must be rejected without changing the staking economy") + + rejectedInfo, err := queryStakerInfo(servers[0], validator, rejectedDelegator) + require.NoError(t, err) + require.False(t, rejectedInfo.Exists, "below-min rejected delegator must not be created") + + receipt, err := sendDelegateTx(servers[0], delegatorA, delegatorAKey, validator, delegationA) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorAInfo, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfo.Exists) + require.Equal(t, 0, delegatorAInfo.Amount.Cmp(delegationA)) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + assertRejectedStakingTxDoesNotChangeKnownStakes(t, servers[0], validator, knownStakers, epochSize, func() (*ethgo.Receipt, error) { + return sendWithdrawDelegationReceiptTx(servers[0], delegatorA, delegatorAKey, validator, big.NewInt(1)) + }, "active delegator withdraw must be rejected without changing the staking economy") + + receipt, err = sendDelegateTx(servers[0], delegatorB, delegatorBKey, validator, delegationB) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorBInfo, err := queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + require.True(t, delegatorBInfo.Exists) + require.Equal(t, 0, delegatorBInfo.Amount.Cmp(delegationB)) + + rawAfterDelegations, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawAfterDelegations.Cmp(new(big.Int).Add(delegationA, delegationB))) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + waitForNextEpochTransition(t, servers, epochSize) + + activeAfterDelegations, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + delegatorAInfo, err = queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + + require.Equal(t, 0, activeAfterDelegations.Cmp(new(big.Int).Add(delegatorAInfo.Amount, delegatorBInfo.Amount))) + assertStakingConservation(t, servers[0], validator, knownStakers) + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorA, delegatorAKey, validator, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorAInfo, err = queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.False(t, delegatorAInfo.Active) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + waitForNextEpochTransition(t, servers, epochSize) + + activeAfterAInactive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + + require.Equal(t, 0, activeAfterAInactive.Cmp(delegatorBInfo.Amount)) + assertStakingConservation(t, servers[0], validator, knownStakers) + + beforeRaw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + beforeActive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + beforeDelegatorAInfo, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + + inactiveTopUp := new(big.Int).Set(delegatorMinStake) + receipt, err = sendDelegateTx(servers[0], delegatorA, delegatorAKey, validator, inactiveTopUp) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + afterRaw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + afterActive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + afterDelegatorAInfo, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + + require.Equal(t, 0, afterRaw.Cmp(new(big.Int).Add(beforeRaw, inactiveTopUp))) + require.Equal(t, 0, afterActive.Cmp(beforeActive), "inactive top-up must not increase active delegated stake") + require.Equal(t, 0, afterDelegatorAInfo.Amount.Cmp(new(big.Int).Add(beforeDelegatorAInfo.Amount, inactiveTopUp))) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + withdrawDelegatorA := big.NewInt(1) + beforeDelegatorAInfo = afterDelegatorAInfo + + receipt, err = sendWithdrawDelegationReceiptTx(servers[0], delegatorA, delegatorAKey, validator, withdrawDelegatorA) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + afterDelegatorAInfo, err = queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.Equal(t, 0, afterDelegatorAInfo.Amount.Cmp(new(big.Int).Sub(beforeDelegatorAInfo.Amount, withdrawDelegatorA))) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorA, delegatorAKey, validator, true) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorAInfo, err = queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + + activeAfterAReactivation, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeAfterAReactivation.Cmp(new(big.Int).Add(delegatorAInfo.Amount, delegatorBInfo.Amount))) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorB, delegatorBKey, validator, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + require.False(t, delegatorBInfo.Active) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + waitForNextEpochTransition(t, servers, epochSize) + + activeAfterBInactive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + delegatorAInfo, err = queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + + require.Equal(t, 0, activeAfterBInactive.Cmp(delegatorAInfo.Amount)) + assertStakingConservation(t, servers[0], validator, knownStakers) + + beforeRaw, err = queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + beforeActive, err = queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + beforeDelegatorBInfo, err := queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + + receipt, err = sendUnstakeDelegationTx(servers[0], delegatorB, delegatorBKey, validator) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + require.False(t, delegatorBInfo.Exists) + require.False(t, validatorHasStaker(t, servers[0], validator, validator, delegatorB)) + + afterRaw, err = queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + afterActive, err = queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + require.Equal(t, 0, afterRaw.Cmp(new(big.Int).Sub(beforeRaw, beforeDelegatorBInfo.Amount))) + require.Equal(t, 0, afterActive.Cmp(beforeActive), "inactive full unstake must not change active delegated stake") + + assertStakingConservation(t, servers[0], validator, knownStakers) + + receipt, err = sendSetActiveReceiptTx(servers[0], validator, validatorKey, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + validatorInfo, err = queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.False(t, validatorInfo.Active) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + waitForNextEpochTransition(t, servers, epochSize) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + withdrawValidator := big.NewInt(1) + beforeValidatorInfo, err := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + + receipt, err = sendWithdrawTx(servers[0], validator, validatorKey, withdrawValidator) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + afterValidatorInfo, err := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, afterValidatorInfo.Amount.Cmp(new(big.Int).Sub(beforeValidatorInfo.Amount, withdrawValidator))) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + waitForNextEpochTransition(t, servers, epochSize) + + receipt, err = framework.UnstakeAmount(validator, validatorKey, servers[0]) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + validatorInfo, err = queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.False(t, validatorInfo.Exists) + + delegatorAInfo, err = queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfo.Exists) + require.Equal(t, validator, delegatorAInfo.Validator) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorA, delegatorAKey, validator, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + waitForNextEpochTransition(t, servers, epochSize) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + receipt, err = sendUnstakeDelegationTx(servers[0], delegatorA, delegatorAKey, validator) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorAInfo, err = queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.False(t, delegatorAInfo.Exists) + + assertStakingConservation(t, servers[0], validator, knownStakers) +} + +func TestPoS_StakingV2_Delegator_DoubleWithdrawAndDoubleUnstakeRejected(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 5, 1, 4) + + validator := addrs[0] + validatorKey := keys[0] + knownStakers := append([]types.Address(nil), addrs...) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], validator) + require.NoError(t, err) + + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], validator, validatorKey, true, new(big.Int).Mul(delegatorMinStake, big.NewInt(100)), 0)) + + delegatorKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegator := crypto.PubKeyToAddress(&delegatorKey.PublicKey) + knownStakers = append(knownStakers, delegator) + + delegationAmount := new(big.Int).Mul(delegatorMinStake, big.NewInt(3)) + fundAccount(t, servers[0], validator, validatorKey, delegator, new(big.Int).Mul(delegatorMinStake, big.NewInt(6))) + + receipt, err := sendDelegateTx(servers[0], delegator, delegatorKey, validator, delegationAmount) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegator, delegatorKey, validator, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + _, _ = stakingEconomySnapshot(t, servers[0], validator, knownStakers) + + delegatorInfoBeforeWithdraw, err := queryStakerInfo(servers[0], validator, delegator) + require.NoError(t, err) + require.True(t, delegatorInfoBeforeWithdraw.Exists) + require.False(t, delegatorInfoBeforeWithdraw.Active) + require.Greater(t, delegatorInfoBeforeWithdraw.Amount.Cmp(delegatorMinStake), 0, "delegator amount must allow a partial withdraw and invalid below-minimum withdraw checks") + + rawBeforeWithdraw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + activeBeforeWithdraw, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + withdrawAmount := big.NewInt(1) + receipt, err = sendWithdrawDelegationReceiptTx(servers[0], delegator, delegatorKey, validator, withdrawAmount) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorInfoAfterWithdraw, err := queryStakerInfo(servers[0], validator, delegator) + require.NoError(t, err) + require.True(t, delegatorInfoAfterWithdraw.Exists) + require.Equal(t, 0, delegatorInfoAfterWithdraw.Amount.Cmp(new(big.Int).Sub(delegatorInfoBeforeWithdraw.Amount, withdrawAmount))) + + rawAfterWithdraw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + activeAfterWithdraw, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + require.Equal(t, 0, rawAfterWithdraw.Cmp(new(big.Int).Sub(rawBeforeWithdraw, withdrawAmount))) + require.Equal(t, 0, activeAfterWithdraw.Cmp(activeBeforeWithdraw), "inactive delegator withdraw must not change active delegated stake") + + assertStakingConservation(t, servers[0], validator, knownStakers) + + assertRejectedDelegationMutation := func(amount *big.Int, msg string) { + t.Helper() + + delegatorInfoBefore, infoErr := queryStakerInfo(servers[0], validator, delegator) + require.NoError(t, infoErr) + + beforeRaw, rawErr := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, rawErr) + + beforeActive, activeErr := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, activeErr) + + receipt, txErr := sendWithdrawDelegationReceiptTx(servers[0], delegator, delegatorKey, validator, amount) + require.NoError(t, txErr) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, msg) + + delegatorInfoAfter, infoErr := queryStakerInfo(servers[0], validator, delegator) + require.NoError(t, infoErr) + require.Equal(t, delegatorInfoBefore.Exists, delegatorInfoAfter.Exists, msg) + require.Equal(t, 0, delegatorInfoAfter.Amount.Cmp(delegatorInfoBefore.Amount), msg) + + afterRaw, rawErr := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, rawErr) + + afterActive, activeErr := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, activeErr) + + require.Equal(t, 0, afterRaw.Cmp(beforeRaw), msg) + require.Equal(t, 0, afterActive.Cmp(beforeActive), msg) + } + + remainingAfterWithdraw := new(big.Int).Set(delegatorInfoAfterWithdraw.Amount) + + assertRejectedDelegationMutation(big.NewInt(0), "zero delegation withdraw must be rejected without mutating staking accounting") + assertRejectedDelegationMutation(new(big.Int).Set(remainingAfterWithdraw), "full delegation withdraw must be rejected without mutating staking accounting") + + withdrawBelowMin := new(big.Int).Sub(remainingAfterWithdraw, new(big.Int).Sub(delegatorMinStake, big.NewInt(1))) + assertRejectedDelegationMutation(withdrawBelowMin, "delegation withdraw leaving below the minimum must be rejected without mutating staking accounting") + + beforeUnstakeInfo, err := queryStakerInfo(servers[0], validator, delegator) + require.NoError(t, err) + require.True(t, beforeUnstakeInfo.Exists) + + beforeUnstakeRaw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + beforeUnstakeActive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + receipt, err = sendUnstakeDelegationTx(servers[0], delegator, delegatorKey, validator) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegatorInfoAfterUnstake, err := queryStakerInfo(servers[0], validator, delegator) + require.NoError(t, err) + require.False(t, delegatorInfoAfterUnstake.Exists) + require.False(t, validatorHasStaker(t, servers[0], validator, validator, delegator)) + + afterUnstakeRaw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + afterUnstakeActive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + require.Equal(t, 0, afterUnstakeRaw.Cmp(new(big.Int).Sub(beforeUnstakeRaw, beforeUnstakeInfo.Amount))) + require.Equal(t, 0, afterUnstakeActive.Cmp(beforeUnstakeActive), "inactive full unstake must not change active delegated stake") + + assertStakingConservation(t, servers[0], validator, knownStakers) + + balanceBeforeDoubleUnstake, _ := stakingEconomySnapshot(t, servers[0], validator, knownStakers) + + rawBeforeDoubleUnstake, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + activeBeforeDoubleUnstake, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + receipt, err = sendUnstakeDelegationTx(servers[0], delegator, delegatorKey, validator) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "double unstakeDelegation must be rejected") + + balanceAfterDoubleUnstake, _ := stakingEconomySnapshot(t, servers[0], validator, knownStakers) + require.GreaterOrEqual(t, balanceAfterDoubleUnstake.Cmp(balanceBeforeDoubleUnstake), 0, "double unstakeDelegation must not debit the staking contract balance") + + rawAfterDoubleUnstake, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + activeAfterDoubleUnstake, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + require.Equal(t, 0, rawAfterDoubleUnstake.Cmp(rawBeforeDoubleUnstake)) + require.Equal(t, 0, activeAfterDoubleUnstake.Cmp(activeBeforeDoubleUnstake)) + + delegatorInfoAfterDoubleUnstake, err := queryStakerInfo(servers[0], validator, delegator) + require.NoError(t, err) + require.False(t, delegatorInfoAfterDoubleUnstake.Exists) + require.False(t, validatorHasStaker(t, servers[0], validator, validator, delegator)) + + assertStakingConservation(t, servers[0], validator, knownStakers) +} + +func TestPoS_StakingV2_Validator_DoubleWithdrawAndDoubleUnstakeRejected(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 5, 1, 4) + + validator := addrs[0] + validatorKey := keys[0] + knownStakers := append([]types.Address(nil), addrs...) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], validator) + require.NoError(t, err) + + validatorInfoBeforeDeactivate, err := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.True(t, validatorInfoBeforeDeactivate.Exists) + require.Greater(t, validatorInfoBeforeDeactivate.Amount.Cmp(minSelfStake), 0, "setup validator stake must allow a partial withdraw while staying above the minimum") + + receipt, err := sendSetActiveReceiptTx(servers[0], validator, validatorKey, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + _, _ = stakingEconomySnapshot(t, servers[0], validator, knownStakers) + + validatorInfoBeforeWithdraw, err := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.True(t, validatorInfoBeforeWithdraw.Exists) + require.False(t, validatorInfoBeforeWithdraw.Active) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + withdrawAmount := big.NewInt(1) + receipt, err = sendWithdrawTx(servers[0], validator, validatorKey, withdrawAmount) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + validatorInfoAfterWithdraw, err := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.True(t, validatorInfoAfterWithdraw.Exists) + require.Equal(t, 0, validatorInfoAfterWithdraw.Amount.Cmp(new(big.Int).Sub(validatorInfoBeforeWithdraw.Amount, withdrawAmount))) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + remainingAfterWithdraw := new(big.Int).Set(validatorInfoAfterWithdraw.Amount) + + assertRejectedValidatorWithdraw := func(amount *big.Int, msg string) { + t.Helper() + + validatorInfoBefore, infoErr := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, infoErr) + + receipt, txErr := sendWithdrawTx(servers[0], validator, validatorKey, amount) + require.NoError(t, txErr) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, msg) + + validatorInfoAfter, infoErr := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, infoErr) + require.Equal(t, validatorInfoBefore.Exists, validatorInfoAfter.Exists, msg) + require.Equal(t, 0, validatorInfoAfter.Amount.Cmp(validatorInfoBefore.Amount), msg) + + assertStakingConservation(t, servers[0], validator, knownStakers) + } + + assertRejectedValidatorWithdraw(big.NewInt(0), "zero validator withdraw must be rejected without mutating validator accounting") + assertRejectedValidatorWithdraw(new(big.Int).Set(remainingAfterWithdraw), "full validator withdraw must be rejected without mutating validator accounting") + + withdrawBelowMin := new(big.Int).Sub(remainingAfterWithdraw, new(big.Int).Sub(minSelfStake, big.NewInt(1))) + assertRejectedValidatorWithdraw(withdrawBelowMin, "validator withdraw leaving below the minimum must be rejected without mutating validator accounting") + + receipt, err = framework.UnstakeAmount(validator, validatorKey, servers[0]) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + validatorInfoAfterUnstake, err := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.False(t, validatorInfoAfterUnstake.Exists) + + validatorSet, err := framework.GetValidatorSet(validator, servers[0].JSONRPC()) + require.NoError(t, err) + require.NotContains(t, validatorSet, validator) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + balanceBeforeDoubleUnstake, _ := stakingEconomySnapshot(t, servers[0], validator, knownStakers) + + receipt, err = framework.UnstakeAmount(validator, validatorKey, servers[0]) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, "double validator unstake must be rejected") + + balanceAfterDoubleUnstake, _ := stakingEconomySnapshot(t, servers[0], validator, knownStakers) + require.GreaterOrEqual(t, balanceAfterDoubleUnstake.Cmp(balanceBeforeDoubleUnstake), 0, "double validator unstake must not debit the staking contract balance") + + validatorInfoAfterDoubleUnstake, err := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.False(t, validatorInfoAfterDoubleUnstake.Exists) + + assertStakingConservation(t, servers[0], validator, knownStakers) +} + +func TestPoS_StakingV2_ValidatorExit_DoesNotRemoveDelegatorPosition(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 5, 1, 4) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], addrs[0]) + require.NoError(t, err) + delegatorMinStake, err := queryDelegatorMinStake(servers[0], addrs[0]) + require.NoError(t, err) + + receipt, err := sendStakeTx(servers[0], addrs[0], keys[0], minSelfStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], addrs[0], keys[0], true, new(big.Int).Mul(delegatorMinStake, big.NewInt(100)), 0)) + + delegatorKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorAddr := crypto.PubKeyToAddress(&delegatorKey.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], delegatorAddr, new(big.Int).Mul(delegatorMinStake, big.NewInt(4))) + + receipt, err = sendDelegateTx(servers[0], delegatorAddr, delegatorKey, addrs[0], new(big.Int).Mul(delegatorMinStake, big.NewInt(2))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + stakerCountBeforeExit, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Greater(t, stakerCountBeforeExit, uint64(0)) + require.True(t, validatorHasStaker(t, servers[0], addrs[1], addrs[0], delegatorAddr)) + + require.NoError(t, sendSetActiveTx(servers[0], addrs[0], keys[0], false)) + + waitForNextEpochTransition(t, servers, 5) + + receipt, err = framework.UnstakeAmount(addrs[0], keys[0], servers[0]) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + validatorInfo, err := queryValidatorInfo(servers[0], addrs[1], addrs[0]) + require.NoError(t, err) + require.False(t, validatorInfo.Exists) + + selfStakerInfo, err := queryStakerInfo(servers[0], addrs[1], addrs[0]) + require.NoError(t, err) + require.False(t, selfStakerInfo.Exists) + + delegatorInfo, err := queryStakerInfo(servers[0], addrs[1], delegatorAddr) + require.NoError(t, err) + require.True(t, delegatorInfo.Exists) + + stakerCountAfterExit, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Greater(t, stakerCountAfterExit, uint64(0)) + require.True(t, validatorHasStaker(t, servers[0], addrs[1], addrs[0], delegatorAddr)) + + require.NoError(t, sendSetDelegationActiveTx(servers[0], delegatorAddr, delegatorKey, addrs[0], false)) + + waitForNextEpochTransition(t, servers, 5) + + receipt, err = sendWithdrawDelegationReceiptTx(servers[0], delegatorAddr, delegatorKey, addrs[0], big.NewInt(1)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + receipt, err = sendUnstakeDelegationTx(servers[0], delegatorAddr, delegatorKey, addrs[0]) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) +} + +func TestPoS_StakingV2_DelegationAfterValidatorRejoin_Invariants(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 5, 1, 4) + + validatorAddr := addrs[0] + validatorKey := keys[0] + + validatorThreshold, err := queryValidatorThreshold(servers[0], addrs[0]) + require.NoError(t, err) + delegatorMinStake, err := queryDelegatorMinStake(servers[0], addrs[0]) + require.NoError(t, err) + + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], validatorAddr, validatorKey, true, new(big.Int).Mul(delegatorMinStake, big.NewInt(100)), 0)) + + assertValidatorAbsent := func() { + t.Helper() + + validatorInfo, infoErr := queryValidatorInfo(servers[0], addrs[0], validatorAddr) + require.NoError(t, infoErr) + require.False(t, validatorInfo.Exists) + + validatorSet, setErr := framework.GetValidatorSet(addrs[0], servers[0].JSONRPC()) + require.NoError(t, setErr) + require.NotContains(t, validatorSet, validatorAddr) + require.NotContains(t, mustGetLatestSnapshotValidators(t, servers[0]), validatorAddr) + } + + delegatorKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorAddr := crypto.PubKeyToAddress(&delegatorKey.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], delegatorAddr, new(big.Int).Mul(delegatorMinStake, big.NewInt(20))) + + receipt, err := sendDelegateTx(servers[0], delegatorAddr, delegatorKey, validatorAddr, new(big.Int).Mul(delegatorMinStake, big.NewInt(3))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + delegatorInfoBeforeExit, err := queryStakerInfo(servers[0], addrs[0], delegatorAddr) + require.NoError(t, err) + require.True(t, delegatorInfoBeforeExit.Exists) + require.Equal(t, validatorAddr, delegatorInfoBeforeExit.Validator) + + require.NoError(t, sendSetActiveTx(servers[0], validatorAddr, validatorKey, false)) + + waitForNextEpochTransition(t, servers, 5) + + receipt, err = framework.UnstakeAmount(validatorAddr, validatorKey, servers[0]) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + assertValidatorAbsent() + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorAddr, delegatorKey, validatorAddr, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + assertValidatorAbsent() + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorAddr, delegatorKey, validatorAddr, true) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + assertValidatorAbsent() + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorAddr, delegatorKey, validatorAddr, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + assertValidatorAbsent() + + waitForNextEpochTransition(t, servers, 5) + + receipt, err = sendWithdrawDelegationReceiptTx(servers[0], delegatorAddr, delegatorKey, validatorAddr, big.NewInt(1)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + assertValidatorAbsent() + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorAddr, delegatorKey, validatorAddr, true) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + assertValidatorAbsent() + + delegator2Key, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegator2Addr := crypto.PubKeyToAddress(&delegator2Key.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], delegator2Addr, new(big.Int).Mul(delegatorMinStake, big.NewInt(20))) + + receipt, err = sendDelegateTx(servers[0], delegator2Addr, delegator2Key, validatorAddr, new(big.Int).Mul(delegatorMinStake, big.NewInt(2))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status) + + delegator2Info, err := queryStakerInfo(servers[0], addrs[0], delegator2Addr) + require.NoError(t, err) + require.False(t, delegator2Info.Exists) + require.False(t, validatorHasStaker(t, servers[0], addrs[0], validatorAddr, delegator2Addr)) + + assertValidatorAbsent() + + require.NotContains(t, mustGetLatestSnapshotValidators(t, servers[0]), validatorAddr) + + receipt, err = sendStakeTx(servers[0], validatorAddr, validatorKey, validatorThreshold) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + require.NotContains(t, mustGetLatestSnapshotValidators(t, servers[0]), validatorAddr) + + waitForNextEpochTransition(t, servers, 5) + + require.Contains(t, mustGetLatestSnapshotValidators(t, servers[0]), validatorAddr) + + delegatorInfoAfterRejoin, err := queryStakerInfo(servers[0], addrs[0], delegatorAddr) + require.NoError(t, err) + require.Equal(t, validatorAddr, delegatorInfoAfterRejoin.Validator) + + delegatedActiveAfterEpoch, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], validatorAddr) + require.NoError(t, err) + require.Equal(t, 0, delegatedActiveAfterEpoch.Cmp(delegatorInfoAfterRejoin.Amount), "active old delegation is only economically relevant again after valid rejoin + snapshot") + + receipt, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorAddr, delegatorKey, validatorAddr, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + delegatedActiveAfterLegacyDeactivate, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], validatorAddr) + require.NoError(t, err) + require.Zero(t, delegatedActiveAfterLegacyDeactivate.Sign()) + + poolAfterRejoin, err := queryValidatorPoolConfig(servers[0], addrs[0], validatorAddr) + require.NoError(t, err) + require.False(t, poolAfterRejoin.delegationEnabled) + require.Zero(t, poolAfterRejoin.maxDelegatedStake.Sign()) + require.Zero(t, poolAfterRejoin.minDelegatorStake.Sign()) + require.Equal(t, uint16(0), poolAfterRejoin.commissionBps) + + receipt, err = sendDelegateTx(servers[0], delegator2Addr, delegator2Key, validatorAddr, new(big.Int).Mul(delegatorMinStake, big.NewInt(2))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status) + + delegator2AfterClosedPool, err := queryStakerInfo(servers[0], addrs[0], delegator2Addr) + require.NoError(t, err) + require.False(t, delegator2AfterClosedPool.Exists) + require.False(t, validatorHasStaker(t, servers[0], addrs[0], validatorAddr, delegator2Addr)) + + require.NoError(t, sendSetValidatorPoolConfigTx( + servers[0], + validatorAddr, + validatorKey, + true, + new(big.Int).Mul(delegatorMinStake, big.NewInt(100)), + 0, + )) + + receipt, err = sendDelegateTx(servers[0], delegator2Addr, delegator2Key, validatorAddr, new(big.Int).Mul(delegatorMinStake, big.NewInt(2))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + delegator2AfterReopen, err := queryStakerInfo(servers[0], addrs[0], delegator2Addr) + require.NoError(t, err) + require.True(t, delegator2AfterReopen.Exists) + require.Equal(t, validatorAddr, delegator2AfterReopen.Validator) + require.True(t, validatorHasStaker(t, servers[0], addrs[0], validatorAddr, delegator2Addr)) + + waitForNextEpochTransition(t, servers, 5) + + receipt, err = sendUnstakeDelegationTx(servers[0], delegatorAddr, delegatorKey, validatorAddr) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + legacyAfterUnstake, err := queryStakerInfo(servers[0], addrs[0], delegatorAddr) + require.NoError(t, err) + require.False(t, legacyAfterUnstake.Exists) + require.False(t, validatorHasStaker(t, servers[0], addrs[0], validatorAddr, delegatorAddr)) + + delegatedActiveAfterLegacyUnstake, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], validatorAddr) + require.NoError(t, err) + require.Equal(t, 0, delegatedActiveAfterLegacyUnstake.Cmp(delegator2AfterReopen.Amount)) +} + +func TestPoS_StakingV2_Reentrancy_DelegatorWithdrawCannotDoubleSpend(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 5, 1, 4) + + validator := addrs[0] + validatorKey := keys[0] + caller := addrs[1] + callerKey := keys[1] + knownStakers := append([]types.Address(nil), addrs...) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], validator) + require.NoError(t, err) + + fundAccount(t, servers[0], validator, validatorKey, caller, new(big.Int).Mul(delegatorMinStake, big.NewInt(10))) + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], validator, validatorKey, true, new(big.Int).Mul(delegatorMinStake, big.NewInt(100)), 0)) + + maliciousDelegator := deployStakingV2ReentrantDelegator(t, servers[0], caller, callerKey) + knownStakers = append(knownStakers, maliciousDelegator) + + delegationAmount := new(big.Int).Mul(delegatorMinStake, big.NewInt(3)) + receipt, err := sendStakingV2ReentrantDelegatorTx(servers[0], caller, callerKey, maliciousDelegator, "delegate", delegationAmount, map[string]interface{}{ + "validator_": ethgo.Address(validator), + }) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + waitForNextEpochTransition(t, servers, 5) + + receipt, err = sendStakingV2ReentrantDelegatorTx(servers[0], caller, callerKey, maliciousDelegator, "setDelegationActive", big.NewInt(0), map[string]interface{}{ + "validator_": ethgo.Address(validator), + "active": false, + }) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + infoBefore, err := queryStakerInfo(servers[0], validator, maliciousDelegator) + require.NoError(t, err) + require.True(t, infoBefore.Exists) + require.False(t, infoBefore.Active) + + rawBefore, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + activeBefore, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + countBefore, err := queryValidatorStakerCount(servers[0], validator, validator) + require.NoError(t, err) + + require.True(t, validatorHasStaker(t, servers[0], validator, validator, maliciousDelegator)) + + receipt, err = sendStakingV2ReentrantDelegatorTx(servers[0], caller, callerKey, maliciousDelegator, "configure", big.NewInt(0), map[string]interface{}{ + "mode_": stakingV2ReentryModeWithdraw, + "validator_": ethgo.Address(validator), + "amount_": big.NewInt(1), + }) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + balanceImmediatelyBeforePayout, err := servers[0].JSONRPC().Eth().GetBalance(ethgo.Address(staking.AddrStakingContract), ethgo.Latest) + require.NoError(t, err) + + maliciousBalanceBeforePayout, err := servers[0].JSONRPC().Eth().GetBalance(ethgo.Address(maliciousDelegator), ethgo.Latest) + require.NoError(t, err) + + receipt, err = sendStakingV2ReentrantDelegatorTx(servers[0], caller, callerKey, maliciousDelegator, "withdrawDelegation", big.NewInt(0), map[string]interface{}{ + "validator_": ethgo.Address(validator), + "amount_": big.NewInt(1), + }) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + balanceAfter, err := servers[0].JSONRPC().Eth().GetBalance(ethgo.Address(staking.AddrStakingContract), ethgo.Latest) + require.NoError(t, err) + + maliciousBalanceAfterPayout, err := servers[0].JSONRPC().Eth().GetBalance(ethgo.Address(maliciousDelegator), ethgo.Latest) + require.NoError(t, err) + + attempted, err := queryStakingV2ReentrantDelegatorBool(servers[0], validator, maliciousDelegator, "attempted") + require.NoError(t, err) + require.True(t, attempted, "malicious fallback must attempt the configured reentrant withdraw") + + infoAfter, err := queryStakerInfo(servers[0], validator, maliciousDelegator) + require.NoError(t, err) + require.True(t, infoAfter.Exists) + require.Equal(t, 0, infoAfter.Amount.Cmp(new(big.Int).Sub(infoBefore.Amount, big.NewInt(1))), "withdraw reentry must not withdraw a second unit") + + rawAfter, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawAfter.Cmp(new(big.Int).Sub(rawBefore, big.NewInt(1)))) + + activeAfter, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeAfter.Cmp(activeBefore), "inactive delegator withdraw must not affect active delegated stake") + + countAfter, err := queryValidatorStakerCount(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, countBefore, countAfter, "partial withdraw must not create or remove staker-list entries") + + require.Equal(t, 0, new(big.Int).Sub(maliciousBalanceAfterPayout, maliciousBalanceBeforePayout).Cmp(big.NewInt(1)), "malicious receiver balance must increase only by the outer withdraw payout") + require.Greater(t, balanceAfter.Cmp(new(big.Int).Sub(balanceImmediatelyBeforePayout, big.NewInt(2))), 0, "staking contract balance must not lose a second withdraw payout even if block rewards drift") + require.True(t, validatorHasStaker(t, servers[0], validator, validator, maliciousDelegator)) + + assertStakingConservation(t, servers[0], validator, knownStakers) +} + +func TestPoS_StakingV2_Reentrancy_DelegatorUnstakeCannotDoubleSpend(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 5, 1, 4) + + validator := addrs[0] + validatorKey := keys[0] + caller := addrs[1] + callerKey := keys[1] + knownStakers := append([]types.Address(nil), addrs...) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], validator) + require.NoError(t, err) + + fundAccount(t, servers[0], validator, validatorKey, caller, new(big.Int).Mul(delegatorMinStake, big.NewInt(10))) + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], validator, validatorKey, true, new(big.Int).Mul(delegatorMinStake, big.NewInt(100)), 0)) + + maliciousDelegator := deployStakingV2ReentrantDelegator(t, servers[0], caller, callerKey) + knownStakers = append(knownStakers, maliciousDelegator) + + delegationAmount := new(big.Int).Mul(delegatorMinStake, big.NewInt(3)) + receipt, err := sendStakingV2ReentrantDelegatorTx(servers[0], caller, callerKey, maliciousDelegator, "delegate", delegationAmount, map[string]interface{}{ + "validator_": ethgo.Address(validator), + }) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + assertStakingConservation(t, servers[0], validator, knownStakers) + + waitForNextEpochTransition(t, servers, 5) + + receipt, err = sendStakingV2ReentrantDelegatorTx(servers[0], caller, callerKey, maliciousDelegator, "setDelegationActive", big.NewInt(0), map[string]interface{}{ + "validator_": ethgo.Address(validator), + "active": false, + }) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + waitForNextEpochTransition(t, servers, 5) + + infoBefore, err := queryStakerInfo(servers[0], validator, maliciousDelegator) + require.NoError(t, err) + require.True(t, infoBefore.Exists) + require.False(t, infoBefore.Active) + + rawBefore, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + activeBefore, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + + require.True(t, validatorHasStaker(t, servers[0], validator, validator, maliciousDelegator)) + + receipt, err = sendStakingV2ReentrantDelegatorTx(servers[0], caller, callerKey, maliciousDelegator, "configure", big.NewInt(0), map[string]interface{}{ + "mode_": stakingV2ReentryModeUnstake, + "validator_": ethgo.Address(validator), + "amount_": big.NewInt(0), + }) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + balanceImmediatelyBeforePayout, err := servers[0].JSONRPC().Eth().GetBalance(ethgo.Address(staking.AddrStakingContract), ethgo.Latest) + require.NoError(t, err) + + maliciousBalanceBeforePayout, err := servers[0].JSONRPC().Eth().GetBalance(ethgo.Address(maliciousDelegator), ethgo.Latest) + require.NoError(t, err) + + receipt, err = sendStakingV2ReentrantDelegatorTx(servers[0], caller, callerKey, maliciousDelegator, "unstakeDelegation", big.NewInt(0), map[string]interface{}{ + "validator_": ethgo.Address(validator), + }) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + + balanceAfter, err := servers[0].JSONRPC().Eth().GetBalance(ethgo.Address(staking.AddrStakingContract), ethgo.Latest) + require.NoError(t, err) + + maliciousBalanceAfterPayout, err := servers[0].JSONRPC().Eth().GetBalance(ethgo.Address(maliciousDelegator), ethgo.Latest) + require.NoError(t, err) + + attempted, err := queryStakingV2ReentrantDelegatorBool(servers[0], validator, maliciousDelegator, "attempted") + require.NoError(t, err) + require.True(t, attempted, "malicious fallback must attempt the configured reentrant unstake") + + infoAfter, err := queryStakerInfo(servers[0], validator, maliciousDelegator) + require.NoError(t, err) + require.False(t, infoAfter.Exists) + require.False(t, validatorHasStaker(t, servers[0], validator, validator, maliciousDelegator)) + + rawAfter, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawAfter.Cmp(new(big.Int).Sub(rawBefore, infoBefore.Amount)), "raw delegated stake must drop by exactly the exited delegation") + + activeAfter, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeAfter.Cmp(activeBefore), "inactive delegator unstake must not affect active delegated stake") + + require.Equal(t, 0, new(big.Int).Sub(maliciousBalanceAfterPayout, maliciousBalanceBeforePayout).Cmp(infoBefore.Amount), "malicious receiver balance must increase only by the outer unstake payout") + require.Greater(t, balanceAfter.Cmp(new(big.Int).Sub(balanceImmediatelyBeforePayout, new(big.Int).Mul(infoBefore.Amount, big.NewInt(2)))), 0, "staking contract balance must not lose a second unstake payout even if block rewards drift") + + assertStakingConservation(t, servers[0], validator, knownStakers) +} + +func assertStakingConservation(t *testing.T, srv *framework.TestServer, queryFrom types.Address, knownStakers []types.Address) { + t.Helper() + + contractBalance, amounts := stakingEconomySnapshot(t, srv, queryFrom, knownStakers) + + summedExistingStakerAmounts := big.NewInt(0) + for _, amount := range amounts { + summedExistingStakerAmounts.Add(summedExistingStakerAmounts, amount) + } + + require.Equal(t, 0, contractBalance.Cmp(summedExistingStakerAmounts), "staking contract native balance must equal summed stakerInfo.amount for all existing known stakers") +} + +func assertRejectedStakingTxDoesNotChangeKnownStakes( + t *testing.T, + srv *framework.TestServer, + queryFrom types.Address, + knownStakers []types.Address, + epochSize uint64, + sendTx func() (*ethgo.Receipt, error), + msg string, +) { + t.Helper() + + for attempt := 0; attempt < 2; attempt++ { + waitUntilMidEpoch(t, srv, epochSize) + + beforeWindow := rejectedTxEpochWindowInfo(t, srv, epochSize) + balanceBefore, amountsBefore := stakingEconomySnapshotAt(t, srv, queryFrom, knownStakers, beforeWindow.blockNumber) + + receipt, err := sendTx() + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status, msg) + + afterWindow := rejectedTxEpochWindowInfo(t, srv, epochSize) + balanceAfter, amountsAfter := stakingEconomySnapshotAt(t, srv, queryFrom, knownStakers, afterWindow.blockNumber) + + if beforeWindow.epoch != afterWindow.epoch { + if attempt == 0 { + t.Logf( + "retrying rejected-tx invariant check after epoch finalized during window: beforeBlock=%d beforeEpoch=%d afterBlock=%d afterEpoch=%d balanceBefore=%s balanceAfter=%s", + beforeWindow.blockNumber, + beforeWindow.epoch, + afterWindow.blockNumber, + afterWindow.epoch, + balanceBefore.String(), + balanceAfter.String(), + ) + continue + } + + require.Failf( + t, + "test invalid: epoch finalized during rejected-tx invariant window", + "beforeBlock=%d beforeEpoch=%d afterBlock=%d afterEpoch=%d balanceBefore=%s balanceAfter=%s", + beforeWindow.blockNumber, + beforeWindow.epoch, + afterWindow.blockNumber, + afterWindow.epoch, + balanceBefore.String(), + balanceAfter.String(), + ) + } + + require.GreaterOrEqual(t, balanceAfter.Cmp(balanceBefore), 0, msg) + require.Len(t, amountsAfter, len(amountsBefore), msg) + + for staker, amountBefore := range amountsBefore { + amountAfter, ok := amountsAfter[staker] + require.True(t, ok, msg) + require.Equal(t, 0, amountAfter.Cmp(amountBefore), msg) + } + + assertStakingConservation(t, srv, queryFrom, knownStakers) + + return + } +} + +type rejectedTxEpochWindow struct { + blockNumber uint64 + epoch uint64 +} + +func rejectedTxEpochWindowInfo(t *testing.T, srv *framework.TestServer, epochSize uint64) rejectedTxEpochWindow { + t.Helper() + + blockNumber, err := srv.JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + + return rejectedTxEpochWindow{ + blockNumber: blockNumber, + epoch: blockNumber / epochSize, + } +} + +func stakingEconomySnapshot(t *testing.T, srv *framework.TestServer, queryFrom types.Address, knownStakers []types.Address) (*big.Int, map[types.Address]*big.Int) { + t.Helper() + + blockNumber, err := srv.JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + + return stakingEconomySnapshotAt(t, srv, queryFrom, knownStakers, blockNumber) +} + +func stakingEconomySnapshotAt(t *testing.T, srv *framework.TestServer, queryFrom types.Address, knownStakers []types.Address, blockNumber uint64) (*big.Int, map[types.Address]*big.Int) { + t.Helper() + + block := ethgo.BlockNumber(blockNumber) + + contractBalance, err := srv.JSONRPC().Eth().GetBalance(ethgo.Address(staking.AddrStakingContract), block) + require.NoError(t, err) + + amounts := make(map[types.Address]*big.Int, len(knownStakers)) + for _, staker := range knownStakers { + if _, ok := amounts[staker]; ok { + continue + } + + info, infoErr := queryStakerInfoAt(srv, queryFrom, staker, block) + require.NoError(t, infoErr) + + if info.Exists { + amounts[staker] = new(big.Int).Set(info.Amount) + } else { + amounts[staker] = big.NewInt(0) + } + } + + return new(big.Int).Set(contractBalance), amounts +} + +func sendSetActiveReceiptTx(srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey, value bool) (*ethgo.Receipt, error) { + m := abis.StakingABI.Methods["setActive"] + if m == nil { + return nil, errors.New("staking ABI missing setActive") + } + + inp, err := m.Inputs.Encode(map[string]interface{}{"active_": value}) + if err != nil { + return nil, err + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + return srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: big.NewInt(0), + Input: append(m.ID(), inp...), + }, key) +} + +func sendStakeTx(srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey, amount *big.Int) (*ethgo.Receipt, error) { + m := abis.StakingABI.Methods["stake"] + if m == nil { + return nil, errors.New("staking ABI missing stake") + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + return srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: amount, + Input: m.ID(), + }, key) +} + +func sendSetDelegationActiveTx(srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey, validator types.Address, active bool) error { + receipt, err := sendSetDelegationActiveReceiptTx(srv, from, key, validator, active) + if err != nil { + return err + } + if receipt.Status != uint64(types.ReceiptSuccess) { + return errors.New("setDelegationActive transaction failed") + } + + return nil +} + +func sendSetDelegationActiveReceiptTx(srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey, validator types.Address, active bool) (*ethgo.Receipt, error) { + m := abis.StakingABI.Methods["setDelegationActive"] + if m == nil { + return nil, errors.New("staking ABI missing setDelegationActive") + } + + inp, err := m.Inputs.Encode(map[string]interface{}{ + "validator": ethgo.Address(validator), + "active_": active, + }) + if err != nil { + return nil, err + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + return srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: big.NewInt(0), + Input: append(m.ID(), inp...), + }, key) +} + +func sendWithdrawDelegationTx(srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey, validator types.Address, amount *big.Int) error { + receipt, err := sendWithdrawDelegationReceiptTx(srv, from, key, validator, amount) + if err != nil { + return err + } + if receipt.Status != uint64(types.ReceiptSuccess) { + return errors.New("withdrawDelegation transaction failed") + } + + return nil +} + +func sendWithdrawDelegationReceiptTx(srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey, validator types.Address, amount *big.Int) (*ethgo.Receipt, error) { + m := abis.StakingABI.Methods["withdrawDelegation"] + if m == nil { + return nil, errors.New("staking ABI missing withdrawDelegation") + } + + inp, err := m.Inputs.Encode(map[string]interface{}{ + "validator": ethgo.Address(validator), + "amount": amount, + }) + if err != nil { + return nil, err + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + return srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: big.NewInt(0), + Input: append(m.ID(), inp...), + }, key) +} + +func sendUnstakeDelegationTx(srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey, validator types.Address) (*ethgo.Receipt, error) { + m := abis.StakingABI.Methods["unstakeDelegation"] + if m == nil { + return nil, errors.New("staking ABI missing unstakeDelegation") + } + + inp, err := m.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(validator)}) + if err != nil { + return nil, err + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + return srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: big.NewInt(0), + Input: append(m.ID(), inp...), + }, key) +} + +func queryStakerInfo(srv *framework.TestServer, from, staker types.Address) (*stakingStakerInfo, error) { + return queryStakerInfoAt(srv, from, staker, ethgo.Latest) +} + +func queryStakerInfoAt(srv *framework.TestServer, from, staker types.Address, block ethgo.BlockNumber) (*stakingStakerInfo, error) { + m := abis.StakingABI.Methods["stakerInfo"] + if m == nil { + return nil, errors.New("staking ABI missing stakerInfo") + } + + input, err := m.Inputs.Encode(map[string]interface{}{"account": ethgo.Address(staker)}) + if err != nil { + return nil, err + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: append(m.ID(), input...), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, block) + if err != nil { + return nil, err + } + + b, err := hex.DecodeHex(resp) + if err != nil { + return nil, err + } + + decoded, err := m.Outputs.Decode(b) + if err != nil { + return nil, err + } + + root, ok := decoded.(map[string]interface{}) + if !ok { + return nil, errors.New("stakerInfo decode root") + } + + tuple, ok := root["0"].(map[string]interface{}) + if !ok { + return nil, errors.New("stakerInfo decode tuple") + } + + out := &stakingStakerInfo{} + out.Exists, _ = tuple["exists"].(bool) + out.Active, _ = tuple["active"].(bool) + out.Amount, _ = tuple["amount"].(*big.Int) + out.JoinedAtBlock, _ = tuple["joinedAtBlock"].(*big.Int) + out.DeactivatedAtBlock, _ = tuple["deactivatedAtBlock"].(*big.Int) + + if v, ok := tuple["validator"].(ethgo.Address); ok { + out.Validator = types.Address(v) + } + if out.Amount == nil { + out.Amount = big.NewInt(0) + } + if out.JoinedAtBlock == nil { + out.JoinedAtBlock = big.NewInt(0) + } + if out.DeactivatedAtBlock == nil { + out.DeactivatedAtBlock = big.NewInt(0) + } + + return out, nil +} + +func queryValidatorDelegatedStakeRaw(srv *framework.TestServer, from, validator types.Address) (*big.Int, error) { + return queryUintMethodByValidator(srv, from, validator, "validatorDelegatedStakeRaw") +} + +func queryValidatorDelegatedStakeActive(srv *framework.TestServer, from, validator types.Address) (*big.Int, error) { + return queryUintMethodByValidator(srv, from, validator, "validatorDelegatedStakeActive") +} + +func queryValidatorStakerCount(srv *framework.TestServer, from, validator types.Address) (uint64, error) { + m := abis.StakingABI.Methods["validatorStakerCount"] + if m == nil { + return 0, errors.New("staking ABI missing validatorStakerCount") + } + + input, err := m.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(validator)}) + if err != nil { + return 0, err + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: append(m.ID(), input...), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return 0, err + } + + return common.ParseUint64orHex(&resp) +} + +func queryValidatorStakerAt(srv *framework.TestServer, from, validator types.Address, idx uint64) (types.Address, error) { + m := abis.StakingABI.Methods["validatorStakerAt"] + if m == nil { + return types.ZeroAddress, errors.New("staking ABI missing validatorStakerAt") + } + + input, err := m.Inputs.Encode(map[string]interface{}{ + "validator": ethgo.Address(validator), + "idx": new(big.Int).SetUint64(idx), + }) + if err != nil { + return types.ZeroAddress, err + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: append(m.ID(), input...), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return types.ZeroAddress, err + } + + b, err := hex.DecodeHex(resp) + if err != nil { + return types.ZeroAddress, err + } + + decoded, err := m.Outputs.Decode(b) + if err != nil { + return types.ZeroAddress, err + } + + root, ok := decoded.(map[string]interface{}) + if !ok { + return types.ZeroAddress, errors.New("validatorStakerAt decode root") + } + + if val, ok := root["0"].(ethgo.Address); ok { + return types.Address(val), nil + } + + return types.ZeroAddress, errors.New("validatorStakerAt decode value") +} + +func validatorHasStaker(t *testing.T, srv *framework.TestServer, from, validator, expectedStaker types.Address) bool { + t.Helper() + + count, err := queryValidatorStakerCount(srv, from, validator) + require.NoError(t, err) + + for i := uint64(0); i < count; i++ { + staker, sErr := queryValidatorStakerAt(srv, from, validator, i) + require.NoError(t, sErr) + + if staker == expectedStaker { + return true + } + } + + return false +} + +func waitUntilMidEpoch(t *testing.T, srv *framework.TestServer, epochSize uint64) { + t.Helper() + + for { + height, err := srv.JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + + pos := height % epochSize + if epochSize <= 3 { + if pos != 0 { + return + } + } else if pos >= 1 && pos <= epochSize-3 { + return + } + + require.Empty(t, framework.WaitForServersToSeal([]*framework.TestServer{srv}, height+1)) + } +} + +func queryUintMethodByValidator(srv *framework.TestServer, from, validator types.Address, method string) (*big.Int, error) { + m := abis.StakingABI.Methods[method] + if m == nil { + return nil, errors.New("staking ABI missing " + method) + } + + input, err := m.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(validator)}) + if err != nil { + return nil, err + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: append(m.ID(), input...), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return nil, err + } + + return common.ParseUint256orHex(&resp) +} diff --git a/e2e/pos_stakingv2_delegation_pool_edge_e2e_test.go b/e2e/pos_stakingv2_delegation_pool_edge_e2e_test.go new file mode 100644 index 0000000..6beaeff --- /dev/null +++ b/e2e/pos_stakingv2_delegation_pool_edge_e2e_test.go @@ -0,0 +1,1081 @@ +package e2e + +import ( + "context" + "crypto/ecdsa" + "errors" + "math/big" + "testing" + + "github.com/stretchr/testify/require" + "github.com/umbracle/ethgo" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/e2e/framework" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/helper/keccak" + "github.com/xgr-network/xgr-node/types" +) + +func TestPoS_StakingV2_MinDelegatorStake_UpdateExistingDelegators(t *testing.T) { + const epochSize = uint64(5) + + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, epochSize, 1, 4) + + validator := addrs[0] + validatorKey := keys[0] + knownStakers := append([]types.Address(nil), addrs...) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], validator) + require.NoError(t, err) + validatorInfo, err := queryStakerInfo(servers[0], validator, validator) + require.NoError(t, err) + require.True(t, validatorInfo.Exists) + if validatorInfo.Amount.Cmp(minSelfStake) < 0 { + receipt, stakeErr := sendStakeTx(servers[0], validator, validatorKey, new(big.Int).Sub(minSelfStake, validatorInfo.Amount)) + require.NoError(t, stakeErr) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + } + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], validator) + require.NoError(t, err) + + maxDelegatedStake := new(big.Int).Mul(delegatorMinStake, big.NewInt(100)) + require.NoError(t, sendSetValidatorPoolConfigTxWithMinDelegatorStake(servers[0], validator, validatorKey, true, maxDelegatedStake, big.NewInt(0), 0)) + assertStakingConservation(t, servers[0], validator, knownStakers) + + delegatorAKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorA := crypto.PubKeyToAddress(&delegatorAKey.PublicKey) + knownStakers = append(knownStakers, delegatorA) + delegationA := new(big.Int).Mul(delegatorMinStake, big.NewInt(2)) + fundAccount(t, servers[0], validator, validatorKey, delegatorA, new(big.Int).Mul(delegatorMinStake, big.NewInt(12))) + + waitUntilMidEpoch(t, servers[0], epochSize) + receiptA, err := sendDelegateTx(servers[0], delegatorA, delegatorAKey, validator, delegationA) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptA.Status) + waitForNextEpochTransition(t, servers, epochSize) + + delegatorAInfo, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfo.Exists) + require.True(t, delegatorAInfo.Active) + require.Equal(t, 0, delegatorAInfo.Amount.Cmp(delegationA)) + activeAOnly, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeAOnly.Cmp(delegatorAInfo.Amount)) + rawAOnly, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawAOnly.Cmp(delegatorAInfo.Amount)) + assertStakingConservation(t, servers[0], validator, knownStakers) + + customMin := new(big.Int).Mul(delegatorMinStake, big.NewInt(3)) + require.NoError(t, sendSetValidatorPoolConfigTxWithMinDelegatorStake(servers[0], validator, validatorKey, true, maxDelegatedStake, customMin, 0)) + + delegatorAInfoAfterMinRaise, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoAfterMinRaise.Exists) + require.True(t, delegatorAInfoAfterMinRaise.Active) + require.Equal(t, 0, delegatorAInfoAfterMinRaise.Amount.Cmp(delegationA)) + activeAfterMinRaise, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeAfterMinRaise.Cmp(delegationA), "raising minDelegatorStake must not forcibly remove an already-active delegator") + rawAfterMinRaise, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawAfterMinRaise.Cmp(delegationA)) + assertStakingConservation(t, servers[0], validator, knownStakers) + + delegatorBKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorB := crypto.PubKeyToAddress(&delegatorBKey.PublicKey) + knownStakers = append(knownStakers, delegatorB) + fundAccount(t, servers[0], validator, validatorKey, delegatorB, new(big.Int).Mul(delegatorMinStake, big.NewInt(12))) + belowCustomMin := new(big.Int).Set(delegationA) + + activeBeforeRejectedB, rawBeforeRejectedB, amountABeforeRejectedB := minDelegatorStakeSnapshot(t, servers[0], validator, delegatorA) + receiptB, err := sendDelegateTx(servers[0], delegatorB, delegatorBKey, validator, belowCustomMin) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receiptB.Status) + delegatorBInfo, err := queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + require.False(t, delegatorBInfo.Exists) + minDelegatorStakeRequireSnapshotUnchanged(t, servers[0], validator, delegatorA, activeBeforeRejectedB, rawBeforeRejectedB, amountABeforeRejectedB, "below-custom-min new delegation must not mutate staking state") + assertStakingConservation(t, servers[0], validator, knownStakers) + + receiptB, err = sendDelegateTx(servers[0], delegatorB, delegatorBKey, validator, customMin) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptB.Status) + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + require.True(t, delegatorBInfo.Exists) + require.True(t, delegatorBInfo.Active) + require.Equal(t, 0, delegatorBInfo.Amount.Cmp(customMin)) + delegatorAInfo, err = queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + rawAfterB, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawAfterB.Cmp(new(big.Int).Add(delegatorAInfo.Amount, delegatorBInfo.Amount))) + assertStakingConservation(t, servers[0], validator, knownStakers) + + receiptDeactivateA, err := sendSetDelegationActiveReceiptTx(servers[0], delegatorA, delegatorAKey, validator, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptDeactivateA.Status) + waitForNextEpochTransition(t, servers, epochSize) + + delegatorAInfoInactive, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoInactive.Exists) + require.False(t, delegatorAInfoInactive.Active) + require.GreaterOrEqual(t, delegatorAInfoInactive.Amount.Cmp(delegationA), 0) + require.Less(t, delegatorAInfoInactive.Amount.Cmp(customMin), 0) + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + require.True(t, delegatorBInfo.Active) + activeAfterAInactive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeAfterAInactive.Cmp(delegatorBInfo.Amount), "inactive delegatorA must no longer contribute active delegated stake") + rawAfterAInactive, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawAfterAInactive.Cmp(new(big.Int).Add(delegatorAInfoInactive.Amount, delegatorBInfo.Amount)), "raw delegated stake must still include inactive delegatorA") + assertStakingConservation(t, servers[0], validator, knownStakers) + + activeBeforeRejectedReactivation, rawBeforeRejectedReactivation, amountABeforeRejectedReactivation := minDelegatorStakeSnapshot(t, servers[0], validator, delegatorA) + receiptReactivateA, err := sendSetDelegationActiveReceiptTx(servers[0], delegatorA, delegatorAKey, validator, true) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receiptReactivateA.Status) + delegatorAInfoAfterRejectedReactivation, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoAfterRejectedReactivation.Exists) + require.False(t, delegatorAInfoAfterRejectedReactivation.Active) + minDelegatorStakeRequireSnapshotUnchanged(t, servers[0], validator, delegatorA, activeBeforeRejectedReactivation, rawBeforeRejectedReactivation, amountABeforeRejectedReactivation, "below-current-min reactivation must not mutate staking state") + assertStakingConservation(t, servers[0], validator, knownStakers) + + beforeTopUpRaw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + beforeTopUpActive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + beforeTopUpInfo, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + topUp := new(big.Int).Set(delegatorMinStake) + receiptTopUpA, err := sendDelegateTx(servers[0], delegatorA, delegatorAKey, validator, topUp) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptTopUpA.Status) + afterTopUpInfo, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, afterTopUpInfo.Exists) + require.False(t, afterTopUpInfo.Active) + require.GreaterOrEqual(t, afterTopUpInfo.Amount.Cmp(customMin), 0) + afterTopUpRaw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + afterTopUpActive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + require.GreaterOrEqual(t, afterTopUpRaw.Cmp(new(big.Int).Add(beforeTopUpRaw, topUp)), 0) + require.Equal(t, 0, afterTopUpRaw.Cmp(new(big.Int).Add(afterTopUpInfo.Amount, delegatorBInfo.Amount))) + require.GreaterOrEqual(t, afterTopUpActive.Cmp(beforeTopUpActive), 0) + require.Equal(t, 0, afterTopUpActive.Cmp(delegatorBInfo.Amount), "inactive top-up must not add delegatorA to active delegated stake") + require.Equal(t, 0, afterTopUpInfo.Amount.Cmp(new(big.Int).Add(beforeTopUpInfo.Amount, topUp))) + assertStakingConservation(t, servers[0], validator, knownStakers) + + receiptReactivateA, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorA, delegatorAKey, validator, true) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptReactivateA.Status) + delegatorAInfoReactivated, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoReactivated.Active) + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + activeAfterAReactivated, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeAfterAReactivated.Cmp(new(big.Int).Add(delegatorAInfoReactivated.Amount, delegatorBInfo.Amount)), "reactivation at current min must include full delegatorA amount") + assertStakingConservation(t, servers[0], validator, knownStakers) + + require.NoError(t, sendSetValidatorPoolConfigTxWithMinDelegatorStake(servers[0], validator, validatorKey, true, maxDelegatedStake, big.NewInt(0), 0)) + receiptDeactivateA, err = sendSetDelegationActiveReceiptTx(servers[0], delegatorA, delegatorAKey, validator, false) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptDeactivateA.Status) + waitForNextEpochTransition(t, servers, epochSize) + + beforeWithdrawInfo, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, beforeWithdrawInfo.Exists) + require.False(t, beforeWithdrawInfo.Active) + require.GreaterOrEqual(t, new(big.Int).Sub(beforeWithdrawInfo.Amount, big.NewInt(1)).Cmp(delegatorMinStake), 0) + beforeWithdrawRaw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + beforeWithdrawActive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + receiptWithdrawA, err := sendWithdrawDelegationReceiptTx(servers[0], delegatorA, delegatorAKey, validator, big.NewInt(1)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptWithdrawA.Status) + afterWithdrawInfo, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, afterWithdrawInfo.Exists) + require.False(t, afterWithdrawInfo.Active) + require.Equal(t, 0, afterWithdrawInfo.Amount.Cmp(new(big.Int).Sub(beforeWithdrawInfo.Amount, big.NewInt(1)))) + afterWithdrawRaw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + afterWithdrawActive, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, afterWithdrawRaw.Cmp(new(big.Int).Sub(beforeWithdrawRaw, big.NewInt(1)))) + require.Equal(t, 0, afterWithdrawActive.Cmp(beforeWithdrawActive), "inactive withdraw must not change active delegated stake") + + receiptReactivateAfterLower, err := sendSetDelegationActiveReceiptTx(servers[0], delegatorA, delegatorAKey, validator, true) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptReactivateAfterLower.Status) + delegatorAInfoAfterLowerReactivation, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoAfterLowerReactivation.Active) + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + activeAfterLowerReactivation, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeAfterLowerReactivation.Cmp(new(big.Int).Add(delegatorAInfoAfterLowerReactivation.Amount, delegatorBInfo.Amount))) + assertStakingConservation(t, servers[0], validator, knownStakers) +} + +func minDelegatorStakeSnapshot(t *testing.T, srv *framework.TestServer, validator, delegator types.Address) (*big.Int, *big.Int, *big.Int) { + t.Helper() + + active, err := queryValidatorDelegatedStakeActive(srv, validator, validator) + require.NoError(t, err) + raw, err := queryValidatorDelegatedStakeRaw(srv, validator, validator) + require.NoError(t, err) + info, err := queryStakerInfo(srv, validator, delegator) + require.NoError(t, err) + + return active, raw, new(big.Int).Set(info.Amount) +} + +func minDelegatorStakeRequireSnapshotUnchanged( + t *testing.T, + srv *framework.TestServer, + validator types.Address, + delegator types.Address, + activeBefore *big.Int, + rawBefore *big.Int, + amountBefore *big.Int, + msg string, +) { + t.Helper() + + activeAfter, rawAfter, amountAfter := minDelegatorStakeSnapshot(t, srv, validator, delegator) + require.Equal(t, 0, activeAfter.Cmp(activeBefore), msg) + require.Equal(t, 0, rawAfter.Cmp(rawBefore), msg) + require.Equal(t, 0, amountAfter.Cmp(amountBefore), msg) +} + +func TestPoS_StakingV2_DelegationPoolCap_UsesRewardGrownRawStake(t *testing.T) { + const epochSize = uint64(5) + + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, epochSize, 1, 4) + + validator := addrs[0] + validatorKey := keys[0] + knownStakers := append([]types.Address(nil), addrs...) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], validator) + require.NoError(t, err) + effectiveMinDelegatorStake := new(big.Int).Set(delegatorMinStake) + + maxTotalDelegatedStake := new(big.Int).Mul(delegatorMinStake, big.NewInt(3)) + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], validator, validatorKey, true, maxTotalDelegatedStake, 0)) + + delegatorAKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorA := crypto.PubKeyToAddress(&delegatorAKey.PublicKey) + knownStakers = append(knownStakers, delegatorA) + delegatorAPrincipal := new(big.Int).Mul(delegatorMinStake, big.NewInt(2)) + fundAccount(t, servers[0], validator, validatorKey, delegatorA, new(big.Int).Mul(delegatorMinStake, big.NewInt(10))) + + waitUntilMidEpoch(t, servers[0], epochSize) + receiptA, err := sendDelegateTx(servers[0], delegatorA, delegatorAKey, validator, delegatorAPrincipal) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptA.Status) + waitForNextEpochTransition(t, servers, epochSize) + + delegatorAInfoBeforeReward, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoBeforeReward.Exists) + require.True(t, delegatorAInfoBeforeReward.Active) + require.Equal(t, 0, delegatorAInfoBeforeReward.Amount.Cmp(delegatorAPrincipal)) + rawBeforeReward, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawBeforeReward.Cmp(delegatorAPrincipal)) + activeBeforeReward, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeBeforeReward.Cmp(delegatorAPrincipal)) + assertStakingConservation(t, servers[0], validator, knownStakers) + + delegatorAInfoAfterReward, rawAfterReward := waitForDelegationRewardGrowth(t, servers, validator, validatorKey, delegatorA, delegatorAPrincipal, epochSize) + require.GreaterOrEqual(t, rawAfterReward.Cmp(delegatorAInfoAfterReward.Amount), 0) + require.Greater(t, rawAfterReward.Cmp(delegatorAPrincipal), 0) + activeAfterReward, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.GreaterOrEqual(t, activeAfterReward.Cmp(rawAfterReward), 0) + assertStakingConservation(t, servers[0], validator, knownStakers) + + delegatorBKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorB := crypto.PubKeyToAddress(&delegatorBKey.PublicKey) + knownStakers = append(knownStakers, delegatorB) + fundAccount(t, servers[0], validator, validatorKey, delegatorB, new(big.Int).Mul(delegatorMinStake, big.NewInt(10))) + + remainingByPrincipal := new(big.Int).Sub(maxTotalDelegatedStake, delegatorAPrincipal) + attemptAmount := new(big.Int).Set(remainingByPrincipal) + require.GreaterOrEqual(t, attemptAmount.Cmp(effectiveMinDelegatorStake), 0) + require.Greater(t, new(big.Int).Add(new(big.Int).Set(rawAfterReward), attemptAmount).Cmp(maxTotalDelegatedStake), 0) + + waitUntilMidEpoch(t, servers[0], epochSize) + rawBeforeRejectedB, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + activeBeforeRejectedB, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + delegatorAInfoBeforeRejectedB, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + + receiptB, err := sendDelegateTx(servers[0], delegatorB, delegatorBKey, validator, attemptAmount) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receiptB.Status) + + delegatorBInfo, err := queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + require.False(t, delegatorBInfo.Exists) + rawAfterRejectedB, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawAfterRejectedB.Cmp(rawBeforeRejectedB), "failed cap tx must not mutate raw delegated stake") + activeAfterRejectedB, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, activeAfterRejectedB.Cmp(activeBeforeRejectedB), "failed cap tx must not mutate active delegated stake") + delegatorAInfoAfterRejectedB, err := queryStakerInfo(servers[0], validator, delegatorA) + require.NoError(t, err) + require.Equal(t, 0, delegatorAInfoAfterRejectedB.Amount.Cmp(delegatorAInfoBeforeRejectedB.Amount), "failed cap tx must not mutate existing delegator amount") + assertStakingConservation(t, servers[0], validator, knownStakers) + + remainingByRaw := new(big.Int).Sub(maxTotalDelegatedStake, rawAfterRejectedB) + if remainingByRaw.Cmp(effectiveMinDelegatorStake) >= 0 { + receiptB, err = sendDelegateTx(servers[0], delegatorB, delegatorBKey, validator, remainingByRaw) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptB.Status) + rawAtCap, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, rawAtCap.Cmp(maxTotalDelegatedStake)) + } else { + require.GreaterOrEqual(t, remainingByRaw.Sign(), 0) + require.Less(t, remainingByRaw.Cmp(effectiveMinDelegatorStake), 0, "reward-grown raw stake left less than one minimum delegation of pool capacity") + tooSmallToBeValid := new(big.Int).Set(remainingByRaw) + if tooSmallToBeValid.Sign() == 0 { + tooSmallToBeValid = big.NewInt(1) + } + receiptB, err = sendDelegateTx(servers[0], delegatorB, delegatorBKey, validator, tooSmallToBeValid) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receiptB.Status) + delegatorBInfo, err = queryStakerInfo(servers[0], validator, delegatorB) + require.NoError(t, err) + require.False(t, delegatorBInfo.Exists) + } + + assertStakingConservation(t, servers[0], validator, knownStakers) +} + +func waitForDelegationRewardGrowth( + t *testing.T, + servers []*framework.TestServer, + validator types.Address, + validatorKey *ecdsa.PrivateKey, + delegator types.Address, + principal *big.Int, + epochSize uint64, +) (*stakingStakerInfo, *big.Int) { + t.Helper() + + for epochAttempt := 0; epochAttempt < 6; epochAttempt++ { + for txIndex := 0; txIndex < 4; txIndex++ { + sendRewardFeeTransfer(t, servers[0], validator, validatorKey) + } + waitForNextEpochTransition(t, servers, epochSize) + + info, err := queryStakerInfo(servers[0], validator, delegator) + require.NoError(t, err) + require.True(t, info.Exists) + require.True(t, info.Active) + + raw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + if raw.Cmp(principal) > 0 && info.Amount.Cmp(principal) > 0 { + return info, raw + } + } + + info, err := queryStakerInfo(servers[0], validator, delegator) + require.NoError(t, err) + raw, err := queryValidatorDelegatedStakeRaw(servers[0], validator, validator) + require.NoError(t, err) + require.Greater(t, info.Amount.Cmp(principal), 0, "delegator stake amount did not grow from fee rewards") + require.Greater(t, raw.Cmp(principal), 0, "delegated raw stake did not grow from fee rewards") + + return info, raw +} + +func sendRewardFeeTransfer(t *testing.T, srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey) { + t.Helper() + + receiverKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + receiver := crypto.PubKeyToAddress(&receiverKey.PublicKey) + rewardGasPrice := new(big.Int).Mul(framework.TestGasPrice(), big.NewInt(1000)) + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + receipt, err := srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &receiver, + GasPrice: rewardGasPrice, + Gas: framework.DefaultGasLimit, + Value: big.NewInt(1), + }, key) + require.NoError(t, err) + require.NotNil(t, receipt) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) +} + +func TestPoS_StakingV2_DelegationPool_MaxDelegatedStakeCap(t *testing.T) { + const epochSize = uint64(5) + + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, epochSize, 1, 4) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], addrs[0]) + require.NoError(t, err) + receiptStake, err := sendStakeTx(servers[0], addrs[0], keys[0], minSelfStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptStake.Status) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], addrs[0]) + require.NoError(t, err) + + maxDelegatedStake := new(big.Int).Mul(delegatorMinStake, big.NewInt(2)) + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], addrs[0], keys[0], true, maxDelegatedStake, 0)) + + delegatorAKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorA := crypto.PubKeyToAddress(&delegatorAKey.PublicKey) + + delegatorBKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorB := crypto.PubKeyToAddress(&delegatorBKey.PublicKey) + + fundAccount(t, servers[0], addrs[0], keys[0], delegatorA, new(big.Int).Mul(delegatorMinStake, big.NewInt(10))) + fundAccount(t, servers[0], addrs[0], keys[0], delegatorB, new(big.Int).Mul(delegatorMinStake, big.NewInt(10))) + + waitUntilMidEpoch(t, servers[0], epochSize) + receiptA, err := sendDelegateTx(servers[0], delegatorA, delegatorAKey, addrs[0], new(big.Int).Set(maxDelegatedStake)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptA.Status) + + waitForNextEpochTransition(t, servers, epochSize) + + delegatorAInfoBefore, err := queryStakerInfo(servers[0], addrs[0], delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoBefore.Exists) + require.True(t, delegatorAInfoBefore.Active) + // StakerInfo.Amount can include rewards, so only lower-bound principal here. + require.GreaterOrEqual(t, delegatorAInfoBefore.Amount.Cmp(maxDelegatedStake), 0) + + delegatedRawBefore, err := queryValidatorDelegatedStakeRaw(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, 0, delegatedRawBefore.Cmp(maxDelegatedStake)) + delegatedRawSlot8Before, err := queryStakingMappingUintStorage(servers[0], addrs[0], 8) + require.NoError(t, err) + require.Equal(t, 0, delegatedRawSlot8Before.Cmp(maxDelegatedStake)) + + delegatedActiveBefore, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.GreaterOrEqual(t, delegatedActiveBefore.Cmp(maxDelegatedStake), 0) + stakerCountBeforeRejectedTxs, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.False(t, validatorHasStaker(t, servers[0], addrs[0], addrs[0], delegatorB)) + + receiptB, err := sendDelegateTx(servers[0], delegatorB, delegatorBKey, addrs[0], big.NewInt(1)) + assertTxRejected(t, receiptB, err) + + delegatorBInfo, err := queryStakerInfo(servers[0], addrs[0], delegatorB) + require.NoError(t, err) + require.False(t, delegatorBInfo.Exists) + + delegatorAInfoAfterB, err := queryStakerInfo(servers[0], addrs[0], delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoAfterB.Exists) + require.True(t, delegatorAInfoAfterB.Active) + require.GreaterOrEqual(t, delegatorAInfoAfterB.Amount.Cmp(maxDelegatedStake), 0) + + delegatedRawAfterB, err := queryValidatorDelegatedStakeRaw(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, 0, delegatedRawAfterB.Cmp(maxDelegatedStake)) + delegatedRawSlot8AfterB, err := queryStakingMappingUintStorage(servers[0], addrs[0], 8) + require.NoError(t, err) + require.Equal(t, 0, delegatedRawSlot8AfterB.Cmp(maxDelegatedStake)) + + delegatedActiveAfterB, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.GreaterOrEqual(t, delegatedActiveAfterB.Cmp(maxDelegatedStake), 0) + stakerCountAfterBRejected, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, stakerCountBeforeRejectedTxs, stakerCountAfterBRejected) + require.False(t, validatorHasStaker(t, servers[0], addrs[0], addrs[0], delegatorB)) + + stakerCountBeforeTopUpRejected, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + delegatedRawBeforeTopUp, err := queryValidatorDelegatedStakeRaw(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + delegatedRawSlot8BeforeTopUp, err := queryStakingMappingUintStorage(servers[0], addrs[0], 8) + require.NoError(t, err) + + receiptATopUp, err := sendDelegateTx(servers[0], delegatorA, delegatorAKey, addrs[0], big.NewInt(1)) + assertTxRejected(t, receiptATopUp, err) + + delegatorAInfoAfterTopUp, err := queryStakerInfo(servers[0], addrs[0], delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoAfterTopUp.Exists) + require.True(t, delegatorAInfoAfterTopUp.Active) + // StakerInfo.Amount can increase from rewards between snapshots; cap is enforced by delegated raw. + require.GreaterOrEqual(t, delegatorAInfoAfterTopUp.Amount.Cmp(maxDelegatedStake), 0) + + delegatorBInfoAfterTopUp, err := queryStakerInfo(servers[0], addrs[0], delegatorB) + require.NoError(t, err) + require.False(t, delegatorBInfoAfterTopUp.Exists) + + delegatedRawAfterTopUp, err := queryValidatorDelegatedStakeRaw(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + // In current PoS accounting, delegated raw can grow between reads due reward accrual. + require.GreaterOrEqual(t, delegatedRawAfterTopUp.Cmp(maxDelegatedStake), 0) + require.GreaterOrEqual(t, delegatedRawAfterTopUp.Cmp(delegatedRawBeforeTopUp), 0) + delegatedRawSlot8AfterTopUp, err := queryStakingMappingUintStorage(servers[0], addrs[0], 8) + require.NoError(t, err) + require.Equal(t, 0, delegatedRawSlot8AfterTopUp.Cmp(delegatedRawAfterTopUp)) + require.GreaterOrEqual(t, delegatedRawSlot8AfterTopUp.Cmp(delegatedRawSlot8BeforeTopUp), 0) + + delegatedActiveAfterTopUp, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.GreaterOrEqual(t, delegatedActiveAfterTopUp.Cmp(maxDelegatedStake), 0) + stakerCountAfterTopUpRejected, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, stakerCountBeforeTopUpRejected, stakerCountAfterTopUpRejected) + require.Equal(t, stakerCountBeforeRejectedTxs, stakerCountAfterTopUpRejected) + require.False(t, validatorHasStaker(t, servers[0], addrs[0], addrs[0], delegatorB)) +} + +func TestPoS_StakingV2_MultipleDelegators_IndependentLifecycle(t *testing.T) { + const epochSize = uint64(5) + + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, epochSize, 1, 4) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], addrs[0]) + require.NoError(t, err) + receiptStake, err := sendStakeTx(servers[0], addrs[0], keys[0], minSelfStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptStake.Status) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], addrs[0]) + require.NoError(t, err) + + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], addrs[0], keys[0], true, new(big.Int).Mul(delegatorMinStake, big.NewInt(1000)), 0)) + + countBefore, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + + delegatorAKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorA := crypto.PubKeyToAddress(&delegatorAKey.PublicKey) + delegatorBKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegatorB := crypto.PubKeyToAddress(&delegatorBKey.PublicKey) + + delegationA := new(big.Int).Set(delegatorMinStake) + delegationB := new(big.Int).Set(delegatorMinStake) + + fundAccount(t, servers[0], addrs[0], keys[0], delegatorA, new(big.Int).Mul(delegatorMinStake, big.NewInt(12))) + fundAccount(t, servers[0], addrs[0], keys[0], delegatorB, new(big.Int).Mul(delegatorMinStake, big.NewInt(12))) + + waitUntilMidEpoch(t, servers[0], epochSize) + receiptA, err := sendDelegateTx(servers[0], delegatorA, delegatorAKey, addrs[0], delegationA) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptA.Status) + waitForNextEpochTransition(t, servers, epochSize) + + waitUntilMidEpoch(t, servers[0], epochSize) + receiptB, err := sendDelegateTx(servers[0], delegatorB, delegatorBKey, addrs[0], delegationB) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptB.Status) + + delegatorAInfo, err := queryStakerInfo(servers[0], addrs[0], delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfo.Exists) + require.True(t, delegatorAInfo.Active) + + delegatorBInfo, err := queryStakerInfo(servers[0], addrs[0], delegatorB) + require.NoError(t, err) + require.True(t, delegatorBInfo.Exists) + require.True(t, delegatorBInfo.Active) + + waitForDelegatedActiveStake(t, servers, addrs[0], new(big.Int).Add(delegationA, delegationB), epochSize) + + countAfterBothJoined, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, countBefore+2, countAfterBothJoined) + require.True(t, validatorHasStaker(t, servers[0], addrs[0], addrs[0], delegatorA)) + require.True(t, validatorHasStaker(t, servers[0], addrs[0], addrs[0], delegatorB)) + + require.NoError(t, sendSetDelegationActiveTx(servers[0], delegatorA, delegatorAKey, addrs[0], false)) + + delegatorAInfoAfterDeactivate, err := queryStakerInfo(servers[0], addrs[0], delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoAfterDeactivate.Exists) + require.False(t, delegatorAInfoAfterDeactivate.Active) + + delegatorBInfoBeforeBoundary, err := queryStakerInfo(servers[0], addrs[0], delegatorB) + require.NoError(t, err) + require.True(t, delegatorBInfoBeforeBoundary.Exists) + require.True(t, delegatorBInfoBeforeBoundary.Active) + + activeBeforeBoundary, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.GreaterOrEqual(t, activeBeforeBoundary.Cmp(delegationB), 0) + + delegatorAInfoAfterBoundary, err := queryStakerInfo(servers[0], addrs[0], delegatorA) + require.NoError(t, err) + require.True(t, delegatorAInfoAfterBoundary.Exists) + require.False(t, delegatorAInfoAfterBoundary.Active) + + delegatorBInfoAfterBoundary, err := queryStakerInfo(servers[0], addrs[0], delegatorB) + require.NoError(t, err) + require.True(t, delegatorBInfoAfterBoundary.Exists) + require.True(t, delegatorBInfoAfterBoundary.Active) + + waitForDelegatedActiveStake(t, servers, addrs[0], delegationB, epochSize) + + receiptUnstakeA := waitForUnstakeDelegationSuccess(t, servers, delegatorA, delegatorAKey, addrs[0], epochSize) + require.Equal(t, uint64(types.ReceiptSuccess), receiptUnstakeA.Status) + + delegatorAInfoAfterUnstake, err := queryStakerInfo(servers[0], addrs[0], delegatorA) + require.NoError(t, err) + require.False(t, delegatorAInfoAfterUnstake.Exists) + + delegatorBInfoAfterAUnstake, err := queryStakerInfo(servers[0], addrs[0], delegatorB) + require.NoError(t, err) + require.True(t, delegatorBInfoAfterAUnstake.Exists) + require.True(t, delegatorBInfoAfterAUnstake.Active) + // B keeps its delegation principal, but amount can increase due to rewards between txs. + require.GreaterOrEqual(t, delegatorBInfoAfterAUnstake.Amount.Cmp(delegationB), 0) + + countAfterAUnstake, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, countAfterBothJoined-1, countAfterAUnstake) + require.False(t, validatorHasStaker(t, servers[0], addrs[0], addrs[0], delegatorA)) + require.True(t, validatorHasStaker(t, servers[0], addrs[0], addrs[0], delegatorB)) + + activeAfterAUnstake, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + // Active delegated stake can be higher than principal because rewards accrue on active stake. + require.GreaterOrEqual(t, activeAfterAUnstake.Cmp(delegationB), 0) + + require.NoError(t, sendSetDelegationActiveTx(servers[0], delegatorB, delegatorBKey, addrs[0], false)) + waitForNextEpochTransition(t, servers, epochSize) + + receiptUnstakeB := waitForUnstakeDelegationSuccess(t, servers, delegatorB, delegatorBKey, addrs[0], epochSize) + require.Equal(t, uint64(types.ReceiptSuccess), receiptUnstakeB.Status) + + delegatorBInfoAfterUnstake, err := queryStakerInfo(servers[0], addrs[0], delegatorB) + require.NoError(t, err) + require.False(t, delegatorBInfoAfterUnstake.Exists) + + countAfterBUnstake, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, countAfterAUnstake-1, countAfterBUnstake) + require.False(t, validatorHasStaker(t, servers[0], addrs[0], addrs[0], delegatorB)) + + activeAfterBUnstake, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, 0, activeAfterBUnstake.Cmp(big.NewInt(0))) +} + +func TestPoS_StakingV2_DelegationPool_MinDelegatorStake_DefaultAndCustom(t *testing.T) { + const epochSize = uint64(5) + + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, epochSize, 1, 4) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], addrs[0]) + require.NoError(t, err) + receiptStake, err := sendStakeTx(servers[0], addrs[0], keys[0], minSelfStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptStake.Status) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], addrs[0]) + require.NoError(t, err) + maxDelegatedStake := new(big.Int).Mul(delegatorMinStake, big.NewInt(1000)) + + // minDelegatorStake=0 -> DELEGATOR_MIN_STAKE fallback + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], addrs[0], keys[0], true, maxDelegatedStake, 0)) + + k1, _ := crypto.GenerateECDSAKey() + d1 := crypto.PubKeyToAddress(&k1.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], d1, new(big.Int).Mul(delegatorMinStake, big.NewInt(3))) + r, err := sendDelegateTx(servers[0], d1, k1, addrs[0], new(big.Int).Sub(delegatorMinStake, big.NewInt(1))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), r.Status) + r, err = sendDelegateTx(servers[0], d1, k1, addrs[0], new(big.Int).Set(delegatorMinStake)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), r.Status) + + // custom minDelegatorStake > default: below fails, equal succeeds + customMin := new(big.Int).Mul(delegatorMinStake, big.NewInt(3)) + require.NoError(t, sendSetValidatorPoolConfigTxWithMinDelegatorStake(servers[0], addrs[0], keys[0], true, maxDelegatedStake, customMin, 0)) + + k2, _ := crypto.GenerateECDSAKey() + d2 := crypto.PubKeyToAddress(&k2.PublicKey) + fundAccount(t, servers[0], addrs[0], keys[0], d2, new(big.Int).Mul(customMin, big.NewInt(2))) + r, err = sendDelegateTx(servers[0], d2, k2, addrs[0], new(big.Int).Sub(customMin, big.NewInt(1))) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), r.Status) + r, err = sendDelegateTx(servers[0], d2, k2, addrs[0], new(big.Int).Set(customMin)) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), r.Status) + + // invalid custom min below default must revert/fail + tooLow := new(big.Int).Sub(delegatorMinStake, big.NewInt(1)) + err = sendSetValidatorPoolConfigTxWithMinDelegatorStake(servers[0], addrs[0], keys[0], true, maxDelegatedStake, tooLow, 0) + require.Error(t, err) +} + +func sendSetValidatorPoolConfigTxWithMinDelegatorStake( + srv *framework.TestServer, + from types.Address, + key *ecdsa.PrivateKey, + delegationEnabled bool, + maxTotalDelegatedStake *big.Int, + minDelegatorStake *big.Int, + commissionBps uint16, +) error { + m := abis.StakingABI.Methods["setValidatorPoolConfig"] + if m == nil { + return errors.New("staking ABI missing setValidatorPoolConfig") + } + + inp, err := m.Inputs.Encode(map[string]interface{}{ + "delegationEnabled": delegationEnabled, + "maxTotalDelegatedStake": maxTotalDelegatedStake, + "minDelegatorStake": minDelegatorStake, + "commissionBps": commissionBps, + }) + if err != nil { + return err + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + receipt, err := srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: big.NewInt(0), + Input: append(m.ID(), inp...), + }, key) + if err != nil { + return err + } + if receipt == nil { + return errors.New("setValidatorPoolConfig transaction receipt is nil") + } + if receipt.Status != uint64(types.ReceiptSuccess) { + return errors.New("setValidatorPoolConfig transaction failed") + } + + return nil +} + +func TestPoS_StakingV2_StorageLayout_DelegationOracle(t *testing.T) { + const epochSize = uint64(5) + + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, epochSize, 1, 4) + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], addrs[0]) + require.NoError(t, err) + receiptStake, err := sendStakeTx(servers[0], addrs[0], keys[0], minSelfStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptStake.Status) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], addrs[0]) + require.NoError(t, err) + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], addrs[0], keys[0], true, new(big.Int).Mul(delegatorMinStake, big.NewInt(1000)), 0)) + + delegatorKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegator := crypto.PubKeyToAddress(&delegatorKey.PublicKey) + delegation := new(big.Int).Set(delegatorMinStake) + + fundAccount(t, servers[0], addrs[0], keys[0], delegator, new(big.Int).Mul(delegatorMinStake, big.NewInt(10))) + receiptDelegate, err := sendDelegateTx(servers[0], delegator, delegatorKey, addrs[0], delegation) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptDelegate.Status) + + waitForNextEpochTransition(t, servers, epochSize) + + abiActive, err := queryValidatorDelegatedStakeActive(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.GreaterOrEqual(t, abiActive.Cmp(delegation), 0) + abiRaw, err := queryValidatorDelegatedStakeRaw(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.Equal(t, 0, abiRaw.Cmp(delegation)) + + abiCount, err := queryValidatorStakerCount(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.GreaterOrEqual(t, abiCount, uint64(2)) + require.True(t, validatorHasStaker(t, servers[0], addrs[0], addrs[0], delegator)) + + rawActiveSlot6, err := queryStakingMappingUintStorage(servers[0], addrs[0], 6) + require.NoError(t, err) + rawActiveSlot9, err := queryStakingMappingUintStorage(servers[0], addrs[0], 9) + require.NoError(t, err) + require.NotEqual(t, 0, rawActiveSlot6.Cmp(abiActive), "slot 6 must not match active delegated stake mapping") + require.Equal(t, 0, rawActiveSlot9.Cmp(abiActive), "slot 9 must match active delegated stake mapping") + rawDelegatedSlot8, err := queryStakingMappingUintStorage(servers[0], addrs[0], 8) + require.NoError(t, err) + require.Equal(t, 0, rawDelegatedSlot8.Cmp(abiRaw), "slot 8 must match raw delegated stake mapping") + + rawStakersByValidatorLenAt6, err := queryStakingMappingUintStorage(servers[0], addrs[0], 6) + require.NoError(t, err) + rawStakersByValidatorLenAt8, err := queryStakingMappingUintStorage(servers[0], addrs[0], 8) + require.NoError(t, err) + require.Equal(t, new(big.Int).SetUint64(abiCount).Uint64(), rawStakersByValidatorLenAt6.Uint64()) + require.NotEqual(t, 0, rawStakersByValidatorLenAt6.Cmp(rawStakersByValidatorLenAt8)) + + for i := uint64(0); i < abiCount; i++ { + abiStaker, abiErr := queryValidatorStakerAt(servers[0], addrs[0], addrs[0], i) + require.NoError(t, abiErr) + + rawStakerAt6, rawErr := queryStakingValidatorStakerAtRawStorage(servers[0], addrs[0], 6, i) + require.NoError(t, rawErr) + rawStakerAt8, raw8Err := queryStakingValidatorStakerAtRawStorage(servers[0], addrs[0], 8, i) + require.NoError(t, raw8Err) + + require.Equal(t, abiStaker, rawStakerAt6) + require.NotEqual(t, abiStaker, rawStakerAt8) + + rawIndexPlusOneAt7, rawIndexErr := queryStakingNestedMappingUintStorage(servers[0], addrs[0], abiStaker, 7) + require.NoError(t, rawIndexErr) + require.Equal(t, 0, rawIndexPlusOneAt7.Cmp(new(big.Int).SetUint64(i+1))) + + rawIndexPlusOneAt8, rawIndexAt8Err := queryStakingNestedMappingUintStorage(servers[0], addrs[0], abiStaker, 8) + require.NoError(t, rawIndexAt8Err) + require.NotEqual(t, 0, rawIndexPlusOneAt8.Cmp(new(big.Int).SetUint64(i+1))) + } +} + +func TestPoS_StakingV2_StorageLayout_ValidatorPoolConfigOracle(t *testing.T) { + const epochSize = uint64(5) + + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, epochSize, 1, 4) + validator := addrs[0] + + minSelfStake, err := queryValidatorMinSelfStake(servers[0], validator) + require.NoError(t, err) + receiptStake, err := sendStakeTx(servers[0], validator, keys[0], minSelfStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receiptStake.Status) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], validator) + require.NoError(t, err) + + maxTotalDelegatedStake := new(big.Int).Mul(delegatorMinStake, big.NewInt(123)) + minDelegatorStake := new(big.Int).Mul(delegatorMinStake, big.NewInt(7)) + commissionBps := uint16(1234) + require.NotEqual(t, minDelegatorStake.Uint64(), uint64(commissionBps), "oracle values must distinguish minDelegatorStake from commissionBps") + + require.NoError(t, sendSetValidatorPoolConfigTxWithMinDelegatorStake( + servers[0], + validator, + keys[0], + true, + maxTotalDelegatedStake, + minDelegatorStake, + commissionBps, + )) + + pool, err := queryValidatorPoolConfig(servers[0], validator, validator) + require.NoError(t, err) + require.True(t, pool.delegationEnabled) + require.Equal(t, 0, pool.maxDelegatedStake.Cmp(maxTotalDelegatedStake)) + require.Equal(t, 0, pool.minDelegatorStake.Cmp(minDelegatorStake)) + require.Equal(t, commissionBps, pool.commissionBps) + + packedFlags, err := queryStakingMappingUintStorageWithOffset(servers[0], validator, 5, 0) + require.NoError(t, err) + require.Equal(t, uint64(1), new(big.Int).And(new(big.Int).Set(packedFlags), big.NewInt(0xff)).Uint64(), "pool exists flag must be packed at base+0") + require.Equal(t, uint64(1), new(big.Int).And(new(big.Int).Rsh(new(big.Int).Set(packedFlags), 8), big.NewInt(0xff)).Uint64(), "pool active flag must be packed at base+0") + require.Equal(t, uint64(1), new(big.Int).And(new(big.Int).Rsh(new(big.Int).Set(packedFlags), 16), big.NewInt(0xff)).Uint64(), "pool delegationEnabled flag must be packed at base+0") + + rawMaxTotalDelegatedStake, err := queryStakingMappingUintStorageWithOffset(servers[0], validator, 5, 1) + require.NoError(t, err) + require.Equal(t, 0, rawMaxTotalDelegatedStake.Cmp(maxTotalDelegatedStake), "_poolConfig base+1 must be maxTotalDelegatedStake") + rawMinDelegatorStake, err := queryStakingMappingUintStorageWithOffset(servers[0], validator, 5, 2) + require.NoError(t, err) + require.Equal(t, 0, rawMinDelegatorStake.Cmp(minDelegatorStake), "_poolConfig base+2 must be minDelegatorStake") + rawCommissionBps, err := queryStakingMappingUintStorageWithOffset(servers[0], validator, 5, 3) + require.NoError(t, err) + require.Equal(t, uint64(commissionBps), rawCommissionBps.Uint64(), "_poolConfig base+3 must be commissionBps") + require.NotEqual(t, rawMinDelegatorStake.Uint64(), rawCommissionBps.Uint64(), "raw oracle must distinguish minDelegatorStake from commissionBps") +} + +func queryStakingMappingUintStorage(srv *framework.TestServer, validator types.Address, slot int64) (*big.Int, error) { + base := keccak.Keccak256(nil, + append( + common.PadLeftOrTrim(validator.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32)..., + ), + ) + raw, err := srv.JSONRPC().Eth().GetStorageAt(ethgo.Address(staking.AddrStakingContract), ethgo.Hash(types.BytesToHash(base)), ethgo.Latest) + if err != nil { + return nil, err + } + + return new(big.Int).SetBytes(raw[:]), nil +} + +func queryStakingMappingUintStorageWithOffset(srv *framework.TestServer, validator types.Address, slot int64, offset int64) (*big.Int, error) { + base := keccak.Keccak256(nil, + append( + common.PadLeftOrTrim(validator.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32)..., + ), + ) + location := new(big.Int).Add(new(big.Int).SetBytes(base), big.NewInt(offset)) + raw, err := srv.JSONRPC().Eth().GetStorageAt(ethgo.Address(staking.AddrStakingContract), ethgo.Hash(types.BytesToHash(location.Bytes())), ethgo.Latest) + if err != nil { + return nil, err + } + + return new(big.Int).SetBytes(raw[:]), nil +} + +func queryStakingValidatorStakerAtRawStorage(srv *framework.TestServer, validator types.Address, slot int64, idx uint64) (types.Address, error) { + base := keccak.Keccak256(nil, + append( + common.PadLeftOrTrim(validator.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32)..., + ), + ) + arrayBase := keccak.Keccak256(nil, common.PadLeftOrTrim(base, 32)) + location := new(big.Int).Add(new(big.Int).SetBytes(arrayBase), new(big.Int).SetUint64(idx)) + + raw, err := srv.JSONRPC().Eth().GetStorageAt( + ethgo.Address(staking.AddrStakingContract), + ethgo.Hash(types.BytesToHash(location.Bytes())), + ethgo.Latest, + ) + if err != nil { + return types.ZeroAddress, err + } + + return types.BytesToAddress(raw[12:]), nil +} + +func queryStakingNestedMappingUintStorage( + srv *framework.TestServer, + outerKey types.Address, + innerKey types.Address, + slot int64, +) (*big.Int, error) { + outerLocation := keccak.Keccak256(nil, + append( + common.PadLeftOrTrim(outerKey.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32)..., + ), + ) + valueLocation := keccak.Keccak256(nil, + append( + common.PadLeftOrTrim(innerKey.Bytes(), 32), + common.PadLeftOrTrim(outerLocation, 32)..., + ), + ) + raw, err := srv.JSONRPC().Eth().GetStorageAt( + ethgo.Address(staking.AddrStakingContract), + ethgo.Hash(types.BytesToHash(valueLocation)), + ethgo.Latest, + ) + if err != nil { + return nil, err + } + + return new(big.Int).SetBytes(raw[:]), nil +} + +func assertTxRejected(t *testing.T, receipt *ethgo.Receipt, err error) { + t.Helper() + + if err != nil { + return + } + require.NotNil(t, receipt) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status) +} + +func waitForDelegatedActiveStake( + t *testing.T, + servers []*framework.TestServer, + validator types.Address, + expected *big.Int, + epochSize uint64, +) { + t.Helper() + + maxBlocks := epochSize*3 + 2 + for i := uint64(0); i < maxBlocks; i++ { + active, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + if active.Cmp(expected) == 0 { + return + } + + height, hErr := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, hErr) + require.Empty(t, framework.WaitForServersToSeal(servers, height+1)) + } + + active, err := queryValidatorDelegatedStakeActive(servers[0], validator, validator) + require.NoError(t, err) + require.Equal(t, 0, active.Cmp(expected)) +} + +func waitForUnstakeDelegationSuccess( + t *testing.T, + servers []*framework.TestServer, + from types.Address, + key *ecdsa.PrivateKey, + validator types.Address, + epochSize uint64, +) *ethgo.Receipt { + t.Helper() + + maxBlocks := epochSize*3 + 2 + for i := uint64(0); i < maxBlocks; i++ { + receipt, err := sendUnstakeDelegationTx(servers[0], from, key, validator) + if err == nil && receipt != nil && receipt.Status == uint64(types.ReceiptSuccess) { + return receipt + } + + height, hErr := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, hErr) + require.Empty(t, framework.WaitForServersToSeal(servers, height+1)) + } + + receipt, err := sendUnstakeDelegationTx(servers[0], from, key, validator) + require.NoError(t, err) + require.NotNil(t, receipt) + + return receipt +} diff --git a/e2e/pos_stakingv2_delegation_pool_test.go b/e2e/pos_stakingv2_delegation_pool_test.go new file mode 100644 index 0000000..c4ceec5 --- /dev/null +++ b/e2e/pos_stakingv2_delegation_pool_test.go @@ -0,0 +1,201 @@ +package e2e + +import ( + "context" + "crypto/ecdsa" + "errors" + "math/big" + "testing" + + "github.com/stretchr/testify/require" + "github.com/umbracle/ethgo" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/e2e/framework" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/types" +) + +type validatorPoolConfigE2E struct { + delegationEnabled bool + maxDelegatedStake *big.Int + minDelegatorStake *big.Int + commissionBps uint16 +} + +func TestPoS_StakingV2_DelegationPoolDefaultsAndOpenFlow(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterNoAutoStake(t, 2, 5, 1, 2) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], minStake, servers[0])) + + pool, err := queryValidatorPoolConfig(servers[0], addrs[0], addrs[0]) + require.NoError(t, err) + require.False(t, pool.delegationEnabled) + require.Zero(t, pool.maxDelegatedStake.Sign()) + require.Equal(t, uint16(0), pool.commissionBps) + + delegatorKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + delegator := crypto.PubKeyToAddress(&delegatorKey.PublicKey) + + delegatorMinStake, err := queryDelegatorMinStake(servers[0], addrs[0]) + require.NoError(t, err) + fundAccount(t, servers[0], addrs[0], keys[0], delegator, new(big.Int).Mul(delegatorMinStake, big.NewInt(3))) + + receipt, err := sendDelegateTx(servers[0], delegator, delegatorKey, addrs[0], delegatorMinStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptFailed), receipt.Status) + + require.NoError(t, sendSetValidatorPoolConfigTx(servers[0], addrs[0], keys[0], true, new(big.Int).Mul(delegatorMinStake, big.NewInt(10)), 150)) + + receipt, err = sendDelegateTx(servers[0], delegator, delegatorKey, addrs[0], delegatorMinStake) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) +} + +func queryDelegatorMinStake(srv *framework.TestServer, from types.Address) (*big.Int, error) { + m := abis.StakingABI.Methods["DELEGATOR_MIN_STAKE"] + if m == nil { + return nil, errors.New("staking ABI missing DELEGATOR_MIN_STAKE") + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: m.ID(), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return nil, err + } + + return common.ParseUint256orHex(&resp) +} + +func queryValidatorPoolConfig(srv *framework.TestServer, from, validator types.Address) (*validatorPoolConfigE2E, error) { + m := abis.StakingABI.Methods["validatorPool"] + if m == nil { + return nil, errors.New("staking ABI missing validatorPool") + } + + input, err := m.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(validator)}) + if err != nil { + return nil, err + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: append(m.ID(), input...), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return nil, err + } + + bytesResp, err := common.ParseBytes(&resp) + if err != nil { + return nil, err + } + + decoded, err := m.Outputs.Decode(bytesResp) + if err != nil { + return nil, err + } + out := decoded.(map[string]interface{})["0"].(map[string]interface{}) + + cfg := &validatorPoolConfigE2E{} + cfg.delegationEnabled, _ = out["delegationEnabled"].(bool) + cfg.maxDelegatedStake, _ = out["maxTotalDelegatedStake"].(*big.Int) + cfg.minDelegatorStake, _ = out["minDelegatorStake"].(*big.Int) + cfg.commissionBps, _ = out["commissionBps"].(uint16) + if cfg.maxDelegatedStake == nil { + cfg.maxDelegatedStake = big.NewInt(0) + } + if cfg.minDelegatorStake == nil { + cfg.minDelegatorStake = big.NewInt(0) + } + + return cfg, nil +} + +func sendSetValidatorPoolConfigTx( + srv *framework.TestServer, + from types.Address, + key *ecdsa.PrivateKey, + enabled bool, + maxStake *big.Int, + commissionBps uint16, +) error { + m := abis.StakingABI.Methods["setValidatorPoolConfig"] + if m == nil { + return errors.New("staking ABI missing setValidatorPoolConfig") + } + + inp, err := m.Inputs.Encode(map[string]interface{}{ + "delegationEnabled": enabled, + "maxTotalDelegatedStake": maxStake, + "minDelegatorStake": big.NewInt(0), + "commissionBps": commissionBps, + }) + if err != nil { + return err + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + receipt, err := srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: big.NewInt(0), + Input: append(m.ID(), inp...), + }, key) + if err != nil { + return err + } + if receipt.Status != uint64(types.ReceiptSuccess) { + return errors.New("setValidatorPoolConfig transaction failed") + } + + return nil +} + +func sendDelegateTx( + srv *framework.TestServer, + from types.Address, + key *ecdsa.PrivateKey, + validator types.Address, + amount *big.Int, +) (*ethgo.Receipt, error) { + m := abis.StakingABI.Methods["delegate"] + if m == nil { + return nil, errors.New("staking ABI missing delegate") + } + + inp, err := m.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(validator)}) + if err != nil { + return nil, err + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + return srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: amount, + Input: append(m.ID(), inp...), + }, key) +} diff --git a/e2e/pos_stakingv2_filter_test.go b/e2e/pos_stakingv2_filter_test.go new file mode 100644 index 0000000..a32082d --- /dev/null +++ b/e2e/pos_stakingv2_filter_test.go @@ -0,0 +1,925 @@ +package e2e + +import ( + "context" + "crypto/ecdsa" + "math/big" + "testing" + "time" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + "github.com/umbracle/ethgo" + "github.com/xgr-network/xgr-node/chain" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" + ibftOp "github.com/xgr-network/xgr-node/consensus/ibft/proto" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/e2e/framework" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/helper/hex" + "github.com/xgr-network/xgr-node/types" +) + +// TestPoS_StakingV2_FilteringAndFallback validates validator-set fetch tier rules: +// - Tier 1 (strict eligible) = active validators with stake >= threshold +// - if Tier 1 count drops below minNumValidators, fetcher falls back to Tier 2 (active validators) +func TestPoS_StakingV2_FilteringAndFallback(t *testing.T) { + t.Skip("flaky in CI: initial Tier 1 validator set can be 3 depending on startup timing") + numGenesisValidators := IBFTMinNodes + require.Equal(t, 4, numGenesisValidators) + + defaultBalance := framework.EthToWei(7_000_000) + stakeAmount := framework.EthToWei(3_000_000) + + ibftManager := framework.NewIBFTServersManager( + t, + numGenesisValidators, + IBFTDirPrefix, + func(_ int, config *framework.TestServerConfig) { + config.SetEpochSize(5) + config.PremineValidatorBalance(defaultBalance) + config.SetIBFTPoS(true) + config.SetMinValidatorCount(3) + config.SetMaxValidatorCount(uint64(numGenesisValidators)) + }, + ) + t.Cleanup(func() { ibftManager.StopServers() }) + + ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute) + defer cancel() + ibftManager.StartServers(ctx) + + servers := make([]*framework.TestServer, 0, numGenesisValidators) + keys := make([]*ecdsa.PrivateKey, 0, numGenesisValidators) + addrs := make([]types.Address, 0, numGenesisValidators) + + for i := 0; i < numGenesisValidators; i++ { + srv := ibftManager.GetServer(i) + key, err := srv.Config.PrivateKey() + require.NoError(t, err) + + servers = append(servers, srv) + keys = append(keys, key) + addrs = append(addrs, crypto.PubKeyToAddress(&key.PublicKey)) + } + + // Bring all validators to threshold. + for i := 0; i < numGenesisValidators; i++ { + err := framework.StakeAmount(addrs[i], keys[i], stakeAmount, servers[i]) + require.NoError(t, err) + } + + require.Empty(t, framework.WaitForServersToSeal(servers, 12)) + + snap1 := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Len(t, snap1, numGenesisValidators) + for _, a := range addrs { + assert.Contains(t, snap1, a) + } + + // Deactivate one validator: Tier 1 remains >= min (3), so no fallback. + require.NoError(t, sendSetActiveTx(servers[3], addrs[3], keys[3], false)) + require.Empty(t, framework.WaitForServersToSeal(servers, 18)) + + snap2 := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Len(t, snap2, 3) + assert.NotContains(t, snap2, addrs[3]) + + // Deactivate another validator: Tier 1 becomes 2 < min(3), so fallback to Tier 2 (active validators). + require.NoError(t, sendSetActiveTx(servers[2], addrs[2], keys[2], false)) + require.Empty(t, framework.WaitForServersToSeal(servers, 24)) + + snap3 := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Len(t, snap3, numGenesisValidators) + for _, a := range addrs { + assert.Contains(t, snap3, a) + } +} + +func TestPoS_StakingV2_Tier2UsedWhenTier1BelowMinValidators(t *testing.T) { + numGenesisValidators := IBFTMinNodes + require.Equal(t, 4, numGenesisValidators) + + defaultBalance := framework.EthToWei(7_000_000) + stakeAmount := framework.EthToWei(3_000_000) + + ibftManager := framework.NewIBFTServersManager( + t, + numGenesisValidators, + IBFTDirPrefix, + func(_ int, config *framework.TestServerConfig) { + config.SetEpochSize(5) + config.PremineValidatorBalance(defaultBalance) + config.SetIBFTPoS(true) + config.SetMinValidatorCount(3) + config.SetMaxValidatorCount(uint64(numGenesisValidators)) + }, + ) + t.Cleanup(func() { ibftManager.StopServers() }) + + ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute) + defer cancel() + ibftManager.StartServers(ctx) + + servers := make([]*framework.TestServer, 0, numGenesisValidators) + keys := make([]*ecdsa.PrivateKey, 0, numGenesisValidators) + addrs := make([]types.Address, 0, numGenesisValidators) + + for i := 0; i < numGenesisValidators; i++ { + srv := ibftManager.GetServer(i) + key, err := srv.Config.PrivateKey() + require.NoError(t, err) + + servers = append(servers, srv) + keys = append(keys, key) + addrs = append(addrs, crypto.PubKeyToAddress(&key.PublicKey)) + } + + // Only 2 validators satisfy strict threshold => Tier 1 count is 2 < min(3). + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], stakeAmount, servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], stakeAmount, servers[1])) + require.Empty(t, framework.WaitForServersToSeal(servers, 12)) + + // Deactivate one validator so active set is exactly 3 => Tier 2 (active fallback) should be used. + require.NoError(t, sendSetActiveTx(servers[3], addrs[3], keys[3], false)) + require.Empty(t, framework.WaitForServersToSeal(servers, 18)) + + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Len(t, snap, 3) + assert.Contains(t, snap, addrs[0]) + assert.Contains(t, snap, addrs[1]) + assert.Contains(t, snap, addrs[2]) + assert.NotContains(t, snap, addrs[3]) +} + +func TestPoS_StakingV2_UnstakeDeletesValidatorState(t *testing.T) { + numGenesisValidators := IBFTMinNodes + require.Equal(t, 4, numGenesisValidators) + epochSize := uint64(5) + + defaultBalance := framework.EthToWei(7_000_000) + stakeAmount := framework.EthToWei(2_000_000) + + ibftManager := framework.NewIBFTServersManager( + t, + numGenesisValidators, + IBFTDirPrefix, + func(_ int, config *framework.TestServerConfig) { + config.SetEpochSize(epochSize) + config.PremineValidatorBalance(defaultBalance) + config.SetIBFTPoS(true) + config.SetMinValidatorCount(3) + config.SetMaxValidatorCount(uint64(numGenesisValidators)) + }, + ) + t.Cleanup(func() { ibftManager.StopServers() }) + + ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute) + defer cancel() + ibftManager.StartServers(ctx) + + servers := make([]*framework.TestServer, 0, numGenesisValidators) + keys := make([]*ecdsa.PrivateKey, 0, numGenesisValidators) + addrs := make([]types.Address, 0, numGenesisValidators) + + for i := 0; i < numGenesisValidators; i++ { + srv := ibftManager.GetServer(i) + key, err := srv.Config.PrivateKey() + require.NoError(t, err) + + servers = append(servers, srv) + keys = append(keys, key) + addrs = append(addrs, crypto.PubKeyToAddress(&key.PublicKey)) + } + + for i := 0; i < numGenesisValidators; i++ { + require.NoError(t, framework.StakeAmount(addrs[i], keys[i], stakeAmount, servers[i])) + } + require.Empty(t, framework.WaitForServersToSeal(servers, 12)) + + removeIdx := 3 + require.NoError(t, sendSetActiveTx(servers[removeIdx], addrs[removeIdx], keys[removeIdx], false)) + require.Empty(t, framework.WaitForServersToSeal(servers, 18)) + + deactivatedInfo, err := queryValidatorInfo(servers[0], addrs[0], addrs[removeIdx]) + require.NoError(t, err) + require.NotNil(t, deactivatedInfo.DeactivatedAtBlock) + require.True(t, deactivatedInfo.DeactivatedAtBlock.Sign() > 0) + + // unstake is allowed only once chain entered the epoch after deactivation + deactivatedAt := deactivatedInfo.DeactivatedAtBlock.Uint64() + unstakeReadyHeight := ((deactivatedAt / epochSize) + 1) * epochSize + require.Empty(t, framework.WaitForServersToSeal(servers, unstakeReadyHeight)) + + receipt, err := framework.UnstakeAmount(addrs[removeIdx], keys[removeIdx], servers[removeIdx]) + require.NoError(t, err) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + require.Empty(t, framework.WaitForServersToSeal(servers, 24)) + + info, err := queryValidatorInfo(servers[0], addrs[0], addrs[removeIdx]) + require.NoError(t, err) + assert.False(t, info.Exists) + assert.False(t, info.Active) + assert.Zero(t, info.StakedAmount.Sign()) + + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.NotContains(t, snap, addrs[removeIdx]) +} + +func TestPoS_StakingV2_WithdrawCannotDropBelowMinStake(t *testing.T) { + numGenesisValidators := IBFTMinNodes + require.Equal(t, 4, numGenesisValidators) + + defaultBalance := framework.EthToWei(7_000_000) + stakeAmount := framework.EthToWei(2_000_001) + + ibftManager := framework.NewIBFTServersManager( + t, + numGenesisValidators, + IBFTDirPrefix, + func(_ int, config *framework.TestServerConfig) { + config.SetEpochSize(5) + config.PremineValidatorBalance(defaultBalance) + config.SetIBFTPoS(true) + config.SetMinValidatorCount(3) + config.SetMaxValidatorCount(uint64(numGenesisValidators)) + }, + ) + t.Cleanup(func() { ibftManager.StopServers() }) + + ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute) + defer cancel() + ibftManager.StartServers(ctx) + + srv := ibftManager.GetServer(0) + key, err := srv.Config.PrivateKey() + require.NoError(t, err) + addr := crypto.PubKeyToAddress(&key.PublicKey) + + require.NoError(t, framework.StakeAmount(addr, key, stakeAmount, srv)) + require.Empty(t, framework.WaitForServersToSeal([]*framework.TestServer{srv}, 8)) + + beforeInfo, err := queryValidatorInfo(srv, addr, addr) + require.NoError(t, err) + beforeStake := new(big.Int).Set(beforeInfo.StakedAmount) + beforeAccountStake, err := framework.GetAccountStake(addr, srv.JSONRPC()) + require.NoError(t, err) + + require.NoError(t, sendSetActiveTx(srv, addr, key, false)) + require.Empty(t, framework.WaitForServersToSeal([]*framework.TestServer{srv}, 14)) + + minStake, err := queryValidatorMinSelfStake(srv, addr) + require.NoError(t, err) + + // withdraw checks are based on accountStake (staker amount), not validatorInfo.stakedAmount. + // Keep a large safety margin below min stake to avoid reward drift between call and execution. + targetRemaining := new(big.Int).Div(new(big.Int).Set(minStake), big.NewInt(2)) + withdrawAmount := new(big.Int).Sub(beforeAccountStake, targetRemaining) + receipt, err := sendWithdrawTx(srv, addr, key, withdrawAmount) + require.NoError(t, err) + require.NotNil(t, receipt) + assert.Equal(t, uint64(types.ReceiptFailed), receipt.Status) + + info, err := queryValidatorInfo(srv, addr, addr) + require.NoError(t, err) + assert.GreaterOrEqual(t, info.StakedAmount.Cmp(beforeStake), 0) + afterAccountStake, err := framework.GetAccountStake(addr, srv.JSONRPC()) + require.NoError(t, err) + assert.GreaterOrEqual(t, afterAccountStake.Cmp(beforeAccountStake), 0) +} + +func TestPoS_StakingV2_FinalizeEpoch_DeactivatesZeroUptimeValidator(t *testing.T) { + const ( + numGenesisValidators = 4 + epochSize = uint64(6) + ) + + defaultBalance := framework.EthToWei(7_000_000) + stakeAmount := framework.EthToWei(2_000_000) + + ibftManager := framework.NewIBFTServersManager( + t, + numGenesisValidators, + IBFTDirPrefix, + func(_ int, config *framework.TestServerConfig) { + config.SetEpochSize(epochSize) + config.PremineValidatorBalance(defaultBalance) + config.SetIBFTPoS(true) + config.SetMinValidatorCount(3) + config.SetMaxValidatorCount(numGenesisValidators) + }, + ) + t.Cleanup(func() { ibftManager.StopServers() }) + + ctx, cancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer cancel() + ibftManager.StartServers(ctx) + + servers := make([]*framework.TestServer, 0, numGenesisValidators) + keys := make([]*ecdsa.PrivateKey, 0, numGenesisValidators) + addrs := make([]types.Address, 0, numGenesisValidators) + + for i := 0; i < numGenesisValidators; i++ { + srv := ibftManager.GetServer(i) + key, err := srv.Config.PrivateKey() + require.NoError(t, err) + + servers = append(servers, srv) + keys = append(keys, key) + addrs = append(addrs, crypto.PubKeyToAddress(&key.PublicKey)) + } + + for i := 0; i < numGenesisValidators; i++ { + require.NoError(t, framework.StakeAmount(addrs[i], keys[i], stakeAmount, servers[i])) + } + require.Empty(t, framework.WaitForServersToSeal(servers, 12)) + + var snapBefore []types.Address + require.Eventually(t, func() bool { + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + height, hErr := servers[0].JSONRPC().Eth().BlockNumber() + if hErr != nil { + return false + } + + var snapErr error + snapBefore, snapErr = getSnapshotValidatorsAt(ctx, servers[0], height) + + return snapErr == nil && len(snapBefore) == numGenesisValidators + }, 90*time.Second, 2*time.Second, "expected 5-validator PoS set before offline phase") + require.Len(t, snapBefore, numGenesisValidators) + + inSnapshot := make(map[types.Address]struct{}, len(snapBefore)) + for _, addr := range snapBefore { + inSnapshot[addr] = struct{}{} + } + + offlineIdx := -1 + offlineAddr := types.ZeroAddress + for i, addr := range addrs { + if i == 0 { + continue + } + + if _, ok := inSnapshot[addr]; !ok { + continue + } + + info, infoErr := queryValidatorInfo(servers[0], addrs[0], addr) + require.NoError(t, infoErr) + if info.Exists && info.Active { + offlineIdx = i + offlineAddr = addr + break + } + } + + require.NotEqual(t, -1, offlineIdx, "failed to find active validator in snapshot") + + queryIdx := 0 + if offlineIdx == queryIdx { + queryIdx = 1 + } + + infoBeforeStop, err := queryValidatorInfo(servers[queryIdx], addrs[queryIdx], offlineAddr) + require.NoError(t, err) + beforeStake := new(big.Int).Set(infoBeforeStop.StakedAmount) + + heightBefore, err := servers[queryIdx].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + firstBoundary := ((heightBefore / epochSize) + 1) * epochSize + finalizeBoundary := firstBoundary + epochSize + + // Keep validator online until the block right before the epoch start, then stop it. + // This isolates a full target epoch with 0% uptime. + if firstBoundary > 1 { + require.Empty(t, framework.WaitForServersToSeal(servers, firstBoundary-1)) + } + ibftManager.StopServer(offlineIdx) + + // Wait epoch-by-epoch to stay below the helper's 1-minute per-call timeout + // (single call across two full epochs is borderline under slower block times). + require.Empty(t, framework.WaitForServersToSeal(ibftManager.ActiveServers(offlineIdx), firstBoundary+1)) + require.Empty(t, framework.WaitForServersToSeal(ibftManager.ActiveServers(offlineIdx), finalizeBoundary+1)) + + targetEpoch := epochFromFinalizedBoundary(finalizeBoundary, epochSize) + slashLog, hasSlashLog := findStakerSlashedLog( + t, + servers[queryIdx], + targetEpoch, + offlineAddr, + offlineAddr, + ) + + infoOffline, err := queryValidatorInfo(servers[queryIdx], addrs[queryIdx], offlineAddr) + require.NoError(t, err) + t.Logf( + "diag targetEpoch=%d hasSlashLog=%v beforeStake=%s afterStake=%s active=%v deactivatedAt=%s", + targetEpoch, + hasSlashLog, + beforeStake.String(), + infoOffline.StakedAmount.String(), + infoOffline.Active, + infoOffline.DeactivatedAtBlock.String(), + ) + + assert.True(t, infoOffline.Exists) + assert.False(t, infoOffline.Active, "validator with 0%% uptime in finalized epoch must be inactive") + + expectedSlashAmount := new(big.Int).Div(new(big.Int).Mul(beforeStake, big.NewInt(100)), big.NewInt(10_000)) + require.Positive(t, expectedSlashAmount.Sign(), "test setup should produce a non-zero slash amount") + expectedStakeAfter := new(big.Int).Sub(beforeStake, expectedSlashAmount) + assert.Equal(t, expectedStakeAfter.String(), infoOffline.StakedAmount.String(), "0%% uptime slash must reduce validator stake") + + if hasSlashLog { + slots := logDataWordBig(slashLog.Data, 5).Uint64() + missed := logDataWordBig(slashLog.Data, 6).Uint64() + require.Greater(t, slots, uint64(0), "StakerSlashed log should audit a real 0%%-uptime epoch (slots=0)") + require.Equal(t, slots, missed, "StakerSlashed log should audit the 0%%-uptime path") + assertStakerSlashedLogData( + t, + slashLog, + 1, + expectedSlashAmount, + beforeStake, + beforeStake, + expectedStakeAfter, + slots, + missed, + 100, + chain.DefaultBurnedAddress, + ) + } + + snapBeforeFinalizedEpoch := mustGetSnapshotValidatorsAt(t, servers[queryIdx], firstBoundary-1) + assert.Contains(t, snapBeforeFinalizedEpoch, offlineAddr, "pre-finalized epoch snapshot must keep old membership") + + require.Empty(t, framework.WaitForServersToSeal(ibftManager.ActiveServers(offlineIdx), finalizeBoundary+3)) + snapNextEpoch := mustGetLatestSnapshotValidators(t, servers[queryIdx]) + assert.NotContains(t, snapNextEpoch, offlineAddr, "inactive validator should drop from next epoch set") + + for i := 0; i < numGenesisValidators; i++ { + if i == offlineIdx { + continue + } + + info, infoErr := queryValidatorInfo(servers[queryIdx], addrs[queryIdx], addrs[i]) + require.NoError(t, infoErr) + assert.True(t, info.Active, "online validators must remain active") + } +} + +func findStakerSlashedLog( + t *testing.T, + srv *framework.TestServer, + epoch uint64, + validator types.Address, + staker types.Address, +) (*ethgo.Log, bool) { + t.Helper() + + topic := stakerSlashedEventTopic() + epochTopic := abiHashU64(epoch) + validatorTopic := abiHashAddress(validator) + stakerTopic := abiHashAddress(staker) + + filter := ðgo.LogFilter{ + Address: []ethgo.Address{ethgo.Address(pos.PosSysAddr)}, + Topics: [][]*ethgo.Hash{ + {&topic}, + }, + } + filter.SetFromUint64(0) + + logs, err := srv.JSONRPC().Eth().GetLogs(filter) + require.NoError(t, err) + if len(logs) == 0 { + allFilter := ðgo.LogFilter{} + allFilter.SetFromUint64(0) + logs, err = srv.JSONRPC().Eth().GetLogs(allFilter) + require.NoError(t, err) + } + + for _, log := range logs { + if log.Address != ethgo.Address(pos.PosSysAddr) || len(log.Topics) != 4 { + continue + } + if log.Topics[0] != topic || log.Topics[1] != epochTopic || log.Topics[2] != validatorTopic || log.Topics[3] != stakerTopic { + continue + } + + return log, true + } + + t.Logf("missing StakerSlashed log for epoch=%d validator=%s staker=%s scanned=%d", epoch, validator, staker, len(logs)) + + return nil, false +} + +func assertStakerSlashedLogData( + t *testing.T, + log *ethgo.Log, + role uint8, + amount *big.Int, + stakeSnapshot *big.Int, + stakeBefore *big.Int, + stakeAfter *big.Int, + slots uint64, + missed uint64, + slashBps uint64, + destination types.Address, +) { + t.Helper() + + require.Equal(t, ethgo.Address(pos.PosSysAddr), log.Address) + require.Len(t, log.Data, 9*32) + require.Equal(t, new(big.Int).SetUint64(uint64(role)), logDataWordBig(log.Data, 0), "role") + require.Equal(t, amount, logDataWordBig(log.Data, 1), "amount") + require.Equal(t, stakeSnapshot, logDataWordBig(log.Data, 2), "stakeSnapshot") + require.Equal(t, stakeBefore, logDataWordBig(log.Data, 3), "stakeBefore") + require.Equal(t, stakeAfter, logDataWordBig(log.Data, 4), "stakeAfter") + require.Equal(t, new(big.Int).SetUint64(slots), logDataWordBig(log.Data, 5), "slots") + require.Equal(t, new(big.Int).SetUint64(missed), logDataWordBig(log.Data, 6), "missed") + require.Equal(t, new(big.Int).SetUint64(slashBps), logDataWordBig(log.Data, 7), "slashBps") + require.Equal(t, abiWordAddress(destination), log.Data[8*32:9*32], "destination") +} + +func stakerSlashedEventTopic() ethgo.Hash { + return ethgo.Hash(types.BytesToHash(crypto.Keccak256([]byte("StakerSlashed(uint256,address,address,uint8,uint256,uint256,uint256,uint256,uint256,uint256,uint256,address)")))) +} + +func abiHashU64(v uint64) ethgo.Hash { + return ethgo.Hash(types.BytesToHash(abiWordBig(new(big.Int).SetUint64(v)))) +} + +func abiHashAddress(addr types.Address) ethgo.Hash { + return ethgo.Hash(types.BytesToHash(abiWordAddress(addr))) +} + +func abiWordAddress(addr types.Address) []byte { + var out [32]byte + copy(out[12:], addr[:]) + return out[:] +} + +func abiWordBig(v *big.Int) []byte { + var out [32]byte + if v == nil || v.Sign() == 0 { + return out[:] + } + b := v.Bytes() + if len(b) > 32 { + b = b[len(b)-32:] + } + copy(out[32-len(b):], b) + return out[:] +} + +func logDataWordBig(data []byte, idx int) *big.Int { + return new(big.Int).SetBytes(data[idx*32 : (idx+1)*32]) +} + +func sendSetActiveTx(srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey, value bool) error { + m := abis.StakingABI.Methods["setActive"] + if m == nil { + return assert.AnError + } + + inp, err := m.Inputs.Encode(map[string]interface{}{"active_": value}) + if err != nil { + return err + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + receipt, err := srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: big.NewInt(0), + Input: append(m.ID(), inp...), + }, key) + if err != nil { + return err + } + if receipt == nil || receipt.Status != uint64(types.ReceiptSuccess) { + return assert.AnError + } + + return nil +} + +func mustGetLatestSnapshotValidators(t *testing.T, srv *framework.TestServer) []types.Address { + t.Helper() + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + height, err := srv.JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + + out, err := getSnapshotValidatorsAt(ctx, srv, height) + require.NoError(t, err) + + return out +} + +func mustGetSnapshotValidatorsAt(t *testing.T, srv *framework.TestServer, height uint64) []types.Address { + t.Helper() + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + out, err := getSnapshotValidatorsAt(ctx, srv, height) + require.NoError(t, err) + + return out +} + +func getSnapshotValidatorsAt(ctx context.Context, srv *framework.TestServer, height uint64) ([]types.Address, error) { + snap, err := srv.IBFTOperator().GetSnapshot(ctx, &ibftOp.SnapshotReq{Number: height}) + if err != nil { + return nil, err + } + + out := make([]types.Address, 0, len(snap.Validators)) + for _, v := range snap.Validators { + out = append(out, types.BytesToAddress(v.Data)) + } + + return out, nil +} + +type stakingValidatorInfo struct { + Exists bool + Active bool + StakedAmount *big.Int + DeactivatedAtBlock *big.Int +} + +func queryValidatorInfo(srv *framework.TestServer, from, validator types.Address) (*stakingValidatorInfo, error) { + m := abis.StakingABI.Methods["validatorInfo"] + if m == nil { + return nil, assert.AnError + } + + input, err := m.Inputs.Encode(map[string]interface{}{"account": ethgo.Address(validator)}) + if err != nil { + return nil, err + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: append(m.ID(), input...), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return nil, err + } + + b, err := hex.DecodeHex(resp) + if err != nil { + return nil, err + } + + decoded, err := m.Outputs.Decode(b) + if err != nil { + return nil, err + } + + mapResult, ok := decoded.(map[string]interface{}) + if !ok { + return nil, assert.AnError + } + + exists, _ := mapResult["0"].(bool) + if !exists { + if v, ok := mapResult["exists"].(bool); ok { + exists = v + } + } + + active, _ := mapResult["1"].(bool) + if !active { + if v, ok := mapResult["active"].(bool); ok { + active = v + } + } + + stakedAmount, _ := mapResult["2"].(*big.Int) + if stakedAmount == nil { + stakedAmount, _ = mapResult["stakedAmount"].(*big.Int) + } + if stakedAmount == nil { + stakedAmount = big.NewInt(0) + } + + deactivatedAtBlock, _ := mapResult["3"].(*big.Int) + if deactivatedAtBlock == nil { + deactivatedAtBlock, _ = mapResult["deactivatedAtBlock"].(*big.Int) + } + if deactivatedAtBlock == nil { + deactivatedAtBlock = big.NewInt(0) + } + + return &stakingValidatorInfo{ + Exists: exists, + Active: active, + StakedAmount: stakedAmount, + DeactivatedAtBlock: deactivatedAtBlock, + }, nil +} + +func queryIsValidatorThresholdMet(srv *framework.TestServer, from, validator types.Address) (bool, error) { + m := abis.StakingABI.Methods["isValidatorThresholdMet"] + if m == nil { + return false, assert.AnError + } + + input, err := m.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(validator)}) + if err != nil { + return false, err + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: append(m.ID(), input...), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return false, err + } + + b, err := hex.DecodeHex(resp) + if err != nil { + return false, err + } + + decoded, err := m.Outputs.Decode(b) + if err != nil { + return false, err + } + + mapResult, ok := decoded.(map[string]interface{}) + if !ok { + return false, assert.AnError + } + + if met, ok := mapResult["0"].(bool); ok { + return met, nil + } + + for _, v := range mapResult { + if met, ok := v.(bool); ok { + return met, nil + } + } + + return false, assert.AnError +} + +func queryJoinEffectiveAtBlock(srv *framework.TestServer, from, account types.Address) (*big.Int, error) { + m := abis.StakingABI.Methods["joinEffectiveAtBlock"] + if m == nil { + return nil, assert.AnError + } + + input, err := m.Inputs.Encode(map[string]interface{}{"account": ethgo.Address(account)}) + if err != nil { + return nil, err + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: append(m.ID(), input...), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return nil, err + } + + b, err := hex.DecodeHex(resp) + if err != nil { + return nil, err + } + + decoded, err := m.Outputs.Decode(b) + if err != nil { + return nil, err + } + + mapResult, ok := decoded.(map[string]interface{}) + if !ok { + return nil, assert.AnError + } + + if at, ok := mapResult["0"].(*big.Int); ok { + return at, nil + } + + for _, v := range mapResult { + if at, ok := v.(*big.Int); ok { + return at, nil + } + } + + return nil, assert.AnError +} + +func epochFromFinalizedBoundary(boundary, epochSize uint64) uint64 { + if boundary < epochSize || epochSize == 0 { + return 0 + } + + return boundary/epochSize - 1 +} + +func queryValidatorMinSelfStake(srv *framework.TestServer, from types.Address) (*big.Int, error) { + m := abis.StakingABI.Methods["VALIDATOR_MIN_SELF_STAKE"] + if m == nil { + return nil, assert.AnError + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: m.ID(), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return nil, err + } + + return common.ParseUint256orHex(&resp) +} + +func queryValidatorThreshold(srv *framework.TestServer, from types.Address) (*big.Int, error) { + m := abis.StakingABI.Methods["VALIDATOR_THRESHOLD"] + if m == nil { + return nil, assert.AnError + } + + to := ethgo.Address(staking.AddrStakingContract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: m.ID(), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return nil, err + } + + return common.ParseUint256orHex(&resp) +} + +func queryMinStake(srv *framework.TestServer, from types.Address) (*big.Int, error) { + return queryValidatorMinSelfStake(srv, from) +} + +func sendWithdrawTx( + srv *framework.TestServer, + from types.Address, + key *ecdsa.PrivateKey, + amount *big.Int, +) (*ethgo.Receipt, error) { + m := abis.StakingABI.Methods["withdraw"] + if m == nil { + return nil, assert.AnError + } + + inp, err := m.Inputs.Encode(map[string]interface{}{"amount": amount}) + if err != nil { + return nil, err + } + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + return srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &staking.AddrStakingContract, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: big.NewInt(0), + Input: append(m.ID(), inp...), + }, key) +} diff --git a/e2e/pos_stakingv2_lifecycle_test.go b/e2e/pos_stakingv2_lifecycle_test.go new file mode 100644 index 0000000..a9d72bc --- /dev/null +++ b/e2e/pos_stakingv2_lifecycle_test.go @@ -0,0 +1,632 @@ +package e2e + +import ( + "context" + "crypto/ecdsa" + "fmt" + "math/big" + "testing" + "time" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + "github.com/umbracle/ethgo" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/e2e/framework" + "github.com/xgr-network/xgr-node/types" +) + +func setupStakingV2Cluster(t *testing.T, numValidators int, epochSize, minValidators, maxValidators uint64) ([]*framework.TestServer, []*ecdsa.PrivateKey, []types.Address, *framework.IBFTServersManager) { + t.Helper() + + defaultBalance := framework.EthToWei(100_000_000) + stakeAmount := framework.EthToWei(2_000_000) + + ibftManager := framework.NewIBFTServersManager( + t, + numValidators, + IBFTDirPrefix, + func(_ int, config *framework.TestServerConfig) { + config.SetEpochSize(epochSize) + config.PremineValidatorBalance(defaultBalance) + config.SetIBFTPoS(true) + config.SetMinValidatorCount(minValidators) + config.SetMaxValidatorCount(maxValidators) + }, + ) + t.Cleanup(func() { ibftManager.StopServers() }) + + ctx, cancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer cancel() + ibftManager.StartServers(ctx) + + servers := make([]*framework.TestServer, 0, numValidators) + keys := make([]*ecdsa.PrivateKey, 0, numValidators) + addrs := make([]types.Address, 0, numValidators) + + for i := 0; i < numValidators; i++ { + srv := ibftManager.GetServer(i) + key, err := srv.Config.PrivateKey() + require.NoError(t, err) + + servers = append(servers, srv) + keys = append(keys, key) + addrs = append(addrs, crypto.PubKeyToAddress(&key.PublicKey)) + } + + for i := 0; i < numValidators; i++ { + require.NoError(t, framework.StakeAmount(addrs[i], keys[i], stakeAmount, servers[i])) + } + require.Empty(t, framework.WaitForServersToSeal(servers, epochSize+6)) + + return servers, keys, addrs, ibftManager +} + +func setupStakingV2ClusterWithStandbyNode(t *testing.T, numNodes, numGenesisValidators int, epochSize, minValidators, maxValidators uint64) ([]*framework.TestServer, []*ecdsa.PrivateKey, []types.Address, *framework.IBFTServersManager) { + t.Helper() + + defaultBalance := framework.EthToWei(100_000_000) + stakeAmount := framework.EthToWei(2_000_000) + + ibftManager := framework.NewIBFTServersManagerWithGenesisValidators( + t, + numNodes, + numGenesisValidators, + IBFTDirPrefix, + func(index int, config *framework.TestServerConfig) { + if index >= numGenesisValidators { + config.SetIBFTDirPrefix("polygon-edge-non-validator-") + config.SetIBFTDir("polygon-edge-non-validator-" + fmt.Sprint(index)) + } + config.SetEpochSize(epochSize) + config.PremineValidatorBalance(defaultBalance) + config.SetIBFTPoS(true) + config.SetMinValidatorCount(minValidators) + config.SetMaxValidatorCount(maxValidators) + }, + ) + t.Cleanup(func() { ibftManager.StopServers() }) + + ctx, cancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer cancel() + ibftManager.StartServers(ctx) + + servers := make([]*framework.TestServer, 0, numNodes) + keys := make([]*ecdsa.PrivateKey, 0, numNodes) + addrs := make([]types.Address, 0, numNodes) + + for i := 0; i < numNodes; i++ { + srv := ibftManager.GetServer(i) + key, err := srv.Config.PrivateKey() + require.NoError(t, err) + + servers = append(servers, srv) + keys = append(keys, key) + addrs = append(addrs, crypto.PubKeyToAddress(&key.PublicKey)) + } + + for i := 0; i < numGenesisValidators; i++ { + require.NoError(t, framework.StakeAmount(addrs[i], keys[i], stakeAmount, servers[i])) + } + require.Empty(t, framework.WaitForServersToSeal(servers, epochSize+6)) + + return servers, keys, addrs, ibftManager +} + +func setupStakingV2ClusterNoAutoStake(t *testing.T, numValidators int, epochSize, minValidators, maxValidators uint64) ([]*framework.TestServer, []*ecdsa.PrivateKey, []types.Address, *framework.IBFTServersManager) { + t.Helper() + + defaultBalance := framework.EthToWei(100_000_000) + + ibftManager := framework.NewIBFTServersManager( + t, + numValidators, + IBFTDirPrefix, + func(_ int, config *framework.TestServerConfig) { + config.SetEpochSize(epochSize) + config.PremineValidatorBalance(defaultBalance) + config.SetIBFTPoS(true) + config.SetMinValidatorCount(minValidators) + config.SetMaxValidatorCount(maxValidators) + }, + ) + t.Cleanup(func() { ibftManager.StopServers() }) + + ctx, cancel := context.WithTimeout(context.Background(), 3*time.Minute) + defer cancel() + ibftManager.StartServers(ctx) + + servers := make([]*framework.TestServer, 0, numValidators) + keys := make([]*ecdsa.PrivateKey, 0, numValidators) + addrs := make([]types.Address, 0, numValidators) + + for i := 0; i < numValidators; i++ { + srv := ibftManager.GetServer(i) + key, err := srv.Config.PrivateKey() + require.NoError(t, err) + + servers = append(servers, srv) + keys = append(keys, key) + addrs = append(addrs, crypto.PubKeyToAddress(&key.PublicKey)) + } + + require.Empty(t, framework.WaitForServersToSeal(servers, epochSize+3)) + + return servers, keys, addrs, ibftManager +} + +func fundAccount(t *testing.T, srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey, to types.Address, amount *big.Int) { + t.Helper() + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + receipt, err := srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &to, + GasPrice: framework.TestGasPrice(), + Gas: framework.DefaultGasLimit, + Value: amount, + }, key) + require.NoError(t, err) + require.NotNil(t, receipt) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) +} + +func ensureStakeFunding( + t *testing.T, + payerSrv *framework.TestServer, + payerAddr types.Address, + payerKey *ecdsa.PrivateKey, + stakerAddr types.Address, + required *big.Int, +) { + t.Helper() + + balance := framework.GetAccountBalance(t, stakerAddr, payerSrv.JSONRPC()) + if balance.Cmp(required) >= 0 { + return + } + + topUp := new(big.Int).Sub(required, balance) + topUp.Add(topUp, framework.EthToWei(1)) // extra headroom for pending tx / gas + fundAccount(t, payerSrv, payerAddr, payerKey, stakerAddr, topUp) +} + +func TestPoS_StakingV2_StakeBelowMinDoesNotJoinSet(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 5, 3, 5) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + + candidateKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + candidateAddr := crypto.PubKeyToAddress(&candidateKey.PublicKey) + + fundAccount(t, servers[0], addrs[0], keys[0], candidateAddr, new(big.Int).Mul(minStake, big.NewInt(2))) + require.NoError(t, framework.StakeAmount(candidateAddr, candidateKey, new(big.Int).Sub(minStake, big.NewInt(1)), servers[0])) + require.Empty(t, framework.WaitForServersToSeal(servers, 18)) + + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.NotContains(t, snap, candidateAddr) +} + +func TestPoS_StakingV2_StakeAtMinJoinsSet(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 5, 3, 5) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + + candidateKey, err := crypto.GenerateECDSAKey() + require.NoError(t, err) + candidateAddr := crypto.PubKeyToAddress(&candidateKey.PublicKey) + + fundAccount(t, servers[0], addrs[0], keys[0], candidateAddr, new(big.Int).Mul(minStake, big.NewInt(3))) + require.NoError(t, framework.StakeAmount(candidateAddr, candidateKey, minStake, servers[0])) + require.Empty(t, framework.WaitForServersToSeal(servers, 22)) + + listed := mustGetStakingValidatorList(t, servers[0], addrs[0]) + assert.Contains(t, listed, candidateAddr, "candidate with exactly min self stake should join validators()") + + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.NotContains(t, snap, candidateAddr, "snapshot Tier 1 still requires validator threshold support") +} + +func TestPoS_StakingV2_BelowMinStakeExcludedWhenTier1StillSatisfiesMinValidators(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + + threshold, err := queryValidatorThreshold(servers[0], addrs[0]) + require.NoError(t, err) + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], threshold, servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], threshold, servers[1])) + require.NoError(t, framework.StakeAmount(addrs[2], keys[2], threshold, servers[2])) + waitForNextEpochTransition(t, servers, 6) + + listed := mustGetStakingValidatorList(t, servers[0], addrs[0]) + require.Contains(t, listed, addrs[3], "target validator must be in validators() universe") + countTier1, countTier2, countTier3 := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], threshold) + require.GreaterOrEqual(t, countTier1, uint64(3), "Tier 1 should remain active because strict-eligible count meets minValidators") + assert.GreaterOrEqual(t, countTier2, countTier1) + assert.GreaterOrEqual(t, countTier3, countTier2) + + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.NotContains(t, snap, addrs[3], "below-min listed validator must be excluded while Tier 1 is selected") +} + +func TestPoS_StakingV2_BelowMinStakeRetainedViaTier2WhenTier1FallsBelowMinValidators(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], minStake, servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], minStake, servers[1])) + waitForNextEpochTransition(t, servers, 6) + + listed := mustGetStakingValidatorList(t, servers[0], addrs[0]) + require.Contains(t, listed, addrs[3], "target validator must be in validators() universe") + countTier1, countTier2, _ := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + require.Less(t, countTier1, uint64(3), "Tier 1 should be insufficient with only two strict validators") + require.GreaterOrEqual(t, countTier2, uint64(3), "Tier 2 should satisfy minValidators via active fallback") + + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Contains(t, snap, addrs[3], "listed below-min validator should be retained because Tier 2 is selected") +} + +func TestPoS_StakingV2_InactiveButStakedRetainedViaTier3WhenTier2FallsBelowMinValidators(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], minStake, servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], minStake, servers[1])) + require.NoError(t, framework.StakeAmount(addrs[2], keys[2], minStake, servers[2])) + waitForNextEpochTransition(t, servers, 6) + + require.NoError(t, sendSetActiveTx(servers[1], addrs[1], keys[1], false)) + require.NoError(t, sendSetActiveTx(servers[2], addrs[2], keys[2], false)) + waitForNextEpochTransition(t, servers, 6) + + listed := mustGetStakingValidatorList(t, servers[0], addrs[0]) + require.Contains(t, listed, addrs[2], "target validator must be in validators() universe") + countTier1, countTier2, countTier3 := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + require.Less(t, countTier1, uint64(3), "Tier 1 should be insufficient with inactive validators") + require.Less(t, countTier2, uint64(3), "Tier 2 should be insufficient when active validator count falls below minValidators") + require.GreaterOrEqual(t, countTier3, uint64(3), "Tier 3 should satisfy minValidators with stake-only fallback") + + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Contains(t, snap, addrs[2], "inactive listed validator with stake>0 should be retained when Tier 3 is selected") +} + +func TestPoS_StakingV2_Tier1ToTier2Transition(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + threshold, err := queryValidatorThreshold(servers[0], addrs[0]) + require.NoError(t, err) + + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], threshold, servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], threshold, servers[1])) + require.NoError(t, framework.StakeAmount(addrs[2], keys[2], threshold, servers[2])) + waitForNextEpochTransition(t, servers, 6) + snapTier1 := mustGetLatestSnapshotValidators(t, servers[0]) + assert.NotContains(t, snapTier1, addrs[3], "below-min listed validator should be excluded while Tier 1 remains active") + + require.NoError(t, sendSetActiveTx(servers[2], addrs[2], keys[2], false)) + waitForNextEpochTransition(t, servers, 6) + + countTier1, countTier2, _ := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], threshold) + require.Less(t, countTier1, uint64(3)) + require.GreaterOrEqual(t, countTier2, uint64(3)) + snapTier2 := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Contains(t, snapTier2, addrs[3], "below-min listed validator should appear once selection transitions from Tier 1 to Tier 2") +} + +func TestPoS_StakingV2_Tier2ToTier1Recovery(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + threshold, err := queryValidatorThreshold(servers[0], addrs[0]) + require.NoError(t, err) + + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], threshold, servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], threshold, servers[1])) + require.NoError(t, framework.StakeAmount(addrs[2], keys[2], threshold, servers[2])) + waitForNextEpochTransition(t, servers, 6) + + require.NoError(t, sendSetActiveTx(servers[2], addrs[2], keys[2], false)) + waitForNextEpochTransition(t, servers, 6) + require.Contains(t, mustGetLatestSnapshotValidators(t, servers[0]), addrs[3], "below-min listed validator should be included while Tier 2 is active") + + require.NoError(t, sendSetActiveTx(servers[2], addrs[2], keys[2], true)) + waitForNextEpochTransition(t, servers, 6) + countTier1, _, _ := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], threshold) + require.GreaterOrEqual(t, countTier1, uint64(3)) + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.NotContains(t, snap, addrs[3], "below-min listed validator should drop once Tier 1 recovers") +} + +func TestPoS_StakingV2_Tier2ToTier3Transition(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], minStake, servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], minStake, servers[1])) + require.NoError(t, framework.StakeAmount(addrs[2], keys[2], minStake, servers[2])) + waitForNextEpochTransition(t, servers, 6) + + require.NoError(t, sendSetActiveTx(servers[2], addrs[2], keys[2], false)) + waitForNextEpochTransition(t, servers, 6) + countTier1Before, countTier2Before, _ := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + require.Less(t, countTier1Before, uint64(3)) + require.GreaterOrEqual(t, countTier2Before, uint64(3), "first phase should remain in Tier 2") + + require.NoError(t, sendSetActiveTx(servers[1], addrs[1], keys[1], false)) + waitForNextEpochTransition(t, servers, 6) + + countTier1, countTier2, countTier3 := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + require.Less(t, countTier1, uint64(3)) + require.Less(t, countTier2, uint64(3)) + require.GreaterOrEqual(t, countTier3, uint64(3)) + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Contains(t, snap, addrs[2], "inactive staked validator should be present once selection transitions to Tier 3") +} + +func TestPoS_StakingV2_Tier3ToTier1Recovery(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterNoAutoStake(t, 4, 6, 3, 5) + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], minStake, servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], minStake, servers[1])) + require.NoError(t, framework.StakeAmount(addrs[2], keys[2], minStake, servers[2])) + require.NoError(t, framework.StakeAmount(addrs[3], keys[3], minStake, servers[3])) + waitForNextEpochTransition(t, servers, 6) + + require.NoError(t, sendSetActiveTx(servers[3], addrs[3], keys[3], false)) + require.NoError(t, sendSetActiveTx(servers[2], addrs[2], keys[2], false)) + require.NoError(t, sendSetActiveTx(servers[1], addrs[1], keys[1], false)) + waitForNextEpochTransition(t, servers, 6) + require.Contains(t, mustGetLatestSnapshotValidators(t, servers[0]), addrs[3], "validator should be included while Tier 3 is active") + + require.NoError(t, sendSetActiveTx(servers[3], addrs[3], keys[3], true)) + require.NoError(t, sendSetActiveTx(servers[2], addrs[2], keys[2], true)) + require.NoError(t, sendSetActiveTx(servers[1], addrs[1], keys[1], true)) + waitForNextEpochTransition(t, servers, 6) + + countTier1, _, _ := countSelectionTiersFromValidatorList(t, servers[0], addrs[0], minStake) + require.GreaterOrEqual(t, countTier1, uint64(3)) + snap := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Contains(t, snap, addrs[3], "validator should remain selected after Tier 1 recovery because it is strict-eligible again") +} + +func TestPoS_StakingV2_DeactivateKeepsMembershipUntilEpochBoundary(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 6, 3, 4) + + require.NoError(t, sendSetActiveTx(servers[3], addrs[3], keys[3], false)) + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + heightNow, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + nextBoundary := ((heightNow / 6) + 1) * 6 + + require.Empty(t, framework.WaitForServersToSeal(servers, nextBoundary-1)) + snapBeforeBoundary, err := getSnapshotValidatorsAt(ctx, servers[0], nextBoundary-1) + require.NoError(t, err) + assert.Contains(t, snapBeforeBoundary, addrs[3]) + + require.Empty(t, framework.WaitForServersToSeal(servers, nextBoundary+3)) + snapAfterBoundary := mustGetLatestSnapshotValidators(t, servers[0]) + assert.NotContains(t, snapAfterBoundary, addrs[3]) +} + +func TestPoS_StakingV2_RejoinAfterDeactivate(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2Cluster(t, 4, 6, 3, 4) + + require.NoError(t, sendSetActiveTx(servers[3], addrs[3], keys[3], false)) + require.Empty(t, framework.WaitForServersToSeal(servers, 20)) + snapAfterDeactivate := mustGetLatestSnapshotValidators(t, servers[0]) + assert.NotContains(t, snapAfterDeactivate, addrs[3]) + + require.NoError(t, sendSetActiveTx(servers[3], addrs[3], keys[3], true)) + require.Empty(t, framework.WaitForServersToSeal(servers, 30)) + snapAfterRejoin := mustGetLatestSnapshotValidators(t, servers[0]) + assert.Contains(t, snapAfterRejoin, addrs[3]) +} + +func TestPoS_StakingV2_MaxValidatorsCutsLowestTier1Validator(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterWithStandbyNode(t, 5, 4, 5, 3, 4) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + threshold, err := queryValidatorThreshold(servers[0], addrs[0]) + require.NoError(t, err) + incumbentDInfo, err := queryValidatorInfo(servers[0], addrs[0], addrs[3]) + require.NoError(t, err) + + // Enforce deterministic strict-tier ranking: + // Incumbent A > Incumbent B > Incumbent C > Candidate > Incumbent D. + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], framework.EthToWei(40), servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], framework.EthToWei(30), servers[1])) + require.NoError(t, framework.StakeAmount(addrs[2], keys[2], framework.EthToWei(20), servers[2])) + + candidateAddr := addrs[4] + candidateKey := keys[4] + + candidateStake := new(big.Int).Add(incumbentDInfo.StakedAmount, framework.EthToWei(10)) + require.GreaterOrEqual(t, candidateStake.Cmp(minStake), 0, "candidate must satisfy min self stake") + require.Greater(t, candidateStake.Cmp(threshold), 0, "candidate stake must strictly exceed threshold") + gasPrice := framework.TestGasPriceUint64() + gasReserve := new(big.Int).Mul( + new(big.Int).SetUint64(framework.DefaultGasLimit), + new(big.Int).SetUint64(gasPrice), + ) + gasReserve.Mul(gasReserve, big.NewInt(5)) + requiredCandidate := new(big.Int).Add(candidateStake, gasReserve) + ensureStakeFunding(t, servers[0], addrs[0], keys[0], candidateAddr, requiredCandidate) + heightAfterFunding, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + require.Empty(t, framework.WaitForServersToSeal(servers, heightAfterFunding)) + candidateBalance, err := servers[0].JSONRPC().Eth().GetBalance(ethgo.Address(candidateAddr), ethgo.Latest) + require.NoError(t, err) + minimumCandidateBalance := new(big.Int).Add(candidateStake, new(big.Int).Div(new(big.Int).Set(gasReserve), big.NewInt(2))) + require.GreaterOrEqual(t, candidateBalance.Cmp(minimumCandidateBalance), 0, "candidate balance must cover candidate stake plus gas reserve") + t.Logf("staking maxValidators candidate: candidateStake=%s candidateBalance=%s gasReserve=%s gasPrice=%d defaultGasLimit=%d", candidateStake.String(), candidateBalance.String(), gasReserve.String(), gasPrice, framework.DefaultGasLimit) + require.NoError(t, framework.StakeAmount(candidateAddr, candidateKey, candidateStake, servers[4])) + + candidateInfo, err := queryValidatorInfo(servers[0], addrs[0], candidateAddr) + require.NoError(t, err) + assert.True(t, candidateInfo.Active, "candidate must be active") + assert.GreaterOrEqual(t, candidateInfo.StakedAmount.Cmp(minStake), 0, "candidate must satisfy min self stake") + + metThreshold, err := queryIsValidatorThresholdMet(servers[0], addrs[0], candidateAddr) + require.NoError(t, err) + assert.True(t, metThreshold, "candidate must satisfy threshold") + + joinEffectiveAt, err := queryJoinEffectiveAtBlock(servers[0], addrs[0], candidateAddr) + require.NoError(t, err) + heightNow, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + + snapshotBlock := joinEffectiveAt.Uint64() + 1 + if heightNow < snapshotBlock { + require.Empty(t, framework.WaitForServersToSeal(servers, snapshotBlock)) + heightNow, err = servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + } + assert.GreaterOrEqual(t, new(big.Int).SetUint64(heightNow).Cmp(joinEffectiveAt), 0, "candidate join must be effective") + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + snap, err := getSnapshotValidatorsAt(ctx, servers[0], snapshotBlock) + require.NoError(t, err) + require.Len(t, snap, 4, "maxValidators cap must be applied") + assert.Contains(t, snap, candidateAddr, "candidate should be included in capped top-4 snapshot") + assert.NotContains(t, snap, addrs[3], "lowest incumbent must be displaced") + assert.Contains(t, snap, addrs[0], "incumbent A should remain in snapshot") + assert.Contains(t, snap, addrs[1], "incumbent B should remain in snapshot") + assert.Contains(t, snap, addrs[2], "incumbent C should remain in snapshot") +} + +func waitForNextEpochTransition(t *testing.T, servers []*framework.TestServer, epochSize uint64) { + t.Helper() + + heightNow, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + nextBoundary := ((heightNow / epochSize) + 1) * epochSize + require.Empty(t, framework.WaitForServersToSeal(servers, nextBoundary+1)) +} + +func mustGetStakingValidatorList(t *testing.T, srv *framework.TestServer, from types.Address) []types.Address { + t.Helper() + + res, err := framework.GetValidatorSet(from, srv.JSONRPC()) + require.NoError(t, err) + + return res +} + +func countSelectionTiersFromValidatorList( + t *testing.T, + srv *framework.TestServer, + queryFrom types.Address, + minStake *big.Int, +) (tier1 uint64, tier2 uint64, tier3 uint64) { + t.Helper() + + for _, addr := range mustGetStakingValidatorList(t, srv, queryFrom) { + info, err := queryValidatorInfo(srv, queryFrom, addr) + require.NoError(t, err) + + if info.StakedAmount.Sign() > 0 { + tier3++ + } + if info.Active { + tier2++ + } + if info.Active && info.StakedAmount.Cmp(minStake) >= 0 { + tier1++ + } + } + + return tier1, tier2, tier3 +} + +func TestPoS_StakingV2_MaxValidatorsTieBreakIsDeterministic(t *testing.T) { + servers, keys, addrs, _ := setupStakingV2ClusterWithStandbyNode(t, 5, 4, 5, 3, 4) + + minStake, err := queryMinStake(servers[0], addrs[0]) + require.NoError(t, err) + threshold, err := queryValidatorThreshold(servers[0], addrs[0]) + require.NoError(t, err) + require.Greater(t, threshold.Cmp(minStake), 0, "threshold must be greater than min self stake") + + // Raise two incumbents above threshold so the capped last seat is contested only by A/B. + require.NoError(t, framework.StakeAmount(addrs[0], keys[0], minStake, servers[0])) + require.NoError(t, framework.StakeAmount(addrs[1], keys[1], minStake, servers[1])) + + candidateA := addrs[2] + candidateB := addrs[3] + + // Use the 5th real running validator as strict-eligible extra candidate. + // This creates 5 strict-eligible validators for maxValidators=4: + // fixed winners = {topup0, topup1, extra}; tie-break = {A, B} for final seat. + extraAddr := addrs[4] + extraKey := keys[4] + extraStake := new(big.Int).Add(threshold, new(big.Int).Mul(minStake, big.NewInt(50))) + requiredExtra := new(big.Int).Add(extraStake, framework.EthToWei(2)) + ensureStakeFunding(t, servers[0], addrs[0], keys[0], extraAddr, requiredExtra) + require.NoError(t, framework.StakeAmount(extraAddr, extraKey, extraStake, servers[4])) + + var metExtra bool + for i := 0; i < 6; i++ { + metExtra, err = queryIsValidatorThresholdMet(servers[0], addrs[0], extraAddr) + require.NoError(t, err) + joinExtra, err := queryJoinEffectiveAtBlock(servers[0], addrs[0], extraAddr) + require.NoError(t, err) + heightNow, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + + if metExtra && new(big.Int).SetUint64(heightNow).Cmp(joinExtra) >= 0 { + break + } + + waitForNextEpochTransition(t, servers, 5) + } + require.True(t, metExtra, "extra validator must be strict Tier1-eligible") + metA, err := queryIsValidatorThresholdMet(servers[0], addrs[0], candidateA) + require.NoError(t, err) + metB, err := queryIsValidatorThresholdMet(servers[0], addrs[0], candidateB) + require.NoError(t, err) + require.True(t, metA && metB, "tie-break must be evaluated only after both candidates are strict Tier1-eligible") + + snap1 := mustGetLatestSnapshotValidators(t, servers[0]) + require.Len(t, snap1, 4) + require.Contains(t, snap1, addrs[0]) + require.Contains(t, snap1, addrs[1]) + require.Contains(t, snap1, extraAddr) + winnerA := containsAddress(snap1, candidateA) + winnerB := containsAddress(snap1, candidateB) + require.NotEqual(t, winnerA, winnerB, "exactly one candidate should win the tie for the capped seat") + + height, err := servers[0].JSONRPC().Eth().BlockNumber() + require.NoError(t, err) + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + snapAtHFromSrv0, err := getSnapshotValidatorsAt(ctx, servers[0], height) + require.NoError(t, err) + snapAtHFromSrv1, err := getSnapshotValidatorsAt(ctx, servers[1], height) + require.NoError(t, err) + + assert.Equal(t, containsAddress(snapAtHFromSrv0, candidateA), containsAddress(snapAtHFromSrv1, candidateA)) + assert.Equal(t, containsAddress(snapAtHFromSrv0, candidateB), containsAddress(snapAtHFromSrv1, candidateB)) + assert.Equal(t, winnerA, containsAddress(snapAtHFromSrv0, candidateA)) + assert.Equal(t, winnerB, containsAddress(snapAtHFromSrv0, candidateB)) +} + +func containsAddress(set []types.Address, target types.Address) bool { + for _, addr := range set { + if addr == target { + return true + } + } + + return false +} diff --git a/e2e/pos_stakingv2_reentrancy_helpers_test.go b/e2e/pos_stakingv2_reentrancy_helpers_test.go new file mode 100644 index 0000000..c1261d2 --- /dev/null +++ b/e2e/pos_stakingv2_reentrancy_helpers_test.go @@ -0,0 +1,119 @@ +package e2e + +import ( + "context" + "crypto/ecdsa" + "errors" + "math/big" + "testing" + + "github.com/stretchr/testify/require" + "github.com/umbracle/ethgo" + "github.com/umbracle/ethgo/abi" + "github.com/xgr-network/xgr-node/e2e/framework" + "github.com/xgr-network/xgr-node/helper/hex" + "github.com/xgr-network/xgr-node/types" +) + +const stakingV2ReentrantDelegatorBytecode = `608060405234801561001057600080fd5b50610812806100206000396000f3fe6080604052600436106100955760003560e01c80635c19a95c116100595780635c19a95c146101895780638c9e2cdb1461019c578063917f51b4146101f6578063953c368c14610210578063aa8c217c14610230576100a4565b806301a5d67e146100ac578063295a5212146100cc5780632f830600146100fd5780633a5381b51461011d57806359703b2e1461015a576100a4565b366100a4576100a2610254565b005b6100a2610254565b3480156100b857600080fd5b506100a26100c73660046106e1565b610499565b3480156100d857600080fd5b506000546100e69060ff1681565b60405160ff90911681526020015b60405180910390f35b34801561010957600080fd5b506100a261011836600461070b565b610558565b34801561012957600080fd5b506000546101429061010090046001600160a01b031681565b6040516001600160a01b0390911681526020016100f4565b34801561016657600080fd5b5060025461017990610100900460ff1681565b60405190151581526020016100f4565b6100a2610197366004610747565b610589565b3480156101a857600080fd5b506100a26101b7366004610769565b600080546001600160a01b03909316610100026001600160a81b031990931660ff90941693909317919091179091556001556002805461ffff19169055565b34801561020257600080fd5b506002546101799060ff1681565b34801561021c57600080fd5b506100a261022b366004610747565b610633565b34801561023c57600080fd5b5061024660015481565b6040519081526020016100f4565b60025460ff1680610268575060005460ff16155b1561026f57565b6002805460ff1916600190811790915560008054909160ff91909116900361034e576000546001546040516101009092046001600160a01b0316602483015260448201526110019062d2eb3f60e11b906064015b60408051601f198184030181529181526020820180516001600160e01b03166001600160e01b031990941693909317909252905161030191906107ad565b6000604051808303816000865af19150503d806000811461033e576040519150601f19603f3d011682016040523d82523d6000602084013e610343565b606091505b50508091505061047f565b60005460ff1660020361038a576000546040516101009091046001600160a01b031660248201526110019063254f0da360e21b906044016102c3565b60005460ff166003036103cc576000546040516101009091046001600160a01b0316602482015260016044820152611001906217c18360e91b906064016102c3565b60005460ff1660040361047f57600154600054604080516101009092046001600160a01b031660248084019190915281518084039091018152604490920181526020820180516317066a5760e21b6001600160e01b03909116179052516110019291610437916107ad565b60006040518083038185875af1925050503d8060008114610474576040519150601f19603f3d011682016040523d82523d6000602084013e610479565b606091505b50909150505b600280549115156101000261ff0019909216919091179055565b6040516001600160a01b0383166024820152604481018290526000906110019062d2eb3f60e11b906064015b60408051601f198184030181529181526020820180516001600160e01b03166001600160e01b031990941693909317909252905161050391906107ad565b6000604051808303816000865af19150503d8060008114610540576040519150601f19603f3d011682016040523d82523d6000602084013e610545565b606091505b505090508061055357600080fd5b505050565b6040516001600160a01b03831660248201528115156044820152600090611001906217c18360e91b906064016104c5565b604080516001600160a01b03831660248083019190915282518083039091018152604490910182526020810180516001600160e01b03166317066a5760e21b17905290516000916110019134916105df916107ad565b60006040518083038185875af1925050503d806000811461061c576040519150601f19603f3d011682016040523d82523d6000602084013e610621565b606091505b505090508061062f57600080fd5b5050565b604080516001600160a01b03831660248083019190915282518083039091018152604490910182526020810180516001600160e01b031663254f0da360e21b17905290516000916110019161068891906107ad565b6000604051808303816000865af19150503d806000811461061c576040519150601f19603f3d011682016040523d82523d6000602084013e610621565b80356001600160a01b03811681146106dc57600080fd5b919050565b600080604083850312156106f457600080fd5b6106fd836106c5565b946020939093013593505050565b6000806040838503121561071e57600080fd5b610727836106c5565b91506020830135801515811461073c57600080fd5b809150509250929050565b60006020828403121561075957600080fd5b610762826106c5565b9392505050565b60008060006060848603121561077e57600080fd5b833560ff8116811461078f57600080fd5b925061079d602085016106c5565b9150604084013590509250925092565b6000825160005b818110156107ce57602081860181015185830152016107b4565b50600092019182525091905056fea2646970667358221220b8e609baa2397c762c86851e83c219ebf23fdf822fa0bd2874b287a82fc4b09564736f6c63430008130033` + +const stakingV2ReentrantDelegatorABI = `[{"stateMutability":"payable","type":"fallback"},{"inputs":[],"name":"amount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"attempted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint8","name":"mode_","type":"uint8"},{"internalType":"address","name":"validator_","type":"address"},{"internalType":"uint256","name":"amount_","type":"uint256"}],"name":"configure","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator_","type":"address"}],"name":"delegate","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"mode","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"reentrySucceeded","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validator_","type":"address"},{"internalType":"bool","name":"active","type":"bool"}],"name":"setDelegationActive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"validator_","type":"address"}],"name":"unstakeDelegation","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"validator","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"validator_","type":"address"},{"internalType":"uint256","name":"amount_","type":"uint256"}],"name":"withdrawDelegation","outputs":[],"stateMutability":"nonpayable","type":"function"},{"stateMutability":"payable","type":"receive"}]` + +var stakingV2ReentrantDelegatorParsedABI = abi.MustNewABI(stakingV2ReentrantDelegatorABI) + +const ( + stakingV2ReentrantDelegatorGasLimit uint64 = framework.DefaultGasLimit + + stakingV2ReentryModeWithdraw uint8 = 1 + stakingV2ReentryModeUnstake uint8 = 2 +) + +func deployStakingV2ReentrantDelegator(t *testing.T, srv *framework.TestServer, from types.Address, key *ecdsa.PrivateKey) types.Address { + t.Helper() + + bytecode, err := hex.DecodeString(stakingV2ReentrantDelegatorBytecode) + require.NoError(t, err) + + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + receipt, err := srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + GasPrice: framework.TestGasPrice(), + Gas: stakingV2ReentrantDelegatorGasLimit, + Value: big.NewInt(0), + Input: bytecode, + }, key) + require.NoError(t, err) + require.NotNil(t, receipt) + require.Equal(t, uint64(types.ReceiptSuccess), receipt.Status) + require.NotEqual(t, ethgo.ZeroAddress, receipt.ContractAddress) + + return types.Address(receipt.ContractAddress) +} + +func sendStakingV2ReentrantDelegatorTx( + srv *framework.TestServer, + from types.Address, + key *ecdsa.PrivateKey, + contract types.Address, + method string, + value *big.Int, + args map[string]interface{}, +) (*ethgo.Receipt, error) { + m := stakingV2ReentrantDelegatorParsedABI.Methods[method] + if m == nil { + return nil, errors.New("reentrant delegator ABI missing " + method) + } + inp, err := m.Inputs.Encode(args) + if err != nil { + return nil, err + } + ctx, cancel := context.WithTimeout(context.Background(), framework.DefaultTimeout) + defer cancel() + + return srv.SendRawTx(ctx, &framework.PreparedTransaction{ + From: from, + To: &contract, + GasPrice: framework.TestGasPrice(), + Gas: stakingV2ReentrantDelegatorGasLimit, + Value: value, + Input: append(m.ID(), inp...), + }, key) +} + +func queryStakingV2ReentrantDelegatorBool(srv *framework.TestServer, from, contract types.Address, method string) (bool, error) { + m := stakingV2ReentrantDelegatorParsedABI.Methods[method] + if m == nil { + return false, errors.New("reentrant delegator ABI missing " + method) + } + to := ethgo.Address(contract) + resp, err := srv.JSONRPC().Eth().Call(ðgo.CallMsg{ + From: ethgo.Address(from), + To: &to, + Data: m.ID(), + GasPrice: framework.TestGasPriceUint64(), + Value: big.NewInt(0), + }, ethgo.Latest) + if err != nil { + return false, err + } + b, err := hex.DecodeHex(resp) + if err != nil { + return false, err + } + decoded, err := m.Outputs.Decode(b) + if err != nil { + return false, err + } + root, ok := decoded.(map[string]interface{}) + if !ok { + return false, errors.New("reentrant delegator bool decode root") + } + value, ok := root["0"].(bool) + if !ok { + return false, errors.New("reentrant delegator bool decode value") + } + + return value, nil +} diff --git a/e2e/pos_test.go b/e2e/pos_test.go deleted file mode 100644 index 2412b1c..0000000 --- a/e2e/pos_test.go +++ /dev/null @@ -1,917 +0,0 @@ -package e2e - -import ( - "context" - "crypto/ecdsa" - "fmt" - "math/big" - "strconv" - "testing" - "time" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - "github.com/umbracle/ethgo" - "github.com/umbracle/ethgo/jsonrpc" - - "github.com/golang/protobuf/ptypes/any" - "github.com/xgr-network/xgr-node/chain" - ibftOp "github.com/xgr-network/xgr-node/consensus/ibft/proto" - "github.com/xgr-network/xgr-node/contracts/staking" - "github.com/xgr-network/xgr-node/crypto" - "github.com/xgr-network/xgr-node/e2e/framework" - "github.com/xgr-network/xgr-node/helper/common" - stakingHelper "github.com/xgr-network/xgr-node/helper/staking" - "github.com/xgr-network/xgr-node/helper/tests" - txpoolOp "github.com/xgr-network/xgr-node/txpool/proto" - "github.com/xgr-network/xgr-node/types" -) - -// foundInValidatorSet is a helper function for searching through the passed in set for a specific -// address -func foundInValidatorSet(validatorSet []types.Address, searchValidator types.Address) bool { - searchStr := searchValidator.String() - for _, validator := range validatorSet { - if validator.String() == searchStr { - return true - } - } - - return false -} - -// getBigDefaultStakedBalance returns the default staked balance as a *big.Int -func getBigDefaultStakedBalance(t *testing.T) *big.Int { - t.Helper() - - val := stakingHelper.DefaultStakedBalance - bigDefaultStakedBalance, err := common.ParseUint256orHex(&val) - - if err != nil { - t.Fatalf("unable to parse DefaultStakedBalance, %v", err) - } - - return bigDefaultStakedBalance -} - -// validateValidatorSet makes sure that the address is present / not present in the -// validator set, as well as if the validator set is of a certain size -func validateValidatorSet( - t *testing.T, - address types.Address, - client *jsonrpc.Client, - expectedExistence bool, - expectedSize int, -) { - t.Helper() - - validatorSet, validatorSetErr := framework.GetValidatorSet(address, client) - if validatorSetErr != nil { - t.Fatalf("Unable to fetch validator set, %v", validatorSetErr) - } - - assert.NotNil(t, validatorSet) - assert.Len(t, validatorSet, expectedSize) - - if expectedExistence { - assert.Truef( - t, - foundInValidatorSet(validatorSet, address), - "expected address to be present in the validator set", - ) - } else { - assert.Falsef(t, - foundInValidatorSet(validatorSet, address), - "expected address to not be present in the validator set", - ) - } -} - -func TestPoS_ValidatorBoundaries(t *testing.T) { - accounts := []struct { - key *ecdsa.PrivateKey - address types.Address - }{} - stakeAmount := framework.EthToWei(1) - numGenesisValidators := IBFTMinNodes - minValidatorCount := uint64(1) - maxValidatorCount := uint64(numGenesisValidators + 1) - numNewStakers := 2 - - for i := 0; i < numNewStakers; i++ { - k, a := tests.GenerateKeyAndAddr(t) - - accounts = append(accounts, struct { - key *ecdsa.PrivateKey - address types.Address - }{ - key: k, - address: a, - }) - } - - defaultBalance := framework.EthToWei(100) - ibftManager := framework.NewIBFTServersManager( - t, - numGenesisValidators, - IBFTDirPrefix, - func(i int, config *framework.TestServerConfig) { - config.SetEpochSize(2) - config.PremineValidatorBalance(defaultBalance) - for j := 0; j < numNewStakers; j++ { - config.Premine(accounts[j].address, defaultBalance) - } - config.SetIBFTPoS(true) - config.SetMinValidatorCount(minValidatorCount) - config.SetMaxValidatorCount(maxValidatorCount) - }) - - t.Cleanup(func() { - ibftManager.StopServers() - }) - - ctx, cancel := context.WithTimeout(context.Background(), time.Minute) - defer cancel() - ibftManager.StartServers(ctx) - - srv := ibftManager.GetServer(0) - - client := srv.JSONRPC() - - testCases := []struct { - name string - address types.Address - key *ecdsa.PrivateKey - expectedExistence bool - expectedSize int - }{ - { - name: "Can add a 5th validator", - address: accounts[0].address, - key: accounts[0].key, - expectedExistence: true, - expectedSize: numGenesisValidators + 1, - }, - { - name: "Can not add a 6th validator", - address: accounts[1].address, - key: accounts[1].key, - expectedExistence: false, - expectedSize: numGenesisValidators + 1, - }, - } - - for _, tt := range testCases { - t.Run(tt.name, func(t *testing.T) { - err := framework.StakeAmount(tt.address, tt.key, stakeAmount, srv) - assert.NoError(t, err) - validateValidatorSet(t, tt.address, client, tt.expectedExistence, tt.expectedSize) - }) - } -} - -func TestPoS_Stake(t *testing.T) { - stakerKey, stakerAddr := tests.GenerateKeyAndAddr(t) - defaultBalance := framework.EthToWei(100) - stakeAmount := framework.EthToWei(5) - - numGenesisValidators := IBFTMinNodes - ibftManager := framework.NewIBFTServersManager( - t, - numGenesisValidators, - IBFTDirPrefix, - func(i int, config *framework.TestServerConfig) { - config.SetEpochSize(2) // Need to leave room for the endblock - config.PremineValidatorBalance(defaultBalance) - config.Premine(stakerAddr, defaultBalance) - config.SetIBFTPoS(true) - }) - - t.Cleanup(func() { - ibftManager.StopServers() - }) - - ctx, cancel := context.WithTimeout(context.Background(), time.Minute) - defer cancel() - ibftManager.StartServers(ctx) - - srv := ibftManager.GetServer(0) - - client := srv.JSONRPC() - - // Stake Balance - stakeError := framework.StakeAmount( - stakerAddr, - stakerKey, - stakeAmount, - srv, - ) - if stakeError != nil { - t.Fatalf("Unable to stake amount, %v", stakeError) - } - - // Check validator set - validateValidatorSet(t, stakerAddr, client, true, numGenesisValidators+1) - - // Check the SC balance - bigDefaultStakedBalance := getBigDefaultStakedBalance(t) - - scBalance := framework.GetAccountBalance(t, staking.AddrStakingContract, client) - expectedBalance := big.NewInt(0).Mul( - bigDefaultStakedBalance, - big.NewInt(int64(numGenesisValidators)), - ) - expectedBalance.Add(expectedBalance, stakeAmount) - - assert.Equal(t, expectedBalance.String(), scBalance.String()) - - stakedAmount, stakedAmountErr := framework.GetStakedAmount(stakerAddr, client) - if stakedAmountErr != nil { - t.Fatalf("Unable to get staked amount, %v", stakedAmountErr) - } - - assert.Equal(t, expectedBalance.String(), stakedAmount.String()) -} - -func TestPoS_Unstake(t *testing.T) { - stakingContractAddr := staking.AddrStakingContract - defaultBalance := framework.EthToWei(100) - - // The last genesis validator will leave from validator set by unstaking - numGenesisValidators := IBFTMinNodes + 1 - ibftManager := framework.NewIBFTServersManager( - t, - numGenesisValidators, - IBFTDirPrefix, - func(_ int, config *framework.TestServerConfig) { - // Premine to send unstake transaction - config.SetEpochSize(2) // Need to leave room for the endblock - config.PremineValidatorBalance(defaultBalance) - config.SetIBFTPoS(true) - }) - - t.Cleanup(func() { - ibftManager.StopServers() - }) - - ctx, cancel := context.WithTimeout(context.Background(), time.Minute) - defer cancel() - ibftManager.StartServers(ctx) - srv := ibftManager.GetServer(0) - - // Get key of last node - unstakerSrv := ibftManager.GetServer(IBFTMinNodes) - unstakerKey, err := unstakerSrv.Config.PrivateKey() - assert.NoError(t, err) - - unstakerAddr := crypto.PubKeyToAddress(&unstakerKey.PublicKey) - - client := srv.JSONRPC() - - // Check the validator is in validator set - validateValidatorSet(t, unstakerAddr, client, true, numGenesisValidators) - - // Send transaction to unstake - receipt, unstakeError := framework.UnstakeAmount( - unstakerAddr, - unstakerKey, - srv, - ) - if unstakeError != nil { - t.Fatalf("Unable to unstake amount, %v", unstakeError) - } - - // Check validator set - validateValidatorSet(t, unstakerAddr, client, false, numGenesisValidators-1) - - // Check the SC balance - bigDefaultStakedBalance := getBigDefaultStakedBalance(t) - - scBalance := framework.GetAccountBalance(t, staking.AddrStakingContract, client) - expectedBalance := big.NewInt(0).Mul( - bigDefaultStakedBalance, - big.NewInt(int64(numGenesisValidators)), - ) - expectedBalance.Sub(expectedBalance, bigDefaultStakedBalance) - - assert.Equal(t, expectedBalance.String(), scBalance.String()) - - stakedAmount, stakedAmountErr := framework.GetStakedAmount(stakingContractAddr, client) - if stakedAmountErr != nil { - t.Fatalf("Unable to get staked amount, %v", stakedAmountErr) - } - - assert.Equal(t, expectedBalance.String(), stakedAmount.String()) - - // Check the address balance - fee := new(big.Int).Mul( - big.NewInt(int64(receipt.GasUsed)), - framework.TestGasPrice(), - ) - - accountBalance := framework.GetAccountBalance(t, unstakerAddr, client) - expectedAccountBalance := big.NewInt(0).Add(defaultBalance, bigDefaultStakedBalance) - expectedAccountBalance.Sub(expectedAccountBalance, fee) - - assert.Equal(t, expectedAccountBalance.String(), accountBalance.String()) -} - -// Test scenario: -// User has 10 ETH staked and a balance of 10 ETH -// Unstake -> Unstake -> Unstake -> Unstake... -// The code below tests numTransactions cycles of Unstake -// Expected result for tests: Staked: 0 ETH; Balance: ~20 ETH -func TestPoS_UnstakeExploit(t *testing.T) { - // Predefined values - stakingContractAddr := staking.AddrStakingContract - - senderKey, senderAddr := tests.GenerateKeyAndAddr(t) - bigDefaultStakedBalance := getBigDefaultStakedBalance(t) - defaultBalance := framework.EthToWei(100) - bigGasPrice := framework.TestGasPrice() - - devInterval := 5 // s - numDummyValidators := 5 - - // Set up the test server - srvs := framework.NewTestServers(t, 1, func(config *framework.TestServerConfig) { - config.SetConsensus(framework.ConsensusDev) - config.SetDevInterval(devInterval) - config.Premine(senderAddr, defaultBalance) - config.SetDevStakingAddresses(append(generateStakingAddresses(numDummyValidators), senderAddr)) - config.SetIBFTPoS(true) - config.SetBlockLimit(5000000000) - }) - srv := srvs[0] - client := srv.JSONRPC() - - previousAccountBalance := framework.GetAccountBalance(t, senderAddr, client) - - // Check if the stake is present on the SC - actualStakingSCBalance, fetchError := framework.GetStakedAmount(senderAddr, client) - if fetchError != nil { - t.Fatalf("Unable to fetch staking SC balance, %v", fetchError) - } - - assert.Equalf(t, - big.NewInt(0).Mul(bigDefaultStakedBalance, big.NewInt(int64(numDummyValidators+1))).String(), - actualStakingSCBalance.String(), - "Staked address balance mismatch before unstake exploit", - ) - - // Required default values - numTransactions := 5 - signer := crypto.NewSigner(chain.AllForksEnabled.At(0), 100) - currentNonce := 0 - - // TxPool client - clt := srv.TxnPoolOperator() - - generateTx := func(i int) *types.Transaction { - unsignedTx := &types.Transaction{ - Nonce: uint64(currentNonce), - From: types.ZeroAddress, - To: &stakingContractAddr, - Gas: framework.DefaultGasLimit, - Value: big.NewInt(0), - V: big.NewInt(1), // it is necessary to encode in rlp, - Input: framework.MethodSig("unstake"), - } - - // Just make very second transaction with dynamic gas fee - if i%2 == 0 { - unsignedTx.Type = types.DynamicFeeTx - unsignedTx.ChainID = big.NewInt(100) - unsignedTx.GasFeeCap = bigGasPrice - unsignedTx.GasTipCap = bigGasPrice - } else { - unsignedTx.Type = types.LegacyTx - unsignedTx.GasPrice = bigGasPrice - } - - signedTx, err := signer.SignTx(unsignedTx, senderKey) - require.NoError(t, err, "Unable to sign transaction") - - currentNonce++ - - return signedTx - } - - txHashes := make([]ethgo.Hash, 0) - - for i := 0; i < numTransactions; i++ { - var msg *txpoolOp.AddTxnReq - - unstakeTxn := generateTx(i) - - msg = &txpoolOp.AddTxnReq{ - Raw: &any.Any{ - Value: unstakeTxn.MarshalRLP(), - }, - From: types.ZeroAddress.String(), - } - - addCtx, addCtxCn := context.WithTimeout(context.Background(), framework.DefaultTimeout) - - addResp, addErr := clt.AddTxn(addCtx, msg) - if addErr != nil { - t.Fatalf("Unable to add txn, %v", addErr) - } - - txHashes = append(txHashes, ethgo.HexToHash(addResp.TxHash)) - - addCtxCn() - } - - // Wait for the transactions to go through - totalGasUsed := srv.GetGasTotal(txHashes) - - // Find how much the address paid for all the transactions in this block - paidFee := big.NewInt(0).Mul(bigGasPrice, big.NewInt(int64(totalGasUsed))) - - // Check the balances - actualAccountBalance := framework.GetAccountBalance(t, senderAddr, client) - actualStakingSCBalance, fetchError = framework.GetStakedAmount(senderAddr, client) - - if fetchError != nil { - t.Fatalf("Unable to fetch staking SC balance, %v", fetchError) - } - - // Make sure the balances match up - - // expBalance = previousAccountBalance + stakeRefund - block fees - expBalance := big.NewInt(0).Sub(big.NewInt(0).Add(previousAccountBalance, bigDefaultStakedBalance), paidFee) - - assert.Equalf(t, - expBalance.String(), - actualAccountBalance.String(), - "Account balance mismatch after unstake exploit", - ) - - assert.Equalf(t, - big.NewInt(0).Mul(bigDefaultStakedBalance, big.NewInt(int64(numDummyValidators))).String(), - actualStakingSCBalance.String(), - "Staked address balance mismatch after unstake exploit", - ) -} - -// generateStakingAddresses is a helper method for generating dummy staking addresses -func generateStakingAddresses(numAddresses int) []types.Address { - result := make([]types.Address, numAddresses) - - for i := 0; i < numAddresses; i++ { - result[i] = types.StringToAddress(strconv.Itoa(i + 100)) - } - - return result -} - -// Test scenario: -// User has 10 ETH staked and a balance of 100 ETH -// Unstake -> Stake 1 ETH -> Unstake -> Stake 1 ETH... -// The code below tests (numTransactions / 2) cycles of Unstake -> Stake 1 ETH -// Expected result for tests: Staked: 1 ETH; Balance: ~119 ETH -func TestPoS_StakeUnstakeExploit(t *testing.T) { - // Predefined values - var blockGasLimit uint64 = 5000000000 - - stakingContractAddr := staking.AddrStakingContract - bigDefaultStakedBalance := getBigDefaultStakedBalance(t) - defaultBalance := framework.EthToWei(100) - bigGasPrice := framework.TestGasPrice() - - senderKey, senderAddr := tests.GenerateKeyAndAddr(t) - numDummyStakers := 100 - - devInterval := 5 // s - - // Set up the test server - srvs := framework.NewTestServers(t, 1, func(config *framework.TestServerConfig) { - config.SetConsensus(framework.ConsensusDev) - config.SetDevInterval(devInterval) - config.Premine(senderAddr, defaultBalance) - config.SetBlockLimit(blockGasLimit) - config.SetIBFTPoS(true) - // This call will add numDummyStakers + 1 staking address to the staking SC. - // This is done in order to pump the stakedAmount value on the staking SC - config.SetDevStakingAddresses(append(generateStakingAddresses(numDummyStakers), senderAddr)) - }) - srv := srvs[0] - client := srv.JSONRPC() - - initialStakingSCBalance, fetchError := framework.GetStakedAmount(senderAddr, client) - if fetchError != nil { - t.Fatalf("Unable to fetch staking SC balance, %v", fetchError) - } - - assert.Equalf(t, - (big.NewInt(0).Mul(big.NewInt(int64(numDummyStakers+1)), bigDefaultStakedBalance)).String(), - initialStakingSCBalance.String(), - "Staked address balance mismatch before stake / unstake exploit", - ) - - // Required default values - numTransactions := 6 - signer := crypto.NewSigner(chain.AllForksEnabled.At(0), 100) - currentNonce := 0 - - // TxPool client - txpoolClient := srv.TxnPoolOperator() - - generateTx := func(i int, value *big.Int, methodName string) *types.Transaction { - unsignedTx := &types.Transaction{ - Nonce: uint64(currentNonce), - From: types.ZeroAddress, - To: &stakingContractAddr, - Gas: framework.DefaultGasLimit, - Value: value, - V: big.NewInt(1), // it is necessary to encode in rlp - Input: framework.MethodSig(methodName), - } - - // Just make very second transaction with dynamic gas fee - if i%2 == 0 { - unsignedTx.Type = types.DynamicFeeTx - unsignedTx.ChainID = big.NewInt(100) - unsignedTx.GasFeeCap = bigGasPrice - unsignedTx.GasTipCap = bigGasPrice - } else { - unsignedTx.Type = types.LegacyTx - unsignedTx.GasPrice = bigGasPrice - } - - signedTx, err := signer.SignTx(unsignedTx, senderKey) - require.NoError(t, err, "Unable to sign transaction") - - currentNonce++ - - return signedTx - } - - oneEth := framework.EthToWei(1) - zeroEth := framework.EthToWei(0) - txHashes := make([]ethgo.Hash, 0) - - for i := 0; i < numTransactions; i++ { - var msg *txpoolOp.AddTxnReq - - if i%2 == 0 { - unstakeTxn := generateTx(i, zeroEth, "unstake") - msg = &txpoolOp.AddTxnReq{ - Raw: &any.Any{ - Value: unstakeTxn.MarshalRLP(), - }, - From: types.ZeroAddress.String(), - } - } else { - stakeTxn := generateTx(i, oneEth, "stake") - msg = &txpoolOp.AddTxnReq{ - Raw: &any.Any{ - Value: stakeTxn.MarshalRLP(), - }, - From: types.ZeroAddress.String(), - } - } - - addResp, addErr := txpoolClient.AddTxn(context.Background(), msg) - if addErr != nil { - t.Fatalf("Unable to add txn, %v", addErr) - } - - txHashes = append(txHashes, ethgo.HexToHash(addResp.TxHash)) - } - - // Set up the blockchain listener to catch the added block event - totalGasUsed := srv.GetGasTotal(txHashes) - - // Find how much the address paid for all the transactions in this block - paidFee := big.NewInt(0).Mul(bigGasPrice, big.NewInt(int64(totalGasUsed))) - - // Check the balances - actualAccountBalance := framework.GetAccountBalance(t, senderAddr, client) - actualStakingSCBalance, fetchError := framework.GetStakedAmount(senderAddr, client) - - if fetchError != nil { - t.Fatalf("Unable to fetch staking SC balance, %v", fetchError) - } - - expStake := big.NewInt(0).Mul(big.NewInt(int64(numDummyStakers)), bigDefaultStakedBalance) - expStake.Add(expStake, oneEth) - - assert.Equalf(t, - expStake.String(), - actualStakingSCBalance.String(), - "Staked address balance mismatch after stake / unstake exploit", - ) - - // Make sure the address balances match up - - // expBalance = previousAccountBalance + stakeRefund - 1 ETH - block fees - expBalance := big.NewInt(0).Sub(big.NewInt(0).Add(defaultBalance, bigDefaultStakedBalance), oneEth) - expBalance = big.NewInt(0).Sub(expBalance, paidFee) - - assert.Equalf(t, - expBalance.String(), - actualAccountBalance.String(), - "Account balance mismatch after stake / unstake exploit", - ) -} - -// Test scenario: -// User has 0 ETH staked and a balance of 100 ETH -// Stake 2 ETH -> Unstake -// Expected result for tests: Staked: 0 ETH; Balance: ~100 ETH; not a validator -func TestPoS_StakeUnstakeWithinSameBlock(t *testing.T) { - // Predefined values - var blockGasLimit uint64 = 5000000000 - - stakingContractAddr := staking.AddrStakingContract - defaultBalance := framework.EthToWei(100) - bigGasPrice := framework.TestGasPrice() - - senderKey, senderAddr := tests.GenerateKeyAndAddr(t) - numDummyStakers := 10 - - devInterval := 5 // s - - // Set up the test server - srvs := framework.NewTestServers(t, 1, func(config *framework.TestServerConfig) { - config.SetConsensus(framework.ConsensusDev) - config.SetDevInterval(devInterval) - config.Premine(senderAddr, defaultBalance) - config.SetBlockLimit(blockGasLimit) - config.SetDevStakingAddresses(generateStakingAddresses(numDummyStakers)) - config.SetIBFTPoS(true) - }) - srv := srvs[0] - client := srv.JSONRPC() - - initialStakingSCBalance, fetchError := framework.GetStakedAmount(senderAddr, client) - if fetchError != nil { - t.Fatalf("Unable to fetch staking SC balance, %v", fetchError) - } - - // Required default values - signer := crypto.NewSigner(chain.AllForksEnabled.At(0), 100) - currentNonce := 0 - - // TxPool client - txpoolClient := srv.TxnPoolOperator() - - generateTx := func(dynamicTx bool, value *big.Int, methodName string) *types.Transaction { - unsignedTx := &types.Transaction{ - Nonce: uint64(currentNonce), - From: types.ZeroAddress, - To: &stakingContractAddr, - Gas: framework.DefaultGasLimit, - Value: value, - V: big.NewInt(1), // it is necessary to encode in rlp - Input: framework.MethodSig(methodName), - } - - if dynamicTx { - unsignedTx.Type = types.DynamicFeeTx - unsignedTx.ChainID = big.NewInt(100) - unsignedTx.GasFeeCap = bigGasPrice - unsignedTx.GasTipCap = bigGasPrice - } else { - unsignedTx.Type = types.LegacyTx - unsignedTx.GasPrice = bigGasPrice - } - - signedTx, err := signer.SignTx(unsignedTx, senderKey) - require.NoError(t, err, "Unable to signatransaction") - - currentNonce++ - - return signedTx - } - - zeroEth := framework.EthToWei(0) - txHashes := make([]ethgo.Hash, 0) - - // addTxn is a helper method for generating and adding a transaction - // through the operator command - addTxn := func(dynamicTx bool, value *big.Int, methodName string) { - txn := generateTx(dynamicTx, value, methodName) - txnMsg := &txpoolOp.AddTxnReq{ - Raw: &any.Any{ - Value: txn.MarshalRLP(), - }, - From: types.ZeroAddress.String(), - } - - addResp, addErr := txpoolClient.AddTxn(context.Background(), txnMsg) - if addErr != nil { - t.Fatalf("Unable to add txn, %v", addErr) - } - - txHashes = append(txHashes, ethgo.HexToHash(addResp.TxHash)) - } - - // Stake transaction - addTxn(false, oneEth, "stake") - - // Unstake transaction - addTxn(true, zeroEth, "unstake") - - // Wait for the transactions to go through - totalGasUsed := srv.GetGasTotal(txHashes) - - // Find how much the address paid for all the transactions in this block - paidFee := big.NewInt(0).Mul(bigGasPrice, big.NewInt(int64(totalGasUsed))) - - // Check the balances - actualAccountBalance := framework.GetAccountBalance(t, senderAddr, client) - actualStakingSCBalance, fetchError := framework.GetStakedAmount(senderAddr, client) - - if fetchError != nil { - t.Fatalf("Unable to fetch staking SC balance, %v", fetchError) - } - - assert.Equalf(t, - initialStakingSCBalance.String(), - actualStakingSCBalance.String(), - "Staked address balance mismatch after stake / unstake events", - ) - - // Make sure the address balances match up - - // expBalance = previousAccountBalance - block fees - expBalance := big.NewInt(0).Sub(defaultBalance, paidFee) - - assert.Equalf(t, - expBalance.String(), - actualAccountBalance.String(), - "Account balance mismatch after stake / unstake events", - ) - - validateValidatorSet(t, senderAddr, client, false, numDummyStakers) -} - -func getSnapshot( - client ibftOp.IbftOperatorClient, - blockNum uint64, - ctx context.Context, -) (*ibftOp.Snapshot, error) { - snapshot, snapshotErr := client.GetSnapshot(ctx, &ibftOp.SnapshotReq{ - Latest: false, - Number: blockNum, - }) - - return snapshot, snapshotErr -} - -func getNextEpochBlock(blockNum uint64, epochSize uint64) uint64 { - if epochSize > blockNum { - return epochSize - } - - return epochSize*(blockNum/epochSize) + epochSize -} - -func TestSnapshotUpdating(t *testing.T) { - faucetKey, faucetAddr := tests.GenerateKeyAndAddr(t) - - defaultBalance := framework.EthToWei(1000) - stakeAmount := framework.EthToWei(5) - epochSize := uint64(5) - - numGenesisValidators := IBFTMinNodes - numNonValidators := 2 - totalServers := numGenesisValidators + numNonValidators - - ibftManager := framework.NewIBFTServersManager( - t, - totalServers, - IBFTDirPrefix, - func(i int, config *framework.TestServerConfig) { - if i < numGenesisValidators { - // Only IBFTMinNodes should be validators - config.PremineValidatorBalance(defaultBalance) - } else { - // Other nodes should not be in the validator set - dirPrefix := "polygon-edge-non-validator-" - config.SetIBFTDirPrefix(dirPrefix) - config.SetIBFTDir(fmt.Sprintf("%s%d", dirPrefix, i)) - } - - config.SetEpochSize(epochSize) - config.Premine(faucetAddr, defaultBalance) - config.SetIBFTPoS(true) - }) - - ctx, cancel := context.WithTimeout(context.Background(), time.Minute) - defer cancel() - ibftManager.StartServers(ctx) - firstValidator := ibftManager.GetServer(0) - - // Make sure the non-validator has funds before staking - firstNonValidator := ibftManager.GetServer(IBFTMinNodes) - firstNonValidatorKey, err := firstNonValidator.Config.PrivateKey() - assert.NoError(t, err) - - firstNonValidatorAddr := crypto.PubKeyToAddress(&firstNonValidatorKey.PublicKey) - - sendCtx, sendWaitFn := context.WithTimeout(context.Background(), time.Second*30) - defer sendWaitFn() - - receipt, transferErr := firstValidator.SendRawTx( - sendCtx, - &framework.PreparedTransaction{ - From: faucetAddr, - To: &firstNonValidatorAddr, - GasPrice: framework.TestGasPrice(), - Gas: 1000000, - Value: framework.EthToWei(300), - }, faucetKey) - if transferErr != nil { - t.Fatalf("Unable to transfer funds, %v", transferErr) - } - - // Now that the non-validator has funds, they can stake - stakeError := framework.StakeAmount( - firstNonValidatorAddr, - firstNonValidatorKey, - stakeAmount, - firstValidator, - ) - - if stakeError != nil { - t.Fatalf("Unable to stake amount, %v", stakeError) - } - - // Check validator set on the Staking Smart Contract - validateValidatorSet(t, firstNonValidatorAddr, firstValidator.JSONRPC(), true, numGenesisValidators+1) - - // Find the nearest next epoch block - nextEpoch := getNextEpochBlock(receipt.BlockNumber, epochSize) + epochSize - - servers := make([]*framework.TestServer, 0) - for i := 0; i < totalServers; i++ { - servers = append(servers, ibftManager.GetServer(i)) - } - - // Wait for all the nodes to reach the epoch block - waitErrors := framework.WaitForServersToSeal(servers, nextEpoch+1) - - if len(waitErrors) != 0 { - t.Fatalf("Unable to wait for all nodes to seal blocks, %v", waitErrors) - } - - // Grab all the operators - serverOperators := make([]ibftOp.IbftOperatorClient, totalServers) - for i := 0; i < totalServers; i++ { - serverOperators[i] = ibftManager.GetServer(i).IBFTOperator() - } - - // isValidatorInSnapshot checks if a certain reference address - // is among the validators for the specific snapshot - isValidatorInSnapshot := func( - client ibftOp.IbftOperatorClient, - blockNumber uint64, - referenceAddr types.Address, - ) bool { - snapshotCtx, ctxCancelFn := context.WithTimeout(context.Background(), time.Second*5) - snapshot, snapshotErr := getSnapshot(client, blockNumber, snapshotCtx) - - if snapshotErr != nil { - t.Fatalf("Unable to fetch snapshot, %v", snapshotErr) - } - - ctxCancelFn() - - for _, validator := range snapshot.Validators { - if types.BytesToAddress(validator.Data) == referenceAddr { - return true - } - } - - return false - } - - // Make sure every node in the network has good snapshot upkeep - for i := 0; i < totalServers; i++ { - // Check the snapshot before the node became a validator - assert.Falsef( - t, - isValidatorInSnapshot(serverOperators[i], nextEpoch-1, firstNonValidatorAddr), - fmt.Sprintf( - "Validator [%s] is in the snapshot validator list for block %d", - firstNonValidatorAddr, - nextEpoch-1, - ), - ) - - // Check the snapshot after the node became a validator - assert.Truef( - t, - isValidatorInSnapshot(serverOperators[i], nextEpoch+1, firstNonValidatorAddr), - fmt.Sprintf( - "Validator [%s] is not in the snapshot validator list for block %d", - firstNonValidatorAddr, - nextEpoch+1, - ), - ) - } -} diff --git a/e2e/transaction_test.go b/e2e/transaction_test.go index d5659bc..56ab4c4 100644 --- a/e2e/transaction_test.go +++ b/e2e/transaction_test.go @@ -72,7 +72,7 @@ func TestPreminedBalance(t *testing.T) { t.Run(testCase.name, func(t *testing.T) { balance, err := rpcClient.Eth().GetBalance(ethgo.Address(testCase.address), ethgo.Latest) assert.NoError(t, err) - assert.Equal(t, testCase.balance, balance) + assert.Equal(t, 0, balance.Cmp(testCase.balance)) }) } } diff --git a/go.mod b/go.mod index 11c7527..2daa9fe 100644 --- a/go.mod +++ b/go.mod @@ -1,4 +1,5 @@ module github.com/xgr-network/xgr-node + // NOTE: // xgrchain must build standalone even if the private ../xgrEngine repo is absent. // Therefore, we replace xgrEngine with a repo-local stub module by default. @@ -254,3 +255,5 @@ require ( ) replace github.com/xgr-network/xgrEngine => ./xgrEngine + +replace github.com/0xPolygon/go-ibft => github.com/xgr-network/go-ibft v0.0.0-20260501091827-652ddc3bf3c1 diff --git a/go.sum b/go.sum index f860c5e..62d7912 100644 --- a/go.sum +++ b/go.sum @@ -706,6 +706,14 @@ github.com/viant/assertly v0.4.8/go.mod h1:aGifi++jvCrUaklKEKT0BU95igDNaqkvz+49u github.com/viant/toolbox v0.24.0/go.mod h1:OxMCG57V0PXuIP2HNQrtJf2CjqdmbrOx5EkMILuUhzM= github.com/vishvananda/netlink v1.1.0/go.mod h1:cTgwzPIzzgDAYoQrMm0EdrjRUBkTqKYppBueQtXaqoE= github.com/vishvananda/netns v0.0.0-20191106174202-0a2b9b5464df/go.mod h1:JP3t17pCcGlemwknint6hfoeCVQrEMVwxRLRjXpq+BU= +github.com/xgr-network/go-ibft v0.0.0-20260403082038-0dc8c3b9d5fe h1:cFCCaCWiI3aA0JrbwqqOIIIvlSwKT9okVYm9zuRYBHE= +github.com/xgr-network/go-ibft v0.0.0-20260403082038-0dc8c3b9d5fe/go.mod h1:FPdz+s0jyQzW4pZK+HMnhz2b8ebsg5FaSVFTjvQi8ls= +github.com/xgr-network/go-ibft v0.0.0-20260406142847-339905dd34f5 h1:+upnAT4Z/7ySY+Jh90gpnoXOMuR0r3CPPp2EK8bgbxI= +github.com/xgr-network/go-ibft v0.0.0-20260406142847-339905dd34f5/go.mod h1:FPdz+s0jyQzW4pZK+HMnhz2b8ebsg5FaSVFTjvQi8ls= +github.com/xgr-network/go-ibft v0.0.0-20260409060202-6825e8ac7627 h1:u5VDzJHoYXfzvsR1DMs4PYGNKiD+SOBfhX+EbA5BS4o= +github.com/xgr-network/go-ibft v0.0.0-20260409060202-6825e8ac7627/go.mod h1:FPdz+s0jyQzW4pZK+HMnhz2b8ebsg5FaSVFTjvQi8ls= +github.com/xgr-network/go-ibft v0.0.0-20260501091827-652ddc3bf3c1 h1:WqAkgr4hYzG/wyQI0O8O2opGkTFgnvM8ABGvsZebt5M= +github.com/xgr-network/go-ibft v0.0.0-20260501091827-652ddc3bf3c1/go.mod h1:FPdz+s0jyQzW4pZK+HMnhz2b8ebsg5FaSVFTjvQi8ls= github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= github.com/yuin/goldmark v1.3.5/go.mod h1:mwnBkeHKe2W/ZEtQ+71ViKU8L12m81fl3OWwC1Zlc8k= diff --git a/helper/common/common.go b/helper/common/common.go index 97e806e..1ff7fc9 100644 --- a/helper/common/common.go +++ b/helper/common/common.go @@ -30,11 +30,8 @@ var ( errInvalidDuration = errors.New("invalid duration") - IBFTImportantNotice = "***** IMPORTANT NOTICE: IBFT consensus protocol is about to be" + - " removed from the Edge in the following release. *****\n" + - "Please migrate to the PolyBFT protocol and plan your activities accordingly.\n" + - "More information on how to execute the migration process can be found here" + - "(https://wiki.xgr.network/docs/edge/operate/ibft-to-polybft/)." + IBFTImportantNotice = "***** IMPORTANT NOTICE: configure and operate your IBFT network according to" + + " your deployment and governance requirements. *****" ) // RetryForever will execute a function until it completes without error or diff --git a/helper/secrets/secrets.go b/helper/secrets/secrets.go new file mode 100644 index 0000000..c573d11 --- /dev/null +++ b/helper/secrets/secrets.go @@ -0,0 +1,15 @@ +package secrets + +import ( + "github.com/xgr-network/xgr-node/secrets" + secretsHelper "github.com/xgr-network/xgr-node/secrets/helper" + "github.com/xgr-network/xgr-node/types" +) + +func InitCloudSecretsManager(secretsConfig *secrets.SecretsManagerConfig) (secrets.SecretsManager, error) { + return secretsHelper.InitCloudSecretsManager(secretsConfig) +} + +func InitECDSAValidatorKey(secretsManager secrets.SecretsManager) (types.Address, error) { + return secretsHelper.InitECDSAValidatorKey(secretsManager) +} diff --git a/helper/staking/staking.go b/helper/staking/staking.go index 01e889b..a9c3e9e 100644 --- a/helper/staking/staking.go +++ b/helper/staking/staking.go @@ -8,6 +8,7 @@ import ( "github.com/xgr-network/xgr-node/helper/common" "github.com/xgr-network/xgr-node/helper/hex" "github.com/xgr-network/xgr-node/helper/keccak" + "github.com/xgr-network/xgr-node/state" "github.com/xgr-network/xgr-node/types" "github.com/xgr-network/xgr-node/validators" ) @@ -51,32 +52,15 @@ func getStorageIndexes(validator validators.Validator, index int) *StorageIndexe storageIndexes := &StorageIndexes{} address := validator.Addr() - // Get the indexes for the mappings - // The index for the mapping is retrieved with: - // keccak(address . slot) - // . stands for concatenation (basically appending the bytes) - storageIndexes.AddressToIsValidatorIndex = getAddressMapping( - address, - addressToIsValidatorSlot, - ) - - storageIndexes.AddressToStakedAmountIndex = getAddressMapping( - address, - addressToStakedAmountSlot, - ) + // mapping(address => Staker) _staker is at slot 3 + stakerBase := getAddressMapping(address, stakerSlot) - storageIndexes.AddressToValidatorIndexIndex = getAddressMapping( - address, - addressToValidatorIndexSlot, - ) - - storageIndexes.ValidatorBLSPublicKeyIndex = getAddressMapping( - address, - addressToBLSPublicKeySlot, - ) + storageIndexes.StakerPackedIndex = stakerBase + storageIndexes.StakerAmountIndex = getIndexWithOffset(stakerBase, 1) + storageIndexes.StakerValidatorIndex = getIndexWithOffset(stakerBase, 4) + storageIndexes.StakerBlsPubKeyIndex = getIndexWithOffset(stakerBase, 5) - // Index for array types is calculated as keccak(slot) + index - // The slot for the dynamic arrays that's put in the keccak needs to be in hex form (padded 64 chars) + // _validators dynamic array is at slot 1 storageIndexes.ValidatorsIndex = getIndexWithOffset( keccak.Keccak256(nil, common.PadLeftOrTrim(big.NewInt(validatorsSlot).Bytes(), 32)), uint64(index), @@ -132,45 +116,75 @@ func setBytesToStorage( type PredeployParams struct { MinValidatorCount uint64 MaxValidatorCount uint64 + EpochSize uint64 } // StorageIndexes is a wrapper for different storage indexes that // need to be modified type StorageIndexes struct { - ValidatorsIndex []byte // []address - ValidatorBLSPublicKeyIndex []byte // mapping(address => byte[]) - AddressToIsValidatorIndex []byte // mapping(address => bool) - AddressToStakedAmountIndex []byte // mapping(address => uint256) - AddressToValidatorIndexIndex []byte // mapping(address => uint256) + ValidatorsIndex []byte // _validators[index] + StakerPackedIndex []byte // _staker[address].(exists,active,index packed) + StakerAmountIndex []byte // _staker[address].amount + StakerValidatorIndex []byte // _staker[address].validator + StakerBlsPubKeyIndex []byte // _staker[address].blsPubKey } // Slot definitions for SC storage var ( - validatorsSlot = int64(0) // Slot 0 - addressToIsValidatorSlot = int64(1) // Slot 1 - addressToStakedAmountSlot = int64(2) // Slot 2 - addressToValidatorIndexSlot = int64(3) // Slot 3 - stakedAmountSlot = int64(4) // Slot 4 - minNumValidatorSlot = int64(5) // Slot 5 - maxNumValidatorSlot = int64(6) // Slot 6 - addressToBLSPublicKeySlot = int64(7) // Slot 7 + validatorThresholdSlot = int64(0) // slot0 VALIDATOR_THRESHOLD (uint256) + configSlot = int64(1) // slot1 packs epochSize|minNumValidators|maxNumValidators (uint64 each) + validatorsSlot = int64(2) // slot2 _validators dynamic array (self-validator stakers) + stakerSlot = int64(3) // slot3 mapping(address => Staker) _staker + stakersSlot = int64(4) // slot4 address[] _stakers + validatorPoolSlot = int64(5) // slot5 mapping(address => ValidatorPoolConfig) _poolConfig + stakersByValidatorSlot = int64(6) // slot6 mapping(address => address[]) _stakersByValidator + stakerIndexByValSlot = int64(7) // slot7 mapping(address => mapping(address => uint256)) _stakerIndexPlusOneByValidator ) const ( - DefaultStakedBalance = "0x8AC7230489E80000" // 10 ETH + // Bootstrap stake is liveness-only and must not alter chain economics. + // Keep this at exactly 10 wei for PoA->PoS migration validators. + DefaultStakedBalance = "0xA" // 10 wei //nolint: lll - StakingSCBytecode = "0x6080604052600436106101185760003560e01c80637a6eea37116100a0578063d94c111b11610064578063d94c111b1461040a578063e387a7ed14610433578063e804fbf61461045e578063f90ecacc14610489578063facd743b146104c657610186565b80637a6eea37146103215780637dceceb81461034c578063af6da36e14610389578063c795c077146103b4578063ca1e7819146103df57610186565b8063373d6132116100e7578063373d6132146102595780633a4b66f1146102845780633c561f041461028e57806351a9ab32146102b9578063714ff425146102f657610186565b806302b751991461018b578063065ae171146101c85780632367f6b5146102055780632def66201461024257610186565b366101865761013c3373ffffffffffffffffffffffffffffffffffffffff16610503565b1561017c576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016101739061178a565b60405180910390fd5b610184610516565b005b600080fd5b34801561019757600080fd5b506101b260048036038101906101ad9190611380565b6105ed565b6040516101bf91906117e5565b60405180910390f35b3480156101d457600080fd5b506101ef60048036038101906101ea9190611380565b610605565b6040516101fc91906116ed565b60405180910390f35b34801561021157600080fd5b5061022c60048036038101906102279190611380565b610625565b60405161023991906117e5565b60405180910390f35b34801561024e57600080fd5b5061025761066e565b005b34801561026557600080fd5b5061026e610759565b60405161027b91906117e5565b60405180910390f35b61028c610763565b005b34801561029a57600080fd5b506102a36107cc565b6040516102b091906116cb565b60405180910390f35b3480156102c557600080fd5b506102e060048036038101906102db9190611380565b610972565b6040516102ed9190611708565b60405180910390f35b34801561030257600080fd5b5061030b610a12565b60405161031891906117e5565b60405180910390f35b34801561032d57600080fd5b50610336610a1c565b60405161034391906117ca565b60405180910390f35b34801561035857600080fd5b50610373600480360381019061036e9190611380565b610a28565b60405161038091906117e5565b60405180910390f35b34801561039557600080fd5b5061039e610a40565b6040516103ab91906117e5565b60405180910390f35b3480156103c057600080fd5b506103c9610a46565b6040516103d691906117e5565b60405180910390f35b3480156103eb57600080fd5b506103f4610a4c565b60405161040191906116a9565b60405180910390f35b34801561041657600080fd5b50610431600480360381019061042c91906113ad565b610ada565b005b34801561043f57600080fd5b50610448610b31565b60405161045591906117e5565b60405180910390f35b34801561046a57600080fd5b50610473610b37565b60405161048091906117e5565b60405180910390f35b34801561049557600080fd5b506104b060048036038101906104ab91906113f6565b610b41565b6040516104bd919061168e565b60405180910390f35b3480156104d257600080fd5b506104ed60048036038101906104e89190611380565b610b80565b6040516104fa91906116ed565b60405180910390f35b600080823b905060008111915050919050565b34600460008282546105289190611906565b9250508190555034600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825461057e9190611906565b9250508190555061058e33610bd6565b1561059d5761059c33610c4e565b5b3373ffffffffffffffffffffffffffffffffffffffff167f9e71bc8eea02a63969f509818f2dafb9254532904319f9dbda79b67bd34a5f3d346040516105e391906117e5565b60405180910390a2565b60036020528060005260406000206000915090505481565b60016020528060005260406000206000915054906101000a900460ff1681565b6000600260008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020549050919050565b61068d3373ffffffffffffffffffffffffffffffffffffffff16610503565b156106cd576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016106c49061178a565b60405180910390fd5b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541161074f576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016107469061172a565b60405180910390fd5b610757610d9d565b565b6000600454905090565b6107823373ffffffffffffffffffffffffffffffffffffffff16610503565b156107c2576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016107b99061178a565b60405180910390fd5b6107ca610516565b565b60606000808054905067ffffffffffffffff8111156107ee576107ed611b9e565b5b60405190808252806020026020018201604052801561082157816020015b606081526020019060019003908161080c5790505b50905060005b60008054905081101561096a576007600080838154811061084b5761084a611b6f565b5b9060005260206000200160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002080546108bb90611a36565b80601f01602080910402602001604051908101604052809291908181526020018280546108e790611a36565b80156109345780601f1061090957610100808354040283529160200191610934565b820191906000526020600020905b81548152906001019060200180831161091757829003601f168201915b505050505082828151811061094c5761094b611b6f565b5b6020026020010181905250808061096290611a99565b915050610827565b508091505090565b6007602052806000526040600020600091509050805461099190611a36565b80601f01602080910402602001604051908101604052809291908181526020018280546109bd90611a36565b8015610a0a5780601f106109df57610100808354040283529160200191610a0a565b820191906000526020600020905b8154815290600101906020018083116109ed57829003601f168201915b505050505081565b6000600554905090565b670de0b6b3a764000081565b60026020528060005260406000206000915090505481565b60065481565b60055481565b60606000805480602002602001604051908101604052809291908181526020018280548015610ad057602002820191906000526020600020905b8160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019060010190808311610a86575b5050505050905090565b80600760003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000209080519060200190610b2d929190611243565b5050565b60045481565b6000600654905090565b60008181548110610b5157600080fd5b906000526020600020016000915054906101000a900473ffffffffffffffffffffffffffffffffffffffff1681565b6000600160008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900460ff169050919050565b6000610be182610eef565b158015610c475750670de0b6b3a76400006fffffffffffffffffffffffffffffffff16600260008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410155b9050919050565b60065460008054905010610c97576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c8e9061174a565b60405180910390fd5b60018060008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548160ff021916908315150217905550600080549050600360008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055506000819080600181540180825580915050600190039060005260206000200160009091909190916101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050565b6000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205490506000600260003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508060046000828254610e38919061195c565b92505081905550610e4833610eef565b15610e5757610e5633610f45565b5b3373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f19350505050158015610e9d573d6000803e3d6000fd5b503373ffffffffffffffffffffffffffffffffffffffff167f0f5bb82176feb1b5e747e28471aa92156a04d9f3ab9f45f28e2d704232b93f7582604051610ee491906117e5565b60405180910390a250565b6000600160008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900460ff169050919050565b60055460008054905011610f8e576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610f85906117aa565b60405180910390fd5b600080549050600360008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410611014576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161100b9061176a565b60405180910390fd5b6000600360008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205490506000600160008054905061106c919061195c565b905080821461115a57600080828154811061108a57611089611b6f565b5b9060005260206000200160009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905080600084815481106110cc576110cb611b6f565b5b9060005260206000200160006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555082600360008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002081905550505b6000600160008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548160ff0219169083151502179055506000600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002081905550600080548061120957611208611b40565b5b6001900381819060005260206000200160006101000a81549073ffffffffffffffffffffffffffffffffffffffff02191690559055505050565b82805461124f90611a36565b90600052602060002090601f01602090048101928261127157600085556112b8565b82601f1061128a57805160ff19168380011785556112b8565b828001600101855582156112b8579182015b828111156112b757825182559160200191906001019061129c565b5b5090506112c591906112c9565b5090565b5b808211156112e25760008160009055506001016112ca565b5090565b60006112f96112f484611825565b611800565b90508281526020810184848401111561131557611314611bd2565b5b6113208482856119f4565b509392505050565b60008135905061133781611d0b565b92915050565b600082601f83011261135257611351611bcd565b5b81356113628482602086016112e6565b91505092915050565b60008135905061137a81611d22565b92915050565b60006020828403121561139657611395611bdc565b5b60006113a484828501611328565b91505092915050565b6000602082840312156113c3576113c2611bdc565b5b600082013567ffffffffffffffff8111156113e1576113e0611bd7565b5b6113ed8482850161133d565b91505092915050565b60006020828403121561140c5761140b611bdc565b5b600061141a8482850161136b565b91505092915050565b600061142f838361144f565b60208301905092915050565b6000611447838361154f565b905092915050565b61145881611990565b82525050565b61146781611990565b82525050565b600061147882611876565b61148281856118b1565b935061148d83611856565b8060005b838110156114be5781516114a58882611423565b97506114b083611897565b925050600181019050611491565b5085935050505092915050565b60006114d682611881565b6114e081856118c2565b9350836020820285016114f285611866565b8060005b8581101561152e578484038952815161150f858261143b565b945061151a836118a4565b925060208a019950506001810190506114f6565b50829750879550505050505092915050565b611549816119a2565b82525050565b600061155a8261188c565b61156481856118d3565b9350611574818560208601611a03565b61157d81611be1565b840191505092915050565b60006115938261188c565b61159d81856118e4565b93506115ad818560208601611a03565b6115b681611be1565b840191505092915050565b60006115ce601d836118f5565b91506115d982611bf2565b602082019050919050565b60006115f16027836118f5565b91506115fc82611c1b565b604082019050919050565b60006116146012836118f5565b915061161f82611c6a565b602082019050919050565b6000611637601a836118f5565b915061164282611c93565b602082019050919050565b600061165a6040836118f5565b915061166582611cbc565b604082019050919050565b611679816119ae565b82525050565b611688816119ea565b82525050565b60006020820190506116a3600083018461145e565b92915050565b600060208201905081810360008301526116c3818461146d565b905092915050565b600060208201905081810360008301526116e581846114cb565b905092915050565b60006020820190506117026000830184611540565b92915050565b600060208201905081810360008301526117228184611588565b905092915050565b60006020820190508181036000830152611743816115c1565b9050919050565b60006020820190508181036000830152611763816115e4565b9050919050565b6000602082019050818103600083015261178381611607565b9050919050565b600060208201905081810360008301526117a38161162a565b9050919050565b600060208201905081810360008301526117c38161164d565b9050919050565b60006020820190506117df6000830184611670565b92915050565b60006020820190506117fa600083018461167f565b92915050565b600061180a61181b565b90506118168282611a68565b919050565b6000604051905090565b600067ffffffffffffffff8211156118405761183f611b9e565b5b61184982611be1565b9050602081019050919050565b6000819050602082019050919050565b6000819050602082019050919050565b600081519050919050565b600081519050919050565b600081519050919050565b6000602082019050919050565b6000602082019050919050565b600082825260208201905092915050565b600082825260208201905092915050565b600082825260208201905092915050565b600082825260208201905092915050565b600082825260208201905092915050565b6000611911826119ea565b915061191c836119ea565b9250827fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0382111561195157611950611ae2565b5b828201905092915050565b6000611967826119ea565b9150611972836119ea565b92508282101561198557611984611ae2565b5b828203905092915050565b600061199b826119ca565b9050919050565b60008115159050919050565b60006fffffffffffffffffffffffffffffffff82169050919050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000819050919050565b82818337600083830152505050565b60005b83811015611a21578082015181840152602081019050611a06565b83811115611a30576000848401525b50505050565b60006002820490506001821680611a4e57607f821691505b60208210811415611a6257611a61611b11565b5b50919050565b611a7182611be1565b810181811067ffffffffffffffff82111715611a9057611a8f611b9e565b5b80604052505050565b6000611aa4826119ea565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff821415611ad757611ad6611ae2565b5b600182019050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4f6e6c79207374616b65722063616e2063616c6c2066756e6374696f6e000000600082015250565b7f56616c696461746f72207365742068617320726561636865642066756c6c206360008201527f6170616369747900000000000000000000000000000000000000000000000000602082015250565b7f696e646578206f7574206f662072616e67650000000000000000000000000000600082015250565b7f4f6e6c7920454f412063616e2063616c6c2066756e6374696f6e000000000000600082015250565b7f56616c696461746f72732063616e2774206265206c657373207468616e20746860008201527f65206d696e696d756d2072657175697265642076616c696461746f72206e756d602082015250565b611d1481611990565b8114611d1f57600080fd5b50565b611d2b816119ea565b8114611d3657600080fd5b5056fea26469706673582212201556e5927c99f1e21e8ae2bbc55b0b507bc60d9732fc9a5e25a0708b409c8c8064736f6c63430008070033" + StakingSCBytecode = "608060405234801561000f575f5ffd5b50604051614ce3380380614ce383398181016040528101906100319190610148565b5f8167ffffffffffffffff1603610074576040517f7192b3c800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b82600160086101000a81548167ffffffffffffffff021916908367ffffffffffffffff16021790555081600160106101000a81548167ffffffffffffffff021916908367ffffffffffffffff1602179055508060015f6101000a81548167ffffffffffffffff021916908367ffffffffffffffff1602179055506a01a784379d99db420000005f81905550505050610198565b5f5ffd5b5f67ffffffffffffffff82169050919050565b6101278161010b565b8114610131575f5ffd5b50565b5f815190506101428161011e565b92915050565b5f5f5f6060848603121561015f5761015e610107565b5b5f61016c86828701610134565b935050602061017d86828701610134565b925050604061018e86828701610134565b9150509250925092565b614b3e806101a55f395ff3fe60806040526004361061020e575f3560e01c80637498a79511610117578063c5f6855f1161009f578063d94c111b1161006e578063d94c111b146107c8578063db18abf6146107f0578063e261680b1461081a578063ebd16eef14610856578063f26ad66b146108805761020e565b8063c5f6855f14610710578063ca1e78191461074c578063cb1c2b5c14610776578063cb5cf2a2146107a05761020e565b806390e9a3e6116100e657806390e9a3e61461061e578063953c368c146106485780639a032e98146106705780639ffc25b0146106ac578063acec338a146106e85761020e565b80637498a79514610540578063753ecc261461057c5780637a6eea37146105b8578063889bc3b7146105e25761020e565b806343e3ef8b1161019a578063572d356e11610169578063572d356e146104465780635c19a95c146104705780636b468deb1461048c5780636c044b26146104c85780636c2bc86c146105045761020e565b806343e3ef8b146103765780634e745f1f146103a05780634f1811dd146103dc5780634f4286141461041c5761020e565b80632def6620116101e15780632def6620146102dc5780632e1a7d4d146102f25780632f8306001461031a5780633a4b66f1146103425780633c561f041461034c5761020e565b806301a5d67e146102125780632086ca251461023a5780632367f6b5146102645780632cfec6ff146102a0575b5f5ffd5b34801561021d575f5ffd5b5061023860048036038101906102339190613cda565b6108bc565b005b348015610245575f5ffd5b5061024e61091f565b60405161025b9190613d3a565b60405180910390f35b34801561026f575f5ffd5b5061028a60048036038101906102859190613d53565b610939565b6040516102979190613d8d565b60405180910390f35b3480156102ab575f5ffd5b506102c660048036038101906102c19190613d53565b610982565b6040516102d39190613d8d565b60405180910390f35b3480156102e7575f5ffd5b506102f06109cb565b005b3480156102fd575f5ffd5b5061031860048036038101906103139190613da6565b610a2d565b005b348015610325575f5ffd5b50610340600480360381019061033b9190613e06565b610a8f565b005b61034a610af1565b005b348015610357575f5ffd5b50610360610b51565b60405161036d9190613f6f565b60405180910390f35b348015610381575f5ffd5b5061038a610ceb565b6040516103979190613d8d565b60405180910390f35b3480156103ab575f5ffd5b506103c660048036038101906103c19190613d53565b610cf9565b6040516103d39190614078565b60405180910390f35b3480156103e7575f5ffd5b5061040260048036038101906103fd9190613d53565b610eb8565b6040516104139594939291906140ef565b60405180910390f35b348015610427575f5ffd5b50610430610fcb565b60405161043d9190613d3a565b60405180910390f35b348015610451575f5ffd5b5061045a610fe5565b6040516104679190613d3a565b60405180910390f35b61048a60048036038101906104859190613d53565b610ffe565b005b348015610497575f5ffd5b506104b260048036038101906104ad9190613d53565b61105f565b6040516104bf9190613d8d565b60405180910390f35b3480156104d3575f5ffd5b506104ee60048036038101906104e99190613d53565b6110a5565b6040516104fb9190613d8d565b60405180910390f35b34801561050f575f5ffd5b5061052a60048036038101906105259190613cda565b61116d565b6040516105379190614156565b60405180910390f35b34801561054b575f5ffd5b5061056660048036038101906105619190613d53565b6111ed565b6040516105739190613d8d565b60405180910390f35b348015610587575f5ffd5b506105a2600480360381019061059d9190613d53565b61131e565b6040516105af9190613d8d565b60405180910390f35b3480156105c3575f5ffd5b506105cc6113bb565b6040516105d99190613d8d565b60405180910390f35b3480156105ed575f5ffd5b5061060860048036038101906106039190613d53565b6113c0565b6040516106159190614224565b60405180910390f35b348015610629575f5ffd5b50610632611527565b60405161063f9190613d8d565b60405180910390f35b348015610653575f5ffd5b5061066e60048036038101906106699190613d53565b611536565b005b34801561067b575f5ffd5b5061069660048036038101906106919190613d53565b611599565b6040516106a39190614244565b60405180910390f35b3480156106b7575f5ffd5b506106d260048036038101906106cd9190613d53565b6115ee565b6040516106df9190613d8d565b60405180910390f35b3480156106f3575f5ffd5b5061070e6004803603810190610709919061425d565b61168f565b005b34801561071b575f5ffd5b5061073660048036038101906107319190613d53565b6116f0565b6040516107439190613d8d565b60405180910390f35b348015610757575f5ffd5b50610760611739565b60405161076d9190614330565b60405180910390f35b348015610781575f5ffd5b5061078a6117c4565b6040516107979190613d8d565b60405180910390f35b3480156107ab575f5ffd5b506107c660048036038101906107c1919061437a565b6117d3565b005b3480156107d3575f5ffd5b506107ee60048036038101906107e9919061443f565b611a7f565b005b3480156107fb575f5ffd5b50610804611c1d565b6040516108119190613d8d565b60405180910390f35b348015610825575f5ffd5b50610840600480360381019061083b9190613d53565b611c2b565b60405161084d9190614244565b60405180910390f35b348015610861575f5ffd5b5061086a611c40565b6040516108779190613d8d565b60405180910390f35b34801561088b575f5ffd5b506108a660048036038101906108a19190613d53565b611c45565b6040516108b39190613d8d565b60405180910390f35b5f600a5414610900576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016108f7906144e4565b60405180910390fd5b6001600a819055506109143383835f611c8b565b5f600a819055505050565b600160109054906101000a900467ffffffffffffffff1681565b5f60035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20600101549050919050565b5f60065f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20805490509050919050565b5f600a5414610a0f576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a06906144e4565b60405180910390fd5b6001600a81905550610a2433335f6001611c8b565b5f600a81905550565b5f600a5414610a71576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a68906144e4565b60405180910390fd5b6001600a81905550610a853333835f611c8b565b5f600a8190555050565b5f600a5414610ad3576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610aca906144e4565b60405180910390fd5b6001600a81905550610ae633838361224c565b5f600a819055505050565b5f600a5414610b35576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610b2c906144e4565b60405180910390fd5b6001600a81905550610b4833333461253d565b5f600a81905550565b606060028054905067ffffffffffffffff811115610b7257610b71614502565b5b604051908082528060200260200182016040528015610ba557816020015b6060815260200190600190039081610b905790505b5090505f5f90505b600280549050811015610ce75760035f60028381548110610bd157610bd061452f565b5b905f5260205f20015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f206005018054610c4090614589565b80601f0160208091040260200160405190810160405280929190818152602001828054610c6c90614589565b8015610cb75780601f10610c8e57610100808354040283529160200191610cb7565b820191905f5260205f20905b815481529060010190602001808311610c9a57829003601f168201915b5050505050828281518110610ccf57610cce61452f565b5b60200260200101819052508080600101915050610bad565b5090565b692a5a058fc295ed00000081565b610d01613b4b565b60035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20604051806101000160405290815f82015f9054906101000a900460ff161515151581526020015f820160019054906101000a900460ff161515151581526020015f820160029054906101000a900467ffffffffffffffff1667ffffffffffffffff1667ffffffffffffffff168152602001600182015481526020016002820154815260200160038201548152602001600482015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001600582018054610e3190614589565b80601f0160208091040260200160405190810160405280929190818152602001828054610e5d90614589565b8015610ea85780601f10610e7f57610100808354040283529160200191610ea8565b820191905f5260205f20905b815481529060010190602001808311610e8b57829003601f168201915b5050505050815250509050919050565b5f5f5f5f60605f60035f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f015f9054906101000a900460ff16815f0160019054906101000a900460ff168260010154836003015484600501808054610f3990614589565b80601f0160208091040260200160405190810160405280929190818152602001828054610f6590614589565b8015610fb05780601f10610f8757610100808354040283529160200191610fb0565b820191905f5260205f20905b815481529060010190602001808311610f9357829003601f168201915b50505050509050955095509550955095505091939590929450565b600160089054906101000a900467ffffffffffffffff1681565b60015f9054906101000a900467ffffffffffffffff1681565b5f600a5414611042576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611039906144e4565b60405180910390fd5b6001600a8190555061105533823461253d565b5f600a8190555050565b5f60095f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b5f5f60035f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f015f9054906101000a900460ff16158061115157508273ffffffffffffffffffffffffffffffffffffffff16816004015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b1561115f575f915050611168565b80600101549150505b919050565b5f60065f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f2082815481106111bd576111bc61452f565b5b905f5260205f20015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905092915050565b5f5f60035f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f015f9054906101000a900460ff16158061129957508273ffffffffffffffffffffffffffffffffffffffff16816004015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b156112a7575f915050611319565b5f815f0160019054906101000a900460ff166112c3575f6112c9565b81600101545b905060095f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20548161131491906145e6565b925050505b919050565b5f5f60035f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f206002015490505f8103611373575f9150506113b6565b60015f9054906101000a900467ffffffffffffffff1667ffffffffffffffff16600161139e83612e7d565b6113a891906145e6565b6113b29190614619565b9150505b919050565b5f5481565b6113c8613bad565b60055f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f206040518060e00160405290815f82015f9054906101000a900460ff161515151581526020015f820160019054906101000a900460ff161515151581526020015f820160029054906101000a900460ff161515151581526020016001820154815260200160028201548152602001600382015f9054906101000a900461ffff1661ffff1661ffff1681526020016004820180546114a090614589565b80601f01602080910402602001604051908101604052809291908181526020018280546114cc90614589565b80156115175780601f106114ee57610100808354040283529160200191611517565b820191905f5260205f20905b8154815290600101906020018083116114fa57829003601f168201915b5050505050815250509050919050565b6a01a784379d99db4200000081565b5f600a541461157a576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611571906144e4565b60405180910390fd5b6001600a8190555061158f33825f6001611c8b565b5f600a8190555050565b5f60055f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f0160029054906101000a900460ff169050919050565b5f5f60035f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f2090505f816003015403611643575f91505061168a565b60015f9054906101000a900467ffffffffffffffff1667ffffffffffffffff1660016116728360030154612e7d565b61167c91906145e6565b6116869190614619565b9150505b919050565b5f600a54146116d3576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016116ca906144e4565b60405180910390fd5b6001600a819055506116e633338361224c565b5f600a8190555050565b5f60035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20600201549050919050565b606060028054806020026020016040519081016040528092919081815260200182805480156117ba57602002820191905f5260205f20905b815f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019060010190808311611771575b5050505050905090565b6a01a784379d99db4200000081565b5f600a5414611817576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161180e906144e4565b60405180910390fd5b6001600a819055505f60035f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f015f9054906101000a900460ff1615806118ca57503373ffffffffffffffffffffffffffffffffffffffff16816004015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b15611901576040517f580e542f00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6127108261ffff161115611941576040517ff4f0b02200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f831415801561195a575069021e19e0c9bab240000083105b15611991576040517f6702d01200000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f60055f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20905085815f0160026101000a81548160ff02191690831515021790555084816001018190555083816002018190555082816003015f6101000a81548161ffff021916908361ffff1602179055503373ffffffffffffffffffffffffffffffffffffffff167f3b5126889e55c444f326ae2159a6534dee12164626d667cd115c2c4ffd041a5087878787604051611a689493929190614669565b60405180910390a250505f600a8190555050505050565b5f600a5414611ac3576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611aba906144e4565b60405180910390fd5b6001600a819055505f60035f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f015f9054906101000a900460ff161580611b7657503373ffffffffffffffffffffffffffffffffffffffff16816004015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b15611bad576040517f580e542f00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b8282826005019182611bc0929190614867565b50828260055f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f206004019182611c10929190614867565b50505f600a819055505050565b69021e19e0c9bab240000081565b5f5f54611c37836111ed565b10159050919050565b60c881565b5f60085f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b5f60035f8673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f015f9054906101000a900460ff161580611d3657508373ffffffffffffffffffffffffffffffffffffffff16816004015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b15611d6d576040517f580e542f00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b805f0160019054906101000a900460ff1615611db5576040517f34637cc900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f816003015403611df2576040517f34637cc900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b611dff8160030154612e7d565b611e0843612e7d565b11611e3f576040517f5c940c6900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f8215611e525781600101549050611f47565b5f841480611e64575081600101548410155b15611e9b576040517fdb73cdf000000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f8573ffffffffffffffffffffffffffffffffffffffff168773ffffffffffffffffffffffffffffffffffffffff1614611edd57611ed886612eb0565b611ee9565b692a5a058fc295ed0000005b90505f858460010154611efc9190614934565b905081811015611f38576040517f6eda21dd00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b85925080846001018190555050505b821561213057611f6d86868460010154855f0160019054906101000a900460ff16612f16565b8473ffffffffffffffffffffffffffffffffffffffff168673ffffffffffffffffffffffffffffffffffffffff160361205357611fa986612ffe565b60055f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f5f82015f6101000a81549060ff02191690555f820160016101000a81549060ff02191690555f820160026101000a81549060ff0219169055600182015f9055600282015f9055600382015f6101000a81549061ffff0219169055600482015f6120509190613bee565b50505b61205d8587613190565b6120668661351c565b8573ffffffffffffffffffffffffffffffffffffffff167f0f5bb82176feb1b5e747e28471aa92156a04d9f3ab9f45f28e2d704232b93f75826040516120ac9190613d8d565b60405180910390a28473ffffffffffffffffffffffffffffffffffffffff168673ffffffffffffffffffffffffffffffffffffffff160361212b578573ffffffffffffffffffffffffffffffffffffffff167fe1434e25d6611e0db941968fdc97811c982ac1602e951637d206f5fdda9dd8f160405160405180910390a25b61219b565b61214c868683855f0160019054906101000a900460ff166137ac565b8573ffffffffffffffffffffffffffffffffffffffff167f7084f5476618d8e60b11ef0d7d3f06914655adb8793e28ff7f018d4c76d505d5826040516121929190613d8d565b60405180910390a25b5f8673ffffffffffffffffffffffffffffffffffffffff16826040516121c090614994565b5f6040518083038185875af1925050503d805f81146121fa576040519150601f19603f3d011682016040523d82523d5f602084013e6121ff565b606091505b5050905080612243576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161223a906149f2565b60405180910390fd5b50505050505050565b5f60035f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f015f9054906101000a900460ff1615806122f757508273ffffffffffffffffffffffffffffffffffffffff16816004015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b1561232e576040517f580e542f00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b811515815f0160019054906101000a900460ff1615150361237b576040517fa291f7f500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f8373ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff16146123bd576123b884612eb0565b6123c9565b692a5a058fc295ed0000005b90508280156123db5750808260010154105b15612412576040517f6eda21dd00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b82825f0160016101000a81548160ff0219169083151502179055508215612441575f826003018190555061244b565b4382600301819055505b8373ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff16036124d6578260055f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f0160016101000a81548160ff0219169083151502179055505b6124e68585846001015486613894565b8473ffffffffffffffffffffffffffffffffffffffff167f5284f0712132690f2f47f4838e558e56a188d75390d1bf332f5a5a0c72cd46e8844360405161252e929190614a10565b60405180910390a25050505050565b5f8103612576576040517fcacf989a00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f8273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161490508061279f575f60035f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f015f9054906101000a900460ff16158061265857508373ffffffffffffffffffffffffffffffffffffffff16816004015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614155b1561268f576040517f2eacdcfb00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f60055f8673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f0160029054906101000a900460ff16612716576040517fc5dc052900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b80600101548460085f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205461276491906145e6565b111561279c576040517fdbcafd5700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b50505b5f60035f8673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f209050805f015f9054906101000a900460ff16612d69575f826128075761280285612eb0565b612813565b692a5a058fc295ed0000005b90508084101561284f576040517fcf0bf48900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b82158015612866575060c861286386613981565b10155b1561289d576040517fc8bb41d900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6001825f015f6101000a81548160ff0219169083151502179055506001825f0160016101000a81548160ff021916908315150217905550600480549050825f0160026101000a81548167ffffffffffffffff021916908367ffffffffffffffff16021790555043826002018190555084826004015f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600486908060018154018082558091505060019003905f5260205f20015f9091909190916101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160065f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20805490506129fb91906145e6565b60075f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f208190555060065f8673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f2086908060018154018082558091505060019003905f5260205f20015f9091909190916101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508215612d6357600286908060018154018082558091505060019003905f5260205f20015f9091909190916101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550600160055f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f015f6101000a81548160ff021916908315150217905550600160055f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f0160016101000a81548160ff0219169083151502179055505f60055f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f0160026101000a81548160ff0219169083151502179055505f60055f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20600101819055505f60055f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20600201819055505f60055f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f206003015f6101000a81548161ffff021916908361ffff1602179055505b50612df2565b8373ffffffffffffffffffffffffffffffffffffffff16816004015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614612df1576040517f2eacdcfb00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5b82816001015f828254612e0591906145e6565b92505081905550612e28858585845f0160019054906101000a900460ff16613a63565b8473ffffffffffffffffffffffffffffffffffffffff167f9e71bc8eea02a63969f509818f2dafb9254532904319f9dbda79b67bd34a5f3d84604051612e6e9190613d8d565b60405180910390a25050505050565b5f60015f9054906101000a900467ffffffffffffffff1667ffffffffffffffff1682612ea99190614a64565b9050919050565b5f5f60055f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f206002015490505f8114612f025780612f0e565b69021e19e0c9bab24000005b915050919050565b8273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff160315612ff8578160085f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f828254612f969190614934565b925050819055508015612ff7578160095f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f828254612fef9190614934565b925050819055505b5b50505050565b5f60016002805490506130119190614934565b90505f5f5f90505b6002805490508110156130a9578373ffffffffffffffffffffffffffffffffffffffff16600282815481106130515761305061452f565b5b905f5260205f20015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff160361309c578091506130a9565b8080600101915050613019565b5081811461314757600282815481106130c5576130c461452f565b5b905f5260205f20015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16600282815481106131015761310061452f565b5b905f5260205f20015f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055505b600280548061315957613158614a94565b5b600190038181905f5260205f20015f6101000a81549073ffffffffffffffffffffffffffffffffffffffff02191690559055505050565b5f60075f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205490505f81036132195750613518565b5f6001826132279190614934565b90505f600160065f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20805490506132779190614934565b905080821461341a575f60065f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f2082815481106132d0576132cf61452f565b5b905f5260205f20015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508060065f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20848154811061334a5761334961452f565b5b905f5260205f20015f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555060018361339c91906145e6565b60075f8873ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f2081905550505b60065f8673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f2080548061346757613466614a94565b5b600190038181905f5260205f20015f6101000a81549073ffffffffffffffffffffffffffffffffffffffff0219169055905560075f8673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f90555050505b5050565b5f60035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f0160029054906101000a900467ffffffffffffffff1667ffffffffffffffff1690505f60016004805490506135909190614934565b905080821461369a575f600482815481106135ae576135ad61452f565b5b905f5260205f20015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905080600484815481106135ed576135ec61452f565b5b905f5260205f20015f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508260035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f0160026101000a81548167ffffffffffffffff021916908367ffffffffffffffff160217905550505b60048054806136ac576136ab614a94565b5b600190038181905f5260205f20015f6101000a81549073ffffffffffffffffffffffffffffffffffffffff0219169055905560035f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f5f82015f6101000a81549060ff02191690555f820160016101000a81549060ff02191690555f820160026101000a81549067ffffffffffffffff0219169055600182015f9055600282015f9055600382015f9055600482015f6101000a81549073ffffffffffffffffffffffffffffffffffffffff0219169055600582015f6137a59190613bee565b5050505050565b8273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16031561388e578160085f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825461382c9190614934565b92505081905550801561388d578160095f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8282546138859190614934565b925050819055505b5b50505050565b8273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16031561397b578015613926578160095f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825461391a91906145e6565b9250508190555061397a565b8160095f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8282546139729190614934565b925050819055505b5b50505050565b5f5f60065f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f2090505f5f90505b8180549050811015613a5c578373ffffffffffffffffffffffffffffffffffffffff168282815481106139fd576139fc61452f565b5b905f5260205f20015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1614613a4f578280613a4b90614ac1565b9350505b80806001019150506139c7565b5050919050565b8273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff160315613b45578160085f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f828254613ae391906145e6565b925050819055508015613b44578160095f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f828254613b3c91906145e6565b925050819055505b5b50505050565b6040518061010001604052805f151581526020015f151581526020015f67ffffffffffffffff1681526020015f81526020015f81526020015f81526020015f73ffffffffffffffffffffffffffffffffffffffff168152602001606081525090565b6040518060e001604052805f151581526020015f151581526020015f151581526020015f81526020015f81526020015f61ffff168152602001606081525090565b508054613bfa90614589565b5f825580601f10613c0c575050613c26565b601f0160209004905f5260205f2090613c259190613c28565b5b565b5f5b80821115613c40578281015f9055600101613c2a565b505050565b5f5ffd5b5f5ffd5b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f613c7682613c4d565b9050919050565b613c8681613c6c565b8114613c90575f5ffd5b50565b5f81359050613ca181613c7d565b92915050565b5f819050919050565b613cb981613ca7565b8114613cc3575f5ffd5b50565b5f81359050613cd481613cb0565b92915050565b5f5f60408385031215613cf057613cef613c45565b5b5f613cfd85828601613c93565b9250506020613d0e85828601613cc6565b9150509250929050565b5f67ffffffffffffffff82169050919050565b613d3481613d18565b82525050565b5f602082019050613d4d5f830184613d2b565b92915050565b5f60208284031215613d6857613d67613c45565b5b5f613d7584828501613c93565b91505092915050565b613d8781613ca7565b82525050565b5f602082019050613da05f830184613d7e565b92915050565b5f60208284031215613dbb57613dba613c45565b5b5f613dc884828501613cc6565b91505092915050565b5f8115159050919050565b613de581613dd1565b8114613def575f5ffd5b50565b5f81359050613e0081613ddc565b92915050565b5f5f60408385031215613e1c57613e1b613c45565b5b5f613e2985828601613c93565b9250506020613e3a85828601613df2565b9150509250929050565b5f81519050919050565b5f82825260208201905092915050565b5f819050602082019050919050565b5f81519050919050565b5f82825260208201905092915050565b8281835e5f83830152505050565b5f601f19601f8301169050919050565b5f613eaf82613e6d565b613eb98185613e77565b9350613ec9818560208601613e87565b613ed281613e95565b840191505092915050565b5f613ee88383613ea5565b905092915050565b5f602082019050919050565b5f613f0682613e44565b613f108185613e4e565b935083602082028501613f2285613e5e565b805f5b85811015613f5d5784840389528151613f3e8582613edd565b9450613f4983613ef0565b925060208a01995050600181019050613f25565b50829750879550505050505092915050565b5f6020820190508181035f830152613f878184613efc565b905092915050565b613f9881613dd1565b82525050565b613fa781613d18565b82525050565b613fb681613ca7565b82525050565b613fc581613c6c565b82525050565b5f61010083015f830151613fe15f860182613f8f565b506020830151613ff46020860182613f8f565b5060408301516140076040860182613f9e565b50606083015161401a6060860182613fad565b50608083015161402d6080860182613fad565b5060a083015161404060a0860182613fad565b5060c083015161405360c0860182613fbc565b5060e083015184820360e086015261406b8282613ea5565b9150508091505092915050565b5f6020820190508181035f8301526140908184613fcb565b905092915050565b6140a181613dd1565b82525050565b5f82825260208201905092915050565b5f6140c182613e6d565b6140cb81856140a7565b93506140db818560208601613e87565b6140e481613e95565b840191505092915050565b5f60a0820190506141025f830188614098565b61410f6020830187614098565b61411c6040830186613d7e565b6141296060830185613d7e565b818103608083015261413b81846140b7565b90509695505050505050565b61415081613c6c565b82525050565b5f6020820190506141695f830184614147565b92915050565b5f61ffff82169050919050565b6141858161416f565b82525050565b5f60e083015f8301516141a05f860182613f8f565b5060208301516141b36020860182613f8f565b5060408301516141c66040860182613f8f565b5060608301516141d96060860182613fad565b5060808301516141ec6080860182613fad565b5060a08301516141ff60a086018261417c565b5060c083015184820360c08601526142178282613ea5565b9150508091505092915050565b5f6020820190508181035f83015261423c818461418b565b905092915050565b5f6020820190506142575f830184614098565b92915050565b5f6020828403121561427257614271613c45565b5b5f61427f84828501613df2565b91505092915050565b5f81519050919050565b5f82825260208201905092915050565b5f819050602082019050919050565b5f6142bc8383613fbc565b60208301905092915050565b5f602082019050919050565b5f6142de82614288565b6142e88185614292565b93506142f3836142a2565b805f5b8381101561432357815161430a88826142b1565b9750614315836142c8565b9250506001810190506142f6565b5085935050505092915050565b5f6020820190508181035f83015261434881846142d4565b905092915050565b6143598161416f565b8114614363575f5ffd5b50565b5f8135905061437481614350565b92915050565b5f5f5f5f6080858703121561439257614391613c45565b5b5f61439f87828801613df2565b94505060206143b087828801613cc6565b93505060406143c187828801613cc6565b92505060606143d287828801614366565b91505092959194509250565b5f5ffd5b5f5ffd5b5f5ffd5b5f5f83601f8401126143ff576143fe6143de565b5b8235905067ffffffffffffffff81111561441c5761441b6143e2565b5b602083019150836001820283011115614438576144376143e6565b5b9250929050565b5f5f6020838503121561445557614454613c45565b5b5f83013567ffffffffffffffff81111561447257614471613c49565b5b61447e858286016143ea565b92509250509250929050565b5f82825260208201905092915050565b7f5245454e5452414e5400000000000000000000000000000000000000000000005f82015250565b5f6144ce60098361448a565b91506144d98261449a565b602082019050919050565b5f6020820190508181035f8301526144fb816144c2565b9050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806145a057607f821691505b6020821081036145b3576145b261455c565b5b50919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f6145f082613ca7565b91506145fb83613ca7565b9250828201905080821115614613576146126145b9565b5b92915050565b5f61462382613ca7565b915061462e83613ca7565b925082820261463c81613ca7565b91508282048414831517614653576146526145b9565b5b5092915050565b6146638161416f565b82525050565b5f60808201905061467c5f830187614098565b6146896020830186613d7e565b6146966040830185613d7e565b6146a3606083018461465a565b95945050505050565b5f82905092915050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026147127fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff826146d7565b61471c86836146d7565b95508019841693508086168417925050509392505050565b5f819050919050565b5f61475761475261474d84613ca7565b614734565b613ca7565b9050919050565b5f819050919050565b6147708361473d565b61478461477c8261475e565b8484546146e3565b825550505050565b5f5f905090565b61479b61478c565b6147a6818484614767565b505050565b5f5b828110156147cc576147c15f828401614793565b6001810190506147ad565b505050565b601f82111561481f578282111561481e576147eb816146b6565b6147f4836146c8565b6147fd856146c8565b602086101561480a575f90505b808301614819828403826147ab565b505050505b5b505050565b5f82821c905092915050565b5f61483f5f1984600802614824565b1980831691505092915050565b5f6148578383614830565b9150826002028217905092915050565b61487183836146ac565b67ffffffffffffffff81111561488a57614889614502565b5b6148948254614589565b61489f8282856147d1565b5f601f8311600181146148cc575f84156148ba578287013590505b6148c4858261484c565b86555061492b565b601f1984166148da866146b6565b5f5b82811015614901578489013582556001820191506020850194506020810190506148dc565b8683101561491e578489013561491a601f891682614830565b8355505b6001600288020188555050505b50505050505050565b5f61493e82613ca7565b915061494983613ca7565b9250828203905081811115614961576149606145b9565b5b92915050565b5f81905092915050565b50565b5f61497f5f83614967565b915061498a82614971565b5f82019050919050565b5f61499e82614974565b9150819050919050565b7f7472616e73666572206661696c656400000000000000000000000000000000005f82015250565b5f6149dc600f8361448a565b91506149e7826149a8565b602082019050919050565b5f6020820190508181035f830152614a09816149d0565b9050919050565b5f604082019050614a235f830185614098565b614a306020830184613d7e565b9392505050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b5f614a6e82613ca7565b9150614a7983613ca7565b925082614a8957614a88614a37565b5b828204905092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603160045260245ffd5b5f614acb82613ca7565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8203614afd57614afc6145b9565b5b60018201905091905056fea2646970667358221220fe157ec2cdd2c2db8651cda0d26eff72b18c38ef6560bbf0ea3ffb456a85a21964736f6c63430008220033" ) +func extractRuntimeBytecode(bytecode []byte) []byte { + for i := 0; i+1 < len(bytecode); i++ { + if bytecode[i] == 0xf3 && bytecode[i+1] == 0xfe { + return bytecode[i+2:] + } + } + + return bytecode +} + // PredeployStakingSC is a helper method for setting up the staking smart contract account, // using the passed in validators as pre-staked validators func PredeployStakingSC( vals validators.Validators, params PredeployParams, ) (*chain.GenesisAccount, error) { + if params.MaxValidatorCount == 0 { + return nil, fmt.Errorf("invalid staking predeploy params: max validator count must be > 0") + } + + if params.MinValidatorCount > params.MaxValidatorCount { + return nil, fmt.Errorf("invalid staking predeploy params: min validator count (%d) exceeds max (%d)", params.MinValidatorCount, params.MaxValidatorCount) + } + + if params.EpochSize < 2 { + return nil, fmt.Errorf("invalid staking predeploy params: epoch size must be >= 2") + } + + if vals != nil && uint64(vals.Len()) > params.MaxValidatorCount { + return nil, fmt.Errorf("invalid staking predeploy params: validator set size (%d) exceeds max validator count (%d)", vals.Len(), params.MaxValidatorCount) + } // Set the code for the staking smart contract // Code retrieved from https://github.com/0xPolygon/staking-contracts + // and predeployed as runtime bytecode directly (constructor is NOT executed). scHex, _ := hex.DecodeHex(StakingSCBytecode) + scHex = extractRuntimeBytecode(scHex) stakingAccount := &chain.GenesisAccount{ Code: scHex, } @@ -185,10 +199,7 @@ func PredeployStakingSC( // Generate the empty account storage map storageMap := make(map[types.Hash]types.Hash) - bigTrueValue := big.NewInt(1) stakedAmount := big.NewInt(0) - bigMinNumValidators := big.NewInt(int64(params.MinValidatorCount)) - bigMaxNumValidators := big.NewInt(int64(params.MaxValidatorCount)) valsLen := big.NewInt(0) if vals != nil { @@ -212,40 +223,79 @@ func PredeployStakingSC( if blsValidator, ok := validator.(*validators.BLSValidator); ok { setBytesToStorage( storageMap, - storageIndexes.ValidatorBLSPublicKeyIndex, + storageIndexes.StakerBlsPubKeyIndex, blsValidator.BLSPublicKey, ) } - // Set the value for the address -> validator array index mapping - storageMap[types.BytesToHash(storageIndexes.AddressToIsValidatorIndex)] = - types.BytesToHash(bigTrueValue.Bytes()) + // pack exists=true (byte0), active=true (byte1), index(uint64) into slot + packed := new(big.Int).SetUint64(uint64(idx)) + packed.Lsh(packed, 16) + packed.Or(packed, big.NewInt(0x0101)) + storageMap[types.BytesToHash(storageIndexes.StakerPackedIndex)] = types.BytesToHash(packed.Bytes()) - // Set the value for the address -> staked amount mapping - storageMap[types.BytesToHash(storageIndexes.AddressToStakedAmountIndex)] = + // _staker[address].amount at base+1 + storageMap[types.BytesToHash(storageIndexes.StakerAmountIndex)] = types.StringToHash(hex.EncodeBig(bigDefaultStakedBalance)) - // Set the value for the address -> validator index mapping - storageMap[types.BytesToHash(storageIndexes.AddressToValidatorIndexIndex)] = - types.StringToHash(hex.EncodeUint64(uint64(idx))) + // _staker[address].joinedAtBlock at base+2 + storageMap[types.BytesToHash(getIndexWithOffset(storageIndexes.StakerPackedIndex, 2))] = + types.BytesToHash(big.NewInt(1).Bytes()) + // _staker[address].validator at base+4 (self-validator bootstrap) + storageMap[types.BytesToHash(storageIndexes.StakerValidatorIndex)] = + types.BytesToHash(validator.Addr().Bytes()) + + // _poolConfig[validator] at slot5: exists=true, active=true + poolBase := getAddressMapping(validator.Addr(), validatorPoolSlot) + storageMap[types.BytesToHash(poolBase)] = types.BytesToHash(big.NewInt(0x0101).Bytes()) + if blsValidator, ok := validator.(*validators.BLSValidator); ok { + setBytesToStorage(storageMap, getIndexWithOffset(poolBase, 1), blsValidator.BLSPublicKey) + } + + // _stakersByValidator[validator] = [validator] + stakersByValBase := getAddressMapping(validator.Addr(), stakersByValidatorSlot) + storageMap[types.BytesToHash(stakersByValBase)] = types.BytesToHash(big.NewInt(1).Bytes()) + stakersByValArrayBase := keccak.Keccak256(nil, common.PadLeftOrTrim(stakersByValBase, 32)) + storageMap[types.BytesToHash(getIndexWithOffset(stakersByValArrayBase, 0))] = + types.BytesToHash(validator.Addr().Bytes()) + + // _stakerIndexPlusOneByValidator[validator][validator] = 1 + stakerIndexOuter := getAddressMapping(validator.Addr(), stakerIndexByValSlot) + stakerIndexInner := append(common.PadLeftOrTrim(validator.Addr().Bytes(), 32), common.PadLeftOrTrim(stakerIndexOuter, 32)...) + storageMap[types.BytesToHash(keccak.Keccak256(nil, stakerIndexInner))] = + types.BytesToHash(big.NewInt(1).Bytes()) } } - // Set the value for the total staked amount - storageMap[types.BytesToHash(big.NewInt(stakedAmountSlot).Bytes())] = - types.BytesToHash(stakedAmount.Bytes()) - - // Set the value for the size of the validators array + // Set slot2 _validators length storageMap[types.BytesToHash(big.NewInt(validatorsSlot).Bytes())] = types.BytesToHash(valsLen.Bytes()) - // Set the value for the minimum number of validators - storageMap[types.BytesToHash(big.NewInt(minNumValidatorSlot).Bytes())] = - types.BytesToHash(bigMinNumValidators.Bytes()) + // Set slot4 _stakers length and values (self-staker list) + storageMap[types.BytesToHash(big.NewInt(stakersSlot).Bytes())] = + types.BytesToHash(valsLen.Bytes()) + stakersArrayBase := keccak.Keccak256(nil, common.PadLeftOrTrim(big.NewInt(stakersSlot).Bytes(), 32)) + if vals != nil { + for idx := 0; idx < vals.Len(); idx++ { + storageMap[types.BytesToHash(getIndexWithOffset(stakersArrayBase, uint64(idx)))] = + types.BytesToHash(vals.At(uint64(idx)).Addr().Bytes()) + } + } - // Set the value for the maximum number of validators - storageMap[types.BytesToHash(big.NewInt(maxNumValidatorSlot).Bytes())] = - types.BytesToHash(bigMaxNumValidators.Bytes()) + // Set slot0 VALIDATOR_THRESHOLD = MIN_STAKE = 2_000_000 ether. + thresholdWei := new(big.Int).SetUint64(2_000_000) + thresholdWei.Mul(thresholdWei, new(big.Int).Exp(big.NewInt(10), big.NewInt(18), nil)) + storageMap[types.BytesToHash(big.NewInt(validatorThresholdSlot).Bytes())] = + types.BytesToHash(thresholdWei.Bytes()) + + // Set packed slot1 (epochSize|minNumValidators|maxNumValidators, uint64 each). + packedConfig := new(big.Int).SetUint64(params.MaxValidatorCount) + packedConfig.Lsh(packedConfig, 64) + packedConfig.Or(packedConfig, new(big.Int).SetUint64(params.MinValidatorCount)) + packedConfig.Lsh(packedConfig, 64) + packedConfig.Or(packedConfig, new(big.Int).SetUint64(params.EpochSize)) + storageMap[types.BytesToHash(big.NewInt(configSlot).Bytes())] = + types.BytesToHash(packedConfig.Bytes()) // Save the storage map stakingAccount.Storage = storageMap @@ -255,3 +305,56 @@ func PredeployStakingSC( return stakingAccount, nil } + +// PredeployStakingSCBootstrap builds deterministic staking contract bootstrap state +// from the supplied validator set and predeploy parameters. +func PredeployStakingSCBootstrap( + vals validators.Validators, + params PredeployParams, +) (*chain.GenesisAccount, error) { + return PredeployStakingSC(vals, params) +} + +// IsUninitializedStakingStorage checks if staking storage has not been initialized yet. +// It must also treat "capacity set but validator list empty" as uninitialized, +// otherwise PoA->PoS bootstrap can skip and leave an empty contract-backed validator set. +func IsUninitializedStakingStorage(txn *state.Transition, addr types.Address) bool { + if txn == nil { + return true + } + + zero := types.Hash{} + + // 1) capacity marker + cfgKey := types.BytesToHash(big.NewInt(configSlot).Bytes()) + cfgH := txn.Txn().GetState(addr, cfgKey) + if cfgH == zero || new(big.Int).SetBytes(cfgH[:]).Sign() == 0 { + return true + } + + // 2) validator list length (slot 1). If empty, treat as uninitialized. + lenKey := types.BytesToHash(big.NewInt(validatorsSlot).Bytes()) + lenH := txn.Txn().GetState(addr, lenKey) + if lenH == zero { + return true + } + if new(big.Int).SetBytes(lenH[:]).Sign() == 0 { + return true + } + + // 3) epochSize (packed in slot1, lower uint64) must be initialized (>0) for unstake epoch math. + cfg := new(big.Int).SetBytes(cfgH[:]) + epoch := cfg.Uint64() + if epoch == 0 { + return true + } + + // 4) threshold (slot0) must be initialized (>0), constructor is not executed for predeploy. + thresholdKey := types.BytesToHash(big.NewInt(validatorThresholdSlot).Bytes()) + thresholdH := txn.Txn().GetState(addr, thresholdKey) + if thresholdH == zero || new(big.Int).SetBytes(thresholdH[:]).Sign() == 0 { + return true + } + + return false +} diff --git a/helper/staking/staking_test.go b/helper/staking/staking_test.go new file mode 100644 index 0000000..1ef58bd --- /dev/null +++ b/helper/staking/staking_test.go @@ -0,0 +1,221 @@ +package staking + +import ( + "encoding/hex" + "math/big" + "strings" + "testing" + + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/helper/keccak" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +func TestStakingV2PredeploySelectorAndABIConsistency(t *testing.T) { + t.Parallel() + + const currentSignature = "setValidatorPoolConfig(bool,uint256,uint256,uint16)" + const oldSignature = "setValidatorPoolConfig(bool,uint256,uint16)" + const currentSelector = "cb5cf2a2" + const oldSelector = "db02fcee" + + method := abis.StakingABI.GetMethodBySignature(currentSignature) + require.NotNil(t, method, "staking ABI must expose the current 4-argument setValidatorPoolConfig") + require.Equal(t, currentSignature, method.Sig()) + require.Equal(t, currentSelector, hex.EncodeToString(method.ID())) + require.Nil(t, abis.StakingABI.GetMethodBySignature(oldSignature), "staking ABI must not expose the old 3-argument setValidatorPoolConfig") + + require.Contains(t, StakingSCBytecode, currentSelector, "embedded bytecode must route the current selector") + require.False(t, strings.Contains(StakingSCBytecode, oldSelector), "embedded bytecode must not route the old selector") +} + +func TestStakingV2EmbeddedBytecodeHashPinned(t *testing.T) { + t.Parallel() + + bytecode, err := hex.DecodeString(StakingSCBytecode) + require.NoError(t, err) + hasher := keccak.NewKeccak256() + _, err = hasher.Write(bytecode) + require.NoError(t, err) + require.Equal(t, "510e1cea27394c6b1ef8e53e44909fa57e40d4af480358bfb904bb023867c2d9", hex.EncodeToString(hasher.Sum(nil))) +} + +func TestPredeployStakingSC_ValidatesParams(t *testing.T) { + t.Parallel() + + _, err := PredeployStakingSC(nil, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 0, EpochSize: 10}) + require.Error(t, err) + require.Contains(t, err.Error(), "max validator count") + + _, err = PredeployStakingSC(nil, PredeployParams{MinValidatorCount: 5, MaxValidatorCount: 4, EpochSize: 10}) + require.Error(t, err) + require.Contains(t, err.Error(), "min validator count") + + _, err = PredeployStakingSC(nil, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 1, EpochSize: 0}) + require.Error(t, err) + require.Contains(t, err.Error(), "epoch size") + + _, err = PredeployStakingSC(nil, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 1, EpochSize: 1}) + require.Error(t, err) + require.Contains(t, err.Error(), "epoch size") + + _, err = PredeployStakingSC(nil, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 1, EpochSize: 2}) + require.NoError(t, err) +} + +func TestPredeployStakingSC_RejectsValidatorSetAboveMax(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet( + &validators.ECDSAValidator{Address: types.StringToAddress("0x1")}, + &validators.ECDSAValidator{Address: types.StringToAddress("0x2")}, + ) + + _, err := PredeployStakingSC(vals, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 1, EpochSize: 10}) + require.Error(t, err) + require.Contains(t, err.Error(), "validator set size") +} + +func TestPredeployStakingSC_AllowsValidParams(t *testing.T) { + t.Parallel() + + acc, err := PredeployStakingSC(nil, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 10, EpochSize: 10}) + require.NoError(t, err) + require.NotNil(t, acc) + require.NotEmpty(t, acc.Code) +} + +func TestPredeployStakingSC_SetsJoinedAtBlockForBootstrapValidators(t *testing.T) { + t.Parallel() + + addr := types.StringToAddress("0x123") + vals := validators.NewECDSAValidatorSet(&validators.ECDSAValidator{Address: addr}) + + acc, err := PredeployStakingSC(vals, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 10, EpochSize: 10}) + require.NoError(t, err) + + stakerBase := getAddressMapping(addr, stakerSlot) + joinedKey := types.BytesToHash(getIndexWithOffset(stakerBase, 2)) + require.Equal(t, types.BytesToHash(big.NewInt(1).Bytes()), acc.Storage[joinedKey]) +} + +func TestPredeployStakingSC_BootstrapSetsSelfValidatorAndPackedFlags(t *testing.T) { + t.Parallel() + + addr := types.StringToAddress("0x124") + vals := validators.NewECDSAValidatorSet(&validators.ECDSAValidator{Address: addr}) + + acc, err := PredeployStakingSC(vals, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 10, EpochSize: 10}) + require.NoError(t, err) + + stakerBase := getAddressMapping(addr, stakerSlot) + packedKey := types.BytesToHash(stakerBase) + validatorKey := types.BytesToHash(getIndexWithOffset(stakerBase, 4)) + amountKey := types.BytesToHash(getIndexWithOffset(stakerBase, 1)) + + packedHash := acc.Storage[packedKey] + packed := new(big.Int).SetBytes(packedHash[:]) + require.Equal(t, uint(1), packed.Bit(0), "exists must be set") + require.Equal(t, uint(1), packed.Bit(8), "active must be set") + require.Equal(t, types.BytesToHash(addr.Bytes()), acc.Storage[validatorKey], "bootstrap must be self-validator") + require.Equal(t, types.StringToHash(DefaultStakedBalance), acc.Storage[amountKey], "bootstrap self stake must use default stake") +} + +func TestPredeployStakingSC_ConfigAndValidatorsSlotsRemainStable(t *testing.T) { + t.Parallel() + + addr := types.StringToAddress("0x125") + vals := validators.NewECDSAValidatorSet(&validators.ECDSAValidator{Address: addr}) + acc, err := PredeployStakingSC(vals, PredeployParams{MinValidatorCount: 3, MaxValidatorCount: 9, EpochSize: 17}) + require.NoError(t, err) + + // slot2 = validators length + require.Equal(t, types.BytesToHash(big.NewInt(1).Bytes()), acc.Storage[types.BytesToHash(big.NewInt(validatorsSlot).Bytes())]) + + // _validators[0] + validatorsBase := keccak.Keccak256(nil, common.PadLeftOrTrim(big.NewInt(validatorsSlot).Bytes(), 32)) + require.Equal(t, types.BytesToHash(addr.Bytes()), acc.Storage[types.BytesToHash(validatorsBase)]) + + // slot1 packs epoch|min|max (uint64 each) + cfgHash := acc.Storage[types.BytesToHash(big.NewInt(configSlot).Bytes())] + cfg := new(big.Int).SetBytes(cfgHash[:]) + require.Equal(t, uint64(17), new(big.Int).And(new(big.Int).Set(cfg), big.NewInt(0).SetUint64(^uint64(0))).Uint64()) + tmp := new(big.Int).Rsh(new(big.Int).Set(cfg), 64) + require.Equal(t, uint64(3), new(big.Int).And(new(big.Int).Set(tmp), big.NewInt(0).SetUint64(^uint64(0))).Uint64()) + require.Equal(t, uint64(9), new(big.Int).Rsh(tmp, 64).Uint64()) +} + +func TestPredeployStakingSC_BootstrappedValidatorsAppearInValidatorsArray(t *testing.T) { + t.Parallel() + + v1 := types.StringToAddress("0x126") + v2 := types.StringToAddress("0x127") + vals := validators.NewECDSAValidatorSet( + &validators.ECDSAValidator{Address: v1}, + &validators.ECDSAValidator{Address: v2}, + ) + acc, err := PredeployStakingSC(vals, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 10, EpochSize: 10}) + require.NoError(t, err) + + require.Equal(t, types.BytesToHash(big.NewInt(2).Bytes()), acc.Storage[types.BytesToHash(big.NewInt(validatorsSlot).Bytes())]) + validatorsBase := keccak.Keccak256(nil, common.PadLeftOrTrim(big.NewInt(validatorsSlot).Bytes(), 32)) + require.Equal(t, types.BytesToHash(v1.Bytes()), acc.Storage[types.BytesToHash(validatorsBase)]) + require.Equal(t, types.BytesToHash(v2.Bytes()), acc.Storage[types.BytesToHash(getIndexWithOffset(validatorsBase, 1))]) +} + +func TestPredeployStakingSC_BLSBootstrapStoresValidatorAndPoolBLSData(t *testing.T) { + t.Parallel() + + addr := types.StringToAddress("0x128") + bls := make([]byte, 48) + for i := range bls { + bls[i] = byte(i + 1) + } + vals := validators.NewBLSValidatorSet(validators.NewBLSValidator(addr, bls)) + acc, err := PredeployStakingSC(vals, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 10, EpochSize: 10}) + require.NoError(t, err) + + stakerBase := getAddressMapping(addr, stakerSlot) + poolBase := getAddressMapping(addr, validatorPoolSlot) + + require.NotEqual(t, types.ZeroHash, acc.Storage[types.BytesToHash(stakerBase)], "staker packed entry must exist") + require.NotEqual(t, types.ZeroHash, acc.Storage[types.BytesToHash(getIndexWithOffset(stakerBase, 5))], "staker BLS entry must exist") + require.NotEqual(t, types.ZeroHash, acc.Storage[types.BytesToHash(poolBase)], "pool packed entry must exist") + require.NotEqual(t, types.ZeroHash, acc.Storage[types.BytesToHash(getIndexWithOffset(poolBase, 1))], "pool BLS entry must exist") +} + +func TestPredeployStakingSC_ThresholdSlotUsesTwoMillionXGR(t *testing.T) { + t.Parallel() + + acc, err := PredeployStakingSC(nil, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 10, EpochSize: 10}) + require.NoError(t, err) + + threshold := new(big.Int).SetUint64(2_000_000) + threshold.Mul(threshold, new(big.Int).Exp(big.NewInt(10), big.NewInt(18), nil)) + require.Equal(t, types.BytesToHash(threshold.Bytes()), acc.Storage[types.BytesToHash(big.NewInt(validatorThresholdSlot).Bytes())]) +} + +func TestPredeployStakingSC_DelegatorIndexesUseSlots6And7(t *testing.T) { + t.Parallel() + + addr := types.StringToAddress("0x129") + vals := validators.NewECDSAValidatorSet(&validators.ECDSAValidator{Address: addr}) + acc, err := PredeployStakingSC(vals, PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 10, EpochSize: 10}) + require.NoError(t, err) + + require.Equal(t, int64(6), stakersByValidatorSlot) + require.Equal(t, int64(7), stakerIndexByValSlot) + + stakersByValBase := getAddressMapping(addr, stakersByValidatorSlot) + require.Equal(t, types.BytesToHash(big.NewInt(1).Bytes()), acc.Storage[types.BytesToHash(stakersByValBase)]) + + stakersByValArrayBase := keccak.Keccak256(nil, common.PadLeftOrTrim(stakersByValBase, 32)) + require.Equal(t, types.BytesToHash(addr.Bytes()), acc.Storage[types.BytesToHash(stakersByValArrayBase)]) + + stakerIndexOuter := getAddressMapping(addr, stakerIndexByValSlot) + stakerIndexInner := append(common.PadLeftOrTrim(addr.Bytes(), 32), common.PadLeftOrTrim(stakerIndexOuter, 32)...) + require.Equal(t, types.BytesToHash(big.NewInt(1).Bytes()), acc.Storage[types.BytesToHash(keccak.Keccak256(nil, stakerIndexInner))]) +} diff --git a/jsonrpc/dispatcher.go b/jsonrpc/dispatcher.go index 4141fda..f10272d 100644 --- a/jsonrpc/dispatcher.go +++ b/jsonrpc/dispatcher.go @@ -96,11 +96,11 @@ func newDispatcher( func (d *Dispatcher) registerEndpoints(store JSONRPCStore) error { d.endpoints.Eth = &Eth{ - d.logger, - store, - d.params.chainID, - d.filterManager, - d.params.priceLimit, + logger: d.logger, + store: store, + chainID: d.params.chainID, + filterManager: d.filterManager, + priceLimit: d.params.priceLimit, } d.endpoints.Net = &Net{ store, diff --git a/jsonrpc/eth_blockchain_test.go b/jsonrpc/eth_blockchain_test.go index d3e76f1..4ee982c 100644 --- a/jsonrpc/eth_blockchain_test.go +++ b/jsonrpc/eth_blockchain_test.go @@ -5,6 +5,7 @@ import ( "math/big" "testing" + "github.com/stretchr/testify/assert" "github.com/xgr-network/xgr-node/blockchain" "github.com/xgr-network/xgr-node/chain" "github.com/xgr-network/xgr-node/helper/hex" @@ -12,7 +13,6 @@ import ( "github.com/xgr-network/xgr-node/state/runtime" "github.com/xgr-network/xgr-node/txpool/proto" "github.com/xgr-network/xgr-node/types" - "github.com/stretchr/testify/assert" ) func TestEth_Block_GetBlockByNumber(t *testing.T) { @@ -623,6 +623,10 @@ func (m *mockBlockStore) GetForksInTime(block uint64) chain.ForksInTime { return m.forksInTime } +func (m *mockBlockStore) GetChainParams() *chain.Params { + return nil +} + func (m *mockBlockStore) MaxPriorityFeePerGas() (*big.Int, error) { if m.maxPriorityFeePerGasFn != nil { return m.maxPriorityFeePerGasFn() diff --git a/jsonrpc/eth_endpoint.go b/jsonrpc/eth_endpoint.go index 9fec42e..61a4588 100644 --- a/jsonrpc/eth_endpoint.go +++ b/jsonrpc/eth_endpoint.go @@ -41,6 +41,7 @@ type ethStateStore interface { GetStorage(root types.Hash, addr types.Address, slot types.Hash) ([]byte, error) GetForksInTime(blockNumber uint64) chain.ForksInTime GetCode(root types.Hash, addr types.Address) ([]byte, error) + GetChainParams() *chain.Params } type ethBlockchainStore interface { @@ -98,6 +99,7 @@ type Eth struct { chainID uint64 filterManager *FilterManager priceLimit uint64 + recoveryCache recoveryOverviewCache } var ( @@ -520,6 +522,21 @@ func (e *Eth) Call(arg *txnArgs, filter BlockNumberOrHash, apiOverride *stateOve return nil, err } + // IMPORTANT (eth_call / estimateGas): + // DecodeTxn may source nonce from txpool, which can diverge from state nonce (notably for 0x0). + // For simulation calls, align nonce to the referenced state to avoid "incorrect nonce". + if transaction.Nonce == 0 { + acc, aerr := e.store.GetAccount(header.StateRoot, transaction.From) + if aerr != nil { + if !errors.Is(aerr, ErrStateNotFound) { + return nil, aerr + } + // account not present => nonce 0 is fine + } else { + transaction.Nonce = acc.Nonce + } + } + // If the caller didn't supply the gas limit in the message, then we set it to maximum possible => block gas limit if transaction.Gas == 0 { transaction.Gas = header.GasLimit @@ -575,6 +592,18 @@ func (e *Eth) EstimateGas(arg *txnArgs, rawNum *BlockNumber) (interface{}, error return nil, err } + // Same rationale as eth_call: simulation must not fail on txpool/state nonce divergence. + if transaction.Nonce == 0 { + acc, aerr := e.store.GetAccount(header.StateRoot, transaction.From) + if aerr != nil { + if !errors.Is(aerr, ErrStateNotFound) { + return nil, aerr + } + } else { + transaction.Nonce = acc.Nonce + } + } + forksInTime := e.store.GetForksInTime(header.Number) // IMPORTANT: @@ -688,7 +717,9 @@ ESTIMATE_BY_EXECUTION: availableBalance.Cmp(big.NewInt(0)) > 0 { // Available balance > 0 gasAllowance := new(big.Int).Div(availableBalance, gasPriceInt) - // Check the gas allowance for this account, make sure high end is capped to it + // Check the gas allowance for this account, make sure high end is capped to it. + // If the allowance cannot even cover intrinsic gas, return a deterministic + // insufficient-funds error instead of falling through to an intrinsic-gas error. if gasAllowance.IsUint64() && highEnd > gasAllowance.Uint64() { e.logger.Debug( fmt.Sprintf( @@ -698,6 +729,9 @@ ESTIMATE_BY_EXECUTION: ) highEnd = gasAllowance.Uint64() + if highEnd < standardGas { + return nil, fmt.Errorf("insufficient funds for gas * price + value: %w", state.ErrNotEnoughFundsForGas) + } } } diff --git a/jsonrpc/eth_endpoint_test.go b/jsonrpc/eth_endpoint_test.go index 0a3cf12..6e083ff 100644 --- a/jsonrpc/eth_endpoint_test.go +++ b/jsonrpc/eth_endpoint_test.go @@ -5,10 +5,10 @@ import ( "math/big" "testing" - "github.com/xgr-network/xgr-node/types" "github.com/hashicorp/go-hclog" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/types" ) func TestEth_DecodeTxn(t *testing.T) { @@ -299,13 +299,18 @@ func TestEth_TxnType(t *testing.T) { func newTestEthEndpoint(store testStore) *Eth { return &Eth{ - hclog.NewNullLogger(), store, 100, nil, 0, + logger: hclog.NewNullLogger(), + store: store, + chainID: 100, } } func newTestEthEndpointWithPriceLimit(store testStore, priceLimit uint64) *Eth { return &Eth{ - hclog.NewNullLogger(), store, 100, nil, priceLimit, + logger: hclog.NewNullLogger(), + store: store, + chainID: 100, + priceLimit: priceLimit, } } diff --git a/jsonrpc/eth_pos_microepoch_status.go b/jsonrpc/eth_pos_microepoch_status.go new file mode 100644 index 0000000..edf73a0 --- /dev/null +++ b/jsonrpc/eth_pos_microepoch_status.go @@ -0,0 +1,209 @@ +package jsonrpc + +import ( + "encoding/json" + "fmt" + "math" + "strconv" + "strings" + + stakingHelper "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/types" +) + +type posMicroEpochStatusResponse struct { + BlockNumber argUint64 `json:"blockNumber"` + Enabled bool `json:"enabled"` + ConfigStatus string `json:"configStatus"` + MicroEpochSize argUint64 `json:"microEpochSize"` + CurrentMicroEpoch argUint64 `json:"currentMicroEpoch"` + CurrentMicroEpochStartBlock argUint64 `json:"currentMicroEpochStartBlock"` + CurrentMicroEpochEndBlock argUint64 `json:"currentMicroEpochEndBlock"` + LastAppliedMicroEpoch argUint64 `json:"lastAppliedMicroEpoch"` + NominalWeightUnits argUint64 `json:"nominalWeightUnits"` + InactivityDecayBps argUint64 `json:"inactivityDecayBps"` + Validators []posMicroEpochValidatorState `json:"validators"` +} + +type posMicroEpochValidatorState struct { + Address types.Address `json:"address"` + UptimeNominalWeight argUint64 `json:"uptimeNominalWeight"` + UptimeEffectiveWeight argUint64 `json:"uptimeEffectiveWeight"` + UptimeInactivity argUint64 `json:"uptimeInactivity"` + MicroNominalWeight argUint64 `json:"microNominalWeight"` + MicroEffectiveWeight argUint64 `json:"microEffectiveWeight"` + MicroInactivity argUint64 `json:"microInactivity"` + WeightStateInitialized bool `json:"weightStateInitialized"` +} + +// GetPosMicroEpochStatus exposes the block-based micro-epoch uptime/weight state. +// It is intentionally independent from the removed beacon/recovery path. +func (e *Eth) GetPosMicroEpochStatus() (interface{}, error) { + head := e.store.Header() + if head == nil { + return nil, fmt.Errorf("header has a nil value") + } + + cfg := readMicroEpochConfigFromChain(e.store.GetChainParams().Engine) + enabled := cfg.microEpochSize > 0 && cfg.nominalWeightUnits > 0 + status := "active" + if !enabled { + status = "micro-epoch uptime is not configured or disabled" + } + + currentME := uint64(0) + startBlock := uint64(0) + endBlock := uint64(0) + if cfg.microEpochSize > 0 && head.Number > 0 { + currentME = (head.Number - 1) / cfg.microEpochSize + startBlock = currentME*cfg.microEpochSize + 1 + endBlock = (currentME + 1) * cfg.microEpochSize + } + + rt := &stakingQueryRuntime{store: e.store, header: head} + validators, err := stakingHelper.QueryValidators(rt, types.ZeroAddress) + if err != nil { + return nil, err + } + + items := make([]posMicroEpochValidatorState, 0, len(validators)) + for _, addr := range validators { + nominal := readBigFromPosSys(e, head.StateRoot, keyUptimeNominalWeight(addr)).Uint64() + effective := readBigFromPosSys(e, head.StateRoot, keyUptimeEffectiveWeight(addr)).Uint64() + inactivity := readBigFromPosSys(e, head.StateRoot, keyUptimeInactivity(addr)).Uint64() + items = append(items, posMicroEpochValidatorState{ + Address: addr, + UptimeNominalWeight: argUint64(nominal), + UptimeEffectiveWeight: argUint64(effective), + UptimeInactivity: argUint64(inactivity), + MicroNominalWeight: argUint64(nominal), + MicroEffectiveWeight: argUint64(effective), + MicroInactivity: argUint64(inactivity), + WeightStateInitialized: nominal > 0 || effective > 0 || inactivity > 0, + }) + } + + return &posMicroEpochStatusResponse{ + BlockNumber: argUint64(head.Number), + Enabled: enabled, + ConfigStatus: status, + MicroEpochSize: argUint64(cfg.microEpochSize), + CurrentMicroEpoch: argUint64(currentME), + CurrentMicroEpochStartBlock: argUint64(startBlock), + CurrentMicroEpochEndBlock: argUint64(endBlock), + LastAppliedMicroEpoch: argUint64(readBigFromPosSys(e, head.StateRoot, keyMicroEpochAppliedStatus()).Uint64()), + NominalWeightUnits: argUint64(cfg.nominalWeightUnits), + InactivityDecayBps: argUint64(cfg.inactivityDecayBps), + Validators: items, + }, nil +} + +func keyMicroEpochAppliedStatus() types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte("xgr.uptime.microepoch.last.applied"))) +} + +type microEpochConfigView struct { + microEpochSize uint64 + nominalWeightUnits uint64 + inactivityDecayBps uint64 +} + +func readMicroEpochConfigFromChain(engine map[string]interface{}) microEpochConfigView { + return microEpochConfigView{ + microEpochSize: firstConfigUint(engine, "microEpochSize", "microEpochSlots", "uptimeSlotsPerEpoch"), + nominalWeightUnits: firstConfigUint(engine, "microEpochNominalWeightUnits", "nominalWeightUnits", "uptimeNominalWeightUnits"), + inactivityDecayBps: firstConfigUint(engine, "microEpochInactivityDecayBps", "inactivityDecayBps", "uptimeInactivityDecayBps"), + } +} + +func firstConfigUint(root interface{}, keys ...string) uint64 { + for _, key := range keys { + if value, ok := findConfigValue(root, key); ok { + if n, ok := coerceConfigUint(value); ok { + return n + } + } + } + return 0 +} + +func findConfigValue(node interface{}, key string) (interface{}, bool) { + switch v := node.(type) { + case map[string]interface{}: + if raw, ok := v[key]; ok { + return raw, true + } + for _, child := range v { + if raw, ok := findConfigValue(child, key); ok { + return raw, true + } + } + case []interface{}: + for _, child := range v { + if raw, ok := findConfigValue(child, key); ok { + return raw, true + } + } + } + return nil, false +} + +func coerceConfigUint(raw interface{}) (uint64, bool) { + switch v := raw.(type) { + case uint64: + return v, true + case uint: + return uint64(v), true + case uint32: + return uint64(v), true + case int: + if v < 0 { + return 0, false + } + return uint64(v), true + case int64: + if v < 0 { + return 0, false + } + return uint64(v), true + case int32: + if v < 0 { + return 0, false + } + return uint64(v), true + case float64: + if v < 0 || math.Trunc(v) != v { + return 0, false + } + return uint64(v), true + case float32: + f := float64(v) + if f < 0 || math.Trunc(f) != f { + return 0, false + } + return uint64(f), true + case json.Number: + n, err := v.Int64() + if err != nil || n < 0 { + return 0, false + } + return uint64(n), true + case string: + t := strings.TrimSpace(v) + if t == "" { + return 0, false + } + base := 10 + if strings.HasPrefix(t, "0x") || strings.HasPrefix(t, "0X") { + base = 16 + t = t[2:] + } + n, err := strconv.ParseUint(t, base, 64) + if err != nil { + return 0, false + } + return n, true + } + return 0, false +} diff --git a/jsonrpc/eth_pos_microepoch_status_test.go b/jsonrpc/eth_pos_microepoch_status_test.go new file mode 100644 index 0000000..5bc9296 --- /dev/null +++ b/jsonrpc/eth_pos_microepoch_status_test.go @@ -0,0 +1,19 @@ +package jsonrpc + +import "testing" + +func TestReadMicroEpochConfigFromChain_StringValues(t *testing.T) { + engine := map[string]interface{}{ + "ibft": map[string]interface{}{ + "config": map[string]interface{}{ + "microEpochSize": "0x8", + "microEpochNominalWeightUnits": "10000", + "microEpochInactivityDecayBps": "9000", + }, + }, + } + cfg := readMicroEpochConfigFromChain(engine) + if cfg.microEpochSize != 8 || cfg.nominalWeightUnits != 10000 || cfg.inactivityDecayBps != 9000 { + t.Fatalf("unexpected cfg: %+v", cfg) + } +} diff --git a/jsonrpc/eth_pos_overview.go b/jsonrpc/eth_pos_overview.go new file mode 100644 index 0000000..494e945 --- /dev/null +++ b/jsonrpc/eth_pos_overview.go @@ -0,0 +1,1448 @@ +package jsonrpc + +import ( + "encoding/binary" + "fmt" + "math/big" + "sort" + "strings" + "sync" + + "github.com/umbracle/ethgo" + "github.com/xgr-network/xgr-node/chain" + ibftFork "github.com/xgr-network/xgr-node/consensus/ibft/fork" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/contracts/abis" + stakingHelper "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/state/runtime" + "github.com/xgr-network/xgr-node/types" + validatorTypes "github.com/xgr-network/xgr-node/validators" +) + +const ( + defaultIBFTEpochSize uint64 = 100000 +) + +type stakingQueryRuntime struct { + store ethStore + header *types.Header + nonPayable bool +} + +func (s *stakingQueryRuntime) Apply(tx *types.Transaction) (*runtime.ExecutionResult, error) { + return s.store.ApplyTxn(s.header, tx, nil, s.nonPayable) +} + +func (s *stakingQueryRuntime) GetNonce(addr types.Address) uint64 { + return s.store.GetNonce(addr) +} + +func (s *stakingQueryRuntime) SetNonPayable(nonPayable bool) { + s.nonPayable = nonPayable +} + +type posValidatorOverview struct { + Address types.Address `json:"address"` + JoinedAtBlock *argUint64 `json:"joinedAtBlock,omitempty"` + JoinEffectiveAtBlock *argUint64 `json:"joinEffectiveAtBlock,omitempty"` + CurrentStake *argBig `json:"currentStake"` + SelfStake *argBig `json:"selfStake,omitempty"` + DelegatedRawStake *argBig `json:"delegatedRawStake,omitempty"` + DelegatedActiveStake *argBig `json:"delegatedActiveStake,omitempty"` + TotalActiveCurrentStake *argBig `json:"totalActiveCurrentStake,omitempty"` + CurrentlyValidating bool `json:"currentlyValidating"` + StakingActive bool `json:"stakingActive"` + DeactivatedAtBlock *argUint64 `json:"deactivatedAtBlock,omitempty"` + DeactivateEffectiveAtBlock *argUint64 `json:"deactivateEffectiveAtBlock,omitempty"` + UnstakeAvailableAtBlock *argUint64 `json:"unstakeAvailableAtBlock,omitempty"` + CanUnstakeNow bool `json:"canUnstakeNow"` + WasValidatorLastEpoch bool `json:"wasValidatorLastEpoch"` + ReportedEpochReward *argBig `json:"reportedEpochReward,omitempty"` + ReportedEpochRewardValidatorNet *argBig `json:"reportedEpochRewardValidatorNet,omitempty"` + ReportedEpochRewardCommission *argBig `json:"reportedEpochRewardCommission,omitempty"` + ReportedEpochRewardDelegatorsNet *argBig `json:"reportedEpochRewardDelegatorsNet,omitempty"` + + RewardIneligible *bool `json:"rewardIneligible,omitempty"` + Slashed *bool `json:"slashed,omitempty"` + MicroNominalWeight *argUint64 `json:"microNominalWeight,omitempty"` + MicroEffectiveWeight *argUint64 `json:"microEffectiveWeight,omitempty"` + MicroInactivity *argUint64 `json:"microInactivity,omitempty"` + + ProposalUptimeLast3EpochsBps *argUint64 `json:"proposalUptimeLast3EpochsBps,omitempty"` + ProposalUptimeLast10EpochsBps *argUint64 `json:"proposalUptimeLast10EpochsBps,omitempty"` + ProposalUptimeLast3EpochsPercent *argUint64 `json:"proposalUptimeLast3EpochsPercent,omitempty"` + ProposalUptimeLast10EpochsPercent *argUint64 `json:"proposalUptimeLast10EpochsPercent,omitempty"` + ProposalUptimeLast3EpochsObserved argUint64 `json:"proposalUptimeLast3EpochsObserved"` + ProposalUptimeLast10EpochsObserved argUint64 `json:"proposalUptimeLast10EpochsObserved"` +} + +type posOverviewResponse struct { + BlockNumber argUint64 `json:"blockNumber"` + EpochSize argUint64 `json:"epochSize"` + MicroEpochSize argUint64 `json:"microEpochSize"` + CurrentMicroEpoch argUint64 `json:"currentMicroEpoch"` + CurrentMicroEpochStartBlock argUint64 `json:"currentMicroEpochStartBlock"` + CurrentMicroEpochEndBlock argUint64 `json:"currentMicroEpochEndBlock"` + CurrentEpoch argUint64 `json:"currentEpoch"` + LastFinalizedEpoch argUint64 `json:"lastFinalizedEpoch"` + ReportedEpoch argUint64 `json:"reportedEpoch"` + ReportedEpochStartBlock argUint64 `json:"reportedEpochStartBlock"` + ReportedEpochEndBlock argUint64 `json:"reportedEpochEndBlock"` + CurrentEpochPendingRewards *argBig `json:"currentEpochPendingRewards"` + StakingContractBalance *argBig `json:"stakingContractBalance"` + MinimumNumValidators argUint64 `json:"minimumNumValidators"` + MaximumNumValidators argUint64 `json:"maximumNumValidators"` + ValidatorThreshold *argBig `json:"validatorThreshold"` + TotalCurrentStake *argBig `json:"totalCurrentStake"` + TotalValidatorSelfStake *argBig `json:"totalValidatorSelfStake"` + TotalDelegatedRawStake *argBig `json:"totalDelegatedRawStake"` + TotalDelegatedActiveStake *argBig `json:"totalDelegatedActiveStake"` + TotalActiveCurrentStake *argBig `json:"totalActiveCurrentStake"` + RewardIneligibleCount *argUint64 `json:"rewardIneligibleCount,omitempty"` + SlashedCount *argUint64 `json:"slashedCount,omitempty"` + + RewardIneligibleStatusExact bool `json:"rewardIneligibleStatusExact"` + SlashStatusExact bool `json:"slashStatusExact"` + LastRoundStakeExact bool `json:"lastRoundStakeExact"` + LastRoundDistributedStake *argBig `json:"lastRoundDistributedStake,omitempty"` + + MonitoringNotes []string `json:"monitoringNotes"` + Validators []posValidatorOverview `json:"validators"` + PoSActive bool `json:"posActive"` + PoSFromBlock *argUint64 `json:"posFromBlock,omitempty"` +} + +type posDelegatorEntry struct { + Delegator types.Address `json:"delegator"` + Amount *argBig `json:"amount"` + EpochEffectiveAmount *argBig `json:"epochEffectiveAmount,omitempty"` + ReportedEpochReward *argBig `json:"reportedEpochReward,omitempty"` + Active bool `json:"active"` + JoinedAtBlock *argUint64 `json:"joinedAtBlock,omitempty"` + DeactivatedAtBlock *argUint64 `json:"deactivatedAtBlock,omitempty"` + EffectiveAtPoint bool `json:"effectiveAtPoint"` +} + +type posValidatorDelegatorsResponse struct { + Validator types.Address `json:"validator"` + SelfStake *argBig `json:"selfStake"` + DelegatedRaw *argBig `json:"delegatedRaw"` + DelegatedActive *argBig `json:"delegatedActive"` + DelegatedActiveCurrent *argBig `json:"delegatedActiveCurrent"` + TotalActiveCurrentStake *argBig `json:"totalActiveCurrentStake"` + SelfStakeLive *argBig `json:"selfStakeLive,omitempty"` + DelegatedLiveRaw *argBig `json:"delegatedLiveRaw,omitempty"` + DelegatedLiveActive *argBig `json:"delegatedLiveActive,omitempty"` + TotalLiveStake *argBig `json:"totalLiveStake,omitempty"` + SelfStakeEpochEffective *argBig `json:"selfStakeEpochEffective,omitempty"` + DelegatedEpochEffective *argBig `json:"delegatedEpochEffective,omitempty"` + TotalEpochEffectiveStake *argBig `json:"totalEpochEffectiveStake,omitempty"` + DelegationEnabled bool `json:"delegationEnabled"` + MaxTotalDelegatedStake *argBig `json:"maxTotalDelegatedStake"` + MinDelegatorStake *argBig `json:"minDelegatorStake"` + EffectiveMinDelegatorStake *argBig `json:"effectiveMinDelegatorStake"` + CommissionBps argUint64 `json:"commissionBps"` + Delegators []posDelegatorEntry `json:"delegators"` +} + +// GetPosValidatorsOverview returns a deterministic PoS validator overview. +// +// Important: reward eligibility/slash and epoch reward distribution are not exposed directly by +// the current staking ABI, so this endpoint does NOT fabricate these values. +func (e *Eth) GetPosValidatorsOverview(reportEpoch *string) (interface{}, error) { + head := e.store.Header() + if head == nil { + return nil, fmt.Errorf("header has a nil value") + } + + epochSize := resolveIBFTEpochSize(e.store.GetChainParams()) + posFrom, hasPoS := resolvePoSFromBlock(e.store.GetChainParams()) + + currentEpoch := epochOf(head.Number, epochSize) + lastFinalizedEpoch := head.Number / epochSize + reportedEpoch := currentEpoch + if reportEpoch != nil { + switch *reportEpoch { + case "current": + reportedEpoch = currentEpoch + case "lastFinalized": + reportedEpoch = lastFinalizedEpoch + default: + return nil, fmt.Errorf("invalid reportEpoch %q (expected \"current\" or \"lastFinalized\")", *reportEpoch) + } + } + if hasPoS && head.Number < posFrom { + return nil, fmt.Errorf("PoS is not active yet (activates at block %d)", posFrom) + } + + reportedEpochStart := uint64(0) + reportedEpochEnd := uint64(0) + if reportedEpoch > 0 { + reportedEpochStart = (reportedEpoch-1)*epochSize + 1 + reportedEpochEnd = reportedEpoch * epochSize + if reportedEpoch == currentEpoch { + reportedEpochEnd = head.Number + } + } + + runtimeAdapter := &stakingQueryRuntime{store: e.store, header: head} + + validators, err := stakingHelper.QueryValidators(runtimeAdapter, types.ZeroAddress) + if err != nil { + return nil, err + } + + minV, err := stakingHelper.QueryMinimumNumValidators(runtimeAdapter, types.ZeroAddress) + if err != nil { + return nil, err + } + maxV, err := stakingHelper.QueryMaximumNumValidators(runtimeAdapter, types.ZeroAddress) + if err != nil { + return nil, err + } + threshold, err := stakingHelper.QueryValidatorThreshold(runtimeAdapter, types.ZeroAddress) + if err != nil { + return nil, err + } + + infos := make(map[types.Address]*posValidatorOverview, len(validators)) + totalCurrentStake := big.NewInt(0) + totalValidatorSelfStake := big.NewInt(0) + totalDelegatedRawStake := big.NewInt(0) + totalDelegatedActiveStake := big.NewInt(0) + totalActiveCurrentStake := big.NewInt(0) + contractEpochNow := uint64(0) + currentEpochSnapshot := readValidatorsFromConsensusHeader(e, head.Number) + lastFinalizedEpochEnd := uint64(0) + if lastFinalizedEpoch > 0 { + lastFinalizedEpochEnd = lastFinalizedEpoch * epochSize + if lastFinalizedEpoch == currentEpoch { + lastFinalizedEpochEnd = head.Number + } + } + lastFinalizedSnapshot := readValidatorsForEpoch(e, head.StateRoot, lastFinalizedEpoch, lastFinalizedEpochEnd) + if len(lastFinalizedSnapshot) == 0 && lastFinalizedEpoch > 0 && epochSize > 0 { + lastFinalizedSnapshot = readValidatorsFromConsensusHeader(e, lastFinalizedEpoch*epochSize-1) + } + if epochSize > 0 { + contractEpochNow = head.Number / epochSize + } + + for _, addr := range validators { + stakeAmt, stakeErr := stakingHelper.QueryAccountStake(runtimeAdapter, types.ZeroAddress, addr) + if stakeErr != nil { + return nil, stakeErr + } + totalCurrentStake.Add(totalCurrentStake, stakeAmt) + + delegatedRaw, err := callStakeUintMethod(runtimeAdapter, "validatorDelegatedStakeRaw", addr) + if err != nil { + return nil, err + } + delegatedActive, err := callStakeUintMethod(runtimeAdapter, "validatorDelegatedStakeActive", addr) + if err != nil { + return nil, err + } + totalActive := new(big.Int).Add(new(big.Int).Set(stakeAmt), delegatedActive) + + totalValidatorSelfStake.Add(totalValidatorSelfStake, stakeAmt) + totalDelegatedRawStake.Add(totalDelegatedRawStake, delegatedRaw) + totalDelegatedActiveStake.Add(totalDelegatedActiveStake, delegatedActive) + totalActiveCurrentStake.Add(totalActiveCurrentStake, totalActive) + + entry := &posValidatorOverview{ + Address: addr, + CurrentStake: argBigPtr(new(big.Int).Set(stakeAmt)), + SelfStake: argBigPtr(new(big.Int).Set(stakeAmt)), + DelegatedRawStake: argBigPtr(new(big.Int).Set(delegatedRaw)), + DelegatedActiveStake: argBigPtr(new(big.Int).Set(delegatedActive)), + TotalActiveCurrentStake: argBigPtr(totalActive), + } + if joinedAt, jErr := queryJoinedAtBlockRuntime(runtimeAdapter, addr); jErr == nil && joinedAt > 0 { + entry.JoinedAtBlock = argUintPtr(joinedAt) + if epochSize > 0 { + joinEpoch := joinedAt / epochSize + entry.JoinEffectiveAtBlock = argUintPtr((joinEpoch + 1) * epochSize) + } + } + + if vinfo, vErr := stakingHelper.QueryValidatorInfo(runtimeAdapter, types.ZeroAddress, addr); vErr == nil && vinfo != nil { + entry.StakingActive = vinfo.Active + + deactBlock := uint64(0) + if vinfo.DeactivatedAtBlock != nil && vinfo.DeactivatedAtBlock.Sign() > 0 { + deactBlock = vinfo.DeactivatedAtBlock.Uint64() + entry.DeactivatedAtBlock = argUintPtr(deactBlock) + + if epochSize > 0 { + deactEpoch := deactBlock / epochSize + entry.UnstakeAvailableAtBlock = argUintPtr((deactEpoch + 1) * epochSize) + entry.CanUnstakeNow = !vinfo.Active && contractEpochNow > deactEpoch + } + } + + entry.CurrentlyValidating = false + if deactBlock > 0 { + if epochSize > 0 { + deactEpoch := deactBlock / epochSize + entry.DeactivateEffectiveAtBlock = argUintPtr((deactEpoch + 1) * epochSize) + } + } + } else { + entry.CurrentlyValidating = false + } + + // Finalized reward/slash history is emitted as PosSysAddr system logs, not retained + // in PosSysAddr storage. RPC exposes live staking state only. + last3 := computeProposalWindowUptimeMetrics(e, head.StateRoot, entry, reportedEpoch, epochSize, 3) + entry.ProposalUptimeLast3EpochsObserved = argUint64(last3.observedSlots) + if last3.uptimeBps != nil { + entry.ProposalUptimeLast3EpochsBps = argUintPtr(*last3.uptimeBps) + pct := *last3.uptimeBps / 100 + entry.ProposalUptimeLast3EpochsPercent = argUintPtr(pct) + } + last10 := computeProposalWindowUptimeMetrics(e, head.StateRoot, entry, reportedEpoch, epochSize, 10) + entry.ProposalUptimeLast10EpochsObserved = argUint64(last10.observedSlots) + if last10.uptimeBps != nil { + entry.ProposalUptimeLast10EpochsBps = argUintPtr(*last10.uptimeBps) + pct := *last10.uptimeBps / 100 + entry.ProposalUptimeLast10EpochsPercent = argUintPtr(pct) + } + _, entry.WasValidatorLastEpoch = lastFinalizedSnapshot[addr] + nomW := readBigFromPosSys(e, head.StateRoot, keyUptimeNominalWeight(addr)).Uint64() + effW := readBigFromPosSys(e, head.StateRoot, keyUptimeEffectiveWeight(addr)).Uint64() + inact := readBigFromPosSys(e, head.StateRoot, keyUptimeInactivity(addr)).Uint64() + if nomW > 0 || effW > 0 || inact > 0 { + entry.MicroNominalWeight = argUintPtr(nomW) + entry.MicroEffectiveWeight = argUintPtr(effW) + entry.MicroInactivity = argUintPtr(inact) + } + + infos[addr] = entry + } + + // Source-of-truth: current consensus header validator snapshot only (no fallback heuristics). + for addr, entry := range infos { + _, entry.CurrentlyValidating = currentEpochSnapshot[addr] + + } + + reportedEpochValidators := readValidatorsForEpoch(e, head.StateRoot, reportedEpoch, reportedEpochEnd) + if len(reportedEpochValidators) == 0 { + switch { + case reportedEpoch == currentEpoch: + reportedEpochValidators = currentEpochSnapshot + case reportedEpoch > 0 && epochSize > 0: + reportedEpochValidators = readValidatorsFromConsensusHeader(e, reportedEpoch*epochSize-1) + } + } + currentEpochPendingRewards := new(big.Int) + if feePoolAcc, accErr := e.store.GetAccount(head.StateRoot, state.FeePoolAddress); accErr == nil && feePoolAcc != nil && feePoolAcc.Balance != nil { + currentEpochPendingRewards = new(big.Int).Set(feePoolAcc.Balance) + } + stakingContractBalance := new(big.Int) + if stakingAcc, accErr := e.store.GetAccount(head.StateRoot, stakingHelper.AddrStakingContract); accErr == nil && stakingAcc != nil && stakingAcc.Balance != nil { + stakingContractBalance = new(big.Int).Set(stakingAcc.Balance) + } + + validatorList := make([]posValidatorOverview, 0, len(infos)) + var rewardIneligibleCount uint64 + var slashedCount uint64 + for _, entry := range infos { + _, wasValidatorInReportedEpoch := reportedEpochValidators[entry.Address] + + rewardIneligible := false + if wasValidatorInReportedEpoch { + rewardIneligible = isValidatorRewardIneligibleInEpoch(e, head.StateRoot, entry.Address, reportedEpoch) + } + + slashed := false + + entry.RewardIneligible = &rewardIneligible + entry.Slashed = &slashed + if rewardIneligible { + rewardIneligibleCount++ + } + if slashed { + slashedCount++ + } + + validatorList = append(validatorList, *entry) + } + sort.Slice(validatorList, func(i, j int) bool { + return validatorList[i].Address.String() < validatorList[j].Address.String() + }) + + lastRoundDistributedStake := new(big.Int) + + cfg := readMicroEpochConfigFromChain(e.store.GetChainParams().Engine) + microEpochSize := cfg.microEpochSize + validatorCount := uint64(len(currentEpochSnapshot)) + if validatorCount == 0 { + validatorCount = uint64(len(validatorList)) + } + if microEpochSize > 0 && validatorCount > 0 && microEpochSize < validatorCount { + microEpochSize = 0 + } + currentMicroEpoch := uint64(0) + currentMicroEpochStart := uint64(0) + currentMicroEpochEnd := uint64(0) + if microEpochSize > 0 && head.Number > 0 { + currentMicroEpoch = (head.Number - 1) / microEpochSize + currentMicroEpochStart = currentMicroEpoch*microEpochSize + 1 + currentMicroEpochEnd = (currentMicroEpoch + 1) * microEpochSize + } + + res := &posOverviewResponse{ + BlockNumber: argUint64(head.Number), + EpochSize: argUint64(epochSize), + MicroEpochSize: argUint64(microEpochSize), + CurrentMicroEpoch: argUint64(currentMicroEpoch), + CurrentMicroEpochStartBlock: argUint64(currentMicroEpochStart), + CurrentMicroEpochEndBlock: argUint64(currentMicroEpochEnd), + CurrentEpoch: argUint64(currentEpoch), + LastFinalizedEpoch: argUint64(lastFinalizedEpoch), + ReportedEpoch: argUint64(reportedEpoch), + ReportedEpochStartBlock: argUint64(reportedEpochStart), + ReportedEpochEndBlock: argUint64(reportedEpochEnd), + CurrentEpochPendingRewards: argBigPtr(currentEpochPendingRewards), + StakingContractBalance: argBigPtr(stakingContractBalance), + MinimumNumValidators: argUint64(minV), + MaximumNumValidators: argUint64(maxV), + ValidatorThreshold: argBigPtr(threshold), + TotalCurrentStake: argBigPtr(totalCurrentStake), + TotalValidatorSelfStake: argBigPtr(totalValidatorSelfStake), + TotalDelegatedRawStake: argBigPtr(totalDelegatedRawStake), + TotalDelegatedActiveStake: argBigPtr(totalDelegatedActiveStake), + TotalActiveCurrentStake: argBigPtr(totalActiveCurrentStake), + RewardIneligibleCount: argUintPtr(rewardIneligibleCount), + SlashedCount: argUintPtr(slashedCount), + RewardIneligibleStatusExact: true, + SlashStatusExact: false, + LastRoundStakeExact: false, + LastRoundDistributedStake: argBigPtr(lastRoundDistributedStake), + MonitoringNotes: []string{ + "currentlyValidating is derived strictly from current consensus header validator set (no heuristic fallback)", + "wasValidatorLastEpoch prefers epoch-keyed PoS state and falls back to last-finalized epoch-end header snapshot if state is missing", + "joinEffectiveAtBlock/deactivateEffectiveAtBlock are deterministic epoch-boundary activation/deactivation markers", + "rewardIneligible is computed only for validators present in reportedEpoch set, using proposer slots/missed counters", + "proposalUptimeLast{3,10}Epochs* are rolling proposer-duty reliability metrics (not lifetime uptime); epochs outside join/deactivation-effective bounds are excluded", + "proposalUptime...Observed reports total proposer duties observed in each window; if 0 then uptime fields are omitted (no fake 100%)", + "Historical rewards/slashes/staker stake-after values are emitted as PosSysAddr system logs and must be indexed from receipts. PoS RPC exposes live staking state and optionally current/pending epoch working data only. Finalized epoch working state is deleted after FinalizeEpoch.", + "currentEpochPendingRewards is the live FeePool balance that will be distributed at the next epoch switch", + "stakingContractBalance is the live on-chain balance of the staking contract and helps detect reward-credit mismatches", + "unstakeAvailableAtBlock/canUnstakeNow are derived from validatorInfo.deactivatedAtBlock and epoch size", + "all returned numeric stake metrics are deterministic and derived directly from contract state + events", + "micro* fields expose the current micro-epoch uptime accounting weights used as multiplier in the weighted PoS path", + "microEpoch* fields describe the current block-based micro-epoch used for uptime weight accounting", + }, + Validators: validatorList, + PoSActive: !hasPoS || head.Number >= posFrom, + } + if hasPoS { + res.PoSFromBlock = argUintPtr(posFrom) + } + + return res, nil +} + +func (e *Eth) GetBeaconTimeStatus() (interface{}, error) { + // Deprecated legacy endpoint; beacon recovery path has been removed. + return map[string]interface{}{ + "enabled": false, + "active": false, + "healthy": false, + "deprecated": true, + "reason": "deprecated", + }, nil +} + +// GetPosValidatorDelegators returns delegator details for one validator. +func (e *Eth) GetPosValidatorDelegators(validator types.Address, reportEpoch *string) (interface{}, error) { + head := e.store.Header() + if head == nil { + return nil, fmt.Errorf("header has a nil value") + } + epochSize := resolveIBFTEpochSize(e.store.GetChainParams()) + currentEpoch := epochOf(head.Number, epochSize) + lastFinalizedEpoch := head.Number / epochSize + reportedEpoch := currentEpoch + if reportEpoch != nil { + switch *reportEpoch { + case "current": + reportedEpoch = currentEpoch + case "lastFinalized": + reportedEpoch = lastFinalizedEpoch + default: + return nil, fmt.Errorf("invalid reportEpoch %q (expected \"current\" or \"lastFinalized\")", *reportEpoch) + } + } + + rt := &stakingQueryRuntime{store: e.store, header: head} + selfStake, _ := callStakeUintMethod(rt, "validatorSelfStake", validator) + delegatedRaw, _ := callStakeUintMethod(rt, "validatorDelegatedStakeRaw", validator) + delegatedActive, _ := callStakeUintMethod(rt, "validatorDelegatedStakeActive", validator) + poolConfig, _ := callStakePoolMethod(rt, validator) + if poolConfig == nil { + poolConfig = &validatorPoolRPCView{MaxTotalDelegatedStake: new(big.Int)} + } + totalActiveCurrent := new(big.Int).Add(new(big.Int).Set(selfStake), delegatedActive) + delegatedActiveCurrent := new(big.Int).Sub(new(big.Int).Set(totalActiveCurrent), selfStake) + if delegatedActiveCurrent.Sign() < 0 { + delegatedActiveCurrent = new(big.Int) + } + + entries := make([]posDelegatorEntry, 0) + count, err := callStakeUintMethod(rt, "validatorStakerCount", validator) + if err != nil { + return nil, err + } + + for i := uint64(0); i < count.Uint64(); i++ { + owner, oErr := callStakeAddressMethod(rt, "validatorStakerAt", validator, i) + if oErr != nil { + return nil, oErr + } + if owner == validator { + continue + } + staker, sErr := stakingHelper.QueryStakerInfo(rt, types.ZeroAddress, owner) + if sErr != nil || staker == nil { + continue + } + joined := uint64(0) + if staker.JoinedAtBlock != nil { + joined = staker.JoinedAtBlock.Uint64() + } + deact := uint64(0) + if staker.DeactivatedAtBlock != nil { + deact = staker.DeactivatedAtBlock.Uint64() + } + snapAmount := readBigFromPosSys(e, head.StateRoot, keyStakerStakeSnapshot(reportedEpoch, owner)) + entries = append(entries, posDelegatorEntry{ + Delegator: owner, + Amount: argBigPtr(staker.Amount), + EpochEffectiveAmount: argBigPtr(snapAmount), + Active: staker.Active, + JoinedAtBlock: argUintPtr(joined), + DeactivatedAtBlock: argUintPtr(deact), + EffectiveAtPoint: snapAmount.Sign() > 0, + }) + } + selfEpochEffective := readBigFromPosSys(e, head.StateRoot, keyStakerStakeSnapshot(reportedEpoch, validator)) + delegatedEpochEffective := new(big.Int) + for _, entry := range entries { + if entry.EffectiveAtPoint { + delegatedEpochEffective.Add(delegatedEpochEffective, (*big.Int)(entry.EpochEffectiveAmount)) + } + } + totalEpochEffective := readBigFromPosSys(e, head.StateRoot, keyStakeSnapshot(reportedEpoch, validator)) + + sort.Slice(entries, func(i, j int) bool { return entries[i].Delegator.String() < entries[j].Delegator.String() }) + + return &posValidatorDelegatorsResponse{ + Validator: validator, + SelfStake: argBigPtr(selfStake), + DelegatedRaw: argBigPtr(delegatedRaw), + DelegatedActive: argBigPtr(delegatedActive), + DelegatedActiveCurrent: argBigPtr(delegatedActiveCurrent), + TotalActiveCurrentStake: argBigPtr(totalActiveCurrent), + SelfStakeLive: argBigPtr(new(big.Int).Set(selfStake)), + DelegatedLiveRaw: argBigPtr(new(big.Int).Set(delegatedRaw)), + DelegatedLiveActive: argBigPtr(new(big.Int).Set(delegatedActive)), + TotalLiveStake: argBigPtr(totalActiveCurrent), + SelfStakeEpochEffective: argBigPtr(selfEpochEffective), + DelegatedEpochEffective: argBigPtr(delegatedEpochEffective), + TotalEpochEffectiveStake: argBigPtr(totalEpochEffective), + DelegationEnabled: poolConfig.DelegationEnabled, + MaxTotalDelegatedStake: argBigPtr(poolConfig.MaxTotalDelegatedStake), + MinDelegatorStake: argBigPtr(poolConfig.MinDelegatorStake), + EffectiveMinDelegatorStake: argBigPtr(poolConfig.EffectiveMinDelegatorStake), + CommissionBps: argUint64(poolConfig.CommissionBps), + Delegators: entries, + }, nil +} + +func uint64Ptr(v uint64) *uint64 { + return &v +} + +func boolPtr(v bool) *bool { + return &v +} + +func stringPtr(v string) *string { + return &v +} + +func int64Ptr(v int64) *int64 { + return &v +} + +type recoveryEvidenceCache struct { + epochStart uint64 + currentSlot uint64 + lastScannedNum uint64 + lastScannedHash types.Hash + evidence map[uint64]map[string]struct{} +} + +type recoveryOverviewCache struct { + mu sync.Mutex + state *recoveryEvidenceCache +} + +func (e *Eth) computeRecoveryOverviewPowers( + head *types.Header, + currentValidators map[types.Address]struct{}, +) (map[string]uint64, string) { + store := e.store + if store == nil || head == nil { + return nil, "deprecated_legacy_endpoint" + } + meta, ok := resolveUptimeMeta(store.GetChainParams()) + if !ok { + return nil, "deprecated_legacy_endpoint" + } + + currentSlot := slotAtTimestamp(meta, head.Timestamp) + if currentSlot == 0 { + return nil, "deprecated_legacy_endpoint" + } + epochStart := epochAtSlot(meta, currentSlot) * meta.slotsPerEpoch + + validatorsByAddr := make(map[string]types.Address, len(currentValidators)) + for addr := range currentValidators { + validatorsByAddr[strings.ToLower(addr.String())] = addr + } + if len(validatorsByAddr) == 0 { + return nil, "deprecated_legacy_endpoint" + } + + e.recoveryCache.mu.Lock() + defer e.recoveryCache.mu.Unlock() + + cache := e.recoveryCache.state + needReset := cache == nil || cache.epochStart != epochStart || cache.lastScannedNum == 0 || head.Number < cache.lastScannedNum + if !needReset && cache.lastScannedNum > 0 { + if cachedHead, ok := store.GetHeaderByNumber(cache.lastScannedNum); !ok || cachedHead == nil || cachedHead.Hash != cache.lastScannedHash { + needReset = true + } + } + + if needReset { + cache = &recoveryEvidenceCache{ + epochStart: epochStart, + currentSlot: currentSlot, + evidence: map[uint64]map[string]struct{}{}, + } + for blockNum := head.Number; blockNum > 0; blockNum-- { + h, ok := store.GetHeaderByNumber(blockNum) + if !ok || h == nil { + continue + } + accumulateRecoveryEvidence(store, h, meta, epochStart, currentSlot, cache.evidence) + if slotAtTimestamp(meta, h.Timestamp) <= epochStart { + break + } + } + cache.lastScannedNum = head.Number + cache.lastScannedHash = head.Hash + e.recoveryCache.state = cache + } + + if cache.lastScannedNum < head.Number { + for blockNum := cache.lastScannedNum + 1; blockNum <= head.Number; blockNum++ { + h, ok := store.GetHeaderByNumber(blockNum) + if !ok || h == nil { + continue + } + accumulateRecoveryEvidence(store, h, meta, epochStart, currentSlot, cache.evidence) + cache.lastScannedNum = blockNum + cache.lastScannedHash = h.Hash + } + cache.currentSlot = currentSlot + e.recoveryCache.state = cache + } + + evidence := cache.evidence + if len(evidence) == 0 { + return nil, "deprecated_legacy_endpoint" + } + + out := map[string]uint64{} + for key := range validatorsByAddr { + missed := uint64(0) + power := meta.nominalWeightUnits + for slot := epochStart; slot <= currentSlot; slot++ { + slotVals := evidence[slot] + if len(slotVals) == 0 { + continue + } + if _, ok := slotVals[key]; !ok { + missed++ + } + if missed > meta.recoveryMissThresholdPerEpoch { + power = 0 + break + } + } + out[key] = power + } + if len(out) == 0 { + return nil, "deprecated_legacy_endpoint" + } + + return out, "deprecated_legacy_endpoint" +} + +func accumulateRecoveryEvidence( + store ethStore, + h *types.Header, + meta uptimeOverviewMeta, + epochStart uint64, + currentSlot uint64, + evidence map[uint64]map[string]struct{}, +) { + return +} + +func extractTopicAddress(topic types.Hash) types.Address { + return types.BytesToAddress(topic[12:]) +} + +func resolveIBFTEpochSize(params *chain.Params) uint64 { + if params == nil { + return defaultIBFTEpochSize + } + + rawIBFT, ok := params.Engine["ibft"] + if !ok { + return defaultIBFTEpochSize + } + ibftMap, ok := rawIBFT.(map[string]interface{}) + if !ok { + return defaultIBFTEpochSize + } + rawEpoch, ok := ibftMap["epochSize"] + if !ok { + return defaultIBFTEpochSize + } + epochFloat, ok := rawEpoch.(float64) + if !ok || epochFloat <= 0 { + return defaultIBFTEpochSize + } + + return uint64(epochFloat) +} + +func resolvePoSFromBlock(params *chain.Params) (uint64, bool) { + if params == nil { + return 0, false + } + + rawIBFT, ok := params.Engine["ibft"] + if !ok { + return 0, false + } + ibftMap, ok := rawIBFT.(map[string]interface{}) + if !ok { + return 0, false + } + rawTypes, ok := ibftMap["types"] + if !ok { + return 0, false + } + typesSlice, ok := rawTypes.([]interface{}) + if !ok { + return 0, false + } + + var ( + minFrom uint64 + found bool + ) + + for _, rawType := range typesSlice { + typeMap, ok := rawType.(map[string]interface{}) + if !ok { + continue + } + + tv, ok := typeMap["type"].(string) + if !ok || tv != "PoS" { + continue + } + + fromFloat, ok := typeMap["from"].(float64) + if !ok || fromFloat < 0 { + continue + } + + from := uint64(fromFloat) + if !found || from < minFrom { + minFrom = from + found = true + } + } + + return minFrom, found +} + +type uptimeOverviewMeta struct { + genesisTimeUnix uint64 + slotDurationSec uint64 + slotsPerEpoch uint64 + recoveryMissThresholdPerEpoch uint64 + nominalWeightUnits uint64 +} + +func resolveUptimeMeta(params *chain.Params) (uptimeOverviewMeta, bool) { + if params == nil { + return uptimeOverviewMeta{}, false + } + rawIBFT, ok := params.Engine["ibft"] + if !ok { + return uptimeOverviewMeta{}, false + } + ibftMap, ok := rawIBFT.(map[string]interface{}) + if !ok { + return uptimeOverviewMeta{}, false + } + configMap := ibftMap + if rawCfg, ok := ibftMap["config"]; ok { + if nested, ok := rawCfg.(map[string]interface{}); ok && nested != nil { + configMap = nested + } + } + read := func(key string) uint64 { + raw, ok := configMap[key] + if !ok || raw == nil { + raw, ok = ibftMap[key] + if !ok || raw == nil { + return 0 + } + } + v, ok := raw.(float64) + if !ok || v <= 0 { + return 0 + } + return uint64(v) + } + meta := uptimeOverviewMeta{ + genesisTimeUnix: read("genesisTime"), + slotDurationSec: read("slotDurationSec"), + slotsPerEpoch: read("microEpochSize"), + recoveryMissThresholdPerEpoch: read("recoveryMissThresholdPerEpoch"), + nominalWeightUnits: read("microEpochNominalWeightUnits"), + } + if v := read("microEpochSlots"); v > 0 { + meta.slotsPerEpoch = v + } + if v := read("nominalWeightUnits"); v > 0 { + meta.nominalWeightUnits = v + } + if v := read("uptimeNominalWeightUnits"); v > 0 { + meta.nominalWeightUnits = v + } + if meta.slotsPerEpoch == 0 { + return uptimeOverviewMeta{}, false + } + return meta, true +} + +func slotAtTimestamp(meta uptimeOverviewMeta, ts uint64) uint64 { + if meta.slotDurationSec == 0 || ts < meta.genesisTimeUnix { + return 0 + } + return (ts - meta.genesisTimeUnix) / meta.slotDurationSec +} + +func epochAtSlot(meta uptimeOverviewMeta, slot uint64) uint64 { + if meta.slotsPerEpoch == 0 { + return 0 + } + return slot / meta.slotsPerEpoch +} + +var posSysAddr = types.StringToAddress("0x0000000000000000000000000000000000009999") + +const ( + keyPrefixPropSlots = "xgr.pos.prop.slots" + keyPrefixPropMiss = "xgr.pos.prop.miss" + keyPrefixEpochLen = "xgr.pos.epoch.validators.len" + keyPrefixEpochVal = "xgr.pos.epoch.validators.val" + keyPrefixSlashed = "xgr.pos.slashed" + keyPrefixRewardTot = "xgr.pos.reward.total" + keyPrefixRewardVal = "xgr.pos.reward.validator" + keyPrefixRewardValCom = "xgr.pos.reward.validator.commission" + keyPrefixRewardDelTot = "xgr.pos.reward.delegators.total" + keyPrefixRewardDel = "xgr.pos.reward.delegator" + keyPrefixUptimeNomW = "xgr.uptime.nominal.weight" + keyPrefixUptimeEffW = "xgr.uptime.effective.weight" + keyPrefixUptimeInact = "xgr.uptime.inactivity.count" + keyPrefixUptimeLastEp = "xgr.uptime.last.epoch" + keyPrefixUptimeLastSl = "xgr.uptime.last.processed.slot" +) + +func epochOf(number, epochSize uint64) uint64 { + if number == 0 || epochSize == 0 { + return 0 + } + if number%epochSize == 0 { + return number / epochSize + } + return number/epochSize + 1 +} + +func keyProposerSlots(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixPropSlots), eb[:], addr.Bytes())) +} + +func keyProposerMissed(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixPropMiss), eb[:], addr.Bytes())) +} + +func keySlashed(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixSlashed), eb[:], addr.Bytes())) +} + +func keyEpochValidatorsLen(epoch uint64) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixEpochLen), eb[:])) +} + +func keyEpochValidator(epoch, idx uint64) types.Hash { + var eb [8]byte + var ib [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + binary.BigEndian.PutUint64(ib[:], idx) + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixEpochVal), eb[:], ib[:])) +} + +func keyRewardTotal(epoch uint64) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardTot), eb[:])) +} + +func keyValidatorReward(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardVal), eb[:], addr.Bytes())) +} + +func keyValidatorCommissionReward(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardValCom), eb[:], addr.Bytes())) +} + +func keyValidatorDelegatorsRewardTotal(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardDelTot), eb[:], addr.Bytes())) +} + +func keyDelegatorReward(epoch uint64, validator, delegator types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixRewardDel), eb[:], validator.Bytes(), delegator.Bytes())) +} + +func keyStakerStakeSnapshot(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + return types.BytesToHash(crypto.Keccak256([]byte("xgr.pos.staker.stake.snapshot"), eb[:], addr.Bytes())) +} + +func keyStakeSnapshot(epoch uint64, addr types.Address) types.Hash { + var eb [8]byte + binary.BigEndian.PutUint64(eb[:], epoch) + return types.BytesToHash(crypto.Keccak256([]byte("xgr.pos.stake.snapshot"), eb[:], addr.Bytes())) +} + +func keyUptimeNominalWeight(addr types.Address) types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixUptimeNomW), addr.Bytes())) +} + +func keyUptimeEffectiveWeight(addr types.Address) types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixUptimeEffW), addr.Bytes())) +} + +func keyUptimeInactivity(addr types.Address) types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixUptimeInact), addr.Bytes())) +} + +func keyUptimeLastEpoch() types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixUptimeLastEp))) +} + +func keyUptimeLastSlot() types.Hash { + return types.BytesToHash(crypto.Keccak256([]byte(keyPrefixUptimeLastSl))) +} + +func readBigFromPosSys(e *Eth, root types.Hash, slot types.Hash) *big.Int { + b, err := e.store.GetStorage(root, posSysAddr, slot) + if err != nil || len(b) == 0 { + return new(big.Int) + } + return new(big.Int).SetBytes(b) +} + +func queryJoinedAtBlockRuntime(rt *stakingQueryRuntime, addr types.Address) (uint64, error) { + if rt == nil { + return 0, nil + } + selector := crypto.Keccak256([]byte("joinedAtBlock(address)"))[:4] + input := make([]byte, 4+32) + copy(input[:4], selector) + copy(input[4+12:], addr.Bytes()) + + to := stakingHelper.AddrStakingContract + tx := &types.Transaction{ + From: types.ZeroAddress, + To: &to, + Input: input, + Nonce: rt.GetNonce(types.ZeroAddress), + Gas: 1000000, + Value: big.NewInt(0), + GasPrice: big.NewInt(0), + } + + rt.SetNonPayable(true) + res, err := rt.Apply(tx) + if err != nil { + return 0, err + } + if res == nil || res.Failed() || len(res.ReturnValue) == 0 { + if res != nil && res.Err != nil { + return 0, res.Err + } + return 0, nil + } + + return new(big.Int).SetBytes(res.ReturnValue).Uint64(), nil +} + +func readValidatorsFromConsensusHeader(e *Eth, blockNumber uint64) map[types.Address]struct{} { + if e == nil || e.store == nil { + return nil + } + + blk, ok := e.store.GetBlockByNumber(blockNumber, false) + if !ok || blk == nil || blk.Header == nil || len(blk.Header.ExtraData) < signer.IstanbulExtraVanity { + return nil + } + + vt := resolveIBFTValidatorType(e.store.GetChainParams(), blockNumber) + extra, ok := decodeIBFTExtraByType(blk.Header, vt) + if !ok || extra == nil || extra.Validators == nil || extra.Validators.Len() == 0 { + return nil + } + + out := make(map[types.Address]struct{}, extra.Validators.Len()) + for i := 0; i < extra.Validators.Len(); i++ { + out[extra.Validators.At(uint64(i)).Addr()] = struct{}{} + } + + if len(out) == 0 { + return nil + } + + return out +} + +func decodeIBFTExtraByType(header *types.Header, vt validatorTypes.ValidatorType) (*signer.IstanbulExtra, bool) { + if header == nil || len(header.ExtraData) < signer.IstanbulExtraVanity { + return nil, false + } + + validatorSet := validatorTypes.NewValidatorSetFromType(vt) + if validatorSet == nil { + return nil, false + } + + extra := &signer.IstanbulExtra{Validators: validatorSet} + switch vt { + case validatorTypes.ECDSAValidatorType: + extra.CommittedSeals = &signer.SerializedSeal{} + extra.ParentCommittedSeals = &signer.SerializedSeal{} + case validatorTypes.BLSValidatorType: + extra.CommittedSeals = &signer.AggregatedSeal{} + extra.ParentCommittedSeals = &signer.AggregatedSeal{} + default: + return nil, false + } + + if err := extra.UnmarshalRLP(header.ExtraData[signer.IstanbulExtraVanity:]); err != nil { + return nil, false + } + + return extra, true +} + +func resolveIBFTValidatorType(params *chain.Params, height uint64) validatorTypes.ValidatorType { + if params == nil { + return validatorTypes.ECDSAValidatorType + } + raw, ok := params.Engine["ibft"] + if !ok { + return validatorTypes.ECDSAValidatorType + } + ibftCfg, ok := raw.(map[string]interface{}) + if !ok { + return validatorTypes.ECDSAValidatorType + } + forks, err := ibftFork.GetIBFTForks(ibftCfg) + if err != nil || len(forks) == 0 { + return validatorTypes.ECDSAValidatorType + } + + for _, f := range forks { + if f == nil { + continue + } + from := f.From.Value + to := uint64(^uint64(0)) + if f.To != nil { + to = f.To.Value + } + if height >= from && height <= to { + if f.ValidatorType != "" { + return f.ValidatorType + } + return validatorTypes.ECDSAValidatorType + } + } + + return validatorTypes.ECDSAValidatorType +} + +func readValidatorsForEpoch(e *Eth, root types.Hash, epoch uint64, epochEndBlock uint64) map[types.Address]struct{} { + set := readValidatorsFromPosState(e, root, epoch) + if len(set) > 0 { + return set + } + if epochEndBlock == 0 { + return nil + } + return readValidatorsFromConsensusHeader(e, epochEndBlock) +} + +func readValidatorsFromPosState(e *Eth, root types.Hash, epoch uint64) map[types.Address]struct{} { + if e == nil || epoch == 0 { + return nil + } + + length := readBigFromPosSys(e, root, keyEpochValidatorsLen(epoch)).Uint64() + if length == 0 { + return nil + } + + set := make(map[types.Address]struct{}, length) + for i := uint64(0); i < length; i++ { + raw := readBigFromPosSys(e, root, keyEpochValidator(epoch, i)).Bytes() + if len(raw) == 0 { + continue + } + + addr := types.BytesToAddress(raw) + if addr == types.ZeroAddress { + continue + } + set[addr] = struct{}{} + } + + if len(set) == 0 { + return nil + } + + return set +} + +func isValidatorRewardIneligibleInEpoch(e *Eth, root types.Hash, addr types.Address, epoch uint64) bool { + if epoch == 0 { + return false + } + + slots := readBigFromPosSys(e, root, keyProposerSlots(epoch, addr)).Uint64() + if slots == 0 { + return false + } + + missed := readBigFromPosSys(e, root, keyProposerMissed(epoch, addr)).Uint64() + if missed > slots { + missed = slots + } + okSlots := slots - missed + + return okSlots*10 < slots*8 +} + +func isValidatorInEpoch(e *Eth, root types.Hash, addr types.Address, epoch uint64) bool { + if epoch == 0 { + return false + } + + if readBigFromPosSys(e, root, keyProposerSlots(epoch, addr)).Sign() > 0 { + return true + } + if readBigFromPosSys(e, root, keyProposerMissed(epoch, addr)).Sign() > 0 { + return true + } + return false +} + +type proposalWindowUptimeMetrics struct { + uptimeBps *uint64 + observedSlots uint64 +} + +func computeProposalWindowUptimeMetrics( + e *Eth, + root types.Hash, + entry *posValidatorOverview, + reportedEpoch uint64, + epochSize uint64, + window uint64, +) proposalWindowUptimeMetrics { + if e == nil || entry == nil || reportedEpoch == 0 || epochSize == 0 || window == 0 { + return proposalWindowUptimeMetrics{} + } + + startEpoch := uint64(1) + if reportedEpoch >= window { + startEpoch = reportedEpoch - window + 1 + } + + var totalSlots uint64 + var missedSlots uint64 + for epoch := startEpoch; epoch <= reportedEpoch; epoch++ { + epochEndBlock := epoch * epochSize + if entry.JoinEffectiveAtBlock != nil && epochEndBlock < uint64(*entry.JoinEffectiveAtBlock) { + continue + } + if entry.DeactivateEffectiveAtBlock != nil && epochEndBlock > uint64(*entry.DeactivateEffectiveAtBlock) { + continue + } + + slots := readBigFromPosSys(e, root, keyProposerSlots(epoch, entry.Address)).Uint64() + if slots == 0 { + continue + } + missed := readBigFromPosSys(e, root, keyProposerMissed(epoch, entry.Address)).Uint64() + if missed > slots { + missed = slots + } + totalSlots += slots + missedSlots += missed + } + + if totalSlots == 0 { + return proposalWindowUptimeMetrics{} + } + + okSlots := totalSlots - missedSlots + bps := (okSlots * 10000) / totalSlots + + return proposalWindowUptimeMetrics{ + uptimeBps: &bps, + observedSlots: totalSlots, + } +} + +func callStakeUintMethod(rt *stakingQueryRuntime, methodName string, validator types.Address) (*big.Int, error) { + method := abis.StakingABI.Methods[methodName] + if method == nil { + return nil, fmt.Errorf("staking ABI missing %s", methodName) + } + + inp, err := method.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(validator)}) + if err != nil { + inp, err = method.Inputs.Encode(map[string]interface{}{"account": ethgo.Address(validator)}) + if err != nil { + return nil, err + } + } + + rt.SetNonPayable(true) + res, err := rt.Apply(&types.Transaction{ + From: types.ZeroAddress, + To: &stakingHelper.AddrStakingContract, + Input: append(method.ID(), inp...), + Nonce: rt.GetNonce(types.ZeroAddress), + Gas: 1000000, + Value: big.NewInt(0), + GasPrice: big.NewInt(0), + }) + if err != nil { + return nil, err + } + if res.Failed() { + return nil, res.Err + } + decoded, err := method.Outputs.Decode(res.ReturnValue) + if err != nil { + return nil, err + } + mp, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode %s failed", methodName) + } + val, ok := mp["0"].(*big.Int) + if !ok { + return nil, fmt.Errorf("decode %s failed", methodName) + } + return val, nil +} + +func callStakeAddressMethod(rt *stakingQueryRuntime, methodName string, validator types.Address, idx uint64) (types.Address, error) { + method := abis.StakingABI.Methods[methodName] + if method == nil { + return types.ZeroAddress, fmt.Errorf("staking ABI missing %s", methodName) + } + inp, err := method.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(validator), "idx": new(big.Int).SetUint64(idx)}) + if err != nil { + return types.ZeroAddress, err + } + rt.SetNonPayable(true) + res, err := rt.Apply(&types.Transaction{ + From: types.ZeroAddress, + To: &stakingHelper.AddrStakingContract, + Input: append(method.ID(), inp...), + Nonce: rt.GetNonce(types.ZeroAddress), + Gas: 1000000, + Value: big.NewInt(0), + GasPrice: big.NewInt(0), + }) + if err != nil { + return types.ZeroAddress, err + } + if res.Failed() { + return types.ZeroAddress, res.Err + } + decoded, err := method.Outputs.Decode(res.ReturnValue) + if err != nil { + return types.ZeroAddress, err + } + mp, ok := decoded.(map[string]interface{}) + if !ok { + return types.ZeroAddress, fmt.Errorf("decode %s failed", methodName) + } + addr, ok := mp["0"].(ethgo.Address) + if !ok { + return types.ZeroAddress, fmt.Errorf("decode %s failed", methodName) + } + + return types.Address(addr), nil +} + +type validatorPoolRPCView struct { + DelegationEnabled bool + MaxTotalDelegatedStake *big.Int + MinDelegatorStake *big.Int + EffectiveMinDelegatorStake *big.Int + CommissionBps uint16 +} + +func callStakePoolMethod(rt *stakingQueryRuntime, validator types.Address) (*validatorPoolRPCView, error) { + method := abis.StakingABI.Methods["validatorPool"] + if method == nil { + return &validatorPoolRPCView{MaxTotalDelegatedStake: new(big.Int)}, fmt.Errorf("staking ABI missing validatorPool") + } + + inp, err := method.Inputs.Encode(map[string]interface{}{"validator": ethgo.Address(validator)}) + if err != nil { + return nil, err + } + + rt.SetNonPayable(true) + res, err := rt.Apply(&types.Transaction{ + From: types.ZeroAddress, + To: &stakingHelper.AddrStakingContract, + Input: append(method.ID(), inp...), + Nonce: rt.GetNonce(types.ZeroAddress), + Gas: 1000000, + Value: big.NewInt(0), + GasPrice: big.NewInt(0), + }) + if err != nil { + return nil, err + } + if res.Failed() { + return nil, res.Err + } + + decoded, err := method.Outputs.Decode(res.ReturnValue) + if err != nil { + return nil, err + } + mp, ok := decoded.(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode validatorPool failed") + } + + out, ok := mp["0"].(map[string]interface{}) + if !ok { + return nil, fmt.Errorf("decode validatorPool failed") + } + + enabled, _ := out["delegationEnabled"].(bool) + maxStake, _ := out["maxTotalDelegatedStake"].(*big.Int) + if maxStake == nil { + maxStake = new(big.Int) + } + minStake, _ := out["minDelegatorStake"].(*big.Int) + if minStake == nil { + minStake = new(big.Int) + } + effectiveMin := new(big.Int).Set(minStake) + if effectiveMin.Sign() == 0 { + effectiveMin = new(big.Int).Mul(big.NewInt(10000), new(big.Int).Exp(big.NewInt(10), big.NewInt(18), nil)) + } + var commission uint16 + switch v := out["commissionBps"].(type) { + case uint16: + commission = v + case *big.Int: + commission = uint16(v.Uint64()) + } + + return &validatorPoolRPCView{ + DelegationEnabled: enabled, + MaxTotalDelegatedStake: maxStake, + MinDelegatorStake: minStake, + EffectiveMinDelegatorStake: effectiveMin, + CommissionBps: commission, + }, nil +} + +func isStakerEffectiveAtPoint(joined, deactivated, blockNumber, epochSize uint64) bool { + if joined == 0 || epochSize == 0 { + return false + } + if blockNumber/epochSize <= joined/epochSize { + return false + } + if deactivated == 0 { + return true + } + + return blockNumber/epochSize <= deactivated/epochSize +} diff --git a/jsonrpc/eth_pos_overview_test.go b/jsonrpc/eth_pos_overview_test.go new file mode 100644 index 0000000..1fbb8e8 --- /dev/null +++ b/jsonrpc/eth_pos_overview_test.go @@ -0,0 +1,1422 @@ +package jsonrpc + +import ( + "encoding/json" + "math/big" + "testing" + + "github.com/hashicorp/go-hclog" + "github.com/stretchr/testify/require" + "github.com/umbracle/ethgo" + "github.com/xgr-network/xgr-node/chain" + "github.com/xgr-network/xgr-node/consensus/ibft/signer" + "github.com/xgr-network/xgr-node/contracts/abis" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/gasprice" + "github.com/xgr-network/xgr-node/helper/progress" + "github.com/xgr-network/xgr-node/state" + "github.com/xgr-network/xgr-node/state/runtime" + "github.com/xgr-network/xgr-node/types" + "github.com/xgr-network/xgr-node/validators" +) + +type posOverviewMockStore struct { + head *types.Header + blocks map[uint64]*types.Block + receipt map[types.Hash][]*types.Receipt + stakes map[types.Address]*big.Int + activeFlags map[types.Address]bool + deactiveBlocks map[types.Address]uint64 + vals []types.Address + params *chain.Params + storage map[types.Hash][]byte + feePoolBalance *big.Int + minValidators uint64 + maxValidators uint64 + threshold *big.Int + poolEnabled map[types.Address]bool + poolMax map[types.Address]*big.Int + poolCommission map[types.Address]uint16 + poolMin map[types.Address]*big.Int + stakerInfos map[types.Address]map[string]interface{} + delegatorsByV map[types.Address][]types.Address + joinedBlocks map[types.Address]uint64 +} + +var _ ethStore = (*posOverviewMockStore)(nil) +var _ gasprice.GasStore = (*posOverviewMockStore)(nil) + +func (m *posOverviewMockStore) Header() *types.Header { return m.head } +func (m *posOverviewMockStore) GetHeaderByNumber(n uint64) (*types.Header, bool) { + b, ok := m.blocks[n] + if !ok { + return nil, false + } + return b.Header, true +} +func (m *posOverviewMockStore) GetBlockByHash(hash types.Hash, full bool) (*types.Block, bool) { + for _, b := range m.blocks { + if b.Hash() == hash { + return b, true + } + } + return nil, false +} +func (m *posOverviewMockStore) GetBlockByNumber(num uint64, full bool) (*types.Block, bool) { + b, ok := m.blocks[num] + return b, ok +} +func (m *posOverviewMockStore) ReadTxLookup(types.Hash) (types.Hash, bool) { + return types.ZeroHash, false +} +func (m *posOverviewMockStore) GetReceiptsByHash(hash types.Hash) ([]*types.Receipt, error) { + return m.receipt[hash], nil +} +func (m *posOverviewMockStore) GetAvgGasPrice() *big.Int { return big.NewInt(0) } +func (m *posOverviewMockStore) ApplyTxn(_ *types.Header, tx *types.Transaction, _ types.StateOverride, _ bool) (*runtime.ExecutionResult, error) { + data := tx.Input + if len(data) < 4 { + return &runtime.ExecutionResult{ReturnValue: nil}, nil + } + joinedAtSelector := crypto.Keccak256([]byte("joinedAtBlock(address)"))[:4] + if len(data) >= 36 && string(data[:4]) == string(joinedAtSelector) { + addr := types.BytesToAddress(data[16:36]) + joinedAt := uint64(0) + if m.joinedBlocks != nil { + joinedAt = m.joinedBlocks[addr] + } + if joinedAt == 0 { + if info := m.stakerInfos[addr]; info != nil { + if v, ok := info["joinedAtBlock"].(*big.Int); ok && v != nil { + joinedAt = v.Uint64() + } + } + } + return &runtime.ExecutionResult{ReturnValue: uint256Bytes(joinedAt)}, nil + } + + sig := types.BytesToHash(data[:4]) + validatorsMethod := abis.StakingABI.Methods["validators"] + accountStakeMethod := abis.StakingABI.Methods["accountStake"] + minMethod := abis.StakingABI.Methods["minNumValidators"] + maxMethod := abis.StakingABI.Methods["maxNumValidators"] + thrMethod := abis.StakingABI.Methods["VALIDATOR_THRESHOLD"] + validatorInfoMethod := abis.StakingABI.Methods["validatorInfo"] + validatorSelfStakeMethod := abis.StakingABI.Methods["validatorSelfStake"] + validatorDelegatedStakeRawMethod := abis.StakingABI.Methods["validatorDelegatedStakeRaw"] + validatorDelegatedStakeActiveMethod := abis.StakingABI.Methods["validatorDelegatedStakeActive"] + validatorStakerCountMethod := abis.StakingABI.Methods["validatorStakerCount"] + validatorStakerAtMethod := abis.StakingABI.Methods["validatorStakerAt"] + stakerInfoMethod := abis.StakingABI.Methods["stakerInfo"] + validatorPoolMethod := abis.StakingABI.Methods["validatorPool"] + joinedAtBlockMethod := abis.StakingABI.Methods["joinedAtBlock"] + + switch sig { + case types.BytesToHash(validatorsMethod.ID()): + enc, err := validatorsMethod.Outputs.Encode(map[string]interface{}{"0": toEthgoAddrs(m.vals)}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(accountStakeMethod.ID()): + decoded, err := accountStakeMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addrEth := decoded.(map[string]interface{})["account"].(ethgo.Address) + addr := types.Address(addrEth) + stake := m.stakes[addr] + if stake == nil { + stake = big.NewInt(0) + } + enc, err := accountStakeMethod.Outputs.Encode(map[string]interface{}{"0": stake}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(minMethod.ID()): + minV := m.minValidators + if minV == 0 { + minV = 1 + } + enc, err := minMethod.Outputs.Encode(map[string]interface{}{"0": new(big.Int).SetUint64(minV)}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(maxMethod.ID()): + maxV := m.maxValidators + if maxV == 0 { + maxV = 100 + } + enc, err := maxMethod.Outputs.Encode(map[string]interface{}{"0": new(big.Int).SetUint64(maxV)}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(thrMethod.ID()): + thr := m.threshold + if thr == nil { + thr = big.NewInt(500) + } + enc, err := thrMethod.Outputs.Encode(map[string]interface{}{"0": thr}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + + case types.BytesToHash(validatorInfoMethod.ID()): + decoded, err := validatorInfoMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addrEth := decoded.(map[string]interface{})["account"].(ethgo.Address) + addr := types.Address(addrEth) + stake := m.stakes[addr] + if stake == nil { + stake = big.NewInt(0) + } + active := m.activeFlags[addr] + deact := new(big.Int).SetUint64(m.deactiveBlocks[addr]) + enc, err := validatorInfoMethod.Outputs.Encode(map[string]interface{}{ + "exists": true, + "active": active, + "stakedAmount": stake, + "deactivatedAtBlock": deact, + "blsPubKey": []byte{}, + }) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(validatorSelfStakeMethod.ID()): + decoded, err := validatorSelfStakeMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addr := types.Address(decoded.(map[string]interface{})["validator"].(ethgo.Address)) + stake := m.stakes[addr] + if stake == nil { + stake = big.NewInt(0) + } + enc, err := validatorSelfStakeMethod.Outputs.Encode(map[string]interface{}{"0": stake}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(validatorDelegatedStakeRawMethod.ID()): + decoded, err := validatorDelegatedStakeRawMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addr := types.Address(decoded.(map[string]interface{})["validator"].(ethgo.Address)) + total := big.NewInt(0) + for _, d := range m.delegatorsByV[addr] { + if d == addr { + continue + } + info := m.stakerInfos[d] + if info != nil { + total.Add(total, info["amount"].(*big.Int)) + } + } + enc, err := validatorDelegatedStakeRawMethod.Outputs.Encode(map[string]interface{}{"0": total}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(validatorDelegatedStakeActiveMethod.ID()): + decoded, err := validatorDelegatedStakeActiveMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addr := types.Address(decoded.(map[string]interface{})["validator"].(ethgo.Address)) + total := big.NewInt(0) + for _, d := range m.delegatorsByV[addr] { + if d == addr { + continue + } + info := m.stakerInfos[d] + if info != nil && info["active"].(bool) { + total.Add(total, info["amount"].(*big.Int)) + } + } + enc, err := validatorDelegatedStakeActiveMethod.Outputs.Encode(map[string]interface{}{"0": total}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(validatorStakerCountMethod.ID()): + decoded, err := validatorStakerCountMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addr := types.Address(decoded.(map[string]interface{})["validator"].(ethgo.Address)) + enc, err := validatorStakerCountMethod.Outputs.Encode(map[string]interface{}{"0": new(big.Int).SetUint64(uint64(len(m.delegatorsByV[addr])))}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(validatorStakerAtMethod.ID()): + decoded, err := validatorStakerAtMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addr := types.Address(decoded.(map[string]interface{})["validator"].(ethgo.Address)) + idx := decoded.(map[string]interface{})["idx"].(*big.Int).Uint64() + delegators := m.delegatorsByV[addr] + if idx >= uint64(len(delegators)) { + return &runtime.ExecutionResult{ReturnValue: nil}, nil + } + enc, err := validatorStakerAtMethod.Outputs.Encode(map[string]interface{}{"0": ethgo.Address(delegators[idx])}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(stakerInfoMethod.ID()): + decoded, err := stakerInfoMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addr := types.Address(decoded.(map[string]interface{})["account"].(ethgo.Address)) + info := m.stakerInfos[addr] + if info == nil { + return &runtime.ExecutionResult{ReturnValue: nil}, nil + } + enc, err := stakerInfoMethod.Outputs.Encode(map[string]interface{}{"0": info}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(validatorPoolMethod.ID()): + decoded, err := validatorPoolMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addr := types.Address(decoded.(map[string]interface{})["validator"].(ethgo.Address)) + max := m.poolMax[addr] + if max == nil { + max = big.NewInt(0) + } + enc, err := validatorPoolMethod.Outputs.Encode(map[string]interface{}{"0": map[string]interface{}{ + "exists": true, + "active": m.activeFlags[addr], + "delegationEnabled": m.poolEnabled[addr], + "maxTotalDelegatedStake": max, + "minDelegatorStake": func() *big.Int { + if m.poolMin != nil && m.poolMin[addr] != nil { + return m.poolMin[addr] + } + return big.NewInt(0) + }(), + "commissionBps": m.poolCommission[addr], + "blsPubKey": []byte{}, + }}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + case types.BytesToHash(joinedAtBlockMethod.ID()): + decoded, err := joinedAtBlockMethod.Inputs.Decode(data[4:]) + if err != nil { + return nil, err + } + addr := types.Address(decoded.(map[string]interface{})["account"].(ethgo.Address)) + joined := big.NewInt(0) + if info := m.stakerInfos[addr]; info != nil { + if v, ok := info["joinedAtBlock"].(*big.Int); ok { + joined = v + } + } + enc, err := joinedAtBlockMethod.Outputs.Encode(map[string]interface{}{"0": joined}) + if err != nil { + return nil, err + } + return &runtime.ExecutionResult{ReturnValue: enc}, nil + default: + return &runtime.ExecutionResult{ReturnValue: nil}, nil + } +} +func (m *posOverviewMockStore) GetSyncProgression() *progress.Progression { return nil } +func (m *posOverviewMockStore) GetAccount(_ types.Hash, addr types.Address) (*Account, error) { + balance := big.NewInt(0) + if addr == state.FeePoolAddress && m.feePoolBalance != nil { + balance = new(big.Int).Set(m.feePoolBalance) + } + return &Account{Balance: balance, Nonce: 0}, nil +} +func (m *posOverviewMockStore) GetStorage(_ types.Hash, _ types.Address, slot types.Hash) ([]byte, error) { + if m.storage == nil { + return nil, nil + } + return m.storage[slot], nil +} +func (m *posOverviewMockStore) GetForksInTime(uint64) chain.ForksInTime { + return chain.AllForksEnabled.At(0) +} +func (m *posOverviewMockStore) GetCode(types.Hash, types.Address) ([]byte, error) { return nil, nil } +func (m *posOverviewMockStore) GetChainParams() *chain.Params { return m.params } +func (m *posOverviewMockStore) AddTx(*types.Transaction) error { return nil } +func (m *posOverviewMockStore) GetPendingTx(types.Hash) (*types.Transaction, bool) { return nil, false } +func (m *posOverviewMockStore) GetNonce(types.Address) uint64 { return 0 } +func (m *posOverviewMockStore) GetBaseFee() uint64 { return 0 } +func (m *posOverviewMockStore) FilterExtra(extra []byte) ([]byte, error) { return extra, nil } +func (m *posOverviewMockStore) MaxPriorityFeePerGas() (*big.Int, error) { return big.NewInt(0), nil } +func (m *posOverviewMockStore) FeeHistory(uint64, uint64, []float64) (*gasprice.FeeHistoryReturn, error) { + return nil, nil +} + +func TestEth_GetPosValidatorsOverview(t *testing.T) { + v1 := types.StringToAddress("0x1000000000000000000000000000000000000001") + v2 := types.StringToAddress("0x1000000000000000000000000000000000000002") + v3 := types.StringToAddress("0x1000000000000000000000000000000000000003") + d1 := types.StringToAddress("0x2000000000000000000000000000000000000001") + d2 := types.StringToAddress("0x2000000000000000000000000000000000000002") + d3 := types.StringToAddress("0x2000000000000000000000000000000000000003") + + b9 := newTestBlock(9, types.StringToHash("0x09")) + b10 := newTestBlock(10, types.StringToHash("0x10")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{ + 9: b9, + 10: b10, + }, + receipt: map[types.Hash][]*types.Receipt{ + b9.Hash(): {}, + b10.Hash(): {}, + }, + stakes: map[types.Address]*big.Int{ + v1: big.NewInt(100), + v2: big.NewInt(600), + v3: big.NewInt(600), + }, + activeFlags: map[types.Address]bool{v1: true, v2: false, v3: false}, + deactiveBlocks: map[types.Address]uint64{v2: 9, v3: 9}, + vals: []types.Address{v1, v2}, + stakerInfos: map[types.Address]map[string]interface{}{ + d1: {"amount": big.NewInt(30), "active": true}, + d2: {"amount": big.NewInt(20), "active": false}, + d3: {"amount": big.NewInt(40), "active": true}, + }, + delegatorsByV: map[types.Address][]types.Address{ + v1: {d1, d2}, + v2: {d3}, + }, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(8)}}, + "microEpochSize": float64(4), + }}}, + storage: map[types.Hash][]byte{ + keyProposerSlots(2, v2): uint256Bytes(10), + keyProposerMissed(2, v2): uint256Bytes(3), + keySlashed(2, v2): uint256Bytes(1), + keyRewardTotal(2): uint256Bytes(777), + keyValidatorReward(2, v2): uint256Bytes(42), + keyEpochValidatorsLen(2): uint256Bytes(1), + keyEpochValidator(2, 0): uint256Address(v2), + }, + feePoolBalance: big.NewInt(333), + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + mode := "current" + resIntf, err := ep.GetPosValidatorsOverview(&mode) + require.NoError(t, err) + + res, ok := resIntf.(*posOverviewResponse) + require.True(t, ok) + require.Equal(t, argUint64(10), res.BlockNumber) + require.Equal(t, "2bc", (*big.Int)(res.TotalCurrentStake).Text(16)) + require.Equal(t, (*big.Int)(res.TotalCurrentStake), (*big.Int)(res.TotalValidatorSelfStake)) + require.Equal(t, big.NewInt(90), (*big.Int)(res.TotalDelegatedRawStake)) + require.Equal(t, big.NewInt(70), (*big.Int)(res.TotalDelegatedActiveStake)) + require.Equal(t, big.NewInt(770), (*big.Int)(res.TotalActiveCurrentStake)) + require.Equal(t, argUint64(5), res.EpochSize) + require.Equal(t, argUint64(2), res.CurrentEpoch) + require.Equal(t, argUint64(2), res.LastFinalizedEpoch) + require.Equal(t, argUint64(2), res.ReportedEpoch) + require.Equal(t, argUint64(6), res.ReportedEpochStartBlock) + require.Equal(t, argUint64(10), res.ReportedEpochEndBlock) + require.NotNil(t, res.CurrentEpochPendingRewards) + require.Equal(t, "14d", (*big.Int)(res.CurrentEpochPendingRewards).Text(16)) + + require.True(t, res.PoSActive) + require.NotNil(t, res.PoSFromBlock) + require.Equal(t, argUint64(8), *res.PoSFromBlock) + require.NotNil(t, res.RewardIneligibleCount) + require.NotNil(t, res.SlashedCount) + require.Equal(t, argUint64(1), *res.RewardIneligibleCount) + require.Equal(t, argUint64(0), *res.SlashedCount) + require.True(t, res.RewardIneligibleStatusExact) + require.False(t, res.SlashStatusExact) + require.False(t, res.LastRoundStakeExact) + require.NotNil(t, res.LastRoundDistributedStake) + require.Equal(t, "0", (*big.Int)(res.LastRoundDistributedStake).Text(16)) + validatorByAddress := make(map[types.Address]posValidatorOverview, len(res.Validators)) + for _, val := range res.Validators { + validatorByAddress[val.Address] = val + } + + val1, ok := validatorByAddress[v1] + require.True(t, ok) + require.Equal(t, big.NewInt(100), (*big.Int)(val1.SelfStake)) + require.Equal(t, big.NewInt(50), (*big.Int)(val1.DelegatedRawStake)) + require.Equal(t, big.NewInt(30), (*big.Int)(val1.DelegatedActiveStake)) + require.Equal(t, big.NewInt(130), (*big.Int)(val1.TotalActiveCurrentStake)) + + var foundV2 bool + for _, val := range res.Validators { + if val.Address == v2 { + foundV2 = true + require.False(t, val.CurrentlyValidating) + require.False(t, val.StakingActive) + require.Equal(t, big.NewInt(600), (*big.Int)(val.SelfStake)) + require.Equal(t, big.NewInt(40), (*big.Int)(val.DelegatedRawStake)) + require.Equal(t, big.NewInt(40), (*big.Int)(val.DelegatedActiveStake)) + require.Equal(t, big.NewInt(640), (*big.Int)(val.TotalActiveCurrentStake)) + require.NotNil(t, val.DeactivatedAtBlock) + require.Equal(t, argUint64(9), *val.DeactivatedAtBlock) + require.NotNil(t, val.UnstakeAvailableAtBlock) + require.Equal(t, argUint64(10), *val.UnstakeAvailableAtBlock) + require.True(t, val.CanUnstakeNow) + require.True(t, val.WasValidatorLastEpoch) + require.Nil(t, val.ReportedEpochReward) + require.NotNil(t, val.RewardIneligible) + require.NotNil(t, val.Slashed) + require.True(t, *val.RewardIneligible) + require.False(t, *val.Slashed) + } + } + require.True(t, foundV2) +} + +func TestEth_GetPosValidatorsOverview_ProposalRollingUptimeWindows(t *testing.T) { + v1 := types.StringToAddress("0x1000000000000000000000000000000000000011") + v2 := types.StringToAddress("0x1000000000000000000000000000000000000012") + v3 := types.StringToAddress("0x1000000000000000000000000000000000000013") + b25 := newTestBlock(25, types.StringToHash("0x25")) + + store := &posOverviewMockStore{ + head: b25.Header, + blocks: map[uint64]*types.Block{25: b25}, + receipt: map[types.Hash][]*types.Receipt{b25.Hash(): {}}, + stakes: map[types.Address]*big.Int{ + v1: big.NewInt(1000), + v2: big.NewInt(2000), + v3: big.NewInt(3000), + }, + activeFlags: map[types.Address]bool{v1: true, v2: true, v3: false}, + deactiveBlocks: map[types.Address]uint64{v3: 18}, + vals: []types.Address{v1, v2, v3}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5), "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}}}}, + joinedBlocks: map[types.Address]uint64{ + v1: 0, + v2: 15, // joinEffectiveAtBlock=20, epoch 4 is first relevant epoch + v3: 0, + }, + storage: map[types.Hash][]byte{ + // v1: last3 (3,4,5) => total=15 missed=3 => 80.00% ; last10 effectively same window with this chain height + keyProposerSlots(3, v1): uint256Bytes(5), + keyProposerMissed(3, v1): uint256Bytes(1), + keyProposerSlots(4, v1): uint256Bytes(5), + keyProposerMissed(4, v1): uint256Bytes(1), + keyProposerSlots(5, v1): uint256Bytes(5), + keyProposerMissed(5, v1): uint256Bytes(1), + + // v2: epoch3 has duties but must be excluded due to joinEffectiveAtBlock=20 + keyProposerSlots(3, v2): uint256Bytes(9), + keyProposerMissed(3, v2): uint256Bytes(9), + keyProposerSlots(4, v2): uint256Bytes(2), + keyProposerMissed(4, v2): uint256Bytes(0), + keyProposerSlots(5, v2): uint256Bytes(2), + keyProposerMissed(5, v2): uint256Bytes(1), + + // v3: deactivation effective at block 20, epoch 5 must be excluded + keyProposerSlots(3, v3): uint256Bytes(1), + keyProposerMissed(3, v3): uint256Bytes(0), + keyProposerSlots(4, v3): uint256Bytes(1), + keyProposerMissed(4, v3): uint256Bytes(1), + keyProposerSlots(5, v3): uint256Bytes(10), + keyProposerMissed(5, v3): uint256Bytes(0), + }, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + mode := "current" + resIntf, err := ep.GetPosValidatorsOverview(&mode) + require.NoError(t, err) + res := resIntf.(*posOverviewResponse) + require.Len(t, res.Validators, 3) + + byAddr := map[types.Address]posValidatorOverview{} + for _, val := range res.Validators { + byAddr[val.Address] = val + } + + require.NotNil(t, byAddr[v1].ProposalUptimeLast3EpochsBps) + require.Equal(t, argUint64(8000), *byAddr[v1].ProposalUptimeLast3EpochsBps) + require.Equal(t, argUint64(80), *byAddr[v1].ProposalUptimeLast3EpochsPercent) + require.Equal(t, argUint64(15), byAddr[v1].ProposalUptimeLast3EpochsObserved) + require.NotNil(t, byAddr[v1].ProposalUptimeLast10EpochsBps) + require.Equal(t, argUint64(8000), *byAddr[v1].ProposalUptimeLast10EpochsBps) + require.Equal(t, argUint64(15), byAddr[v1].ProposalUptimeLast10EpochsObserved) + + require.NotNil(t, byAddr[v2].JoinEffectiveAtBlock) + require.Equal(t, argUint64(20), *byAddr[v2].JoinEffectiveAtBlock) + require.NotNil(t, byAddr[v2].ProposalUptimeLast3EpochsBps) + require.Equal(t, argUint64(7500), *byAddr[v2].ProposalUptimeLast3EpochsBps) + require.Equal(t, argUint64(4), byAddr[v2].ProposalUptimeLast3EpochsObserved) + + require.NotNil(t, byAddr[v3].DeactivateEffectiveAtBlock) + require.Equal(t, argUint64(20), *byAddr[v3].DeactivateEffectiveAtBlock) + require.NotNil(t, byAddr[v3].ProposalUptimeLast3EpochsBps) + require.Equal(t, argUint64(5000), *byAddr[v3].ProposalUptimeLast3EpochsBps) + require.Equal(t, argUint64(2), byAddr[v3].ProposalUptimeLast3EpochsObserved) +} + +func TestEth_GetPosValidatorsOverview_ProposalRollingUptime_NoObservedDuties(t *testing.T) { + v1 := types.StringToAddress("0x1000000000000000000000000000000000000021") + b25 := newTestBlock(25, types.StringToHash("0x26")) + + store := &posOverviewMockStore{ + head: b25.Header, + blocks: map[uint64]*types.Block{25: b25}, + receipt: map[types.Hash][]*types.Receipt{b25.Hash(): {}}, + stakes: map[types.Address]*big.Int{v1: big.NewInt(1000)}, + activeFlags: map[types.Address]bool{v1: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{v1}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5), "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}}}}, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + mode := "current" + resIntf, err := ep.GetPosValidatorsOverview(&mode) + require.NoError(t, err) + res := resIntf.(*posOverviewResponse) + require.Len(t, res.Validators, 1) + + val := res.Validators[0] + require.Nil(t, val.ProposalUptimeLast3EpochsBps) + require.Nil(t, val.ProposalUptimeLast10EpochsBps) + require.Nil(t, val.ProposalUptimeLast3EpochsPercent) + require.Nil(t, val.ProposalUptimeLast10EpochsPercent) + require.Equal(t, argUint64(0), val.ProposalUptimeLast3EpochsObserved) + require.Equal(t, argUint64(0), val.ProposalUptimeLast10EpochsObserved) +} + +func TestEth_GetPosValidatorsOverview_LastFinalized(t *testing.T) { + v1 := types.StringToAddress("0x1000000000000000000000000000000000000001") + b10 := newTestBlock(10, types.StringToHash("0x10")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{v1: big.NewInt(100)}, + vals: []types.Address{v1}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5), "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(8)}}}}}, + storage: map[types.Hash][]byte{ + keySlashed(2, v1): uint256Bytes(1), + }, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + mode := "lastFinalized" + resIntf, err := ep.GetPosValidatorsOverview(&mode) + require.NoError(t, err) + + res := resIntf.(*posOverviewResponse) + require.Equal(t, argUint64(2), res.ReportedEpoch) + require.Equal(t, argUint64(6), res.ReportedEpochStartBlock) + require.Equal(t, argUint64(10), res.ReportedEpochEndBlock) +} + +func TestEth_GetPosValidatorsOverview_NoLegacyBeaconSummaryFields(t *testing.T) { + v1 := types.StringToAddress("0x1000000000000000000000000000000000000001") + b10 := newTestBlock(10, types.StringToHash("0x10")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{v1: big.NewInt(100)}, + vals: []types.Address{v1}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5), "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(8)}}}}}, + storage: map[types.Hash][]byte{}, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + resIntf, err := ep.GetPosValidatorsOverview(nil) + require.NoError(t, err) + res := resIntf.(*posOverviewResponse) + raw, err := json.Marshal(res) + require.NoError(t, err) + + out := map[string]interface{}{} + require.NoError(t, json.Unmarshal(raw, &out)) + require.NotContains(t, out, "heartbeatHeight") + require.NotContains(t, out, "beaconLastAppliedSlot") + require.NotContains(t, out, "beaconLastAppliedEpoch") + require.NotContains(t, out, "beaconCurrentWallclockSlot") + require.NotContains(t, out, "beaconCurrentWallclockEpoch") + require.NotContains(t, out, "beaconSlotDurationSec") + require.NotContains(t, out, "beaconGenesisTimeUnix") + require.NotContains(t, out, "beaconTimeHealthy") + require.NotContains(t, out, "beaconTimeReason") + require.NotContains(t, out, "beaconTimeSampleCount") + require.NotContains(t, out, "recoveryTotalVotingPower") + require.NotContains(t, out, "recoveryActiveVotingPower") + require.NotContains(t, out, "recoveryViewSource") +} + +func TestEth_GetPosValidatorsOverview_InvalidMode(t *testing.T) { + b10 := newTestBlock(10, types.StringToHash("0x10")) + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{}, + vals: []types.Address{}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5), "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(8)}}}}}, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + mode := "foo" + _, err := ep.GetPosValidatorsOverview(&mode) + require.Error(t, err) + require.Contains(t, err.Error(), "invalid reportEpoch") +} + +func TestEth_GetPosValidatorsOverview_CurrentlyValidating_UsesEpochSnapshot(t *testing.T) { + v1 := types.StringToAddress("0x1000000000000000000000000000000000000001") + v2 := types.StringToAddress("0x1000000000000000000000000000000000000002") + b10 := newTestBlock(10, types.StringToHash("0x10")) + extraCurrent := &signer.IstanbulExtra{ + Validators: validators.NewECDSAValidatorSet(validators.NewECDSAValidator(v1)), + ProposerSeal: []byte{}, + CommittedSeals: &signer.SerializedSeal{}, + ParentCommittedSeals: &signer.SerializedSeal{}, + } + b10.Header.ExtraData = append(make([]byte, signer.IstanbulExtraVanity), extraCurrent.MarshalRLPTo(nil)...) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{ + v1: big.NewInt(100), + v2: big.NewInt(200), + }, + activeFlags: map[types.Address]bool{v1: true, v2: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{v1, v2}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5), "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(8)}}}}}, + minValidators: 2, + threshold: big.NewInt(500), + storage: map[types.Hash][]byte{ + keyEpochValidatorsLen(2): uint256Bytes(1), + keyEpochValidator(2, 0): uint256Address(v1), + }, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + resIntf, err := ep.GetPosValidatorsOverview(nil) + require.NoError(t, err) + + res := resIntf.(*posOverviewResponse) + require.Len(t, res.Validators, 2) + found := map[types.Address]bool{} + wasLast := map[types.Address]bool{} + for _, val := range res.Validators { + found[val.Address] = val.CurrentlyValidating + wasLast[val.Address] = val.WasValidatorLastEpoch + } + require.True(t, found[v1]) + require.False(t, found[v2]) + require.True(t, wasLast[v1]) + require.False(t, wasLast[v2]) +} + +func uint256Bytes(v uint64) []byte { + out := make([]byte, 32) + b := new(big.Int).SetUint64(v).Bytes() + copy(out[32-len(b):], b) + return out +} + +func uint256Address(addr types.Address) []byte { + out := make([]byte, 32) + copy(out[12:], addr[:]) + return out +} + +func toEthgoAddrs(addrs []types.Address) [][20]byte { + res := make([][20]byte, len(addrs)) + for i := range addrs { + res[i] = [20]byte(addrs[i]) + } + return res +} + +func TestEth_GetPosValidatorsOverview_PoSNotActive(t *testing.T) { + b10 := newTestBlock(10, types.StringToHash("0x10")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{}, + stakes: map[types.Address]*big.Int{}, + vals: []types.Address{}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5), "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(100)}}}}}, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + _, err := ep.GetPosValidatorsOverview(nil) + require.Error(t, err) + require.Contains(t, err.Error(), "PoS is not active yet") +} + +func TestEth_GetPosValidatorsOverview_RewardIneligibleOnlyForEpochMembers(t *testing.T) { + v1 := types.StringToAddress("0x1000000000000000000000000000000000000001") + b10 := newTestBlock(10, types.StringToHash("0x10")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{v1: big.NewInt(100)}, + vals: []types.Address{v1}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5), "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(8)}}}}}, + storage: map[types.Hash][]byte{ + keyProposerSlots(2, v1): uint256Bytes(10), + keyProposerMissed(2, v1): uint256Bytes(10), + keyEpochValidatorsLen(2): uint256Bytes(0), // v1 not in reported epoch validator set + }, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + mode := "current" + resIntf, err := ep.GetPosValidatorsOverview(&mode) + require.NoError(t, err) + + res := resIntf.(*posOverviewResponse) + require.Len(t, res.Validators, 1) + require.NotNil(t, res.Validators[0].RewardIneligible) + require.False(t, *res.Validators[0].RewardIneligible) +} + +func TestEth_GetPosValidatorDelegators_ReturnsPoolConfig(t *testing.T) { + validator := types.StringToAddress("0x2000000000000000000000000000000000000001") + delegator := types.StringToAddress("0x3000000000000000000000000000000000000001") + + head := newTestBlock(12, types.StringToHash("0x12")).Header + store := &posOverviewMockStore{ + head: head, + blocks: map[uint64]*types.Block{12: newTestBlock(12, types.StringToHash("0x12"))}, + receipt: map[types.Hash][]*types.Receipt{}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(2_000_000)}, + activeFlags: map[types.Address]bool{validator: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "type": "PoS", + "validator_type": "ecdsa", + "deployment": float64(0), + "minValidatorCount": float64(1), + "maxValidatorCount": float64(100), + "blockTrackerPollInterv": "1s", + }}}, + poolEnabled: map[types.Address]bool{validator: false}, + poolMax: map[types.Address]*big.Int{validator: big.NewInt(55)}, + poolCommission: map[types.Address]uint16{validator: 321}, + delegatorsByV: map[types.Address][]types.Address{validator: []types.Address{delegator}}, + stakerInfos: map[types.Address]map[string]interface{}{ + delegator: { + "exists": true, + "active": true, + "index": uint64(0), + "amount": big.NewInt(10), + "joinedAtBlock": big.NewInt(10), + "deactivatedAtBlock": big.NewInt(0), + "validator": ethgo.Address(validator), + "blsPubKey": []byte{}, + }, + }, + storage: map[types.Hash][]byte{ + keyStakeSnapshot(2, validator): uint256Bytes(200_000), + keyStakerStakeSnapshot(2, validator): uint256Bytes(200_000), + }, + } + + e := &Eth{store: store, logger: hclog.NewNullLogger()} + respAny, err := e.GetPosValidatorDelegators(validator, nil) + require.NoError(t, err) + + resp := respAny.(*posValidatorDelegatorsResponse) + require.Equal(t, validator, resp.Validator) + require.Equal(t, false, resp.DelegationEnabled) + require.Equal(t, "55", ((*big.Int)(resp.MaxTotalDelegatedStake)).String()) + require.Equal(t, "0", ((*big.Int)(resp.MinDelegatorStake)).String()) + require.Equal(t, "10000000000000000000000", ((*big.Int)(resp.EffectiveMinDelegatorStake)).String()) + require.Equal(t, argUint64(321), resp.CommissionBps) + require.Equal(t, "10", ((*big.Int)(resp.DelegatedActiveCurrent)).String()) + require.Equal(t, "2000010", ((*big.Int)(resp.TotalActiveCurrentStake)).String()) + require.Len(t, resp.Delegators, 1) + require.Equal(t, delegator, resp.Delegators[0].Delegator) +} + +func TestEth_GetPosValidatorDelegators_UsesRenamedCurrentStakeFieldsInJSON(t *testing.T) { + validator := types.StringToAddress("0x2000000000000000000000000000000000000002") + delegator := types.StringToAddress("0x3000000000000000000000000000000000000002") + + head := newTestBlock(20, types.StringToHash("0x20")).Header + store := &posOverviewMockStore{ + head: head, + blocks: map[uint64]*types.Block{20: newTestBlock(20, types.StringToHash("0x20"))}, + receipt: map[types.Hash][]*types.Receipt{}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(200_000)}, + activeFlags: map[types.Address]bool{validator: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "type": "PoS", + }}}, + poolEnabled: map[types.Address]bool{validator: true}, + poolMax: map[types.Address]*big.Int{validator: big.NewInt(10_000)}, + poolCommission: map[types.Address]uint16{validator: 100}, + delegatorsByV: map[types.Address][]types.Address{validator: []types.Address{delegator}}, + stakerInfos: map[types.Address]map[string]interface{}{ + delegator: { + "exists": true, + "active": true, + "index": uint64(0), + "amount": big.NewInt(10_000), + "joinedAtBlock": big.NewInt(10), + "deactivatedAtBlock": big.NewInt(0), + "validator": ethgo.Address(validator), + "blsPubKey": []byte{}, + }, + }, + } + + e := &Eth{store: store, logger: hclog.NewNullLogger()} + respAny, err := e.GetPosValidatorDelegators(validator, nil) + require.NoError(t, err) + + raw, err := json.Marshal(respAny) + require.NoError(t, err) + rawStr := string(raw) + require.Contains(t, rawStr, "delegatedActiveCurrent") + require.Contains(t, rawStr, "totalActiveCurrentStake") + require.NotContains(t, rawStr, "delegatedEffective") + require.NotContains(t, rawStr, "effectiveTotalStake") + require.Contains(t, rawStr, "effectiveAtPoint") +} + +func TestPosValidatorDelegatorsResponse_JSONPoolFieldNames(t *testing.T) { + resp := &posValidatorDelegatorsResponse{ + MaxTotalDelegatedStake: (*argBig)(big.NewInt(1)), + MinDelegatorStake: (*argBig)(big.NewInt(2)), + EffectiveMinDelegatorStake: (*argBig)(big.NewInt(3)), + } + + raw, err := json.Marshal(resp) + require.NoError(t, err) + rawStr := string(raw) + require.Contains(t, rawStr, "maxTotalDelegatedStake") + require.Contains(t, rawStr, "minDelegatorStake") + require.Contains(t, rawStr, "effectiveMinDelegatorStake") + require.NotContains(t, rawStr, "maxDelegatedStake") + require.NotContains(t, rawStr, "minDelegationStake") + require.NotContains(t, rawStr, "effectiveMinDelegationStake") +} + +func TestEth_GetPosValidatorDelegators_ExcludesSelfValidatorAndReturnsRewardFields(t *testing.T) { + validator := types.StringToAddress("0x2200000000000000000000000000000000000002") + delegator := types.StringToAddress("0x2300000000000000000000000000000000000002") + b10 := newTestBlock(10, types.StringToHash("0x22")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(200_000), delegator: big.NewInt(10_000)}, + activeFlags: map[types.Address]bool{validator: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}, + }}}, + delegatorsByV: map[types.Address][]types.Address{validator: []types.Address{validator, delegator}}, + stakerInfos: map[types.Address]map[string]interface{}{ + validator: { + "exists": true, + "active": true, + "index": uint64(0), + "amount": big.NewInt(200_000), + "joinedAtBlock": big.NewInt(1), + "deactivatedAtBlock": big.NewInt(0), + "validator": ethgo.Address(validator), + "blsPubKey": []byte{}, + }, + delegator: { + "exists": true, + "active": true, + "index": uint64(1), + "amount": big.NewInt(10_000), + "joinedAtBlock": big.NewInt(8), + "deactivatedAtBlock": big.NewInt(0), + "validator": ethgo.Address(validator), + "blsPubKey": []byte{}, + }, + }, + storage: map[types.Hash][]byte{ + keyDelegatorReward(2, validator, delegator): uint256Bytes(123), + }, + } + + e := &Eth{store: store, logger: hclog.NewNullLogger()} + mode := "current" + respAny, err := e.GetPosValidatorDelegators(validator, &mode) + require.NoError(t, err) + + resp := respAny.(*posValidatorDelegatorsResponse) + require.Len(t, resp.Delegators, 1) + require.Equal(t, delegator, resp.Delegators[0].Delegator) + require.Nil(t, resp.Delegators[0].ReportedEpochReward) +} + +func TestEth_GetPosValidatorDelegators_LastFinalizedUsesEpochEffectiveStake(t *testing.T) { + validator := types.StringToAddress("0x2400000000000000000000000000000000000002") + liveOnlyDelegatorA := types.StringToAddress("0x2500000000000000000000000000000000000002") + liveOnlyDelegatorB := types.StringToAddress("0x2500000000000000000000000000000000000003") + b20 := newTestBlock(20, types.StringToHash("0x24")) + store := &posOverviewMockStore{ + head: b20.Header, + blocks: map[uint64]*types.Block{20: b20}, + receipt: map[types.Hash][]*types.Receipt{b20.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(200_000), liveOnlyDelegatorA: big.NewInt(10_000), liveOnlyDelegatorB: big.NewInt(7_000)}, + activeFlags: map[types.Address]bool{validator: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(10), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}, + }}}, + delegatorsByV: map[types.Address][]types.Address{validator: {liveOnlyDelegatorA, liveOnlyDelegatorB}}, + stakerInfos: map[types.Address]map[string]interface{}{ + validator: { + "exists": true, "active": true, "index": uint64(0), "amount": big.NewInt(200_000), + "joinedAtBlock": big.NewInt(1), "deactivatedAtBlock": big.NewInt(0), "validator": ethgo.Address(validator), "blsPubKey": []byte{}, + }, + liveOnlyDelegatorA: { + "exists": true, "active": true, "index": uint64(1), "amount": big.NewInt(10_000), + "joinedAtBlock": big.NewInt(15), "deactivatedAtBlock": big.NewInt(0), "validator": ethgo.Address(validator), "blsPubKey": []byte{}, + }, + liveOnlyDelegatorB: { + "exists": true, "active": true, "index": uint64(2), "amount": big.NewInt(7_000), + "joinedAtBlock": big.NewInt(19), "deactivatedAtBlock": big.NewInt(0), "validator": ethgo.Address(validator), "blsPubKey": []byte{}, + }, + }, + storage: map[types.Hash][]byte{ + keyStakerStakeSnapshot(2, validator): uint256Bytes(123_456), + keyStakeSnapshot(2, validator): uint256Bytes(222_222), + keyStakerStakeSnapshot(2, liveOnlyDelegatorA): uint256Bytes(3_000), + }, + } + + e := &Eth{store: store, logger: hclog.NewNullLogger()} + mode := "lastFinalized" + respAny, err := e.GetPosValidatorDelegators(validator, &mode) + require.NoError(t, err) + resp := respAny.(*posValidatorDelegatorsResponse) + require.Equal(t, "3000", ((*big.Int)(resp.DelegatedEpochEffective)).String()) + require.Equal(t, "123456", ((*big.Int)(resp.SelfStakeEpochEffective)).String()) + require.Equal(t, "222222", ((*big.Int)(resp.TotalEpochEffectiveStake)).String()) + require.Equal(t, "217000", ((*big.Int)(resp.TotalLiveStake)).String()) + require.Len(t, resp.Delegators, 2) + require.True(t, resp.Delegators[0].EffectiveAtPoint) + require.Equal(t, "3000", ((*big.Int)(resp.Delegators[0].EpochEffectiveAmount)).String()) + require.False(t, resp.Delegators[1].EffectiveAtPoint) + require.Equal(t, "0", ((*big.Int)(resp.Delegators[1].EpochEffectiveAmount)).String()) +} + +func TestEth_GetPosValidatorDelegators_LastFinalizedKeepsDeactivatedDelegatorEffectiveForFinalizedEpoch(t *testing.T) { + validator := types.StringToAddress("0x2600000000000000000000000000000000000002") + delegator := types.StringToAddress("0x2700000000000000000000000000000000000002") + b20 := newTestBlock(20, types.StringToHash("0x25")) + store := &posOverviewMockStore{ + head: b20.Header, + blocks: map[uint64]*types.Block{20: b20}, + receipt: map[types.Hash][]*types.Receipt{b20.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(200_000), delegator: big.NewInt(10_000)}, + activeFlags: map[types.Address]bool{validator: true, delegator: false}, + deactiveBlocks: map[types.Address]uint64{delegator: 19}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(10), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}, + }}}, + delegatorsByV: map[types.Address][]types.Address{validator: {delegator}}, + stakerInfos: map[types.Address]map[string]interface{}{ + validator: { + "exists": true, "active": true, "index": uint64(0), "amount": big.NewInt(200_000), + "joinedAtBlock": big.NewInt(1), "deactivatedAtBlock": big.NewInt(0), "validator": ethgo.Address(validator), "blsPubKey": []byte{}, + }, + delegator: { + "exists": true, "active": false, "index": uint64(1), "amount": big.NewInt(10_000), + "joinedAtBlock": big.NewInt(8), "deactivatedAtBlock": big.NewInt(19), "validator": ethgo.Address(validator), "blsPubKey": []byte{}, + }, + }, + storage: map[types.Hash][]byte{ + keyStakeSnapshot(2, validator): uint256Bytes(210_000), + keyStakerStakeSnapshot(2, validator): uint256Bytes(200_000), + keyStakerStakeSnapshot(2, delegator): uint256Bytes(10_000), + }, + } + + e := &Eth{store: store, logger: hclog.NewNullLogger()} + mode := "lastFinalized" + respAny, err := e.GetPosValidatorDelegators(validator, &mode) + require.NoError(t, err) + resp := respAny.(*posValidatorDelegatorsResponse) + require.Equal(t, "10000", ((*big.Int)(resp.DelegatedEpochEffective)).String()) + require.Equal(t, "210000", ((*big.Int)(resp.TotalEpochEffectiveStake)).String()) + require.Equal(t, "200000", ((*big.Int)(resp.TotalLiveStake)).String()) + require.Len(t, resp.Delegators, 1) + require.True(t, resp.Delegators[0].EffectiveAtPoint) +} + +func TestEth_GetPosValidatorDelegators_LastFinalizedDoesNotFallbackWhenTotalSnapshotMissing(t *testing.T) { + validator := types.StringToAddress("0x2600000000000000000000000000000000000003") + delegator := types.StringToAddress("0x2700000000000000000000000000000000000003") + b20 := newTestBlock(20, types.StringToHash("0x26")) + store := &posOverviewMockStore{ + head: b20.Header, + blocks: map[uint64]*types.Block{20: b20}, + receipt: map[types.Hash][]*types.Receipt{b20.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(200_000), delegator: big.NewInt(10_000)}, + activeFlags: map[types.Address]bool{validator: true, delegator: false}, + deactiveBlocks: map[types.Address]uint64{delegator: 19}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(10), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}, + }}}, + delegatorsByV: map[types.Address][]types.Address{validator: {delegator}}, + stakerInfos: map[types.Address]map[string]interface{}{ + validator: {"exists": true, "active": true, "index": uint64(0), "amount": big.NewInt(200_000), "joinedAtBlock": big.NewInt(1), "deactivatedAtBlock": big.NewInt(0), "validator": ethgo.Address(validator), "blsPubKey": []byte{}}, + delegator: {"exists": true, "active": false, "index": uint64(1), "amount": big.NewInt(10_000), "joinedAtBlock": big.NewInt(8), "deactivatedAtBlock": big.NewInt(19), "validator": ethgo.Address(validator), "blsPubKey": []byte{}}, + }, + storage: map[types.Hash][]byte{ + keyStakerStakeSnapshot(2, validator): uint256Bytes(200_000), + keyStakerStakeSnapshot(2, delegator): uint256Bytes(10_000), + }, + } + + e := &Eth{store: store, logger: hclog.NewNullLogger()} + mode := "lastFinalized" + respAny, err := e.GetPosValidatorDelegators(validator, &mode) + require.NoError(t, err) + resp := respAny.(*posValidatorDelegatorsResponse) + require.Equal(t, "10000", ((*big.Int)(resp.DelegatedEpochEffective)).String()) + require.Equal(t, "200000", ((*big.Int)(resp.SelfStakeEpochEffective)).String()) + require.Equal(t, "0", ((*big.Int)(resp.TotalEpochEffectiveStake)).String()) +} + +func TestEth_GetPosValidatorsOverview_ExcludesDelegatorsFromValidatorList(t *testing.T) { + validator := types.StringToAddress("0x4000000000000000000000000000000000000001") + delegator := types.StringToAddress("0x4000000000000000000000000000000000000002") + b10 := newTestBlock(10, types.StringToHash("0x10")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(200_000), delegator: big.NewInt(10_000)}, + activeFlags: map[types.Address]bool{validator: true, delegator: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}, + }}}, + delegatorsByV: map[types.Address][]types.Address{validator: []types.Address{delegator}}, + stakerInfos: map[types.Address]map[string]interface{}{ + delegator: { + "exists": true, + "active": true, + "index": uint64(0), + "amount": big.NewInt(10_000), + "joinedAtBlock": big.NewInt(8), + "deactivatedAtBlock": big.NewInt(0), + "validator": ethgo.Address(validator), + "blsPubKey": []byte{}, + }, + }, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + resAny, err := ep.GetPosValidatorsOverview(nil) + require.NoError(t, err) + + res := resAny.(*posOverviewResponse) + require.Len(t, res.Validators, 1) + require.Equal(t, validator, res.Validators[0].Address) +} + +func TestEth_GetPosValidatorsOverview_ProvidesMicroEpochFields(t *testing.T) { + validator := types.StringToAddress("0x6000000000000000000000000000000000000001") + b10 := newTestBlock(10, types.StringToHash("0x10")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(2_000_000)}, + activeFlags: map[types.Address]bool{validator: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "microEpochSize": float64(4), + "microEpochNominalWeightUnits": float64(10000), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}, + }}}, + } + store.storage = map[types.Hash][]byte{ + keyUptimeNominalWeight(validator): uint256Bytes(100), + keyUptimeEffectiveWeight(validator): uint256Bytes(100), + keyUptimeInactivity(validator): uint256Bytes(0), + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + resAny, err := ep.GetPosValidatorsOverview(nil) + require.NoError(t, err) + + res := resAny.(*posOverviewResponse) + require.Equal(t, argUint64(4), res.MicroEpochSize) + require.Equal(t, argUint64(2), res.CurrentMicroEpoch) + require.Equal(t, argUint64(9), res.CurrentMicroEpochStartBlock) + require.Equal(t, argUint64(12), res.CurrentMicroEpochEndBlock) + require.Len(t, res.Validators, 1) + require.NotNil(t, res.Validators[0].MicroNominalWeight) + require.NotNil(t, res.Validators[0].MicroEffectiveWeight) + require.Equal(t, argUint64(100), *res.Validators[0].MicroNominalWeight) + require.Equal(t, argUint64(100), *res.Validators[0].MicroEffectiveWeight) + require.NotNil(t, res.Validators[0].MicroInactivity) + require.Equal(t, argUint64(0), *res.Validators[0].MicroInactivity) + + payload, err := json.Marshal(res) + require.NoError(t, err) + text := string(payload) + for _, forbidden := range []string{ + "effectiveStake", "votingPower", "totalVotingPower", "weightedQuorumThreshold", + "beaconNominalWeight", "beaconEffectiveWeight", "beaconInactivity", + "recoveryVotingPower", "recoveryTotalVotingPower", "recoveryActiveVotingPower", "recoveryViewSource", + "beaconTimeHealthy", "beaconTimeReason", "beaconTimeSampleCount", + } { + require.NotContains(t, text, forbidden) + } +} + +func TestEth_GetPosValidatorsOverview_MicroWeights_DefaultWhenStateMissing(t *testing.T) { + validator := types.StringToAddress("0x6000000000000000000000000000000000000002") + b10 := newTestBlock(10, types.StringToHash("0x11")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(2_000_000)}, + activeFlags: map[types.Address]bool{validator: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "microEpochSize": float64(4), + "microEpochNominalWeightUnits": float64(10000), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}, + }}}, + } + store.storage = map[types.Hash][]byte{} + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + resAny, err := ep.GetPosValidatorsOverview(nil) + require.NoError(t, err) + + res := resAny.(*posOverviewResponse) + require.Len(t, res.Validators, 1) + require.Nil(t, res.Validators[0].MicroNominalWeight) + require.Nil(t, res.Validators[0].MicroEffectiveWeight) + require.Nil(t, res.Validators[0].MicroInactivity) + + out, err := json.Marshal(res) + require.NoError(t, err) + require.NotContains(t, string(out), "beaconNominalWeight") + require.NotContains(t, string(out), "votingPower") +} + +func TestEth_GetPosValidatorsOverview_MicroEpochMissingConfigLeavesFieldsZero(t *testing.T) { + validator := types.StringToAddress("0x6000000000000000000000000000000000000004") + b10 := newTestBlock(10, types.StringToHash("0x13")) + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(2_000_000)}, + activeFlags: map[types.Address]bool{validator: true}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5)}}}, + } + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + resAny, err := ep.GetPosValidatorsOverview(nil) + require.NoError(t, err) + res := resAny.(*posOverviewResponse) + require.Equal(t, argUint64(0), res.MicroEpochSize) + require.Equal(t, argUint64(0), res.CurrentMicroEpoch) + require.Equal(t, argUint64(0), res.CurrentMicroEpochStartBlock) + require.Equal(t, argUint64(0), res.CurrentMicroEpochEndBlock) +} + +func TestEth_GetPosValidatorsOverview_MicroEpochConfigTooSmallIsRejected(t *testing.T) { + v1 := types.StringToAddress("0x6000000000000000000000000000000000000005") + v2 := types.StringToAddress("0x6000000000000000000000000000000000000006") + b10 := newTestBlock(10, types.StringToHash("0x14")) + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{v1: big.NewInt(2_000_000), v2: big.NewInt(2_000_000)}, + activeFlags: map[types.Address]bool{v1: true, v2: true}, + vals: []types.Address{v1, v2}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "microEpochSize": float64(1), + }}}, + } + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + resAny, err := ep.GetPosValidatorsOverview(nil) + require.NoError(t, err) + res := resAny.(*posOverviewResponse) + require.Equal(t, argUint64(0), res.MicroEpochSize) +} + +func TestEth_GetPosValidatorsOverview_MicroWeights_DecayFromState(t *testing.T) { + validator := types.StringToAddress("0x6000000000000000000000000000000000000003") + b10 := newTestBlock(10, types.StringToHash("0x12")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(2_000_000)}, + activeFlags: map[types.Address]bool{validator: true}, + deactiveBlocks: map[types.Address]uint64{}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "microEpochSize": float64(4), + "microEpochNominalWeightUnits": float64(10000), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}, + }}}, + } + store.storage = map[types.Hash][]byte{ + keyUptimeNominalWeight(validator): uint256Bytes(10000), + keyUptimeEffectiveWeight(validator): uint256Bytes(5000), + keyUptimeInactivity(validator): uint256Bytes(1), + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + resAny, err := ep.GetPosValidatorsOverview(nil) + require.NoError(t, err) + res := resAny.(*posOverviewResponse) + require.Len(t, res.Validators, 1) + require.Equal(t, argUint64(10000), *res.Validators[0].MicroNominalWeight) + require.Equal(t, argUint64(5000), *res.Validators[0].MicroEffectiveWeight) + require.Equal(t, argUint64(1), *res.Validators[0].MicroInactivity) +} + +func TestEth_GetPosValidatorsOverview_ProvidesEpochTimingFields(t *testing.T) { + validator := types.StringToAddress("0x5000000000000000000000000000000000000001") + b10 := newTestBlock(10, types.StringToHash("0x10")) + + store := &posOverviewMockStore{ + head: b10.Header, + blocks: map[uint64]*types.Block{10: b10}, + receipt: map[types.Hash][]*types.Receipt{b10.Hash(): {}}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(2_000_000)}, + activeFlags: map[types.Address]bool{validator: false}, + deactiveBlocks: map[types.Address]uint64{validator: 9}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{ + "epochSize": float64(5), + "types": []interface{}{map[string]interface{}{"type": "PoS", "from": float64(1)}}, + }}}, + stakerInfos: map[types.Address]map[string]interface{}{ + validator: { + "exists": true, + "active": false, + "index": uint64(0), + "amount": big.NewInt(2_000_000), + "joinedAtBlock": big.NewInt(8), + "deactivatedAtBlock": big.NewInt(9), + "validator": ethgo.Address(validator), + "blsPubKey": []byte{}, + }, + }, + } + + ep := &Eth{logger: hclog.NewNullLogger(), store: store} + resAny, err := ep.GetPosValidatorsOverview(nil) + require.NoError(t, err) + res := resAny.(*posOverviewResponse) + require.Len(t, res.Validators, 1) + v := res.Validators[0] + require.NotNil(t, v.JoinedAtBlock) + require.NotNil(t, v.JoinEffectiveAtBlock) + require.NotNil(t, v.DeactivatedAtBlock) + require.NotNil(t, v.DeactivateEffectiveAtBlock) + require.NotNil(t, v.UnstakeAvailableAtBlock) + require.Equal(t, argUint64(8), *v.JoinedAtBlock) + require.Equal(t, argUint64(10), *v.JoinEffectiveAtBlock) + require.Equal(t, argUint64(9), *v.DeactivatedAtBlock) + require.Equal(t, argUint64(10), *v.DeactivateEffectiveAtBlock) + require.Equal(t, argUint64(10), *v.UnstakeAvailableAtBlock) + require.True(t, v.CanUnstakeNow) +} + +func TestEth_GetPosValidatorDelegators_UsesCustomEffectiveMinDelegatorStake(t *testing.T) { + validator := types.StringToAddress("0x1111000000000000000000000000000000000001") + head := newTestBlock(20, types.StringToHash("0x99")).Header + custom, _ := new(big.Int).SetString("123000000000000000000000", 10) + store := &posOverviewMockStore{ + head: head, + blocks: map[uint64]*types.Block{20: newTestBlock(20, types.StringToHash("0x99"))}, + receipt: map[types.Hash][]*types.Receipt{}, + stakes: map[types.Address]*big.Int{validator: big.NewInt(200_000)}, + activeFlags: map[types.Address]bool{validator: true}, + vals: []types.Address{validator}, + params: &chain.Params{Engine: map[string]interface{}{"ibft": map[string]interface{}{"epochSize": float64(5), "type": "PoS"}}}, + poolEnabled: map[types.Address]bool{validator: true}, + poolMax: map[types.Address]*big.Int{validator: big.NewInt(55)}, + poolMin: map[types.Address]*big.Int{validator: custom}, + poolCommission: map[types.Address]uint16{validator: 321}, + delegatorsByV: map[types.Address][]types.Address{validator: {}}, + stakerInfos: map[types.Address]map[string]interface{}{}, + } + e := &Eth{store: store, logger: hclog.NewNullLogger()} + respAny, err := e.GetPosValidatorDelegators(validator, nil) + require.NoError(t, err) + resp := respAny.(*posValidatorDelegatorsResponse) + require.Equal(t, custom.String(), ((*big.Int)(resp.MinDelegatorStake)).String()) + require.Equal(t, custom.String(), ((*big.Int)(resp.EffectiveMinDelegatorStake)).String()) + require.Equal(t, "55", ((*big.Int)(resp.MaxTotalDelegatedStake)).String()) +} diff --git a/jsonrpc/eth_state_test.go b/jsonrpc/eth_state_test.go index ff2bc83..b672565 100644 --- a/jsonrpc/eth_state_test.go +++ b/jsonrpc/eth_state_test.go @@ -5,12 +5,12 @@ import ( "math/big" "testing" + "github.com/stretchr/testify/assert" "github.com/xgr-network/xgr-node/chain" "github.com/xgr-network/xgr-node/helper/hex" "github.com/xgr-network/xgr-node/state" "github.com/xgr-network/xgr-node/state/runtime" "github.com/xgr-network/xgr-node/types" - "github.com/stretchr/testify/assert" ) var ( @@ -704,6 +704,25 @@ func TestEth_EstimateGas_GasLimit(t *testing.T) { } } +func TestEth_EstimateGas_InsufficientFundsBeforeIntrinsic(t *testing.T) { + store := getExampleStore() + ethEndpoint := newTestEthEndpoint(store) + + // Keep the sender balance too low to cover intrinsic gas at the specified gas price. + store.account.account.Balance = big.NewInt(10000) + + // Contract interaction (non-empty data) forces estimate-by-execution path. + tx := constructMockTx(nil, argBytesPtr([]byte{0x12})) + tx.GasPrice = argBytesPtr([]byte{0x1}) + + estimate, err := ethEndpoint.EstimateGas(tx, nil) + + assert.Nil(t, estimate) + assert.Error(t, err) + assert.ErrorIs(t, err, state.ErrNotEnoughFundsForGas) + assert.ErrorContains(t, err, "insufficient funds for gas * price + value") +} + func TestEth_EstimateGas_Reverts(t *testing.T) { testTable := []struct { name string @@ -902,6 +921,10 @@ func (m *mockSpecialStore) GetForksInTime(blockNumber uint64) chain.ForksInTime return chain.AllForksEnabled.At(0) } +func (m *mockSpecialStore) GetChainParams() *chain.Params { + return nil +} + func (m *mockSpecialStore) ApplyTxn(header *types.Header, txn *types.Transaction, _ types.StateOverride, _ bool) (*runtime.ExecutionResult, error) { if m.applyTxnHook != nil { return m.applyTxnHook(header, txn) diff --git a/jsonrpc/filter_manager_test.go b/jsonrpc/filter_manager_test.go index 5cb2015..dd75aa6 100644 --- a/jsonrpc/filter_manager_test.go +++ b/jsonrpc/filter_manager_test.go @@ -11,13 +11,15 @@ import ( "testing" "time" - "github.com/xgr-network/xgr-node/blockchain" - "github.com/xgr-network/xgr-node/txpool/proto" - "github.com/xgr-network/xgr-node/types" "github.com/gorilla/websocket" "github.com/hashicorp/go-hclog" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/blockchain" + "github.com/xgr-network/xgr-node/consensus/ibft/pos" + "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/txpool/proto" + "github.com/xgr-network/xgr-node/types" ) func Test_GetLogsForQuery(t *testing.T) { @@ -230,6 +232,46 @@ func Test_getLogsFromBlock(t *testing.T) { } } +func TestGetLogsForQueryFindsPosSystemReceiptLogsOnBoundaryBlock(t *testing.T) { + t.Parallel() + + header := &types.Header{Hash: types.StringToHash("pos-boundary"), Number: 20} + systemTx := pos.EpochFinalizationSystemTx(header.Number) + uptimeTopic := types.BytesToHash(crypto.Keccak256([]byte("ValidatorUptimeFinalized(uint256,address,uint256,uint256,uint256,uint256,uint256,bool,bool)"))) + + block := &types.Block{ + Header: header, + Transactions: []*types.Transaction{systemTx}, + } + store := &mockBlockStore{receipts: map[types.Hash][]*types.Receipt{ + header.Hash: { + { + TxHash: systemTx.Hash, + TransactionType: types.StateTx, + Logs: []*types.Log{ + {Address: pos.PosSysAddr, Topics: []types.Hash{uptimeTopic}}, + }, + }, + }, + }} + store.appendBlocksToStore([]*types.Block{block}) + + f := NewFilterManager(hclog.NewNullLogger(), store, 1000) + t.Cleanup(func() { f.Close() }) + + logs, err := f.GetLogsForQuery(&LogQuery{ + fromBlock: 20, + toBlock: 20, + Addresses: []types.Address{pos.PosSysAddr}, + Topics: [][]types.Hash{{uptimeTopic}}, + }) + + require.NoError(t, err) + require.Len(t, logs, 1) + require.Equal(t, systemTx.Hash, logs[0].TxHash) + require.Equal(t, uint64(0), uint64(logs[0].TxIndex)) +} + func Test_GetLogFilterFromID(t *testing.T) { t.Parallel() diff --git a/jsonrpc/mocks_test.go b/jsonrpc/mocks_test.go index 5303df5..14a054d 100644 --- a/jsonrpc/mocks_test.go +++ b/jsonrpc/mocks_test.go @@ -1,6 +1,7 @@ package jsonrpc import ( + "github.com/xgr-network/xgr-node/chain" "math/big" "sync" @@ -220,3 +221,7 @@ func (m *mockStore) GetStateSyncProof(stateSyncID uint64) (types.Proof, error) { func (m *mockStore) FilterExtra(extra []byte) ([]byte, error) { return extra, nil } + +func (m *mockStore) GetChainParams() *chain.Params { + return nil +} diff --git a/jsonrpc/throttling_test.go b/jsonrpc/throttling_test.go index 13b73ac..f5218fa 100644 --- a/jsonrpc/throttling_test.go +++ b/jsonrpc/throttling_test.go @@ -14,82 +14,85 @@ func TestThrottling(t *testing.T) { t.Parallel() th := NewThrottling(5, time.Millisecond*50) - sfn := func(value int, sleep time.Duration) func() (interface{}, error) { - return func() (interface{}, error) { - time.Sleep(sleep) - return value, nil - } - } + acquiredCh := make(chan struct{}, 10) + releaseCh := make(chan struct{}, 10) + finishedCh := make(chan struct{}, 10) + waitTimeout := 5 * time.Second wg := sync.WaitGroup{} - wg.Add(9) - - go func() { - defer wg.Done() - - res, err := th.AttemptRequest(context.Background(), sfn(100, time.Millisecond*500)) - - require.NoError(t, err) - assert.Equal(t, 100, res.(int)) //nolint - }() - time.Sleep(time.Millisecond * 100) + startBlockingRequest := func(value int) { + wg.Add(1) - for i := 2; i <= 5; i++ { go func() { defer wg.Done() - res, err := th.AttemptRequest(context.Background(), sfn(100, time.Millisecond*1000)) + res, err := th.AttemptRequest(context.Background(), func() (interface{}, error) { + acquiredCh <- struct{}{} + <-releaseCh + + return value, nil + }) require.NoError(t, err) - assert.Equal(t, 100, res.(int)) //nolint + assert.Equal(t, value, res.(int)) //nolint + finishedCh <- struct{}{} }() } - go func() { - time.Sleep(time.Millisecond * 150) - - defer wg.Done() - - res, err := th.AttemptRequest(context.Background(), sfn(100, time.Millisecond*100)) - - require.ErrorIs(t, err, errRequestLimitExceeded) - assert.Nil(t, res) - }() + for i := 0; i < 5; i++ { + startBlockingRequest(100) + } - go func() { - time.Sleep(time.Millisecond * 620) + for i := 0; i < 5; i++ { + select { + case <-acquiredCh: + case <-time.After(waitTimeout): + t.Fatal("timed out waiting for request acquisition") + } + } - defer wg.Done() + res, err := th.AttemptRequest(context.Background(), func() (interface{}, error) { + return 1, nil + }) - res, err := th.AttemptRequest(context.Background(), sfn(10, time.Millisecond*100)) + require.ErrorIs(t, err, errRequestLimitExceeded) + assert.Nil(t, res) - require.NoError(t, err) - assert.Equal(t, 10, res.(int)) //nolint - }() + releaseCh <- struct{}{} - go func() { - time.Sleep(time.Millisecond * 640) + select { + case <-finishedCh: + case <-time.After(waitTimeout): + t.Fatal("timed out waiting for request release") + } - defer wg.Done() + startBlockingRequest(10) - res, err := th.AttemptRequest(context.Background(), sfn(100, time.Millisecond*100)) + select { + case <-acquiredCh: + case <-time.After(waitTimeout): + t.Fatal("timed out waiting for replacement request acquisition") + } - require.ErrorIs(t, err, errRequestLimitExceeded) - assert.Nil(t, res) - }() + res, err = th.AttemptRequest(context.Background(), func() (interface{}, error) { + return 2, nil + }) - go func() { - time.Sleep(time.Millisecond * 1000) + require.ErrorIs(t, err, errRequestLimitExceeded) + assert.Nil(t, res) - defer wg.Done() + for i := 0; i < 5; i++ { + releaseCh <- struct{}{} + } - res, err := th.AttemptRequest(context.Background(), sfn(1, time.Millisecond*100)) + wg.Wait() - require.NoError(t, err) - assert.Equal(t, 1, res.(int)) //nolint - }() + res, err = th.AttemptRequest(context.Background(), func() (interface{}, error) { + return 3, nil + }) - wg.Wait() + require.NoError(t, err) + assert.Equal(t, 3, res.(int)) //nolint } diff --git a/jsonrpc/xgr_engine_embedded.go b/jsonrpc/xgr_engine_embedded.go index de21e61..61cd417 100644 --- a/jsonrpc/xgr_engine_embedded.go +++ b/jsonrpc/xgr_engine_embedded.go @@ -20,13 +20,13 @@ func newXGREndpointEmbedded(logger hclog.Logger, ethRPCURL, engineEOA string, en } ctx := context.Background() - // 1) SessionStore sofort (braucht kein JSON-RPC) + // 1) Initialize session store immediately (does not require JSON-RPC). store, err := xdala.NewPGSessionStore(ctx, "") if err != nil { return nil, fmt.Errorf("init session store: %w", err) } - // 2) Endpoint sofort mit Sessions (damit enqueue/wakeup etc. nicht mehr nil sind) + // 2) Initialize endpoint immediately with sessions (so enqueue/wakeup etc. are not nil). ep := xgrsvc.New(xgrsvc.Config{ Logger: logger.Named("xgr"), EthRPCURL: ethRPCURL, @@ -35,12 +35,12 @@ func newXGREndpointEmbedded(logger hclog.Logger, ethRPCURL, engineEOA string, en Sessions: store, }) - // 3) TxLayer + Background NACHLAUFEND starten (sonst Boot-Deadlock auf 127.0.0.1:8545) + // 3) Start TxLayer + background asynchronously afterward (avoid boot deadlock on 127.0.0.1:8545). go func() { log := logger.Named("engine.boot") var lastErr error - // kurze Retry-Phase reicht, weil JSON-RPC gleich hochkommt + // A short retry window is enough because JSON-RPC starts shortly after. for i := 0; i < 120; i++ { // 120 * 250ms = 30s txl, err := xdala.NewRpcTxLayerFromEnv(ctx, logger.Named("xdala.tx")) if err == nil { @@ -57,7 +57,7 @@ func newXGREndpointEmbedded(logger hclog.Logger, ethRPCURL, engineEOA string, en } lastErr = err - // nicht spammen + // avoid log spam if i == 0 || i == 19 || i == 59 || i == 119 { log.Warn("tx layer not ready yet", "attempt", i+1, "err", err) } diff --git a/network/gossip_test.go b/network/gossip_test.go index 78a7a5e..2dbbb0f 100644 --- a/network/gossip_test.go +++ b/network/gossip_test.go @@ -4,6 +4,7 @@ import ( "context" "errors" "fmt" + "sync" "testing" "time" @@ -37,10 +38,13 @@ func TestSimpleGossip(t *testing.T) { servers, createErr := createServers(numServers, nil) require.NoError(t, createErr, "Unable to create servers") - messageCh := make(chan *testproto.GenericMessage) + var ( + receivedMu sync.Mutex + receivedBy = make(map[int]struct{}, numServers) + callbackErr error + ) t.Cleanup(func() { - close(messageCh) closeTestServers(t, servers) }) @@ -56,46 +60,56 @@ func TestSimpleGossip(t *testing.T) { serverTopics[i] = topic + serverIndex := i subscribeErr := topic.Subscribe(func(obj interface{}, _ peer.ID) { - // Everyone should relay they got the message genericMessage, ok := obj.(*testproto.GenericMessage) - require.True(t, ok, "invalid type assert") + receivedMu.Lock() + defer receivedMu.Unlock() - messageCh <- genericMessage + if !ok { + if callbackErr == nil { + callbackErr = fmt.Errorf("invalid type assert for server %d", serverIndex) + } + + return + } + + if genericMessage.Message == sentMessage { + receivedBy[serverIndex] = struct{}{} + } }) require.NoError(t, subscribeErr, "Unable to subscribe to topic") } - publisher := servers[0] publisherTopic := serverTopics[0] - ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second) - defer cancel() + require.Eventually(t, func() bool { + for i := range servers { + if NumSubscribers(servers[i], topicName) < len(servers)-1 { + return false + } + } - err := WaitForSubscribers(ctx, publisher, topicName, len(servers)-1) - require.NoError(t, err, "Unable to wait for subscribers") + return true + }, 10*time.Second, 100*time.Millisecond, "Unable to wait for subscribers on all servers") - err = publisherTopic.Publish( + err := publisherTopic.Publish( &testproto.GenericMessage{ Message: sentMessage, }) require.NoError(t, err, "Unable to publish message") - messagesGossiped := 0 + require.Eventually(t, func() bool { + receivedMu.Lock() + defer receivedMu.Unlock() - for { - select { - case <-time.After(time.Second * 15): - t.Fatalf("Multicast messages not received before timeout") - case message := <-messageCh: - if message.Message == sentMessage { - messagesGossiped++ - if messagesGossiped == len(servers) { - return - } - } - } - } + return callbackErr != nil || len(receivedBy) == len(servers) + }, 15*time.Second, 100*time.Millisecond, "Multicast messages not received before timeout") + + receivedMu.Lock() + defer receivedMu.Unlock() + require.NoError(t, callbackErr) + require.Len(t, receivedBy, len(servers), "Expected all servers to receive the gossip message") } func Test_RepeatedClose(t *testing.T) { diff --git a/network/server.go b/network/server.go index 5753a2c..f932b5a 100644 --- a/network/server.go +++ b/network/server.go @@ -677,8 +677,24 @@ func (s *Server) Subscribe(ctx context.Context, handler func(evnt *peerEvent.Pee case <-s.closeCh: return - case evnt := <-sub.Out(): + case evnt, ok := <-sub.Out(): + if !ok { + return + } + + if ctx.Err() != nil { + return + } + if obj, ok := evnt.(peerEvent.PeerEvent); ok { + select { + case <-ctx.Done(): + return + case <-s.closeCh: + return + default: + } + handler(&obj) } } diff --git a/network/server_test.go b/network/server_test.go index fc0e0ae..347c84f 100644 --- a/network/server_test.go +++ b/network/server_test.go @@ -735,7 +735,11 @@ func TestSubscribe(t *testing.T) { }) err := server.Subscribe(ctx, func(e *peerEvent.PeerEvent) { - eventCh <- e + select { + case <-ctx.Done(): + return + case eventCh <- e: + } }) assert.NoError(t, err) @@ -751,7 +755,11 @@ func TestSubscribe(t *testing.T) { t.Helper() select { - case received := <-eventCh: + case received, ok := <-eventCh: + if !ok { + return nil, false + } + return received, true case <-time.After(timeout): return nil, false diff --git a/scripts/Makefile b/scripts/Makefile index 2115985..3105193 100644 --- a/scripts/Makefile +++ b/scripts/Makefile @@ -34,8 +34,7 @@ protoc: check-protoc ./server/proto/*.proto \ ./network/proto/*.proto \ ./txpool/proto/*.proto \ - ./consensus/ibft/**/*.proto \ - ./consensus/polybft/**/*.proto + ./consensus/ibft/**/*.proto .PHONY: build build: check-go check-git @@ -71,39 +70,21 @@ test-e2e: check-go go build -race -o artifacts/xgrchain . env EDGE_BINARY=${PWD}/artifacts/xgrchain go test -v -timeout=30m ./e2e/... -.PHONY: test-e2e-polybft -test-e2e-polybft: check-go - go build -o artifacts/xgrchain . - env EDGE_BINARY=${PWD}/artifacts/xgrchain E2E_TESTS=true E2E_LOGS=true \ - go test -v -timeout=1h30m ./e2e-polybft/e2e/... - -.PHONY: test-property-polybft -test-property-polybft: check-go - go build -o artifacts/xgrchain . - env EDGE_BINARY=${PWD}/artifacts/xgrchain E2E_TESTS=true E2E_LOGS=true go test -v -timeout=30m ./e2e-polybft/property/... \ - -rapid.checks=10 - .PHONY: compile-core-contracts compile-core-contracts: check-npm cd core-contracts && npm install && npm run compile - $(MAKE) generate-smart-contract-bindings - -.PHONY: generate-smart-contract-bindings -generate-smart-contract-bindings: check-go - go run ./consensus/polybft/contractsapi/artifacts-gen/main.go - go run ./consensus/polybft/contractsapi/bindings-gen/main.go .PHONY: run-docker run-docker: - ./scripts/cluster polybft --docker + ./scripts/cluster ibft --docker .PHONY: stop-docker stop-docker: - ./scripts/cluster polybft --docker stop + ./scripts/cluster ibft --docker stop .PHONY: destroy-docker destroy-docker: - ./scripts/cluster polybft --docker destroy + ./scripts/cluster ibft --docker destroy .PHONY: help help: @@ -117,13 +98,10 @@ help: @printf " %-35s - %s\n" "test" "Run unit tests" @printf " %-35s - %s\n" "fuzz-test" "Run fuzz tests" @printf " %-35s - %s\n" "test-e2e" "Run end-to-end tests" - @printf " %-35s - %s\n" "test-e2e-polybft" "Run end-to-end tests for PolyBFT" - @printf " %-35s - %s\n" "test-property-polybft" "Run property tests for PolyBFT" @printf " %-35s - %s\n" "compile-core-contracts" "Compile core contracts" - @printf " %-35s - %s\n" "generate-smart-contract-bindings" "Generate smart contract bindings" - @printf " %-35s - %s\n" "run-docker" "Run Docker cluster for PolyBFT" - @printf " %-35s - %s\n" "stop-docker" "Stop Docker cluster for PolyBFT" - @printf " %-35s - %s\n" "destroy-docker" "Destroy Docker cluster for PolyBFT" + @printf " %-35s - %s\n" "run-docker" "Run Docker cluster for IBFT" + @printf " %-35s - %s\n" "stop-docker" "Stop Docker cluster for IBFT" + @printf " %-35s - %s\n" "destroy-docker" "Destroy Docker cluster for IBFT" # ----------------------------- # XGRCHAIN CUSTOM BUILD & DEPLOY diff --git a/scripts/README.md b/scripts/README.md index ca6b77f..7f3b9a3 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -2,18 +2,15 @@ ## Prerequisites -When deploying with `polybft` consensus, there are some additional dependencies: +For local deployments, ensure the following dependencies are available: * [go 1.20.x](https://go.dev/dl/) -* [jq](https://jqlang.github.io/jq) -* [curl](https://everything.curl.dev/get) ## Local development Running `xgrchain` from local binary can be done very easily by using provided `scripts` folder. * `scripts/cluster ibft` - deploy environment with `ibft` consensus -* `scripts/cluster polybft` - deploy environment with `polybft` consensus ## Customization diff --git a/scripts/cluster b/scripts/cluster old mode 100644 new mode 100755 index 6bfadc7..535f299 --- a/scripts/cluster +++ b/scripts/cluster @@ -1,54 +1,21 @@ #!/usr/bin/env bash -dp_error_flag=0 - -# Check if jq is installed -if [[ "$1" == "polybft" ]] && ! command -v jq >/dev/null 2>&1; then - echo "jq is not installed." - echo "Manual installation instructions: Visit https://jqlang.github.io/jq/ for more information." - dp_error_flag=1 -fi - -# Check if curl is installed -if [[ "$1" == "polybft" ]] && ! command -v curl >/dev/null 2>&1; then - echo "curl is not installed." - echo "Manual installation instructions: Visit https://everything.curl.dev/get/ for more information." - dp_error_flag=1 -fi - -# Check if docker-compose is installed -if [[ "$2" == "--docker" ]] && ! command -v docker-compose >/dev/null 2>&1; then - echo "docker-compose is not installed." - echo "Manual installation instructions: Visit https://docs.docker.com/compose/install/ for more information." - dp_error_flag=1 -fi - -# Stop script if any of the dependencies have failed -if [[ "$dp_error_flag" -eq 1 ]]; then - echo "Missing dependencies. Please install them and run the script again." - exit 1 -fi +set -e function showhelp() { - echo "Usage: cluster {consensus} [{command}] [{flags}]" + echo "Usage: cluster ibft [{command}] [{flags}]" echo "Consensus:" - echo " ibft Start Supernets test environment locally with ibft consensus" - echo " polybft Start Supernets test environment locally with polybft consensus" + echo " ibft Start local test environment with IBFT consensus" echo "Commands:" - echo " stop Stop the running environment" - echo " destroy Destroy the running environment" - echo " write-logs Writes STDOUT and STDERR output to log file. Not applicable when using --docker flag." + echo " stop Stop the running Docker environment" + echo " destroy Destroy the running Docker environment" + echo " write-logs Write validator STDOUT/STDERR to log files (non-Docker mode)" echo "Flags:" echo " --docker Run using Docker (requires docker-compose)." echo " --help Display this help information" - echo "Examples:" - echo " cluster polybft -- Run the script with the polybft consensus" - echo " cluster polybft --docker -- Run the script with the polybft consensus using docker" - echo " cluster polybft stop -- Stop the running environment" } function initIbftConsensus() { - echo "Running with ibft consensus" ./xgrchain secrets init --insecure --data-dir test-chain- --num 4 node1_id=$(./xgrchain secrets output --data-dir test-chain-1 | grep Node | head -n 1 | awk -F ' ' '{print $4}') @@ -59,109 +26,17 @@ function initIbftConsensus() { --bootnode /ip4/127.0.0.1/tcp/30302/p2p/$node2_id" } -function initPolybftConsensus() { - echo "Running with polybft consensus" - genesis_params="--consensus polybft" - - address1=$(./xgrchain polybft-secrets --insecure --data-dir test-chain-1 | grep Public | head -n 1 | awk -F ' ' '{print $5}') - address2=$(./xgrchain polybft-secrets --insecure --data-dir test-chain-2 | grep Public | head -n 1 | awk -F ' ' '{print $5}') - address3=$(./xgrchain polybft-secrets --insecure --data-dir test-chain-3 | grep Public | head -n 1 | awk -F ' ' '{print $5}') - address4=$(./xgrchain polybft-secrets --insecure --data-dir test-chain-4 | grep Public | head -n 1 | awk -F ' ' '{print $5}') -} - function createGenesis() { ./xgrchain genesis $genesis_params \ --block-gas-limit 10000000 \ --premine 0x85da99c8a7c2c95964c8efd687e95e632fc533d6:1000000000000000000000 \ --premine 0x0000000000000000000000000000000000000000 \ - --epoch-size 10 \ - --reward-wallet 0xDEADBEEF:1000000 \ - --native-token-config "XGR:XGR:18:true:$address1" \ - --burn-contract 0:0x0000000000000000000000000000000000000000 \ - --proxy-contracts-admin 0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed -} - -function initRootchain() { - echo "Initializing rootchain" - - if [ "$1" == "write-logs" ]; then - echo "Writing rootchain server logs to the file..." - ./xgrchain rootchain server 2>&1 | tee ./rootchain-server.log & - else - ./xgrchain rootchain server >/dev/null & - fi - - set +e - while true; do - if curl -sSf -o /dev/null http://127.0.0.1:8545; then - break - fi - sleep 1 - done - set -e - - proxyContractsAdmin=0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed - - ./xgrchain polybft stake-manager-deploy \ - --jsonrpc http://127.0.0.1:8545 \ - --proxy-contracts-admin ${proxyContractsAdmin} \ - --test - - stakeManagerAddr=$(cat genesis.json | jq -r '.params.engine.polybft.bridge.stakeManagerAddr') - stakeToken=$(cat genesis.json | jq -r '.params.engine.polybft.bridge.stakeTokenAddr') - - ./xgrchain rootchain deploy \ - --stake-manager ${stakeManagerAddr} \ - --stake-token ${stakeToken} \ - --proxy-contracts-admin ${proxyContractsAdmin} \ - --test - - customSupernetManagerAddr=$(cat genesis.json | jq -r '.params.engine.polybft.bridge.customSupernetManagerAddr') - supernetID=$(cat genesis.json | jq -r '.params.engine.polybft.supernetID') - - ./xgrchain rootchain fund \ - --stake-token ${stakeToken} \ - --mint \ - --addresses ${address1},${address2},${address3},${address4} \ - --amounts 1000000000000000000000000,1000000000000000000000000,1000000000000000000000000,1000000000000000000000000 - - ./xgrchain polybft whitelist-validators \ - --addresses ${address1},${address2},${address3},${address4} \ - --supernet-manager ${customSupernetManagerAddr} \ - --private-key aa75e9a7d427efc732f8e4f1a5b7646adcc61fd5bae40f80d13c8419c9f43d6d \ - --jsonrpc http://127.0.0.1:8545 - - counter=1 - while [ $counter -le 4 ]; do - echo "Registering validator: ${counter}" - - ./xgrchain polybft register-validator \ - --supernet-manager ${customSupernetManagerAddr} \ - --data-dir test-chain-${counter} \ - --jsonrpc http://127.0.0.1:8545 - - ./xgrchain polybft stake \ - --data-dir test-chain-${counter} \ - --amount 1000000000000000000000000 \ - --supernet-id ${supernetID} \ - --stake-manager ${stakeManagerAddr} \ - --stake-token ${stakeToken} \ - --jsonrpc http://127.0.0.1:8545 - - ((counter++)) - done - - ./xgrchain polybft supernet \ - --private-key aa75e9a7d427efc732f8e4f1a5b7646adcc61fd5bae40f80d13c8419c9f43d6d \ - --supernet-manager ${customSupernetManagerAddr} \ - --finalize-genesis-set \ - --enable-staking \ - --jsonrpc http://127.0.0.1:8545 + --epoch-size 10 } function startNodes() { - if [ "$2" == "write-logs" ]; then - echo "Writing validators logs to the files..." + if [ "$1" == "write-logs" ]; then + echo "Writing validators logs to files..." fi for i in {1..4}; do @@ -169,41 +44,25 @@ function startNodes() { grpc_port=$((10000 * $i)) libp2p_port=$((30300 + $i)) jsonrpc_port=$((10000 * $i + 2)) - log_file="./validator-$i.log" - relayer_arg="" - # Start relayer only if running polybft and for the 1st node - if [ "$1" == "polybft" ] && [ $i -eq 1 ]; then - relayer_arg="--relayer" - fi - - if [ "$2" == "write-logs" ]; then - if [ ! -f "$log_file" ]; then - touch "$log_file" - fi - + if [ "$1" == "write-logs" ]; then + touch "$log_file" ./xgrchain server --data-dir "$data_dir" --chain genesis.json \ --grpc-address ":$grpc_port" --libp2p ":$libp2p_port" --jsonrpc ":$jsonrpc_port" \ - --num-block-confirmations 2 $relayer_arg \ - --log-level DEBUG 2>&1 | tee $log_file & + --num-block-confirmations 2 --log-level DEBUG 2>&1 | tee "$log_file" & else ./xgrchain server --data-dir "$data_dir" --chain genesis.json \ --grpc-address ":$grpc_port" --libp2p ":$libp2p_port" --jsonrpc ":$jsonrpc_port" \ - --num-block-confirmations 2 $relayer_arg \ - --log-level DEBUG & + --num-block-confirmations 2 --log-level DEBUG & fi - done wait } function startServerFromDockerCompose() { - if [ "$1" != "polybft" ]; then - export EDGE_CONSENSUS="$1" - fi - + export EDGE_CONSENSUS="ibft" docker-compose -f ./docker/local/docker-compose.yml up -d --build } @@ -215,65 +74,47 @@ function stopDockerEnvironment() { docker-compose -f ./docker/local/docker-compose.yml stop } -set -e - -# Show help if help flag is entered or no arguments are provided if [[ "$1" == "--help" ]] || [[ $# -eq 0 ]]; then showhelp exit 0 fi -# Reset test-dirs +if [ "$1" != "ibft" ]; then + echo "Unsupported consensus mode. Supported mode is: ibft." + showhelp + exit 1 +fi + +if [[ "$2" == "--docker" ]] && ! command -v docker-compose >/dev/null 2>&1; then + echo "docker-compose is not installed." + echo "Manual installation instructions: Visit https://docs.docker.com/compose/install/ for more information." + exit 1 +fi + rm -rf test-chain-* rm -f genesis.json -# Build binary go build -o xgrchain . -# If --docker flag is set run docker environment otherwise run from binary case "$2" in "--docker") - # cluster {consensus} --docker destroy if [ "$3" == "destroy" ]; then destroyDockerEnvironment - echo "Docker $1 environment destroyed!" + echo "Docker environment destroyed!" exit 0 - # cluster {consensus} --docker stop elif [ "$3" == "stop" ]; then stopDockerEnvironment - echo "Docker $1 environment stopped!" + echo "Docker environment stopped!" exit 0 fi - # cluster {consensus} --docker - echo "Running $1 docker environment..." - startServerFromDockerCompose $1 - echo "Docker $1 environment deployed." - exit 0 + echo "Running docker environment..." + startServerFromDockerCompose + echo "Docker environment deployed." ;; -# cluster {consensus} *) - echo "Running $1 environment from local binary..." - # Initialize ibft or polybft consensus - if [ "$1" == "ibft" ]; then - # Initialize ibft consensus - initIbftConsensus - # Create genesis file and start the server from binary - createGenesis - startNodes $1 $2 - exit 0 - elif [ "$1" == "polybft" ]; then - # Initialize polybft consensus - initPolybftConsensus - # Create genesis file and start the server from binary - createGenesis - initRootchain $2 - startNodes $1 $2 - exit 0 - else - echo "Unsupported consensus mode. Supported modes are: ibft and polybft." - showhelp - exit 1 - fi + initIbftConsensus + createGenesis + startNodes "$2" ;; esac diff --git a/scripts/monitor_balances.sh b/scripts/monitor_balances.sh new file mode 100755 index 0000000..0880a3c --- /dev/null +++ b/scripts/monitor_balances.sh @@ -0,0 +1,76 @@ +#!/usr/bin/env bash +set -euo pipefail + +# ----------------------------------------------------------------------------- +# Hardcoded configuration (edit these values directly) +# ----------------------------------------------------------------------------- +RPC_URL="http://127.0.0.1:8545" +OUT_FILE="balance_report.txt" +POOL_ADDR="0x000000000000000000000000000000000000fEE2" + +VALIDATOR_ADDRS=( + "0x1111111111111111111111111111111111111111" + "0x2222222222222222222222222222222222222222" +) +# ----------------------------------------------------------------------------- + +if [ "${#VALIDATOR_ADDRS[@]}" -lt 1 ]; then + echo "Please set at least one address in VALIDATOR_ADDRS at the top of this script." + exit 1 +fi + +rpc_call() { + local method="$1" + local params_json="$2" + curl -sS -X POST "$RPC_URL" \ + -H 'content-type: application/json' \ + --data "{\"jsonrpc\":\"2.0\",\"method\":\"${method}\",\"params\":${params_json},\"id\":1}" +} + +extract_result() { + local payload="$1" + + python3 - "$payload" <<'PY' +import json +import sys + +payload = json.loads(sys.argv[1]) +if payload.get("error") is not None: + raise SystemExit(f"RPC error: {payload['error']}") +result = payload.get("result") +if result is None: + raise SystemExit("RPC response missing result") +print(result) +PY +} + +hex_to_dec() { + local hex_value="$1" + python3 - "$hex_value" <<'PY' +import sys +print(int(sys.argv[1], 16)) +PY +} + +block_hex="$(extract_result "$(rpc_call "eth_blockNumber" '[]')")" +block_dec="$(hex_to_dec "$block_hex")" + +{ + printf "\n==== %s | block=%s ====" "$(date -u +"%Y-%m-%dT%H:%M:%SZ")" "$block_dec" + printf "\n%-12s | %-44s | %-20s | %-10s\n" "ENTITY" "ADDRESS" "BALANCE_WEI" "BALANCE_HEX" + printf -- "%.12s-+-%.44s-+-%.20s-+-%.10s\n" "------------" "--------------------------------------------" "--------------------" "----------" + + pool_hex="$(extract_result "$(rpc_call "eth_getBalance" "[\"$POOL_ADDR\",\"latest\"]")")" + pool_dec="$(hex_to_dec "$pool_hex")" + printf "%-12s | %-44s | %-20s | %-10s\n" "POOL" "$POOL_ADDR" "$pool_dec" "$pool_hex" + + idx=1 + for validator in "${VALIDATOR_ADDRS[@]}"; do + bal_hex="$(extract_result "$(rpc_call "eth_getBalance" "[\"$validator\",\"latest\"]")")" + bal_dec="$(hex_to_dec "$bal_hex")" + printf "%-12s | %-44s | %-20s | %-10s\n" "VALIDATOR_$idx" "$validator" "$bal_dec" "$bal_hex" + idx=$((idx + 1)) + done +} >> "$OUT_FILE" + +echo "Appended balances to: $OUT_FILE" diff --git a/server/builtin.go b/server/builtin.go index e4bdcb3..f16a483 100644 --- a/server/builtin.go +++ b/server/builtin.go @@ -6,7 +6,6 @@ import ( consensusDev "github.com/xgr-network/xgr-node/consensus/dev" consensusDummy "github.com/xgr-network/xgr-node/consensus/dummy" consensusIBFT "github.com/xgr-network/xgr-node/consensus/ibft" - consensusPolyBFT "github.com/xgr-network/xgr-node/consensus/polybft" "github.com/xgr-network/xgr-node/forkmanager" "github.com/xgr-network/xgr-node/secrets" "github.com/xgr-network/xgr-node/secrets/awsssm" @@ -25,17 +24,15 @@ type ForkManagerFactory func(forks *chain.Forks) error type ForkManagerInitialParamsFactory func(config *chain.Chain) (*forkmanager.ForkParams, error) const ( - DevConsensus ConsensusType = "dev" - IBFTConsensus ConsensusType = "ibft" - PolyBFTConsensus ConsensusType = consensusPolyBFT.ConsensusName - DummyConsensus ConsensusType = "dummy" + DevConsensus ConsensusType = "dev" + IBFTConsensus ConsensusType = "ibft" + DummyConsensus ConsensusType = "dummy" ) var consensusBackends = map[ConsensusType]consensus.Factory{ - DevConsensus: consensusDev.Factory, - IBFTConsensus: consensusIBFT.Factory, - PolyBFTConsensus: consensusPolyBFT.Factory, - DummyConsensus: consensusDummy.Factory, + DevConsensus: consensusDev.Factory, + IBFTConsensus: consensusIBFT.Factory, + DummyConsensus: consensusDummy.Factory, } // secretsManagerBackends defines the SecretManager factories for different @@ -47,17 +44,11 @@ var secretsManagerBackends = map[secrets.SecretsManagerType]secrets.SecretsManag secrets.GCPSSM: gcpssm.SecretsManagerFactory, } -var genesisCreationFactory = map[ConsensusType]GenesisFactoryHook{ - PolyBFTConsensus: consensusPolyBFT.GenesisPostHookFactory, -} +var genesisCreationFactory = map[ConsensusType]GenesisFactoryHook{} -var forkManagerFactory = map[ConsensusType]ForkManagerFactory{ - PolyBFTConsensus: consensusPolyBFT.ForkManagerFactory, -} +var forkManagerFactory = map[ConsensusType]ForkManagerFactory{} -var forkManagerInitialParamsFactory = map[ConsensusType]ForkManagerInitialParamsFactory{ - PolyBFTConsensus: consensusPolyBFT.ForkManagerInitialParamsFactory, -} +var forkManagerInitialParamsFactory = map[ConsensusType]ForkManagerInitialParamsFactory{} func ConsensusSupported(value string) bool { _, ok := consensusBackends[ConsensusType(value)] diff --git a/server/server.go b/server/server.go index d733ecf..be496d4 100644 --- a/server/server.go +++ b/server/server.go @@ -15,7 +15,6 @@ import ( "github.com/xgr-network/xgr-node/blockchain/storage" "github.com/xgr-network/xgr-node/blockchain/storage/leveldb" "github.com/xgr-network/xgr-node/blockchain/storage/memory" - consensusPolyBFT "github.com/xgr-network/xgr-node/consensus/polybft" "github.com/xgr-network/xgr-node/forkmanager" "github.com/xgr-network/xgr-node/gasprice" @@ -252,28 +251,6 @@ func NewServer(config *Config) (*Server, error) { var initialStateRoot = types.ZeroHash - if ConsensusType(engineName) == PolyBFTConsensus { - polyBFTConfig, err := consensusPolyBFT.GetPolyBFTConfig(config.Chain) - if err != nil { - return nil, err - } - - if polyBFTConfig.InitialTrieRoot != types.ZeroHash { - checkedInitialTrieRoot, err := itrie.HashChecker(polyBFTConfig.InitialTrieRoot.Bytes(), stateStorage) - if err != nil { - return nil, fmt.Errorf("error on state root verification %w", err) - } - - if checkedInitialTrieRoot != polyBFTConfig.InitialTrieRoot { - return nil, errors.New("invalid initial state root") - } - - logger.Info("Initial state root checked and correct") - - initialStateRoot = polyBFTConfig.InitialTrieRoot - } - } - genesisRoot, err := m.executor.WriteGenesis(config.Chain.Genesis.Alloc, initialStateRoot) if err != nil { return nil, err @@ -653,6 +630,14 @@ func (j *jsonRPCHub) GetForksInTime(blockNumber uint64) chain.ForksInTime { return j.Executor.GetForksInTime(blockNumber) } +func (j *jsonRPCHub) GetChainParams() *chain.Params { + if j.Blockchain == nil { + return nil + } + + return j.Blockchain.Config() +} + func (j *jsonRPCHub) GetStorage(stateRoot types.Hash, addr types.Address, slot types.Hash) ([]byte, error) { account, err := getAccountImpl(j.state, stateRoot, addr) if err != nil { diff --git a/state/executor.go b/state/executor.go index e9f601b..c4eafd1 100644 --- a/state/executor.go +++ b/state/executor.go @@ -26,6 +26,10 @@ import ( var SystemAddress = types.StringToAddress("0x0000000000000000000000000000000000009999") +// FeePoolAddress collects the pooled validator share and is distributed epoch-wise by IBFT-PoS. +// Consensus-critical: only used when the FeePoolSplit fork is active. +var FeePoolAddress = types.StringToAddress("0x000000000000000000000000000000000000fEE2") + func Keccak256Hash(data []byte) [32]byte { hash := sha3.NewLegacyKeccak256() hash.Write(data) @@ -37,7 +41,7 @@ func Keccak256Hash(data []byte) [32]byte { func HexToAddress(hexStr string) [20]byte { var addr [20]byte - // "0x" entfernen + // Remove the "0x" prefix. clean := strings.TrimPrefix(hexStr, "0x") data, err := hex.DecodeString(clean) if err != nil { @@ -48,7 +52,7 @@ func HexToAddress(hexStr string) [20]byte { return addr } -// LeftPadBytes fΓΌllt ein Byte-Slice links mit 0 auf die angegebene LΓ€nge auf +// LeftPadBytes left-pads a byte slice with zeros to the specified length. func LeftPadBytes(input []byte, length int) []byte { if len(input) >= length { return input @@ -187,6 +191,13 @@ func (e *Executor) ProcessBlock( } for _, t := range block.Transactions { + if types.IsEpochFinalizationSystemTxForBlock(t, block.Header.Number, contracts.SystemCaller) { + // The deterministic native PoS epoch-finalization system transaction is + // represented by logs emitted in the consensus PreCommitState hook and + // materialized with WriteSystemReceipt after FinalizeEpoch completes. + continue + } + if t.Gas > block.Header.GasLimit { continue } @@ -257,11 +268,13 @@ func (e *Executor) BeginTxn( config: forkConfig, gasPool: uint64(txCtx.GasLimit), - receipts: []*types.Receipt{}, - totalGas: 0, - donationFee: nil, - validatorFee: nil, - burnedFee: nil, + receipts: []*types.Receipt{}, + totalGas: 0, + donationFee: nil, + validatorFee: nil, + validatorImmediateFee: nil, + validatorPooledFee: nil, + burnedFee: nil, evm: evm.NewEVM(), precompiles: precompiled.NewPrecompiled(), @@ -312,12 +325,14 @@ type Transition struct { gasPool uint64 // result - receipts []*types.Receipt - totalGas uint64 - donationFee *big.Int - validatorFee *big.Int - burnedFee *big.Int - PostHook func(t *Transition) + receipts []*types.Receipt + totalGas uint64 + donationFee *big.Int + validatorFee *big.Int + validatorImmediateFee *big.Int + validatorPooledFee *big.Int + burnedFee *big.Int + PostHook func(t *Transition) // runtimes evm *evm.EVM @@ -382,6 +397,30 @@ func (t *Transition) Receipts() []*types.Receipt { var emptyFrom = types.Address{} +var ( + feeLogAddress = HexToAddress("0x000000000000000000000000000000000000fEE1") + xgrFeeSplitTopic = Keccak256Hash([]byte("XGRFeeSplit(uint256,uint256,uint256)")) + xgrFeeAccountingTopic = Keccak256Hash([]byte("XGRFeeAccounting(uint256,uint256,uint256,uint256)")) + xgrFeeAccountingZeroPooled = big.NewInt(0) +) + +func feeAmountBytes(amount *big.Int) []byte { + if amount == nil { + return LeftPadBytes(nil, 32) + } + + return LeftPadBytes(amount.Bytes(), 32) +} + +func encodeFeeLogData(amounts ...*big.Int) []byte { + data := make([]byte, 0, len(amounts)*32) + for _, amount := range amounts { + data = append(data, feeAmountBytes(amount)...) + } + + return data +} + // Write writes another transaction to the executor func (t *Transition) Write(txn *types.Transaction) error { var err error @@ -408,29 +447,29 @@ func (t *Transition) Write(txn *types.Transaction) error { t.totalGas += result.GasUsed - topics := []types.Hash{ - Keccak256Hash([]byte("XGRFeeSplit(uint256,uint256,uint256)")), - } - - data := append( - LeftPadBytes(t.donationFee.Bytes(), 32), - append( - LeftPadBytes(t.validatorFee.Bytes(), 32), - LeftPadBytes(t.burnedFee.Bytes(), 32)..., - )..., - ) - - myLog := &types.Log{ - Address: HexToAddress("0x000000000000000000000000000000000000fEE1"), - Topics: topics, - Data: data, + logs := t.state.Logs() + logs = append(logs, &types.Log{ + Address: feeLogAddress, + Topics: []types.Hash{xgrFeeSplitTopic}, + Data: encodeFeeLogData(t.donationFee, t.validatorFee, t.burnedFee), BlockNumber: uint64(t.ctx.Number), TxHash: txn.Hash, + }) + if t.config.FeePoolSplit { + logs = append(logs, &types.Log{ + Address: feeLogAddress, + Topics: []types.Hash{xgrFeeAccountingTopic}, + Data: encodeFeeLogData( + t.donationFee, + t.validatorImmediateFee, + t.validatorPooledFee, + t.burnedFee, + ), + BlockNumber: uint64(t.ctx.Number), + TxHash: txn.Hash, + }) } - logs := t.state.Logs() - logs = append(logs, myLog) - receipt := &types.Receipt{ CumulativeGasUsed: t.totalGas, TransactionType: txn.Type, @@ -462,6 +501,36 @@ func (t *Transition) Write(txn *types.Transaction) error { return nil } +// WriteSystemReceipt materializes logs emitted outside normal transaction +// execution (for example consensus-owned PoS epoch finalization logs) into a +// deterministic receipt for a native system transaction. The transaction is not +// executed here; it supplies the transaction hash and type used by RPC and +// receipt roots. +func (t *Transition) WriteSystemReceipt(txn *types.Transaction) error { + if txn == nil { + return fmt.Errorf("missing system transaction") + } + + logs := t.state.Logs() + for _, log := range logs { + log.BlockNumber = uint64(t.ctx.Number) + log.TxHash = txn.Hash + } + + receipt := &types.Receipt{ + CumulativeGasUsed: t.totalGas, + TransactionType: txn.Type, + TxHash: txn.Hash, + GasUsed: 0, + Logs: logs, + } + receipt.SetStatus(types.ReceiptSuccess) + receipt.LogsBloom = types.CreateBloom([]*types.Receipt{receipt}) + t.receipts = append(t.receipts, receipt) + + return nil +} + // Commit commits the final result func (t *Transition) Commit() (Snapshot, types.Hash, error) { objs, err := t.state.Commit(t.config.EIP155) @@ -495,6 +564,60 @@ func (t *Transition) Txn() *Txn { return t.state } +func (t *Transition) ForksInTime() chain.ForksInTime { + return t.config +} + +func cloneBig(x *big.Int) *big.Int { + if x == nil { + return nil + } + return new(big.Int).Set(x) +} + +// Call executes a transaction in "simulation" mode and ALWAYS reverts state changes. +// Intended for eth_call / estimateGas / internal view queries. +func (t *Transition) Call(msg *types.Transaction) (*runtime.ExecutionResult, error) { + // Snapshot world state + s := t.state.Snapshot() + + // Snapshot transition-local mutable fields (apply() mutates these) + prevCtx := t.ctx + prevGasPool := t.gasPool + prevReceipts := t.receipts + prevTotalGas := t.totalGas + prevDonation := cloneBig(t.donationFee) + prevValidator := cloneBig(t.validatorFee) + prevValidatorImmediate := cloneBig(t.validatorImmediateFee) + prevValidatorPooled := cloneBig(t.validatorPooledFee) + prevBurned := cloneBig(t.burnedFee) + prevPostHook := t.PostHook + + // PostHook must not run for simulation calls + t.PostHook = nil + + res, err := t.apply(msg) + + // Always revert world state changes, regardless of success/failure + if revertErr := t.state.RevertToSnapshot(s); revertErr != nil { + return nil, revertErr + } + + // Restore transition-local bookkeeping + t.ctx = prevCtx + t.gasPool = prevGasPool + t.receipts = prevReceipts + t.totalGas = prevTotalGas + t.donationFee = prevDonation + t.validatorFee = prevValidator + t.validatorImmediateFee = prevValidatorImmediate + t.validatorPooledFee = prevValidatorPooled + t.burnedFee = prevBurned + t.PostHook = prevPostHook + + return res, err +} + // Apply applies a new transaction func (t *Transition) Apply(msg *types.Transaction) (*runtime.ExecutionResult, error) { s := t.state.Snapshot() @@ -686,8 +809,10 @@ func (t *Transition) apply(msg *types.Transaction) (*runtime.ExecutionResult, er if msg.IsContractCreation() { result = t.Create2(msg.From, msg.Input, value, gasLeft) } else { - if err := t.state.IncrNonce(msg.From); err != nil { - return nil, err + if !t.ctx.NonPayable { + if err := t.state.IncrNonce(msg.From); err != nil { + return nil, err + } } result = t.Call2(msg.From, *msg.To, msg.Input, value, gasLeft) } @@ -699,82 +824,106 @@ func (t *Transition) apply(msg *types.Transaction) (*runtime.ExecutionResult, er t.ctx.Tracer.TxEnd(result.GasLeft) } - // Refund the sender - remaining := new(big.Int).Mul(new(big.Int).SetUint64(result.GasLeft), gasPrice) - t.state.AddBalance(msg.From, remaining) - - // Berechne gesamte Fee = gasUsed Γ— gasPrice - totalFeeRaw := new(big.Int).Mul(new(big.Int).SetUint64(result.GasUsed), gasPrice) + if !t.ctx.NonPayable { + // Refund the sender + remaining := new(big.Int).Mul(new(big.Int).SetUint64(result.GasLeft), gasPrice) + t.state.AddBalance(msg.From, remaining) + + // Compute total fee = gasUsed Γ— gasPrice + totalFeeRaw := new(big.Int).Mul(new(big.Int).SetUint64(result.GasUsed), gasPrice) + + // Subtract the fixed burn amount (clamped; never create negative fees). + burned := big.NewInt(0).Mul(big.NewInt(1000), big.NewInt(1_000_000_000)) + burnedApplied := new(big.Int).Set(burned) + totalFee := new(big.Int).Set(totalFeeRaw) + if totalFee.Cmp(burnedApplied) <= 0 { + // Fee is below fixed burn -> everything goes to burn, remainder = 0. + burnedApplied.Set(totalFee) + totalFee.SetInt64(0) + } else { + totalFee.Sub(totalFee, burnedApplied) + } - // ziehe Burning Betrag ab (clamped; niemals negative Fees erzeugen) - burned := big.NewInt(0).Mul(big.NewInt(1000), big.NewInt(1_000_000_000)) - burnedApplied := new(big.Int).Set(burned) - totalFee := new(big.Int).Set(totalFeeRaw) - if totalFee.Cmp(burnedApplied) <= 0 { - // Fee reicht nicht fΓΌr den fixen Burn -> alles geht an Burn, Rest = 0 - burnedApplied.Set(totalFee) - totalFee.SetInt64(0) - } else { - totalFee.Sub(totalFee, burnedApplied) - } - - // Lade optionale Konfigurationen aus dem State - burnedAddr := chain.DefaultBurnedAddress - donationAddr := chain.DefaultDonationAddress - donationPercent := chain.DefaultDonationPercent - - // Donation config analog minBaseFee: read from EngineRegistry storage slots (if deployed). - // If registry is missing (address==0 or code-size==0), keep DefaultDonation*. - if chain.EngineRegistryAddress != (types.Address{}) { - if code := t.state.GetCode(chain.EngineRegistryAddress); len(code) > 0 { - // donationAddress: address is right-aligned in last 20 bytes of the slot - addrSlot := t.state.GetState(chain.EngineRegistryAddress, chain.EngineRegistrySlotKeyDonationAddress()) - var regAddr types.Address - copy(regAddr[:], addrSlot[12:32]) - // donationPercent: uint256 (accept 0..100) - pctSlot := t.state.GetState(chain.EngineRegistryAddress, chain.EngineRegistrySlotKeyDonationPercent()) - pct := new(big.Int).SetBytes(pctSlot[:]) - if pct.Sign() >= 0 && pct.BitLen() <= 64 { - p := pct.Uint64() - if p <= 100 { - donationPercent = p + // Load optional configuration values from state. + burnedAddr := chain.DefaultBurnedAddress + donationAddr := chain.DefaultDonationAddress + donationPercent := chain.DefaultDonationPercent + + // Donation config analog minBaseFee: read from EngineRegistry storage slots (if deployed). + // If registry is missing (address==0 or code-size==0), keep DefaultDonation*. + if chain.EngineRegistryAddress != (types.Address{}) { + if code := t.state.GetCode(chain.EngineRegistryAddress); len(code) > 0 { + // donationAddress: address is right-aligned in last 20 bytes of the slot + addrSlot := t.state.GetState(chain.EngineRegistryAddress, chain.EngineRegistrySlotKeyDonationAddress()) + var regAddr types.Address + copy(regAddr[:], addrSlot[12:32]) + // donationPercent: uint256 (accept 0..100) + pctSlot := t.state.GetState(chain.EngineRegistryAddress, chain.EngineRegistrySlotKeyDonationPercent()) + pct := new(big.Int).SetBytes(pctSlot[:]) + if pct.Sign() >= 0 && pct.BitLen() <= 64 { + p := pct.Uint64() + if p <= 100 { + donationPercent = p + } + } + // Safety: if address is zero => donation disabled + if regAddr == types.ZeroAddress { + donationPercent = 0 + } else { + donationAddr = regAddr } } - // Safety: if address is zero => donation disabled - if regAddr == types.ZeroAddress { - donationPercent = 0 + } + + // Compute split: donation + validator + donation := new(big.Int).Mul(totalFee, new(big.Int).SetUint64(donationPercent)) + donation.Div(donation, big.NewInt(100)) + if donation.Sign() < 0 { + donation.SetInt64(0) + } + if donation.Cmp(totalFee) > 0 { + donation.Set(totalFee) + } + validator := new(big.Int).Sub(totalFee, donation) + if validator.Sign() < 0 { + validator.SetInt64(0) + } + // Distribute fee + if donation.Sign() > 0 { + t.state.AddBalance(donationAddr, donation) + } + validatorImmediate := new(big.Int) + validatorPooled := new(big.Int) + if validator.Sign() > 0 { + if t.config.FeePoolSplit { + // forked PoS behavior + validatorImmediate.Rsh(new(big.Int).Set(validator), 1) + validatorPooled.Sub(validator, validatorImmediate) + + if validatorImmediate.Sign() > 0 { + t.state.AddBalance(t.ctx.Coinbase, validatorImmediate) + } + if validatorPooled.Sign() > 0 { + t.state.AddBalance(FeePoolAddress, validatorPooled) + } } else { - donationAddr = regAddr + // legacy PoA / xgr-node behavior + validatorImmediate.Set(validator) + t.state.AddBalance(t.ctx.Coinbase, validator) } } + if !t.config.FeePoolSplit { + validatorPooled.Set(xgrFeeAccountingZeroPooled) + } + if burnedApplied.Sign() > 0 { + t.state.AddBalance(burnedAddr, burnedApplied) + } + t.donationFee = donation + t.validatorFee = validator + t.validatorImmediateFee = validatorImmediate + t.validatorPooledFee = validatorPooled + t.burnedFee = burnedApplied } - - // Berechne Aufteilung: Donation + Validator - donation := new(big.Int).Mul(totalFee, new(big.Int).SetUint64(donationPercent)) - donation.Div(donation, big.NewInt(100)) - if donation.Sign() < 0 { - donation.SetInt64(0) - } - if donation.Cmp(totalFee) > 0 { - donation.Set(totalFee) - } - validator := new(big.Int).Sub(totalFee, donation) - if validator.Sign() < 0 { - validator.SetInt64(0) - } - // Verteile Fee - if donation.Sign() > 0 { - t.state.AddBalance(donationAddr, donation) - } - if validator.Sign() > 0 { - t.state.AddBalance(t.ctx.Coinbase, validator) - } - if burnedApplied.Sign() > 0 { - t.state.AddBalance(burnedAddr, burnedApplied) - } - t.donationFee = donation - t.validatorFee = validator - t.burnedFee = burnedApplied // return gas to the pool t.addGasPool(result.GasLeft) return result, nil @@ -1358,7 +1507,12 @@ func checkAndProcessTx(msg *types.Transaction, t *Transition) error { // GasPrice is mandatory for LegacyTx + AccessListTx (and any other non-1559 tx). // This avoids panics in GetGasPrice()/Cost() paths and rejects invalid blocks. if msg.Type != types.DynamicFeeTx && msg.Type != types.StateTx && msg.GasPrice == nil { - return NewTransitionApplicationError(ErrGasPriceNotSet, true) + // eth_call / estimateGas: allow missing gasPrice + if t.ctx.NonPayable { + msg.GasPrice = big.NewInt(0) + } else { + return NewTransitionApplicationError(ErrGasPriceNotSet, true) + } } // EIP-3860 (Shanghai): contract-creation *transactions* with oversized initcode are invalid // and must be rejected by consensus before execution. @@ -1366,12 +1520,12 @@ func checkAndProcessTx(msg *types.Transaction, t *Transition) error { if t.config.EIP3860 && msg.IsContractCreation() && len(msg.Input) > TxPoolMaxInitCodeSize { return NewTransitionApplicationError(ErrMaxInitCodeSizeExceeded, true) } - // 1. the nonce of the message caller is correct - if err := t.nonceCheck(msg); err != nil { - return NewTransitionApplicationError(err, true) - } if !t.ctx.NonPayable { + // 1. nonce check is only for real tx admission, not eth_call / estimateGas + if err := t.nonceCheck(msg); err != nil { + return NewTransitionApplicationError(err, true) + } // 2. check dynamic fees of the transaction if err := t.checkDynamicFees(msg); err != nil { return NewTransitionApplicationError(err, true) diff --git a/state/executor_test.go b/state/executor_test.go index c15686a..324d596 100644 --- a/state/executor_test.go +++ b/state/executor_test.go @@ -157,3 +157,114 @@ func Test_Transition_checkDynamicFees(t *testing.T) { }) } } + +func TestTransitionWriteEmitsXGRFeeAccounting(t *testing.T) { + t.Parallel() + + feeLogDataWord := func(t *testing.T, data []byte, index int) *big.Int { + t.Helper() + require.GreaterOrEqual(t, len(data), (index+1)*32) + + return new(big.Int).SetBytes(data[index*32 : (index+1)*32]) + } + + getLog := func(receipt *types.Receipt, topic types.Hash) *types.Log { + for _, log := range receipt.Logs { + if len(log.Topics) > 0 && log.Topics[0] == topic { + return log + } + } + + return nil + } + + findLog := func(t *testing.T, receipt *types.Receipt, topic types.Hash) *types.Log { + t.Helper() + + log := getLog(receipt, topic) + require.NotNilf(t, log, "missing log topic %s", topic) + + return log + } + + newFeeAccountingTransition := func(t *testing.T, feePoolSplit bool) (*Transition, *types.Transaction) { + t.Helper() + + snap := newStateWithPreState(map[types.Address]*PreState{ + addr1: {Balance: 1_000_000_000_000_000_000}, + addr2: {}, + }) + txn := newTxn(snap) + transition := NewTransition(chain.ForksInTime{FeePoolSplit: feePoolSplit}, snap, txn) + transition.ctx = runtime.TxContext{ + BaseFee: big.NewInt(0), + Coinbase: types.StringToAddress("0x0000000000000000000000000000000000000abc"), + Number: 7, + } + transition.gasPool = 100_000 + + return transition, &types.Transaction{ + From: addr1, + To: &addr2, + Gas: 50_000, + GasPrice: big.NewInt(1_000_000_000), + Value: big.NewInt(0), + } + } + + t.Run("pre-PoS fee split does not emit accounting log", func(t *testing.T) { + t.Parallel() + + transition, txn := newFeeAccountingTransition(t, false) + require.NoError(t, transition.Write(txn)) + require.Len(t, transition.Receipts(), 1) + + receipt := transition.Receipts()[0] + feeSplit := findLog(t, receipt, xgrFeeSplitTopic) + require.Nil(t, getLog(receipt, xgrFeeAccountingTopic)) + + require.Len(t, feeSplit.Data, 96) + + donation := feeLogDataWord(t, feeSplit.Data, 0) + validator := feeLogDataWord(t, feeSplit.Data, 1) + burned := feeLogDataWord(t, feeSplit.Data, 2) + + accounted := new(big.Int).Add(donation, validator) + accounted.Add(accounted, burned) + expectedTotal := new(big.Int).Mul(new(big.Int).SetUint64(receipt.GasUsed), txn.GasPrice) + require.Equal(t, 0, expectedTotal.Cmp(accounted)) + }) + + t.Run("PoS fee pool split accounting includes immediate and pooled validator shares", func(t *testing.T) { + t.Parallel() + + transition, txn := newFeeAccountingTransition(t, true) + require.NoError(t, transition.Write(txn)) + require.Len(t, transition.Receipts(), 1) + + receipt := transition.Receipts()[0] + feeSplit := findLog(t, receipt, xgrFeeSplitTopic) + feeAccounting := findLog(t, receipt, xgrFeeAccountingTopic) + + require.Len(t, feeSplit.Data, 96) + require.Len(t, feeAccounting.Data, 128) + + donation := feeLogDataWord(t, feeAccounting.Data, 0) + validatorImmediate := feeLogDataWord(t, feeAccounting.Data, 1) + validatorPooled := feeLogDataWord(t, feeAccounting.Data, 2) + burned := feeLogDataWord(t, feeAccounting.Data, 3) + validatorAggregate := feeLogDataWord(t, feeSplit.Data, 1) + + require.Positive(t, validatorImmediate.Sign()) + require.Positive(t, validatorPooled.Sign()) + + validatorTotal := new(big.Int).Add(validatorImmediate, validatorPooled) + require.Equal(t, 0, validatorAggregate.Cmp(validatorTotal)) + + accounted := new(big.Int).Add(donation, validatorImmediate) + accounted.Add(accounted, validatorPooled) + accounted.Add(accounted, burned) + expectedTotal := new(big.Int).Mul(new(big.Int).SetUint64(receipt.GasUsed), txn.GasPrice) + require.Equal(t, 0, expectedTotal.Cmp(accounted)) + }) +} diff --git a/state/runtime/precompiled/bls_agg_sigs_verification.go b/state/runtime/precompiled/bls_agg_sigs_verification.go index 84de26b..7a01bf3 100644 --- a/state/runtime/precompiled/bls_agg_sigs_verification.go +++ b/state/runtime/precompiled/bls_agg_sigs_verification.go @@ -6,11 +6,12 @@ import ( "github.com/umbracle/ethgo/abi" "github.com/xgr-network/xgr-node/bls" "github.com/xgr-network/xgr-node/chain" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" "github.com/xgr-network/xgr-node/state/runtime" "github.com/xgr-network/xgr-node/types" ) +var domainStateReceiver = []byte("DOMAIN_STATE_RECEIVER") + var ( errBLSVerifyAggSignsInputs = errors.New("invalid input") errBLSVerifyAggSignsInputsLen = errors.New("invalid input length") @@ -100,7 +101,7 @@ func (c *blsAggSignsVerification) run(input []byte, caller types.Address, host r blsPubKeys[i] = blsPubKey } - if sig.VerifyAggregated(blsPubKeys, types.Hash(msg).Bytes(), signer.DomainStateReceiver) { + if sig.VerifyAggregated(blsPubKeys, types.Hash(msg).Bytes(), domainStateReceiver) { return abiBoolTrue, nil } diff --git a/state/runtime/precompiled/bls_agg_sigs_verification_test.go b/state/runtime/precompiled/bls_agg_sigs_verification_test.go index b390ebc..88b3a7e 100644 --- a/state/runtime/precompiled/bls_agg_sigs_verification_test.go +++ b/state/runtime/precompiled/bls_agg_sigs_verification_test.go @@ -7,7 +7,6 @@ import ( "github.com/stretchr/testify/require" "github.com/umbracle/ethgo/abi" "github.com/xgr-network/xgr-node/bls" - "github.com/xgr-network/xgr-node/consensus/polybft/signer" "github.com/xgr-network/xgr-node/types" ) @@ -68,7 +67,7 @@ func generatePubKeysAndSignature(t *testing.T, numKeys int, messageRaw []byte) ( signatures := make(bls.Signatures, len(validators)) for i, validator := range validators { - sign, err := validator.Sign(message[:], signer.DomainStateReceiver) + sign, err := validator.Sign(message[:], domainStateReceiver) require.NoError(t, err) pubKeys[i] = validator.PublicKey().Marshal() diff --git a/state/runtime/precompiled/engine_execute.go b/state/runtime/precompiled/engine_execute.go index 7aead70..dd54538 100644 --- a/state/runtime/precompiled/engine_execute.go +++ b/state/runtime/precompiled/engine_execute.go @@ -99,7 +99,7 @@ func pidUsed(host runtime.Host, user ethgo.Address, pid *big.Int) bool { return pid.Cmp(next) < 0 } -// Kein fixes Overhead mehr +// No fixed overhead anymore const engineOverheadGas = uint64(0) var engineMetaEvent = ethabi.MustNewABI(engineabi.EngineMetaEventABI).Events["EngineMeta"] @@ -146,17 +146,17 @@ type inMeta struct { Extras []byte } -// ---------- Gas-/Fee-Accounting (Single Source of Truth) ------------------- +// ---------- Gas/Fee accounting (single source of truth) ------------------- // -// WICHTIG: -// - Precompile.gas() rechnet NUR Precompile-Kosten (ohne TX-Base 21k und ohne calldata-cost). -// - Settlement/Preflight rechnet TX-Base + calldata-cost zusΓ€tzlich, weil der Engine-EOA diese bezahlt. +// IMPORTANT: +// - Precompile.gas() accounts only for precompile costs (without TX base 21k and without calldata cost). +// - Settlement/Preflight additionally account for TX base + calldata cost because the engine EOA pays them. // -// Bausteine: -// - validationGas: deterministisch (explizit ΓΌbergeben) -// - Logs: deterministisch ΓΌber calcEngineMetaLen / calcEngineExtrasLen -// - CALL-Overhead: deterministisch aus len(call.Data) -// - execLimit: deterministisch (explizit ΓΌbergeben) +// Components: +// - validationGas: deterministic (explicitly passed in) +// - Logs: deterministic via calcEngineMetaLen / calcEngineExtrasLen +// - CALL overhead: deterministic from len(call.Data) +// - execLimit: deterministic (explicitly passed in) func calldataCostUnits(b []byte) uint64 { var c uint64 @@ -211,23 +211,34 @@ func (f feeCalc) logUnits() uint64 { return logCostUnits(1, f.metaLen) + logCostUnits(1, f.extrasLen) } -// Precompile-Gas (ohne TX-Base + calldata) +// Precompile gas (without TX base + calldata) func (f feeCalc) precompileGasUnits() uint64 { return f.validationGas + f.logUnits() + f.callOverhead + f.execLimit + engineOverheadGas } -// EVM-TX Units (TX-Base + calldata + Events + CALL-Overhead + execLimit), ohne validationGas +// EVM TX units (TX base + calldata + events + CALL overhead + execLimit), without validationGas func (f feeCalc) evmTxUnits() uint64 { return 21_000 + f.calldata + f.logUnits() + f.callOverhead + f.execLimit + engineOverheadGas } -// Gesamt fΓΌr Abrechnung/Receipt-Summe (EVM + Validation) +// Total for billing/receipt sum (EVM + validation) func (f feeCalc) totalTxUnits() uint64 { return f.evmTxUnits() + f.validationGas } -func (e *engineExecute) gas(input []byte, _ *chain.ForksInTime) uint64 { - // Minimum (User-Wunsch): niemals 0 zurΓΌckgeben fΓΌr ENGINE_EXECUTE, auch wenn Decode fehlschlΓ€gt. +func precompileGasUnitsForFork(fc feeCalc, forks *chain.ForksInTime) uint64 { + // With PoS/FeePoolSplit, validationGas is no longer forwarded to the EVM. + // Validation is instead settled directly in the precompile between sender and + // engine EOA. + if forks != nil && forks.FeePoolSplit { + return fc.logUnits() + fc.callOverhead + fc.execLimit + engineOverheadGas + } + + return fc.precompileGasUnits() +} + +func (e *engineExecute) gas(input []byte, forks *chain.ForksInTime) uint64 { + // Minimum (user requirement): never return 0 for ENGINE_EXECUTE, even if decode fails. const minMalformedExecuteGas = uint64(21_000) if len(input) < 4 { return 0 @@ -261,7 +272,7 @@ func (e *engineExecute) gas(input []byte, _ *chain.ForksInTime) uint64 { meta := decodeMeta(metaMap) fc := calcFee(input, grant, call, meta) - return fc.precompileGasUnits() + return precompileGasUnitsForFork(fc, forks) } func (e *engineExecute) run(input []byte, caller types.Address, host runtime.Host) ([]byte, error) { @@ -324,21 +335,21 @@ func (e *engineExecute) run(input []byte, caller types.Address, host runtime.Hos return nil, runtime.ErrInvalidInputData } - // --- Monotone Guard (einziger Wahrheitsanker: kNext) -------------------- - // Regeln: - // - Neuer Root : sessionId == kNext + // --- Monotonic guard (single source of truth: kNext) -------------------- + // Rules: + // - New root : sessionId == kNext // - Follow-up : sessionId < kNext // - Reject : sessionId > kNext curNext := sloadU256(host, kNext(grant.From)) if curNext == nil || curNext.Sign() == 0 { - curNext = big.NewInt(1) // erste Session ΓΌberhaupt + curNext = big.NewInt(1) // first session overall } switch grant.SessionId.Cmp(curNext) { case 1: - // versucht zu springen (grâßer als kNext) + // attempted jump (greater than kNext) return nil, runtime.ErrInvalidInputData case 0: - // neuer Root -> nach den SicherheitsprΓΌfungen wird kNext erhΓΆht + // new root -> kNext is increased after security checks default: // follow-up (< curNext) -> ok } @@ -355,43 +366,43 @@ func (e *engineExecute) run(input []byte, caller types.Address, host runtime.Hos return nil, runtime.ErrUnauthorizedCaller } - // --- TatsΓ€chlich bezahlter TX-Gaspreis (Source of Truth fΓΌr Settlement) --- + // --- Actually paid TX gas price (source of truth for settlement) --- // In dieser Codebase ist TxContext.GasPrice ein uint256 als types.Hash (big-endian). txCtx := host.GetTxContext() paidWeiPerGas := new(big.Int).SetBytes(txCtx.GasPrice[:]) if paidWeiPerGas.Sign() <= 0 { return nil, runtime.ErrInvalidInputData } - // --- GebΓΌhren-Guards --------------------------------------------------- + // --- Fee guards --------------------------------------------------- // Semantik: fehlender/0er MaxFeePerGas => "erbt BaseFee" (falls vorhanden) if bf := txCtx.BaseFee; bf != nil { if call.MaxFeePerGas == nil || call.MaxFeePerGas.Sign() == 0 { - // kein Cap ΓΌbergeben -> auf tatsΓ€chlich bezahlten Preis heben - // (sonst ΓΌber-/unterverrechnen wir, sobald cap != effective price) + // no cap provided -> raise to the actually paid price + // (otherwise we over/under-charge as soon as cap != effective price) call.MaxFeePerGas = new(big.Int).Set(paidWeiPerGas) } else if call.MaxFeePerGas.Cmp(bf) < 0 { // explizit gesetzter Cap < BaseFee return nil, runtime.ErrInvalidInputData } } - // Wenn selbst nach dem Fallback noch nil/<=0 -> unzulΓ€ssig + // If still nil/<=0 after fallback -> invalid if call.MaxFeePerGas == nil || call.MaxFeePerGas.Sign() <= 0 { return nil, runtime.ErrInvalidInputData } - // Grant enthΓ€lt kein MaxFeePerGas- oder PriorityFee-Feld mehr - // Wenn kein Ziel, muss GasLimit 0 sein + // Grant no longer carries MaxFeePerGas or PriorityFee fields + // If there is no target, GasLimit must be 0 if (call.To == (ethgo.Address{})) && call.GasLimit != 0 { return nil, runtime.ErrInvalidInputData } - // Settlement/Preflight immer mit dem tatsΓ€chlich bezahlten Preis (nicht mit dem Cap). + // Settlement/Preflight always use the actually paid price (not the cap). effectiveWeiPerGas := paidWeiPerGas - // ---------- Konservativer Preflight-Guthabencheck ----------------------- - // Ziel: spΓ€tere Erstattung darf NICHT mehr fehlschlagen β†’ Engine bleibt - // niemals auf Kosten sitzen (auch bei Reverts). + // ---------- Conservative preflight balance check ----------------------- + // Goal: later reimbursement must NOT fail anymore -> engine remains + // never left carrying costs (including on reverts). // - // Enthaltene Einheiten (SSOT): - // fc.totalTxUnits() + Value (+ ggf. GrantFee) + // Included units (SSOT): + // fc.totalTxUnits() + value (+ optional grant fee) worstWei := new(big.Int).Mul(new(big.Int).SetUint64(fc.totalTxUnits()), effectiveWeiPerGas) worstTotal := new(big.Int).Set(worstWei) worstTotal.Add(worstTotal, nz(call.ValueWei)) @@ -408,7 +419,7 @@ func (e *engineExecute) run(input []byte, caller types.Address, host runtime.Hos return nil, runtime.ErrNotEnoughFunds } var execResGasUsed uint64 - // Default: log-only (kein innerer CALL) als Fehler markieren + // Default: mark log-only (no inner CALL) as failure success := false if call.GasLimit > 0 && (call.To != (ethgo.Address{})) { code := host.GetCode(types.Address(call.To)) @@ -427,10 +438,10 @@ func (e *engineExecute) run(input []byte, caller types.Address, host runtime.Hos success = res.Succeeded() } - // --- Einheitliche Erstattung an den Engine-EOA --- - // WICHTIG: Im Meta-Event die ROOT-ID (sessionId) loggen, NICHT die Node-PID + // --- Unified reimbursement to the engine EOA --- + // IMPORTANT: Im Meta-Event die ROOT-ID (sessionId) loggen, NICHT die Node-PID metaData, _ := engineMetaEvent.Inputs.Encode([]interface{}{ - grant.SessionId, // processId-Feld trΓ€gt jetzt die rootId (Session) + grant.SessionId, // processId field now carries rootId (session) meta.Iteration, // iteration grant.XRC729, // orchestration grant.OstcId, // ostcId @@ -448,15 +459,15 @@ func (e *engineExecute) run(input []byte, caller types.Address, host runtime.Hos new(big.Int).SetUint64(execResGasUsed), meta.Extras, }) - // Abrechnungseinheiten sind SSOT aus fc: - // - EVM-Units (Base+Calldata+Logs+CALL+execLimit) - // - Validation-Units (call.ValidationGas) + // Billing units are SSOT from fc: + // - EVM units (base+calldata+logs+CALL+execLimit) + // - Validation units (call.ValidationGas) evmUnits := fc.evmTxUnits() totalUnits := fc.totalTxUnits() - // Erstattung deckungsgleich zur SSOT-Aufteilung: - // Feld 3: EVM-Refund (ohne Validation) - // Feld 4: Validation-Wei (nur Breakdown) + // Reimbursement aligned with SSOT split: + // Field 3: EVM refund (without validation) + // Field 4: validation wei (breakdown only) evmFeeRefund := new(big.Int).Mul(new(big.Int).SetUint64(evmUnits), effectiveWeiPerGas) engineFeeWei := new(big.Int).Mul(new(big.Int).SetUint64(fc.validationGas), effectiveWeiPerGas) totalPay := new(big.Int).Add(new(big.Int).Set(evmFeeRefund), engineFeeWei) @@ -465,24 +476,24 @@ func (e *engineExecute) run(input []byte, caller types.Address, host runtime.Hos return nil, err } } - // EngineFee ist separat ausgewiesen (siehe Output-Feld 4). + // EngineFee is reported separately (see output field 4). emitExtras := true // Emit EngineMeta event (exact order) id := engineMetaEvent.ID() topics := []types.Hash{types.BytesToHash(id[:])} host.EmitLog(contracts.EngineExecutePrecompile, topics, metaData) - // Emit EngineExtrasV2 event deckungsgleich zu gas(): immer loggen + // Emit EngineExtrasV2 event in line with gas(): always emit. if emitExtras { id2 := engineExtrasEvent.ID() topics2 := []types.Hash{types.BytesToHash(id2[:])} host.EmitLog(contracts.EngineExecutePrecompile, topics2, extrasData) } - // FΓΌr UI: - // - Feld 2 (β€žbilledUnitsβ€œ) entspricht den verrechneten Gas-Units. - // - Feld 3 enthΓ€lt die EVM-Refund-Wei (Gas). - // - Feld 4 enthΓ€lt die EngineFee-Wei (ValidationGas). + // For UI: + // - Field 2 ("billedUnits") contains billed gas units. + // - Field 3 contains EVM refund wei (gas). + // - Field 4 contains engine fee wei (validationGas). out, _ := ethabi.MustNewType("tuple(bool,uint64,uint256,uint256)").Encode([]interface{}{ success, totalUnits, @@ -490,8 +501,8 @@ func (e *engineExecute) run(input []byte, caller types.Address, host runtime.Hos engineFeeWei, }) - // Persistierung von kNext erfolgte bereits oben **vor** dem EVM-Call. - // Hier KEIN weiteres State-Tuning mehr, um Doppelwahrheiten auszuschließen. + // kNext persistence already happened above **before** the EVM call. + // Do NOT perform additional state tuning here to avoid dual sources of truth. return out, nil } @@ -553,15 +564,15 @@ func logGrantFeeCharged(host runtime.Host, payer, engine types.Address, seconds host.EmitLog(contracts.EngineExecutePrecompile, nil, payload) } -// ---------- arithmetische LΓ€ngen-Helfer (exakt, ohne Encode) ---------------- +// ---------- arithmetic length helpers (exact, without encode) ---------------- func pad32(n int) int { return ((n + 31) / 32) * 32 } func dynLen(n int) int { return 32 + pad32(n) } // 32B len + padded payload func bLen(s string) int { return len([]byte(s)) } // UTF-8 Bytes -// EngineMeta: 13 Felder (8 static im Head, 5 dynamic im Tail) +// EngineMeta: 13 fields (8 static in head, 5 dynamic in tail) const nArgsMeta = 13 -// EngineExtrasV2: 2 Felder (1 dynamic) +// EngineExtrasV2: 2 fields (1 dynamic) const nArgsExtras = 2 func calcEngineMetaLen(g inGrant, m inMeta) int { @@ -575,13 +586,13 @@ func calcEngineMetaLen(g inGrant, m inMeta) int { return head + tail } -// --- Entfernte Legacy-Helfer ------------------------------------------------ -// Alle kRootSession-Referenzen wurden eliminiert. -// Als Invariante gilt: -// - Neuer Root: sessionId == kNext +// --- Removed legacy helpers ------------------------------------------------ +// All kRootSession references were removed. +// Invariant: +// - New root: sessionId == kNext // - Follow-up: sessionId < kNext -// - Ablehnung: sessionId > kNext -// - lastRoot := kNext - 1 (implizit) +// - Rejection: sessionId > kNext +// - lastRoot := kNext - 1 (implicit) func calcEngineExtrasLen(m inMeta) int { return 32*nArgsExtras + dynLen(len(m.Extras)) diff --git a/stub.sum b/stub.sum index 64d5906..d457643 100644 --- a/stub.sum +++ b/stub.sum @@ -303,6 +303,8 @@ github.com/valyala/fasthttp v1.51.0 h1:8b30A5JlZ6C7AS81RsWjYMQmrZG6feChmgAolCl1S github.com/valyala/fasthttp v1.51.0/go.mod h1:oI2XroL+lI7vdXyYoQk03bXBThfFl2cVdIA3Xl7cH8g= github.com/valyala/fastjson v1.6.3 h1:tAKFnnwmeMGPbwJ7IwxcTPCNr3uIzoIj3/Fh90ra4xc= github.com/valyala/fastjson v1.6.3/go.mod h1:CLCAqky6SMuOcxStkYQvblddUtoRxhYMGLrsQns1aXY= +github.com/xgr-network/go-ibft v0.0.0-20260406142847-339905dd34f5 h1:+upnAT4Z/7ySY+Jh90gpnoXOMuR0r3CPPp2EK8bgbxI= +github.com/xgr-network/go-ibft v0.0.0-20260406142847-339905dd34f5/go.mod h1:FPdz+s0jyQzW4pZK+HMnhz2b8ebsg5FaSVFTjvQi8ls= go.etcd.io/bbolt v1.3.8 h1:xs88BrvEv273UsB79e0hcVrlUWmS0a8upikMFhSyAtA= go.etcd.io/bbolt v1.3.8/go.mod h1:N9Mkw9X8x5fupy0IKsmuqVtoGDyxsaDlbk4Rd05IAQw= go.opencensus.io v0.24.0 h1:y73uSU6J157QMP2kn2r30vwW1A2W2WFwSCGnAVxeaD0= diff --git a/syncer/client.go b/syncer/client.go index fcff67a..5cab3d6 100644 --- a/syncer/client.go +++ b/syncer/client.go @@ -31,11 +31,12 @@ type syncPeerClient struct { network Network // reference to the network module blockchain Blockchain // reference to the blockchain module - subscription blockchain.Subscription // reference to the blockchain subscription - topic *network.Topic // reference to the network topic - id string // node id - peerStatusUpdateCh chan *NoForkPeer // peer status update channel - peerConnectionUpdateCh chan *event.PeerEvent // peer connection update channel + subscription blockchain.Subscription // reference to the blockchain subscription + topic *network.Topic // reference to the network topic + id string // node id + peerStatusUpdateCh chan *NoForkPeer // peer status update channel + peerConnectionUpdateCh chan *event.PeerEvent // peer connection update channel + peerEventProcessReadyCh chan struct{} // optional test hook for peer event subscription readiness shouldEmitBlocks bool // flag for emitting blocks in the topic closeCh chan struct{} @@ -273,6 +274,9 @@ func (m *syncPeerClient) startPeerEventProcess() { return } + if m.peerEventProcessReadyCh != nil { + close(m.peerEventProcessReadyCh) + } for { select { diff --git a/syncer/client_test.go b/syncer/client_test.go index ce59dc9..d7654be 100644 --- a/syncer/client_test.go +++ b/syncer/client_test.go @@ -39,13 +39,14 @@ func newTestNetwork(t *testing.T) *network.Server { func newTestSyncPeerClient(network Network, blockchain Blockchain) *syncPeerClient { client := &syncPeerClient{ - logger: hclog.NewNullLogger(), - network: network, - blockchain: blockchain, - id: network.AddrInfo().ID.String(), - peerStatusUpdateCh: make(chan *NoForkPeer, 1), - peerConnectionUpdateCh: make(chan *event.PeerEvent, 1), - closeCh: make(chan struct{}), + logger: hclog.NewNullLogger(), + network: network, + blockchain: blockchain, + id: network.AddrInfo().ID.String(), + peerStatusUpdateCh: make(chan *NoForkPeer, 1), + peerConnectionUpdateCh: make(chan *event.PeerEvent, 1), + peerEventProcessReadyCh: nil, + closeCh: make(chan struct{}), } // need to register protocol @@ -174,12 +175,19 @@ func TestStatusPubSub(t *testing.T) { _, peerSrv := createTestSyncerService(t, &mockBlockchain{}) peerID := peerSrv.AddrInfo().ID + client.peerEventProcessReadyCh = make(chan struct{}) go client.startPeerEventProcess() + select { + case <-client.peerEventProcessReadyCh: + case <-time.After(5 * time.Second): + t.Fatal("timed out waiting for peer event process readiness") + } // run goroutine to collect events var ( - events = []*event.PeerEvent{} - wg sync.WaitGroup + events = []*event.PeerEvent{} + eventsMu sync.Mutex + wg sync.WaitGroup ) wg.Add(1) @@ -188,7 +196,9 @@ func TestStatusPubSub(t *testing.T) { defer wg.Done() for event := range client.GetPeerConnectionUpdateEventCh() { + eventsMu.Lock() events = append(events, event) + eventsMu.Unlock() } }() @@ -211,11 +221,22 @@ func TestStatusPubSub(t *testing.T) { assert.NoError(t, err) - // close channel and wait for events + require.Eventually(t, func() bool { + eventsMu.Lock() + defer eventsMu.Unlock() + + return len(events) == 2 + }, 5*time.Second, 10*time.Millisecond) + + // close channel and wait for events after both expected events are observed close(client.closeCh) wg.Wait() + eventsMu.Lock() + observedEvents := append([]*event.PeerEvent(nil), events...) + eventsMu.Unlock() + expected := []*event.PeerEvent{ { PeerID: peerID, @@ -227,7 +248,7 @@ func TestStatusPubSub(t *testing.T) { }, } - assert.Equal(t, expected, events) + assert.Equal(t, expected, observedEvents) } func TestPeerConnectionUpdateEventCh(t *testing.T) { diff --git a/tests/state_test.go b/tests/state_test.go index 0ceb7fd..4e040fd 100644 --- a/tests/state_test.go +++ b/tests/state_test.go @@ -126,6 +126,12 @@ func RunSpecificTest(t *testing.T, file string, c testCase, name, fork string, i func TestState(t *testing.T) { t.Parallel() + if _, err := os.Stat(stateTests); os.IsNotExist(err) { + if _, legacyErr := os.Stat(legacyStateTests); os.IsNotExist(legacyErr) { + t.Skip("state test fixtures are not present in this repository setup") + } + } + long := []string{ "static_Call50000", "static_Return50000", diff --git a/tools/testapi/testapi.go b/tools/testapi/testapi.go index a466fee..a5d765f 100644 --- a/tools/testapi/testapi.go +++ b/tools/testapi/testapi.go @@ -23,19 +23,19 @@ type Config struct { } type Route struct { - Method string `json:"method"` // GET|POST|PUT|PATCH (Default GET) - Path string `json:"path"` // exakte Pfadangabe, z.B. /fx/latest - Mode string `json:"mode,omitempty"` // first|round-robin|sequential (Default first) - Responses []Reply `json:"responses"` // mind. 1 Eintrag + Method string `json:"method"` // GET|POST|PUT|PATCH (default GET) + Path string `json:"path"` // exact path, e.g. /fx/latest + Mode string `json:"mode,omitempty"` // first|round-robin|sequential (default first) + Responses []Reply `json:"responses"` // at least 1 entry } type Reply struct { Status int `json:"status,omitempty"` // Default 200 Headers map[string]string `json:"headers,omitempty"` // Optional - ContentType string `json:"contentType,omitempty"` // Default: aus Body/Text abgeleitet - Body json.RawMessage `json:"body,omitempty"` // GΓΌltiges JSON (roh, unverΓ€ndert gesendet) - Text string `json:"text,omitempty"` // Falls kein JSON, wird Text gesendet - DelayMs int `json:"delayMs,omitempty"` // kΓΌnstliche Latenz + ContentType string `json:"contentType,omitempty"` // default: derived from body/text + Body json.RawMessage `json:"body,omitempty"` // valid JSON (raw, sent unchanged) + Text string `json:"text,omitempty"` // if not JSON, text is sent + DelayMs int `json:"delayMs,omitempty"` // artificial latency } type compiledRoute struct { @@ -44,7 +44,7 @@ type compiledRoute struct { mode string replies []Reply mu sync.Mutex - cursor int // fΓΌr round-robin/sequential + cursor int // for round-robin/sequential } type server struct { @@ -146,7 +146,7 @@ func (s *server) ServeHTTP(w http.ResponseWriter, r *http.Request) { } resp := s.pickReply(cr) - // kΓΌnstliche Latenz + // artificial latency if d := resp.DelayMs; d > 0 { ctx, cancel := context.WithTimeout(r.Context(), time.Duration(d)*time.Millisecond) defer cancel() diff --git a/tracker/event_tracker_test.go b/tracker/event_tracker_test.go index dfa5e3f..b7621c7 100644 --- a/tracker/event_tracker_test.go +++ b/tracker/event_tracker_test.go @@ -41,6 +41,10 @@ func (m *mockEventSubscriber) len() int { } func TestEventTracker_TrackSyncEvents(t *testing.T) { + if os.Getenv("XGR_ENABLE_DOCKER_INTEGRATION_TESTS") != "1" { + t.Skip("requires docker-backed RPC with eth_accounts; set XGR_ENABLE_DOCKER_INTEGRATION_TESTS=1 to run") + } + const ( numBlockConfirmations = 6 eventsPerStep = 8 diff --git a/txpool/event_subscription_test.go b/txpool/event_subscription_test.go index b8736f5..954ef78 100644 --- a/txpool/event_subscription_test.go +++ b/txpool/event_subscription_test.go @@ -117,7 +117,7 @@ func TestEventSubscription_ProcessedEvents(t *testing.T) { eventStore: &eventQueue{ events: make([]*proto.TxPoolEvent, 0), }, - notifyCh: make(chan struct{}), + notifyCh: make(chan struct{}, 1), } go subscription.runLoop() diff --git a/txpool/txpool_test.go b/txpool/txpool_test.go index 16856c3..fad3b9d 100644 --- a/txpool/txpool_test.go +++ b/txpool/txpool_test.go @@ -2808,6 +2808,13 @@ func TestExecutablesOrder(t *testing.T) { addr types.Address, nonce, gasPrice uint64, gasFeeCap uint64, value uint64) *types.Transaction { tx := newTx(addr, nonce, 1) tx.Value = new(big.Int).SetUint64(value) + tx.Input = []byte{ + addr[0], + byte(nonce), + byte(gasPrice), + byte(gasFeeCap), + byte(value), + } if gasPrice == 0 { tx.Type = types.DynamicFeeTx @@ -2955,25 +2962,17 @@ func TestExecutablesOrder(t *testing.T) { pool.Start() defer pool.Close() - subscription := pool.eventManager.subscribe( - []proto.EventType{proto.EventType_PROMOTED}, - ) - - expectedPromotedTx := 0 for _, txs := range test.allTxs { for _, tx := range txs { - expectedPromotedTx++ // send all txs assert.NoError(t, pool.addTx(local, tx)) } } - ctx, cancelFn := context.WithTimeout(context.Background(), time.Second*10) - defer cancelFn() - - // All txns should get added - require.Len(t, waitForEvents(ctx, subscription, expectedPromotedTx), expectedPromotedTx) - require.Equal(t, uint64(len(test.expectedPriceOrder)), pool.accounts.promoted()) + expectedPromotedTx := len(test.expectedPriceOrder) + require.Eventually(t, func() bool { + return pool.accounts.promoted() == uint64(expectedPromotedTx) + }, 10*time.Second, 10*time.Millisecond) pool.Prepare() @@ -3492,12 +3491,10 @@ func TestSetSealing(t *testing.T) { } func TestBatchTx_SingleAccount(t *testing.T) { - t.Parallel() - _, addr := tests.GenerateKeyAndAddr(t) pool, err := newTestPool() - assert.NoError(t, err) + require.NoError(t, err) pool.SetSigner(&mockSigner{}) @@ -3508,68 +3505,92 @@ func TestBatchTx_SingleAccount(t *testing.T) { // subscribe to enqueue and promote events subscription := pool.eventManager.subscribe([]proto.EventType{proto.EventType_ENQUEUED, proto.EventType_PROMOTED}) - txHashMap := map[types.Hash]struct{}{} - // mutex for txHashMap - mux := &sync.RWMutex{} + txCount := int(defaultMaxAccountEnqueued) + txHashMap := make(map[types.Hash]struct{}, txCount) + txs := make([]*types.Transaction, txCount) + + for i := 0; i < txCount; i++ { + tx := newTx(addr, uint64(i), 1) + require.NotNil(t, tx) + + tx.ComputeHash(1) + txHashMap[tx.Hash] = struct{}{} + txs[i] = tx + } + + start := make(chan struct{}) + errCh := make(chan error, txCount) counter := uint64(0) + wg := new(sync.WaitGroup) + wg.Add(txCount) // run max number of addTx concurrently - for i := 0; i < int(defaultMaxAccountEnqueued); i++ { - go func(i uint64) { - tx := newTx(addr, i, 1) + for i, tx := range txs { + i := i + tx := tx - tx.ComputeHash(1) + go func() { + defer wg.Done() - // add transaction hash to map - mux.Lock() - txHashMap[tx.Hash] = struct{}{} - mux.Unlock() + <-start - // submit transaction to pool - assert.NoError(t, pool.addTx(local, tx)) + if addErr := pool.addTx(local, tx); addErr != nil { + errCh <- fmt.Errorf("tx[%d] add failed: %w", i, addErr) + + return + } atomic.AddUint64(&counter, 1) - }(uint64(i)) + }() + } + + close(start) + wg.Wait() + close(errCh) + + for addErr := range errCh { + require.NoError(t, addErr) } enqueuedCount := 0 promotedCount := 0 - ev := (*proto.TxPoolEvent)(nil) + receivedEvents := 0 + expectedEventCount := txCount * 2 + timeout := time.NewTimer(10 * time.Second) + defer timeout.Stop() // wait for all the submitted transactions to be promoted - for { + for receivedEvents < expectedEventCount { select { - case ev = <-subscription.subscriptionChannel: - case <-time.After(time.Second * 3): + case ev := <-subscription.subscriptionChannel: + // check if valid transaction hash + _, hashExists := txHashMap[types.StringToHash(ev.TxHash)] + require.True(t, hashExists, "received event for unknown hash %s", ev.TxHash) + + // increment corresponding event type's count + if ev.Type == proto.EventType_ENQUEUED { + enqueuedCount++ + } else if ev.Type == proto.EventType_PROMOTED { + promotedCount++ + } else { + require.Failf(t, "unexpected event type", "type: %s", ev.Type.String()) + } + + receivedEvents++ + case <-timeout.C: t.Fatal(fmt.Sprintf("timeout. processed: %d/%d and %d/%d. Added: %d", enqueuedCount, defaultMaxAccountEnqueued, promotedCount, defaultMaxAccountEnqueued, atomic.LoadUint64(&counter))) } - - // check if valid transaction hash - mux.Lock() - _, hashExists := txHashMap[types.StringToHash(ev.TxHash)] - mux.Unlock() - - assert.True(t, hashExists) - - // increment corresponding event type's count - if ev.Type == proto.EventType_ENQUEUED { - enqueuedCount++ - } else if ev.Type == proto.EventType_PROMOTED { - promotedCount++ - } - - if enqueuedCount == int(defaultMaxAccountEnqueued) && promotedCount == int(defaultMaxAccountEnqueued) { - // compare local tracker to pool internal - assert.Equal(t, defaultMaxAccountEnqueued, pool.Length()) - - // all transactions are promoted - break - } } + assert.Equal(t, int(defaultMaxAccountEnqueued), enqueuedCount) + assert.Equal(t, int(defaultMaxAccountEnqueued), promotedCount) + // compare local tracker to pool internal + assert.Equal(t, defaultMaxAccountEnqueued, pool.Length()) + acc := pool.accounts.get(addr) + require.NotNil(t, acc) acc.nonceToTx.lock() diff --git a/types/header_hash.go b/types/header_hash.go index 114eb30..bb4970b 100644 --- a/types/header_hash.go +++ b/types/header_hash.go @@ -1,17 +1,22 @@ package types import ( + "sync" + "github.com/umbracle/fastrlp" "github.com/xgr-network/xgr-node/helper/keccak" ) -var HeaderHash func(h *Header) Hash +var ( + HeaderHash func(h *Header) Hash + headerHashMu sync.RWMutex +) // This is the default header hash for the block. // In IBFT, this header hash method is substituted // for Istanbul Header Hash calculation func init() { - HeaderHash = defHeaderHash + SetHeaderHash(defHeaderHash) } var marshalArenaPool fastrlp.ArenaPool @@ -32,7 +37,23 @@ func defHeaderHash(h *Header) (hash Hash) { // ComputeHash computes the hash of the header func (h *Header) ComputeHash() *Header { - h.Hash = HeaderHash(h) + h.Hash = GetHeaderHash()(h) return h } + +// SetHeaderHash updates the active header hash function. +func SetHeaderHash(hashFn func(h *Header) Hash) { + headerHashMu.Lock() + HeaderHash = hashFn + headerHashMu.Unlock() +} + +// GetHeaderHash returns the active header hash function. +func GetHeaderHash() func(h *Header) Hash { + headerHashMu.RLock() + hashFn := HeaderHash + headerHashMu.RUnlock() + + return hashFn +} diff --git a/types/transaction.go b/types/transaction.go index f71c19b..d868cb2 100644 --- a/types/transaction.go +++ b/types/transaction.go @@ -8,6 +8,41 @@ import ( "github.com/xgr-network/xgr-node/helper/common" ) +const ( + // EpochFinalizationSystemTxInput marks the deterministic native + // epoch-finalization system transaction used for receipt/log indexing. + EpochFinalizationSystemTxInput = "xgr.pos.finalizeEpoch.v1" +) + +// EpochFinalizationSystemTxTo is the consensus-owned PoS system address. +var EpochFinalizationSystemTxTo = StringToAddress("0x0000000000000000000000000000000000009999") + +// IsEpochFinalizationSystemTx reports whether tx has the deterministic shape used +// for native PoS epoch-finalization receipt/log indexing. The sender, nonce, and +// hash are intentionally checked by IsEpochFinalizationSystemTxForBlock. +func IsEpochFinalizationSystemTx(tx *Transaction) bool { + return tx != nil && + tx.Type == StateTx && + tx.To != nil && *tx.To == EpochFinalizationSystemTxTo && + tx.Gas == StateTransactionGasLimit && + tx.GasPrice != nil && tx.GasPrice.Sign() == 0 && + tx.Value != nil && tx.Value.Sign() == 0 && + string(tx.Input) == EpochFinalizationSystemTxInput +} + +// IsEpochFinalizationSystemTxForBlock reports whether tx is the deterministic +// native epoch-finalization system transaction for blockNumber and systemCaller. +func IsEpochFinalizationSystemTxForBlock(tx *Transaction, blockNumber uint64, systemCaller Address) bool { + if !IsEpochFinalizationSystemTx(tx) || tx.From != systemCaller || tx.Nonce != blockNumber { + return false + } + + cpy := tx.Copy() + cpy.ComputeHash(blockNumber) + + return tx.Hash == cpy.Hash +} + const ( // StateTransactionGasLimit is arbitrary default gas limit for state transactions StateTransactionGasLimit = 1000000 diff --git a/validators/store/contract/contract_test.go b/validators/store/contract/contract_test.go index d0d2a82..d8f5546 100644 --- a/validators/store/contract/contract_test.go +++ b/validators/store/contract/contract_test.go @@ -28,8 +28,9 @@ var ( testBLSPubKey2 = newTestBLSKeyBytes() testPredeployParams = stakingHelper.PredeployParams{ - MinValidatorCount: 0, + MinValidatorCount: 1, MaxValidatorCount: 10, + EpochSize: 10, } testBlockGasLimit uint64 = 10000000 ) diff --git a/validators/store/contract/fetcher.go b/validators/store/contract/fetcher.go index 579c5bf..afc3b9e 100644 --- a/validators/store/contract/fetcher.go +++ b/validators/store/contract/fetcher.go @@ -2,82 +2,582 @@ package contract import ( "fmt" + "math/big" + "sort" "github.com/xgr-network/xgr-node/contracts/staking" "github.com/xgr-network/xgr-node/crypto" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/helper/keccak" "github.com/xgr-network/xgr-node/state" "github.com/xgr-network/xgr-node/types" "github.com/xgr-network/xgr-node/validators" ) -// FetchValidators fetches validators from a contract switched by validator type +const ( + validatorThresholdSlot = int64(0) + configSlot = int64(1) + validatorsSlot = int64(2) + stakerSlot = int64(3) + stakersByValidatorSlot = int64(6) + validatorDelegatedActiveSlot = int64(9) +) + +type weightedAddr struct { + addr types.Address + stake *big.Int +} + +type weightedBLS struct { + addr types.Address + stake *big.Int + bls []byte +} + +// FetchValidators fetches validators from staking state and applies filtering policy. func FetchValidators( validatorType validators.ValidatorType, transition *state.Transition, - from types.Address, + _ types.Address, ) (validators.Validators, error) { switch validatorType { case validators.ECDSAValidatorType: - return FetchECDSAValidators(transition, from) + return FetchECDSAValidators(transition, types.ZeroAddress) case validators.BLSValidatorType: - return FetchBLSValidators(transition, from) + return FetchBLSValidators(transition, types.ZeroAddress) } return nil, fmt.Errorf("unsupported validator type: %s", validatorType) } -// FetchECDSAValidators queries a contract for validator addresses and returns ECDSAValidators -func FetchECDSAValidators( - transition *state.Transition, - from types.Address, -) (validators.Validators, error) { - valAddrs, err := staking.QueryValidators(transition, from) - if err != nil { - return nil, err +func FetchECDSAValidators(transition *state.Transition, _ types.Address) (validators.Validators, error) { + valAddrs := readValidators(transition) + minCount := readMinNumValidators(transition) + maxCount := readMaxNumValidators(transition) + threshold := readValidatorThreshold(transition) + + eligible := validators.NewECDSAValidatorSet() + eligibleWeighted := make([]weightedAddr, 0, len(valAddrs)) + emergency := validators.NewECDSAValidatorSet() + emergencyWeighted := make([]weightedAddr, 0, len(valAddrs)) + + for _, addr := range valAddrs { + candidate := validators.NewECDSAValidator(addr) + selfStake := readStakerAmount(transition, addr) + totalStake := ReadValidatorEffectiveTotalStakeAt(transition, addr, currentBlockNumber(transition)) + votingStake := ReadValidatorVotingStakeAt(transition, addr, currentBlockNumber(transition)) + + // Emergency validator selection intentionally retains inactive-but-staked validators and uses + // the same canonical stake basis as consensus voting power. + if votingStake.Sign() > 0 { + emergencyWeighted = append(emergencyWeighted, weightedAddr{addr: addr, stake: votingStake}) + } + + if isValidatorActive(transition, addr) { + if err := emergency.Add(candidate); err != nil { + return nil, err + } + } + + if !isValidatorActive(transition, addr) { + continue + } + if selfStake.Cmp(validatorSelfStakeMinWei()) < 0 || totalStake.Cmp(threshold) < 0 { + continue + } + if err := eligible.Add(candidate); err != nil { + return nil, err + } + + eligibleWeighted = append(eligibleWeighted, weightedAddr{addr: addr, stake: totalStake}) + } + + if uint64(eligible.Len()) < minCount { + if uint64(emergency.Len()) >= minCount { + return trimECDSASetToMax(emergency, maxCount), nil + } + + res, err := weightedECDSASet(emergencyWeighted) + if err != nil { + return nil, err + } + + return trimECDSASetToMax(res, maxCount), nil } - ecdsaValidators := validators.NewECDSAValidatorSet() + if maxCount > 0 && uint64(eligible.Len()) > maxCount { + res, err := weightedECDSASet(eligibleWeighted) + if err != nil { + return nil, err + } + + return trimECDSASetToMax(res, maxCount), nil + } + + return eligible, nil +} + +// IsEmergencyModeActive returns true when the normal eligibility filter would +// produce a validator set below the configured minimum validator count. +// In this mode, the fetcher falls back to broader selection rules. +func IsEmergencyModeActive(transition *state.Transition) bool { + valAddrs := readValidators(transition) + minCount := readMinNumValidators(transition) + threshold := readValidatorThreshold(transition) + + eligibleCount := uint64(0) + for _, addr := range valAddrs { + if !isValidatorActive(transition, addr) { + continue + } + + selfStake := readStakerAmount(transition, addr) + totalStake := ReadValidatorEffectiveTotalStakeAt(transition, addr, currentBlockNumber(transition)) + if selfStake.Cmp(validatorSelfStakeMinWei()) < 0 || totalStake.Cmp(threshold) < 0 { + continue + } + + eligibleCount++ + } + + return eligibleCount < minCount +} + +func FetchBLSValidators(transition *state.Transition, _ types.Address) (validators.Validators, error) { + valAddrs := readValidators(transition) + minCount := readMinNumValidators(transition) + maxCount := readMaxNumValidators(transition) + threshold := readValidatorThreshold(transition) + + eligible := validators.NewBLSValidatorSet() + eligibleWeighted := make([]weightedBLS, 0, len(valAddrs)) + emergency := validators.NewBLSValidatorSet() + emergencyWeighted := make([]weightedBLS, 0, len(valAddrs)) + for _, addr := range valAddrs { - if err := ecdsaValidators.Add(validators.NewECDSAValidator(addr)); err != nil { + blsKey := readMetaBLSPubKey(transition, addr) + selfStake := readStakerAmount(transition, addr) + totalStake := ReadValidatorEffectiveTotalStakeAt(transition, addr, currentBlockNumber(transition)) + votingStake := ReadValidatorVotingStakeAt(transition, addr, currentBlockNumber(transition)) + _, blsErr := crypto.UnmarshalBLSPublicKey(blsKey) + + if votingStake.Sign() > 0 && blsErr == nil { + emergencyWeighted = append(emergencyWeighted, weightedBLS{addr: addr, stake: votingStake, bls: blsKey}) + } + + if isValidatorActive(transition, addr) && blsErr == nil { + if err := emergency.Add(validators.NewBLSValidator(addr, blsKey)); err != nil { + return nil, err + } + } + + if !isValidatorActive(transition, addr) { + continue + } + if selfStake.Cmp(validatorSelfStakeMinWei()) < 0 || totalStake.Cmp(threshold) < 0 { + continue + } + if blsErr != nil { + continue + } + if err := eligible.Add(validators.NewBLSValidator(addr, blsKey)); err != nil { return nil, err } + + eligibleWeighted = append(eligibleWeighted, weightedBLS{addr: addr, stake: totalStake, bls: blsKey}) + } + + if uint64(eligible.Len()) < minCount { + if uint64(emergency.Len()) >= minCount { + return trimBLSSetToMax(emergency, maxCount), nil + } + + res, err := weightedBLSSet(emergencyWeighted) + if err != nil { + return nil, err + } + + return trimBLSSetToMax(res, maxCount), nil + } + + if maxCount > 0 && uint64(eligible.Len()) > maxCount { + res, err := weightedBLSSet(eligibleWeighted) + if err != nil { + return nil, err + } + + return trimBLSSetToMax(res, maxCount), nil } - return ecdsaValidators, nil + return eligible, nil } -// FetchBLSValidators queries a contract for validator addresses & BLS Public Keys and returns ECDSAValidators -func FetchBLSValidators( +func readValidators(transition *state.Transition) []types.Address { + if transition == nil { + return nil + } + lenHash := transition.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(big.NewInt(validatorsSlot).Bytes())) + length := new(big.Int).SetBytes(lenHash[:]).Uint64() + if length == 0 { + return nil + } + base := keccak.Keccak256(nil, common.PadLeftOrTrim(big.NewInt(validatorsSlot).Bytes(), 32)) + idx := new(big.Int).SetBytes(base) + out := make([]types.Address, 0, length) + for i := uint64(0); i < length; i++ { + slot := new(big.Int).Add(idx, new(big.Int).SetUint64(i)) + raw := transition.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(slot.Bytes())) + out = append(out, types.BytesToAddress(raw[12:])) + } + return out +} + +func readMinNumValidators(transition *state.Transition) uint64 { + if transition == nil { + return 0 + } + raw := transition.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(big.NewInt(configSlot).Bytes())) + v := new(big.Int).SetBytes(raw[:]) + v.Rsh(v, 64) + return lowUint64(v) +} + +func readMaxNumValidators(transition *state.Transition) uint64 { + if transition == nil { + return 0 + } + + raw := transition.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(big.NewInt(configSlot).Bytes())) + v := new(big.Int).SetBytes(raw[:]) + v.Rsh(v, 128) + + return lowUint64(v) +} + +func readValidatorThreshold(transition *state.Transition) *big.Int { + if transition == nil { + return validatorThresholdWei() + } + + raw := transition.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(big.NewInt(validatorThresholdSlot).Bytes())) + v := new(big.Int).SetBytes(raw[:]) + if v.Sign() == 0 { + return validatorThresholdWei() + } + + return v +} + +func weightedECDSASet(weighted []weightedAddr) (validators.Validators, error) { + sort.Slice(weighted, func(i, j int) bool { + cmp := weighted[i].stake.Cmp(weighted[j].stake) + if cmp == 0 { + return weighted[i].addr.String() < weighted[j].addr.String() + } + return cmp > 0 + }) + + out := validators.NewECDSAValidatorSet() + for _, it := range weighted { + if err := out.Add(validators.NewECDSAValidator(it.addr)); err != nil { + return nil, err + } + } + + return out, nil +} + +func trimECDSASetToMax(set validators.Validators, maxCount uint64) validators.Validators { + if set == nil || maxCount == 0 || uint64(set.Len()) <= maxCount { + return set + } + + trimmed := validators.NewECDSAValidatorSet() + for i := uint64(0); i < maxCount; i++ { + _ = trimmed.Add(set.At(i)) + } + + return trimmed +} + +func weightedBLSSet(weighted []weightedBLS) (validators.Validators, error) { + sort.Slice(weighted, func(i, j int) bool { + cmp := weighted[i].stake.Cmp(weighted[j].stake) + if cmp == 0 { + return weighted[i].addr.String() < weighted[j].addr.String() + } + return cmp > 0 + }) + + out := validators.NewBLSValidatorSet() + for _, it := range weighted { + if err := out.Add(validators.NewBLSValidator(it.addr, it.bls)); err != nil { + return nil, err + } + } + + return out, nil +} + +func trimBLSSetToMax(set validators.Validators, maxCount uint64) validators.Validators { + if set == nil || maxCount == 0 || uint64(set.Len()) <= maxCount { + return set + } + + trimmed := validators.NewBLSValidatorSet() + for i := uint64(0); i < maxCount; i++ { + _ = trimmed.Add(set.At(i)) + } + + return trimmed +} + +func lowUint64(v *big.Int) uint64 { + if v == nil { + return 0 + } + + mask := new(big.Int).SetUint64(^uint64(0)) + t := new(big.Int).And(v, mask) + + return t.Uint64() +} + +func isValidatorActive(transition *state.Transition, addr types.Address) bool { + if readStakerValidator(transition, addr) != addr { + return false + } + return readStakerPacked(transition, addr).Bit(8) == 1 +} + +func readStakerAmount(transition *state.Transition, addr types.Address) *big.Int { + raw := transition.Txn().GetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 1)) + return new(big.Int).SetBytes(raw[:]) +} + +func readMetaBLSPubKey(transition *state.Transition, addr types.Address) []byte { + base := stakerSlotWithOffset(addr, 5) + raw := transition.Txn().GetState(staking.AddrStakingContract, base) + b := raw[:] + if b[31]%2 == 0 { + ln := int(b[31] / 2) + if ln == 0 { + return nil + } + out := make([]byte, ln) + copy(out, b[:ln]) + return out + } + ln := int((new(big.Int).SetBytes(b).Uint64() - 1) / 2) + if ln <= 0 { + return nil + } + dataBase := keccak.Keccak256(nil, common.PadLeftOrTrim(base.Bytes(), 32)) + slot := new(big.Int).SetBytes(dataBase) + out := make([]byte, 0, ln) + for len(out) < ln { + r := transition.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(slot.Bytes())) + need := ln - len(out) + if need > 32 { + need = 32 + } + out = append(out, r[:need]...) + slot.Add(slot, big.NewInt(1)) + } + return out +} + +func readStakerPacked(transition *state.Transition, addr types.Address) *big.Int { + raw := transition.Txn().GetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 0)) + return new(big.Int).SetBytes(raw[:]) +} + +func readStakerValidator(transition *state.Transition, addr types.Address) types.Address { + raw := transition.Txn().GetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 4)) + return types.BytesToAddress(raw[12:]) +} + +func readValidatorDelegatedStakeActive(transition *state.Transition, validator types.Address) *big.Int { + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(validatorDelegatedActiveSlot).Bytes(), 32)...), + ) + raw := transition.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(base)) + return new(big.Int).SetBytes(raw[:]) +} + +// ReadValidatorEffectiveTotalStakeAt returns epoch-effective total stake at a block. +// It is used for eligibility, Tier-1 selection, and epoch-based economic views. +// Self stake and delegator stake are counted only when epoch-effective. +// setActive/deactivation can affect inclusion through isStakerEffectiveAt. +func ReadValidatorEffectiveTotalStakeAt( transition *state.Transition, - from types.Address, -) (validators.Validators, error) { - valAddrs, err := staking.QueryValidators(transition, from) - if err != nil { - return nil, err + validator types.Address, + blockNumber uint64, +) *big.Int { + if transition == nil || readStakerValidator(transition, validator) != validator { + return new(big.Int) } - blsPublicKeys, err := staking.QueryBLSPublicKeys(transition, from) - if err != nil { - return nil, err + epochSize := readEpochSize(transition) + total := new(big.Int) + if isStakerEffectiveAt(transition, validator, blockNumber, epochSize) { + total.Add(total, readStakerAmount(transition, validator)) } - blsValidators := validators.NewBLSValidatorSet() + for _, owner := range readValidatorStakers(transition, validator) { + if owner == validator { + continue + } - for idx := range valAddrs { - // ignore the validator whose BLS Key is not set - // because BLS validator needs to have both Address and BLS Public Key set - // in the contract - if _, err := crypto.UnmarshalBLSPublicKey(blsPublicKeys[idx]); err != nil { + if isStakerEffectiveAt(transition, owner, blockNumber, epochSize) { + total.Add(total, readStakerAmount(transition, owner)) + } + } + + return total +} + +// ReadValidatorVotingStakeAt returns the canonical stake basis for stake-weighted IBFT voting. +// It is only used for validators already selected into the validator set by the fetcher. +// Self stake always counts as raw stake when self-mapped. +// Delegated stake counts only when epoch-effective at blockNumber. +// setActive, deactivation, and join-maturity do not gate self stake here. +func ReadValidatorVotingStakeAt( + transition *state.Transition, + validator types.Address, + blockNumber uint64, +) *big.Int { + if transition == nil || readStakerValidator(transition, validator) != validator { + return new(big.Int) + } + + epochSize := readEpochSize(transition) + total := new(big.Int).Set(readStakerAmount(transition, validator)) + for _, owner := range readValidatorStakers(transition, validator) { + if owner == validator { continue } - if err := blsValidators.Add(validators.NewBLSValidator( - valAddrs[idx], - blsPublicKeys[idx], - )); err != nil { - return nil, err + if isStakerEffectiveAt(transition, owner, blockNumber, epochSize) { + total.Add(total, readStakerAmount(transition, owner)) } } - return blsValidators, nil + return total +} + +// ReadStakerEffectiveStakeAt returns staker amount effective at blockNumber. +// If the staker is not epoch-effective at blockNumber, zero is returned. +func ReadStakerEffectiveStakeAt( + transition *state.Transition, + staker types.Address, + blockNumber uint64, +) *big.Int { + if transition == nil { + return new(big.Int) + } + + epochSize := readEpochSize(transition) + if !isStakerEffectiveAt(transition, staker, blockNumber, epochSize) { + return new(big.Int) + } + + return readStakerAmount(transition, staker) +} + +func currentBlockNumber(transition *state.Transition) uint64 { + if transition == nil { + return 0 + } + + return uint64(transition.GetTxContext().Number) +} + +func readEpochSize(transition *state.Transition) uint64 { + if transition == nil { + return 0 + } + + raw := transition.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(big.NewInt(configSlot).Bytes())) + v := new(big.Int).SetBytes(raw[:]) + + return lowUint64(v) +} + +func readValidatorStakers(transition *state.Transition, validator types.Address) []types.Address { + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(stakersByValidatorSlot).Bytes(), 32)...), + ) + baseHash := types.BytesToHash(base) + lengthRaw := transition.Txn().GetState(staking.AddrStakingContract, baseHash) + length := new(big.Int).SetBytes(lengthRaw[:]).Uint64() + if length == 0 { + return nil + } + + dataBase := keccak.Keccak256(nil, common.PadLeftOrTrim(base, 32)) + idx := new(big.Int).SetBytes(dataBase) + out := make([]types.Address, 0, length) + for i := uint64(0); i < length; i++ { + slot := new(big.Int).Add(idx, new(big.Int).SetUint64(i)) + raw := transition.Txn().GetState(staking.AddrStakingContract, types.BytesToHash(slot.Bytes())) + out = append(out, types.BytesToAddress(raw[12:])) + } + + return out +} + +func readStakerJoinedAtBlock(transition *state.Transition, addr types.Address) uint64 { + raw := transition.Txn().GetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 2)) + return new(big.Int).SetBytes(raw[:]).Uint64() +} + +func readStakerDeactivatedAtBlock(transition *state.Transition, addr types.Address) uint64 { + raw := transition.Txn().GetState(staking.AddrStakingContract, stakerSlotWithOffset(addr, 3)) + return new(big.Int).SetBytes(raw[:]).Uint64() +} + +func isStakerEffectiveAt(transition *state.Transition, addr types.Address, blockNumber, epochSize uint64) bool { + if !isStakerMatureAt(transition, addr, blockNumber, epochSize) { + return false + } + + deact := readStakerDeactivatedAtBlock(transition, addr) + if deact == 0 { + return true + } + + return blockNumber/epochSize <= deact/epochSize +} + +func isStakerMatureAt(transition *state.Transition, addr types.Address, blockNumber, epochSize uint64) bool { + joined := readStakerJoinedAtBlock(transition, addr) + if joined == 0 { + return false + } + if epochSize == 0 { + return readStakerPacked(transition, addr).Bit(8) == 1 + } + return blockNumber/epochSize > joined/epochSize +} + +func stakerSlotWithOffset(addr types.Address, offset int64) types.Hash { + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(addr.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(stakerSlot).Bytes(), 32)...), + ) + idx := new(big.Int).SetBytes(base) + idx.Add(idx, big.NewInt(offset)) + return types.BytesToHash(idx.Bytes()) +} + +func validatorSelfStakeMinWei() *big.Int { + base := new(big.Int).SetUint64(200_000) + wei := new(big.Int).Exp(big.NewInt(10), big.NewInt(18), nil) + return base.Mul(base, wei) +} + +func validatorThresholdWei() *big.Int { + base := new(big.Int).SetUint64(2_000_000) + wei := new(big.Int).Exp(big.NewInt(10), big.NewInt(18), nil) + return base.Mul(base, wei) } diff --git a/validators/store/contract/fetcher_test.go b/validators/store/contract/fetcher_test.go index 8aac3ca..3e27fd6 100644 --- a/validators/store/contract/fetcher_test.go +++ b/validators/store/contract/fetcher_test.go @@ -1,12 +1,15 @@ package contract import ( - "errors" - "fmt" + "math/big" "testing" "github.com/stretchr/testify/assert" - testHelper "github.com/xgr-network/xgr-node/helper/tests" + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/helper/keccak" + stakingHelper "github.com/xgr-network/xgr-node/helper/staking" "github.com/xgr-network/xgr-node/state" "github.com/xgr-network/xgr-node/types" "github.com/xgr-network/xgr-node/validators" @@ -15,128 +18,810 @@ import ( func TestFetchValidators(t *testing.T) { t.Parallel() - // only check error handling because of the duplicated tests below - fakeValidatorType := validators.ValidatorType("fake") - res, err := FetchValidators( - fakeValidatorType, - nil, - types.ZeroAddress, + res, err := FetchValidators(validators.ValidatorType("fake"), nil, types.ZeroAddress) + assert.Nil(t, res) + assert.ErrorContains(t, err, "unsupported validator type") +} + +func TestFetchValidators_UsesTier1WhenTier1MeetsMinValidators(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("2000000000000000000000000")) + setMetaActive(t, transition, addr2, false) - assert.Nil(t, res) - assert.ErrorContains(t, err, fmt.Sprintf("unsupported validator type: %s", fakeValidatorType)) + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)), res) } -func TestFetchECDSAValidators(t *testing.T) { +func TestFetchValidators_UsesTier2WhenTier1BelowMinValidators(t *testing.T) { t.Parallel() - var ( - ecdsaValidators = validators.NewECDSAValidatorSet( - validators.NewECDSAValidator(addr1), - validators.NewECDSAValidator(addr2), - ) + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 2, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("2000000000000000000000000")) + setMetaActive(t, transition, addr2, false) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, vals, res) +} + +func TestFetchValidators_Tier1MaxValidatorsUsesStakeThenAddressOrdering(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + validators.NewECDSAValidator(types.StringToAddress("3")), ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMaxNumValidators(t, transition, 2) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("3000000000000000000000000")) + setMetaStake(t, transition, types.StringToAddress("3"), mustBig("3000000000000000000000000")) - tests := []struct { - name string - transition *state.Transition - from types.Address - expectedRes validators.Validators - expectedErr error - }{ - { - name: "should return error if QueryValidators failed", - transition: newTestTransition( - t, - ), - from: types.ZeroAddress, - expectedRes: nil, - expectedErr: errors.New("empty input"), - }, - { - name: "should return ECDSA Validators", - transition: newTestTransitionWithPredeployedStakingContract( - t, - ecdsaValidators, - ), - from: types.ZeroAddress, - expectedRes: ecdsaValidators, - expectedErr: nil, - }, + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr2), + validators.NewECDSAValidator(types.StringToAddress("3")), + ), res) +} + +func TestFetchValidators_Tier1TieBreakDeterministicByAddressWhenStakeEqual(t *testing.T) { + t.Parallel() + + lowAddr := addr1 + highAddr := addr2 + other := types.StringToAddress("3") + + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(lowAddr), + validators.NewECDSAValidator(highAddr), + validators.NewECDSAValidator(other), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMaxNumValidators(t, transition, 1) + + // strict Tier1 preconditions: active + self >= 200k + effective total >= 2M + selfStake := mustBig("3000000000000000000000000") + for _, addr := range []types.Address{lowAddr, highAddr, other} { + setMetaStake(t, transition, addr, selfStake) } + setMetaStake(t, transition, other, mustBig("1000000000000000000000000")) - for _, test := range tests { - test := test + expectedWinner := lowAddr + for i := 0; i < 5; i++ { + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + require.NoError(t, err) + require.Equal(t, 1, res.Len()) + assert.Equal(t, expectedWinner, res.At(0).Addr(), "run=%d", i) + assert.NotEqual(t, highAddr, res.At(0).Addr(), "run=%d", i) + assert.NotEqual(t, other, res.At(0).Addr(), "run=%d", i) + } +} - t.Run(test.name, func(t *testing.T) { - t.Parallel() +func TestFetchValidators_Tier1TieBreakIgnoresBelowThresholdCandidate(t *testing.T) { + t.Parallel() - res, err := FetchValidators( - validators.ECDSAValidatorType, - test.transition, - test.from, - ) + lowAddr := addr1 + highAddr := addr2 + belowThreshold := types.StringToAddress("3") - assert.Equal(t, test.expectedRes, res) - testHelper.AssertErrorMessageContains(t, test.expectedErr, err) - }) + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(lowAddr), + validators.NewECDSAValidator(highAddr), + validators.NewECDSAValidator(belowThreshold), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMaxNumValidators(t, transition, 2) + + selfStake := mustBig("200000000000000000000000") + for _, addr := range []types.Address{lowAddr, highAddr, belowThreshold} { + setMetaStake(t, transition, addr, selfStake) } + lowDelegator := types.StringToAddress("301") + highDelegator := types.StringToAddress("302") + setStakerAsDelegator(t, transition, lowDelegator, lowAddr, mustBig("1800000000000000000000000"), 1, true) + setStakerAsDelegator(t, transition, highDelegator, highAddr, mustBig("1800000000000000000000000"), 1, true) + setValidatorStakers(t, transition, lowAddr, []types.Address{lowDelegator}) + setValidatorStakers(t, transition, highAddr, []types.Address{highDelegator}) + setValidatorStakers(t, transition, belowThreshold, nil) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + require.NoError(t, err) + require.Equal(t, 2, res.Len()) + assert.Equal(t, lowAddr, res.At(0).Addr()) + assert.Equal(t, highAddr, res.At(1).Addr()) } -func TestFetchBLSValidators(t *testing.T) { +func TestFetchValidators_Tier2MaxValidatorsUsesCurrentDocumentedOrdering(t *testing.T) { t.Parallel() - var ( - blsValidators = validators.NewBLSValidatorSet( - validators.NewBLSValidator(addr1, testBLSPubKey1), - validators.NewBLSValidator(addr2, []byte{}), // validator 2 has not set BLS Public Key - ) + orderedFirst := addr2 + orderedSecond := addr1 + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(orderedFirst), + validators.NewECDSAValidator(orderedSecond), ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 2, MaxValidatorCount: 10, EpochSize: 10}) + setMaxNumValidators(t, transition, 1) + setMetaStake(t, transition, orderedFirst, mustBig("1000000000000000000")) + setMetaStake(t, transition, orderedSecond, mustBig("9000000000000000000000000")) - tests := []struct { - name string - transition *state.Transition - from types.Address - expectedRes validators.Validators - expectedErr error - }{ - { - name: "should return error if QueryValidators failed", - transition: newTestTransition( - t, - ), - from: types.ZeroAddress, - expectedRes: nil, - expectedErr: errors.New("empty input"), - }, - { - name: "should return ECDSA Validators", - transition: newTestTransitionWithPredeployedStakingContract( - t, - blsValidators, - ), - from: types.ZeroAddress, - expectedRes: validators.NewBLSValidatorSet( - validators.NewBLSValidator(addr1, testBLSPubKey1), - ), - expectedErr: nil, - }, + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, validators.NewECDSAValidatorSet(validators.NewECDSAValidator(orderedFirst)), res, "Tier 2 trimming keeps validator-array order") +} + +func TestFetchValidators_UsesTier3WhenTier2BelowMinValidators(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 2, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("2000000000000000000000000")) + setMetaActive(t, transition, addr1, false) + setMetaActive(t, transition, addr2, false) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, vals, res) +} + +func TestFetchValidators_Tier3MaxValidatorsUsesStakeThenAddressOrdering(t *testing.T) { + t.Parallel() + + addr3 := types.StringToAddress("3") + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + validators.NewECDSAValidator(addr3), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 3, MaxValidatorCount: 10, EpochSize: 10}) + setMaxNumValidators(t, transition, 2) + setMetaStake(t, transition, addr1, mustBig("300")) + setMetaStake(t, transition, addr2, mustBig("300")) + setMetaStake(t, transition, addr3, mustBig("100")) + setMetaActive(t, transition, addr1, false) + setMetaActive(t, transition, addr2, false) + setMetaActive(t, transition, addr3, false) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + ), res) +} + +func TestFetchBLSValidators_FilteredByActiveStakeAndBLS(t *testing.T) { + t.Parallel() + + vals := validators.NewBLSValidatorSet( + validators.NewBLSValidator(addr1, testBLSPubKey1), + validators.NewBLSValidator(addr2, testBLSPubKey2), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("2000000000000000000000000")) + setMetaActive(t, transition, addr2, false) + + res, err := FetchBLSValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, validators.NewBLSValidatorSet(validators.NewBLSValidator(addr1, testBLSPubKey1)), res) +} + +func TestFetchBLSValidators_FallbackUsesStakePositiveAndValidBLSWhenActiveSetBelowMin(t *testing.T) { + t.Parallel() + + vals := validators.NewBLSValidatorSet( + validators.NewBLSValidator(addr1, testBLSPubKey1), + validators.NewBLSValidator(addr2, testBLSPubKey2), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 2, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("2000000000000000000000000")) + setMetaActive(t, transition, addr2, false) + + res, err := FetchBLSValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, vals, res) +} + +func TestFetchBLSValidators_FallbackUsesOnlyValidBLSWhenFilteredBelowMinAndInvalidBLSPresent(t *testing.T) { + t.Parallel() + + vals := validators.NewBLSValidatorSet( + validators.NewBLSValidator(addr1, testBLSPubKey1), + validators.NewBLSValidator(addr2, []byte{0x01}), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 5, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("200")) + setMetaStake(t, transition, addr2, mustBig("300")) + setMetaActive(t, transition, addr1, false) + setMetaActive(t, transition, addr2, false) + + res, err := FetchBLSValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, validators.NewBLSValidatorSet(validators.NewBLSValidator(addr1, testBLSPubKey1)), res) +} + +func TestFetchBLSValidators_TrimmedByMaxValidatorCount(t *testing.T) { + t.Parallel() + + vals := validators.NewBLSValidatorSet( + validators.NewBLSValidator(addr1, testBLSPubKey1), + validators.NewBLSValidator(addr2, testBLSPubKey2), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMaxNumValidators(t, transition, 1) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("3000000000000000000000000")) + + res, err := FetchBLSValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, validators.NewBLSValidatorSet(validators.NewBLSValidator(addr2, testBLSPubKey2)), res) +} + +func TestIsEmergencyModeActive_TrueWhenTier1BelowMinimum(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 2, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("1000000000000000000000000")) + + assert.True(t, IsEmergencyModeActive(transition)) +} + +func TestIsEmergencyModeActive_FalseWhenTier1MeetsMinimum(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 2, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("2000000000000000000000000")) + + assert.False(t, IsEmergencyModeActive(transition)) +} + +func TestFetchValidators_UsesSelfPlusActiveDelegatedStakeForThreshold(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 1, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("200000000000000000000000")) // 200k self + setDelegatedActiveStake(t, transition, addr1, mustBig("1800000000000000000000000")) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, vals, res) +} + +func TestFetchValidators_RequiresEffectiveTotalSupportAtLeastThreshold(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("200000000000000000000000")) // 200k self + setDelegatedActiveStake(t, transition, addr1, mustBig("1799999999999999999999999")) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + require.NoError(t, err) + assert.Equal(t, 0, res.Len()) +} + +func TestFetchValidators_RequiresSelfValidatorPosition(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + + // Simulate non-self staker by changing validator pointer at _staker[addr1].validator (base + 4). + transition.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffsetTest(addr1, 4), types.BytesToHash(addr2.Bytes())) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + assert.NoError(t, err) + assert.Equal(t, 0, res.Len()) +} + +func TestFetchValidators_DelegatorNeverBecomesValidatorCandidate(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("200000000000000000000000")) + + delegator := types.StringToAddress("0x335") + setStakerAsDelegator(t, transition, delegator, addr1, mustBig("5000000000000000000000000"), 1, true) + setValidatorStakers(t, transition, addr1, []types.Address{addr1, delegator}) + + // Simulate accidental listing in validators() storage - fetcher must still filter by self-position. + setValidatorUniverse(t, transition, []types.Address{addr1, delegator}) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + require.NoError(t, err) + require.Equal(t, 1, res.Len()) + assert.Equal(t, addr1, res.At(0).Addr()) +} + +func TestFetchValidators_RequiresValidatorMinSelfStakeEvenWithHighDelegation(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("199999999999999999999999")) // just below 200k + + delegator := types.StringToAddress("0x336") + setStakerAsDelegator(t, transition, delegator, addr1, mustBig("5000000000000000000000000"), 1, true) + setValidatorStakers(t, transition, addr1, []types.Address{delegator}) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + require.NoError(t, err) + assert.Equal(t, 0, res.Len()) +} + +func TestReadValidatorEffectiveTotalStakeAt_NewValidatorCountsFromNextEpoch(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setStakerJoinedAt(t, transition, addr1, 19) + setStakerValidator(t, transition, addr1, addr1) + + sameEpoch := ReadValidatorEffectiveTotalStakeAt(transition, addr1, 19) + nextEpoch := ReadValidatorEffectiveTotalStakeAt(transition, addr1, 20) + + assert.Equal(t, 0, sameEpoch.Sign()) + assert.Equal(t, mustBig("2000000000000000000000000"), nextEpoch) +} + +func TestReadValidatorEffectiveTotalStakeAt_NewDelegatorCountsFromNextEpoch(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + delegator := types.StringToAddress("0x333") + setStakerAsDelegator(t, transition, delegator, addr1, mustBig("10000000000000000000000"), 19, true) // 10k at block 19 + setValidatorStakers(t, transition, addr1, []types.Address{delegator}) + + // same epoch as join (epoch 1) => not effective + sameEpoch := ReadValidatorEffectiveTotalStakeAt(transition, addr1, 19) + // next epoch => effective + nextEpoch := ReadValidatorEffectiveTotalStakeAt(transition, addr1, 20) + + assert.Equal(t, mustBig("10"), sameEpoch) // bootstrap self stake + assert.Equal(t, mustBig("10000000000000000000010"), nextEpoch) +} + +func TestReadValidatorEffectiveTotalStakeAt_DeactivationEffectiveAtEpochBoundary(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + delegator := types.StringToAddress("0x334") + setStakerAsDelegator(t, transition, delegator, addr1, mustBig("10000000000000000000000"), 9, true) + setValidatorStakers(t, transition, addr1, []types.Address{delegator}) + + // deactivate in epoch 2 -> still counted in epoch 2, excluded from epoch 3 + setStakerDeactivatedAt(t, transition, delegator, 21) + beforeBoundary := ReadValidatorEffectiveTotalStakeAt(transition, addr1, 29) + afterBoundary := ReadValidatorEffectiveTotalStakeAt(transition, addr1, 30) + + assert.Equal(t, mustBig("10000000000000000000010"), beforeBoundary) + assert.Equal(t, mustBig("10"), afterBoundary) +} + +func TestReadValidatorEffectiveTotalStakeAt_DeactivationInsideEpochRemainsEffectiveUntilNextEpoch(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + delegator := types.StringToAddress("0x335") + setStakerAsDelegator(t, transition, delegator, addr1, mustBig("10000000000000000000000"), 8, true) + setValidatorStakers(t, transition, addr1, []types.Address{delegator}) + setStakerDeactivatedAt(t, transition, delegator, 19) + + // Deactivation at block 19 (epoch 1) remains epoch-effective through block 19. + assert.Equal(t, mustBig("10000000000000000000010"), ReadValidatorEffectiveTotalStakeAt(transition, addr1, 19)) + // From epoch 2 onward this delegator is no longer epoch-effective. + assert.Equal(t, mustBig("10"), ReadValidatorEffectiveTotalStakeAt(transition, addr1, 20)) + assert.Equal(t, mustBig("10"), ReadValidatorEffectiveTotalStakeAt(transition, addr1, 29)) +} + +func TestReadValidatorVotingStakeAt_DeactivatedValidatorStillCountsStake(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + setMetaStake(t, transition, addr1, mustBig("10")) + setStakerValidator(t, transition, addr1, addr1) + setStakerJoinedAt(t, transition, addr1, 1) + setMetaActive(t, transition, addr1, false) + setStakerDeactivatedAt(t, transition, addr1, 21) + + effective := ReadValidatorEffectiveTotalStakeAt(transition, addr1, 30) + voting := ReadValidatorVotingStakeAt(transition, addr1, 30) + + assert.Equal(t, 0, effective.Sign()) + assert.Equal(t, mustBig("10"), voting) +} + +func TestReadValidatorVotingStakeAt_DeactivatedValidatorWithActiveDelegator(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + delegator := types.StringToAddress("0x334") + setStakerAsDelegator(t, transition, delegator, addr1, mustBig("100"), 9, true) + setValidatorStakers(t, transition, addr1, []types.Address{delegator}) + + setMetaStake(t, transition, addr1, mustBig("10")) + setStakerValidator(t, transition, addr1, addr1) + setStakerJoinedAt(t, transition, addr1, 1) + setMetaActive(t, transition, addr1, false) + setStakerDeactivatedAt(t, transition, addr1, 21) + + assert.Equal(t, mustBig("110"), ReadValidatorVotingStakeAt(transition, addr1, 30)) +} + +func TestReadValidatorVotingStakeAt_DeactivatedValidatorWithDeactivatedDelegator(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + delegator := types.StringToAddress("0x334") + setStakerAsDelegator(t, transition, delegator, addr1, mustBig("100"), 9, true) + setStakerDeactivatedAt(t, transition, delegator, 21) + setValidatorStakers(t, transition, addr1, []types.Address{delegator}) + + setMetaStake(t, transition, addr1, mustBig("10")) + setStakerValidator(t, transition, addr1, addr1) + setStakerJoinedAt(t, transition, addr1, 1) + setMetaActive(t, transition, addr1, false) + setStakerDeactivatedAt(t, transition, addr1, 21) + + assert.Equal(t, mustBig("10"), ReadValidatorVotingStakeAt(transition, addr1, 30)) +} + +func TestReadValidatorVotingStakeAt_RawSelfStakeCountsWithoutJoinMaturity(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + setMetaStake(t, transition, addr1, mustBig("10")) + setStakerValidator(t, transition, addr1, addr1) + setStakerJoinedAt(t, transition, addr1, 25) + setMetaActive(t, transition, addr1, true) + + assert.Equal(t, 0, ReadValidatorEffectiveTotalStakeAt(transition, addr1, 29).Sign()) + assert.Equal(t, mustBig("10"), ReadValidatorVotingStakeAt(transition, addr1, 29)) +} + +func TestReadValidatorVotingStakeAt_MissingSelfMappingOrRawStakeReturnsZero(t *testing.T) { + t.Parallel() + + vals := validators.NewECDSAValidatorSet(validators.NewECDSAValidator(addr1)) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 0, MaxValidatorCount: 10, EpochSize: 10}) + + setMetaStake(t, transition, addr1, mustBig("0")) + setStakerValidator(t, transition, addr1, types.ZeroAddress) + + assert.Equal(t, 0, ReadValidatorVotingStakeAt(transition, addr1, 30).Sign()) +} + +func newTransitionWithParams(t *testing.T, vals validators.Validators, params stakingHelper.PredeployParams) *state.Transition { + t.Helper() + transition := newTestTransition(t) + + contractState, err := stakingHelper.PredeployStakingSC(vals, params) + assert.NoError(t, err) + assert.NoError(t, transition.SetAccountDirectly(staking.AddrStakingContract, contractState)) + transition.ContextPtr().Number = int64(params.EpochSize * 2) + + return transition +} + +func setMetaStake(t *testing.T, transition *state.Transition, addr types.Address, stake *big.Int) { + t.Helper() + key := stakerSlotWithOffsetTest(addr, 1) + transition.Txn().SetState(staking.AddrStakingContract, key, types.BytesToHash(stake.Bytes())) +} + +func setMetaActive(t *testing.T, transition *state.Transition, addr types.Address, active bool) { + t.Helper() + key := stakerSlotWithOffsetTest(addr, 0) + cur := transition.Txn().GetState(staking.AddrStakingContract, key) + v := new(big.Int).SetBytes(cur[:]) + if active { + v.Or(v, new(big.Int).Lsh(big.NewInt(1), 8)) + } else { + mask := new(big.Int).Lsh(big.NewInt(1), 8) + mask.Not(mask) + v.And(v, mask) } + transition.Txn().SetState(staking.AddrStakingContract, key, types.BytesToHash(v.Bytes())) +} - for _, test := range tests { - test := test +func setMaxNumValidators(t *testing.T, transition *state.Transition, max uint64) { + t.Helper() - t.Run(test.name, func(t *testing.T) { - t.Parallel() + key := types.BytesToHash(big.NewInt(1).Bytes()) + raw := transition.Txn().GetState(staking.AddrStakingContract, key) + v := new(big.Int).SetBytes(raw[:]) - res, err := FetchValidators( - validators.BLSValidatorType, - test.transition, - test.from, - ) + // clear max (bits [128..191]) + mask64 := new(big.Int).SetUint64(^uint64(0)) + clearMask := new(big.Int).Lsh(mask64, 128) + clearMask.Not(clearMask) + v.And(v, clearMask) - assert.Equal(t, test.expectedRes, res) - testHelper.AssertErrorMessageContains(t, test.expectedErr, err) + maxShifted := new(big.Int).Lsh(new(big.Int).SetUint64(max), 128) + v.Or(v, maxShifted) + + transition.Txn().SetState(staking.AddrStakingContract, key, types.BytesToHash(v.Bytes())) +} + +func stakerSlotWithOffsetTest(addr types.Address, offset int64) types.Hash { + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(addr.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(3).Bytes(), 32)...), + ) + idx := new(big.Int).SetBytes(base) + idx.Add(idx, big.NewInt(offset)) + return types.BytesToHash(idx.Bytes()) +} + +func setDelegatedActiveStake(t *testing.T, transition *state.Transition, validator types.Address, amount *big.Int) { + t.Helper() + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(9).Bytes(), 32)...), + ) + transition.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(base), types.BytesToHash(amount.Bytes())) +} + +func setStakerAsDelegator( + t *testing.T, + transition *state.Transition, + delegator types.Address, + validator types.Address, + amount *big.Int, + joinedAt uint64, + active bool, +) { + t.Helper() + + setMetaStake(t, transition, delegator, amount) + setMetaActive(t, transition, delegator, active) + setStakerValidator(t, transition, delegator, validator) + setStakerJoinedAt(t, transition, delegator, joinedAt) +} + +func setStakerValidator(t *testing.T, transition *state.Transition, addr, validator types.Address) { + t.Helper() + transition.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffsetTest(addr, 4), types.BytesToHash(validator.Bytes())) +} + +func setStakerJoinedAt(t *testing.T, transition *state.Transition, addr types.Address, joinedAt uint64) { + t.Helper() + transition.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffsetTest(addr, 2), types.BytesToHash(new(big.Int).SetUint64(joinedAt).Bytes())) +} + +func setStakerDeactivatedAt(t *testing.T, transition *state.Transition, addr types.Address, deactivatedAt uint64) { + t.Helper() + transition.Txn().SetState(staking.AddrStakingContract, stakerSlotWithOffsetTest(addr, 3), types.BytesToHash(new(big.Int).SetUint64(deactivatedAt).Bytes())) +} + +func setValidatorStakers(t *testing.T, transition *state.Transition, validator types.Address, stakers []types.Address) { + t.Helper() + + base := keccak.Keccak256(nil, + append(common.PadLeftOrTrim(validator.Bytes(), 32), common.PadLeftOrTrim(big.NewInt(stakersByValidatorSlot).Bytes(), 32)...), + ) + transition.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(base), types.BytesToHash(new(big.Int).SetUint64(uint64(len(stakers))).Bytes())) + + dataBase := keccak.Keccak256(nil, common.PadLeftOrTrim(base, 32)) + idx := new(big.Int).SetBytes(dataBase) + for i, staker := range stakers { + slot := new(big.Int).Add(idx, new(big.Int).SetUint64(uint64(i))) + transition.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(slot.Bytes()), types.BytesToHash(staker.Bytes())) + } +} + +func setValidatorUniverse(t *testing.T, transition *state.Transition, vals []types.Address) { + t.Helper() + + lenSlot := types.BytesToHash(big.NewInt(validatorsSlot).Bytes()) + transition.Txn().SetState(staking.AddrStakingContract, lenSlot, types.BytesToHash(new(big.Int).SetUint64(uint64(len(vals))).Bytes())) + + base := keccak.Keccak256(nil, common.PadLeftOrTrim(big.NewInt(validatorsSlot).Bytes(), 32)) + idx := new(big.Int).SetBytes(base) + for i, v := range vals { + slot := new(big.Int).Add(idx, new(big.Int).SetUint64(uint64(i))) + transition.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(slot.Bytes()), types.BytesToHash(v.Bytes())) + } +} + +func mustBig(v string) *big.Int { + b, ok := new(big.Int).SetString(v, 10) + if !ok { + panic("invalid big int") + } + return b +} + +func TestFetchECDSAValidators_EmergencyFallbackDeterministicRegression(t *testing.T) { + t.Parallel() + + addr3 := types.StringToAddress("3") + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + validators.NewECDSAValidator(addr3), + ) + + t.Run("strict eligible below min falls back to active validators when active count meets min", func(t *testing.T) { + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 2, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("1")) + setMetaStake(t, transition, addr3, mustBig("1")) + setMetaActive(t, transition, addr3, false) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + require.NoError(t, err) + require.Equal(t, validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + ), res) + }) + + t.Run("active count below min falls back to weighted stake with address tie break and max trim", func(t *testing.T) { + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 3, MaxValidatorCount: 10, EpochSize: 10}) + setMaxNumValidators(t, transition, 2) + setMetaStake(t, transition, addr1, mustBig("100")) + setMetaStake(t, transition, addr2, mustBig("300")) + setMetaStake(t, transition, addr3, mustBig("300")) + setMetaActive(t, transition, addr1, false) + setMetaActive(t, transition, addr2, false) + setMetaActive(t, transition, addr3, false) + + for i := 0; i < 5; i++ { + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + require.NoError(t, err) + require.Equal(t, validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr2), + validators.NewECDSAValidator(addr3), + ), res, "run=%d", i) + } + }) +} + +func TestFetchBLSValidators_EmergencyFallbackDeterministicAndInvalidKeys(t *testing.T) { + t.Parallel() + + addr3 := types.StringToAddress("3") + invalidBLS := []byte{0x01, 0x02, 0x03} + + t.Run("invalid active staked BLS key is skipped without panic and active fallback stays deterministic", func(t *testing.T) { + vals := validators.NewBLSValidatorSet( + validators.NewBLSValidator(addr1, testBLSPubKey1), + validators.NewBLSValidator(addr2, invalidBLS), + validators.NewBLSValidator(addr3, testBLSPubKey2), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 2, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("9000000000000000000000000")) + setMetaStake(t, transition, addr3, mustBig("1")) + + require.NotPanics(t, func() { + res, err := FetchBLSValidators(transition, types.ZeroAddress) + require.NoError(t, err) + require.Equal(t, validators.NewBLSValidatorSet( + validators.NewBLSValidator(addr1, testBLSPubKey1), + validators.NewBLSValidator(addr3, testBLSPubKey2), + ), res) }) + }) + + t.Run("weighted emergency fallback ignores invalid key and trims equal stake by address", func(t *testing.T) { + vals := validators.NewBLSValidatorSet( + validators.NewBLSValidator(addr1, testBLSPubKey1), + validators.NewBLSValidator(addr2, invalidBLS), + validators.NewBLSValidator(addr3, testBLSPubKey2), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 3, MaxValidatorCount: 10, EpochSize: 10}) + setMaxNumValidators(t, transition, 1) + setMetaStake(t, transition, addr1, mustBig("300")) + setMetaStake(t, transition, addr2, mustBig("1000000")) + setMetaStake(t, transition, addr3, mustBig("300")) + setMetaActive(t, transition, addr1, false) + setMetaActive(t, transition, addr2, false) + setMetaActive(t, transition, addr3, false) + + for i := 0; i < 5; i++ { + res, err := FetchBLSValidators(transition, types.ZeroAddress) + require.NoError(t, err) + require.Equal(t, validators.NewBLSValidatorSet(validators.NewBLSValidator(addr1, testBLSPubKey1)), res, "run=%d", i) + } + }) +} + +func TestFetchValidators_RemoveValidatorSwapPopOrderAndTrimRemainDeterministic(t *testing.T) { + t.Parallel() + + addr3 := types.StringToAddress("3") + addr4 := types.StringToAddress("4") + vals := validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr2), + validators.NewECDSAValidator(addr3), + validators.NewECDSAValidator(addr4), + ) + transition := newTransitionWithParams(t, vals, stakingHelper.PredeployParams{MinValidatorCount: 4, MaxValidatorCount: 10, EpochSize: 10}) + setMetaStake(t, transition, addr1, mustBig("4000000000000000000000000")) + setMetaStake(t, transition, addr2, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr3, mustBig("2000000000000000000000000")) + setMetaStake(t, transition, addr4, mustBig("3000000000000000000000000")) + + removeValidatorSwapPopForTest(t, transition, addr2) + setMaxNumValidators(t, transition, 2) + + res, err := FetchECDSAValidators(transition, types.ZeroAddress) + require.NoError(t, err) + require.Equal(t, validators.NewECDSAValidatorSet( + validators.NewECDSAValidator(addr1), + validators.NewECDSAValidator(addr4), + ), res) + require.Equal(t, addr4, readValidators(transition)[1], "middle removal must swap-pop the previous tail into the removed slot") + require.Equal(t, []types.Address{addr1, addr4}, []types.Address{res.At(0).Addr(), res.At(1).Addr()}, "proposer calculation inputs must remain stable after removal and max trim") +} + +func removeValidatorSwapPopForTest(t *testing.T, transition *state.Transition, removed types.Address) { + t.Helper() + + vals := readValidators(transition) + idx := -1 + for i, addr := range vals { + if addr == removed { + idx = i + break + } + } + require.NotEqual(t, -1, idx) + last := len(vals) - 1 + if idx != last { + vals[idx] = vals[last] } + vals = vals[:last] + setValidatorUniverse(t, transition, vals) } diff --git a/validators/store/contract/minstake_test.go b/validators/store/contract/minstake_test.go new file mode 100644 index 0000000..068de4f --- /dev/null +++ b/validators/store/contract/minstake_test.go @@ -0,0 +1,151 @@ +package contract + +import ( + "math/big" + "os" + "regexp" + "strings" + "testing" + + "github.com/hashicorp/go-hclog" + "github.com/stretchr/testify/require" + "github.com/xgr-network/xgr-node/chain" + "github.com/xgr-network/xgr-node/contracts/staking" + "github.com/xgr-network/xgr-node/helper/common" + "github.com/xgr-network/xgr-node/helper/keccak" + "github.com/xgr-network/xgr-node/state" + itrie "github.com/xgr-network/xgr-node/state/immutable-trie" + "github.com/xgr-network/xgr-node/types" +) + +func TestStakingV2StorageSlotsRemainAlignedWithContractLayout(t *testing.T) { + t.Parallel() + + // These constants must match the deployed StakingV2 bytecode layout used by E2E. + require.Equal(t, int64(6), stakersByValidatorSlot) + require.Equal(t, int64(9), validatorDelegatedActiveSlot) +} + +func TestStakingV2StorageSlotsMatchSolidityDeclarationOrder(t *testing.T) { + t.Parallel() + + source, err := os.ReadFile("../../../contracts/staking/StakingV2.sol") + require.NoError(t, err) + + layout := stakingV2DeclaredStorageLayout(string(source)) + for name, slot := range map[string]int64{ + "VALIDATOR_THRESHOLD": validatorThresholdSlot, + "packedConfig(epochSize,min,max)": configSlot, + "_validators": validatorsSlot, + "_staker": stakerSlot, + "_stakersByValidator": stakersByValidatorSlot, + "_validatorDelegatedStakeActive": validatorDelegatedActiveSlot, + } { + require.Equal(t, slot, layout[name], name) + } +} +func stakingV2DeclaredStorageLayout(source string) map[string]int64 { + re := regexp.MustCompile(`(?m)^\s*(?:uint256|uint64|address\[\]|mapping\([^;]+\)|uint16|bool|bytes)\s+(?:public|private|internal)?\s*([A-Za-z_][A-Za-z0-9_]*)\s*;`) + matches := re.FindAllStringSubmatch(source, -1) + out := make(map[string]int64) + slot := int64(0) + configPacked := false + for _, match := range matches { + name := match[1] + if strings.HasSuffix(name, "TOTAL") || strings.HasPrefix(name, "VALIDATOR_MIN_") || strings.HasPrefix(name, "DELEGATOR_MIN_") || name == "MAX_DELEGATORS_PER_VALIDATOR" || name == "MIN_STAKE" { + continue + } + + switch name { + case "VALIDATOR_THRESHOLD": + out[name] = slot + slot++ + case "epochSize", "minNumValidators", "maxNumValidators": + if !configPacked { + out["packedConfig(epochSize,min,max)"] = slot + slot++ + configPacked = true + } + case "_validators", "_staker", "_stakers", "_poolConfig", "_stakersByValidator", "_stakerIndexPlusOneByValidator", "_validatorDelegatedStakeRaw", "_validatorDelegatedStakeActive", "_reentrancyStatus": + out[name] = slot + slot++ + } + } + + return out +} + +func TestReadValidatorDelegatedStakeActiveUsesSlot9(t *testing.T) { + t.Parallel() + + tx := newFetcherTestTransition(t) + validator := types.StringToAddress("0x1001") + + slot6 := storageMappingSlot(validator, 6) + slot9 := storageMappingSlot(validator, validatorDelegatedActiveSlot) + + tx.Txn().SetState(staking.AddrStakingContract, slot6, types.BytesToHash(big.NewInt(123).Bytes())) + tx.Txn().SetState(staking.AddrStakingContract, slot9, types.BytesToHash(big.NewInt(999).Bytes())) + + require.Equal(t, big.NewInt(999), readValidatorDelegatedStakeActive(tx, validator)) +} + +func TestReadValidatorStakersUsesSlot6(t *testing.T) { + t.Parallel() + + tx := newFetcherTestTransition(t) + validator := types.StringToAddress("0x1002") + delegator := types.StringToAddress("0x2002") + + base := storageMappingSlotBytes(validator, stakersByValidatorSlot) + baseHash := types.BytesToHash(base) + dataBase := keccak.Keccak256(nil, common.PadLeftOrTrim(base, 32)) + + tx.Txn().SetState(staking.AddrStakingContract, baseHash, types.BytesToHash(big.NewInt(1).Bytes())) + tx.Txn().SetState(staking.AddrStakingContract, types.BytesToHash(dataBase), types.BytesToHash(delegator.Bytes())) + + require.Equal(t, []types.Address{delegator}, readValidatorStakers(tx, validator)) +} + +func storageMappingSlot(addr types.Address, slot int64) types.Hash { + return types.BytesToHash(storageMappingSlotBytes(addr, slot)) +} + +func storageMappingSlotBytes(addr types.Address, slot int64) []byte { + return keccak.Keccak256(nil, + append( + common.PadLeftOrTrim(addr.Bytes(), 32), + common.PadLeftOrTrim(big.NewInt(slot).Bytes(), 32)..., + ), + ) +} + +func newFetcherTestTransition(t *testing.T) *state.Transition { + t.Helper() + + st := itrie.NewState(itrie.NewMemoryStorage()) + ex := state.NewExecutor(&chain.Params{ + Forks: chain.AllForksEnabled, + BurnContract: map[uint64]types.Address{ + 0: types.ZeroAddress, + }, + }, st, hclog.NewNullLogger()) + + root, err := ex.WriteGenesis(nil, types.Hash{}) + require.NoError(t, err) + + ex.GetHash = func(h *types.Header) state.GetHashByNumber { + return func(uint64) types.Hash { + return root + } + } + + tx, err := ex.BeginTxn( + root, + &types.Header{}, + types.ZeroAddress, + ) + require.NoError(t, err) + + return tx +}