Merge pull request #1041 from oasisprotocol/rube/979-remove-truffle-section-from-emerald

docs: move emerald and cipher into other-paratimes

Author: rube-de

docs/README.mdx

@@ -32,14 +32,14 @@ The part also covers other ParaTimes such as the non-confidential
 <DocCardList items={[
     findSidebarItem('/dapp/sapphire/'),
     findSidebarItem('/dapp/opl/'),
-    findSidebarItem('/dapp/emerald/'),
-    findSidebarItem('/dapp/cipher/'),
+    findSidebarItem('/dapp/tools/other-paratimes/emerald/'),
+    findSidebarItem('/dapp/tools/other-paratimes/cipher/'),
 ]} />
 
 [Oasis Sapphire]: dapp/sapphire/README.mdx
 [Oasis Privacy Layer]: dapp/opl/README.mdx
-[Oasis Emerald]: dapp/emerald/README.mdx
-[Oasis Cipher]: dapp/emerald/README.mdx
+[Oasis Emerald]: dapp/tools/other-paratimes/emerald/README.mdx
+[Oasis Cipher]: dapp/tools/other-paratimes/cipher/README.mdx
 
 ## Build ROFL
 

docs/dapp/README.mdx

@@ -12,17 +12,17 @@ import {findSidebarItem} from '@site/src/sidebarUtils';
 
 The [Oasis architecture] is designed to have a simple, robust consensus layer
 on top which connects handful of ParaTimes executing smart contracts.
-DApp developers may choose among those ParaTimes depending on whether they
-require confidentiality and/or EVM-compatibility.
 
-Learn more by exploring the ParaTimes below!
+[Sapphire] is the primary ParaTime. It is EVM-compatible and allows you to
+write both confidential and non-confidential smart contracts.
 
-|                      | EVM-compatible                                        | Oasis Wasm                                          |
-|---------------------:|-------------------------------------------------------|-----------------------------------------------------|
-| **Confidential**     | <DocCard item={findSidebarItem('/dapp/sapphire/')} /> | <DocCard item={findSidebarItem('/dapp/cipher/')} /> |
-| **Non-Confidential** | <DocCard item={findSidebarItem('/dapp/emerald/')} />  |                                                     |
+For an overview of the other ParaTimes, refer to the [Other ParaTimes] chapter.
 
 [Oasis architecture]: ../general/oasis-network/README.mdx
+[Sapphire]: https://github.com/oasisprotocol/docs/blob/main/docs/dapp/sapphire/README.mdx
+[Other ParaTimes]: ./tools/other-paratimes/README.mdx
+
+## Oasis Privacy Layer
 
 In addition to building fully native dApps running on one of the Oasis
 ParaTimes, you can also add privacy to your existing dApps running on other,

docs/dapp/cipher/README.mdx

@@ -16,8 +16,8 @@ for full list of deployed contract addresses.
 
 :::
 
-[paratime]: /general/oasis-network/faq#how-is-a-paratime-different-from-a-parachain
-[emerald]: /dapp/emerald
+[paratime]: ../../general/oasis-network/faq#how-is-a-paratime-different-from-a-parachain
+[emerald]: ./other-paratimes/emerald/README.mdx
 [band-supported-blockchains]: https://docs.bandchain.org/develop/supported-blockchains
 
 ### What is the Band Protocol?

docs/dapp/cipher/confidential-smart-contract.md

@@ -0,0 +1,22 @@
+---
+description: Other Paratimes
+---
+import DocCard from '@theme/DocCard';
+import DocCardList from '@theme/DocCardList';
+import {findSidebarItem} from '@site/src/sidebarUtils';
+
+# Other ParaTimes
+
+In addition to our primary ParaTime, [Sapphire], several additional ParaTimes
+are running on top of the consensus layer.
+DApp developers can choose a Paratime to build on according to their
+specific requirements, such as confidentiality and EVM compatibility.
+
+Learn more by exploring the ParaTimes below!
+
+|                      | EVM-compatible                                        | Oasis Wasm                                          |
+|---------------------:|-------------------------------------------------------|-----------------------------------------------------|
+| **Confidential**     | <DocCard item={findSidebarItem('/dapp/sapphire/')} /> | <DocCard item={findSidebarItem('/dapp/tools/other-paratimes/cipher/')} /> |
+| **Non-Confidential** | <DocCard item={findSidebarItem('/dapp/tools/other-paratimes/emerald/')} />  | |
+
+[Sapphire]: https://github.com/oasisprotocol/docs/blob/main/docs/dapp/sapphire/README.mdx

docs/dapp/cipher/hello-world.md

@@ -0,0 +1,63 @@
+import DocCard from '@theme/DocCard';
+import DocCardList from '@theme/DocCardList';
+import {findSidebarItem} from '@site/src/sidebarUtils';
+
+# Cipher ParaTime
+
+Cipher is a confidential ParaTime for executing Wasm smart contracts.
+
+As an officially supported ParaTime by the Oasis Protocol Foundation, Cipher
+allows for:
+
+* Flexibility: developer can define which data to store in a public
+  and which data in the (more expensive) confidential storage
+* Security: the [Rust language] primarily used for writing Wasm smart contracts
+  is known for its strict memory management and was developed specifically to
+  avoid memory leaks
+* Scalability: increased throughput of transactions
+* Low-cost: 99%+ lower fees than Ethereum
+* 6 second finality (1 block)
+* Cross-chain bridge to enable cross-chain interoperability (upcoming)
+
+If you're looking for EVM-compatible ParaTimes, check out the
+[Emerald](../emerald/README.mdx) and the confidential
+[Sapphire](https://github.com/oasisprotocol/sapphire-paratime/blob/main/docs/README.mdx) paratimes.
+
+[Rust language]: https://www.rust-lang.org/
+
+## Network Information
+
+See crucial network information [here][network].
+
+[network]: ./network.mdx
+
+## Smart Contract Development
+
+Cipher implements the [Oasis Contract SDK] API. To learn how to write a
+confidential smart contract in Rust and deploy it on Cipher, read the related
+Oasis Contract SDK chapters:
+
+<DocCard item={
+    findSidebarItem('/dapp/tools/other-paratimes/cipher/prerequisites')
+} />
+
+<DocCard item={
+    findSidebarItem('/dapp/tools/other-paratimes/cipher/hello-world')
+} />
+
+<DocCard item={
+    findSidebarItem('/dapp/tools/other-paratimes/cipher/confidential-smart-contract')
+} />
+
+## See also
+
+<DocCardList items={[
+    findSidebarItem('/general/manage-tokens/'),
+    findSidebarItem('/node/run-your-node/paratime-node'),
+    findSidebarItem('/node/run-your-node/paratime-client-node'),
+    findSidebarItem('/dapp/tools/other-paratimes/emerald/'),
+    findSidebarItem('/dapp/sapphire/'),
+]} />
+
+[Oasis Contract SDK]:
+  https://github.com/oasisprotocol/oasis-sdk/tree/main/contract-sdk

docs/dapp/cipher/prerequisites.md

@@ -0,0 +1 @@
+../../../../../external/oasis-sdk/docs/contract/confidential-smart-contract.md