path: root/eth/config.go

// Copyright 2017 The go-ethereum Authors
// This file is part of the go-ethereum library.
//
// The go-ethereum library is free software: you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// The go-ethereum library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.

package eth

import (
    "math/big"
    "os"
    "os/user"
    "path/filepath"
    "runtime"

    "github.com/ethereum/go-ethereum/common"
    "github.com/ethereum/go-ethereum/common/hexutil"
    "github.com/ethereum/go-ethereum/core"
    "github.com/ethereum/go-ethereum/eth/downloader"
    "github.com/ethereum/go-ethereum/eth/gasprice"
    "github.com/ethereum/go-ethereum/params"
)

// DefaultConfig contains default settings for use on the Ethereum main net.
var DefaultConfig = Config{
    SyncMode:             downloader.FastSync,
    EthashCacheDir:       "ethash",
    EthashCachesInMem:    2,
    EthashCachesOnDisk:   3,
    EthashDatasetsInMem:  1,
    EthashDatasetsOnDisk: 2,
    NetworkId:            1,
    LightPeers:           20,
    DatabaseCache:        128,
    GasPrice:             big.NewInt(18 * params.Shannon),

    GPO: gasprice.Config{
        Blocks:     10,
        Percentile: 50,
    },
}

func init() {
    home := os.Getenv("HOME")
    if home == "" {
        if user, err := user.Current(); err == nil {
            home = user.HomeDir
        }
    }
    if runtime.GOOS == "windows" {
        DefaultConfig.EthashDatasetDir = filepath.Join(home, "AppData", "Ethash")
    } else {
        DefaultConfig.EthashDatasetDir = filepath.Join(home, ".ethash")
    }
}

//go:generate gencodec -type Config -field-override configMarshaling -formats toml -out gen_config.go

type Config struct {
    // The genesis block, which is inserted if the database is empty.
    // If nil, the Ethereum main net block is used.
    Genesis *core.Genesis `toml:",omitempty"`

    // Protocol options
    NetworkId uint64 // Network ID to use for selecting peers to connect to
    SyncMode  downloader.SyncMode

    // Light client options
    LightServ  int `toml:",omitempty"` // Maximum percentage of time allowed for serving LES requests
    LightPeers int `toml:",omitempty"` // Maximum number of LES client peers
    MaxPeers   int `toml:"-"`          // Maximum number of global peers

    // Database options
    SkipBcVersionCheck bool `toml:"-"`
    DatabaseHandles    int  `toml:"-"`
    DatabaseCache      int

    // Mining-related options
    Etherbase    common.Address `toml:",omitempty"`
    MinerThreads int            `toml:",omitempty"`
    ExtraData    []byte         `toml:",omitempty"`
    GasPrice     *big.Int

    // Ethash options
    EthashCacheDir       string
    EthashCachesInMem    int
    EthashCachesOnDisk   int
    EthashDatasetDir     string
    EthashDatasetsInMem  int
    EthashDatasetsOnDisk int

    // Gas Price Oracle options
    GPO gasprice.Config

    // Enables tracking of SHA3 preimages in the VM
    EnablePreimageRecording bool

    // Miscellaneous options
    DocRoot   string `toml:"-"`
    PowFake   bool   `toml:"-"`
    PowTest   bool   `toml:"-"`
    PowShared bool   `toml:"-"`
}

type configMarshaling struct {
    ExtraData hexutil.Bytes
}