Skip to content

Commit

Permalink
Deploying to gh-pages from @ 8b4df5e 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
mlegner committed Oct 17, 2024
1 parent f6fd60e commit 1397c26
Show file tree
Hide file tree
Showing 8 changed files with 62 additions and 60 deletions.
51 changes: 26 additions & 25 deletions blog/04_testnet_update.html
Original file line number Diff line number Diff line change
Expand Up @@ -192,56 +192,57 @@ <h1 id="announcing-testnet"><a class="header" href="#announcing-testnet">Announc
epochs, and blob deletion.</p>
<h2 id="blob-deletion"><a class="header" href="#blob-deletion">Blob deletion</a></h2>
<p>The most important user-facing new feature is optional blob deletion. The uploader of a blob can
optionally indicate a blob is "deletable". This information is stored in the Sui blob meta-data
optionally indicate a blob is "deletable". This information is stored in the Sui blob metadata
object, and is also included in the event denoting when the blob is certified. Subsequently, the
owner of the Sui blob meta-data object can "delete" it. As a result storage for the remaining
owner of the Sui blob metadata object can "delete" it. As a result storage for the remaining
period is reclaimed and can be used by subsequent blob storage operations.</p>
<p>Blob deletion allows more fine grained storage cost management: smart contracts that wrap blob
meta-data objects can define logic that stores blobs and delete them to minimize costs, and reclaim
<p>Blob deletion allows more fine-grained storage cost management: smart contracts that wrap blob
metadata objects can define logic that stores blobs and delete them to minimize costs, and reclaim
storage space before Walrus epochs end.</p>
<p>However, blob deletion is not an effective privacy mechanism in itself: copies of the blob may exist
outside Walrus storage nodes on caches and end-user stores
or devices. Furthermore, if the identical blob is stored by multiple Walrus users, the blob will
still be available on Walrus until no copy exists. Thus deleting your own copy of a blob cannot
guarantee that it is deleted from Walrus as a whole.</p>
outside Walrus storage nodes on caches and end-user stores or devices. Furthermore, if the identical
blob is stored by multiple Walrus users, the blob will still be available on Walrus until no copy
exists. Thus deleting your own copy of a blob cannot guarantee that it is deleted from Walrus as a
whole.</p>
<ul>
<li>Find out how to
<a href="../usage/client-cli.html#reclaiming-space-via-deletable-blobs">upload and delete deletable blobs</a>
thought the CLI.</li>
<li>Find out more about how <a href="../dev-guide/dev-operations.html#delete">delete operations work</a>.</li>
</ul>
<h2 id="epochs"><a class="header" href="#epochs">Epochs</a></h2>
<p>Walrus Testnet enables multiple epochs. Initially an epoch is a single day to ensure the logic of
epoch change is thoroughly tested. At Mainnet epochs will likely be multiple weeks long.</p>
<p>Now stored blob expiry epoch is meaningful, and blobs will become unavailable after their expiry
epoch. The store command may be used to extend the expiry epoch of a blob that is still available.
This operation is efficient and only affects payments and meta-data, and does not re-upload blob
contents.</p>
<p>Walrus Testnet enables multiple epochs. Initially, the epoch duration is set to a single day to
ensure the logic of epoch change is thoroughly tested. At Mainnet, epochs will likely be multiple
weeks long.</p>
<p>The progress of epochs makes the expiry epoch of blobs meaningful, and blobs will become unavailable
after their expiry epoch. The store command may be used to extend the expiry epoch of a blob that is
still available. This operation is efficient and only affects payments and metadata, and does not
re-upload blob contents.</p>
<ul>
<li>Find out the <a href="../usage/client-cli.html#walrus-system-information">current epoch</a> through the CLI.</li>
<li>Find out how to store a blob for
<a href="../usage/client-cli.html#storing-querying-status-and-reading-blobs">multiple epochs</a>.</li>
</ul>
<h2 id="the-wal-token-and-the-testnet-wal-faucet"><a class="header" href="#the-wal-token-and-the-testnet-wal-faucet">The WAL token and the Testnet WAL faucet</a></h2>
<p>Payments for blob storage and extending blob expiry are denominated in Testnet WAL, a
Walrus token issued on the Sui Testnet. Testnet WAL has no value, and an unlimited supply - so no
need to covet or hoard it - its just for testing purposes and only issued on Sui Testnet.</p>
Walrus token issued on the Sui Testnet. Testnet WAL has no value, and an unlimited supply; so no
need to covet or hoard it, it's just for testing purposes and only issued on Sui Testnet.</p>
<p>WAL also has a smaller unit called FROST, similar to MIST for SUI. 1 WAL is equal to 1 billion
(1000000000) FROST.</p>
<p>To make Testnet WAL available to all who want to experiment with the Walrus Testnet we provide a
utility and smart contract to convert Testnet SUI (which also has no value) into Testnet WAL using
a one-to-one exchange rate. This is chosen arbitrarily, and generally one should not read too much
into the actual WAL denominated costs of storage on Testnet. They have been chosen arbitrarily.</p>
<p>Find out how to <a href="../usage/setup.html#testnet-wal-faucet">request Test WAL tokens</a> through the CLI.</p>
<p>Find out how to <a href="../usage/setup.html#testnet-wal-faucet">request Testnet WAL tokens</a> through the CLI.</p>
<h2 id="decentralization-through-staking--unstaking"><a class="header" href="#decentralization-through-staking--unstaking">Decentralization through staking &amp; unstaking</a></h2>
<p>The WAL token may also be used to stake with storage operators. Staked WAL can be unstaked and
re-staked with other operators or used to purchase storage.</p>
<p>Each epoch storage nodes are selected and allocated storage shards according to their delegated
stake. At the end of each epoch payments for storing blobs for the epoch are distributed to storage
nodes and those that delegate stake to them. Furthermore, important network parameters - such as
total available storage and storage price - are set by the selected storage operators each epoch
nodes and those that delegate stake to them. Furthermore, important network parameters (such as
total available storage and storage price) are set by the selected storage operators each epoch
according to their stake weight.</p>
<p>A staking web dApps is provided to experiment with this functionality. Community members have also
<p>A staking web dApp is provided to experiment with this functionality. Community members have also
created explorers that can be used to view storage nodes when considering who to stake with. Staking
ensures that the ultimate governance of Walrus, directly in terms of storage nodes, and indirectly
in terms of parameters and software they chose, rests with WAL Token holders.</p>
Expand All @@ -250,13 +251,13 @@ <h2 id="decentralization-through-staking--unstaking"><a class="header" href="#de
stake; efficient ways to sync state between storage nodes; as well as better ways for storage nodes
to follow Sui event streams.</p>
<ul>
<li>Explore the <a href="https://stake.walrus.site">Walrus staking dApp</a></li>
<li>Look at recent activity on the <a href="https://walruscan.com/testnet/home">Walrus Explorer</a></li>
<li>Explore the <a href="https://stake.walrus.site">Walrus staking dApp</a>.</li>
<li>Look at recent activity on the <a href="https://walruscan.com/testnet/home">Walrus Explorer</a>.</li>
</ul>
<h2 id="new-move-contracts--documentation"><a class="header" href="#new-move-contracts--documentation">New Move contracts &amp; documentation</a></h2>
<p>As part of the Testnet release of Walrus the documentation and Move Smart contracts have been
updated, and can be found at the <a href="https://github.com/MystenLabs/walrus-docs">Walrus-docs repository</a>
and as a <a href="https://docs.walrus.site/">Walrus Docs Site</a>.</p>
<p>As part of the Testnet release of Walrus, the documentation and Move Smart contracts have been
updated, and can be found in the <a href="https://github.com/MystenLabs/walrus-docs"><code>walrus-docs</code>
repository</a>.</p>
<h2 id="new-walrus-sites-features"><a class="header" href="#new-walrus-sites-features">New Walrus Sites features</a></h2>
<p>With the move to Walrus Testnet, Walrus Sites have also been updated! The new features in this
update greatly increase the flexibility, speed, and security of Walrus Sites. Developers can now
Expand Down
2 changes: 1 addition & 1 deletion dev-guide/dev-operations.html
Original file line number Diff line number Diff line change
Expand Up @@ -260,7 +260,7 @@ <h2 id="certify-availability"><a class="header" href="#certify-availability">Cer
<p>Once a blob is certified, Walrus will ensure that sufficient slivers will always be
available on storage nodes to recover it within the specified epochs.</p>
<h2 id="delete"><a class="header" href="#delete">Delete</a></h2>
<p>Stored blobs can be optionally set as deletable by the user that creates them. This meta-data is
<p>Stored blobs can be optionally set as deletable by the user that creates them. This metadata is
stored in the Sui blob object, and whether a blob is deletable or not is included in certified blob
events. A deletable blob may be deleted by the owner of the blob object, to reclaim and re-use
the storage resource associated with it.</p>
Expand Down
2 changes: 1 addition & 1 deletion dev-guide/sui-struct.html
Original file line number Diff line number Diff line change
Expand Up @@ -263,7 +263,7 @@ <h2 id="events"><a class="header" href="#events">Events</a></h2>
that they should expect slivers associated with its Blob ID. Eventually when the blob is
certified, a <code>BlobCertified</code> is emitted containing information about the blob ID and the epoch
after which the blob will be deleted. Before that epoch the blob is guaranteed to be available.</p>
<pre><code class="language-move">/// Signals that a blob with meta-data has been registered.
<pre><code class="language-move">/// Signals that a blob with metadata has been registered.
public struct BlobRegistered has copy, drop {
epoch: u32,
blob_id: u256,
Expand Down
Loading

0 comments on commit 1397c26

Please sign in to comment.