docs: Revamp dapp to build

README.md

@@ -86,7 +86,7 @@ link checker in `package.json`._
 ### Documentation structure
 
 `docs` folder contains markdown files of the documentation. Each subfolder
-represents a documentation **part** (general, node, dApp, paratime, core etc.).
+represents a documentation **part** (general, node, build, paratime, core etc.).
 Each markdown file inside a part corresponds to a **chapter** (subchapter for a
 markdown file inside a subfolder) and each subtitle of a chapter is called a
 **section** (subsection etc.).
@@ -191,7 +191,7 @@ the redirection.
 There are three kinds of image assets used in the docs.
 
 1. Screenshots, photos, non-technical figures go into `images/` folder
-   on the part-level (i.e. `docs/dapp/images`). External repositories may use
+   on the part-level (i.e. `docs/build/images`). External repositories may use
    own images in their respective folder.
 2. [Mermaid](https://mermaid-js.github.io) diagrams (preferred tool for
    sequence diagrams, flowcharts and other technical material) live in
@@ -225,7 +225,7 @@ and their usage including the articles:
   The consensus layer only supports the Ed25519 signature scheme.
 - Emerald
 - dApp
-  Emerald supports writing dApps. DApp is a modern distributed application.
+  Sapphire supports writing dApps. DApp is a modern distributed application.
 - key manager
 - key manager node
 - Mainnet

docs/README.mdx

@@ -17,7 +17,7 @@ chains and how to use unique Oasis features.
     findSidebarItem('/general/manage-tokens/cli/'),
 ]} />
 
-## Create dApp
+## Build
 
 Contains learning material for the smart contract developers. Since the Oasis
 platform is best known for confidentiality, the most notable ParaTime is
@@ -30,16 +30,16 @@ The part also covers other ParaTimes such as the non-confidential
 [Oasis Emerald] and Wasm-compatible, confidential [Oasis Cipher].
 
 <DocCardList items={[
-    findSidebarItem('/dapp/sapphire/'),
-    findSidebarItem('/dapp/opl/'),
-    findSidebarItem('/dapp/tools/other-paratimes/emerald/'),
-    findSidebarItem('/dapp/tools/other-paratimes/cipher/'),
+    findSidebarItem('/build/sapphire/'),
+    findSidebarItem('/build/opl/'),
+    findSidebarItem('/build/tools/other-paratimes/emerald/'),
+    findSidebarItem('/build/tools/other-paratimes/cipher/'),
 ]} />
 
-[Oasis Sapphire]: dapp/sapphire/README.mdx
-[Oasis Privacy Layer]: dapp/opl/README.mdx
-[Oasis Emerald]: dapp/tools/other-paratimes/emerald/README.mdx
-[Oasis Cipher]: dapp/tools/other-paratimes/cipher/README.mdx
+[Oasis Sapphire]: ./build/sapphire/README.mdx
+[Oasis Privacy Layer]: ./build/opl/README.mdx
+[Oasis Emerald]: ./build/tools/other-paratimes/emerald/README.mdx
+[Oasis Cipher]: ./build/tools/other-paratimes/cipher/README.mdx
 
 ## Build ROFL
 
@@ -48,7 +48,7 @@ offchain in a trusted environment (TEE) and that seamlessly communicate with
 Oasis Sapphire. This is ideal for trusted oracles, compute-expensive tasks
 in AI or as a backend for interactive games.
 
-<DocCard item={findSidebarItem('/rofl/')} />
+<DocCard item={findSidebarItem('/build/rofl/')} />
 
 ## Get Involved
 
@@ -83,7 +83,7 @@ Apart from the Sapphire, Emerald, Cipher and the Key manager ParaTimes,
 you can also write, compile, sign and deploy your own ParaTime on the Oasis
 Network. This part describes the knobs you need to use to do so.
 
-<DocCard item={findSidebarItem('/paratime/')} />
+<DocCard item={findSidebarItem('/build/tools/build-paratime/')} />
 
 ## Develop Core
 

docs/dapp/README.mdx → docs/build/README.mdx

@@ -6,7 +6,7 @@ import DocCard from '@theme/DocCard';
 import DocCardList from '@theme/DocCardList';
 import {findSidebarItem} from '@site/src/sidebarUtils';
 
-# Create dApp
+# Build
 
 ![Oasis architectural design including ParaTime and consensus layers](../general/images/architecture/technology_scalability.svg)
 
@@ -19,7 +19,7 @@ write both confidential and non-confidential smart contracts.
 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
+[Sapphire]: https://github.com/oasisprotocol/docs/blob/main/docs/build/sapphire/README.mdx
 [Other ParaTimes]: ./tools/other-paratimes/README.mdx
 
 ## Oasis Privacy Layer
@@ -34,7 +34,16 @@ integrating bridges and wrapping the OpenZeppelin ERC2771 contract on top of
 Sapphire, demonstrates best practices for writing confidential smart contracts
 and working examples for you to explore and extend.
 
-<DocCard item={findSidebarItem('/dapp/opl/')} />
+<DocCard item={findSidebarItem('/build/opl/')} />
+
+## ROFL
+
+Runtime OFfchain Logic (ROFL) enables you to build secure applications running
+offchain in a trusted environment (TEE) and that seamlessly communicate with
+Oasis Sapphire. This is ideal for trusted oracles, compute-expensive tasks
+in AI or as a backend for interactive games.
+
+<DocCard item={findSidebarItem('/build/rofl/')} />
 
 ## Consensus Layer RPC Endpoints
 
@@ -72,7 +81,7 @@ Public gRPC endpoints (in alphabetic order):
 
 | Name (Provider)                              | Mainnet URL               | Testnet URL                   |
 |----------------------------------------------|---------------------------|-------------------------------|
-| Oasis Scan ([Bit Cat])                       | https://www.oasisscan.com | https://testnet.oasisscan.com |
+| Oasis Scan ([Bit Cat])                       | `https://www.oasisscan.com` | `https://testnet.oasisscan.com` |
 | Oasis Explorer ([Oasis Protocol Foundation]) | *Coming soon*             | *Coming soon*                 |
 
 [Bit Cat]: https://www.bitcat365.com/

docs/dapp/opl/README.mdx → docs/build/opl/README.mdx

@@ -22,7 +22,7 @@ For more information about OPL and to catch the latest news, please visit the
 [official OPL page].
 
 [official OPL page]: https://oasisprotocol.org/opl
-[Sapphire]: ../sapphire/README.mdx
+[Sapphire]: https://github.com/oasisprotocol/docs/blob/main/docs/build/sapphire/README.mdx
 
 ## How OPL Works
 
@@ -40,7 +40,7 @@ messages, please visit our [Gasless Transactions chapter].
 
 :::
 
-[Gasless Transactions chapter]: ../sapphire/gasless.md
+[Gasless Transactions chapter]: https://github.com/oasisprotocol/docs/blob/main/docs/build/sapphire/develop/gasless.md
 
 ## Message Bridges
 
@@ -65,9 +65,9 @@ enables seamless state transitions across multiple chains.
 ## Examples
 
 <DocCardList items={[
-    findSidebarItem('/dapp/opl/opl-sdk/ping-example'),
-    findSidebarItem('/dapp/opl/celer/ping-example'),
-    findSidebarItem('/dapp/opl/router-protocol/pingpong-example'),
+    findSidebarItem('/build/opl/opl-sdk/ping-example'),
+    findSidebarItem('/build/opl/celer/ping-example'),
+    findSidebarItem('/build/opl/router-protocol/pingpong-example'),
     ]} />
 
 [OPL SDK]: ./opl-sdk/README.md

docs/dapp/opl/celer/ping-example.md → docs/build/opl/celer/ping-example.md

@@ -22,7 +22,7 @@ The only prerequisite is a set-up Metamask account.
 If you're new to Remix, follow our basic guide for using Remix
 [here][dapp-remix].
 
-[dapp-remix]: /dapp/tools/remix.md
+[dapp-remix]: ../../tools/remix.md
 
 :::
 

docs/dapp/opl/opl-sdk/ping-example.md → docs/build/opl/opl-sdk/ping-example.md

@@ -23,7 +23,7 @@ The only prerequisite is a set-up Metamask account.
 If you're new to Remix, follow our basic guide for using Remix
 [here][dapp-remix].
 
-[dapp-remix]: /dapp/tools/remix.md
+[dapp-remix]: ../../tools/remix.md
 
 :::
 

docs/dapp/opl/router-protocol/pingpong-example.md → docs/build/opl/router-protocol/pingpong-example.md

@@ -22,7 +22,7 @@ The only prerequisite is a set-up Metamask account.
 If you're new to Remix, follow our basic guide for using Remix
 [here][dapp-remix].
 
-[dapp-remix]: /dapp/tools/remix.md
+[dapp-remix]: ../../tools/remix.md
 
 :::
 
@@ -281,7 +281,7 @@ For detailed instructions on fee payer approval, see our [approval guide].
 
 [Router faucet]: https://faucet.routerprotocol.com/
 [feepayer]: https://testnet.routerscan.io/feePayer
-[approval guide]: /dapp/opl/router-protocol/approve
+[approval guide]: ./approve.md
 
 ## Executing PingPong
 

docs/rofl/README.mdx → docs/build/rofl/README.mdx

@@ -22,8 +22,8 @@ This chapter will teach you how to build your own ROFL app with the help of the
 [Oasis Runtime SDK].
 
 <DocCardList items={[
-    findSidebarItem('/rofl/prerequisites'),
-    findSidebarItem('/rofl/app'),
+    findSidebarItem('/build/rofl/prerequisites'),
+    findSidebarItem('/build/rofl/app'),
 ]} />
 
 [Oasis Runtime SDK]:

docs/build/rofl/app.mdx

@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/app.mdx

docs/build/rofl/deployment.md

@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/deployment.md

docs/build/rofl/prerequisites.md

@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/prerequisites.md

docs/build/rofl/rofl.svg

@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/rofl.svg

docs/build/rofl/trust-root.md

@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/trust-root.md

docs/dapp/tools/README.mdx → docs/build/tools/README.mdx

@@ -18,9 +18,9 @@ Oasis.
 ## See also
 
 <DocCardList items={[
-  findSidebarItem('/dapp/tools/abi-playground'),
-  findSidebarItem('/dapp/tools/verification'),
-  findSidebarItem('/dapp/tools/localnet'),
-  findSidebarItem('/dapp/tools/band'),
-  findSidebarItem('/dapp/tools/remix'),
+  findSidebarItem('/build/tools/abi-playground'),
+  findSidebarItem('/build/tools/verification'),
+  findSidebarItem('/build/tools/localnet'),
+  findSidebarItem('/build/tools/band'),
+  findSidebarItem('/build/tools/remix'),
 ]} />

docs/paratime/README.mdx → docs/build/tools/build-paratime/README.mdx

@@ -11,10 +11,10 @@ This chapter will teach you how to build your own ParaTime with [Oasis Runtime
 SDK].
 
 <DocCardList items={[
-    findSidebarItem('/paratime/prerequisites'),
-    findSidebarItem('/paratime/minimal-runtime'),
-    findSidebarItem('/paratime/modules'),
-    findSidebarItem('/paratime/reproducibility'),
+    findSidebarItem('/build/tools/build-paratime/prerequisites'),
+    findSidebarItem('/build/tools/build-paratime/minimal-runtime'),
+    findSidebarItem('/build/tools/build-paratime/modules'),
+    findSidebarItem('/build/tools/build-paratime/reproducibility'),
     findSidebarItem('https://api.docs.oasis.io/rust/oasis_runtime_sdk'),
 ]} />
 

docs/build/tools/build-paratime/minimal-runtime.md

@@ -0,0 +1 @@
+../../../../external/oasis-sdk/docs/runtime/minimal-runtime.md

docs/build/tools/build-paratime/modules.md

@@ -0,0 +1 @@
+../../../../external/oasis-sdk/docs/runtime/modules.md

docs/build/tools/build-paratime/prerequisites.md

@@ -0,0 +1 @@
+../../../../external/oasis-sdk/docs/runtime/prerequisites.md

docs/build/tools/build-paratime/reproducibility.md

@@ -0,0 +1 @@
+../../../../external/oasis-sdk/docs/runtime/reproducibility.md

docs/dapp/tools/other-paratimes/README.mdx → docs/build/tools/other-paratimes/README.mdx

@@ -16,7 +16,7 @@ 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/')} />  | |
+| **Confidential**     | <DocCard item={findSidebarItem('/build/sapphire/')} /> | <DocCard item={findSidebarItem('/build/tools/other-paratimes/cipher/')} /> |
+| **Non-Confidential** | <DocCard item={findSidebarItem('/build/tools/other-paratimes/emerald/')} />  | |
 
-[Sapphire]: https://github.com/oasisprotocol/docs/blob/main/docs/dapp/sapphire/README.mdx
+[Sapphire]: https://github.com/oasisprotocol/docs/blob/main/docs/build/sapphire/README.mdx

docs/dapp/tools/other-paratimes/cipher/README.mdx → docs/build/tools/other-paratimes/cipher/README.mdx

@@ -38,15 +38,15 @@ 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')
+    findSidebarItem('/build/tools/other-paratimes/cipher/prerequisites')
 } />
 
 <DocCard item={
-    findSidebarItem('/dapp/tools/other-paratimes/cipher/hello-world')
+    findSidebarItem('/build/tools/other-paratimes/cipher/hello-world')
 } />
 
 <DocCard item={
-    findSidebarItem('/dapp/tools/other-paratimes/cipher/confidential-smart-contract')
+    findSidebarItem('/build/tools/other-paratimes/cipher/confidential-smart-contract')
 } />
 
 ## See also
@@ -55,8 +55,8 @@ Oasis Contract SDK chapters:
     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/'),
+    findSidebarItem('/build/tools/other-paratimes/emerald/'),
+    findSidebarItem('/build/sapphire/'),
 ]} />
 
 [Oasis Contract SDK]:

docs/dapp/tools/other-paratimes/cipher/network.mdx → docs/build/tools/other-paratimes/cipher/network.mdx

@@ -61,4 +61,4 @@ and wish to be added to these docs, open an issue at
 
 :::
 
-[github.com/oasisprotocol/docs]: https://github.com/oasisprotocol/docs
+[github.com/oasisprotocol/docs]: https://github.com/oasisprotocol/docs

docs/dapp/tools/other-paratimes/emerald/README.mdx → docs/build/tools/other-paratimes/emerald/README.mdx

@@ -33,6 +33,6 @@ See crucial network information [here][network].
     findSidebarItem('/node/run-your-node/paratime-node'),
     findSidebarItem('/node/run-your-node/paratime-client-node'),
     findSidebarItem('/node/web3'),
-    findSidebarItem('/dapp/sapphire/'),
-    findSidebarItem('/dapp/tools/other-paratimes/cipher/'),
+    findSidebarItem('/build/sapphire/'),
+    findSidebarItem('/build/tools/other-paratimes/cipher/'),
 ]} />

docs/dapp/tools/other-paratimes/emerald/network.mdx → docs/build/tools/other-paratimes/emerald/network.mdx

@@ -58,7 +58,7 @@ dedicated RPC endpoints, consider the following providers (in alphabetic order):
 
 | Name/Provider               | Mainnet URL                               | Testnet URL                               | EIP-3091 compatible |
 |-----------------------------|-------------------------------------------|-------------------------------------------|---------------------|
-| [Oasis Explorer][Oasis Protocol Foundation] | https://explorer.oasis.io/mainnet/emerald | https://explorer.oasis.io/testnet/emerald | Yes                 |
+| [Oasis Explorer][Oasis Protocol Foundation] | `https://explorer.oasis.io/mainnet/emerald` | `https://explorer.oasis.io/testnet/emerald` | Yes                 |
 | Oasis Scan ([Bit Cat])                      | [https://www.oasisscan.com/paratimes/000…87f](https://www.oasisscan.com/paratimes/000000000000000000000000000000000000000000000000e2eaa99fc008f87f) | [https://testnet.oasisscan.com/paratimes/000…ca7](https://testnet.oasisscan.com/paratimes/00000000000000000000000000000000000000000000000072c8215e60d5bca7) | No |
 
 [Bit Cat]: https://www.bitcat365.com/

docs/dapp/tools/remix.md → docs/build/tools/remix.md

@@ -87,13 +87,13 @@ Note that Remix operates without a Sapphire client, meaning transactions and
 queries are unencrypted and unsigned by default. To make use of Sapphire's
 confidential features, refer to our [Quickstart Tutorial].
 
-[Quickstart Tutorial]: https://docs.oasis.io/dapp/sapphire/quickstart
+[Quickstart Tutorial]: https://github.com/oasisprotocol/docs/blob/main/docs/build/sapphire/quickstart.mdx
 
 Should you have any questions, do not hesitate to share them with us on the
 [#dev-central Discord channel][discord].
 
 [localnet]: ./localnet.mdx
-[network page]: https://docs.oasis.io/dapp/sapphire/network#rpc-endpoints
+[network page]: https://github.com/oasisprotocol/docs/blob/main/docs/build/sapphire/network.mdx#rpc-endpoints
 [Remix]: https://remix.ethereum.org
 [Remix documentation]: https://remix-ide.readthedocs.io/en/latest/
 [metamask]: ../../general/manage-tokens/README.mdx#metamask

docs/general/manage-tokens/README.mdx

@@ -125,8 +125,8 @@ chapter.
 ![Metamask - Adding Sapphire Mainnet Network Configuration](../images/wallet/metamask/settings.png)
 
 [MetaMask]: https://metamask.io/download/
-[Sapphire]: ../../dapp/sapphire/network.mdx#rpc-endpoints
-[Emerald]: ../../dapp/tools/other-paratimes/emerald/network.mdx#rpc-endpoints
+[Sapphire]: ../../build/sapphire/network.mdx#rpc-endpoints
+[Emerald]: ../../build/tools/other-paratimes/emerald/network.mdx#rpc-endpoints
 
 ### Ledger
 

docs/general/manage-tokens/how-to-transfer-eth-erc20-to-emerald-paratime.md

@@ -6,7 +6,7 @@ the Wormhole token bridge.
 
 ## About
 
-[Emerald](/dapp/tools/other-paratimes/emerald/) is an Oasis ParaTime providing an Ethereum-compatible blockchain for the Oasis Network. If you want to use any dApp for DEX, NFT and similar built on Emerald, you will have to transfer your assets into the Emerald ParaTime.
+[Emerald](../../build/tools/other-paratimes/emerald/) is an Oasis ParaTime providing an Ethereum-compatible blockchain for the Oasis Network. If you want to use any dApp for DEX, NFT and similar built on Emerald, you will have to transfer your assets into the Emerald ParaTime.
 
 To transfer your ROSE tokens into Emerald, read the [Manage tokens](README.mdx).
 
@@ -93,6 +93,6 @@ Now you can start using that wrapped assets across new Oasis dApps like the firs
 :::info
 
 Make sure that your MetaMask is connected to the Emerald Mainnet chain. You
-can find the network parameters [here](../../dapp/tools/other-paratimes/emerald/network.mdx#rpc-endpoints).
+can find the network parameters [here](../../build/tools/other-paratimes/emerald/network.mdx#rpc-endpoints).
 
 :::

docs/node/mainnet/README.md

@@ -89,7 +89,7 @@ This section contains parameters for various ParaTimes known to be deployed on t
 
 :::info
 
-Check the [Emerald ParaTime page](/dapp/tools/other-paratimes/emerald/network#rpc-endpoints) on how to access
+Check the [Emerald ParaTime page](../../build/tools/other-paratimes/emerald/network#rpc-endpoints) on how to access
 the public Web3 endpoint.
 
 :::

docs/node/run-your-node/paratime-client-node.mdx

@@ -98,7 +98,7 @@ Like the genesis document, make sure you obtain these from a trusted source.
 #### **Compiling the ParaTime Binary from Source Code**
 
 In case you decide to build the ParaTime binary from source yourself, make sure
-that you follow our [guidelines for deterministic compilation](../../paratime/reproducibility)
+that you follow our [guidelines for deterministic compilation](../../build/tools/build-paratime/reproducibility)
 to ensure that you receive the exact same binary.
 
 :::

docs/node/run-your-node/paratime-node.mdx

@@ -165,7 +165,7 @@ Like the genesis document, make sure you obtain these from a trusted source.
 #### **Compiling the ParaTime Binary from Source Code**
 
 In case you decide to build the ParaTime binary from source yourself, make sure
-that you follow our [guidelines for deterministic compilation](../../paratime/reproducibility.md)
+that you follow our [guidelines for deterministic compilation](../../build/tools/build-paratime/reproducibility.md)
 to ensure that you receive the exact same binary.
 
 When the ParaTime is running in a TEE, a different binary to what is registered