BfcStaking

Description

바이프로스트 노드의 핵심 DPoS (위임 지분 증명) 합의 메커니즘은 pallet_bfc_staking에 정의되어 있습니다. pallet_bfc_staking은 검증자 (validator)와 지명자 (nominator)의 개념을 정의하고 이들의 자체 스테이킹 (self-bonds) 및 지명 (nominations)을 관리하는 사용자 정의 팔렛입니다. 또한 라운드 (rounds) 개념과 라운드 내의 로직도 정의합니다.

Extrinsics

set_staking_expectations(expectations: Range<BalanceOf>)

  • interface: api.tx.bfcStaking.setStakingExpectations

  • summary: 총 스테이킹 기대치를 설정합니다. 이 기대치는 해당 라운드의 발행량을 결정합니다. 오리진은 루트 (root)여야 합니다.

set_inflation(schedule: Range<Perbill>)

  • interface: api.tx.bfcStaking.setInflation

  • summary: 라운드별 인플레이션을 도출하기 위한 연간 인플레이션율을 설정합니다. 오리진은 루트 (root)여야 합니다.

set_max_full_selected(new: u32)

  • interface: api.tx.bfcStaking.setMaxFullSelected

  • summary: 라운드당 선택되는 풀 검증자 후보의 최대 수를 설정합니다. 오리진은 루트 (root)여야 합니다.

set_basic_full_selected(new: u32)

  • interface: api.tx.bfcStaking.setMaxBasicSelected

  • summary: 라운드당 선택되는 기본 검증자 후보의 최대 수를 설정합니다. 오리진은 루트 (root)여야 합니다.

set_min_total_selected(new: u32)

  • interface: api.tx.bfcStaking.setMinTotalSelected

  • summary: 라운드당 선택되는 검증자 후보의 최소 수를 설정합니다. 오리진은 루트 (root)여야 합니다.

set_default_validator_commission(new: Perbill, tier: TierType)

  • interface: api.tx.bfcStaking.setDefaultValidatorCommission

  • summary: 주어진 티어(tier)의 모든 검증자에 대한 기본 수수료율을 설정합니다. 오리진은 루트 (root)여야 합니다.

set_max_validator_commission(new: Perbill, tier: TierType)

  • interface: api.tx.bfcStaking.setMaxValidatorCommission

  • summary: 주어진 티어(tier)의 모든 검증자에 대한 최대 수수료율을 설정합니다. 오리진은 루트 (root)여야 합니다.

set_validator_commission(new: Perbill)

  • interface: api.tx.bfcStaking.setValidatorCommission

  • summary: 주어진 검증자의 수수료율을 설정합니다. 오리진은 컨트롤러 계정 (controller account)이어야 합니다.

set_validator_tier(more: BalanceOf, new: TierType, relayer?: AccountId)

  • interface: api.tx.bfcStaking.setValidatorTier

  • summary: 검증자 후보 티어(tier)를 수정합니다. 실제 상태 반영은 다음 라운드에 적용됩니다. 오리진은 스태시 계정(stash account)이어야 합니다.

set_blocks_per_round(new: u32)

  • interface: api.tx.bfcStaking.setBlocksPerRound

  • summary: 라운드당 블록 수를 설정합니다. 새로운 라운드 길이는 다음 블록에서 즉시 업데이트됩니다. 이는 라운드당 인플레이션 설정도 업데이트합니다. 오리진은 루트 (root)여야 합니다.

set_storage_cache_lifetime(new: u32)

  • interface: api.tx.bfcStaking.setStorageCacheLifetime

  • summary: StorageCacheLifetime 라운드 길이를 설정합니다. 오리진은 루트 (root)여야 합니다.

join_candidates(controller: AccountId, relayer?: AccountId, bond: BalanceOf, candidate_count: u32)

  • interface: api.tx.bfcStaking.joinCandidates

  • summary: 검증자 후보 집합에 합류합니다. 오리진은 스태시 계정 (stash account)이어야 합니다.

schedule_leave_candidates(candidate_count: u32)

  • interface: api.tx.bfcStaking.scheduleLeaveCandidates

  • summary: 후보 집합을 떠날 것을 요청합니다. 성공 시, 해당 계정은 검증자로 선택되는 것을 방지하기 위해 후보 풀에서 즉시 제거됩니다. 오리진은 컨트롤러 계정 (controller account)이어야 합니다.

execute_leave_candidates(candidate_nomination_count: u32)

  • interface: api.tx.bfcStaking.executeLeaveCandidates

  • summary: 후보 떠나기 요청을 실행합니다. 오리진은 스태시 계정 (stash account)이어야 합니다.

cancel_leave_candidates(candidate_count: u32)

  • interface: api.tx.bfcStaking.cancelLeaveCandidates

  • summary: 후보 떠나기 보류 중인 요청을 취소합니다. 오리진은 컨트롤러 계정 (controller account)이어야 합니다.

set_controller(new: AccountId)

  • interface: api.tx.bfcStaking.setController

  • summary: 본딩된 컨트롤러 계정을 (재)설정합니다. 오리진은 본딩된 스태시 계정 (stash account)이어야 합니다. 실제 변경 사항은 다음 라운드 업데이트에 적용됩니다. 오리진은 스태시 계정 (stash account)이어야 합니다.

set_candidate_reward_dst(new_reward_dst: RewardDestination)

  • interface: api.tx.bfcStaking.setCandidateRewardDst

  • summary: 검증자 후보 보상 목적지를 설정합니다. 오리진은 컨트롤러 계정 (controller account)이어야 합니다.

set_nominator_reward_dst(new_reward_dst: RewardDestination)

  • interface: api.tx.bfcStaking.setNominatorRewardDst

  • summary: 지명자 보상 목적지를 설정합니다.

go_offline()

  • interface: api.tx.bfcStaking.goOffline

  • summary: 언본딩 (unbonding) 없이 일시적으로 검증자 후보 집합을 떠납니다. 오리진은 컨트롤러 계정 (controller account)이어야 합니다.

go_online()

  • interface: api.tx.bfcStaking.goOnline

  • summary: 이전에 강제 퇴출되거나 오프라인 상태였던 경우 검증자 후보 집합에 다시 합류합니다. 오리진은 컨트롤러 계정 (controller account)이어야 합니다.

candidate_bond_more(more: BalanceOf)

  • interface: api.tx.bfcStaking.candidateBondMore

  • summary: 검증자 후보의 자체 본딩을 더 늘립니다. 오리진은 스태시 계정 (stash account)이어야 합니다.

schedule_candidate_bond_less(less: BalanceOf)

  • interface: api.tx.bfcStaking.scheduleCandidateBondLess

  • summary: 검증자 후보가 자체 본딩을 줄이도록 요청합니다. 오리진은 컨트롤러 계정 (controller account)이어야 합니다.

execute_candidate_bond_less()

  • interface: api.tx.bfcStaking.executeCandidateBondLess

  • summary: 검증자 후보 자체 본딩 조정을 위한 보류 중인 요청을 실행합니다. 오리진은 스태시 계정 (stash account)이어야 합니다.

cancel_candidate_bond_less()

  • interface: api.tx.bfcStaking.cancelCandidateBondLess

  • summary: 검증자 후보 자체 본딩 조정을 위한 보류 중인 요청을 취소합니다. 오리진은 컨트롤러 계정 (controller account)이어야 합니다.

nominate(candidate: AccountId, amount: BalanceOf, candidate_nomination_count: u32, nomination_count: u32)

  • interface: api.tx.bfcStaking.nominate

  • summary: 주어진 후보자를 지명합니다.

schedule_leave_nominators()

  • interface: api.tx.bfcStaking.scheduleLeaveNominators

  • summary: 지명자 (nominator) 집합을 떠날 것을 요청합니다.

execute_leave_nominators(nomination_count: u32)

  • interface: api.tx.bfcStaking.executeLeaveNominators

  • summary: 지명자 집합을 떠나고 진행 중인 모든 지명을 철회할 권한을 실행합니다.

cancel_leave_nominators()

  • interface: api.tx.bfcStaking.cancelLeaveNominators

  • summary: 지명자 집합을 떠나기 위한 보류 중인 요청을 취소합니다.

schedule_revoke_nomination(validator: AccountId)

  • interface: api.tx.bfcStaking.scheduleRevokeNomination

  • summary: 기존 지명을 철회할 것을 요청합니다.

nominator_bond_more(candidate: AccountId, more: BalanceOf)

  • interface: api.tx.bfcStaking.nominatorBondMore

  • summary: 특정 검증자 후보에게 더 많은 본딩을 합니다.

schedule_nominator_bond_less(candidate: AccountId, less: BalanceOf)

  • interface: api.tx.bfcStaking.scheduleNominatorBondLess

  • summary: 특정 검증자 후보에게 더 적은 본딩을 요청합니다.

execute_nomination_request(candidate: AccountId)

  • interface: api.tx.bfcStaking.executeNominationRequest

  • summary: 기존 지명을 변경하기 위한 보류 중인 요청을 실행합니다.

cancel_nomination_request(candidate: AccountId)

  • interface: api.tx.bfcStaking.cancelNominationRequest

  • summary: 기존 지명 변경 요청을 취소합니다.

Storage Values

Session(): SessionIndex

  • interface: api.query.bfcStaking.session

  • summary: 현재 라운드의 현재 세션 인덱스.

Round(): RoundInfo<T::BlockNumber>

  • interface: api.query.bfcStaking.round

  • summary: 현재 라운드 인덱스 및 특정 정보.

StorageCacheLifetime(): u32

  • interface: api.query.bfcStaking.storageCacheLifetime

  • summary: 스토리지 데이터가 캐시될 수 있는 최대 스토리지 수명.

DefaultFullValidatorCommission(): Perbill

  • interface: api.query.bfcStaking.defaultFullValidatorCommission

  • summary: 풀 검증자를 위한 기본 수수료율.

DefaultBasicValidatorCommission(): Perbill

  • interface: api.query.bfcStaking.defaultBasicValidatorCommission

  • summary: 기본 검증자를 위한 기본 수수료율.

MaxFullValidatorCommission(): Perbill

  • interface: api.query.bfcStaking.maxFullValidatorCommission

  • summary: 풀 검증자를 위한 최대 수수료율.

MaxBasicValidatorCommission(): Perbill

  • interface: api.query.bfcStaking.maxBasicValidatorCommission

  • summary: 기본 검증자를 위한 최대 수수료율.

MaxTotalSelected(): u32

  • interface: api.query.bfcStaking.maxTotalSelected

  • summary: 매 라운드마다 선택되는 최대 노드 후보 수.

MaxFullSelected(): u32

  • interface: api.query.bfcStaking.maxFullSelected

  • summary: 매 라운드마다 선택되는 최대 풀 노드 후보 수.

MaxBasicSelected(): u32

  • interface: api.query.bfcStaking.maxBasicSelected

  • summary: 매 라운드마다 선택되는 최대 기본 노드 후보 수.

MinTotalSelected(): u32

  • interface: api.query.bfcStaking.minTotalSelected

  • summary: 매 라운드마다 선택되는 최소 후보 수.

ProductivityPerBlock(): Perbill

  • interface: api.query.bfcStaking.productivityPerBlock

  • summary: 현재 라운드에서 블록 생산당 생산성 비율.

NominatorState(AccountId): Option<Nominator<AccountId, BalanceOf>>

  • interface: api.query.bfcStaking.nominatorState

  • summary: 계정이 지명자인 경우 해당 계정과 연결된 지명자 상태를 가져오고, 그렇지 않으면 None.

CandidateInfo(AccountId): Option<CandidateMetadata<AccountId, BalanceOf, BlockNumberOf>>

  • interface: api.query.bfcStaking.candidateInfo

  • summary: 계정이 후보자인 경우 해당 계정과 연결된 검증자 후보 정보를 가져오고, 그렇지 않으면 None.

BondedStash(AccountId): Option<AccountId>

  • interface: api.query.bfcStaking.bondedStash

  • summary: 모든 잠긴 "스태시" 계정에서 컨트롤러 계정으로의 매핑.

TopNominations(AccountId): Option<Nominations<AccountId, BalanceOf>>

  • interface: api.query.bfcStaking.topNominations

  • summary: 검증자 후보를 위한 상위 지명.

BottomNominations(AccountId): Option<Nominations<AccountId, BalanceOf>>

  • interface: api.query.bfcStaking.bottomNominations

  • summary: 검증자 후보를 위한 하위 지명.

SelectedCandidates(): Vec<AccountId>

  • interface: api.query.bfcStaking.selectedCandidates

  • summary: 현재 라운드를 위해 선택된 활성 검증자 세트 (풀 및 기본).

SelectedFullCandidates(): Vec<AccountId>

  • interface: api.query.bfcStaking.selectedFullCandidates

  • summary: 현재 라운드를 위해 선택된 활성 풀 검증자 세트.

SelectedBasicCandidates(): Vec<AccountId>

  • interface: api.query.bfcStaking.selectedBasicCandidates

  • summary: 현재 라운드를 위해 선택된 활성 기본 검증자 세트.

CachedSelectedCandidates(): Vec<(RoundIndex, Vec<AccountId>)>

  • interface: api.query.bfcStaking.cachedSelectedCandidates

  • summary: 전 라운드에서 선택된 캐시된 활성 검증자 세트.

Majority(): u32

  • interface: api.query.bfcStaking.majority

  • summary: 현재 활성 검증자 세트의 Majority.

CachedMajority(): Vec<(RoundIndex, u32)>

  • interface: api.query.bfcStaking.cachedMajority

  • summary: 이전 라운드에서 선택된 활성 검증자 세트를 기반으로 캐시된 Majority.

Total(): BalanceOf

  • interface: api.query.bfcStaking.total

  • summary: 이 스테이킹 팔렛(pallet)에 의해 잠긴 총 자본.

CandidatePool(): Vec<Bond<AccountId, BalanceOf>>

  • interface: api.query.bfcStaking.candidatePool

  • summary: 검증자 후보 풀, 각 후보는 총 투표력을 가짐.

AtStake(RoundIndex): ValidatorSnapshot<AccountId, BalanceOf>

  • interface: api.query.bfcStaking.atStake

  • summary: 라운드 시작 시 검증자 지명 스테이크 스냅샷.

TotalAtStake(RoundIndex): Option<TotalSnapshot<BalanceOf>>

  • interface: api.query.bfcStaking.totalAtStake

  • summary: 라운드 시작 시 네트워크 상태 스냅샷.

DelayedPayouts(RoundIndex): Option<DelayedPayout<BalanceOf>>

  • interface: api.query.bfcStaking.delayedPayouts

  • summary: 지연된 보상 지급.

DelayedControllerSets(RoundIndex): Vec<DelayedControllerSet<AccountId>>

  • interface: api.query.bfcStaking.delayedControllerSets

  • summary: 지연된 새 컨트롤러 계정 설정 요청.

Staked(RoundIndex): BalanceOf

  • interface: api.query.bfcStaking.staked

  • summary: 라운드에서 선택된 후보자에 대해 집계된 총 스테이크.

InflationConfig(): InflationInfo<BalanceOf>

  • interface: api.query.bfcStaking.inflationConfig

  • summary: 인플레이션 설정.

Points(RoundIndex): RewardPoint

  • interface: api.query.bfcStaking.points

  • summary: 라운드에서 블록 생산에 대해 검증자에게 부여된 총 점수.

AwardedPts(AccountId): RewardPoint

  • interface: api.query.bfcStaking.awardedPts

  • summary: 라운드당 각 검증자에 대한 점수.

AwardedTokens(): BalanceOf

  • interface: api.query.bfcStaking.awardedTokens

  • summary: 제네시스(genesis) 이후 검증자와 지명자에게 부여된 토큰.

Constants

DefaultBlocksPerSession: u32

  • interface: api.consts.bfcStaking.defaultBlocksPerSession

  • summary: 제네시스 (genesis) 시점의 기본 세션당 블록 수.

DefaultBlocksPerRound: u32

  • interface: api.consts.bfcStaking.defaultBlocksPerRound

  • summary: 제네시스 (genesis) 시점의 기본 라운드당 블록 수.

MinBlocksPerRound: u32

  • interface: api.consts.bfcStaking.minBlocksPerRound

  • summary: 제네시스 (genesis) 시점의 기본 최소 라운드당 블록 수.

StorageCacheLifetimeInRounds: u32

  • interface: api.consts.bfcStaking.storageCacheLifetimeInRounds

  • summary: 특정 스토리지 데이터가 캐시될 수 있는 라운드 기준 최대 수명.

LeaveCandidatesDelay: RoundIndex

  • interface: api.consts.bfcStaking.leaveCandidatesDelay

  • summary: 후보자가 종료 요청을 실행하기 전에 본딩된 상태로 유지되는 라운드 수.

CandidateBondLessDelay: RoundIndex

  • interface: api.consts.bfcStaking.candidateBondLessDelay

  • summary: 후보자가 자체 본딩을 줄이도록 요청한 후 실행 가능해지기까지 기다려야 하는 라운드 수.

LeaveNominatorsDelay: RoundIndex

  • interface: api.consts.bfcStaking.leaveNominatorsDelay

  • summary: 지명자가 종료 요청을 실행하기 전에 본딩된 상태로 유지되는 라운드 수.

RevokeNominationDelay: RoundIndex

  • interface: api.consts.bfcStaking.revokeNominationDelay

  • summary: 지명 철회 요청을 실행하기 전에 지명이 본딩된 상태로 유지되는 라운드 수.

NominationBondLessDelay: RoundIndex

  • interface: api.consts.bfcStaking.nominationBondLessDelay

  • summary: 지명 감소 요청이 실행 가능해지기까지 기다려야 하는 라운드 수.

RewardPaymentDelay: RoundIndex

  • interface: api.consts.bfcStaking.rewardPaymentDelay

  • summary: 블록 저자에게 보상이 지급되는 시점까지의 라운드 수.

DefaultMaxSelectedFullCandidates: u32

  • interface: api.consts.bfcStaking.defaultMaxSelectedFullCandidates

  • summary: 매 라운드마다 선택되는 기본 최대 풀 노드 후보 수.

DefaultMaxSelectedBasicCandidates: u32

  • interface: api.consts.bfcStaking.defaultMaxSelectedBasicCandidates

  • summary: 매 라운드마다 선택되는 기본 최대 기본 노드 후보 수.

DefaultMinSelectedCandidates: u32

  • interface: api.consts.bfcStaking.defaultMinSelectedCandidates

  • summary: 매 라운드마다 선택되는 기본 최소 후보 수 (풀 및 기본).

MaxTopNominationsPerCandidate: u32

  • interface: api.consts.bfcStaking.maxTopNominationsPerCandidate

  • summary: 후보자당 집계되는 최대 상위 지명 수.

MaxBottomNominationsPerCandidate: u32

  • interface: api.consts.bfcStaking.maxBottomNominationsPerCandidate

  • summary: 후보자당 집계되는 최대 하위 지명 수.

MaxNominationsPerNominator: u32

  • interface: api.consts.bfcStaking.maxNominationsPerNominator

  • summary: 지명자당 최대 지명 수.

DefaultFullValidatorCommission: Perbill

  • interface: api.consts.bfcStaking.defaultFullValidatorCommission

  • summary:풀 검증자를 위한 기본 수수료율.

DefaultBasicValidatorCommission: Perbill

  • interface: api.consts.bfcStaking.defaultBasicValidatorCommission

  • summary: 기본 검증자를 위한 기본 수수료율.

MaxFullValidatorCommission: Perbill

  • interface: api.consts.bfcStaking.maxFullValidatorCommission

  • summary: 풀 검증자를 위해 사용 가능한 최대 수수료율.

MaxBasicValidatorCommission: Perbill

  • interface: api.consts.bfcStaking.maxBasicValidatorCommission

  • summary: 기본 검증자를 위해 사용 가능한 최대 수수료율.

MinFullValidatorStk: BalanceOf

  • interface: api.consts.bfcStaking.minFullValidatorStk

  • summary: 라운드의 SelectedCandidates에 포함되기 위한 모든 풀 노드 후보에게 요구되는 최소 스테이크.

MinBasicValidatorStk: BalanceOf

  • interface: api.consts.bfcStaking.minBasicValidatorStk

  • summary: 라운드의 SelectedCandidates에 포함되기 위한 모든 기본 노드 후보에게 요구되는 최소 스테이크.

MinFullCandidateStk: BalanceOf

  • interface: api.consts.bfcStaking.minFullCandidateStk

  • summary: 풀 검증자 후보가 되기 위한 모든 계정에게 요구되는 최소 스테이크.

MinBasicCandidateStk: BalanceOf

  • interface: api.consts.bfcStaking.minBasicCandidateStk

  • summary: 기본 검증자 후보가 되기 위한 모든 계정에게 요구되는 최소 스테이크.

MinNominatorStk: BalanceOf

  • interface: api.consts.bfcStaking.minNominatorStk

  • summary: 온체인에 등록된 모든 계정이 지명자가 되기 위한 최소 스테이크.

Previous팔렛 인터페이스NextBfcUtility

Last updated