diff --git a/docs/data/README.mdx b/docs/data/README.mdx index 62cf7c9f99..9bb4613d48 100644 --- a/docs/data/README.mdx +++ b/docs/data/README.mdx @@ -2,10 +2,31 @@ title: Data Overview --- -The RPC, data indexers, Hubble, and Horizon are platforms or tools that facilitate communication between users and applications and the Stellar network. With these various platforms, users can query network data, submit transactions, and interact with smart contracts without needing to understand the low-level details of Stellar Core. +import platform_decision_tree from "/img/platform_decision_tree.png"; + +There are several products to choose from when interacting with the Stellar Network, and each one is optimized for different access patterns, so it's important to choose the right tool based on your specific use-case. These tools allow users to query network data, submit transactions, and interact with smart contracts without needing to understand the low-level details of Stellar Core. This section will walk you through the differences between the various platforms and tools, what platform or tool is best for what use case, and then link to their various documentation locations. +- **[RPC](#rpc)** - live network gateway +- **[Horizon](#horizon)** - API for network state data +- **Galexie** - exports raw ledger metadata files +- **[Hubble](#hubble)** - analytics database for network data + +| Features | RPC | Horizon | Galexie | Hubble | +| ----------------------- | --- | ------- | ------- | ------ | +| Real-time Data | ✅ | ✅ | ✅ | ❌ | +| Historical Data | ❌ | ❌\* | ✅ | ✅ | +| Smart Contracts | ✅ | ❌ | ✅ | ✅ | +| API | ✅ | ✅ | ❌ | ❌ | +| Transaction Submission | ✅ | ✅ | ❌ | ❌ | +| Curated and Parsed Data | ❌ | ✅ | ❌ | ✅ | +| Ad Hoc Data Analysis | ❌ | ❌ | ❌ | ✅ | + +\*_Please note that Horizon can provide full historical data but is not the recommended tool for full historical data access._ + + + ## [RPC](./rpc/README.mdx) The RPC primarily provides information that the Stellar network currently has in view, i.e., **the current state**, which includes the current balances of all accounts, the current state of smart contracts, and any other relevant information that constitutes the present condition of the blockchain. It has the ability to send a transaction to the network and query the network for the status of previous transactions (subject to the retention window of seven days, transactions older than that will return a `NOT_FOUND` response). The RPC is meant to be simple, minimal, and scalable. diff --git a/static/img/platform_decision_tree.png b/static/img/platform_decision_tree.png new file mode 100644 index 0000000000..fa4d7527d7 Binary files /dev/null and b/static/img/platform_decision_tree.png differ