From 549baa3fd8f199156eb55831565537c730ea2e6d Mon Sep 17 00:00:00 2001 From: pharr117 Date: Fri, 13 Sep 2024 22:06:10 -0400 Subject: [PATCH] Move reference docs for better organization --- docs/reference/README.md | 30 +++++++++++++------ .../application_workflow.md | 0 .../index_command.md | 0 .../cosmos_indexer_modules.md | 3 ++ .../custom_message_type_registration.md | 3 ++ .../probe_codec_walkthrough.md | 3 ++ .../custom_indexer_examples.md | 0 .../custom_indexer_walkthrough.md | 0 .../indexer_sdk_and_custom_parsers.md | 0 .../indexer_type.md | 0 .../block_events_indexed_data.md | 0 .../block_indexed_data.md | 0 .../transactions_indexed_data.md | 0 13 files changed, 30 insertions(+), 9 deletions(-) rename docs/reference/{ => application_workflow}/application_workflow.md (100%) rename docs/reference/{ => application_workflow}/index_command.md (100%) create mode 100644 docs/reference/custom_cosmos_module_extensions/cosmos_indexer_modules.md create mode 100644 docs/reference/custom_cosmos_module_extensions/custom_message_type_registration.md create mode 100644 docs/reference/custom_cosmos_module_extensions/probe_codec_walkthrough.md rename docs/reference/{ => custom_data_indexing}/custom_indexer_examples.md (100%) rename docs/reference/{ => custom_data_indexing}/custom_indexer_walkthrough.md (100%) rename docs/reference/{ => custom_data_indexing}/indexer_sdk_and_custom_parsers.md (100%) rename docs/reference/{ => custom_data_indexing}/indexer_type.md (100%) rename docs/reference/{ => default_data_indexing}/block_events_indexed_data.md (100%) rename docs/reference/{ => default_data_indexing}/block_indexed_data.md (100%) rename docs/reference/{ => default_data_indexing}/transactions_indexed_data.md (100%) diff --git a/docs/reference/README.md b/docs/reference/README.md index 6f3ed6d7..9a97ad61 100644 --- a/docs/reference/README.md +++ b/docs/reference/README.md @@ -4,22 +4,34 @@ This sections provides reference documentation on how the codebase works. It als ## Application Workflow -* [`index` Command](./index_command.md) - The main command that starts the application built using the [cobra](https://cobra.dev/) framework -* [Application Workflow](./application_workflow.md) - The multi-processing workflow used by the application +* [`index` Command](./application_workflow/index_command.md) - The main command that starts the application built using the [cobra](https://cobra.dev/) framework +* [Application Workflow](./application_workflow/application_workflow.md) - The multi-processing workflow used by the application ## Default Data Indexing The application indexes data into a default shape. The following sections provide details on the datasets that are pulled from the blockchain and the default data indexing: -* [Block Indexed Data](./block_indexed_data.md) - The shape of the data for blocks and how the application indexes it -* [Block Events Indexed Data](./block_events_indexed_data.md) - The shape of the data for block events and how the application indexes it -* [Transactions Indexed Data](./transactions_indexed_data.md) - The shape of the data for transactions and how the application indexes it +* [Block Indexed Data](./default_data_indexing/block_indexed_data.md) - The shape of the data for blocks and how the application indexes it +* [Block Events Indexed Data](./default_data_indexing/block_events_indexed_data.md) - The shape of the data for block events and how the application indexes it +* [Transactions Indexed Data](./default_data_indexing/transactions_indexed_data.md) - The shape of the data for transactions and how the application indexes it ## Custom Data Indexing The application allows for custom data indexing by providing developer access to the underlying types used by the indexer. The following sections provide details on how to use the `cosmos-indexer` codebase as an SDK to build a custom indexer: -* [Indexer Type](./indexer_type.md) - The main controller for indexer behavior and how to modify it -* [Indexer SDK and Custom Parsers](./indexer_sdk_and_custom_parsers.md) - Reference documentation on custom parsers and how to register them -* [Walkthrough](./custom_indexer_walkthrough.md) - A walkthrough of a real world example of creating a custom indexer -* [Examples](./custom_indexer_examples.md) - An explanation of the examples provided in the codebase [examples](https://github.com/DefiantLabs/cosmos-indexer/tree/main/examples) directory +* [Indexer Type](./custom_data_indexing/indexer_type.md) - The main controller for indexer behavior and how to modify it +* [Indexer SDK and Custom Parsers](./custom_data_indexing/indexer_sdk_and_custom_parsers.md) - Reference documentation on custom parsers and how to register them +* [Walkthrough](./custom_data_indexing/custom_indexer_walkthrough.md) - A walkthrough of a real world example of creating a custom indexer +* [Examples](./custom_data_indexing/custom_indexer_examples.md) - An explanation of the examples provided in the codebase [examples](https://github.com/DefiantLabs/cosmos-indexer/tree/main/examples) directory + +## Custom Cosmos Module Extensions + +The application allows for extending the supported transaction message types by providing developer access to the underlying types used by the indexer. This allows developers to bring in custom cosmos modules into the indexer, either through the usage of custom AppModuleBasic implementations with chain-specific message types or through the usage of registering custom message types in the indexer. + +Depending on certain factors, such as the version of the Cosmos SDK the custom chain module is based on, developers may need to implement custom message types to be able to decode the transaction messages found on the chain. + +The following sections provide details on how to use the `cosmos-indexer` codebase as an SDK to extend the supported transaction message types: + +* [Probe Codec Walkthrough](./custom_cosmos_module_extensions/probe_codec_walkthrough.md) - Reference documentation on the probe package and its codec for decoding JSON RPC responses and their Protobuf encoded Transaction Messages +* [Custom Message Type Registration](./custom_cosmos_module_extensions/custom_message_type_registration.md) - Reference documentation on how to register custom message types in the indexer +* [Cosmos Indexer Modules](./custom_cosmos_module_extensions/cosmos_indexer_modules.md) - Reference documentation on the modules provided by the `cosmos-indexer-modules` codebase for extending the supported transaction message types diff --git a/docs/reference/application_workflow.md b/docs/reference/application_workflow/application_workflow.md similarity index 100% rename from docs/reference/application_workflow.md rename to docs/reference/application_workflow/application_workflow.md diff --git a/docs/reference/index_command.md b/docs/reference/application_workflow/index_command.md similarity index 100% rename from docs/reference/index_command.md rename to docs/reference/application_workflow/index_command.md diff --git a/docs/reference/custom_cosmos_module_extensions/cosmos_indexer_modules.md b/docs/reference/custom_cosmos_module_extensions/cosmos_indexer_modules.md new file mode 100644 index 00000000..b5595e8d --- /dev/null +++ b/docs/reference/custom_cosmos_module_extensions/cosmos_indexer_modules.md @@ -0,0 +1,3 @@ +# Cosmos Indexer Modules + +Coming Soon diff --git a/docs/reference/custom_cosmos_module_extensions/custom_message_type_registration.md b/docs/reference/custom_cosmos_module_extensions/custom_message_type_registration.md new file mode 100644 index 00000000..d9406bd1 --- /dev/null +++ b/docs/reference/custom_cosmos_module_extensions/custom_message_type_registration.md @@ -0,0 +1,3 @@ +# Custom Message Type Registration + +Coming Soon diff --git a/docs/reference/custom_cosmos_module_extensions/probe_codec_walkthrough.md b/docs/reference/custom_cosmos_module_extensions/probe_codec_walkthrough.md new file mode 100644 index 00000000..a77cfbac --- /dev/null +++ b/docs/reference/custom_cosmos_module_extensions/probe_codec_walkthrough.md @@ -0,0 +1,3 @@ +# Probe Codec Walkthrough + +Coming Soon diff --git a/docs/reference/custom_indexer_examples.md b/docs/reference/custom_data_indexing/custom_indexer_examples.md similarity index 100% rename from docs/reference/custom_indexer_examples.md rename to docs/reference/custom_data_indexing/custom_indexer_examples.md diff --git a/docs/reference/custom_indexer_walkthrough.md b/docs/reference/custom_data_indexing/custom_indexer_walkthrough.md similarity index 100% rename from docs/reference/custom_indexer_walkthrough.md rename to docs/reference/custom_data_indexing/custom_indexer_walkthrough.md diff --git a/docs/reference/indexer_sdk_and_custom_parsers.md b/docs/reference/custom_data_indexing/indexer_sdk_and_custom_parsers.md similarity index 100% rename from docs/reference/indexer_sdk_and_custom_parsers.md rename to docs/reference/custom_data_indexing/indexer_sdk_and_custom_parsers.md diff --git a/docs/reference/indexer_type.md b/docs/reference/custom_data_indexing/indexer_type.md similarity index 100% rename from docs/reference/indexer_type.md rename to docs/reference/custom_data_indexing/indexer_type.md diff --git a/docs/reference/block_events_indexed_data.md b/docs/reference/default_data_indexing/block_events_indexed_data.md similarity index 100% rename from docs/reference/block_events_indexed_data.md rename to docs/reference/default_data_indexing/block_events_indexed_data.md diff --git a/docs/reference/block_indexed_data.md b/docs/reference/default_data_indexing/block_indexed_data.md similarity index 100% rename from docs/reference/block_indexed_data.md rename to docs/reference/default_data_indexing/block_indexed_data.md diff --git a/docs/reference/transactions_indexed_data.md b/docs/reference/default_data_indexing/transactions_indexed_data.md similarity index 100% rename from docs/reference/transactions_indexed_data.md rename to docs/reference/default_data_indexing/transactions_indexed_data.md