Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

SubQuery Featured #2917

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
Open

Conversation

bgodlin
Copy link

@bgodlin bgodlin commented Mar 17, 2024

Hello Iris team,

We are submitting this contribution with the intention of incorporating SubQuery into your project documentation. As you can observe, we have already prepared the initial project. Kindly inform us if any adjustments are necessary on our part.

Summary by CodeRabbit

  • Documentation
    • Updated the guide on the SubQuery Indexer with information on its features, ecosystem support, and capabilities for analytics and multi-chain projects. Added developer resources and operational guidance.

Copy link

coderabbitai bot commented Mar 17, 2024

Walkthrough

The new documentation introduces the SubQuery Indexer, a powerful blockchain data indexer supporting 150+ ecosystems. It highlights its fast, flexible, and decentralized APIs for web3 projects, enabling feature-rich analytics and multi-chain projects.

Changes

File Path Change Summary
docs/tools/subquery.md Introduced the SubQuery Indexer, emphasizing its support for 150+ ecosystems and multi-chain data aggregation. Includes developer resources.

🐰🌟
In the realm of data, where chains entwine,
A rabbit with SubQuery, a bond divine.
Across diverse ecosystems, it swiftly flies,
Indexing data where the blockchain lies.
With SubQuery's might, our projects soar,
Web3's horizons, open evermore! 🚀🌐


Recent Review Details

Configuration used: CodeRabbit UI

Commits Files that changed from the base of the PR and between 14a6a42 and f3baf93.
Files selected for processing (1)
  • docs/tools/subquery.md (1 hunks)

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

Share
Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai generate interesting stats about this repository and render them as a table.
    • @coderabbitai show all the console.log statements in this repository.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (invoked as PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger a review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai help to get help.

Additionally, you can add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.

CodeRabbit Configration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Status

Actionable comments generated: 7

Configuration used: CodeRabbit UI

Commits Files that changed from the base of the PR and between 65dccb0 and 6a61e1b.
Files selected for processing (1)
  • docs/tools/subquery.md (1 hunks)
Additional comments: 1
docs/tools/subquery.md (1)
  • 1-25: Ensure consistency in the use of British vs. American English throughout the document based on the target audience's preference. Additionally, verify the accessibility of all external links to ensure they are correct and functional.
Verification successful

The verification process for the external links mentioned in the document has been successfully completed. All provided links are accessible and return a 200 HTTP status code, indicating they are correct and functional.

Regarding the consistency in the use of British vs. American English, this aspect was not verifiable through script execution and would require manual review. However, the primary concern of link accessibility has been addressed.

Scripts Executed

The following scripts were executed for the analysis:


Script:

#!/bin/bash
# Example command to check the status of external links in the markdown file.
# Note: Actual implementation depends on available tools and may require a custom script.
curl -o /dev/null --silent --head --write-out '%{http_code}' [URL] | grep 200

Length of output: 81



Script:

#!/bin/bash
# Verifying the accessibility of external links mentioned in the document.

# SubQuery Academy (Documentation)
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://academy.subquery.network/ | grep 200

# Intro Quick Start Guide: 1. Create a New Project
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://academy.subquery.network/quickstart/quickstart.html | grep 200

# Starter Project
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://github.com/subquery/cosmos-subql-starter/tree/main/Iris/iris-starter | grep 200

# Instructions on how to run SubQuery Locally
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://academy.subquery.network/run_publish/run.html | grep 200

# Managed Service
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://managedservice.subquery.network/ | grep 200

# SubQuery Network
curl -o /dev/null --silent --head --write-out '%{http_code}\n' https://subquery.network/network | grep 200

Length of output: 778

docs/tools/subquery.md Outdated Show resolved Hide resolved
bgodlin and others added 4 commits March 19, 2024 17:02
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Status

Actionable comments generated: 4

Configuration used: CodeRabbit UI

Commits Files that changed from the base of the PR and between 6a61e1b and 51ed147.
Files selected for processing (1)
  • docs/tools/subquery.md (1 hunks)


SubQuery is a leading blockchain data indexer that provides developers with fast, flexible, universal, open-source and decentralised APIs for web3 projects. SubQuery SDK allows developers to get rich indexed data and build intuitive and immersive decentralised applications in a faster and more efficient way. SubQuery supports 150+ ecosystems including Iris, Cosmos, Ethereum, Near, Polygon, Polkadot, Algorand, and Avalanche.

Another one of SubQuery's competitive advantages is the ability to aggregate data not only within a chain but across multiple blockchains all within a single project. This allows the creation of feature-rich dashboard analytics, multi-chain block scanners, or projects that index IBC transactions across zones.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider adding a comma after "blockchains" for better readability and changing "multi-chain" to "multichain" for consistency with industry terminology.

- across multiple blockchains all within a single project
+ across multiple blockchains, all within a single project
- multi-chain block scanners
+ multichain block scanners

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
Another one of SubQuery's competitive advantages is the ability to aggregate data not only within a chain but across multiple blockchains all within a single project. This allows the creation of feature-rich dashboard analytics, multi-chain block scanners, or projects that index IBC transactions across zones.
Another one of SubQuery's competitive advantages is the ability to aggregate data not only within a chain but across multiple blockchains, all within a single project. This allows the creation of feature-rich dashboard analytics, multichain block scanners, or projects that index IBC transactions across zones.

SubQuery is open-source, meaning you have the freedom to run it in the following three ways:

- Locally on your own computer (or a cloud provider of your choosing), [view the instructions on how to run SubQuery Locally](https://academy.subquery.network/run_publish/run.html).
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production ready services for mission critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider using "production-ready" as a hyphenated compound adjective to modify "services" and "mission-critical" with a hyphen when used as a compound adjective.

- production ready services
+ production-ready services
- mission critical data
+ mission-critical data

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production ready services for mission critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production-ready services for mission-critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).


- Locally on your own computer (or a cloud provider of your choosing), [view the instructions on how to run SubQuery Locally](https://academy.subquery.network/run_publish/run.html).
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production ready services for mission critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).
- You can publish it to the decentralised [SubQuery Network](https://subquery.network/network), the most open, performant, reliable, and scalable data service for dApp developers. The SubQuery Network indexes and services data to the global community in an incentivised and verifiable way and supports Iris from launch.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The document uses British English spelling for "decentralised" and "incentivised". Ensure consistency in spelling conventions throughout the document. If the target audience primarily uses American English, consider changing to "decentralized" and "incentivized".

- decentralised
+ decentralized
- incentivised
+ incentivized

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
- You can publish it to the decentralised [SubQuery Network](https://subquery.network/network), the most open, performant, reliable, and scalable data service for dApp developers. The SubQuery Network indexes and services data to the global community in an incentivised and verifiable way and supports Iris from launch.
- You can publish it to the decentralized [SubQuery Network](https://subquery.network/network), the most open, performant, reliable, and scalable data service for dApp developers. The SubQuery Network indexes and services data to the global community in an incentivized and verifiable way and supports Iris from launch.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Status

Actionable comments generated: 5

Configuration used: CodeRabbit UI

Commits Files that changed from the base of the PR and between 51ed147 and 723508e.
Files selected for processing (1)
  • docs/tools/subquery.md (1 hunks)

docs/tools/subquery.md Outdated Show resolved Hide resolved
SubQuery is open-source, meaning you have the freedom to run it in the following three ways:

- Locally on your own computer (or a cloud provider of your choosing), [view the instructions on how to run SubQuery Locally](https://academy.subquery.network/run_publish/run.html).
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production ready services for mission critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The phrases "production ready" and "mission critical" are often hyphenated when used as compound adjectives. Consider adding hyphens to improve readability.

- production ready services for mission critical data
+ production-ready services for mission-critical data

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production ready services for mission critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production-ready services for mission-critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).


- Locally on your own computer (or a cloud provider of your choosing), [view the instructions on how to run SubQuery Locally](https://academy.subquery.network/run_publish/run.html).
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production ready services for mission critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).
- You can publish it to the decentralised [SubQuery Network](https://subquery.network/network), the most open, performant, reliable, and scalable data service for dApp developers. The SubQuery Network indexes and services data to the global community in an incentivised and verifiable way and supports Iris from launch.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The document uses British English spelling for "decentralised" and "incentivised". If the target audience primarily uses American English, consider changing to "decentralized" and "incentivized".

- decentralised
+ decentralized
- incentivised
+ incentivized

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
- You can publish it to the decentralised [SubQuery Network](https://subquery.network/network), the most open, performant, reliable, and scalable data service for dApp developers. The SubQuery Network indexes and services data to the global community in an incentivised and verifiable way and supports Iris from launch.
- You can publish it to the decentralized [SubQuery Network](https://subquery.network/network), the most open, performant, reliable, and scalable data service for dApp developers. The SubQuery Network indexes and services data to the global community in an incentivized and verifiable way and supports Iris from launch.

docs/tools/subquery.md Outdated Show resolved Hide resolved
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

Review Status

Configuration used: CodeRabbit UI

Commits Files that changed from the base of the PR and between 723508e and a52ea0b.
Files selected for processing (1)
  • docs/tools/subquery.md (1 hunks)
Additional Context Used

docs/tools/subquery.md Outdated Show resolved Hide resolved
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

Review Status

Configuration used: CodeRabbit UI

Commits Files that changed from the base of the PR and between a52ea0b and 8a18d69.
Files selected for processing (1)
  • docs/tools/subquery.md (1 hunks)
Additional Context Used

docs/tools/subquery.md Outdated Show resolved Hide resolved
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4


SubQuery is a leading blockchain data indexer that provides developers with fast, flexible, universal, open-source and decentralized APIs for web3 projects. SubQuery SDK allows developers to get rich indexed data and build intuitive and immersive decentralized applications in a faster and more efficient way. SubQuery supports 150+ ecosystems including Iris, Cosmos, Ethereum, Near, Polygon, Polkadot, Algorand, and Avalanche.

Another one of SubQuery's competitive advantages is the ability to aggregate data not only within a chain but across multiple blockchains, all within a single project. This allows the creation of feature-rich dashboard analytics, multi-chain block scanners, or projects that index IBC transactions across zones.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The term "multi-chain" should be hyphenated when used as an adjective for consistency with industry terminology.

- multi-chain block scanners
+ multichain block scanners

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
Another one of SubQuery's competitive advantages is the ability to aggregate data not only within a chain but across multiple blockchains, all within a single project. This allows the creation of feature-rich dashboard analytics, multi-chain block scanners, or projects that index IBC transactions across zones.
Another one of SubQuery's competitive advantages is the ability to aggregate data not only within a chain but across multiple blockchains, all within a single project. This allows the creation of feature-rich dashboard analytics, multichain block scanners, or projects that index IBC transactions across zones.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4


# SubQuery Indexer

SubQuery is a leading blockchain data indexer that provides developers with fast, flexible, universal, open-source and decentralized APIs for web3 projects. SubQuery SDK allows developers to get rich indexed data and build intuitive and immersive decentralized applications in a faster and more efficient way. SubQuery supports 150+ ecosystems including Iris, Cosmos, Ethereum, Near, Polygon, Polkadot, Algorand, and Avalanche.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use "open-source" consistently as a compound adjective.

- open source and decentralized APIs
+ open-source and decentralized APIs

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
SubQuery is a leading blockchain data indexer that provides developers with fast, flexible, universal, open-source and decentralized APIs for web3 projects. SubQuery SDK allows developers to get rich indexed data and build intuitive and immersive decentralized applications in a faster and more efficient way. SubQuery supports 150+ ecosystems including Iris, Cosmos, Ethereum, Near, Polygon, Polkadot, Algorand, and Avalanche.
SubQuery is a leading blockchain data indexer that provides developers with fast, flexible, universal, open-source and decentralized APIs for web3 projects. SubQuery SDK allows developers to get rich indexed data and build intuitive and immersive decentralized applications in a faster and more efficient way. SubQuery supports 150+ ecosystems including Iris, Cosmos, Ethereum, Near, Polygon, Polkadot, Algorand, and Avalanche.


SubQuery is a leading blockchain data indexer that provides developers with fast, flexible, universal, open-source and decentralized APIs for web3 projects. SubQuery SDK allows developers to get rich indexed data and build intuitive and immersive decentralized applications in a faster and more efficient way. SubQuery supports 150+ ecosystems including Iris, Cosmos, Ethereum, Near, Polygon, Polkadot, Algorand, and Avalanche.

Another one of SubQuery's competitive advantages is the ability to aggregate data not only within a chain but across multiple blockchains, all within a single project. This allows the creation of feature-rich dashboard analytics, multichain block scanners, or projects that index IBC transactions across zones.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a comma for better readability and use "multichain" consistently.

- across multiple blockchains all within a single project
+ across multiple blockchains, all within a single project
- multichain block scanners
+ multichain block scanners

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
Another one of SubQuery's competitive advantages is the ability to aggregate data not only within a chain but across multiple blockchains, all within a single project. This allows the creation of feature-rich dashboard analytics, multichain block scanners, or projects that index IBC transactions across zones.
Another one of SubQuery's competitive advantages is the ability to aggregate data not only within a chain but across multiple blockchains, all within a single project. This allows the creation of feature-rich dashboard analytics, multichain block scanners, or projects that index IBC transactions across zones.

- Intro Quick Start Guide: [1. Create a New Project](https://academy.subquery.network/quickstart/quickstart.html)
- [Starter Project](https://github.com/subquery/cosmos-subql-starter/tree/main/Iris/iris-starter)

For technical questions and support, reach out to us `[email protected]`
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a comma after "support" for better readability.

- For technical questions and support reach out to us `[email protected]`
+ For technical questions and support, reach out to us `[email protected]`

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
For technical questions and support, reach out to us `[email protected]`
For technical questions and support, reach out to us `[email protected]`

SubQuery is open-source, meaning you have the freedom to run it in the following three ways:

- Locally on your own computer (or a cloud provider of your choosing), [view the instructions on how to run SubQuery Locally](https://academy.subquery.network/run_publish/run.html).
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production-ready services for mission-critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use hyphenated compound adjectives for "production-ready" and "mission-critical".

- production ready services for mission critical data
+ production-ready services for mission-critical data

Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation.

Suggested change
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production-ready services for mission-critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).
- You can publish it to SubQuery's enterprise-level [Managed Service](https://managedservice.subquery.network/), where we'll host your SubQuery project in production-ready services for mission-critical data with zero-downtime blue/green deployments. There even is a generous free tier. [Find out how](https://academy.subquery.network/run_publish/publish.html).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants