Merge pull request #1058 from oasisprotocol/rube/split-sapphire-guide

docs: Revamp dapp to build
oasisprotocol · Jan 17, 2025 · e9b3346 · e9b3346
2 parents 140c155 + 01cee79
commit e9b3346
Show file tree

Hide file tree

Showing 106 changed files with 368 additions and 333 deletions.
diff --git a/README.md b/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

diff --git a/docs/README.mdx b/docs/README.mdx
@@ -17,7 +17,7 @@ chains and how to use unique Oasis features.
     findSidebarItem('/general/manage-tokens/cli/'),
 ]} />
 
-## Create dApp
+## Build on Oasis
 
 Contains learning material for the smart contract developers. Since the Oasis
 platform is best known for confidentiality, the most notable ParaTime is
@@ -26,29 +26,21 @@ encryption**. The Oasis team also prepared a set of libraries called the
 [Oasis Privacy Layer] to **bridge existing dApps running on other chains** to
 use the unique Sapphire's confidentiality.
 
-The part also covers other ParaTimes such as the non-confidential
-[Oasis Emerald] and Wasm-compatible, confidential [Oasis Cipher].
+Our [Runtime OFfchain Logic (ROFL)][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.
 
 <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/rofl/'),
+    findSidebarItem('/build/tools/'),
 ]} />
 
-[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
-
-## Build 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('/rofl/')} />
+[Oasis Sapphire]: ./build/sapphire/README.mdx
+[Oasis Privacy Layer]: ./build/opl/README.mdx
+[ROFL]: ./build/rofl/README.mdx
 
 ## Get Involved
 
@@ -83,7 +75,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
 

diff --git a/docs/dapp/README.mdx → docs/build/README.mdx b/docs/dapp/README.mdx → docs/build/README.mdx
@@ -6,23 +6,36 @@ import DocCard from '@theme/DocCard';
 import DocCardList from '@theme/DocCardList';
 import {findSidebarItem} from '@site/src/sidebarUtils';
 
-# Create dApp
+# Build on Oasis
 
 ![Oasis architectural design including ParaTime and consensus layers](../general/images/architecture/technology_scalability.svg)
 
 The [Oasis architecture] is designed to have a simple, robust consensus layer
 on top which connects handful of ParaTimes executing smart contracts.
 
+## Sapphire
+
 [Sapphire] is the primary ParaTime. It is EVM-compatible and allows you to
 write both confidential and non-confidential smart contracts.
 
 For an overview of the other ParaTimes, refer to the [Other ParaTimes] chapter.
 
+<DocCard item={findSidebarItem('/build/sapphire/')} />
+
 [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
+## 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/')} />
+
+## Oasis Privacy Layer (OPL)
 
 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,
@@ -34,7 +47,7 @@ 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/')} />
 
 ## Consensus Layer RPC Endpoints
 
@@ -72,7 +85,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/

diff --git a/docs/dapp/diagrams/opl-contract-flow.mmd → docs/build/diagrams/opl-contract-flow.mmd b/docs/dapp/diagrams/opl-contract-flow.mmd → docs/build/diagrams/opl-contract-flow.mmd
diff --git a/docs/dapp/diagrams/opl-contract-flow.mmd.svg → .../build/diagrams/opl-contract-flow.mmd.svg b/docs/dapp/diagrams/opl-contract-flow.mmd.svg → .../build/diagrams/opl-contract-flow.mmd.svg
diff --git a/...app/diagrams/opl-router-pingpong-flow.mmd → ...ild/diagrams/opl-router-pingpong-flow.mmd b/...app/diagrams/opl-router-pingpong-flow.mmd → ...ild/diagrams/opl-router-pingpong-flow.mmd
diff --git a/...diagrams/opl-router-pingpong-flow.mmd.svg → ...diagrams/opl-router-pingpong-flow.mmd.svg b/...diagrams/opl-router-pingpong-flow.mmd.svg → ...diagrams/opl-router-pingpong-flow.mmd.svg
diff --git a/docs/dapp/images/emerald/block_explorer1.png → .../build/images/emerald/block_explorer1.png b/docs/dapp/images/emerald/block_explorer1.png → .../build/images/emerald/block_explorer1.png
diff --git a/docs/dapp/images/emerald/block_explorer2.png → .../build/images/emerald/block_explorer2.png b/docs/dapp/images/emerald/block_explorer2.png → .../build/images/emerald/block_explorer2.png
diff --git a/docs/dapp/images/emerald/oasisscan1.png → docs/build/images/emerald/oasisscan1.png b/docs/dapp/images/emerald/oasisscan1.png → docs/build/images/emerald/oasisscan1.png
diff --git a/docs/dapp/images/emerald/oasisscan2.png → docs/build/images/emerald/oasisscan2.png b/docs/dapp/images/emerald/oasisscan2.png → docs/build/images/emerald/oasisscan2.png
diff --git a/docs/dapp/images/opl/celer-architecture.png → docs/build/images/opl/celer-architecture.png b/docs/dapp/images/opl/celer-architecture.png → docs/build/images/opl/celer-architecture.png
diff --git a/docs/dapp/images/opl/celer-e2e.png → docs/build/images/opl/celer-e2e.png b/docs/dapp/images/opl/celer-e2e.png → docs/build/images/opl/celer-e2e.png
diff --git a/docs/dapp/images/opl/compile-pingpong.png → docs/build/images/opl/compile-pingpong.png b/docs/dapp/images/opl/compile-pingpong.png → docs/build/images/opl/compile-pingpong.png
diff --git a/docs/dapp/images/opl/confirm-new-poll.png → docs/build/images/opl/confirm-new-poll.png b/docs/dapp/images/opl/confirm-new-poll.png → docs/build/images/opl/confirm-new-poll.png
diff --git a/docs/dapp/images/opl/create-poll.png → docs/build/images/opl/create-poll.png b/docs/dapp/images/opl/create-poll.png → docs/build/images/opl/create-poll.png
diff --git a/docs/dapp/images/opl/past-dao-proposals.png → docs/build/images/opl/past-dao-proposals.png b/docs/dapp/images/opl/past-dao-proposals.png → docs/build/images/opl/past-dao-proposals.png
diff --git a/...dapp/images/opl/privacy-layer-diagram.png → ...uild/images/opl/privacy-layer-diagram.png b/...dapp/images/opl/privacy-layer-diagram.png → ...uild/images/opl/privacy-layer-diagram.png
diff --git a/docs/dapp/images/opl/router-approve.png → docs/build/images/opl/router-approve.png b/docs/dapp/images/opl/router-approve.png → docs/build/images/opl/router-approve.png
diff --git a/docs/dapp/images/opl/router-architecture.png → .../build/images/opl/router-architecture.png b/docs/dapp/images/opl/router-architecture.png → .../build/images/opl/router-architecture.png
diff --git a/...mages/opl/router-deploy-pingpong-amoy.png → ...mages/opl/router-deploy-pingpong-amoy.png b/...mages/opl/router-deploy-pingpong-amoy.png → ...mages/opl/router-deploy-pingpong-amoy.png
diff --git a/...s/opl/router-deploy-pingpong-sapphire.png → ...s/opl/router-deploy-pingpong-sapphire.png b/...s/opl/router-deploy-pingpong-sapphire.png → ...s/opl/router-deploy-pingpong-sapphire.png
diff --git a/docs/dapp/images/opl/router-faucet.png → docs/build/images/opl/router-faucet.png b/docs/dapp/images/opl/router-faucet.png → docs/build/images/opl/router-faucet.png
diff --git a/docs/dapp/images/opl/router-iping.png → docs/build/images/opl/router-iping.png b/docs/dapp/images/opl/router-iping.png → docs/build/images/opl/router-iping.png
diff --git a/docs/dapp/images/opl/router-metadata.png → docs/build/images/opl/router-metadata.png b/docs/dapp/images/opl/router-metadata.png → docs/build/images/opl/router-metadata.png
diff --git a/docs/dapp/images/opl/vote-on-ballot.png → docs/build/images/opl/vote-on-ballot.png b/docs/dapp/images/opl/vote-on-ballot.png → docs/build/images/opl/vote-on-ballot.png
diff --git a/docs/dapp/images/remix/remix01.png → docs/build/images/remix/remix01.png b/docs/dapp/images/remix/remix01.png → docs/build/images/remix/remix01.png
diff --git a/docs/dapp/images/remix/remix02.png → docs/build/images/remix/remix02.png b/docs/dapp/images/remix/remix02.png → docs/build/images/remix/remix02.png
diff --git a/docs/dapp/images/remix/remix03.png → docs/build/images/remix/remix03.png b/docs/dapp/images/remix/remix03.png → docs/build/images/remix/remix03.png
diff --git a/docs/dapp/images/remix/remix04.png → docs/build/images/remix/remix04.png b/docs/dapp/images/remix/remix04.png → docs/build/images/remix/remix04.png
diff --git a/docs/dapp/images/remix/sourcify.png → docs/build/images/remix/sourcify.png b/docs/dapp/images/remix/sourcify.png → docs/build/images/remix/sourcify.png
diff --git a/...pp/images/tools/abi_playground_import.png → ...ld/images/tools/abi_playground_import.png b/...pp/images/tools/abi_playground_import.png → ...ld/images/tools/abi_playground_import.png
diff --git a/...dapp/images/tools/abi_playground_load.png → ...uild/images/tools/abi_playground_load.png b/...dapp/images/tools/abi_playground_load.png → ...uild/images/tools/abi_playground_load.png
diff --git a/.../images/tools/abi_playground_localnet.png → .../images/tools/abi_playground_localnet.png b/.../images/tools/abi_playground_localnet.png → .../images/tools/abi_playground_localnet.png
diff --git a/...s/tools/band_demooracle_smartcontract.png → ...s/tools/band_demooracle_smartcontract.png b/...s/tools/band_demooracle_smartcontract.png → ...s/tools/band_demooracle_smartcontract.png
diff --git a/...s/band_deploy_demooracle_smartcontact.png → ...s/band_deploy_demooracle_smartcontact.png b/...s/band_deploy_demooracle_smartcontact.png → ...s/band_deploy_demooracle_smartcontact.png
diff --git a/docs/dapp/images/tools/band_get_rates.png → docs/build/images/tools/band_get_rates.png b/docs/dapp/images/tools/band_get_rates.png → docs/build/images/tools/band_get_rates.png
diff --git a/docs/dapp/images/tools/band_saveprice.png → docs/build/images/tools/band_saveprice.png b/docs/dapp/images/tools/band_saveprice.png → docs/build/images/tools/band_saveprice.png
diff --git a/.../images/tools/explorer_abi_playground.png → .../images/tools/explorer_abi_playground.png b/.../images/tools/explorer_abi_playground.png → .../images/tools/explorer_abi_playground.png
diff --git a/docs/dapp/images/tools/sourcify1.png → docs/build/images/tools/sourcify1.png b/docs/dapp/images/tools/sourcify1.png → docs/build/images/tools/sourcify1.png
diff --git a/docs/dapp/images/tools/sourcify2.png → docs/build/images/tools/sourcify2.png b/docs/dapp/images/tools/sourcify2.png → docs/build/images/tools/sourcify2.png
diff --git a/docs/dapp/images/tools/sourcify3.png → docs/build/images/tools/sourcify3.png b/docs/dapp/images/tools/sourcify3.png → docs/build/images/tools/sourcify3.png
diff --git a/docs/dapp/opl/README.mdx → docs/build/opl/README.mdx b/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

diff --git a/docs/dapp/opl/celer/README.md → docs/build/opl/celer/README.md b/docs/dapp/opl/celer/README.md → docs/build/opl/celer/README.md
diff --git a/docs/dapp/opl/celer/networks.md → docs/build/opl/celer/networks.md b/docs/dapp/opl/celer/networks.md → docs/build/opl/celer/networks.md
diff --git a/docs/dapp/opl/celer/ping-example.md → docs/build/opl/celer/ping-example.md b/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
 
 :::
 

diff --git a/docs/dapp/opl/opl-sdk/README.md → docs/build/opl/opl-sdk/README.md b/docs/dapp/opl/opl-sdk/README.md → docs/build/opl/opl-sdk/README.md
diff --git a/docs/dapp/opl/opl-sdk/ping-example.md → docs/build/opl/opl-sdk/ping-example.md b/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
 
 :::
 

diff --git a/docs/dapp/opl/router-protocol/README.md → docs/build/opl/router-protocol/README.md b/docs/dapp/opl/router-protocol/README.md → docs/build/opl/router-protocol/README.md
diff --git a/docs/dapp/opl/router-protocol/approve.md → docs/build/opl/router-protocol/approve.md b/docs/dapp/opl/router-protocol/approve.md → docs/build/opl/router-protocol/approve.md
diff --git a/docs/dapp/opl/router-protocol/interface.md → docs/build/opl/router-protocol/interface.md b/docs/dapp/opl/router-protocol/interface.md → docs/build/opl/router-protocol/interface.md
diff --git a/...p/opl/router-protocol/pingpong-example.md → ...d/opl/router-protocol/pingpong-example.md b/...p/opl/router-protocol/pingpong-example.md → ...d/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
 

diff --git a/docs/rofl/README.mdx → docs/build/rofl/README.mdx b/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]:

diff --git a/docs/build/rofl/app.mdx b/docs/build/rofl/app.mdx
@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/app.mdx
diff --git a/docs/build/rofl/deployment.md b/docs/build/rofl/deployment.md
@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/deployment.md
diff --git a/docs/build/rofl/prerequisites.md b/docs/build/rofl/prerequisites.md
@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/prerequisites.md
diff --git a/docs/build/rofl/rofl.svg b/docs/build/rofl/rofl.svg
@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/rofl.svg
diff --git a/docs/build/rofl/trust-root.md b/docs/build/rofl/trust-root.md
@@ -0,0 +1 @@
+../../../external/oasis-sdk/docs/rofl/trust-root.md
diff --git a/docs/dapp/sapphire → docs/build/sapphire b/docs/dapp/sapphire → docs/build/sapphire
diff --git a/docs/dapp/tools/README.mdx → docs/build/tools/README.mdx b/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'),
 ]} />
diff --git a/docs/dapp/tools/abi-playground.md → docs/build/tools/abi-playground.md b/docs/dapp/tools/abi-playground.md → docs/build/tools/abi-playground.md
@@ -1,5 +1,5 @@
 ---
-description: Interacting with contracts
+description: Interacting with contracts in the browser
 ---
 
 # ABI Playground

diff --git a/docs/dapp/tools/band.md → docs/build/tools/band.md b/docs/dapp/tools/band.md → docs/build/tools/band.md
@@ -1,4 +1,8 @@
-# Integrating BAND Oracle
+---
+description: A guide to integrate the Band Oracle
+---
+
+# Band Oracle
 
 <p style={{width: '100%'}}>
 <iframe style={{margin: 'auto', display:'block'}} width="560" height="315" src="https://www.youtube.com/embed/cwe6P5MvIfk?si=4QFRA8yJ2PCZB5fq" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

diff --git a/docs/paratime/README.mdx → docs/build/tools/build-paratime/README.mdx b/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'),
 ]} />
 

diff --git a/docs/build/tools/build-paratime/minimal-runtime.md b/docs/build/tools/build-paratime/minimal-runtime.md
@@ -0,0 +1 @@
+../../../../external/oasis-sdk/docs/runtime/minimal-runtime.md
diff --git a/docs/build/tools/build-paratime/modules.md b/docs/build/tools/build-paratime/modules.md
@@ -0,0 +1 @@
+../../../../external/oasis-sdk/docs/runtime/modules.md
diff --git a/docs/build/tools/build-paratime/prerequisites.md b/docs/build/tools/build-paratime/prerequisites.md
@@ -0,0 +1 @@
+../../../../external/oasis-sdk/docs/runtime/prerequisites.md
diff --git a/docs/build/tools/build-paratime/reproducibility.md b/docs/build/tools/build-paratime/reproducibility.md
@@ -0,0 +1 @@
+../../../../external/oasis-sdk/docs/runtime/reproducibility.md
diff --git a/docs/dapp/tools/localnet.mdx → docs/build/tools/localnet.mdx b/docs/dapp/tools/localnet.mdx → docs/build/tools/localnet.mdx
@@ -1,3 +1,7 @@
+---
+description: A Docker container that simulates a local Sapphire blockchain
+---
+
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 

diff --git a/docs/dapp/tools/other-paratimes/README.mdx → docs/build/tools/other-paratimes/README.mdx b/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
diff --git a/...p/tools/other-paratimes/cipher/README.mdx → ...d/tools/other-paratimes/cipher/README.mdx b/...p/tools/other-paratimes/cipher/README.mdx → ...d/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]:

diff --git a/...mes/cipher/confidential-smart-contract.md → ...mes/cipher/confidential-smart-contract.md b/...mes/cipher/confidential-smart-contract.md → ...mes/cipher/confidential-smart-contract.md
diff --git a/...ols/other-paratimes/cipher/hello-world.md → ...ols/other-paratimes/cipher/hello-world.md b/...ols/other-paratimes/cipher/hello-world.md → ...ols/other-paratimes/cipher/hello-world.md
diff --git a/.../tools/other-paratimes/cipher/network.mdx → .../tools/other-paratimes/cipher/network.mdx b/.../tools/other-paratimes/cipher/network.mdx → .../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
diff --git a/...s/other-paratimes/cipher/prerequisites.md → ...s/other-paratimes/cipher/prerequisites.md b/...s/other-paratimes/cipher/prerequisites.md → ...s/other-paratimes/cipher/prerequisites.md
diff --git a/.../tools/other-paratimes/emerald/README.mdx → .../tools/other-paratimes/emerald/README.mdx b/.../tools/other-paratimes/emerald/README.mdx → .../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/'),
 ]} />
diff --git a/...tools/other-paratimes/emerald/network.mdx → ...tools/other-paratimes/emerald/network.mdx b/...tools/other-paratimes/emerald/network.mdx → ...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/

diff --git a/...imes/emerald/writing-dapps-on-emerald.mdx → ...imes/emerald/writing-dapps-on-emerald.mdx b/...imes/emerald/writing-dapps-on-emerald.mdx → ...imes/emerald/writing-dapps-on-emerald.mdx
diff --git a/docs/dapp/tools/remix.md → docs/build/tools/remix.md b/docs/dapp/tools/remix.md → docs/build/tools/remix.md
@@ -1,5 +1,5 @@
 ---
-description: Remix web IDE
+description: A guide for the Remix web IDE
 ---
 
 # Remix
@@ -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

diff --git a/docs/dapp/tools/verification.md → docs/build/tools/verification.md b/docs/dapp/tools/verification.md → docs/build/tools/verification.md
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		../../../external/oasis-sdk/docs/rofl/deployment.md
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		../../../external/oasis-sdk/docs/rofl/prerequisites.md
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		../../../external/oasis-sdk/docs/rofl/trust-root.md
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		../../../../external/oasis-sdk/docs/runtime/minimal-runtime.md
Original file line number	Diff line number	Diff line change
Expand Up		@@ -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