From 3fcf22a144a256f63a8d38d3e23f1c21c6648d59 Mon Sep 17 00:00:00 2001 From: 0xLyon Date: Tue, 1 Aug 2023 11:04:59 +0200 Subject: [PATCH] FAQ updates/fix --- docs/BSC-FAQs-delegator.md | 7 -- docs/BSC-FAQs-general.md | 179 +++---------------------------------- docs/BSC-FAQs-tokens.md | 52 +++-------- docs/BSC-FAQs-validator.md | 130 +-------------------------- sidebars.js | 2 +- 5 files changed, 24 insertions(+), 346 deletions(-) diff --git a/docs/BSC-FAQs-delegator.md b/docs/BSC-FAQs-delegator.md index 2ad5fb5f53..809d5c8b5f 100644 --- a/docs/BSC-FAQs-delegator.md +++ b/docs/BSC-FAQs-delegator.md @@ -31,10 +31,6 @@ The current **UnbondingTime** in BNB Smart Chain mainnet is **7 days**. Redelegations between a unique delegator, source validator, and destination validator can only happen once every **UnbondingTime** -### How many tokens are required to stake BNB? - -The [minimum delegated amount](parameters.md) is **1BNB**. - ### How to claim my rewards? The rewards will be distributed to every delegators from `bscvalidator` [smart contract](https://bscscan.com/address/0x0000000000000000000000000000000000001000) everyday. @@ -62,9 +58,6 @@ By delegating to a validator, a user delegates voting power. This does not mean ### Can I receive my staking rewards if my chosen validator is inactive? No, you cannot. -### When can I receive my unstaked BNB? -After you sent `undelegate` transaction, you have to wait 7 days. This period starts at UTC 00:00 next day. - ### What is APR? Annual Percentage Rate (APR) is the annual rate of interest paid to delegators net of commission. The calculation is based on the income of this validator 2 days ago. It is not compounded and updated every 24 hours. diff --git a/docs/BSC-FAQs-general.md b/docs/BSC-FAQs-general.md index 48cd85e9a0..110388a47e 100644 --- a/docs/BSC-FAQs-general.md +++ b/docs/BSC-FAQs-general.md @@ -6,19 +6,7 @@ sidebar_position: 2 # BNB Smart Chain FAQs -### What is BNB Smart Chain? - -BNB Smart Chain brings EVM-compatible programmability and native cross-chain communication with BNB Beacon Chain using an innovative consensus of Proof of Staked Authority (PoSA). - -### Why is BNB Smart Chain designed as a separate chain from BNB Beacon Chain? - -The execution of a Smart Contract may slow down the exchange function and add non-deterministic factors to trading. Even if that compromise could be tolerated, it might be a straightforward idea to introduce a new Virtual Machine specification based on Tendermint, based on the current underlying consensus protocol and major RPC implementation of BNB Beacon Chain. But all these will increase the learning requirements for all existing dApp communities, and will not be very welcomed. - -### Where will the published whitepaper be found? - -The whitepaper can be found at . Your feedback is more than welcome. - -### Where can I take a look at the BNB Smart Chain code? Is there a GitHub repository? +### Where can I find BNB Smart Chain code? Is there a GitHub repository? The codebase of BSC is open-sourced here: @@ -29,18 +17,7 @@ The codebase of BSC is open-sourced here: * * -## What is the consensus model of BSC? - -BNB Smart Chain is an innovative solution to bring programmability and interoperability to BNB Beacon Chain. BNB Smart Chain relies on a system of 50 validators with Proof of Staked Authority (PoSA) consensus that can support short block time and lower fees. For more details, refer [here](learn/consensus.md). - -## Where can I find some support? -* Technical talk and support running our software: - * Telegram: or - * Discord: -* Bugs or technical contributions on [GitHub](https://github.com/bnb-chain) -* General discussion regarding our blockchain on [Telegram](https://t.me/BNBChainDevs) or - -## Which are BNB Smart Chain's official channels for communication and information? +### What are BNB Smart Chain's official communication channels? * Telegram: or * Discord: @@ -59,21 +36,6 @@ BNB Smart Chain is an innovative solution to bring programmability and interoper - [Trust Wallet](wallet/trustwallet.md) - [SafePal](https://blog.safepal.io/pre-announcement-trade-on-dex-with-safepal/) - [TokenPocket](https://tokenpocket-gm.medium.com/defi-with-tokenpocket-how-to-use-binance-smart-chain-swap-with-tokenpocket-e76d6cd7986) - - -### How to recover if you choose the wrong network type? - -Please read this [guide](./wallet/withdraw-en.md) - -### How does BNB Smart Chain work? What are the architecture and consensus used? - -BNB Smart Chain relies on a system of 50 validators with Proof of Staked Authority (PoSA) consensus that can support short block time and lower fees. - -There will be fewer validators on the BNB Smart Chain testnet. - -### Can you tell me more about Proof of Staked Authority(PoSA)? What is it? - -PoSA is a combination of PoA and PoS. Blocks are produced by a limited set of validators, they are elected in and out based on staking-based governance. Validators take turns to produce blocks in a PoA manner ### What are the benefits for developers to build on BNB Smart Chain? @@ -85,34 +47,10 @@ PoSA is a combination of PoA and PoS. Blocks are produced by a limited set of va * **Native cross-chain transfer & communication** -### What are the benefits for developers to build on BNB Chain? - -BNB Chain opens the gate for users to take advantage of the fast transferring and trading - -### How many assets are issued on BNB Chain? - -There are already [140 assets](https://explorer.bnbchain.org/assets/bep2) on BNB Chain - -The introduction of [BEP8](https://github.com/bnb-chain/BEPs/blob/master/BEP8.md) is an innovative way for tokenization of properties - -### What makes BNB Smart Chain different? - -Key Innovations: - -* Proof-of-staked-authority Consensus - -* Native Cross-Chain Communication - -* Expand the use cases of the BNB token - ### BNB Smart Chain is EVM-compatible. What does that mean? EVM means Ethereum Virtual Machine. Any smart contract written to run in EVM can be easily ported to BNB Smart Chain. -### Can developers make hybrid Dapps using both BNB Beacon Chain and BNB Smart Chain in one single Dapp? - -Yes, with the help of native cross-chain functions - ### How to query the current system parameters ``` @@ -135,127 +73,30 @@ bnbcli params side-params --side-chain-id=bsc --node http://dataseed4.bnbch * Cross-chain relay fee: 0.004 BNB - -### How is BNB Smart Chain Ecosystem? - - - -### What are the incentives for developers to build on BSC Chain? - -Future coding competitions; Hackathons - -* Gitcoin: https://gitcoin.co/binancex -* Dorahacks: https://hackerlink.io/en/grant/1 - -### What are Pegged tokens on BNB Smart Chain? - -Soon after the launch of BNB Beacon Chain, BNB Chain issued several pegged BEP2 tokens that are running on other blockchain networks, including BTC (BTCB), ETH, XRP, LTC, BCH, and ONT. These tokens are backed by real tokens locked in public addresses and have allowed users to benefit from both the volatility of these tokens as well as the fast transfer and trading experience of BNB Beacon Chain. - -Current list: - -* BUSD: -* USDT: -* BTC: -* ETH: -* DAI: -* DOT: -* XRP: -* LINK: -* BAND: -* LTC: -* EOS: -* BCH: -* XTZ: -* ONT: -* ADA: -* ATOM: -* YFII: -* ZEC: - -Details are [here](https://www.bnbchain.org/en/blog/binance-presents-project-token-canal-2/) - - -### How to Send and Receive BNB on BNB Smart Chain? - -[Binance.com](https:/www.binance.com) can withdraw BNB to BSC. - -1. If you don't have an existing address of BNB Smart Chain, please use these [wallets](Wallet.md) to create one. - -2. On your Binance account, open your Binance Extension wallet then tap on Withdraw. Select BEP20 as the Network. Indicate the amount and paste your BSC address. - -3. Complete the steps to withdraw - -4. Wait for the exchange to process your request. Once it is confirmed, you will immediately receive BNB to your Smart Chain address. - -### How to Send and Receive Pegged tokens on Smart Chain? - -[Binance.com](https:/www.binance.com) can withdraw those pegged tokens to BSC. - -1. If you don't have an existing address of BNB Smart Chain, please use these [wallets](Wallet.md) to create one. - -2. On your Binance account, open your wallet then tap on Withdraw. Select BEP20 as the Network. Indicate the amount and paste your BSC address. - - -![img](https://lh5.googleusercontent.com/dR9bBqUpNlBFX6zsKFkVRMgHz27Ak0Icu8AFsuJm_1ke6-qSG5Cg2FJLcpRYlFeuFEpisOdXpwn1KDOHBH7qQV9CpYxVb--2B1NxQm-L6B6qSl9Cq90uCSrwHEPAOh69Z0MM2VtG) - - -3. Complete the steps to withdraw - -4. Wait for the exchange to process your request. Once it is confirmed, you will immediately receive BNB to your Smart Chain address. - -## Which dApps are deployed on BSC? +### Which dApps are deployed on BSC? Refer to [here](https://bnbproject.org/) to learn about the different projects deployed on BSC. -## What to do if I transferred funds to the exchange wallet but the exchange doesn't support the BSC chain? +### What to do if I transferred funds to the exchange wallet but the exchange doesn't support the BSC chain? Please be careful while doing transactions to other exchanges to check if they support or accept deposits through BSC or not. The confirmed transaction on the blockchain cannot be reverted as we also don't have any access to the wallet address. -## What to do in case of a wrong network withdrawal issue? +### What to do in case of a wrong network withdrawal issue? Please try to use the wallet app which supports both BSC and ETH networks in it. So that you can access any network with the same address and transfer your funds out of the wrong network. - -## What to do in case of a Missing memo or wrong memo? +### What to do in case of a Missing memo or wrong memo? Please try to contact the support of the receiver address to help with the deposit. If it's an exchange wallet address then contact them with the correct memo. -## How to track Cross-chain transfer tx From BC to BSC? - -1. Get the Cross-chain transfer transaction hash of the BNB Beacon Chain - -For example - -Please make sure the “Transaction Type” is “Cross-chain transfer out” - -![img](./assets/bsc_faqs_general/Txn_Type_Cross-chain_transfer_out.png) - -2. Get Destination Address - -The “TxHash on BSC” is linked to BNB smart chain explorer - -![img](./assets/bsc_faqs_general/txn_hash_receiver_add_bsc.png) - -For example https://www.bscscan.com/tx/0x43980b4f9ae4c03685dd61172d23ccae07eb8abb0d677c579bfc7059e447ead9 - -If "status" is a success, it means this transaction is successful. - -The tokens were sent from "BSC: Token Hub" to the receiver address. - -![img](./assets/bsc_faqs_general/cross_chain_txn_bsc.png) - -## How to connect Metamask to BNB Smart Chain? +### How to connect Metamask to BNB Smart Chain? Please refer [here](wallet/metamask.md) -## How can I report a scam/ rug pull? +### How can I report a scam/rug pull? -If you meet any potential Scams, Phishing, Rug Pulls, and Hacks, please report through this portal: -https://forms.coinholmes.com +If you meet any potential Scams, Phishing, Rug Pulls, and Hacks, please report through this portal - [Coinholmes](https://forms.coinholmes.com) Coinholmes.com is supported by the Peckshield team (A professional security company) -## How to reset Binance Extension Wallet? -If the user has a seed phrase then the user can refer to [here](wallet/extension/reset.md) to reset the wallet. - -## How to apply for Pioneer Burn Refunding? +### How to apply for Pioneer Burn Refunding? The [self-service window](https://www.binance.com/en/my/wallet/uncredited_deposit/form?&coin=&network=&amount=&txId=tx) for [BNB Pioneer Burn Program](https://www.binance.com/en/support/announcement/7bcf4da5671d44a0a5118c2277773bb4) is now live. Eligible users who lose tokens as part of mistakes they made while making transactions on BNB Smart Chain can access this page and fill in the application form. We will investigate your case and help retrieve the assets if your case is qualified for the Program. diff --git a/docs/BSC-FAQs-tokens.md b/docs/BSC-FAQs-tokens.md index fe7776edf9..16d7bd94f0 100644 --- a/docs/BSC-FAQs-tokens.md +++ b/docs/BSC-FAQs-tokens.md @@ -6,28 +6,23 @@ sidebar_position: 2 # Tokens in BNB Beacon Chain and BNB Smart Chain -## What role does BNB play in securing BNB Smart Chain ? - -BNB is the token used to prevent `nothing-at-stake` problem. - -## What are tokens on BNB Smart Chain ? +### What are tokens on BNB Smart Chain ? BNB is the native token for BSC, and pegged BEP2 tokens on BSC is called BEP20. -## What is BEP2? +### What is BEP2? -A simple token protocol for easy management of asset on BNB Beacon Chain +[BEP2](https://github.com/bnb-chain/BEPs/blob/master/BEP2.md) is a simple token protocol for easy management of asset on BNB Beacon Chain. BNB is BEP2 -## What is BEP20? +### What is BEP20? A token protocol on BSC which is compatible with BEP2 and [ERC20](https://eips.ethereum.org/EIPS/eip-20). It extends ERC20 and contains more interfaces, such as `getOwner` and `decimals`. +Read the full proposal here: [BEP20](https://github.com/bnb-chain/BEPs/blob/master/BEP20.md) -Read the full proposal here: - -## What is BEP8? +### What is BEP8? It is proposed to accommodate the small or micro projects, intellectual properties, and other small token economies. Similar to SME board in the traditional stock markets, BEP8 tokens markets will increase the liquidity of utility tokens of startups or Intellectual Property (IP) tokens by removing the capital requirements for listing. Besides, any BEP8 token issuer can choose to directly list against BNB and BUSD without the voting process of validators. @@ -36,46 +31,23 @@ Details: * [BEP8 Proposal](https://github.com/bnb-chain/BEPs/blob/master/BEP8.md) * [Commandline Instructions](beaconchain/learn/BEP8.md) -## How to issue BEP2 tokens? +### How to issue BEP2 tokens? Please follow the guide [here](https://community.binance.org/topic/2487/) -## How to issue BEP20 tokens? +### How to issue BEP20 tokens? Please follow the guide [here](issue-BEP20.md) -## How can I stake my BNB? - -Please follow the guide [here](staking-with-ext-wallet.md) - -## How many tokens are required to stake BNB? - -The [minimum delegated amount](parameters.md) is **1BNB**. - -## Which wallets can be used to stake BNB? - -You can use: - -* [command line tool](https://github.com/bnb-chain/node/releases/tag/v0.8.1) -* [Binance Extension Wallet](wallet/bnb-chain-wallet.md) -* [Math Wallet](http://blog.mathwallet.xyz/?p=3890) - -## Where can I find out more about staking economics and rewards? - -You can read details in White Paper: - -## Where do network rewards come from? - -Validators and delegators will earn rewards from the following sources: +### Where can I find out more about staking economics and rewards? -* Calling smart contracts on BSC is metered by gas. -* Rewards for running a BSC Relayer if validators have one +You can read details in [White Paper](https://github.com/bnb-chain/whitepaper/blob/master/WHITEPAPER.md#rewarding) -## Which wallets can I use to store BNB? +### Which wallets can I use to store BNB? You can see the list [here](Wallet.md) -## How to track Cross-chain transfer tx From BSC to BC? +### How to track Cross-chain transfer tx From BSC to BC? 1. Get Cross-chain transfer tx hash of BNB Smart Chain diff --git a/docs/BSC-FAQs-validator.md b/docs/BSC-FAQs-validator.md index 6fa869bd9b..023d55d4f7 100644 --- a/docs/BSC-FAQs-validator.md +++ b/docs/BSC-FAQs-validator.md @@ -13,42 +13,6 @@ It powers the blockchain network by processing transactions and signing blocks. Validators and delegators will earn rewards from transaction fees: dApp usages. -### What's on-chain governance proposal? - -The proposal will decide: slash amount, cross-chain transfer fees. - -### How to join testnet as a validator? - - 1. Choose your own server/PC. - 2. Install software. - 3. Create a wallet and get some BNB. - 4. Run your fullnode and keep it synced. - 5. Stake your BNB on BC, the top 29 most staked nodes to be the validator set. - -### How to join mainnet as a validator? - - 1. Choose your own server/PC - 2. Install software - 3. Create a wallet and get some BNB - 4. Run your fullnode and keep it synced - 5. Stake your BNB on BC, the top 29 most staked nodes to be the validator set" - -### What are hardware requirements of running a validator node? - -Processing transactions is mostly CPU bound. Therefore we recommend running CPU optimized servers. - - * Directly facing internet (public IP, no NAT) - - * 8 cores CPU - - * 16GB of RAM - - * 500 SSD storage" - -### How many BNB are required to create a validator? - -Validators can self-bond, meaning they can delegate BNB to themselves, and they can also receive delegations from any other BNB holders. These bonded BNB acts as collateral and cause each delegate, including validators, to have “skin in the game” so to speak. If any equivocation or byzantine behavior by a validator were to be committed, the validator and its delegates would be slashed a predefined amount of bonded stake. The minimum self-delegated amount is 2000BNB. - ### When are rewards paid out? The rewards will not be sent to validator right away, instead, they will be distributed and accumulated on a contract. The reward distribution happens on BC around every day UTC 00:00. @@ -70,76 +34,10 @@ On BNB Smart Chain (BSC) network, validators are responsible for securing the ne One of the important on-chain governance implementations is the technique of “slashing” along with jailing. When jailed validator cannot participate in the consensus mechanism or earn rewards for set period of time. Slashing ensures that validators who act maliciously or show bad behavior are punished. Furthermore, it is designed to expose any attacker and make execution of their attempts extremely expensive. Anyone can submit BSC slash request. Even though BSC slash request requires slash evidence and transaction cost fees, huge reward is given in case the request is successful. To ensure that the delegators are not punished for the validator’s bad behavior, only the self-bonded BNB of the validator are slashed. Currently, slashing is applied on any node that processes an invalid transaction, performs double-signing or is unavailable for a defined period of time. -### What are the two slashable cases? - -The validators are slashed in cases of self-bound less than the required minimum, double singing, and unavailability. - -*_Double Signing:_* refers to an event when a validator node proposes two different blocks at the same block height. A validator will be removed from the validator set definitely, if they try signing two different blocks and broadcasting them. For a BSC slash request for double signing the supporting evidence should indicate two block headers having same block height and same parent block hash sealed by the same validator. Two signatures of these two blocks must not be the same. The time of these two blocks must be within the validity of the evidence, which is 24 hours. Rewards for submitting double-sign evidence is **1000BNB**. In case the provided evidence are valid, the validators face a slashing of **10000BNB** from their self-delegated BNB and will be ‘jailed’ for a time period of 7 days. - -*_Unavailability/ Downtime in a 24 hour period:_* the slash fee for a validator being offline is self-delegated **50BNB** accompanied with a jail time of 2 days. If a validator misses at least 50 blocks (~52 minutes of downtime) during 24 hours, they will not be able to receive any rewards during that period of time. -Instead their reward will be distributed amongst other better performing validators of the set. Another case of unavailability is when a validator misses over 150 blocks (~157.5 minutes of downtime) during 24 hours. In this case, the validator will not receive reward instead it will be propagated back to BC. - -*_Self‐bond below minimum:_* Validators are jailed for 1 day if their self‐bond falls below **2000BNB**. - -### What is the minimum amount for self-delegation to avoid being jailed? - -The [minimum self-delegated amount](parameters.md) is **2000BNB**. - -### What is the unbounding time period? - -Unbonding time: 7 days - -### What is the unjail fees for a validator jailed for being offline? What is the offline jail time period? - -offline Unjail fee: 1BNB - -offline Jailed time: 2 days. A validator can only unjail 2 days later after it has been jailed - -### What is the slashing amount charged to the validators for being offline and double signing? - -offline slashing amount: 50BNB - -Double-sign slashing amount: 10000BNB - -### Where can you monitor the slash contract? - -The slash contract can be monitored on the BSC scanner on the following link - -https://bscscan.com/address/0x0000000000000000000000000000000000001001#events - -### Does an inactive validator receive any rewards? - -No, they will not. - -### Can I receive my staking rewards if my chosen validator is inactive? - -No, you cannot. - -### When can I receive my unstaked BNB? - -After you sent `undelegate` transaction, you have to wait 7 days. This period starts at UTC 00:00 next day. - -### How to get un-jailed? -Validator nodes that have been jailed due to their malicious or bad behavior can be set to ‘unjailed’ by sending a side-unjail transaction if the validation passed. Furthermore, when unjailed, to join the validator set again, the validator must wait for the next UTC 0:00. The fees to un-jail a smart contract validator is **1BNB**. Whereas, the fee for submitting a byzantine behavior evidence of a validator is **10BNB**. - -_Example:_ - -~~~~ -bnbcli slashing side-unjail --side-chain-id=bsc –node http://dataseed4.bnbchain.org:80 --chain-id=Binance-Chain-Tigris --trust-node --output=json --from {the address of the validaator operator} -~~~~ - ### What is 'self-delegation'? How can I increase my 'self-delegation'? Self-delegation is delegation from a validator to themselves. This amount can be increases by sending a delegate transaction from your validator's operator address. -### What is the command to prune? - - * Stop the node gracefully - - * Run `nohup geth snapshot prune-state --datadir {the data dir of your bsc node} &` - - * Wait for 5-6 hours to finish, it depends on the size of current storage - ### What to do if one can’t run prune-state command In the event when running the geth snapshot `prune-state --datadir /chaindata` on geth 1.1.5 return the following error ~~~~ @@ -191,31 +89,5 @@ Run screen then press enter, anytime you lose connection via ssh, run screen -r `geth --config ./config.toml –datadir ./mainnet --cache 100000 --rpc.allow-unprotected-txs --txlookuplimit 0 --http --maxpeers 100 –ws --syncmode=full --snapshot=false ` -### What are the few adjustments that can help resolve sync issues? - - * Keep maxpeers at around 30. Either Too large or too less is not suggested - - * Enable snapshot, snapshot is another format of state world, it is designed to improve the performance. You can always set it to true. - - * Upgrade to 1.1.5 and diffsync is enabled - - * Try to reduce amount of peers to 30-50 (more peers need more resources) and make sure you're connected to enough peers with net.peerCount - - * Upgrade your hardware, especially Disk and CPU resources. - ### Why is the tx from my dapp not visible on the bscscan even though its hash is generated? -Due to network congestion, it is possible for the tx to appear after a delay. Another possibility is that the number of pending txs have exceeded the size of the limited tx pool of the network and hence the txs have been dropped. - -### What is the best course of actions to make sure the slash indicator for a validator contract doesn’t exceed beyond 150 and getting jailed? - * Pruning is the top choice. - - * Use better CPU, currently we suggest m5zn.3xlarge, it is 3.2G Hz frequency. - - * IOPS above 10000 is good enough. - - * Running 2-3 backup nodes please. - - * NVMe disk is better than SSD - -### Can the location of the validator nodes be considered as playing factor in performance? Is there any way to get the enode or ips of the validator nodes? -The validators are usually running in a private network making it hard to connect or trace their location. Furthermore, it is suggested by community developers that EU is considered a better location in terms of performance. +Due to network congestion, it is possible for the tx to appear after a delay. Another possibility is that the number of pending txs have exceeded the size of the limited tx pool of the network and hence the txs have been dropped. \ No newline at end of file diff --git a/sidebars.js b/sidebars.js index 51e8ce7704..ca01ea3c0c 100644 --- a/sidebars.js +++ b/sidebars.js @@ -328,7 +328,7 @@ const sidebars = { label: 'BNB Smart Chain FAQs', items: ['BSC-FAQs-general', 'BSC-FAQs-tokens', 'BSC-FAQs-validator', 'BSC-FAQs-delegator', - 'parameters', 'cross', 'faq'], + 'parameters', 'cross'], }, { type: 'doc', label: 'BNB Beacon Chain FAQs', id: 'beaconchain/faq/faq',