-
Notifications
You must be signed in to change notification settings - Fork 49
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
Add Ormi Subgraph Hosting Guide #472
Open
ljuliandicarlo
wants to merge
4
commits into
rollkit:main
Choose a base branch
from
ljuliandicarlo:main
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
4 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,71 @@ | ||
# Using Ormi's 0xgraph Subgraph Hosting Solution | ||
|
||
## Introduction | ||
|
||
[Ormi Labs](https://app.0xgraph.xyz/dashboard/api) offers a powerful solution for hosting and managing subgraphs, which can be particularly useful for Rollkit rollups and their ecosystems - enabling dApps with low-latency and reliable real-time data. This beginner guide aims to demonstrate the capabilities of 0xgraph's subgraph hosting solution for rollup teams. | ||
|
||
Please note that network support for your specific rollup will need to be added before subgraphs can be fully migrated. To get network support added for your rollup, please reach out to the Ormi team at julian@ormi.xyz. | ||
|
||
This guide will walk you through the process of using Ormi's services to host your Subgraphs, providing insight into how these services can enhance the real-time data querying capabilities of your Rollkit rollups ecosystem once network support is implemented. | ||
|
||
## Prerequisites | ||
|
||
- Node.js installed on your system | ||
- Basic understanding of Subgraphs and GraphQL APIs | ||
|
||
## Getting Started with Ormi | ||
|
||
### 1. Install the 0xgraph CLI | ||
First, install the 0xgraph CLI tool: | ||
```bash | ||
npm i @xgraph/cli | ||
``` | ||
|
||
### 2. Authentication | ||
Next you'll need to authenticate with Ormi using your API key. You can obtain this key by signing up at https://app.0xgraph.xyz/dashboard/api. | ||
|
||
Once you have your API key, authenticate with Ormi using the following command: | ||
|
||
```bash | ||
0xgraph auth | ||
|
||
## Creating and Deploying Your Subgraph | ||
### 1. Prepare Your Subgraph | ||
Ensure your Subgraph project follows the standard structure: | ||
- Subgraph.yaml: The manifest file | ||
- Schema.graphql: The schema file | ||
- Mapping files (typically in AssemblyScript) | ||
|
||
### 2. Generate Types and Mappings | ||
Run the following command in your Subgraph project root: | ||
```bash | ||
0xgraph codegen | ||
``` | ||
### 3. Build Your Subgraph | ||
Build your Subgraph using: | ||
```bash | ||
0xgraph build | ||
``` | ||
### 4. Create/Register Your Subgraph | ||
Choose a unique name for your Subgraph and register it | ||
```bash | ||
0xgraph create <my-subgraph-name> | ||
``` | ||
### 5. Deploy Your Subgraph | ||
Deploy your subgraph to Ormi's hosted service: | ||
```bash | ||
0xgraph deploy | ||
``` | ||
Follow the prompts to specify your subgraph name and version. | ||
|
||
|
||
## Conclusion | ||
By leveraging Ormi for subgraph hosting, Rollkit rollup teams can gain valuable insights into the powerful data indexing and querying capabilities that can enhance their ecosystems. This integration paves the way for more efficient data retrieval and analysis, potentially improving the overall performance and functionality of Rollkit-based projects. | ||
|
||
The 0xgraph solution offers a glimpse into the future of decentralized data management for rollups, promising low-latency access to real-time data that can significantly boost dApp performance and user experience. As the blockchain space continues to evolve, tools like Ormi's subgraph hosting service are becoming increasingly crucial for building scalable and efficient decentralized applications. | ||
|
||
While this guide provides a starting point, remember that full integration requires network support for your specific rollup. We encourage rollup teams to reach out to Ormi Labs to discuss adding support for their networks, unlocking the full potential of this powerful tool for their ecosystems. | ||
|
||
For more detailed information on subgraph development and best practices, refer to The Graph's official documentation and the Messari subgraphs repository. Stay tuned for updates as Ormi continues to expand its network support and feature set, bringing advanced data solutions to an ever-growing number of blockchain ecosystems. | ||
|
||
Links: [Ormi Labs](https://ormi.xyz/) | [0xgraph docs](https://docs.ormi.xyz/0xgraph) | [X](https://x.com/ormilabs) |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add missing code block closure.
The code block starting at line 29 is missing its closing backticks.
0xgraph auth +```
📝 Committable suggestion