Merge branch 'main' into update-token-example-naming

Author: leighmcculloch

config/theme/navbar.ts

@@ -353,6 +353,11 @@ const data: NavbarItem = {
       label: 'Hubble',
       activeBasePath: 'docs/data/analytics/hubble'
     },
+    {
+      to: '/docs/data/analytics/public-dashboards',
+      label: 'Dashboards',
+      activeBasePath: 'docs/data/analytics/public-dashboards'
+    },
     {
       to: '/docs/data/analytics/analytics-providers',
       label: 'Providers',

docs/build/smart-contracts/example-contracts/tokens.mdx

@@ -35,7 +35,7 @@ This example shows how to build a token from scratch using only the `soroban-sdk
 
 [open-in-github-codespaces]: https://github.com/codespaces/new?repo=stellar/soroban-examples&editor=web
 [open-in-code-anywhere]: https://app.codeanywhere.com/#https://github.com/stellar/soroban-examples
-[token example]: https://github.com/stellar/soroban-examples/tree/v23.0.0/token
+[token example]: https://github.com/stellar/soroban-examples/tree/main/token
 [token interface]: ../../../tokens/token-interface.mdx
 
 :::info[Whisk Changes]
@@ -46,10 +46,10 @@ With the release of Whisk, Protocol 23, the [token interface] has seen some chan
 
 ## Run the Example
 
-First go through the [Setup] process to get your development environment configured, then clone the `v23.0.0` tag of `soroban-examples` repository:
+First go through the [Setup] process to get your development environment configured, then clone the `soroban-examples` repository:
 
 ```sh
-git clone -b v23.0.0 https://github.com/stellar/soroban-examples
+git clone https://github.com/stellar/soroban-examples
 ```
 
 Or, skip the development environment setup and open this example in [GitHub Codespaces][open-in-github-codespaces] or [Code Anywhere][open-in-code-anywhere].
@@ -338,8 +338,6 @@ impl TokenInterface for Token {
             .extend_ttl(INSTANCE_LIFETIME_THRESHOLD, INSTANCE_BUMP_AMOUNT);
 
         write_allowance(&e, from.clone(), spender.clone(), amount, live_until_ledger);
-        // The event's `expiration_ledger` data field name is unchanged to
-        // preserve on-chain event compatibility (soroban-token-sdk::events::Approve).
         events::Approve {
             from,
             spender,
@@ -507,7 +505,7 @@ pub enum DataKey {
 </TabItem>
 </Tabs>
 
-Ref: https://github.com/stellar/soroban-examples/tree/v23.0.0/token
+Ref: https://github.com/stellar/soroban-examples/tree/main/token
 
 ## How it Works
 
@@ -601,7 +599,7 @@ Of course, you will want your token to behave in an _intuitive_ and _transparent
 
 ## Tests
 
-Open the [`token/src/test.rs`](https://github.com/stellar/soroban-examples/tree/v23.0.0/token/src/test.rs) file to follow along.
+Open the [`token/src/test.rs`](https://github.com/stellar/soroban-examples/tree/main/token/src/test.rs) file to follow along.
 
 ```rust title="token/src/test.rs"
 #![cfg(test)]
@@ -879,7 +877,7 @@ fn test_zero_allowance() {
 }
 ```
 
-The token example implements eight different tests to cover a wide array of potential behaviors and problems. However, all of the tests start with a few common pieces. In any test, the first thing that is always required is an `Env`, which is the Soroban environment that the contract will run in.
+The token example implements six different tests to cover a wide array of potential behaviors and problems. However, all of the tests start with a few common pieces. In any test, the first thing that is always required is an `Env`, which is the Soroban environment that the contract will run in.
 
 ```rust
 let e = Env::default();

docs/data/README.mdx

@@ -7,6 +7,28 @@ There are several products to choose from when interacting with the Stellar Netw
 
 Use the summaries below to determine which types of data tools are right for your use case.
 
+## Compare Data Products
+
+SDF maintains four data products. Two are APIs and two are for bulk historical data, so start by picking the row that matches how you want to consume the data.
+
+|  | [RPC](./apis/rpc/README.mdx) | [Horizon](./apis/horizon/README.mdx) | [Hubble](./analytics/hubble/README.mdx) | [Galexie](./indexers/build-your-own/galexie/README.mdx) |
+| --- | --- | --- | --- | --- |
+| Type | API | API | Data warehouse | Ledger export tool |
+| Interface | JSON-RPC | REST | SQL (BigQuery) | XDR files in your data lake |
+| Real-time data | ✅ | ✅ | ❌ | ❌ |
+| Historical data | About 7 days | 1 year\* | Full | Full |
+| Smart contract data | ✅ | ❌ | ✅ | ✅ |
+| Transaction submission | ✅ | ✅ | ❌ | ❌ |
+| Transaction simulation | ✅ | ❌ | ❌ | ❌ |
+| Curated and parsed data | ❌ | ✅ | ✅ | ❌ |
+| Hosted by SDF | Testnet and futurenet | Mainnet, testnet, and futurenet\* | Public BigQuery dataset | None\*\* |
+
+\*_The SDF-hosted Horizon keeps one year of history and is nearing end-of-life in favor of RPC. A self-hosted Horizon can serve full history, but Hubble or Galexie are the recommended tools for that._
+
+\*\*_SDF does not host a Galexie data lake, but [several providers](./indexers/build-your-own/galexie/providers.mdx) make public ones available._
+
+The [Ingest SDK](./indexers/build-your-own/ingest-sdk/README.mdx) and [Processors](./indexers/build-your-own/processors/README.mdx) are libraries for building on top of these products rather than data products themselves. Third-party APIs, indexers, and analytics platforms are listed on their own pages in each section below.
+
 ## [Analytics](./analytics/README.mdx)
 
 Explore and analyze Stellar network data to uncover trends, track activity, and generate insights for decision-making and reporting.

docs/data/analytics/README.mdx

@@ -11,6 +11,10 @@ Hubble is an open-source, read-only BigQuery data warehouse maintained by SDF th
 
 Within Hubble, the stellar-etl product powers the extraction and transformation of Stellar network data into BigQuery. This open-source pipeline allows developers to extend or customize data ingestion workflows based on their analytical needs. Stellar-etl provides flexibility in how data is processed, enabling users to extract specific ledger entries, operations, or event logs based on their requirements.
 
+## [Public Dashboards](./public-dashboards.mdx)
+
+Public Dashboards is a directory of free, browser-based dashboards that track Stellar network activity, real-world assets, stablecoins, and DeFi. Most are maintained by ecosystem analytics platforms rather than SDF. Start here if you want to look at Stellar metrics without writing a query.
+
 ## [Data Analytics Providers](./analytics-providers/analytics-providers.mdx)
 
 Data Analytics Providers provide a complete historical record of Pubnet Stellar network data for analysis and insights. These platforms enable users to explore network trends but are not designed for real-time data access or transaction execution. The key difference is that these ecosystem platforms operate independently of SDF and provide metrics and dashboards about the Stellar network.

docs/data/analytics/analytics-providers/analytics-providers.mdx

@@ -5,6 +5,8 @@ title: Data Analytics Providers
 
 The following is a list of data analytics platforms that make a complete historical record of Pubnet Stellar network data available.
 
+For curated dashboards you can browse without writing queries, see the [Public Dashboards](../public-dashboards.mdx) page.
+
 | Platform | Description | Home page and Signup | Pricing | Data Access | Dashboard access |
 | --- | --- | --- | --- | --- | --- |
 | Hubble | SDF provides a publicly available raw dataset with a complete historical record of Stellar network data, updated every 15 minutes. | [Hubble](https://console.cloud.google.com/bigquery?project=crypto-stellar&ws=!1m4!1m3!3m2!1scrypto-stellar!2scrypto_stellar) <br></br> [Signup](https://cloud.google.com/?hl=en) | End users incur the cost to execute queries. Visit the [BigQuery Pricing](https://cloud.google.com/bigquery/pricing#analysis_pricing_models) page to learn more. | Please see the [Analyst Guide](./hubble/analyst-guide) for more information. | N/A |

docs/data/analytics/public-dashboards.mdx

@@ -0,0 +1,41 @@
+---
+title: Public Dashboards
+description: A directory of free, public dashboards that track Stellar network activity, real-world assets, stablecoins, and DeFi.
+sidebar_position: 500
+---
+
+This page lists public dashboards that show what is happening on the Stellar network. Every dashboard here can be opened in a browser without an account, though some platforms offer extra views to signed-in users. Most are built and maintained by third parties, not SDF, so refresh cadence and methodology vary by platform.
+
+If you want to run your own queries against the underlying data instead, see [Hubble](./hubble/README.mdx) or the [Data Analytics Providers](./analytics-providers/analytics-providers.mdx) page. For looking up a specific transaction, account, or contract, use a [block explorer](../../tools/developer-tools/block-explorers.mdx).
+
+## Network Overview
+
+Chain-level activity: transactions, operations, accounts, fees, and comparisons with other networks.
+
+| Dashboard | Published by | What it shows |
+| --- | --- | --- |
+| [Stellar Network](https://dashboard.stellar.org) | SDF | Real-time network liveness for developers and validators: ledger close times, transaction throughput, and testnet status. The first place to check during a protocol upgrade. |
+| [Stellar on Dune](https://dune.com/blockchains/stellar) | Dune | Entry point to Dune's Stellar datasets and community dashboards. Best when you want to fork a query or build your own chart. |
+| [Stellar Ecosystem Portal](https://stellar.messari.io) | Messari | Metrics alongside research reports, news, and ecosystem project profiles. Aimed at investors and analysts who want context, not just charts. |
+| [Stellar on Artemis](https://app.artemis.xyz/project/stellar) | Artemis | Fees, revenue, active addresses, and TVL in a standard format for comparing Stellar against other chains. |
+| [Stellar on Token Terminal](https://tokenterminal.com/explorer/projects/stellar) | Token Terminal | Financial statement style metrics for Stellar. Useful for analysts benchmarking Stellar with the same definitions Token Terminal applies to every chain. |
+| [Stellar Cross-Chain Explorer](https://stellar.range.org) | Range | Cross-chain transfers into and out of Stellar at the transaction level, with bridge hops and counterparties. For compliance and bridge users. |
+| [Stellar on DappRadar](https://dappradar.com/chain/stellar) | DappRadar | Dapp discovery and usage rankings. Best for finding which Soroban apps have users. |
+
+## Real-World Assets and Stablecoins
+
+Tokenized assets, stablecoin supply, and related transaction volume on Stellar.
+
+| Dashboard | Published by | What it shows |
+| --- | --- | --- |
+| [RWAs on Stellar](https://dune.com/stellar/rwas) | SDF | SDF's own view of tokenized assets and stablecoins on Stellar. Lists assets as they launch on Stellar, including ones not yet tracked by rwa.xyz. |
+| [Stellar on rwa.xyz](https://app.rwa.xyz/networks/stellar) | rwa.xyz | Tokenized asset value on Stellar by asset class and issuer, using the same vetted methodology rwa.xyz applies to every network. Useful for comparing Stellar's RWA footprint with other networks on a like-for-like basis. |
+
+## DeFi and Lending
+
+Total value locked, protocol activity, and lending metrics for Soroban-based protocols.
+
+| Dashboard | Published by | What it shows |
+| --- | --- | --- |
+| [Stellar on DefiLlama](https://defillama.com/chain/stellar) | DefiLlama | TVL by protocol on Stellar, with history. The TVL figure most commonly cited in third-party research. |
+| [Blend Protocol Analytics](https://dune.com/stellar/blend-protocol-analytics) | SDF | SDF-maintained view of Blend lending pools: TVL, supply and borrow, utilization, and volume. Currently the one dashboard here focused on a single Soroban protocol. |

docs/data/apis/README.mdx

@@ -13,7 +13,7 @@ Learn about the services that provide access to real-time Stellar network data
 | Transaction Simulation  | ✅  | ❌      |
 | Curated and Parsed Data | ❌  | ✅      |
 
-\*_Please note that Horizon can provide full historical data but is not the recommended tool for full historical data access. Please use [Hubble](../analytics/hubble/README.mdx) or [Galexie](../indexers/build-your-own/galexie/README.mdx) instead._
+\*_Horizon can provide full historical data if you run your own instance, but it is not the recommended tool for that. Use [Hubble](../analytics/hubble/README.mdx) or [Galexie](../indexers/build-your-own/galexie/README.mdx) instead. For a side-by-side comparison of all four SDF data products, see [Compare Data Products](../README.mdx#compare-data-products)._
 
 ## [RPC](./rpc/README.mdx)
 

docs/tokens/usdt0-layerzero.mdx

@@ -11,6 +11,8 @@ description: "Use USDT0, Tether's USDT delivered over LayerZero's OFT standard,
 
 On Stellar, USDT0 is a **classic asset with a SAC**. Classic flows use a trustline plus a payment. Soroban contracts call the SAC. See the [tokenization model comparison](./anatomy-of-an-asset.mdx#tokenization-model-comparison) for what that implies.
 
+For an overview of what USDT0 unlocks on Stellar, the partners supporting it today, and a deployment checklist, see the [USDT0 on Stellar launch guide](pathname:///launch/usdt0).
+
 :::info[Full documentation]
 
 For the architecture, the OFT interface, supported chains, and the transfer UI:

docusaurus.config.ts

@@ -154,6 +154,25 @@ const config: Config = {
         googleTagManager: {
           containerId: "GTM-M2JLH37",
         },
+        sitemap: {
+          // Files under static/ bypass the Docusaurus build, so pages served
+          // from there never appear in the generated sitemap. /launch/usdt0 is
+          // a permanent page and was invisible to crawlers without this.
+          createSitemapItems: async ({
+            defaultCreateSitemapItems,
+            ...rest
+          }) => {
+            const items = await defaultCreateSitemapItems(rest);
+            return [
+              ...items,
+              {
+                url: `${rest.siteConfig.url}/launch/usdt0`,
+                changefreq: "weekly",
+                priority: 0.5
+              },
+            ];
+          },
+        },
       } satisfies Preset.Options,
     ],
   ],

routes.txt

@@ -280,6 +280,7 @@
 /docs/data/analytics/hubble/developer-guide/visualization
 /docs/data/analytics/hubble/developer-guide/visualization/getting-started
 /docs/data/analytics/hubble/developer-guide/visualization/overview
+/docs/data/analytics/public-dashboards
 /docs/data/apis
 /docs/data/apis/horizon
 /docs/data/apis/horizon/admin-guide