From b2c5bf3afd407dc97ad5e8b2c3a47458a849e301 Mon Sep 17 00:00:00 2001 From: Randall-Mysten <109545725+randall-Mysten@users.noreply.github.com> Date: Wed, 22 Mar 2023 09:14:06 -0700 Subject: [PATCH] Misc updates for next release (#9692) ## Description Describe the changes or additions included in this PR. ## Test Plan How did you test the new or updated feature? --- If your changes are not user-facing and not a breaking change, you can skip the following section. Otherwise, please indicate what changed, and then add to the Release Notes section as highlighted during the release process. ### Type of Change (Check all that apply) - [ ] user-visible impact - [ ] breaking change for a client SDKs - [ ] breaking change for FNs (FN binary must upgrade) - [ ] breaking change for validators or node operators (must upgrade binaries) - [ ] breaking change for on-chain data layout - [ ] necessitate either a data wipe or data migration ### Release notes --- doc/in-progress/archive-exch-integ-faq.md | 180 +++++++++++++++++++ doc/src/learn/exchange-integration-guide.md | 185 +------------------- doc/src/learn/tokenomics/index.md | 4 +- doc/src/learn/tokenomics/proof-of-stake.md | 2 +- doc/src/learn/tokenomics/storage-fund.md | 2 +- 5 files changed, 189 insertions(+), 184 deletions(-) create mode 100644 doc/in-progress/archive-exch-integ-faq.md diff --git a/doc/in-progress/archive-exch-integ-faq.md b/doc/in-progress/archive-exch-integ-faq.md new file mode 100644 index 0000000000000..e5ebaba777681 --- /dev/null +++ b/doc/in-progress/archive-exch-integ-faq.md @@ -0,0 +1,180 @@ +--- +title: Exchange Integration FAQ +--- + +**This is outdated/deprecated content** + +--- + +## Sui Exchange Integration FAQs + +Get answers to common questions about Sui. + +### How to change the amount of an existing stake? + +During the staking period, you can add to or withdraw your stake from a validator. To modify your stake amount you can use the following functions: + * Use the `request_add_stake` and `request_add_stake_with_locked_coin` methods to add to the staked amount. + * Use the `request_withdraw_stake` method to withdraw staked SUI. + +### How is a staking transaction different from a typical transaction regarding construction, signing, and broadcasting? + +Staking transactions are Move call transactions that call specific Move functions in the [sui_system](https://github.com/MystenLabs/sui/blob/main/crates/sui-framework/sources/governance/sui_system.move) module of the Sui Framework. The staking transaction uses a shared object, and is no different from other shared object transactions. + +### Is there a minimum and maximum staking amount (for Validators and user staking)? + +There will be a minimum amount required, as well as limits on stake changes within an epoch. + + * **Validators:** Requires a minimum of 30 Million SUI to join as a Sui Validator. Validators must maintain a minimum of 20 Million SUI to continue as a validator. Any validator that drops below 15 Million SUI is removed at the next epoch boundary. + * **User staking:** The minimum amount to stake with a validator is 1 SUI. + +### How to stake and un-stake SUI? + +Sui Wallet supports both stake and un-staking. Staking via Move code or the Sui CLI is also possible - the relevant functions are in the [sui_system](https://github.com/MystenLabs/sui/blob/main/crates/sui-framework/sources/governance/sui_system.move) module. + +### Where are the Sui Developer Docs? + +* Sui Documentation Portal: [https://docs.sui.io/](https://docs.sui.io/) +* Sui REST API's: [https://docs.sui.io/sui-jsonrpc](https://docs.sui.io/sui-jsonrpc) + +### What is the difference between the devnet branch and the main branch of the Sui repo? + +The main branch contains all the latest changes. The `devnet` branch reflects the binary that is currently running on the Devnet network. + +### Can I get contract information through the RPC API? + +Yes, contracts are also stored in objects. You can use the sui_getObject to fetch the object. Example: [https://explorer.sui.io/objects/0xe70628039d00d9779829bb79d6397ea4ecff5686?p=31](https://explorer.sui.io/objects/0xe70628039d00d9779829bb79d6397ea4ecff5686?p=31) + +**Note:** You can see only the deserialized bytecode (as opposed to Source code). + +### Can I get the information in the contract, such as the total amount of the currency issued and the number of decimal places? + +There's no contract-level storage in Sui. In general, this contract-level information is usually stored in an object or event. For example, we store decimals in this object [https://github.com/MystenLabs/sui/blob/1aca0465275496e40f02a674938def962126412b/crates/sui-framework/sources/coin.move#L36](https://github.com/MystenLabs/sui/blob/1aca0465275496e40f02a674938def962126412b/crates/sui-framework/sources/coin.move#L36). And in this case we provide an [RPC endpoint](https://github.com/MystenLabs/sui/blob/main/crates/sui-json-rpc/src/api/). + +### Is the gas price dynamic? Is it available through JSON-RPC? + +Yes, the gas price is dynamic and exposed via the [sui_getReferenceGasPrice](https://docs.sui.io/sui-jsonrpc#sui_getReferenceGasPrice) endpoint. + +### How can I delete an object within Sui? + +You can delete objects (in most cases) only if the Move module that defines the object type includes a Move function that can delete the object, such as when a Move contract writer explicitly wants the object to be deletable.[https://docs.sui.io/devnet/build/programming-with-objects/ch2-using-objects#option-1-delete-the-object](https://docs.sui.io/devnet/build/programming-with-objects/ch2-using-objects#option-1-delete-the-object) + +If the delete function is defined in the Move module, you can delete the object by invoking the Move call using CLI or wallet. Here’s an example: + + 1. Create an example NFT using the Sui Client CLI: [https://docs.sui.io/devnet/build/cli-client#create-an-example-nft](https://docs.sui.io/devnet/build/cli-client#create-an-example-nft). + + 2. Call this Move [function](https://github.com/MystenLabs/sui/blob/21c26ce6a5d4e3448abd74323e3164286d3deba6/crates/sui-framework/sources/devnet_nft.move#L69-L72) with the CLI by following [https://docs.sui.io/devnet/build/cli-client#calling-move-code](https://docs.sui.io/devnet/build/cli-client#calling-move-code). + +### What is the denomination of Sui？ + +MIST is the smallest unit of a SUI Coin. 1 SUI equals 1 billion MIST, and 1 MIST equals 10^-9 of a SUI. + +## Transactions FAQs + +Questions about transaction in Sui. + +### How can we subscribe to transaction events? + +There are "Move events" that are emitted by Move code, and "transaction events" such as object transfers, creations, and deletions. See the [Sui Events](../build/event_api.md) topic for a list of all the events you can subscribe to via the pub/sub API and their structure. + +### Can I get the corresponding transaction serial number through TransactionDigest? + +As a best practice, don't rely on the transaction serial number because there's no total ordering of transactions on Sui. The transaction serial numbers differ between different Full nodes. + +### Is the paged transaction data obtained by different nodes the same? + +No, the ordering will be different on different nodes for now, while we are still working on checkpoints. After checkpoint process is complete, the ordering will be the same on all nodes + +### Is there a nonce or timestamp mechanism for transactions? + +There are no nonce or timestamps in our transaction data structure at the moment + +### What is the transaction expiry window? + +Transactions don't expire. + +### How many validators will Sui have at Mainnet genesis? + +The number is still under consideration. The validator set is not fixed, but validators must apply and then be approved through our validator application process. + +### Is the address used for staking the same as the wallet address that owns the staked coins? + +Yes, a user/validator stakes using the address that owns the staked coin. There is no special address derivation + +### How is a staking transaction different from a typical transaction regarding construction, signing, and broadcasting? + +Staking transactions are Move call transactions that call specific Move function in the [Sui Framework](https://github.com/MystenLabs/sui/blob/main/crates/sui-framework/sources/governance/sui_system.move). The staking transaction uses a shared object, and is no different from other shared object transactions. + +### Does Sui support staking a partial amount of the SUI owned by an address? + +Yes, an address can own multiple coins of different amounts. Sui supports staking coins owned by an address to different validators. The minimum user staking amount is 1 SUI. + +### Can I use one account address to stake with multiple validators? + +Yes, if an address owns multiple coins, you can stake each coin with a different validator. + +### Can I change the amount of an existing stake during the staking period? + +Yes, you can add to or withdraw your stake from a validator. Use the following methods to modify the stake amount: + +Use the [`request_add_stake`](https://github.com/MystenLabs/sui/blob/58229627970a6e9ff558b156c1cb193f246eaf88/crates/sui-framework/docs/sui_system.md#0x2_sui_system_request_add_stake) and [`request_add_stake_with_locked_coin`](https://github.com/MystenLabs/sui/blob/58229627970a6e9ff558b156c1cb193f246eaf88/crates/sui-framework/docs/sui_system.md#0x2_sui_system_request_add_stake_with_locked_coin) methods to add to the staked amount. + +Use the [`request_withdraw_stake`](https://github.com/MystenLabs/sui/blob/58229627970a6e9ff558b156c1cb193f246eaf88/crates/sui-framework/docs/sui_system.md#0x2_sui_system_request_withdraw_stake) method to withdraw all or part of the stake. + +### Does Sui require a bonding / warm-up period? + +Yes, the specifics are still under consideration. + +### Does Sui require an un-bonding / cool-down period? + +Yes, the current un-bonding period is under consideration. + +### Are staking rewards auto-compounded? + +Yes, Sui uses a staking pool approach inspired by liquidity pools. Rewards are added to the pool and auto-compounded through the appreciation of pool token value relative to SUI tokens. + +### Do rewards appear as inbound/outbound on-chain transactions? + +Yes, rewards are added to the staking pool through a special system transaction at epoch boundaries. + +### How long does it take to get the first reward after staking? How frequently are rewards paid out? + +Rewards are compounded every epoch, and paid out when you withdraw your stake. You must stake for the entire duration of an epoch to receive rewards for that epoch. + +### How does slashing work, and what are the penalties? + +There will not be slashing for the principal stake allocated. Instead, validators will get penalized by having fewer future rewards when these get paid out. Rewards that have already been accrued are not at risk. + +### Does Sui support on-chain governance or voting? + +On-chain governance is not implemented for Sui. There is no plan to add it in the near future. + +### How can I retrieve the current block height or query a block by height using a Sui endpoint? + +Sui is [DAG](https://cointelegraph.com/explained/what-is-a-directed-acyclic-graph-in-cryptocurrency-how-does-dag-work)-based, so the block-based view of the transaction history is not always the most direct one. To get the latest transaction, use the Transaction Query API: + + ```json + { + "jsonrpc": "2.0", + "id": 1, + "method": "sui_queryTransactions", + "params": [ + "All", + , + 100, + "Ascending" + ] + } + ``` + +### How are transactions proposed by validators if they're not included in blocks? Does a validator propose blocks or just individual transactions? + +Validators form a certificate (a quorum of signatures) for each transaction, and then propose checkpoints consisting of certificates since the last checkpoint. You can read more in section 4.3 of the [Sui Smart Contract Platform](https://github.com/MystenLabs/sui/blob/main/doc/paper/sui.pdf). + +### How do I get test Devnet coins? + +- You can find our [faucet in Discord](https://discord.com/channels/916379725201563759/971488439931392130). You can also request coins from the [Sui Faucet](../build/faucet.md) programmatically. + +### How can I get in touch and request more information? + +- Please visit our [Discord server](https://discord.gg/sui). + diff --git a/doc/src/learn/exchange-integration-guide.md b/doc/src/learn/exchange-integration-guide.md index 77aea3281e65e..539a1f95c807a 100644 --- a/doc/src/learn/exchange-integration-guide.md +++ b/doc/src/learn/exchange-integration-guide.md @@ -235,7 +235,7 @@ Please refer to [offline signing](https://github.com/MystenLabs/sui/blob/d0aceae A native weighted multi-sig multi-scheme signature is also supported. Please see [multisig](https://github.com/MystenLabs/sui/blob/d0aceaea613b33fc969f7ca2cdd84b8a35e87de3/crates/sui/multisig.md) for details. -## SUI Staking and Delegation +## SUI Staking The Sui blockchain uses a Delegated Proof-of-Stake mechanism (DPoS). This allows SUI token holders to stake their SUI tokens to any validator of their choice. When someone stakes their SUI tokens, it means those tokens are locked for the entire epoch. Users can withdraw their stake at any time, but new staking requests become active only at the start of the next epoch. @@ -248,7 +248,7 @@ The total voting power in the Sui Network is always 10,000. The voting power of Sui supports the following API operations related to staking. You can find the source code in the [sui_system](https://github.com/MystenLabs/sui/blob/main/crates/sui-framework/sources/governance/sui_system.move) module. * `request_add_stake` - Add delegated stake to a validator's staking pool. + Add user stake to a validator's staking pool. ```rust public entry fun request_add_stake( @@ -268,7 +268,7 @@ public entry fun request_add_stake( ``` * `request_add_stake_mul_coin` - Add delegated stake to a validator's staking pool using multiple coins. + Add user stake to a validator's staking pool using multiple coins. ```rust public entry fun request_add_stake_mul_coin( @@ -284,7 +284,7 @@ public entry fun request_add_stake_mul_coin( ``` * `request_add_stake_with_locked_coin` - Add delegated stake to a validator's staking pool using a locked SUI coin. + Add user stake to a validator's staking pool using a locked SUI coin. ```rust public entry fun request_add_stake_with_locked_coin( @@ -299,7 +299,7 @@ public entry fun request_add_stake_with_locked_coin( ``` * `request_withdraw_stake` - Withdraw some portion of a delegation from a validator's staking pool. + Withdraw some portion of a user stake from a validator's staking pool. ```rust public entry fun request_withdraw_stake( @@ -318,178 +318,3 @@ public entry fun request_withdraw_stake( ); } ``` - -## Sui Exchange Integration FAQs - -Get answers to common questions about Sui. - -### How to change the amount of an existing stake? - -During the staking period, you can add to or withdraw your stake from a validator. To modify your stake amount you can use the following functions: - * Use the `request_add_stake` and `request_add_stake_with_locked_coin` methods to add to the staked amount. - * Use the `request_withdraw_stake` method to withdraw your delegation. - -### How is a staking transaction different from a typical transaction regarding construction, signing, and broadcasting? - -Staking transactions are Move call transactions that call specific Move functions in the [sui_system](https://github.com/MystenLabs/sui/blob/main/crates/sui-framework/sources/governance/sui_system.move) module of the Sui Framework. The staking transaction uses a shared object, and is no different from other shared object transactions. - -### Is there a minimum and maximum staking amount (for validation and delegation)? - -There will be a minimum amount required, as well as limits on stake changes within an epoch. - - * **Validation:** Requires a high minimum amount of SUI delegated with each validator to stay in the validator set. - * **Delegation:** There will be a relatively low minimum amount for each delegation. - -Specific amounts to be determined prior to Sui Mainnet. - -### How to stake and un-stake SUI? - -Sui Wallet supports both stake and un-staking. Staking via Move code or the Sui CLI is also possible - the relevant functions are in the [sui_system](https://github.com/MystenLabs/sui/blob/main/crates/sui-framework/sources/governance/sui_system.move) module. - -### Where are the Sui Developer Docs? - -* Sui Documentation Portal: [https://docs.sui.io/](https://docs.sui.io/) -* Sui REST API's: [https://docs.sui.io/sui-jsonrpc](https://docs.sui.io/sui-jsonrpc) - -### What is the difference between the devnet branch and the main branch of the Sui repo? - -The main branch contains all the latest changes. The `devnet` branch reflects the binary that is currently running on the Devnet network. - -### Can I get contract information through the RPC API? - -Yes, contracts are also stored in objects. You can use the sui_getObject to fetch the object. Example: [https://explorer.sui.io/objects/0xe70628039d00d9779829bb79d6397ea4ecff5686?p=31](https://explorer.sui.io/objects/0xe70628039d00d9779829bb79d6397ea4ecff5686?p=31) - -**Note:** You can see only the deserialized bytecode (as opposed to Source code). - -### Can I get the information in the contract, such as the total amount of the currency issued and the number of decimal places? - -There's no contract-level storage in Sui. In general, this contract-level information is usually stored in an object or event. For example, we store decimals in this object [https://github.com/MystenLabs/sui/blob/1aca0465275496e40f02a674938def962126412b/crates/sui-framework/sources/coin.move#L36](https://github.com/MystenLabs/sui/blob/1aca0465275496e40f02a674938def962126412b/crates/sui-framework/sources/coin.move#L36). And in this case we provide an [RPC endpoint](https://github.com/MystenLabs/sui/blob/main/crates/sui-json-rpc/src/api/). - -### Is the gas price dynamic? Is it available through JSON-RPC? - -Yes, the gas price is dynamic and exposed via the [sui_getReferenceGasPrice](https://docs.sui.io/sui-jsonrpc#sui_getReferenceGasPrice) endpoint. - -### How can I delete an object within Sui? - -You can delete objects (in most cases) only if the Move module that defines the object type includes a Move function that can delete the object, such as when a Move contract writer explicitly wants the object to be deletable.[https://docs.sui.io/devnet/build/programming-with-objects/ch2-using-objects#option-1-delete-the-object](https://docs.sui.io/devnet/build/programming-with-objects/ch2-using-objects#option-1-delete-the-object) - -If the delete function is defined in the Move module, you can delete the object by invoking the Move call using CLI or wallet. Here’s an example: - - 1. Create an example NFT using the Sui Client CLI: [https://docs.sui.io/devnet/build/cli-client#create-an-example-nft](https://docs.sui.io/devnet/build/cli-client#create-an-example-nft). - - 2. Call this Move [function](https://github.com/MystenLabs/sui/blob/21c26ce6a5d4e3448abd74323e3164286d3deba6/crates/sui-framework/sources/devnet_nft.move#L69-L72) with the CLI by following [https://docs.sui.io/devnet/build/cli-client#calling-move-code](https://docs.sui.io/devnet/build/cli-client#calling-move-code). - -### What is the denomination of Sui？ - -MIST is the smallest unit of a SUI Coin. 1 SUI equals 1 billion MIST, and 1 MIST equals 10^-9 of a SUI. - -## Transactions FAQs - -Questions about transaction in Sui. - -### How can we subscribe to transaction events? - -There are "Move events" that are emitted by Move code, and "transaction events" such as object transfers, creations, and deletions. See the [Sui Events](../build/event_api.md) topic for a list of all the events you can subscribe to via the pub/sub API and their structure. - -### Can I get the corresponding transaction serial number through TransactionDigest? - -As a best practice, don't rely on the transaction serial number because there's no total ordering of transactions on Sui. The transaction serial numbers differ between different Full nodes. - -### Is the paged transaction data obtained by different nodes the same? - -No, the ordering will be different on different nodes for now, while we are still working on checkpoints. After checkpoint process is complete, the ordering will be the same on all nodes - -### Is there a nonce or timestamp mechanism for transactions? - -There are no nonce or timestamps in our transaction data structure at the moment - -### What is the transaction expiry window? - -Transactions don't expire. - -### How many validators will Sui have at Mainnet genesis? - -The number is still under consideration. The validator set is not fixed, but validators must apply and then be approved through our validator application process. - -### Is the address used for staking the same as the wallet address that owns the staked coins? - -Yes, a user/validator stakes using the address that owns the staked coin. There is no special address derivation - -### How is a staking transaction different from a typical transaction regarding construction, signing, and broadcasting? - -Staking transactions are Move call transactions that call specific Move function in the [Sui Framework](https://github.com/MystenLabs/sui/blob/main/crates/sui-framework/sources/governance/sui_system.move). The staking transaction uses a shared object, and is no different from other shared object transactions. - -### Does Sui support staking a partial amount of the SUI owned by an address? - -Yes, an address can own multiple coins of different amounts. Sui supports staking coins owned by an address to different validators. The minimum staking amount that can be delegated is 1 MIST which is equal to .000000001 SUI. - -### Can I use one account address to stake with multiple validators? - -Yes, if an address owns multiple coins, you can stake each coin with a different validator. - -### Can I change the amount of an existing stake during the staking period? - -Yes, you can add to or withdraw your stake from a validator. Use the following methods to modify the stake amount: - -Use the [`request_add_stake`](https://github.com/MystenLabs/sui/blob/58229627970a6e9ff558b156c1cb193f246eaf88/crates/sui-framework/docs/sui_system.md#0x2_sui_system_request_add_stake) and [`request_add_stake_with_locked_coin`](https://github.com/MystenLabs/sui/blob/58229627970a6e9ff558b156c1cb193f246eaf88/crates/sui-framework/docs/sui_system.md#0x2_sui_system_request_add_stake_with_locked_coin) methods to add to the staked amount. - -Use the [`request_withdraw_stake`](https://github.com/MystenLabs/sui/blob/58229627970a6e9ff558b156c1cb193f246eaf88/crates/sui-framework/docs/sui_system.md#0x2_sui_system_request_withdraw_stake) method to withdraw all or part of the delegation. - -### Does Sui require a bonding / warm-up period? - -Yes, the specifics are still under consideration. - -### Does Sui require an un-bonding / cool-down period? - -Yes, the current un-bonding period is under consideration. - -### Are staking rewards auto-compounded? - -Yes, Sui uses a staking pool approach inspired by liquidity pools. Rewards are added to the pool and auto-compounded through the appreciation of pool token value relative to SUI tokens. - -### Do rewards appear as inbound/outbound on-chain transactions? - -Yes, rewards are added to the staking pool through a special system transaction at epoch boundaries. - -### How long does it take to get the first reward after staking? How frequently are rewards paid out? - -Rewards are compounded every epoch, and paid out when you withdraw your stake. You must stake for the entire duration of an epoch to receive rewards for that epoch. - -### How does slashing work, and what are the penalties? - -There will not be slashing for the principal stake allocated. Instead, validators will get penalized by having fewer future rewards when these get paid out. Rewards that have already been accrued are not at risk. - -### Does Sui support on-chain governance or voting? - -On-chain governance is not implemented for Sui. There is no plan to add it in the near future. - -### How can I retrieve the current block height or query a block by height using a Sui endpoint? - -Sui is [DAG](https://cointelegraph.com/explained/what-is-a-directed-acyclic-graph-in-cryptocurrency-how-does-dag-work)-based, so the block-based view of the transaction history is not always the most direct one. To get the latest transaction, use the Transaction Query API: - - ```json - { - "jsonrpc": "2.0", - "id": 1, - "method": "sui_queryTransactions", - "params": [ - "All", - , - 100, - "Ascending" - ] - } - ``` - -### How are transactions proposed by validators if they're not included in blocks? Does a validator propose blocks or just individual transactions? - -Validators form a certificate (a quorum of signatures) for each transaction, and then propose checkpoints consisting of certificates since the last checkpoint. You can read more in section 4.3 of the [Sui Smart Contract Platform](https://github.com/MystenLabs/sui/blob/main/doc/paper/sui.pdf). - -### How do I get test Devnet coins? - -- You can find our [faucet in Discord](https://discord.com/channels/916379725201563759/971488439931392130). You can also request coins from the [Sui Faucet](../build/faucet.md) programmatically. - -### How can I get in touch and request more information? - -- Please visit our [Discord server](https://discord.gg/sui). - diff --git a/doc/src/learn/tokenomics/index.md b/doc/src/learn/tokenomics/index.md index 9657ae6072458..19e231b36d745 100644 --- a/doc/src/learn/tokenomics/index.md +++ b/doc/src/learn/tokenomics/index.md @@ -12,7 +12,7 @@ This page includes a high-level overview of Sui’s economic model. The Sui economy is characterized by three main sets of participants: * **Users** submit transactions to the Sui platform in order to create, mutate, and transfer digital assets or interact with more sophisticated applications enabled by smart contracts, interoperability, and composability. -* **SUI token holders** bear the option of delegating their tokens to validators and participating in the proof-of-stake mechanism. SUI owners also hold the rights to participate in Sui’s governance. +* **SUI token holders** have the option of staking their tokens to validators and participating in the proof-of-stake mechanism. SUI owners also hold the rights to participate in Sui’s governance. * **Validators** manage transaction processing and execution on the Sui platform. The Sui economy has five core components: @@ -20,7 +20,7 @@ The Sui economy has five core components: * The [SUI token](../tokenomics/sui-token.md) is the Sui platform’s native asset. * [Gas fees](../tokenomics/gas-pricing.md) are charged on all network operations and used to reward participants of the proof-of-stake mechanism and prevent spam and denial-of-service attacks. * [Sui’s storage fund](../tokenomics/storage-fund.md) is used to shift stake rewards across time and compensate future validators for storage costs of previously stored on-chain data. -* The [proof-of-stake mechanism](../tokenomics/proof-of-stake.md) is used to select, incentivize, and reward honest behavior by the Sui platform’s operators – i.e. validators and the SUI delegators. +* The [proof-of-stake mechanism](../tokenomics/proof-of-stake.md) is used to select, incentivize, and reward honest behavior by Sui Validators and the SUI owners that stake with them. * On-chain voting is used for governance and protocol upgrades. Throughout, we use the visual representation in the following figure to aid the discussion. diff --git a/doc/src/learn/tokenomics/proof-of-stake.md b/doc/src/learn/tokenomics/proof-of-stake.md index 23802453febe8..a4781f7720406 100644 --- a/doc/src/learn/tokenomics/proof-of-stake.md +++ b/doc/src/learn/tokenomics/proof-of-stake.md @@ -6,7 +6,7 @@ The Sui platform relies on Delegated Proof-of-Stake to determine the set of vali ## SUI token staking -Within each epoch, operations are processed by a fixed set of validators, each with a specific amount of stake from SUI token holders. A validator's share of total stake is relevant in that it determines each validator’s share of voting power for processing transactions. Staking SUI implies the SUI tokens are locked for the entire epoch. SUI token holders are free to unstake their SUI or to change their selected validator when the epoch changes. +Within each epoch, operations are processed by a fixed set of validators, each with a specific amount of stake from SUI token holders. A validator's share of total stake is relevant in that it determines each validator’s share of voting power for processing transactions. Staking SUI implies the SUI tokens are locked for the entire epoch. SUI token holders are free to withdraw their SUI or to change their selected validator when the epoch changes. ## Economic model diff --git a/doc/src/learn/tokenomics/storage-fund.md b/doc/src/learn/tokenomics/storage-fund.md index 1520a8fd3b0ad..0b20b20be56bb 100644 --- a/doc/src/learn/tokenomics/storage-fund.md +++ b/doc/src/learn/tokenomics/storage-fund.md @@ -6,7 +6,7 @@ Sui includes an efficient and sustainable economic mechanism for financing data Financially, on-chain data storage introduces a severe inter-temporal challenge: validators who process and write data into storage today may differ from the future validators needing to store that data. If users were to pay fees for computation power only at write, effectively, future users would need to subsidize past users for their storage and pay disproportionately high fees. This negative network externality can become highly taxing for Sui in the future if left unaddressed. -Sui’s economic design includes a storage fund that redistributes storage fees from past transactions to future validators. When users transact on Sui, they pay fees upfront for both computation and storage. The storage fees are deposited into a storage fund used to adjust the share of future stake rewards distributed to validators relative to SUI delegators. This design is intended to provide future Sui validators with viable business models. +Sui’s economic design includes a storage fund that redistributes storage fees from past transactions to future validators. When users transact on Sui, they pay fees upfront for both computation and storage. The storage fees are deposited into a storage fund used to adjust the share of future stake rewards distributed to validators relative to the users that stake SUI with them. This design is intended to provide future Sui validators with viable business models. ## Storage fund rewards