From 52a10f9de3dfe75159871c2176e505471c6d8a4b Mon Sep 17 00:00:00 2001 From: Elliot Voris Date: Wed, 13 Mar 2024 15:22:23 -0500 Subject: [PATCH] [Soroban Merge] Create a "Learn" section of the docs (#354) * initial commit * example including an image * add doc on assets-and-authorization, with auth part filled in * update wordmark * Add a homepage (#197) * permit homepage * progress * desktop version is donenough * slight mobile tweaks * feedback tweaks * small order and style tweaks * mobile tweaks * copy tweak * moar slight tweaks * add Sorobanathon links * slight rename * z-index tweaks * USDC -> XLM * copy tweak * tweakers for weekers * copy and zindex tweaks * appeasing the nit pickers * added a meta image * Soroban landing (#396) * init soroban landing * Start landing markup * Add earn section and refine styles * Add SCF section * Add Soroban section * Update hero min-height * add media section * add assets v1 * add links to getting started * update twitter * add assets v2 * add missing links * Adjust images * final * clean up old home page assets * cleanup scss colors * added hello world code * dark mode * fixed some minor issues * updaters * add a 5. card --------- Co-authored-by: Jesmar Castillo <32423903+jesmarsc@users.noreply.github.com> Co-authored-by: Tyler van der Hoeven * Evm to Soroban (#409) * initial commit * add code breakdown * add mdx * remove mdx * update Rust SC * add advanced concepts * add vault contract and tests * Update solidity-and-rust-advanced-concepts.mdx * remove un tabbed code * update vault.rs; add shell cmds * update yield amount * add vault deployment and interaction * add wdraw message * fix script sequence * add EVM comparison * update error handling * 1st round review * Update script descroption * add solidity to approved languages * fixed a broken link * move file folder; add token inheritance * update links * fixed broken links * update Soroban Description * nit: spelling * Fix bytes and arrays * spelling errors * spelling errors * no capitalization on build * grammar spelling errors * spelling and grammar errors * fixes; post PR review * macros description * Correction: Data Types * update Symbol Definition * update traits definition: fix Solidity Contract * Merge main into evm-to-soroban (#414) * update code block (#400) * additional copy changes to site (#401) * copy edits from Dom (#403) * update broken link (#404) * update token interface (#406) * update token intereface Interface was referenced from : https://github.com/stellar/rs-soroban-sdk/blob/main/soroban-sdk/src/token.rs * update fn description * nit: update fn description * nit: format * nit: bracket format * fix event topics * update events * revert per PR to fix event name https://github.com/stellar/rs-soroban-env/pull/778/files * Improve Failure Condition Handling in Token Interface (#394) * Add Error Handling Section * update authorization info * add more context to authorization * nit: call not specific to callers address * Add event docs (#375) * Add event docs * Remove note * Add link to events example * fixes malformed hello world link (#412) * Remove derive Default (#413) --------- Co-authored-by: Tyler van der Hoeven Co-authored-by: Bri <92327786+briwylde08@users.noreply.github.com> Co-authored-by: Siddharth Suresh Co-authored-by: Leigh McCulloch <351529+leighmcculloch@users.noreply.github.com> * fix spelling and add string example * move evm-to-soroban * resolve conflict * add auth section. Add comparison for addresses * embolden main point about replay prevention * nit update section * nit wording * improve Address and Auth Callouts * update contract deposit fn. Update ID to addr conversion * nit: var placeholders * example vault update * update vault example to 8.1 * update to align w main * updates Env:: to env. ; nits * add section on composability * nit: update soroban-sdk version * update example to use sdk 8.4 * remove admin from mint * nit: grammar; update tx messages --------- Co-authored-by: Tyler van der Hoeven Co-authored-by: Bri <92327786+briwylde08@users.noreply.github.com> Co-authored-by: Siddharth Suresh Co-authored-by: Leigh McCulloch <351529+leighmcculloch@users.noreply.github.com> * Add dapps challenge (#487) * Add Dapps Challenge to Docs Todo: user dashboard visibility * add hide unless dapps * update user card * update checkpoints * add user dashboard to dapps challenges * Update Dapp Challenge Description * Update tsconfig.json * fix tsconfig.json * small grammar fixes * small grammar fixes * small grammar fixes * small grammar fixes * small grammar fixes * update challenge 0 and 1 ; add images for challenge 2 * Capitalize Futurenet; lowercase Dapp when needed * disclaimer; nit crowdfunding -> crowdfund * Update challenge-0-crowdfund.mdx * update layout and guides * Update smart-contracts.mdx * update content * add links * nit update soroban quickstart * Update react.mdx * Update challenge-0-crowdfund.mdx * update start course redirect * we -> you * update wrangler endpoint to stellar cloudflare * update wrangler endpoint * add module resolution and jsx * add wrong network page; remove unused code; add vercel.app checking * update wallets conclusion * nit Update wallets.mdx * nit update broken link * Freighter -> WalletData Component * update crowdfund dapps challenge for P10 * Fix Setup * update docker workflow; add better notes * nit standalone docker requirement * re-enable .vercel.app check; move ParentChallengeForm * move Login function * fixed automatic log in problem * comment out connection check * comment out auto connect hook; nit Login -> Connect * removed unused setLoading() changed order of operations * update to checkout challenge branch * completed challenge message = clickable url * remember user is logged in * setup `BrowserOnly` * Update yarn.lock * Update yarn.lock * merge main into dapps challenge * Update yarn.lock * nit: refresh message * add disconnect button comment; better connection insight * update contract initialization to use strings * auto populate url; add resubmit; fix broken invoke * add setSavedUrl; improve url auto populate * improve local storage for pubkey --------- Co-authored-by: Bri <92327786+briwylde08@users.noreply.github.com> * seo-editorial-docs (#547) * SDC UI upgrades (#542) * Update index.tsx * update kv:worker endpoint * Update index.tsx * Add Root component, finish-step-button, update styles * Add library for toast notifications, show milestone notification * Add class for HttpClient, functions for requests * Changed backend model, finalize user progress on course * Add confetti effect on complete button click, refactor * Remove mocks, use endpoint, fix issues * Merge Development into main (#2) * update kv:worker endpoint * Update index.tsx * Add Root component, finish-step-button, update styles * Add library for toast notifications, show milestone notification * Add class for HttpClient, functions for requests * Changed backend model, finalize user progress on course * Add confetti effect on complete button click, refactor * Remove mocks, use endpoint, fix issues --------- Co-authored-by: Iryna Telesheva Co-authored-by: Iryna Telesheva <131377033+itelesheva@users.noreply.github.com> * Add Dashboard for Dapps challenges (#3) * Added dashboard component, styled cards * Added DashboardHeader, Leaderboard component, tabs, styles * Added ChallengesList component, updated login logic, tabs * Refactor existing approach, update models, add filtering * Add UI folder, add id for switcher and random avatar generating * Remove old dashboard components, rename util file * Add dashboard link to dapps sidebar instead of navbar * Add TODOs, rename component * Fix issues * Add Dashboard for Dapps challenges (#3) (#4) * Added dashboard component, styled cards * Added DashboardHeader, Leaderboard component, tabs, styles * Added ChallengesList component, updated login logic, tabs * Refactor existing approach, update models, add filtering * Add UI folder, add id for switcher and random avatar generating * Remove old dashboard components, rename util file * Add dashboard link to dapps sidebar instead of navbar * Add TODOs, rename component * Fix issues Co-authored-by: Iryna Telesheva <131377033+itelesheva@users.noreply.github.com> * Merge SDC from julian-dev28:main to Stellar:SSDC23 (#541) * Update index.tsx * update kv:worker endpoint * Update index.tsx * Add Root component, finish-step-button, update styles * Add library for toast notifications, show milestone notification * Add class for HttpClient, functions for requests * Changed backend model, finalize user progress on course * Add confetti effect on complete button click, refactor * Remove mocks, use endpoint, fix issues * Merge Development into main (#2) * update kv:worker endpoint * Update index.tsx * Add Root component, finish-step-button, update styles * Add library for toast notifications, show milestone notification * Add class for HttpClient, functions for requests * Changed backend model, finalize user progress on course * Add confetti effect on complete button click, refactor * Remove mocks, use endpoint, fix issues --------- Co-authored-by: Iryna Telesheva Co-authored-by: Iryna Telesheva <131377033+itelesheva@users.noreply.github.com> * Add Dashboard for Dapps challenges (#3) (#4) * Added dashboard component, styled cards * Added DashboardHeader, Leaderboard component, tabs, styles * Added ChallengesList component, updated login logic, tabs * Refactor existing approach, update models, add filtering * Add UI folder, add id for switcher and random avatar generating * Remove old dashboard components, rename util file * Add dashboard link to dapps sidebar instead of navbar * Add TODOs, rename component * Fix issues Co-authored-by: Iryna Telesheva <131377033+itelesheva@users.noreply.github.com> --------- Co-authored-by: Iryna Telesheva Co-authored-by: Iryna Telesheva <131377033+itelesheva@users.noreply.github.com> * Update the user workflow for the challenges with CI/CD (#5) * Update the Crowdfund challenge with pull request validation step info * Refactor * Add isPullRequestRequired field handling * Update text for Crowdfund checkpoint 8 * Make isPullRequestRequired required * Fix issue with dates * Merge branch 'main' into SSDC23 * Update challenge-0-crowdfund.mdx --------- Co-authored-by: Iryna Telesheva Co-authored-by: Iryna Telesheva <131377033+itelesheva@users.noreply.github.com> * Add lp dapp challenge (#543) * Create challenge-2-liquidity-pool * update lp dapp challenge * complete lp-dapp challenge * nit spelling * Update challenge-2-liquidity-pool.mdx * nit spelling * nit add steps to workflow * nit update workflow * update workflow again * add diff * edit diff * more diff editing * editorial edits * Update dapps/dapp-challenges/challenge-2-liquidity-pool.mdx Co-authored-by: Elliot Voris * Update dapps/dapp-challenges/challenge-2-liquidity-pool.mdx Co-authored-by: Elliot Voris * Update dapps/dapp-challenges/challenge-2-liquidity-pool.mdx Co-authored-by: Elliot Voris * Update dapps/dapp-challenges/challenge-2-liquidity-pool.mdx Co-authored-by: Elliot Voris * Update dapps/dapp-challenges/challenge-2-liquidity-pool.mdx Co-authored-by: Elliot Voris * add reference to earlier step; fix conflict in crowdfund dapp page * update quickstart version * small wording change --------- Co-authored-by: Bri Wylde <92327786+briwylde08@users.noreply.github.com> Co-authored-by: Elliot Voris * Sdc mental models: payment dapp upgrades (#641) * bringing sdc-mental-models branch up to date (#632) * feat: provide a means of receiving simple feedback from users (#587) * feat: provide a means of receiving simple feedback from users Here, we have swizzled (ejected) the `DocItem/Footer` component from docusaurus, and are inserting our own `ReaderFeedback` component into it before the rest of the doc footer content. Also, the `custom.scss` file has been used to style this element in a consistent manner with the rest of the site. This is the first step to resolve #586: The user interaction can now take place. From here, we will work on integrating the custom events into Google analytics. Ultimately, we will like to implment this feature into the `stellar-docs` repository, as well. Refs: #586 * Moving some React state things around * Including an `alt` tag for the like/dislike buttons * use the `pageId` for `eventLabel` in the send event * style: Linting the code * style: changing inline svg tag to be on newlines, changine filename to `jsx` * feat: Inserting the `DocItem/Footer` components on `dapps` and `api` pages * feat: migrating to the GA4 plugin in docusaurus * Testing with a new ga4 tracking id for preview domain * add some console statements to test what's happening * add configuration for test gtag container for this pr preview * feat: use `gtag` over the deprecated `ga` function * adding my own test gtag? * Remove the `gtag` function call, and just register state * removing the old-style google analytics tag for good * remove staging tag manager containers in preparation for production * replace staging ga4 tracking id with production tracking id * use `@site/static` for feedback button imports, rename file extension * rpc: rename expirationLedgerSeq to liveUntilLedgerSeq (#625) * rpc: rename expirationLedgerSeq to liveUntilLedgerSeq * rpc: rename expiration ledger in openrpc file --------- Co-authored-by: Elliot Voris * Remove docker image hashes (#628) * remove mentions of specific image hashes in docker commands * update docker image hash to most recent version on releases page * Update WASM retrieval tutorial (#627) * docs: explain the diagnostic events that are emitted in sandbox (#593) * docs: explain the diagnostic events that are emitted in sandbox Perhaps this approach is too verbose? I think having the explanation of what is being seen right there in the tutorial is useful at this early step in the "getting started" section. A new developer is more likely to understand what they see, and remember what it is in the future if we don't try to interrupt their flow at this point by sending them to another page for some (possibly irrelevant) info. I may be incorrect there, and I'm happy to hear opinions from others. Refs: #521 * docs: add a space between two words * editorial in Update hello-world.mdx --------- Co-authored-by: Bri Wylde <92327786+briwylde08@users.noreply.github.com> * Fix a couple typos in rust-dialect.mdx (#630) --------- Co-authored-by: Elliot Voris Co-authored-by: Alfonso Acosta Co-authored-by: George Co-authored-by: Bri Wylde <92327786+briwylde08@users.noreply.github.com> Co-authored-by: Sapo-Dorado * Crowdfund dapp copy updates v1 Added in some (minimal) context throughout. Tidied up a few grammatical/spelling inconsistencies. * add description and update "ship it" workflow * update soroban-cli install * Update challenge-0-crowdfund.mdx * remove extra vercel link * Merge branch 'main' into sdc-mental-models * Add intro to dapps * nit formatting * Payment dapp copy updates Updates to Checkpoints 0-4 of the Payment dapp challenge, including added copy and a few very minor grammatical upgrades. * add more context * Merge Payment dapp fix (#643) * Update latest testnet-compatible JavaScript release versions (#634) * Update latest testnet-compatible JavaScript release versions * Add links to release notes for each version * Upgrade `getLedgerEntries` examples to latest pre-stable releases of the SDKs (#635) Co-authored-by: Elliot Voris * Switch Ubuntu base image to 22.04 from 20.04 (#638) Signed-off-by: Satyam Zode Co-authored-by: Satyam Zode * Update getting-started for 20.0.0-rc.4.1 cli (#636) * Updates to setup.mdx * Add CLI for testnet configuration to Setup * Updates to hello-world.mdx Reorder some code snippets to be after the description * Small edits in storing-data.mdx * Add high_expiration_watermark argument to bump in incrementor * Move deploy-to-testnet after hello-world to allow the user to interact with their contract on testnet * Add Optimizing Builds to hello-world * Update storing-data to remove sandbox interation * Add a deploy-incrementor-to-testnet step * Update position of Create an App * Apply suggestions from code review Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> * Update create-an-app.mdx * Fix typo * Add a mv command for .soroban dir when reorganizing to a multi-contract project * Apply mdx prettier updates * Update astro port in create-an-app.mdx * Apply suggestions from code review Co-authored-by: Elliot Voris * Add .mdx to end of internal markdown links for docusaurus magic * Make sure there are new lines before and after ::: tags * Some additional edits/improvements * Mention that Freighter is available as a firefox add-on * Update the deploy-incrementor url * Apply prettier updates --------- Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> Co-authored-by: Elliot Voris * docs: change preflight wording to simulate transaction (#585) * docs: change preflight wording to simulate transaction A first attempt to resolve #478, there may be more work to be done. I've used a few different phrases, depending on how the sentence structure works, perhaps taking some liberties in the process. I've also left alone the `releases` page for preview releases older than 11. It seems unnecessary to rewrite the development history too far into the past. Refs: #478 * editorial on Update interacting-with-contracts.mdx * added a couple "the"s Update state-expiration.mdx * fix wording about ledger entries to be less confusing * clearing up some other language surrounding footprints --------- Co-authored-by: Bri Wylde <92327786+briwylde08@users.noreply.github.com> * Create data-providers.mdx (#629) * Create data-providers.mdx Adding new page for data providers to cover indexers and block explorers * Update data-providers.mdx updated explanation text * style: fixing some markdown styles and formatting * Adding some more verbose descriptions and links --------- Co-authored-by: Elliot Voris * docs: change sitewide wording from "preview release" to "release candidate" (#639) * docs: update welcome page "preview release" > "release candidate" * docs: change "preview release" > "release candidate" on releases page * update payment challenge; add styles * add clickable object to localhost:9000 example * Update challenge-1-payment.mdx * Squashed commit of the following: commit b6a1a46df7d2b42b340f1331ec52733bc6216725 Author: Julian Martinez Date: Wed Nov 8 10:10:12 2023 -0800 add more context --------- Signed-off-by: Satyam Zode Co-authored-by: George Co-authored-by: Elliot Voris Co-authored-by: Satyam Zode <5508956+satyamz@users.noreply.github.com> Co-authored-by: Satyam Zode Co-authored-by: Elizabeth Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> Co-authored-by: Elliot Voris Co-authored-by: Bri Wylde <92327786+briwylde08@users.noreply.github.com> Co-authored-by: jcx120 <91218921+jcx120@users.noreply.github.com> * format image * Squashed commit of the following: commit 308444d93d4f7133107ca499a6d255fe5ae302d4 Author: Julian Martinez Date: Wed Nov 8 14:55:06 2023 -0800 update copy commit ec062702a5a900ff890bf5cc99dfd9b6dbe1915a Author: Julian Martinez Date: Wed Nov 8 12:34:07 2023 -0800 add styles for lp commit f7bbf2e61a262aa6dd76bed2f43cd26aafce075b Author: Julian Martinez Date: Wed Nov 8 12:13:49 2023 -0800 add image styles * update copy for production deployment * caution -> tip * add commas, add soroban-cli install to payment dapp * fix broken link * Squashed commit of the following: commit 7de8a99ec32065376ea4fd2f42a14194cdda6e49 Author: Elliot Voris Date: Thu Nov 9 15:47:49 2023 -0600 docs: move data providers page out of sdks directory (#645) commit 55e0a866c6dbbe2b4dd38f38816915d59c962584 Author: Elliot Voris Date: Tue Nov 7 11:40:20 2023 -0600 docs: change sitewide wording from "preview release" to "release candidate" (#639) * docs: update welcome page "preview release" > "release candidate" * docs: change "preview release" > "release candidate" on releases page commit 2ae107280eb4bfee7192e7bdabf704c80ffab43c Author: jcx120 <91218921+jcx120@users.noreply.github.com> Date: Tue Nov 7 08:48:50 2023 -0800 Create data-providers.mdx (#629) * Create data-providers.mdx Adding new page for data providers to cover indexers and block explorers * Update data-providers.mdx updated explanation text * style: fixing some markdown styles and formatting * Adding some more verbose descriptions and links --------- Co-authored-by: Elliot Voris commit 0054011876a8273788a5bf6de16623683c9159d2 Author: Elliot Voris Date: Mon Nov 6 11:00:02 2023 -0600 docs: change preflight wording to simulate transaction (#585) * docs: change preflight wording to simulate transaction A first attempt to resolve #478, there may be more work to be done. I've used a few different phrases, depending on how the sentence structure works, perhaps taking some liberties in the process. I've also left alone the `releases` page for preview releases older than 11. It seems unnecessary to rewrite the development history too far into the past. Refs: #478 * editorial on Update interacting-with-contracts.mdx * added a couple "the"s Update state-expiration.mdx * fix wording about ledger entries to be less confusing * clearing up some other language surrounding footprints --------- Co-authored-by: Bri Wylde <92327786+briwylde08@users.noreply.github.com> commit b9710ea0ea6c4652aea2019504534197195a2b3a Author: Elizabeth Date: Mon Nov 6 11:59:21 2023 -0500 Update getting-started for 20.0.0-rc.4.1 cli (#636) * Updates to setup.mdx * Add CLI for testnet configuration to Setup * Updates to hello-world.mdx Reorder some code snippets to be after the description * Small edits in storing-data.mdx * Add high_expiration_watermark argument to bump in incrementor * Move deploy-to-testnet after hello-world to allow the user to interact with their contract on testnet * Add Optimizing Builds to hello-world * Update storing-data to remove sandbox interation * Add a deploy-incrementor-to-testnet step * Update position of Create an App * Apply suggestions from code review Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> * Update create-an-app.mdx * Fix typo * Add a mv command for .soroban dir when reorganizing to a multi-contract project * Apply mdx prettier updates * Update astro port in create-an-app.mdx * Apply suggestions from code review Co-authored-by: Elliot Voris * Add .mdx to end of internal markdown links for docusaurus magic * Make sure there are new lines before and after ::: tags * Some additional edits/improvements * Mention that Freighter is available as a firefox add-on * Update the deploy-incrementor url * Apply prettier updates --------- Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> Co-authored-by: Elliot Voris commit 61054dcad82dbf77c28aa1819ad08b6fa132ad70 Author: Satyam Zode <5508956+satyamz@users.noreply.github.com> Date: Fri Nov 3 20:26:27 2023 +0530 Switch Ubuntu base image to 22.04 from 20.04 (#638) Signed-off-by: Satyam Zode Co-authored-by: Satyam Zode commit d6091131996ab81e42dff57f4bccaad3f5d56b3e Author: George Date: Thu Nov 2 12:53:52 2023 -0700 Upgrade `getLedgerEntries` examples to latest pre-stable releases of the SDKs (#635) Co-authored-by: Elliot Voris commit 228e4bfed691effa58a07b664abfd78b04e6dcd4 Author: George Date: Thu Nov 2 09:18:50 2023 -0700 Update latest testnet-compatible JavaScript release versions (#634) * Update latest testnet-compatible JavaScript release versions * Add links to release notes for each version * add SEO logic --------- Signed-off-by: Satyam Zode Co-authored-by: Elliot Voris Co-authored-by: Alfonso Acosta Co-authored-by: George Co-authored-by: Bri Wylde <92327786+briwylde08@users.noreply.github.com> Co-authored-by: Sapo-Dorado Co-authored-by: Julian Martinez Co-authored-by: Julian Martinez <73849597+Julian-dev28@users.noreply.github.com> Co-authored-by: Satyam Zode <5508956+satyamz@users.noreply.github.com> Co-authored-by: Satyam Zode Co-authored-by: Elizabeth Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> Co-authored-by: Elliot Voris Co-authored-by: jcx120 <91218921+jcx120@users.noreply.github.com> * undo some changes from the docs scavenger hunt (#656) * clearer Soroban favicon (#662) * Add oracle dapp challenge (#664) * add oracle dapp * update endpoint * add images * Update http-client.ts * update challenge list * add last checkpoint to oracle dapp * Update http-client.ts * update meta tag * add some items for the rollout (#684) * Pre mainnet restructure (#644) * docs: rename "fundamentals and concepts" to "soroban internals" * docs: remove old "under the hood" section * docs: add tags to the various tutorials * docs: move tutorials into one main directory * fix broken links to old pages * docs: renaming soroban internals in category file * docs: remove old "command line reference" category * docs: add tokens directory, rearrange sidebars * docs: rearrange migration from evm guide * docs: remove unused reference/interfaces category * docs: move "reference" section to "resources" * docs: move "releases" page up a level * docs: move FAQ page up one level * docs: move dev tools into resources directory * docs: move testnet.mdx to networks.mdx * docs: rearrange items in resources directory * docs: collapse various SDK pages into two pages * docs: move data-providers up one level * docs: remove some empty categories, move the tutorial template * docs: add a new getting-started page, reorganize that section * docs: change sidebar position integers in soroban-internals * docs: shuffling contract interaction around in soroban-internals * style: fixing a couple small markdown nits in dapps directory * docs: fix a broken link * feat: start to the "guides" page(s) * style(lint): fixing a small linting error * remove guides placeholder * fixing broken links * work on guides listing. might revert this * formatting mdx * docs: fixing a broken link to tutorials * style: crack at making the tutorials filterable and hidden in the sidebar * customizing some components for the `/guides` pages and layouts * rename index page for guides to README * remove commented configuration option * remove some console logging in components * change name of index page in guides sidebar * remove commented sidebar generation code * remove comments and add description to sidebar generator * rename sidebar generator file * more work on how the 'guides' pages might look. * docs: adjusting sidebar positions of new getting started pages * fix some broken links in the getting-started section * prefer "README.mdx" files where possible * some more guides placeholder stubs * docs(guides): More placeholder stubs for guides and categories * feat: don't display "guides in category" page on `/guides` * build: check/fix MDX formatting in more directories than just docs * style: add a larger margin before more category guides * style: more selectively increase that top margin * docs(guides): a quick stab at a "publishing" events guide * docs(guides): first stab at the "publish events" guide * docs: updating tutorial descriptions * fix a few broken links * docs: add note about a tuple with one element * style: couple link changes and reformats * move fuzzing tutorial back * change to README file in contract interactions category * docs(guides): give a better title for the wasm metadata guide * fixing some broken markdown links * fix (another!) broken link * move the guides back into the main layout of the docs directory * add placeholder for testnet reset automation stuff * some initial content for some guides * markdown formatting and fixing broken links * moving "resources" back to "reference" to fit the definition better More like "technical reference" rather than a "reference encyclopedia" * change some styles of the tutorial list * removing most category pages * some more first-drafts of guides * fixing some category links * include a period at the end of each tutorial description * simplify tutorial search box placeholder text * better description for the tutorials page * making the pre-commit script executable * flesh out some of the state archival guides * first effort for some rpc ledger key guides * fix some broken links * add a guide on ingesting events into a db * first effort at storage type guides * Some more stubs, marking drafts, and a couple additions * make not a draft to fix a broken link * guides category descriptions in README.mdx files * marking incomplete chain migration docs as drafts * change some tutorial difficulty levels * fine-tune the tutorials component styling a bit * improving some guides organization * fix linting errors and broken links * include wrap instructions for native lumens * fix broken link in contract metadata guide * final changes to existing guides * moving developer tools into the main sidebar * create real redirects instead of just notes * fix broken links in a dapps challenge page * fix a redirect syntax error * fix a tutorials redirect * Pre mainnet restructure (#644) * docs: rename "fundamentals and concepts" to "soroban internals" * docs: remove old "under the hood" section * docs: add tags to the various tutorials * docs: move tutorials into one main directory * fix broken links to old pages * docs: renaming soroban internals in category file * docs: remove old "command line reference" category * docs: add tokens directory, rearrange sidebars * docs: rearrange migration from evm guide * docs: remove unused reference/interfaces category * docs: move "reference" section to "resources" * docs: move "releases" page up a level * docs: move FAQ page up one level * docs: move dev tools into resources directory * docs: move testnet.mdx to networks.mdx * docs: rearrange items in resources directory * docs: collapse various SDK pages into two pages * docs: move data-providers up one level * docs: remove some empty categories, move the tutorial template * docs: add a new getting-started page, reorganize that section * docs: change sidebar position integers in soroban-internals * docs: shuffling contract interaction around in soroban-internals * style: fixing a couple small markdown nits in dapps directory * docs: fix a broken link * feat: start to the "guides" page(s) * style(lint): fixing a small linting error * remove guides placeholder * fixing broken links * work on guides listing. might revert this * formatting mdx * docs: fixing a broken link to tutorials * style: crack at making the tutorials filterable and hidden in the sidebar * customizing some components for the `/guides` pages and layouts * rename index page for guides to README * remove commented configuration option * remove some console logging in components * change name of index page in guides sidebar * remove commented sidebar generation code * remove comments and add description to sidebar generator * rename sidebar generator file * more work on how the 'guides' pages might look. * docs: adjusting sidebar positions of new getting started pages * fix some broken links in the getting-started section * prefer "README.mdx" files where possible * some more guides placeholder stubs * docs(guides): More placeholder stubs for guides and categories * feat: don't display "guides in category" page on `/guides` * build: check/fix MDX formatting in more directories than just docs * style: add a larger margin before more category guides * style: more selectively increase that top margin * docs(guides): a quick stab at a "publishing" events guide * docs(guides): first stab at the "publish events" guide * docs: updating tutorial descriptions * fix a few broken links * docs: add note about a tuple with one element * style: couple link changes and reformats * move fuzzing tutorial back * change to README file in contract interactions category * docs(guides): give a better title for the wasm metadata guide * fixing some broken markdown links * fix (another!) broken link * move the guides back into the main layout of the docs directory * add placeholder for testnet reset automation stuff * some initial content for some guides * markdown formatting and fixing broken links * moving "resources" back to "reference" to fit the definition better More like "technical reference" rather than a "reference encyclopedia" * change some styles of the tutorial list * removing most category pages * some more first-drafts of guides * fixing some category links * include a period at the end of each tutorial description * simplify tutorial search box placeholder text * better description for the tutorials page * making the pre-commit script executable * flesh out some of the state archival guides * first effort for some rpc ledger key guides * fix some broken links * add a guide on ingesting events into a db * first effort at storage type guides * Some more stubs, marking drafts, and a couple additions * make not a draft to fix a broken link * guides category descriptions in README.mdx files * marking incomplete chain migration docs as drafts * change some tutorial difficulty levels * fine-tune the tutorials component styling a bit * improving some guides organization * fix linting errors and broken links * include wrap instructions for native lumens * fix broken link in contract metadata guide * final changes to existing guides * moving developer tools into the main sidebar * create real redirects instead of just notes * fix broken links in a dapps challenge page * fix a redirect syntax error * fix a tutorials redirect * docs: make the transaction lifecycle page a draft (#701) * Fix description of enums supported by contract types (#703) * Update resource limits and make a new reference page for them (#736) * add a reference page on resource limits and fees * remove resource fee/limit tables from "explainer" page * removing some unnecessary comments and entries Some of the comments are more applicable in the discussion doc, than they are for developer documentation. So, let's get rid of those. * remove unnecessary "current is..." language from resource fees * [Stellar Merge] Tools Section (#739) * create redirects for tools and SDKs pages * adjust some redirect URLs to better reflect new stellar-docs pages * forgot a semicolon! * linking to migrated developer tools page * fine-tuning some redirects * add a list of "already migrated" stuff to the sidebar * remove SDKs content that's being migrated * fix the resulting broken links * Revert "remove SDKs content that's being migrated" This reverts commit 6dd2a28a8f124e876607a9bf30894a420ea6eb08. * Revert "linking to migrated developer tools page" This reverts commit fc2340818a08c42fc1f13f6a49d97111610c9100. * try this method of turning docs into external links * include soroban-cli page in the tools migration * change cli links to developer docs * use by-name params in pagination example (#743) Refs: #728 * [Stellar Merge] Tools Section (#739) * create redirects for tools and SDKs pages * adjust some redirect URLs to better reflect new stellar-docs pages * forgot a semicolon! * linking to migrated developer tools page * fine-tuning some redirects * add a list of "already migrated" stuff to the sidebar * remove SDKs content that's being migrated * fix the resulting broken links * Revert "remove SDKs content that's being migrated" This reverts commit 6dd2a28a8f124e876607a9bf30894a420ea6eb08. * Revert "linking to migrated developer tools page" This reverts commit fc2340818a08c42fc1f13f6a49d97111610c9100. * try this method of turning docs into external links * include soroban-cli page in the tools migration * change cli links to developer docs * use by-name params in pagination example (#743) Refs: #728 * Update fee page, close #710 (#745) * Update fee page, close #710 * Apply suggestions from code review Co-authored-by: Elliot Voris Co-authored-by: Leigh McCulloch <351529+leighmcculloch@users.noreply.github.com> --------- Co-authored-by: Jane Wang Co-authored-by: Elliot Voris Co-authored-by: Leigh McCulloch <351529+leighmcculloch@users.noreply.github.com> * Update fee page, close #710 (#745) * Update fee page, close #710 * Apply suggestions from code review Co-authored-by: Elliot Voris Co-authored-by: Leigh McCulloch <351529+leighmcculloch@users.noreply.github.com> --------- Co-authored-by: Jane Wang Co-authored-by: Elliot Voris Co-authored-by: Leigh McCulloch <351529+leighmcculloch@users.noreply.github.com> * [Stellar Merge] Redirects for Soroban RPC pages (#757) * add a redirect for anything under the `/api` route * change the API navbar item to an external link * disable the `/api` plugin-content-docs * fix some broken links * updating a couple other misc redirects * add external links to RPC providers and usage instructions * add some redirects for RPC information docs * add an admonition to the rpc usage page * move some directories into a "learn" directory * more README.mdx files * update sidebars * add a "Learn" item to the top navbar * fix a boat-load of broken links * add whitespace back to list of operations * add more linebreak spaces * initial nginx redirects * Add Java SDK Example. (#765) * Add Java SDK Example. * Enable Java code highlights. * use a README file in the stellar data structures section * pull in changes for soroban-internals section * use a README file in soroban-internals section * move the soroban env diagram file location * fix broken links in soroban internals pages * run soroban internals pages through linter * use a README file in soroban types category * use README for contract interactions section * move migrate docs into learn directory * use a README document for the migration section * fixup some broken links in the migration section * fix a couple more broken links * quick placeholders for sq and fca00c, we'll want better copy probably * try to capture any anchor URLs used in the glossary * update existing redirects for new learn section * fix muxed accounts redirect * better README files in chain migration categories * rename "soroban-internals" to "smart contract internals" * fix broken links * fix canonical links in smart-contract-internals directory * change title of Smart Contracts Internals category page * couple tweaks * capitalization * fix link * use `.mdx` links to markdown files in fees encyclopedia page --------- Signed-off-by: Satyam Zode Co-authored-by: Tyler van der Hoeven Co-authored-by: Graydon Hoare Co-authored-by: Alejo Mendoza Co-authored-by: Jesmar Castillo <32423903+jesmarsc@users.noreply.github.com> Co-authored-by: Julian Martinez <73849597+Julian-dev28@users.noreply.github.com> Co-authored-by: Bri <92327786+briwylde08@users.noreply.github.com> Co-authored-by: Siddharth Suresh Co-authored-by: Leigh McCulloch <351529+leighmcculloch@users.noreply.github.com> Co-authored-by: Iryna Telesheva Co-authored-by: Iryna Telesheva <131377033+itelesheva@users.noreply.github.com> Co-authored-by: nmadadair <109177652+nmadadair@users.noreply.github.com> Co-authored-by: Alfonso Acosta Co-authored-by: George Co-authored-by: Sapo-Dorado Co-authored-by: Julian Martinez Co-authored-by: Satyam Zode <5508956+satyamz@users.noreply.github.com> Co-authored-by: Satyam Zode Co-authored-by: Elizabeth Co-authored-by: Chad Ostrowski <221614+chadoh@users.noreply.github.com> Co-authored-by: jcx120 <91218921+jcx120@users.noreply.github.com> Co-authored-by: Jane Wang Co-authored-by: Jane Wang Co-authored-by: Jun Luo <4catcode@gmail.com> --- README.md | 24 +- .../application-design-considerations.mdx | 8 +- .../account-creation.mdx | 4 +- .../anchor-integration/setup.mdx | 2 +- .../manage-trust.mdx | 4 +- .../path-payment.mdx | 4 +- .../example-application-tutorial/payment.mdx | 4 +- docs/building-apps/wallet/sep30.mdx | 2 +- docs/building-apps/wallet/stellar.mdx | 2 +- docs/encyclopedia/_category_.json | 7 - .../fundamentals-and-concepts/_category_.json | 4 - .../stellar-data-structures/_category_.json | 4 - docs/issuing-assets/control-asset-access.mdx | 14 +- docs/issuing-assets/how-to-issue-an-asset.mdx | 16 +- docs/learn/encyclopedia/README.mdx | 10 + docs/{ => learn}/encyclopedia/anchors.mdx | 4 +- .../encyclopedia/channel-accounts.mdx | 0 .../encyclopedia/claimable-balances.mdx | 4 +- docs/{ => learn}/encyclopedia/clawbacks.mdx | 0 .../encyclopedia/error-handling.mdx | 6 +- docs/{ => learn}/encyclopedia/federation.mdx | 0 .../encyclopedia/fee-bump-transactions.mdx | 4 +- .../fees-surge-pricing-fee-strategies.mdx | 8 +- docs/{ => learn}/encyclopedia/inflation.mdx | 0 .../encyclopedia/ledger-headers.mdx | 0 ...uidity-on-stellar-sdex-liquidity-pools.mdx | 6 + .../encyclopedia/lumen-supply-metrics.mdx | 0 docs/{ => learn}/encyclopedia/memos.mdx | 0 .../encyclopedia/network-passphrases.mdx | 0 .../encyclopedia/path-payments.mdx | 0 .../pooled-accounts-muxed-accounts-memos.mdx | 0 .../securing-web-based-projects.mdx | 2 +- .../encyclopedia/signatures-multisig.mdx | 4 +- .../encyclopedia/sponsored-reserves.mdx | 8 +- docs/{ => learn}/encyclopedia/xdr.mdx | 0 docs/learn/fundamentals/README.mdx | 10 + .../fundamentals}/list-of-operations.mdx | 0 .../fundamentals}/lumens.mdx | 0 .../fundamentals}/networks.mdx | 0 .../stellar-consensus-protocol.mdx | 0 .../stellar-data-structures/README.mdx | 10 + .../stellar-data-structures/accounts.mdx | 0 .../stellar-data-structures/assets.mdx | 4 +- .../stellar-data-structures/contracts.mdx | 0 .../stellar-data-structures/ledgers.mdx | 0 .../operations-and-transactions.mdx | 0 .../stellar-ecosystem-proposals.mdx | 0 .../fundamentals}/stellar-stack.mdx | 2 +- .../fundamentals}/transaction-lifecycle.mdx | 0 docs/{ => learn}/glossary.mdx | 42 +- docs/learn/interactive/README.mdx | 10 + docs/learn/interactive/fca00c.mdx | 12 + docs/learn/interactive/quest.mdx | 10 + docs/learn/migrate/README.mdx | 10 + docs/learn/migrate/cosmos.mdx | 8 + docs/learn/migrate/evm/README.mdx | 10 + .../evm/introduction-to-solidity-and-rust.mdx | 37 + .../migrate/evm/smart-contract-deployment.mdx | 1299 ++++ .../solidity-and-rust-advanced-concepts.mdx | 907 +++ .../migrate/evm/solidity-and-rust-basics.mdx | 643 ++ docs/learn/migrate/near.mdx | 8 + docs/learn/migrate/solana.mdx | 8 + .../learn/smart-contract-internals/README.mdx | 10 + .../authorization.mdx | 180 + .../contract-interactions/README.mdx | 10 + .../contract-interactions/cross-contract.mdx | 25 + .../contract-interactions/overview.mdx | 43 + .../stellar-transaction.mdx | 677 ++ .../contract-interactions/tests.mdx | 24 + .../transaction-simulation.mdx | 35 + .../contract-lifecycle.mdx | 66 + .../smart-contract-internals/debugging.mdx | 60 + .../environment-concepts.mdx | 73 + .../learn/smart-contract-internals/errors.mdx | 48 + .../learn/smart-contract-internals/events.mdx | 129 + .../fees-and-metering.mdx | 135 + .../high-level-overview.mdx | 52 + .../persisting-data.mdx | 102 + .../smart-contract-internals/rust-dialect.mdx | 80 + .../state-archival.mdx | 405 ++ .../transaction-lifecycle.mdx | 15 + .../smart-contract-internals/types/README.mdx | 10 + .../types/built-in-types.mdx | 91 + .../types/custom-types.mdx | 129 + .../types/fully-typed-contracts.mdx | 101 + docs/tutorials/create-account.mdx | 8 +- docs/tutorials/follow-received-payments.mdx | 6 +- docs/tutorials/send-and-receive-payments.mdx | 12 +- docusaurus.config.js | 6 + .../anchor-platform/admin-guide/overview.mdx | 2 +- .../admin-guide/sep24/integration.mdx | 2 +- .../sep24/setting-up-production-server.mdx | 2 +- .../admin-guide/sep6/integration.mdx | 2 +- .../callbacks/del-customer.api.mdx | 2 +- .../callbacks/gen-address.api.mdx | 8 +- .../callbacks/get-customer.api.mdx | 2 +- .../anchor-platform/callbacks/get-fee.api.mdx | 2 +- .../callbacks/get-rates.api.mdx | 4 +- .../callbacks/post-event.api.mdx | 4 +- .../callbacks/put-customer.api.mdx | 6 +- .../create-custody-transaction.api.mdx | 2 +- .../generate-unique-address.api.mdx | 2 +- .../custody-server/send-payment.api.mdx | 2 +- .../custody-server/send-refund.api.mdx | 2 +- .../resources/get-transaction.api.mdx | 4 +- .../resources/get-transactions.api.mdx | 4 +- .../resources/transactions/README.mdx | 2 +- network/core-node/README.mdx | 2 +- network/core-node/admin-guide/configuring.mdx | 8 +- network/core-node/admin-guide/monitoring.mdx | 2 +- network/horizon/README.mdx | 2 +- network/horizon/admin-guide/configuring.mdx | 2 +- .../aggregations/order-books/README.mdx | 2 +- network/horizon/aggregations/paths/README.mdx | 2 +- .../operation-specific/README.mdx | 2 +- .../operation-specific/account-merge.mdx | 2 +- .../operation-specific/allow-trust.mdx | 2 +- .../operation-specific/bump-sequence.mdx | 2 +- .../operation-specific/change-trust.mdx | 2 +- .../operation-specific/create-account.mdx | 2 +- .../create-passive-sell-offer.mdx | 2 +- .../operation-specific/manage-buy-offer.mdx | 2 +- .../operation-specific/manage-data.mdx | 2 +- .../operation-specific/manage-sell-offer.mdx | 2 +- .../path-payment-strict-receive.mdx | 2 +- .../path-payment-strict-send.mdx | 2 +- .../operation-specific/payment.mdx | 2 +- .../operation-specific/set-options.mdx | 2 +- network/horizon/resources/accounts/README.mdx | 2 +- network/horizon/resources/accounts/object.mdx | 6 +- network/horizon/resources/assets/README.mdx | 2 +- .../cb-retrieve-related-operations.api.mdx | 2 +- .../cb-retrieve-related-transactions.api.mdx | 2 +- .../horizon/resources/get-all-offers.api.mdx | 2 +- .../horizon/resources/get-all-trades.api.mdx | 2 +- .../resources/get-data-by-account-id.api.mdx | 2 +- .../get-effects-by-account-id.api.mdx | 2 +- .../resources/get-offer-by-offer-id.api.mdx | 2 +- .../get-offers-by-account-id.api.mdx | 2 +- .../get-operations-by-account-id.api.mdx | 2 +- .../get-payments-by-account-id.api.mdx | 2 +- .../get-trades-by-account-id.api.mdx | 2 +- .../resources/get-trades-by-offer-id.api.mdx | 2 +- .../get-transactions-by-account-id.api.mdx | 2 +- network/horizon/resources/ledgers/README.mdx | 2 +- network/horizon/resources/ledgers/object.mdx | 2 +- .../resources/list-all-accounts.api.mdx | 2 +- .../horizon/resources/list-all-assets.api.mdx | 2 +- .../list-all-claimable-balances.api.mdx | 2 +- .../resources/list-all-effects.api.mdx | 2 +- .../resources/list-all-ledgers.api.mdx | 2 +- .../resources/list-all-operations.api.mdx | 2 +- .../resources/list-all-payments.api.mdx | 2 +- .../resources/list-all-transactions.api.mdx | 2 +- .../resources/list-liquidity-pools.api.mdx | 2 +- .../list-strict-receive-payment-paths.api.mdx | 2 +- .../list-strict-send-payment-paths.api.mdx | 2 +- .../resources/list-trade-aggregations.api.mdx | 2 +- .../lp-retrieve-related-operations.api.mdx | 2 +- .../lp-retrieve-related-transactions.api.mdx | 2 +- network/horizon/resources/offers/README.mdx | 2 +- .../object/extend-footprint-ttl.mdx | 2 +- .../object/invoke-host-function.mdx | 6 +- .../object/liquidity-pool-deposit.mdx | 2 +- .../object/liquidity-pool-withdraw.mdx | 2 +- .../operations/object/restore-footprint.mdx | 2 +- .../retrieve-a-claimable-balance.api.mdx | 2 +- .../resources/retrieve-a-ledger.api.mdx | 2 +- .../retrieve-a-ledgers-effects.api.mdx | 2 +- .../retrieve-a-ledgers-operations.api.mdx | 2 +- .../retrieve-a-ledgers-payments.api.mdx | 2 +- .../retrieve-a-ledgers-transactions.api.mdx | 2 +- .../retrieve-a-liquidity-pool.api.mdx | 2 +- .../resources/retrieve-a-transaction.api.mdx | 2 +- .../retrieve-a-transactions-effects.api.mdx | 2 +- ...retrieve-a-transactions-operations.api.mdx | 2 +- .../resources/retrieve-an-account.api.mdx | 2 +- .../resources/retrieve-an-operation.api.mdx | 2 +- .../retrieve-an-operations-effects.api.mdx | 2 +- .../resources/retrieve-an-order-book.api.mdx | 2 +- .../resources/retrieve-fee-stats.api.mdx | 2 +- .../retrieve-related-effects.api.mdx | 2 +- .../resources/retrieve-related-trades.api.mdx | 2 +- .../resources/submit-a-transaction.api.mdx | 2 +- network/horizon/resources/trades/README.mdx | 2 +- .../horizon/resources/transactions/README.mdx | 2 +- .../horizon/resources/transactions/object.mdx | 2 +- network/hubble/optimizing-queries.mdx | 2 +- .../resources/authenticate-mfa.api.mdx | 2 +- .../resources/create-asset.api.mdx | 2 +- .../resources/create-disbursement.api.mdx | 2 +- .../resources/create-user.api.mdx | 2 +- .../resources/delete-asset.api.mdx | 2 +- ...download-disbursement-instructions.api.mdx | 2 +- .../resources/forgot-password.api.mdx | 2 +- .../resources/get-all-assets.api.mdx | 2 +- .../resources/get-all-countries.api.mdx | 2 +- .../resources/get-all-roles.api.mdx | 2 +- .../resources/get-all-users.api.mdx | 2 +- .../resources/get-all-wallets.api.mdx | 2 +- .../resources/get-organization-info.api.mdx | 2 +- .../resources/get-organization-logo.api.mdx | 2 +- .../resources/get-profile.api.mdx | 2 +- .../list-all-disbursement-receivers.api.mdx | 2 +- .../resources/list-all-disbursements.api.mdx | 2 +- .../resources/list-all-payments.api.mdx | 2 +- .../resources/list-all-receivers.api.mdx | 2 +- .../resources/log-in.api.mdx | 2 +- ...ovide-signed-challenge-transaction.api.mdx | 2 +- .../resources/refresh-token.api.mdx | 2 +- .../request-challenge-transaction.api.mdx | 2 +- .../request-registration-url.api.mdx | 2 +- .../resources/reset-password.api.mdx | 2 +- .../resources/retrieve-a-disbursement.api.mdx | 2 +- .../resources/retrieve-a-payment.api.mdx | 2 +- .../resources/retrieve-a-receiver.api.mdx | 2 +- .../resources/retrieve-all-statistics.api.mdx | 2 +- .../retrieve-disbursement-statistics.api.mdx | 2 +- .../retrieve-stellar-info-file.api.mdx | 2 +- .../resources/send-one-time-passcode.api.mdx | 2 +- .../start-wallet-registration.api.mdx | 2 +- .../update-a-disbursement-status.api.mdx | 2 +- .../resources/update-a-receiver.api.mdx | 2 +- .../update-organization-profile.api.mdx | 2 +- .../update-user-activation-status.api.mdx | 2 +- .../resources/update-user-profile.api.mdx | 2 +- .../resources/update-user-role.api.mdx | 2 +- .../upload-disbursement-instructions.api.mdx | 2 +- .../verify-receiver-registration.api.mdx | 2 +- nginx/includes/redirects.conf | 62 +- openapi/anchor-platform/Callbacks API.yml | 4 +- openapi/anchor-platform/bundled_callback.yml | 4 +- openrpc/src/methods/simulateTransaction.json | 4 +- sidebars.js | 46 +- .../assets/diagrams/environment-concepts.png | Bin 0 -> 105149 bytes static/img/add_token.png | Bin 0 -> 42901 bytes static/img/added_balance.png | Bin 0 -> 66437 bytes static/img/approveTokenMint.png | Bin 0 -> 96343 bytes static/img/approveTxn.png | Bin 0 -> 102577 bytes static/img/aucb_balance.png | Bin 0 -> 70313 bytes static/img/back100.png | Bin 0 -> 87628 bytes static/img/backedResult.png | Bin 0 -> 91548 bytes static/img/balance_rcvr.png | Bin 0 -> 66001 bytes static/img/choose_token.png | Bin 0 -> 118473 bytes static/img/confirm_mint.png | Bin 0 -> 120632 bytes static/img/confirm_pmt.png | Bin 0 -> 401975 bytes static/img/connect_freighter.png | Bin 0 -> 81645 bytes static/img/connect_freighter_example.png | Bin 0 -> 30778 bytes static/img/connect_wallet.png | Bin 0 -> 74371 bytes static/img/counter.png | Bin 0 -> 235960 bytes static/img/dashboard-bg.png | Bin 0 -> 378728 bytes static/img/deploy-counter.png | Bin 0 -> 93771 bytes static/img/deployed-contracts.png | Bin 0 -> 45115 bytes static/img/deployedDApp.png | Bin 0 -> 815878 bytes static/img/deposit50.png | Bin 0 -> 74496 bytes static/img/docusaurus-social-card.jpg | Bin 0 -> 55746 bytes static/img/docusaurus.png | Bin 0 -> 5142 bytes static/img/dt_acct_bal.png | Bin 0 -> 67811 bytes static/img/end.png | Bin 0 -> 117455 bytes static/img/example.png | Bin 0 -> 125958 bytes static/img/freighter_settings.png | Bin 0 -> 157462 bytes static/img/futurenetDeployment.png | Bin 0 -> 161660 bytes static/img/gear_icon.png | Bin 0 -> 61989 bytes static/img/hex2str.png | Bin 0 -> 108622 bytes static/img/increment.png | Bin 0 -> 47344 bytes static/img/input_token_id.png | Bin 0 -> 116604 bytes static/img/landing/arrow-black.svg | 26 + static/img/landing/arrow-white.svg | 26 + static/img/landing/designed-for-icon.svg | 3 + static/img/landing/discord-1.svg | 12 + static/img/landing/earn.svg | 4446 ++++++++++++ static/img/landing/group-245.svg | 8 + static/img/landing/icon.svg | 8 + static/img/landing/icon1.svg | 8 + static/img/landing/icon2.svg | 8 + static/img/landing/icon3.svg | 8 + static/img/landing/icon4.svg | 8 + static/img/landing/icon5.svg | 8 + static/img/landing/icon6.svg | 3 + static/img/landing/image-1.svg | 2204 ++++++ static/img/landing/image-11.svg | 3 + static/img/landing/image-111@3x.png | Bin 0 -> 543735 bytes static/img/landing/image-1@2x.png | Bin 0 -> 14787 bytes static/img/landing/image-2.svg | 6294 +++++++++++++++++ static/img/landing/image-23.svg | 3 + static/img/landing/image-231@3x.png | Bin 0 -> 606601 bytes static/img/landing/image-3.svg | 9 + static/img/landing/image-39@2x.png | Bin 0 -> 32632 bytes static/img/landing/image-4.svg | 4881 +++++++++++++ static/img/landing/image-4@2x.png | Bin 0 -> 14809 bytes static/img/landing/image-5.svg | 15 + static/img/landing/image-54.svg | 3 + static/img/landing/learn.svg | 18 + static/img/landing/scf.svg | 10 + static/img/landing/ships.svg | 1106 +++ static/img/landing/soroban-white.svg | 9 + static/img/landing/twitter-1.svg | 3 + static/img/landing/vector-6.svg | 3 + static/img/landing/vector-7.svg | 3 + static/img/landing/vector-8.svg | 3 + static/img/landing/vector.svg | 3 + static/img/landing/vector1.svg | 3 + static/img/landing/vector2.svg | 3 + static/img/landing/vector3.svg | 3 + static/img/landing/vector4.svg | 3 + static/img/landing/youtube-1.svg | 10 + static/img/leaderboard-placeholder.png | Bin 0 -> 9120 bytes static/img/manage_assets.png | Bin 0 -> 66392 bytes static/img/meta.png | Bin 0 -> 24928 bytes static/img/mintToken.png | Bin 0 -> 84961 bytes static/img/mint_amt.png | Bin 0 -> 99529 bytes static/img/mint_token.png | Bin 0 -> 103001 bytes static/img/mint_token_landing.png | Bin 0 -> 87337 bytes static/img/mint_tokens.png | Bin 0 -> 39722 bytes static/img/mint_tx_result.png | Bin 0 -> 100260 bytes static/img/new_token.png | Bin 0 -> 51686 bytes static/img/next.png | Bin 0 -> 83761 bytes static/img/oracle_approve.png | Bin 0 -> 100237 bytes static/img/oracle_balance_contract.png | Bin 0 -> 72354 bytes static/img/oracle_balance_user.png | Bin 0 -> 30562 bytes static/img/oracle_calculate.png | Bin 0 -> 98243 bytes static/img/oracle_connect.png | Bin 0 -> 168819 bytes static/img/oracle_deployed.png | Bin 0 -> 294169 bytes static/img/oracle_home.png | Bin 0 -> 159998 bytes static/img/oracle_mint.png | Bin 0 -> 54174 bytes static/img/oracle_mintBal.png | Bin 0 -> 52756 bytes static/img/payment_settings.png | Bin 0 -> 106856 bytes static/img/pmt_dest.png | Bin 0 -> 112593 bytes static/img/preferences_menu.png | Bin 0 -> 60051 bytes static/img/select_token.png | Bin 0 -> 100125 bytes static/img/sign_tx.png | Bin 0 -> 362736 bytes static/img/soroban-fav-icon.png | Bin 0 -> 694 bytes static/img/soroban-wordmark-temp-dark.svg | 12 + static/img/soroban-wordmark-temp.svg | 12 + static/img/soroban_fees.png | Bin 0 -> 99373 bytes static/img/stellar-logo-dark.svg | 19 +- static/img/stellar-logo.svg | 19 +- static/img/submit_mint_tx.png | Bin 0 -> 210447 bytes static/img/submit_pmt.png | Bin 0 -> 204517 bytes static/img/success.png | Bin 0 -> 62418 bytes static/img/swap.png | Bin 0 -> 96290 bytes static/img/swapComplete.png | Bin 0 -> 137854 bytes static/img/timeline-drk.png | Bin 0 -> 53084 bytes static/img/timeline-lgt.png | Bin 0 -> 55640 bytes static/img/token_to_mint.png | Bin 0 -> 114068 bytes static/img/tutorial/docsVersionDropdown.png | Bin 0 -> 25102 bytes static/img/tutorial/localeDropdown.png | Bin 0 -> 30020 bytes static/img/tx_settings.png | Bin 0 -> 114721 bytes static/img/undraw_docusaurus_mountain.svg | 171 + static/img/undraw_docusaurus_react.svg | 170 + static/img/undraw_docusaurus_tree.svg | 40 + static/img/updatedBalance.png | Bin 0 -> 84839 bytes static/img/updatedBalances.png | Bin 0 -> 41280 bytes static/img/updatedBalances50.png | Bin 0 -> 40311 bytes static/img/vault-project.png | Bin 0 -> 22278 bytes static/img/wallet_connected.png | Bin 0 -> 81613 bytes static/img/wdraw.png | Bin 0 -> 89301 bytes 357 files changed, 25398 insertions(+), 358 deletions(-) delete mode 100644 docs/encyclopedia/_category_.json delete mode 100644 docs/fundamentals-and-concepts/_category_.json delete mode 100644 docs/fundamentals-and-concepts/stellar-data-structures/_category_.json create mode 100644 docs/learn/encyclopedia/README.mdx rename docs/{ => learn}/encyclopedia/anchors.mdx (90%) rename docs/{ => learn}/encyclopedia/channel-accounts.mdx (100%) rename docs/{ => learn}/encyclopedia/claimable-balances.mdx (98%) rename docs/{ => learn}/encyclopedia/clawbacks.mdx (100%) rename docs/{ => learn}/encyclopedia/error-handling.mdx (98%) rename docs/{ => learn}/encyclopedia/federation.mdx (100%) rename docs/{ => learn}/encyclopedia/fee-bump-transactions.mdx (89%) rename docs/{ => learn}/encyclopedia/fees-surge-pricing-fee-strategies.mdx (96%) rename docs/{ => learn}/encyclopedia/inflation.mdx (100%) rename docs/{ => learn}/encyclopedia/ledger-headers.mdx (100%) rename docs/{ => learn}/encyclopedia/liquidity-on-stellar-sdex-liquidity-pools.mdx (99%) rename docs/{ => learn}/encyclopedia/lumen-supply-metrics.mdx (100%) rename docs/{ => learn}/encyclopedia/memos.mdx (100%) rename docs/{ => learn}/encyclopedia/network-passphrases.mdx (100%) rename docs/{ => learn}/encyclopedia/path-payments.mdx (100%) rename docs/{ => learn}/encyclopedia/pooled-accounts-muxed-accounts-memos.mdx (100%) rename docs/{ => learn}/encyclopedia/securing-web-based-projects.mdx (99%) rename docs/{ => learn}/encyclopedia/signatures-multisig.mdx (97%) rename docs/{ => learn}/encyclopedia/sponsored-reserves.mdx (98%) rename docs/{ => learn}/encyclopedia/xdr.mdx (100%) create mode 100644 docs/learn/fundamentals/README.mdx rename docs/{fundamentals-and-concepts => learn/fundamentals}/list-of-operations.mdx (100%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/lumens.mdx (100%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/networks.mdx (100%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/stellar-consensus-protocol.mdx (100%) create mode 100644 docs/learn/fundamentals/stellar-data-structures/README.mdx rename docs/{fundamentals-and-concepts => learn/fundamentals}/stellar-data-structures/accounts.mdx (100%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/stellar-data-structures/assets.mdx (98%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/stellar-data-structures/contracts.mdx (100%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/stellar-data-structures/ledgers.mdx (100%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/stellar-data-structures/operations-and-transactions.mdx (100%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/stellar-ecosystem-proposals.mdx (100%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/stellar-stack.mdx (96%) rename docs/{fundamentals-and-concepts => learn/fundamentals}/transaction-lifecycle.mdx (100%) rename docs/{ => learn}/glossary.mdx (86%) create mode 100644 docs/learn/interactive/README.mdx create mode 100644 docs/learn/interactive/fca00c.mdx create mode 100644 docs/learn/interactive/quest.mdx create mode 100644 docs/learn/migrate/README.mdx create mode 100644 docs/learn/migrate/cosmos.mdx create mode 100644 docs/learn/migrate/evm/README.mdx create mode 100644 docs/learn/migrate/evm/introduction-to-solidity-and-rust.mdx create mode 100644 docs/learn/migrate/evm/smart-contract-deployment.mdx create mode 100644 docs/learn/migrate/evm/solidity-and-rust-advanced-concepts.mdx create mode 100644 docs/learn/migrate/evm/solidity-and-rust-basics.mdx create mode 100644 docs/learn/migrate/near.mdx create mode 100644 docs/learn/migrate/solana.mdx create mode 100644 docs/learn/smart-contract-internals/README.mdx create mode 100644 docs/learn/smart-contract-internals/authorization.mdx create mode 100644 docs/learn/smart-contract-internals/contract-interactions/README.mdx create mode 100644 docs/learn/smart-contract-internals/contract-interactions/cross-contract.mdx create mode 100644 docs/learn/smart-contract-internals/contract-interactions/overview.mdx create mode 100644 docs/learn/smart-contract-internals/contract-interactions/stellar-transaction.mdx create mode 100644 docs/learn/smart-contract-internals/contract-interactions/tests.mdx create mode 100644 docs/learn/smart-contract-internals/contract-interactions/transaction-simulation.mdx create mode 100644 docs/learn/smart-contract-internals/contract-lifecycle.mdx create mode 100644 docs/learn/smart-contract-internals/debugging.mdx create mode 100644 docs/learn/smart-contract-internals/environment-concepts.mdx create mode 100644 docs/learn/smart-contract-internals/errors.mdx create mode 100644 docs/learn/smart-contract-internals/events.mdx create mode 100644 docs/learn/smart-contract-internals/fees-and-metering.mdx create mode 100644 docs/learn/smart-contract-internals/high-level-overview.mdx create mode 100644 docs/learn/smart-contract-internals/persisting-data.mdx create mode 100644 docs/learn/smart-contract-internals/rust-dialect.mdx create mode 100644 docs/learn/smart-contract-internals/state-archival.mdx create mode 100644 docs/learn/smart-contract-internals/transaction-lifecycle.mdx create mode 100644 docs/learn/smart-contract-internals/types/README.mdx create mode 100644 docs/learn/smart-contract-internals/types/built-in-types.mdx create mode 100644 docs/learn/smart-contract-internals/types/custom-types.mdx create mode 100644 docs/learn/smart-contract-internals/types/fully-typed-contracts.mdx create mode 100644 static/assets/diagrams/environment-concepts.png create mode 100644 static/img/add_token.png create mode 100644 static/img/added_balance.png create mode 100644 static/img/approveTokenMint.png create mode 100644 static/img/approveTxn.png create mode 100644 static/img/aucb_balance.png create mode 100644 static/img/back100.png create mode 100644 static/img/backedResult.png create mode 100644 static/img/balance_rcvr.png create mode 100644 static/img/choose_token.png create mode 100644 static/img/confirm_mint.png create mode 100644 static/img/confirm_pmt.png create mode 100644 static/img/connect_freighter.png create mode 100644 static/img/connect_freighter_example.png create mode 100644 static/img/connect_wallet.png create mode 100644 static/img/counter.png create mode 100644 static/img/dashboard-bg.png create mode 100644 static/img/deploy-counter.png create mode 100644 static/img/deployed-contracts.png create mode 100644 static/img/deployedDApp.png create mode 100644 static/img/deposit50.png create mode 100644 static/img/docusaurus-social-card.jpg create mode 100644 static/img/docusaurus.png create mode 100644 static/img/dt_acct_bal.png create mode 100644 static/img/end.png create mode 100644 static/img/example.png create mode 100644 static/img/freighter_settings.png create mode 100644 static/img/futurenetDeployment.png create mode 100644 static/img/gear_icon.png create mode 100644 static/img/hex2str.png create mode 100644 static/img/increment.png create mode 100644 static/img/input_token_id.png create mode 100644 static/img/landing/arrow-black.svg create mode 100644 static/img/landing/arrow-white.svg create mode 100644 static/img/landing/designed-for-icon.svg create mode 100644 static/img/landing/discord-1.svg create mode 100644 static/img/landing/earn.svg create mode 100644 static/img/landing/group-245.svg create mode 100644 static/img/landing/icon.svg create mode 100644 static/img/landing/icon1.svg create mode 100644 static/img/landing/icon2.svg create mode 100644 static/img/landing/icon3.svg create mode 100644 static/img/landing/icon4.svg create mode 100644 static/img/landing/icon5.svg create mode 100644 static/img/landing/icon6.svg create mode 100644 static/img/landing/image-1.svg create mode 100644 static/img/landing/image-11.svg create mode 100644 static/img/landing/image-111@3x.png create mode 100644 static/img/landing/image-1@2x.png create mode 100644 static/img/landing/image-2.svg create mode 100644 static/img/landing/image-23.svg create mode 100644 static/img/landing/image-231@3x.png create mode 100644 static/img/landing/image-3.svg create mode 100644 static/img/landing/image-39@2x.png create mode 100644 static/img/landing/image-4.svg create mode 100644 static/img/landing/image-4@2x.png create mode 100644 static/img/landing/image-5.svg create mode 100644 static/img/landing/image-54.svg create mode 100644 static/img/landing/learn.svg create mode 100644 static/img/landing/scf.svg create mode 100644 static/img/landing/ships.svg create mode 100644 static/img/landing/soroban-white.svg create mode 100644 static/img/landing/twitter-1.svg create mode 100644 static/img/landing/vector-6.svg create mode 100644 static/img/landing/vector-7.svg create mode 100644 static/img/landing/vector-8.svg create mode 100644 static/img/landing/vector.svg create mode 100644 static/img/landing/vector1.svg create mode 100644 static/img/landing/vector2.svg create mode 100644 static/img/landing/vector3.svg create mode 100644 static/img/landing/vector4.svg create mode 100644 static/img/landing/youtube-1.svg create mode 100644 static/img/leaderboard-placeholder.png create mode 100644 static/img/manage_assets.png create mode 100644 static/img/meta.png create mode 100644 static/img/mintToken.png create mode 100644 static/img/mint_amt.png create mode 100644 static/img/mint_token.png create mode 100644 static/img/mint_token_landing.png create mode 100644 static/img/mint_tokens.png create mode 100644 static/img/mint_tx_result.png create mode 100644 static/img/new_token.png create mode 100644 static/img/next.png create mode 100644 static/img/oracle_approve.png create mode 100644 static/img/oracle_balance_contract.png create mode 100644 static/img/oracle_balance_user.png create mode 100644 static/img/oracle_calculate.png create mode 100644 static/img/oracle_connect.png create mode 100644 static/img/oracle_deployed.png create mode 100644 static/img/oracle_home.png create mode 100644 static/img/oracle_mint.png create mode 100644 static/img/oracle_mintBal.png create mode 100644 static/img/payment_settings.png create mode 100644 static/img/pmt_dest.png create mode 100644 static/img/preferences_menu.png create mode 100644 static/img/select_token.png create mode 100644 static/img/sign_tx.png create mode 100644 static/img/soroban-fav-icon.png create mode 100644 static/img/soroban-wordmark-temp-dark.svg create mode 100644 static/img/soroban-wordmark-temp.svg create mode 100644 static/img/soroban_fees.png create mode 100644 static/img/submit_mint_tx.png create mode 100644 static/img/submit_pmt.png create mode 100644 static/img/success.png create mode 100644 static/img/swap.png create mode 100644 static/img/swapComplete.png create mode 100644 static/img/timeline-drk.png create mode 100644 static/img/timeline-lgt.png create mode 100644 static/img/token_to_mint.png create mode 100644 static/img/tutorial/docsVersionDropdown.png create mode 100644 static/img/tutorial/localeDropdown.png create mode 100644 static/img/tx_settings.png create mode 100644 static/img/undraw_docusaurus_mountain.svg create mode 100644 static/img/undraw_docusaurus_react.svg create mode 100644 static/img/undraw_docusaurus_tree.svg create mode 100644 static/img/updatedBalance.png create mode 100644 static/img/updatedBalances.png create mode 100644 static/img/updatedBalances50.png create mode 100644 static/img/vault-project.png create mode 100644 static/img/wallet_connected.png create mode 100644 static/img/wdraw.png diff --git a/README.md b/README.md index 4d79beb8b..21ac4334f 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ Welcome to the official home repository for [Documentation][docs] and [API Reference][api] for the [Stellar Network][stellar]. -# Table of Contents +## Table of Contents - [Contributing](#contributing) - [Quick Start](#quick-start) @@ -14,7 +14,7 @@ Welcome to the official home repository for [Documentation][docs] and - [Alert](#alert) - [Code Example](#code-example) -# Contributing +## Contributing Contributions are more than welcome! Thank you! 🎉 @@ -29,8 +29,8 @@ helpful and meaningful way. Markdown is super easy to learn, and will come quite naturally after only a bit of practice. You can always help fix typos, spelling, and broken links, too. -# Quick Start -[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)][codespaces] +## Quick Start +[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)][codespaces] [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][gitpod] To begin development on the documentation, you will first need [yarn][yarn] @@ -55,7 +55,7 @@ npm run check:mdx # this will search for problems in the MDX files npm run format:mdx # this will fix any problems that were found ``` -# Repository Structure +## Repository Structure - `/docs/` Contains all the documentation content. If you're contributing to the actual documentation, rather than site functionality, this is likely where you @@ -88,9 +88,9 @@ npm run format:mdx # this will fix any problems that were found case-by-case basis, and it may be determined that a redirect isn't the right approach in some instances.) -# Using Markdown +## Using Markdown -## Markdown Basics +### Markdown Basics If you're unfamiliar with Markdown, there are **loads** of good tutorials and cheat sheets out there. Check out some of these resources to get a handle on the @@ -100,24 +100,24 @@ basics: - [Interactive markdown tutorial][tutorial] - [The markdown guide][guide] -## Custom Markdown +### Custom Markdown Our repository uses some custom React components that can be used inside the `MDX` documents. Use them as follows: **Make sure that there is an empty line within the wrapper.** For example, -``` +```text -Note: the testnet is reset every three months, so when building on it, make sure you have a plan to recreate necessary accounts and other data. For more info, check out the [best practices for using the testnet](../../fundamentals-and-concepts/testnet-and-pubnet). +Note: the testnet is reset every three months, so when building on it, make sure you have a plan to recreate necessary accounts and other data. For more info, check out the [best practices for using the testnet](../../learn/fundamentals/networks.mdx). ``` -### Alert +#### Alert ![Testnet reset alert](./readme-imgs/alert.png) @@ -134,7 +134,7 @@ Note: the testnet is reset every three months, so when building on it, make sure ``` -### Code Example +#### Code Example ![Create account code example](./readme-imgs/code-example.png) diff --git a/docs/building-apps/application-design-considerations.mdx b/docs/building-apps/application-design-considerations.mdx index 25fd61819..30542296b 100644 --- a/docs/building-apps/application-design-considerations.mdx +++ b/docs/building-apps/application-design-considerations.mdx @@ -11,7 +11,7 @@ There are four custody options to consider: - Non-custodial service - the user of the application stores their own secret key - Custodial service - the service provider (application) stores the users’ secret keys -- Mixture of both - with the use of [multisig](../encyclopedia/signatures-multisig.mdx), this option is useful for maintaining non-custodial status while still allowing for account recovery +- Mixture of both - with the use of [multisig](../learn/encyclopedia/signatures-multisig.mdx), this option is useful for maintaining non-custodial status while still allowing for account recovery - Third-party key management services - integrate a third-party custodial service into your application that can store your users’ secret keys ### Non-custodial service @@ -24,13 +24,13 @@ Typically, non-custodial applications create or import a pre-existing Stellar ac With a custodial service, the service provider (an application such as a centralized exchange) stores the users’ secret keys and delegates usage rights to the user. -Many custodial services choose to use a single pooled Stellar account (called shared, omnibus, or [pooled accounts](https://developers.stellar.org/docs/encyclopedia/pooled-accounts-muxed-accounts-memos)) to handle transactions on behalf of their users instead of creating a new Stellar account for each user. To distinguish between individual users in a pooled account, we encourage the implementation of [muxed accounts](https://developers.stellar.org/docs/encyclopedia/pooled-accounts-muxed-accounts-memos#muxed-accounts). +Many custodial services choose to use a single pooled Stellar account (called shared, omnibus, or [pooled accounts](../learn/encyclopedia/pooled-accounts-muxed-accounts-memos.mdx)) to handle transactions on behalf of their users instead of creating a new Stellar account for each user. To distinguish between individual users in a pooled account, we encourage the implementation of [muxed accounts](../learn/encyclopedia/pooled-accounts-muxed-accounts-memos.mdx#muxed-accounts). Learn how to set up an application as a custodial service in this [tutorial]. ### A mixture of non-custodial and custodial -Building an application with [multi-signature](../encyclopedia/signatures-multisig.mdx) capabilities allows you to have a non-custodial service with account recovery. If the user loses their secret key, they can still sign transactions with other authorized signatures, granted the signature threshold is high enough. +Building an application with [multi-signature](../learn/encyclopedia/signatures-multisig.mdx) capabilities allows you to have a non-custodial service with account recovery. If the user loses their secret key, they can still sign transactions with other authorized signatures, granted the signature threshold is high enough. ### Third-party key management services​ @@ -95,7 +95,7 @@ The flow with Claimable Balances looks like this: ### Option 2: the wallet creates and funds the Stellar account upon user sign-up​ -For this option, the wallet creates and funds the Stellar account upon every new user sign-up with the minimum requirement of 1XLM, plus the .5XLM reserve for establishing the first trustline, plus a bit more to cover transaction fees. For more information on minimum balances, check out the [Lumens section](https://developers.stellar.org/docs/fundamentals-and-concepts/lumens#minimum-balance). +For this option, the wallet creates and funds the Stellar account upon every new user sign-up with the minimum requirement of 1XLM, plus the .5XLM reserve for establishing the first trustline, plus a bit more to cover transaction fees. For more information on minimum balances, check out the [Lumens section](../learn/fundamentals/lumens.mdx#minimum-balance). The flow looks like this: diff --git a/docs/building-apps/example-application-tutorial/account-creation.mdx b/docs/building-apps/example-application-tutorial/account-creation.mdx index 6b4aab838..4a8b1aed1 100644 --- a/docs/building-apps/example-application-tutorial/account-creation.mdx +++ b/docs/building-apps/example-application-tutorial/account-creation.mdx @@ -188,8 +188,8 @@ Source: https://github.com/stellar/basic-payment-app/blob/main/src/lib/stellar/h Our `walletStore` is used in a ton of places in our application, especially in the confirmation modal when asking a user to input their pincode. Read on to see how we've done that. -[accounts section]: ../../fundamentals-and-concepts/stellar-data-structures/accounts +[accounts section]: ../../learn/fundamentals/stellar-data-structures/accounts.mdx [non-custodial application]: ../application-design-considerations#non-custodial-service [`js-stellar-wallets` sdk]: https://github.com/stellar/js-stellar-wallets -[sponsored reserves]: ../../encyclopedia/sponsored-reserves +[sponsored reserves]: ../../learn/encyclopedia/sponsored-reserves.mdx [contacts list]: ./contacts-list diff --git a/docs/building-apps/example-application-tutorial/anchor-integration/setup.mdx b/docs/building-apps/example-application-tutorial/anchor-integration/setup.mdx index f05ca1a92..7be37f673 100644 --- a/docs/building-apps/example-application-tutorial/anchor-integration/setup.mdx +++ b/docs/building-apps/example-application-tutorial/anchor-integration/setup.mdx @@ -11,7 +11,7 @@ In this example, we’ll use an anchor on Stellar’s Testnet to simulate a bank :::info -SEPs define community-decided standards for interoperability on Stellar. Read more in our [SEPs section](../../../fundamentals-and-concepts/stellar-ecosystem-proposals). +SEPs define community-decided standards for interoperability on Stellar. Read more in our [SEPs section](../../../learn/fundamentals/stellar-ecosystem-proposals.mdx). ::: diff --git a/docs/building-apps/example-application-tutorial/manage-trust.mdx b/docs/building-apps/example-application-tutorial/manage-trust.mdx index d2f957652..cbab3b36c 100644 --- a/docs/building-apps/example-application-tutorial/manage-trust.mdx +++ b/docs/building-apps/example-application-tutorial/manage-trust.mdx @@ -3,7 +3,7 @@ title: Manage Trust sidebar_position: 30 --- -For an account to hold and trade assets other than XLM, it must establish a [trustline](../../fundamentals-and-concepts/stellar-data-structures/accounts#trustlines) with the issuing account of that particular asset. Each trustline increases the account’s [base reserve](../../fundamentals-and-concepts/stellar-data-structures/accounts#base-reserves-and-subentries) by 0.5 XLM, which means the account will have to hold more XLM in its minimum balance. +For an account to hold and trade assets other than XLM, it must establish a [trustline](../../learn/fundamentals/stellar-data-structures/accounts.mdx#trustlines) with the issuing account of that particular asset. Each trustline increases the account’s [base reserve](../../learn/fundamentals/stellar-data-structures/accounts.mdx#base-reserves-and-subentries) by 0.5 XLM, which means the account will have to hold more XLM in its minimum balance. ## User experience @@ -11,7 +11,7 @@ First, we’ll have the user create a trustline for an asset by navigating to th :::info -An asset is displayed as an asset code and issuer address. Learn more in our [Assets section](https://developers.stellar.org/docs/fundamentals-and-concepts/stellar-data-structures/assets). +An asset is displayed as an asset code and issuer address. Learn more in our [Assets section](../../learn/fundamentals/stellar-data-structures/assets.mdx). ::: diff --git a/docs/building-apps/example-application-tutorial/path-payment.mdx b/docs/building-apps/example-application-tutorial/path-payment.mdx index 04dd79cff..0aba8834b 100644 --- a/docs/building-apps/example-application-tutorial/path-payment.mdx +++ b/docs/building-apps/example-application-tutorial/path-payment.mdx @@ -3,7 +3,7 @@ title: Path Payment sidebar_position: 50 --- -A path payment is where the asset sent can be different from the asset received. There are two possible path payment operations: 1) `path_payment_strict_send`, which allows the user to specify the amount of the asset to send, and 2) `path_payment_strict_receive`, which allows the user to specify the amount of the asset received. Read more in the [Path Payments Encyclopedia Entry](../../encyclopedia/path-payments). +A path payment is where the asset sent can be different from the asset received. There are two possible path payment operations: 1) `path_payment_strict_send`, which allows the user to specify the amount of the asset to send, and 2) `path_payment_strict_receive`, which allows the user to specify the amount of the asset received. Read more in the [Path Payments Encyclopedia Entry](../../learn/encyclopedia/path-payments.mdx). ## User experience @@ -17,7 +17,7 @@ The user will then preview the transaction, input their pincode, and select the ### The `/dashboard/send` page -Most of this page has been discussed in the [Payment section](./payment#the-dashboardsend-page). Below, we're highlighting the unique pieces that are added to BasicPay to allow for the path payment feature. +Most of this page has been discussed in the [Payment section](./payment.mdx#the-dashboardsend-page). Below, we're highlighting the unique pieces that are added to BasicPay to allow for the path payment feature. ```html title="/src/routes/dashboard/send/+page.svelte"