Create sui-glossary.md #766
Conversation
Launch initial glossary of terms for Sui
Clay-Mysten
requested review from
666lcz,
awelc,
gdanezis,
huitseeker,
lxfind,
sblackshear and
velvia
|
|
||
| ### Authority | ||
|
|
||
| An authority in Sui plays a passive role analogous to the more active role of validators and minors in other blockchains. In Sui, |
There was a problem hiding this comment.
There was a discussion about this from @gdanezis @adeabiodun and others. Basically "passive" is no longer true or won't be true soon as we add features such as shared objects which require consensus, plus other things down the line like state agreement.
The other question for everyone is since authorities are becoming active should we just call them validators?
There was a problem hiding this comment.
I would file an issue for this update as we use passive already in our docs. And you will have better luck getting a decision from others in a bug, for sure.
|
|
||
| ### Certificate | ||
|
|
||
| A certificate is the mechanism proving a transaction has been approved, or certified. Authorities vote on transactions, and the sender collects |
There was a problem hiding this comment.
Should we say gateway here instead of "sender"? Just to clarify we don't mean the end user.
There was a problem hiding this comment.
Actually, I get the impression the gateway is optional. End users may act as senders directly, eating the bandwidth cost a gateway would help them avoid. I could be mistaken. Feel free to edit directly when you have an answer.
There was a problem hiding this comment.
@huitseeker for comment here, as well.
doc/src/learn/sui-glossary.md
Outdated
|
|
||
| ### Epoch | ||
|
|
||
| An [epoch](https://coinmarketcap.com/alexandria/glossary/epoch) refers to the period between increments made in a blockchain, for instance before |
There was a problem hiding this comment.
Epochs more refer to long periods of time in a blockchain, typically at which point there is an agreement event between the nodes in a chain, and potential membership changes.
There was a problem hiding this comment.
@huitseeker for guidance as he seemed to indicate these were smaller periods in our talk within the Sui world at least.
Making accumulator-gateway relationship clear
Fixed epoch entry and linked to our canonical definition
gdanezis
added
the
Type: Documentation
|
Ping? |
| Find terms used in Sui defined below. Where possible, we link to a canonical definition and focus upon Sui’s use of the term. | ||
|
|
||
|
|
||
| ### Accumulator |
There was a problem hiding this comment.
First time hearing about this. Is this used somewhere in our design?
There was a problem hiding this comment.
I know a few folks have used this term to explain things but guess the impt Q is usage in other docs
| check of the sender’s account, greatly speeding transaction times. | ||
|
|
||
|
|
||
| ### Total order |
There was a problem hiding this comment.
Might want to put Total Order together with Causal Order
| smart contracts are written in the [Move](https://github.com/MystenLabs/awesome-move) programming language. | ||
|
|
||
|
|
||
| ### Single-writer objects |
There was a problem hiding this comment.
First time hearing about this, is this referenced/used anywhere?
There was a problem hiding this comment.
I'm not sure what we call non-shared objects, regular objects? Owned objects (to use a Rust term?)
| exchange of private keys, third parties may offload bandwidth use from mobile device to server - for a fee. | ||
|
|
||
|
|
||
| ### Multi-writer objects |
There was a problem hiding this comment.
This definition seems problematic, I think we call it Shared Mutable Object, and it's shared by everyone, not just more than one account.
There was a problem hiding this comment.
Yeah I think it's better to say "Shared Mutable Object", I see that term used everywhere, and explain that it means multiple people can write.
There was a problem hiding this comment.
Please edit in the Google Doc. Thanks!
Alright, Doc for drafting here: Thanks! |
Launch initial glossary of terms for Sui