From 4e88dc76a2ced44de1315e4dccf42825508dc1ac Mon Sep 17 00:00:00 2001 From: Elliot Voris Date: Thu, 18 Apr 2024 11:16:00 -0500 Subject: [PATCH 1/6] redirects for dapps challenge --- nginx/includes/redirects.conf | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/nginx/includes/redirects.conf b/nginx/includes/redirects.conf index 2eb5f7c4..8e126b8a 100644 --- a/nginx/includes/redirects.conf +++ b/nginx/includes/redirects.conf @@ -72,3 +72,11 @@ rewrite "^/docs/category/tokens$" "https://developers.stellar.org/docs/smart-con rewrite "^/docs/tokens(.*)$" "https://developers.stellar.org/docs/smart-contracts/tokens$1" permanent; rewrite "^/docs/reference/freighter$" "https://developers.stellar.org/docs/smart-contracts/guides/freighter" permanent; rewrite "^/docs/faq$" "https://developers.stellar.org/docs/learn/smart-contract-internals/faq" permanent; +# dapps challenge +rewrite "^/dapps/guides/wallets(.*)$" "https://developers.stellar.org/docs/smart-contracts/guides/freighter/integrate-freighter-react" permanent; +rewrite "^/dapps/guides/smart-contracts(.*)" "https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-0-crowdfund" permanent; +rewrite "^/dapps/guides(.*)$" "https://developers.stellar.org/docs/smart-contracts/guides/dapps$1" permanent; +rewrite "^/dapps/scaffold-soroban(.*)$" "https://developers.stellar.org/docs/learn/interactive/dapps/scaffold-soroban$1" permanent; +rewrite "^/dapps/dapp-challenges(.*)$" "https://developers.stellar.org/docs/learn/interactive/dapps/challenges$1" permanent; +rewrite "^/dapps" "https://developers.stellar.org/docs/learn/interactive/dapps" permanent; +rewrite "^/dashboard" "https://developers.stellar.org/docs/learn/interactive/dapps/dashboard" permanent; From 24ea84450ebb502c3e4696f2cc242433178e7dd7 Mon Sep 17 00:00:00 2001 From: Elliot Voris Date: Thu, 18 Apr 2024 11:28:39 -0500 Subject: [PATCH 2/6] add migration URLs to docs --- dapps/README.mdx | 10 ++++++++++ dapps/dapp-challenges/challenge-0-crowdfund.mdx | 10 ++++++++++ dapps/dapp-challenges/challenge-1-payment.mdx | 10 ++++++++++ dapps/dapp-challenges/challenge-2-liquidity-pool.mdx | 10 ++++++++++ dapps/dapp-challenges/challenge-3-oracle.mdx | 10 ++++++++++ dapps/guides/docker.mdx | 10 ++++++++++ dapps/guides/initialization.mdx | 10 ++++++++++ dapps/guides/react.mdx | 10 ++++++++++ dapps/guides/smart-contracts.mdx | 10 ++++++++++ dapps/guides/wallets.mdx | 10 ++++++++++ dapps/scaffold-soroban.mdx | 10 ++++++++++ 11 files changed, 110 insertions(+) diff --git a/dapps/README.mdx b/dapps/README.mdx index 6c087990..23370911 100644 --- a/dapps/README.mdx +++ b/dapps/README.mdx @@ -1,8 +1,18 @@ --- sidebar_position: 1 title: Dapps on Soroban +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/learn/migrate/introduction-to-solidity-and-rust + label: Introduction to Solidity, Rust, and Soroban --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/learn/migrate/introduction-to-solidity-and-rust) for the most up-to-date information + +::: + Decentralized applications, or "dapps," mark a significant shift in our digital interactions, running on a blockchain or peer-to-peer network instead of centralized servers. This shift enhances transparency, security, and user control, as data and smart contracts are stored on a public ledger, open for audit by anyone. Soroban facilitates building and deploying dapps on the Stellar blockchain, offering tools and frameworks that simplify the development process for even those with minimal coding experience. The Soroban Dapps Challenge highlights this, enabling you to create a variety of dapp use cases on a single page in just 20 minutes, with minimal coding, guiding you from smart contract deployment to user interaction through a web frontend. The Soroban Dapps Challenge is a dynamic course designed for developers eager to explore the potential of building decentralized applications (Dapps) on the Soroban smart contracts platform. This course is part challenge, part educational journey that sets the stage for practical and creative blockchain development. diff --git a/dapps/dapp-challenges/challenge-0-crowdfund.mdx b/dapps/dapp-challenges/challenge-0-crowdfund.mdx index adff7075..cd08ac0f 100644 --- a/dapps/dapp-challenges/challenge-0-crowdfund.mdx +++ b/dapps/dapp-challenges/challenge-0-crowdfund.mdx @@ -2,8 +2,18 @@ sidebar_position: 0 title: Crowdfund Dapp Challenge description: Build and ship a Crowdfund Dapp! Beat the Challenge! +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-0-crowdfund + label: Crowdfund Dapp Challenge --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-0-crowdfund) for the most up-to-date information + +::: + import mintToken from "../../static/img/mintToken.png"; import approveTokenMint from "../../static/img/approveTokenMint.png"; import updatedBalance from "../../static/img/updatedBalance.png"; diff --git a/dapps/dapp-challenges/challenge-1-payment.mdx b/dapps/dapp-challenges/challenge-1-payment.mdx index 41bbf31c..019faa10 100644 --- a/dapps/dapp-challenges/challenge-1-payment.mdx +++ b/dapps/dapp-challenges/challenge-1-payment.mdx @@ -2,8 +2,18 @@ sidebar_position: 0 title: Payment Dapp Challenge description: Take on the challenge and master the Soroban Payment Dapp! +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-1-payment + label: Payment Dapp Challenge --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-1-payment) for the most up-to-date information + +::: + Payment Dapp Challenge. diff --git a/dapps/dapp-challenges/challenge-2-liquidity-pool.mdx b/dapps/dapp-challenges/challenge-2-liquidity-pool.mdx index 638d8112..65a7702c 100644 --- a/dapps/dapp-challenges/challenge-2-liquidity-pool.mdx +++ b/dapps/dapp-challenges/challenge-2-liquidity-pool.mdx @@ -2,8 +2,18 @@ sidebar_position: 2 title: Liquidity Pool Dapp Challenge description: Deploy an example dapp, add liquidity! Beat the Challenge! +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-2-liquidity-pool + label: Liquidity Pool Dapp Challenge --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-2-liquidity-pool) for the most up-to-date information + +::: + import mint_tokens from "../../static/img/mint_tokens.png"; import approveTokenMint from "../../static/img/approveTokenMint.png"; import updatedBalances from "../../static/img/updatedBalances.png"; diff --git a/dapps/dapp-challenges/challenge-3-oracle.mdx b/dapps/dapp-challenges/challenge-3-oracle.mdx index e38c2870..e9109300 100644 --- a/dapps/dapp-challenges/challenge-3-oracle.mdx +++ b/dapps/dapp-challenges/challenge-3-oracle.mdx @@ -2,8 +2,18 @@ sidebar_position: 0 title: Oracle Dapp Challenge description: Get prices with the Oracle Dapp! Beat the Challenge! +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-3-oracle + label: Oracle Dapp Challenge --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-3-oracle) for the most up-to-date information + +::: + import oracle_connect from "../../static/img/oracle_connect.png"; import oracle_home from "../../static/img/oracle_home.png"; import oracle_mintBal from "../../static/img/oracle_mintBal.png"; diff --git a/dapps/guides/docker.mdx b/dapps/guides/docker.mdx index 1b2ac95d..5d256bb3 100644 --- a/dapps/guides/docker.mdx +++ b/dapps/guides/docker.mdx @@ -2,8 +2,18 @@ sidebar_position: 0 title: Docker description: Explore how to use Docker to build and run Soroban Dapps. +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/smart-contracts/guides/dapps/docker + label: Docker --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/smart-contracts/guides/dapps/docker) for the most up-to-date information + +::: + # What is Docker? Welcome to the world of [Docker](https://www.docker.com/), an essential tool for software development. Docker packages software into units known as containers, ensuring consistency, isolation, portability, and scalability. diff --git a/dapps/guides/initialization.mdx b/dapps/guides/initialization.mdx index dccbc812..2608389f 100644 --- a/dapps/guides/initialization.mdx +++ b/dapps/guides/initialization.mdx @@ -2,8 +2,18 @@ sidebar_position: 3 title: Initialization description: Learn how to initialize a Soroban Dapp using scripts +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/smart-contracts/guides/dapps/initialization + label: Initialization --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/smart-contracts/guides/dapps/initialization) for the most up-to-date information + +::: + # Example Soroban Dapp Initialization When setting up an example Soroban Dapp, correct initialization is crucial. This process entails several steps, including deploying Docker, cloning and deploying smart contracts, and invoking functions to configure them. In this comprehensive guide, you will walk you through the necessary steps to successfully build and deploy these smart contracts, ensuring a seamless setup for your Soroban Dapp. diff --git a/dapps/guides/react.mdx b/dapps/guides/react.mdx index ac14e055..cf4728ed 100644 --- a/dapps/guides/react.mdx +++ b/dapps/guides/react.mdx @@ -2,8 +2,18 @@ sidebar_position: 1 title: React description: Learn about the frontend for the example Crowdfund Dapp. +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/smart-contracts/guides/dapps/react + label: React --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/smart-contracts/guides/dapps/react) for the most up-to-date information + +::: + This section elaborates on how the frontends from your dapp can interact with the example contracts and access chain data, and connect to a freighter wallet. This will be illustrated by utilizing libraries provided by [`@soroban-react`](https://soroban-react.gitbook.io/index/), a simple, powerful framework for building modern Soroban Dapps using React created by a member of the Soroban community. Below is a list of the libraries used throughout the frontend code and their respective imports: diff --git a/dapps/guides/smart-contracts.mdx b/dapps/guides/smart-contracts.mdx index aa643e04..365e2f25 100644 --- a/dapps/guides/smart-contracts.mdx +++ b/dapps/guides/smart-contracts.mdx @@ -2,8 +2,18 @@ sidebar_position: 2 title: Smart Contracts description: Learn about the smart contracts from the Soroban Dapps Challenge. +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-0-crowdfund + label: Smart Contracts --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-0-crowdfund) for the most up-to-date information + +::: + ## Crowdfund Example The [example crowdfunding smart contract](https://github.com/stellar/soroban-example-dapp/blob/main/contracts/crowdfund/src/lib.rs), written in Rust and using the Soroban SDK, is a template for creating a crowdfunding dapp. Users can deposit tokens into the contract until a target amount is reached or a deadline expires. If the target is met, the recipient can withdraw the tokens. If the deadline passes without the target being met, donors can reclaim their tokens. diff --git a/dapps/guides/wallets.mdx b/dapps/guides/wallets.mdx index 4b133871..f42beb82 100644 --- a/dapps/guides/wallets.mdx +++ b/dapps/guides/wallets.mdx @@ -2,8 +2,18 @@ sidebar_position: 4 title: Wallets description: Learn how to use wallets on Soroban +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/smart-contracts/guides/freighter/integrate-freighter-react + label: Wallets --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/smart-contracts/guides/freighter/integrate-freighter-react) for the most up-to-date information + +::: + import freighter_settings from "../../static/img/freighter_settings.png"; import gear_icon from "../../static/img/gear_icon.png"; import preferences_menu from "../../static/img/preferences_menu.png"; diff --git a/dapps/scaffold-soroban.mdx b/dapps/scaffold-soroban.mdx index 15c4960b..02223c3b 100644 --- a/dapps/scaffold-soroban.mdx +++ b/dapps/scaffold-soroban.mdx @@ -2,8 +2,18 @@ sidebar_position: 2 title: Scaffold Soroban description: Dive into the simple implementations of Soroban dapps to understand and learn the Soroban ecosystem. +sidebar_custom_props: + migration: + href: https://developers.stellar.org/docs/learn/migrate/introduction-to-solidity-and-rust + label: Introduction to Solidity, Rust, and Soroban --- +:::danger These are not the droids you're looking for + +This page has been migrated to the Stellar Developers documentation. Please [click here](https://developers.stellar.org/docs/learn/migrate/introduction-to-solidity-and-rust) for the most up-to-date information + +::: + ## Demonstrative Soroban Dapps import ReactPlayer from "react-player"; From 5e937ee05139a516dfb313f1e58dc6b4ac2fd5d5 Mon Sep 17 00:00:00 2001 From: Elliot Voris Date: Thu, 18 Apr 2024 11:35:30 -0500 Subject: [PATCH 3/6] add migration URLs to Dapps section's sidebar --- sidebarsDapps.js | 40 ++++++++++++++++++++++++++++++---------- 1 file changed, 30 insertions(+), 10 deletions(-) diff --git a/sidebarsDapps.js b/sidebarsDapps.js index 6b498cf7..31c5a0e4 100644 --- a/sidebarsDapps.js +++ b/sidebarsDapps.js @@ -1,29 +1,49 @@ module.exports = { mySidebar: [ { - type: 'doc', - id: 'README', + type: 'link', label: 'Welcome', + href: 'https://developers.stellar.org/docs/learn/migrate/introduction-to-solidity-and-rust', }, { type: 'link', label: 'Dashboard', - href: '/dashboard', + href: 'https://developers.stellar.org/docs/learn/interactive/dapps/dashboard', }, { - type: 'doc', - id: 'scaffold-soroban', + type: 'link', label: 'Scaffold Soroban', + href: 'https://developers.stellar.org/docs/learn/interactive/dapps/scaffold-soroban', }, { type: 'category', label: 'Guides', items: [ - 'guides/docker', - 'guides/initialization', - 'guides/react', - 'guides/smart-contracts', - 'guides/wallets' + { + type: 'link', + label: 'Docker', + href: 'https://developers.stellar.org/docs/smart-contracts/guides/dapps/docker' + }, + { + type: 'link', + label: 'Initialization', + href: 'https://developers.stellar.org/docs/smart-contracts/guides/dapps/initialization' + }, + { + type: 'link', + label: 'React', + href: 'https://developers.stellar.org/docs/smart-contracts/guides/dapps/react' + }, + { + type: 'link', + label: 'Smart Contracts', + href: 'https://developers.stellar.org/docs/learn/interactive/dapps/challenges/challenge-0-crowdfund' + }, + { + type: 'link', + label: 'Wallets', + href: 'https://developers.stellar.org/docs/smart-contracts/guides/freighter/integrate-freighter-react' + }, ], collapsible: true, // The category can be collapsed. collapsed: true, // Initially, the category will be collapsed. From 64665aaec8a3d0cbc9627e7293c7ad8d8ec81b86 Mon Sep 17 00:00:00 2001 From: Elliot Voris Date: Thu, 18 Apr 2024 11:38:16 -0500 Subject: [PATCH 4/6] change top-level nav destination to new dapps home --- docusaurus.config.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index 2f0ecdf2..b286fc59 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -108,7 +108,7 @@ const config = { // position: 'left', // }, { - to: '/dapps', + href: 'https://developers.stellar.org/docs/learn/interactive/dapps', label: 'Dapps', position: 'left' }, From 965a46c59195ff497cdb7b827318d1d88d5ea8c4 Mon Sep 17 00:00:00 2001 From: Elliot Voris Date: Thu, 18 Apr 2024 14:51:54 -0500 Subject: [PATCH 5/6] remove dapps directory from docusaurus config (also, other commented-out sections) --- docusaurus.config.js | 30 ------------------------------ 1 file changed, 30 deletions(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index b286fc59..443af714 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -22,30 +22,6 @@ const config = { }, plugins: [ "docusaurus-plugin-sass", - // [ - // '@docusaurus/plugin-content-docs', - // { - // id: 'api', - // path: 'api', - // routeBasePath: 'api', - // sidebarPath: require.resolve('./sidebarsApi.js'), - // editUrl: "https://github.com/stellar/soroban-docs/tree/main/", - // showLastUpdateTime: true, - // showLastUpdateAuthor: true, - // }, - // ], - [ - '@docusaurus/plugin-content-docs', - { - id: 'dapps', - path: 'dapps', - routeBasePath: 'dapps', - sidebarPath: require.resolve('./sidebarsDapps.js'), - editUrl: "https://github.com/stellar/soroban-docs/tree/main/", - showLastUpdateTime: true, - showLastUpdateAuthor: true, - }, - ], require('./src/dev-server-plugin'), require('./src/analytics-module') ], @@ -101,12 +77,6 @@ const config = { label: 'API', position: 'left' }, - // { - // href: 'https://fastcheapandoutofcontrol.com/', - // label: 'Play Game', - // className: 'nav-highlight', - // position: 'left', - // }, { href: 'https://developers.stellar.org/docs/learn/interactive/dapps', label: 'Dapps', From d5d922441a5df50106cf69adde5672ac61ea48af Mon Sep 17 00:00:00 2001 From: Elliot Voris Date: Thu, 18 Apr 2024 14:58:47 -0500 Subject: [PATCH 6/6] remove admonition about dapps challenge on /docs page --- docs/README.mdx | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/README.mdx b/docs/README.mdx index 1a9abeb3..397271da 100644 --- a/docs/README.mdx +++ b/docs/README.mdx @@ -6,9 +6,3 @@ title: We've Moved! All of our documentation content previously available at `soroban.stellar.org` has now been merged into one, consolidated collection available in the [Stellar Developers Documentation](https://developers.stellar.org). Redirects from this site are in-place, and links have been updated everywhere we've found them. If you have any issues finding the content you're looking for, please give our [docs search](https://developers.stellar.org/search) a try. If you still have trouble, we welcome all feedback, issues, and pull requests in the [stellar-docs GitHub repo](https://github.com/stellar/stellar-docs). - -:::info There is one temporary exception... - -The [Soroban Dapps Challenge](/dapps) remains here, for a brief time. There are some version mismatches we're working through, and that section will also be folded into the collection at `developers.stellar.org` soon. - -:::