Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

FAQ cleanup #1268

Merged
merged 3 commits into from
Apr 7, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 24 additions & 38 deletions doc/src/contribute/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Use these online resources:

### What does Sui offer over other blockchains?

Sui offers ease of development, a developer interface, fast transaction speeds, a sane object model, and better security. Sui calls the consensus protocol only for transactions affecting objects owned by multiple accounts. This means simple sends can happen almost immediately.
Sui offers ease of development, a developer interface, fast transaction speeds, a sane object model, and better security. Sui calls the consensus protocol only for transactions affecting objects owned by multiple accounts. This means simple transactions complete almost immediately.

See these resources on the [Sui Developer Portal](https://docs.sui.io/) for the complete story on why we built Sui:

Expand Down Expand Up @@ -53,9 +53,13 @@ There is no relationship between Sui/Mysten and Aptos. The similarity is that th
## Roadmap


### Can I buy the Sui token? Is Mysten labs' token name SUI?
### Can I buy the Sui token?

There is currently no timeline for a public Sui token sale. We will have a public token by the time mainnet launches, but it is not available right now and there is no timeline as of yet. Anyone who claims otherwise (offering tokens, whitelists, pre-sale, etc.) is running a scam."
We will have a public token for the Sui mainnet. But it is not available right now and there is no timeline as of yet. Anyone who claims otherwise (offering tokens, whitelists, pre-sale, etc.) is running a scam.

### Will the token name be SUI?

Yes, the token name will be SUI.


### When is the Sui devnet/testnet/mainnet launching?
Expand All @@ -69,25 +73,32 @@ A testnet is coming in a few months. See our roadmap: \
No. More information is forthcoming.


## Getting involved {#getting-involved}
## Getting involved


### How can I join the Sui network? How do I participate in the Sui project?

Here are the current participation methods:
Join our [Discord](https://discord.gg/mysten) and follow our [Twitter](https://twitter.com/Mysten_Labs) for the latest updates and announcements.

For developers:

1. Download the [Sui SDK](https://app.swaggerhub.com/apis/MystenLabs/sui-api/) and start building.
1. [Install Sui](https://docs.sui.io/build/install).
1. Download the [Sui SDK](https://app.swaggerhub.com/apis/MystenLabs/sui-api/).
1. Spin up a [local node](../build/wallet.md).
1. Join the [Move](https://discord.gg/8prNjUqyFj) and [Sui](https://discord.gg/CVcnUzKYCB) developer channels in Discord.
1. Use the SDK for [testing packages](https://docs.sui.io/build/move#testing-a-package).
1. [Start building](https://docs.sui.io/build)!

### Are there things we can already try if we are not a developer?

We have a number of examples and demos available for viewing at: [https://docs.sui.io/explore](../explore)

### Are you looking for partners?

We are seeking partners that can contribute to the ecosystem primarily in development by building apps with the SDK now so they can be ready to launch when the network goes live.


### With whom can I talk about a partnership or strategic investment? How can I discuss Sui in person?
Start in [Discord](https://discord.gg/mysten).
Start in [Discord](https://discord.gg/mysten).


### Where can I see the investors of the project?
Expand All @@ -100,39 +111,30 @@ See the [mystenlabs.com](https://mystenlabs.com/) website for company details.
Wait until the community managers are on board. The managers will plan for growing and engaging the community. Stay tuned in Discord.


### I'm looking for someone from the Mysten Crew to speak at a student club web3 event - is there someone I can DM/email?
### I'm looking for someone from the Mysten Crew to speak at an event - is there someone I can DM/email?

Ask in Discord.


## Development


### Are there things we can already test if we are not a developer?

We have a number of examples and demos available for viewing at: [https://docs.sui.io/explore](../explore)


### Once a Move package is published to the Sui network, is there any way for devs to update the code?

Not currently. Packages are immutable objects, and this property is relied upon in several places.


### Is there any information on node architecture and running validators on Sui?

Section four in the[ Sui Smart Contract Platform](https://github.com/MystenLabs/sui/blob/main/doc/paper/sui.pdf) white paper is the best reference for node architecture.
Section four in the [Sui Smart Contract Platform](https://github.com/MystenLabs/sui/blob/main/doc/paper/sui.pdf) white paper is the best reference for node architecture.


### Can I run a Sui validator node?

We do not yet have a public devnet or testnet that will allow others to operate Sui nodes. You can run a Sui node or Sui network locally. Check out our [Wallet](https://docs.sui.io/build/wallet) documentation and then speak to it either using the [Wallet CLI](../build/wallet#command-line-mode) or [REST API](../build/rest-api).

You can run the [SDK](https://app.swaggerhub.com/apis/MystenLabs/sui-api/) for a local, non-networked node for development. We do not yet have a public devnet or testnet that will allow others to operate Sui nodes, but both are on our [roadmap](https://github.com/MystenLabs/sui/blob/main/ROADMAP.md#roadmap).
We do not yet have a public devnet or testnet that will allow others to operate Sui nodes, but both are on our [roadmap](https://github.com/MystenLabs/sui/blob/main/ROADMAP.md#roadmap). Right now, you can run a local, non-networked Sui node for development. Check out our [Wallet](https://docs.sui.io/build/wallet) documentation to get started. You can interact with the local node via either the [Wallet CLI](../build/wallet#command-line-mode) or [REST API](../build/rest-api).

### What does a local node do and what are the hardware requirements to run it? How is it different from a testnet node?

### What does a local node do and what hardware requirements will I be needing to run it? How is it different from the coming testnet node?

A local node allows you to build software using Move for Sui. On a single core m1, it should run 30k TPS. Testnet will be running on a network of validators. So, with enough nodes or validators running on mainnet..Sui will do 30k tps blazing speeds. An 8-core machine runs 120k TPS unoptimized for simple transactions.
A local node allows you to start building software using Move for Sui, and can be run on commodity hardware. A testnet node will be part of a live network of validators.


## Technology
Expand All @@ -148,22 +150,6 @@ See [Why move?](../learn/why-move) for more details on this. In addition, see th

Finally, the EVM developer community is very small--approximately 4,000 programmers according to [this study](https://medium.com/electric-capital/electric-capital-developer-report-2021-f37874efea6d). Compare this to (e.g.) the [>20M registered iOS developers](https://techcrunch.com/2018/06/04/app-store-hits-20m-registered-developers-at-100b-in-revenues-500m-visitors-per-week/#:~:text=Today%20at%20WWDC%2C%20Apple's%20CEO,500%20million%20visitors%20per%20week.). Thus, the practical path to scaling the smart contract dev community is to bring folks in from the broader population, not to pull them from the tiny pool of existing Solidity developers. We think Move is much safer and much more approachable for mainstream programmers than the EVM.


### Is there a difference in principle between Solana Sealevel and Sui execution?

Q: For transactions involving shared objects, the broad strokes look similar. Obviously, every Solana transaction would go through the consensus mechanism in Solana

A: As far as parallelism goes:

Solana does optimistic concurrency control, which is to launch a bunch of TX executions in parallel, and retry in some sequence those for which that didn't work. One difference is they're discovering the causal dependencies between TXes: by the time a TX with dependencies is run successfully, that may be its second (or more) execution.

For Sui, the causality is declared up front and the TX is run after its dependents. (You might call this "pessimistic" by contrast.)

Naturally, as you point out, there are many, many other differences the moment you zoom out of the precise question of concurrent execution (degree of consensus involvement, flow of the TX to an authority, leaderless architecture, etc.).

Solana declares a weaker form of concurrency, that is state registers the TX will access in either mode, and that's a useful heuristic for sure. We declare object versions the execution engine must have before executing.


### Is Sui an L2, or are there plans to support L2s?

Sui tackles scaling at the base layer rather than via L2s. We think this approach leads to a more user and developer-friendly system than adding additional complexity on top of an already-complex base layer that doesn't scale.
Expand Down