{"id":21583994,"url":"https://github.com/bryanlabs/cosmos-indexer-sdk","last_synced_at":"2025-04-28T13:15:55.553Z","repository":{"id":231523381,"uuid":"705357782","full_name":"bryanlabs/cosmos-indexer-sdk","owner":"bryanlabs","description":"An opensource cosmos indexer!  Please feel free to use this to build other awesome apps like https://app.sycamore.tax and https://elections.atomaccelerator.com","archived":false,"fork":false,"pushed_at":"2024-09-17T04:24:42.000Z","size":559,"stargazers_count":33,"open_issues_count":12,"forks_count":14,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-24T15:03:01.207Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://defiantlabs.net","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bryanlabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://wallet.keplr.app/chains/osmosis?modal=validator\u0026chain=osmosis-1\u0026validator_address=osmovaloper1dnmz4yzv73lr3lmauuaa0wpwn8zm8s20lg3pg9","defiantlabs.net"]}},"created_at":"2023-10-15T19:32:31.000Z","updated_at":"2024-11-22T04:15:02.000Z","dependencies_parsed_at":"2024-04-04T13:02:35.593Z","dependency_job_id":"46b9af87-94ea-4ed2-a4e3-a122587d4071","html_url":"https://github.com/bryanlabs/cosmos-indexer-sdk","commit_stats":null,"previous_names":["defiantlabs/cosmos-indexer","bryanlabs/cosmos-indexer-sdk"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryanlabs%2Fcosmos-indexer-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryanlabs%2Fcosmos-indexer-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryanlabs%2Fcosmos-indexer-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryanlabs%2Fcosmos-indexer-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bryanlabs","download_url":"https://codeload.github.com/bryanlabs/cosmos-indexer-sdk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227153040,"owners_count":17738547,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-24T15:01:00.716Z","updated_at":"2024-11-29T15:20:28.801Z","avatar_url":"https://github.com/bryanlabs.png","language":"Go","funding_links":["https://wallet.keplr.app/chains/osmosis?modal=validator\u0026chain=osmosis-1\u0026validator_address=osmovaloper1dnmz4yzv73lr3lmauuaa0wpwn8zm8s20lg3pg9","defiantlabs.net"],"categories":["Go"],"sub_categories":[],"readme":"# Cosmos Indexer\n\nThe Cosmos Indexer is an open-source application designed to index a Cosmos chain to a generalized Transaction/Event DB schema. Its mission is to offer a flexible DB schema compatible with all Cosmos SDK Chains while simplifying the indexing process to allow developers flexible ways to store custom indexed data.\n\n## Quick Start\n\nYou can use our `docker-compose` file for a quick demo of how to run the indexer, DB, web client, and UI.\n\n```shell\ndocker compose up\n```\nKeep an eye on the output for the index and access the web server through the provided link.\n\n## Getting Started\n\nIt's indexing time! Follow the steps below to get started.\n\n### Prerequisites\n\nBefore you can start indexing a chain, you need to set up the application's dependencies:\n\n#### PostgreSQL\nThe application requires a PostgreSQL server with an established database and an owner user/role with password login. Here's a simple example of setting up a containerized database locally [here](https://towardsdatascience.com/local-development-set-up-of-postgresql-with-docker-c022632f13ea).\n\n#### Go\nThe application is written in Go, so you need to build it from source. This requires a system installation of at minimum Go 1.22. Instructions for installing and configuring Go can be found [here](https://go.dev/doc/install).\n\n## Indexing and Querying\n\nYou are now ready to index and query the chain. For detailed steps, check out the [Indexing](#indexing) and [Querying](#querying) sections below.\n\n## CLI Syntax\n\nThe Cosmos Indexer tool provides several settings and commands which are accessible via a config file or through CLI flags. You can learn about the CLI flags and their function by running `go run main.go` to display the application help text.\n\nFor more detailed information on the settings, refer to the [Config](#config) section.\n\n### Config\n\nThe config file, used to set up the Cosmos Tax CLI tool, is broken into four main\n\n sections:\n\n1. [Log](#log)\n2. [Database](#database)\n3. [Base](#base)\n4. [Probe](#probe)\n\n#### Log\n\nThe Log section covers settings related to logging levels and formats, including log file paths and whether to use [ZeroLog's](https://github.com/rs/zerolog) pretty logging.\n\n#### Database\n\nThe Database section defines the settings needed to connect to the database server and to configure the logging level of the ORM.\n\n#### Base\n\nThe Base section contains the core settings for the tool, such as API endpoints, block ranges, indexing behavior, and more.\n\n#### Probe\n\nThe probe section configures [probe](https://github.com/DefiantLabs/probe) used by the tool to read data from the blockchain. This is built into the application and doesn't need to be installed separately.\n\nFor detailed descriptions of each setting in these sections, please refer to the [Detailed Config Explanation](#detailed-config-explanation) section below.\n\n## Detailed Config Explanation\n\nThis section provides an in-depth description of each setting available in the config file. For further details, refer to the inline documentation within the config file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbryanlabs%2Fcosmos-indexer-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbryanlabs%2Fcosmos-indexer-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbryanlabs%2Fcosmos-indexer-sdk/lists"}