You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
98 lines
3.2 KiB
98 lines
3.2 KiB
// Package shardingconfig defines types and utilities that deal with Harmony
|
|
// sharding configuration schedule.
|
|
package shardingconfig
|
|
|
|
import (
|
|
"fmt"
|
|
"math/big"
|
|
|
|
"github.com/harmony-one/harmony/crypto/bls"
|
|
"github.com/harmony-one/harmony/numeric"
|
|
|
|
"github.com/harmony-one/harmony/internal/genesis"
|
|
)
|
|
|
|
// Schedule returns the sharding configuration instance for the given
|
|
// epoch.
|
|
type Schedule interface {
|
|
InstanceForEpoch(epoch *big.Int) Instance
|
|
|
|
// CalcEpochNumber returns the epoch number based on the block number
|
|
CalcEpochNumber(blockNum uint64) *big.Int
|
|
|
|
// IsLastBlock check if the block is the last block in the epoch
|
|
// NOTE: This method is very critical for the epoch transition logic and other checks.
|
|
IsLastBlock(blockNum uint64) bool
|
|
|
|
// EpochLastBlock returns the last block number of an epoch
|
|
// NOTE: This method id important for a few rpcs and validator APR calculation
|
|
EpochLastBlock(epochNum uint64) uint64
|
|
|
|
// VDFDifficulty returns number of iterations for VDF calculation
|
|
VdfDifficulty() int
|
|
|
|
// GetNetworkID() return networkID type.
|
|
GetNetworkID() NetworkID
|
|
|
|
// GetShardingStructure returns sharding structure.
|
|
GetShardingStructure(int, int) []map[string]interface{}
|
|
|
|
// IsSkippedEpoch returns if epoch was skipped on shard chain
|
|
IsSkippedEpoch(uint32, *big.Int) bool
|
|
}
|
|
|
|
// Instance is one sharding configuration instance.
|
|
type Instance interface {
|
|
// NumShards returns the number of shards in the network.
|
|
NumShards() uint32
|
|
|
|
// NumNodesPerShard returns number of nodes in each shard.
|
|
NumNodesPerShard() int
|
|
|
|
// NumHarmonyOperatedNodesPerShard returns number of nodes in each shard
|
|
// that are operated by Harmony.
|
|
NumHarmonyOperatedNodesPerShard() int
|
|
|
|
// HarmonyVotePercent returns total percentage of voting power harmony nodes possess.
|
|
HarmonyVotePercent() numeric.Dec
|
|
|
|
// ExternalVotePercent returns total percentage of voting power external validators possess.
|
|
ExternalVotePercent() numeric.Dec
|
|
|
|
// HmyAccounts returns a list of Harmony accounts
|
|
HmyAccounts() []genesis.DeployAccount
|
|
|
|
// FnAccounts returns a list of Foundational node accounts
|
|
FnAccounts() []genesis.DeployAccount
|
|
|
|
// FindAccount returns the deploy account based on the blskey
|
|
FindAccount(blsPubKey string) (bool, *genesis.DeployAccount)
|
|
|
|
// ReshardingEpoch returns a list of Epoch while off-chain resharding happens
|
|
ReshardingEpoch() []*big.Int
|
|
|
|
// Count of blocks per epoch
|
|
BlocksPerEpoch() uint64
|
|
// HIP-16: The absolute number of maximum effective slots per shard limit for each validator. 0 means no limit.
|
|
SlotsLimit() int
|
|
|
|
// ExternalAllowlist returns the list of external leader keys in allowlist(HIP18)
|
|
ExternalAllowlist() []bls.PublicKeyWrapper
|
|
|
|
// ExternalAllowlistLimit returns the maximum number of external leader keys on each shard(HIP18)
|
|
ExternalAllowlistLimit() int
|
|
}
|
|
|
|
// genShardingStructure return sharding structure, given shard number and its patterns.
|
|
func genShardingStructure(shardNum, shardID int, httpPattern, wsPattern string) []map[string]interface{} {
|
|
res := []map[string]interface{}{}
|
|
for i := 0; i < shardNum; i++ {
|
|
res = append(res, map[string]interface{}{
|
|
"current": int(shardID) == i,
|
|
"shardID": i,
|
|
"http": fmt.Sprintf(httpPattern, i),
|
|
"ws": fmt.Sprintf(wsPattern, i),
|
|
})
|
|
}
|
|
return res
|
|
}
|
|
|