Merge remote-tracking branch 'origin/main' into karthik/ttp-docs

Author: karthikiyer56

README.md

@@ -89,6 +89,12 @@ 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
 ```
 
+After that you need to build the `routes.txt` file, to do that run the next command
+
+```bash
+yarn build
+```
+
 ## Repository Structure
 
 - `/docs/` Contains all the documentation content. If you're contributing to the

docs/networks/software-versions.mdx

@@ -30,6 +30,10 @@ Release candidates are software releases that are also released to the [Testnet]
 | Stellar JS Stellar Base | `v14.0.0-rc.2` | `NPM: 14.0.0-rc.2` |
 | Stellar JS Stellar SDK | `v14.0.0-rc.3` | `NPM: 14.0.0-rc.3` |
 | Freighter | `n/a` | `n/a` |
+| Laboratory | `n/a` | `n/a` |
+| Futurenet Network Passphrase | `n/a` | `Test SDF Future Network ; October 2022` |
+| Testnet Network Passphrase | `n/a` | `Test SDF Network ; September 2015` |
+| Mainnet Network Passphrase | `n/a` | `Public Global Stellar Network ; September 2015` |
 
 ### Release notes
 

docs/tools/developer-tools/scaffold-stellar.mdx

@@ -0,0 +1,111 @@
+---
+title: Scaffold Stellar
+description: Convention-over-configuration toolkit for Stellar smart contract development
+sidebar_label: Scaffold Stellar
+sidebar_position: 110
+---
+
+**Scaffold Stellar** is a developer toolkit for building decentralized applications (dApps) and smart contracts on the Stellar blockchain. It helps you go from idea to working full-stack dApp faster — by providing CLI tools, reusable contract templates, a smart contract registry, and a modern frontend.
+
+## Prerequisites
+
+Before you begin, make sure you have the following installed:
+
+| Tool | Description | Install Link |
+| --- | --- | --- |
+| [Rust & Cargo](https://www.rust-lang.org/tools/install) | For writing and compiling smart contracts | `curl https://sh.rustup.rs -sSf \| sh` |
+| [Node.js & npm](https://nodejs.org/) | For frontend development | Download from official site |
+| [Stellar CLI](https://github.com/stellar/stellar-cli) | For building, deploying, and interacting with smart contracts | [`Link for the repo`](https://github.com/stellar/stellar-cli) |
+
+## Getting Started
+
+### Installation
+
+Install the required CLI tools:
+
+```bash
+# Install stellar-scaffold CLI
+cargo install stellar-scaffold-cli
+
+# Install registry CLI (to easily deploy your contract to the registry)
+cargo install stellar-registry-cli
+```
+
+### Creating a New Project
+
+1. Initialize a new project:
+
+```bash
+stellar scaffold init my-project
+cd my-project
+```
+
+You will have a few sample contracts already in the project, or you can start from the [OpenZeppelin Wizard](./openzepplin-contracts) to customize your contract and start a Scaffold Stellar project from there.
+
+2. Set up your development environment:
+
+```bash
+# Copy and configure environment variables
+cp .env.example .env
+
+# Install frontend dependencies
+npm install
+```
+
+3. Start development environment:
+
+```bash
+npm run dev
+```
+
+You'll have a running dApp, with a couple of contracts to start with, ready to start building!
+
+Explore the `environments.toml` file to customize your development environment(s).
+
+## Project Structure
+
+When you run `stellar scaffold init`, it creates a full-stack project structure with example contracts and a modern frontend:
+
+```
+my-project/
+├── contracts/            # Rust smart contracts (compiled to WASM)
+├── packages/            # Auto-generated TypeScript contract clients
+├── src/                # React frontend code
+│   ├── components/     # Reusable UI components
+│   ├── contracts/      # Contract interaction logic
+│   ├── App.tsx        # Main app component
+│   └── main.tsx       # Entry point
+├── environments.toml   # Configuration per environment (dev/test/prod)
+├── .env               # Local environment variables
+├── package.json       # Frontend packages
+└── target/           # Build outputs
+```
+
+This template provides a ready-to-use frontend application with example smart contracts and their TypeScript clients. The frontend is set up with `Vite`, `React`, and includes basic components for interacting with the contracts.
+
+## Features
+
+- **CLI Plugins for Stellar**
+
+  - `stellar scaffold init`: Initialize new Stellar smart contract projects
+  - `stellar scaffold upgrade`: Transform existing Stellar contract workspaces into Scaffold projects
+  - `stellar scaffold build`: Build contracts and generate TypeScript clients
+  - `stellar scaffold watch`: Development mode with hot reloading
+  - `stellar registry`: Publish, deploy, and manage smart contracts
+
+- **Environment Management**
+
+  - Environment-specific builds (development, testing, staging, production)
+  - Seamless integration with both local and deployed contracts
+  - Network configuration via `environments.toml`
+  - Support for multiple deployment environments
+
+- **Smart Contract Registry**
+  - On-chain publishing platform for Wasm binaries
+  - Version management and contract naming
+  - Contract verification and dependency management
+  - Secure deployment workflow for testnet and mainnet
+
+### More Resources
+
+For more information, check out the [project on GitHub](https://github.com/AhaLabs/scaffold-stellar)!

docs/tools/lab/account.mdx

@@ -10,7 +10,7 @@ sidebar_position: 10
 
 ![Lab: Create Account](/assets/lab/lab-account-create.png)
 
-From the Lab’s top navigation, click on the "Account" link. You will land on the "Create Account Keypair" page, where you can generate a [keypair](../../learn/glossary.mdx#keypair) by following these steps:
+From the Lab’s main navigation, click on the "Account" link to expand sub-navigation. Click the "Create Account Keypair" page. Here you can generate a [keypair](../../learn/glossary.mdx#keypair) by following these steps:
 
 1. Make sure you are on the Stellar network for which you want to generate the keypair. You can see the current network in the upper right corner of the page. Click on dropdown to change the network (don’t forget to provide any necessary information). We will use Testnet network for this example.
 2. Click the "Generate keypair" button to create public and secret keys for an account. Save them someplace safe, even if they are used only for testing.
@@ -29,13 +29,13 @@ The Friendbot can be used for new account or accounts with balance under a start
 
 :::
 
-4. Optionally, to save the generated keypair, click the "Save Keypair" button. Enter the name in the pop-up and click the "Save" button to save the keypair in the browser's local storage. Click the "Saved Keypairs" link on the left-side menu to view saved keypairs. The save feature is available only on Testnet and Futurenet networks.
+4. Optionally, to save the generated keypair, click the "Save Keypair" button. Enter the name in the pop-up and click the "Save" button to save the keypair in the browser's local storage. Click the "Saved" link on the main menu to expand the submenu, then click on the "Keypairs" link to view saved keypairs. The save feature is available only on Testnet and Futurenet networks.
 
 ## [Fund Account](https://lab.stellar.org/account/fund)
 
 ![Lab: Fund Account](/assets/lab/lab-account-fund.png)
 
-If you already have a keypair you want to fund, go to the "Fund Account" page.
+If you already have a keypair you want to fund, go to the "Fund Account" page (under the "Account" item in the main menu).
 
 1. If you have generated a keypair on the "Create Account Keypair" page, you can use its public key by clicking the "Fill in the generated key" button. The button will be disabled if there is no keypair.
 2. You can always manually input a public key.

docs/tools/lab/api-explorer/horizon-endpoint.mdx

@@ -10,7 +10,7 @@ On August 1, 2024, the publicly accessible SDF-hosted Horizon had its historical
 
 Data on the Stellar ledger is organized into [resources](../../../data/apis/horizon/api-reference/resources): **Accounts, Assets, Claimable Balances, Effects, Ledgers, Liquidity Pools, Offers, Operations, Trades**, and **Transactions**. Each resource has multiple endpoints. Endpoints that aggregate ledger data (also known as [aggregations](../../../data/apis/horizon/api-reference/aggregations)) include resources like **Order Books, Paths, Trade Aggregations**, and **Fee Stats**.
 
-Stellar Lab's Horizon Endpoints lists each resource type in the side menu, allowing developers to interact with its respective endpoints.
+Stellar Lab's Horizon Endpoints lists each resource type in the menu, allowing developers to interact with its respective endpoints.
 
 ![Lab: Horizon Page](/assets/lab/horizon-endpoints.png)
 
@@ -353,7 +353,7 @@ Clicking the icon opens a modal. We recommend providing an identifiable name to
 
 ![Lab: Horizon - Modal](/assets/lab/horizon-save-modal.png)
 
-Saved endpoints are located at the top left of the side menu. They include requests for both the **RPC Methods** and **Horizon Endpoints**.
+Saved endpoints are located in the main menu under the "Saved" menu, "Requests" submenu. They include requests for both the **RPC Methods** and **Horizon Endpoints**.
 
 ![Lab: Horizon - Saved Requests Page](/assets/lab/horizon-saved-requests.png)
 

docs/tools/lab/api-explorer/rpc-methods.mdx

@@ -1,10 +1,10 @@
 # RPC Methods
 
-RPC methods are a set of functions that allow developers to interact directly with the Stellar network. You can learn more about all the RPC methods [here](../../../data/apis/rpc/api-reference/methods). The Lab provides an easy way to use these methods from the UI. To access the "RPC Methods" section, click on the "API Explorer" link in the main navigation, which will open a new page listing all RPC methods by name.
+RPC methods are a set of functions that allow developers to interact directly with the Stellar network. You can learn more about all the RPC methods [here](../../../data/apis/rpc/api-reference/methods). The Lab provides an easy way to use these methods from the UI. To access the "RPC Methods" items, click on the "API Explorer" link in the main navigation, then click the "RPC Methods" submenu link, which will open another submenu listing all RPC methods by name. Click on the method name to open that page.
 
 :::warning
 
-RPC URL is required to submit these methods. You can update or set the RPC URL in the network selector in the main navigation bar.
+RPC URL is required to submit these methods. You can update or set the RPC URL in the network selector in the top right corner.
 
 :::
 
@@ -30,7 +30,7 @@ The Stellar Lab allows you to share RPC methods with filled data. Simply click o
 
 ## Saved Requests
 
-You can save methods in the browser’s local storage by clicking the Save button (next to the Share button). Once you click that button, a modal will pop up, where you will need to enter the name and click save. To view your saved RPC methods in the Lab, click the "Saved Requests" link in the menu, then click the "RPC Methods" tab in the top right.
+You can save methods in the browser’s local storage by clicking the Save button (next to the Share button). Once you click that button, a modal will pop up, where you will need to enter the name and click save. To view your saved RPC methods in the Lab, click the "Saved" link in the main menu, then click the "Requests" submenu link. Then click the "RPC Methods" tab in the top right.
 
 :::info
 

docs/tools/lab/smart-contracts/README.mdx

@@ -0,0 +1,18 @@
+---
+title: Smart Contracts
+sidebar_position: 20
+---
+
+import DocCardList from "@theme/DocCardList";
+
+# Smart Contracts
+
+In this section, you can explore Stellar smart contracts by ID and view a list of smart contracts on the selected Stellar network.
+
+:::tip
+
+If you don't know any Stellar smart contract ID, view the list and click on any of the items. This will direct you to the "Contract Explorer" page, where the selected ID is pre-filled. Load the contract and check it out!
+
+:::
+
+<DocCardList />

docs/tools/lab/smart-contracts/contract-explorer.mdx

@@ -0,0 +1,71 @@
+# Contract Explorer
+
+On the "Contract Explorer" page, you can take a deep dive into Stellar smart contracts. Here, you can view high-level contract information, invoke contract methods directly from the browser, explore the contract specification, source code, contract storage, build information, and version history.
+
+:::warning
+
+RPC URL is required to view the contract information. You can update or set the RPC URL in the network selector in the top right corner.
+
+:::
+
+![Lab: Contract Explorer](/assets/lab/lab-contract-explorer.png)
+
+Let's load `CAJJZSGMMM3PD7N33TAPHGBUGTB43OC73HVIK2L2G6BNGGGYOSSYBXBD` contract ID on the Mainnet network, and see what we can learn about it.
+
+## Contract Info
+
+In the "Contract Info" section, we can view the date when the contract was created and the creator's Stellar address. It also displays the Wasm hash and GitHub repository, along with a link to the source code of this contract. Also, you can see how many contract storage entries this contract has.
+
+![Lab: Contract Explorer: Contract Info](/assets/lab/lab-contract-explorer-info.png)
+
+## Invoke Contract
+
+This feature allows you to directly interact with and execute methods of a Stellar smart contract from the Lab UI in your browser.
+
+:::warning
+
+A connected wallet is required to invoke the contract.
+
+:::
+
+![Lab: Contract Explorer: Invoke Contract](/assets/lab/lab-contract-explorer-invoke.png)
+
+## Contract Spec
+
+In this section, you can view [Contract Meta](../../../learn/fundamentals/contract-development/overview#contract-meta), [Contract Env Meta](../../../learn/fundamentals/contract-development/overview#environment-meta), and [Contract Spec](../../../learn/fundamentals/contract-development/overview#contract-spec) from the Wasm file. You can view each section in JSON or XDR formats, by selecting the type from the dropdown in the top-right corner of the editor view. You can also download each section individually in the chosen format (the download button is located next to the type dropdown), or download the entire Wasm file by clicking the "Download Wasm" button at the bottom of the section.
+
+![Lab: Contract Explorer: Contract Spec](/assets/lab/lab-contract-explorer-spec.png)
+
+## Source Code
+
+In the code editor, you can view the `README.md` file of the smart contract repository. You can further explore the code by opening it in a Dev Container, Codeanywhere, or by using the GitHub link (see the dropdown in the top right corner of the editor view).
+
+![Lab: Contract Explorer: Source Code](/assets/lab/lab-contract-explorer-source.png)
+
+## Contract Storage
+
+Here you can view stored data entries for this smart contract in human-readable format. You can filter this data by Key and Value, as well as sort it by Durability, TTL, or Updated columns. You can also export this data in XDR or JSON formats.
+
+![Lab: Contract Explorer: Contract Storage](/assets/lab/lab-contract-explorer-storage.png)
+
+## Build Info
+
+If the smart contract has build verification configured (following the [Contract Source Validation SEP](https://github.com/orgs/stellar/discussions/1573)), this section displays information from the GitHub attestation.
+
+:::info
+
+"Build Verified" only means that the GitHub Action run has attested to have built the Wasm, but does not verify the source code. Always make sure you fully understand what the smart contract does before using it.
+
+:::
+
+![Lab: Contract Explorer: Build Info](/assets/lab/lab-contract-explorer-build.png)
+
+## Version History
+
+In this section, you can find the Wasm history of changes.
+
+![Lab: Contract Explorer: Version History](/assets/lab/lab-contract-explorer-version.png)
+
+## Bindings
+
+Bindings are a feature of the [Stellar CLI](../../cli) that generate fully typed client libraries for your smart contracts, tailored to your chosen programming language, including TypeScript, JSON, Rust, Python, and Java. This makes it easy to integrate Stellar contracts into your application as if they were native modules. Each binding provides type-safe functions corresponding to your contract’s methods. To learn more about generating bindings, please see the [Stellar CLI’s bindings command](../../cli/stellar-cli#stellar-contract-bindings).

docs/tools/lab/smart-contracts/smart-contract-list.mdx

@@ -0,0 +1,5 @@
+# Smart Contract List
+
+This page shows a list of Stellar smart contracts on the selected network. The table displays the smart contract ID or address, along with its creation date and time. Clicking on the contract address will direct you to the "Contract Explorer" page, where the selected address is pre-filled.
+
+![Lab: Smart Contract List](/assets/lab/lab-smart-contract-list.png)

docs/tools/lab/transactions.mdx

@@ -4,7 +4,7 @@
 
 ![Lab: Build Transaction](/assets/lab/lab-transactions-build.png)
 
-You can access the "Build Transaction" page by clicking the "Transactions" link in the Lab's top navigation. The transaction builder UI has helpful messages, links, and input validation to make learning how to build transactions on the Stellar network easier. There are three main sections: params, operations, and transaction validation (error or success).
+You can access the "Build Transaction" page by clicking the "Transactions" link in the Lab's main navigation. The transaction builder UI has helpful messages, links, and input validation to make learning how to build transactions on the Stellar network easier. There are three main sections: params, operations, and transaction validation (error or success).
 
 ### Params