diff --git a/docs/build/dapp-staking/indexer/tutorial.md b/docs/build/dapp-staking/indexer/tutorial.md index a9667ca82e9..e7cca6fb96f 100644 --- a/docs/build/dapp-staking/indexer/tutorial.md +++ b/docs/build/dapp-staking/indexer/tutorial.md @@ -1,6 +1,6 @@ # How to Install and Run -## Indexder Installation +## Indexer Installation ### 1. Prerequisites diff --git a/docs/build/integrations/dapp-listing/dappradar.md b/docs/build/integrations/dapp-listing/dappradar.md deleted file mode 100644 index 7aa10df15f9..00000000000 --- a/docs/build/integrations/dapp-listing/dappradar.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -sidebar_position: 2 ---- - -# DappRadar {#dappradar-en-page-id} - -## Introduction to DappRadar - -[DappRadar] was started in 2018 with the goal of delivering high quality, accurate insights about decentralized applications to a global audience, and rapidly became the go-to, trusted industry source. Since then, DappRadar has become a defacto standard for dApp discovery with more than ten thousand applications listed over twenty protocols. In their own words, *“Across the globe consumers are discovering dapps and managing their NFT/DeFi portfolios with . We’re visited by over 500,000 users every month, our data powers leading industry partners and our quarterly reports are the trusted authority on multichain dapp market insight*.” -Astar and Shiden are live on DappRadar, where you will find them under [Astar dApps](https://dappradar.com/rankings/protocol/astar) and [Shiden dApps](https://dappradar.com/rankings/protocol/shiden). - -![1](img/1.png) - -You can [submit your project](https://dappradar.com/dashboard/submit-dapp) to DappRadar by providing background on your project including a short and a full description, website URL, and logo. Only a subset of the fields are required, but you are encouraged to complete as many as possible. - -:::caution -DappRadar contains user-generated content. You should verify any information with your own research. Astar/Shiden is a permissionless network. Any project can deploy its contracts to Astar/Shiden. -::: - -## Required Content - -At a minimum, you must include the following information to submit your project/dApp to DappRadar: - -- dApp Name -- Logo (250 x 250 pixel png or jpg) -- Category -- Website URL -- Short Description (160 characters or less) -- Full Description - -## How to Submit your dApp - -First, you'll need to [create a DappRadar account](https://auth.dappradar.com/email-register) and verify your email. Once ready with the required content, you can head to the where you can take the following steps: - -![2](img/2.png) -![3](img/3.png) - -- Enter your project’s name -- Upload your dApp's logo (250 by 250 pixel PNG or JPG, 150KB max) -- Select the relevant category for your dApp -- Include the URL for your dApp - -![4](img/4.png) - -- Write a short description (160 characters or less) -- Specify the protocols your dApp is deployed on. You can select multiple protocols here, such as Astar and Shiden -- After selecting at least one protocol, you'll be prompted to enter your dApp's contract address(es) for each protocol. Please try to fill all the contract address(es) on your dApp for better accuracy of the data. -- Write a full description for your dApp - -![5](img/5.png) -![6](img/6.png) - -- Optionally, provide social / media links. (These will be shown on the dApp page, so we highly recommend you do so.) -- It is also optional but recommended that you provide screenshots of your dApp. You also have the option of providing a YouTube link to a demo of your dApp. -- Review the terms and conditions, and press **Submit a dApp** - -Submissions are reviewed by the DappRadar team and will be published if the dApp is deemed suitable for listing. For any Astar/Shiden-related questions you can reach out to us in [Discord](https://discord.gg/astarnetwork). For DappRadar questions, support is available in the [DappRadar Discord](https://discord.com/invite/4ybbssrHkm) or you can contact [developers@dappradar.com](mailto:developers@dappradar.com). - -[DappRadar]: https://dappradar.com/ diff --git a/docs/build/integrations/dapp-listing/img/1.png b/docs/build/integrations/dapp-listing/img/1.png deleted file mode 100644 index 79b7392b61e..00000000000 Binary files a/docs/build/integrations/dapp-listing/img/1.png and /dev/null differ diff --git a/docs/build/integrations/dapp-listing/img/2.png b/docs/build/integrations/dapp-listing/img/2.png deleted file mode 100644 index 9b5beaca294..00000000000 Binary files a/docs/build/integrations/dapp-listing/img/2.png and /dev/null differ diff --git a/docs/build/integrations/dapp-listing/img/3.png b/docs/build/integrations/dapp-listing/img/3.png deleted file mode 100644 index 7e0832e64e8..00000000000 Binary files a/docs/build/integrations/dapp-listing/img/3.png and /dev/null differ diff --git a/docs/build/integrations/dapp-listing/img/4.png b/docs/build/integrations/dapp-listing/img/4.png deleted file mode 100644 index e173fbbbad8..00000000000 Binary files a/docs/build/integrations/dapp-listing/img/4.png and /dev/null differ diff --git a/docs/build/integrations/dapp-listing/img/5.png b/docs/build/integrations/dapp-listing/img/5.png deleted file mode 100644 index ef4418435d5..00000000000 Binary files a/docs/build/integrations/dapp-listing/img/5.png and /dev/null differ diff --git a/docs/build/integrations/dapp-listing/img/6.png b/docs/build/integrations/dapp-listing/img/6.png deleted file mode 100644 index 523cfe9ee2d..00000000000 Binary files a/docs/build/integrations/dapp-listing/img/6.png and /dev/null differ diff --git a/docs/build/integrations/indexers/thegraph.md b/docs/build/integrations/indexers/thegraph.md deleted file mode 100644 index bfb2714c75a..00000000000 --- a/docs/build/integrations/indexers/thegraph.md +++ /dev/null @@ -1,196 +0,0 @@ ---- -sidebar_position: 4 ---- - -import Figure from '/src/components/figure' - -# The Graph - -## The Graph Quick Start - -Getting historical data on a smart contract can be frustrating when you’re building a dapp. The Graph provides a decentralized option to query smart contract data through APIs known as subgraphs, which utilize GraphQL. The Graph’s infrastructure relies on a decentralized network of indexers, enabling your dapp to become truly decentralized. - -These subgraphs only take a few minutes to set up and get running. To get started, follow these three steps: - -1. Initialize your subgraph project -2. Deploy & Publish -3. Query from your dapp - -Pricing: **All developers receive 100K free queries per month on the decentralized network**. After these free queries, you only pay based on usage at $4 for every 100K queries. - -Here’s a step by step walk through: - -## 1. Initialize your subgraph project - -### Create a subgraph on Subgraph Studio⁠ - -Go to the [Subgraph Studio](https://thegraph.com/studio/) and connect your wallet. Once your wallet is connected, you can begin by clicking “Create a Subgraph”. Please choose a good name for the subgraph because this name can’t be edited later. It is recommended to use Title Case: “Subgraph Name Chain Name.” - -![Create a Subgraph](https://lh7-us.googleusercontent.com/docsz/AD_4nXf8OTdwMxlKQGKzIF_kYR7NPKeh9TmWnZBYxb7ft_YbdOdx_VVtbp6PslN7N1KGUzNpIDCmaXppdrllM1cw_J4L8Na03BXOWzJTK1POCve0nkRjQYgWJ60QHAdtQ4Niy83SMM8m0F0f-N-AJj4PDqDPlA5M?key=fnI6SyFgXU9SZRNX5C5vPQ) - - -You will then land on your subgraph’s page. All the CLI commands you need will be visible on the right side of the page: - -![CLI commands](https://lh7-us.googleusercontent.com/docsz/AD_4nXe3YvCxiOH_LupSWe8zh9AmP-VrV4PlOq3f7Ix6hNlBUYcANUFuLuVIWR74OGiBs0nrugTyT0v3o6RPmTsgHONdv_ZJNWtcDWEkRntXPHlQGFcqmEBa-D6j4aoIPzUKYdOJMVUPu8O3fwjdZ4IaXXZoTzY?key=fnI6SyFgXU9SZRNX5C5vPQ) - - -### Install the Graph CLI⁠ - -On your local machine run the following: -``` -npm install -g @graphprotocol/graph-cli -``` -### Initialize your Subgraph⁠ - -You can copy this directly from your subgraph page to include your specific subgraph slug: -``` -graph init --studio -``` -You’ll be prompted to provide some info on your subgraph like this: - -![cli sample](https://lh7-us.googleusercontent.com/docsz/AD_4nXdTAUsUb5vbs3GtCrhKhuXM1xYoqqooYTxw6lfJfYtLJNP8GKVOhTPmjxlM1b6Qpx-pXNVOzRuc8BL12wZXqy4MIj8ja0tp15znfuJD_Mg84SSNj3JpQ4d31lNTxPYnpba4UOzZx8pmgOIsbI7vCz70v9gC?key=fnI6SyFgXU9SZRNX5C5vPQ) - - -Simply have your contract verified on the block explorer and the CLI will automatically obtain the ABI and set up your subgraph. The default settings will generate an entity for each event. - -## 2. Deploy & Publish - -### Deploy to Subgraph Studio⁠ - -First run these commands: - -```bash -$ graph codegen -$ graph build -``` - -Then run these to authenticate and deploy your subgraph. You can copy these commands directly from your subgraph’s page in Studio to include your specific deploy key and subgraph slug: - -```bash -$ graph auth --studio -$ graph deploy --studio -``` - -You will be asked for a version label. You can enter something like v0.0.1, but you’re free to choose the format. - -### Test your subgraph⁠ - -You can test your subgraph by making a sample query in the playground section. The Details tab will show you an API endpoint. You can use that endpoint to test from your dapp. - -![Playground](https://lh7-us.googleusercontent.com/docsz/AD_4nXf3afwSins8_eO7BceGPN79VvwolDxmFNUnkPk0zAJCaUA-3-UAAjVvrMzwr7q9vNYWdrEUNgm2De2VfQpWauiT87RkFc-cVfoPSsQbYSgsmwhyY1-tpPdv2J1H4JAMq70nfWBhb8PszZBFjsbDAaJ5eto?key=fnI6SyFgXU9SZRNX5C5vPQ) - - -### Publish Your Subgraph to The Graph’s Decentralized Network - -Once your subgraph is ready to be put into production, you can publish it to the decentralized network. On your subgraph’s page in Subgraph Studio, click on the Publish button: - -![publish button](https://edgeandnode.notion.site/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2Fa7d6afae-8784-4b15-a90e-ee8f6ee007ba%2F2f9c4526-123d-4164-8ea8-39959c8babbf%2FUntitled.png?table=block&id=37005371-76b4-4780-b044-040a570e3af6&spaceId=a7d6afae-8784-4b15-a90e-ee8f6ee007ba&width=1420&userId=&cache=v2) - - -Before you can query your subgraph, Indexers need to begin serving queries on it. In order to streamline this process, you can curate your own subgraph using GRT. - -When publishing, you’ll see the option to curate your subgraph. As of May 2024, it is recommended that you curate your own subgraph with at least 3,000 GRT to ensure that it is indexed and available for querying as soon as possible. - -![Publish screen](https://lh7-us.googleusercontent.com/docsz/AD_4nXerUr-IgWjwBZvp9Idvz5hTq8AFB0n_VlXCzyDtUxKaCTANT4gkk-2O77oW-a0ZWOh3hnqQsY7zcSaLeCQin9XU1NTX1RVYOLFX9MuVxBEqcMryqgnGQKx-MbDnOWKuMoLBhgyVWQereg3cdWtCPcTQKFU?key=fnI6SyFgXU9SZRNX5C5vPQ) - -## 3. Query your Subgraph - -Congratulations! You can now query your subgraph on the decentralized network! - -For any subgraph on the decentralized network, you can start querying it by passing a GraphQL query into the subgraph’s query URL which can be found at the top of its Explorer page. - -Here’s an example from the [CryptoPunks Ethereum subgraph](https://thegraph.com/explorer/subgraphs/HdVdERFUe8h61vm2fDyycHgxjsde5PbB832NHgJfZNqK) by Messari: - -![Query URL](https://lh7-us.googleusercontent.com/docsz/AD_4nXebivsPOUjPHAa3UVtvxoYTFXaGBao9pQOAJvFK0S7Uv0scfL6TcTVjmNCzT4DgsIloAQyrPTCqHjFPtmjyrzoKkfSeV28FjS32F9-aJJm0ILAHey2gqMr7Seu4IqPz2d__QotsWG3OKv2dEghiD74eypzs?key=fnI6SyFgXU9SZRNX5C5vPQ) - - -The query URL for this subgraph is: - -https://gateway-arbitrum.network.thegraph.com/api/**[api-key]**/subgraphs/id/HdVdERFUe8h61vm2fDyycHgxjsde5PbB832NHgJfZNqK - -Now, you simply need to fill in your own API Key to start sending GraphQL queries to this endpoint. - -### Getting your own API Key - -![API keys](https://lh7-us.googleusercontent.com/docsz/AD_4nXdz7H8hSRf2XqrU0jN3p3KbmuptHvQJbhRHOJh67nBfwh8RVnhTsCFDGA_JQUFizyMn7psQO0Vgk6Vy7cKYH47OyTq5PqycB0xxLyF4kSPsT7hYdMv2MEzAo433sJT6VlQbUAzgPnSxKI9a5Tn3ShSzaxI?key=fnI6SyFgXU9SZRNX5C5vPQ) - - -In Subgraph Studio, you’ll see the “API Keys” menu at the top of the page. Here you can create API Keys. - -## Appendix - -### Sample Query - -This query shows the most expensive CryptoPunks sold. - -```graphql -{ - trades(orderBy: priceETH, orderDirection: desc) { - priceETH - tokenId - } -} - -``` - -Passing this into the query URL returns this result: - -``` -{ - "data": { - "trades": [ - { - "priceETH": "124457.067524886018255505", - "tokenId": "9998" - }, - { - "priceETH": "8000", - "tokenId": "5822" - }, -// ... -``` - - - -### Sample code - -```jsx -const axios = require('axios'); - -const graphqlQuery = `{ - trades(orderBy: priceETH, orderDirection: desc) { - priceETH - tokenId - } -}`; -const queryUrl = 'https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/HdVdERFUe8h61vm2fDyycHgxjsde5PbB832NHgJfZNqK' - -const graphQLRequest = { - method: 'post', - url: queryUrl, - data: { - query: graphqlQuery, - }, -}; - -// Send the GraphQL query -axios(graphQLRequest) - .then((response) => { - // Handle the response here - const data = response.data.data - console.log(data) - - }) - .catch((error) => { - // Handle any errors - console.error(error); - }); -``` - -### Additional resources: - -- To explore all the ways you can optimize & customize your subgraph for a better performance, read more about [creating a subgraph here](https://thegraph.com/docs/en/developing/creating-a-subgraph/). -- For more information about querying data from your subgraph, read more [here](https://thegraph.com/docs/en/querying/querying-the-graph/). \ No newline at end of file diff --git a/docs/build/integrations/node-providers/index.md b/docs/build/integrations/node-providers/index.md index 3be1ce521b7..44ce3054227 100644 --- a/docs/build/integrations/node-providers/index.md +++ b/docs/build/integrations/node-providers/index.md @@ -1,6 +1,6 @@ # Node Providers - -The free endpoints mentioned in the [Build Environment section](/docs/build/environment/endpoints) are rate limited and designed for end users to be able to interact with dApps, or deploy/call smart contracts. They are not suitable for usage by dApp UIs that scrape blockchain data continuously, or indexers (like the Graph). + +The free endpoints mentioned in the [Build Environment section](/docs/build/environment/endpoints) are rate limited and designed for end users to be able to interact with dApps, or deploy/call smart contracts. They are not suitable for usage by dApp UIs that scrape blockchain data continuously, or indexers. If you are an active developer you should consider creating your own endpoint, and it is mandatory to do so for production deployments. Refer to how run an [archive node](/docs/nodes diff --git a/docs/build/nodes/archive-node/binary.md b/docs/build/nodes/archive-node/binary.md index 6da2dea8446..112ff28377c 100644 --- a/docs/build/nodes/archive-node/binary.md +++ b/docs/build/nodes/archive-node/binary.md @@ -71,7 +71,7 @@ Description=Astar Archive node [Service] User=astar Group=astar - + ExecStart=/usr/local/bin/astar-collator \ --pruning archive \ --rpc-cors all \ @@ -101,7 +101,7 @@ Description=Shiden Archive node [Service] User=astar Group=astar - + ExecStart=/usr/local/bin/astar-collator \ --pruning archive \ --rpc-cors all \ @@ -131,7 +131,7 @@ Description=Shibuya Archive node [Service] User=astar Group=astar - + ExecStart=/usr/local/bin/astar-collator \ --pruning archive \ --rpc-cors all \ @@ -208,7 +208,7 @@ journalctl -fu astar-collator -n100 ### Indexers and oracles -To access data from indexers (e.g. The Graph) or Oracles (e.g. Chainlink), you need to add the debug flags below to the node launch command, after the `astar-collator` line: +To access data from indexers (e.g. Subsquid) or Oracles (e.g. Chainlink), you need to add the debug flags below to the node launch command, after the `astar-collator` line: `--ethapi=debug` diff --git a/docs/build/nodes/archive-node/docker.md b/docs/build/nodes/archive-node/docker.md index 68ed799bbcc..d10106ec29d 100644 --- a/docs/build/nodes/archive-node/docker.md +++ b/docs/build/nodes/archive-node/docker.md @@ -118,7 +118,7 @@ curl -H "Content-Type: application/json" --data '{ "jsonrpc":"2.0", "method":"sy In any case, wait for the chain to be fully synchronized by checking the [node log](/docs/build/nodes/archive-node/binary#get-node-logs). -How the archive node will be used will largely determine what steps to follow next: +How the archive node will be used will largely determine what steps to follow next: - If accessing the node publicly, running an [nginx server](/docs/build/nodes/archive-node/nginx) is the recommended option. - If the dApp is running on the same server as the node, then it can be accessed directly with the `localhost` address. This setup is recommended for testing purposes only. - If running the node locally for testing purposes, switch networks in [Polkadot.js portal](https://polkadot.js.org/apps) to explore the chain: @@ -145,7 +145,7 @@ docker logs -f -n 100 $(docker ps -aq --filter name="astar-container") ### Indexers and Oracles -To access data from indexers (like The Graph) or Oracles (like Chainlink), add the follwing debug flags to the node launch command, after the `astar-collator` line: +To access data from indexers (like Subsquid) or Oracles (like Chainlink), add the follwing debug flags to the node launch command, after the `astar-collator` line: `--ethapi=debug` diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/requirements.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/requirements.md index 6bd0e5977f0..8bc45587f85 100644 --- a/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/requirements.md +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-devs/requirements.md @@ -78,7 +78,6 @@ Projects deployed outside the Astar Network must demonstrate: To strengthen your application, ensure you: - Are listed on **[DefiLlama](https://defillama.com/)** (if contributing to TVL). -- Are listed on **[DappRadar](https://dappradar.com/)** (if you have daily active users). - Have **verified smart contracts** on Astar Native, EVM, Soneium, Ethereum or Polkadot. - Tag your GitHub repo with `#astar-network` and `#dAppStaking`. - (For infrastructure/tools) Submit a PR to [Astar Documentation](https://github.com/AstarNetwork/astar-docs) to be listed. @@ -131,14 +130,14 @@ Once approved: ### Title: Project Name - dApp Staking Application -**Introduction:** Brief introduction of your proposal; -**Project Overview:** Presentation of your project; -**Mission:** What is your mission and what do you want to achieve with your project? You can also share your vision; -**Team:** Introducing the team behind the project and the main contributors. You can share links to personal profiles; -**Security:** Share how you manage the security of your projects and users. You can share audit reports if you have them; -**Past Performance & Milestones:** Describe your latest achievements and the milestones you have reached in your project; -**Roadmap:** Present your plans and the next steps in your project; -**dApp Staking Reward Usage Breakdown:** Describe how you will use the rewards you earn with dApp Staking; +**Introduction:** Brief introduction of your proposal; +**Project Overview:** Presentation of your project; +**Mission:** What is your mission and what do you want to achieve with your project? You can also share your vision; +**Team:** Introducing the team behind the project and the main contributors. You can share links to personal profiles; +**Security:** Share how you manage the security of your projects and users. You can share audit reports if you have them; +**Past Performance & Milestones:** Describe your latest achievements and the milestones you have reached in your project; +**Roadmap:** Present your plans and the next steps in your project; +**dApp Staking Reward Usage Breakdown:** Describe how you will use the rewards you earn with dApp Staking; **Appendix:** Links to your projects, products and communities ::: diff --git a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/staking.md b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/staking.md index ba4c45dac27..fffc94df33b 100644 --- a/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/staking.md +++ b/docs/use/how-to-guides/layer-1/dapp-staking/for-stakers/staking.md @@ -86,7 +86,7 @@ You can start staking either by clicking the blue **“Choose dApps”** button :::tip Project cards -Click on the project cards for more information, access to their communities or to view team profiles. You can also find useful resources on our [**forum**](https://forum.astar.network/) or check [**DefilLama**](https://defillama.com/) or [**DappRadar**](https://dappradar.com/). +Click on the project cards for more information, access to their communities or to view team profiles. You can also find useful resources on our [**forum**](https://forum.astar.network/) or check [**DefilLama**](https://defillama.com/). ::: @@ -146,16 +146,16 @@ At the end of a Period, tokens are unstaked from all dApps, remain locked on the ::: -## 3. Video tutorial +## 3. Video tutorial To wrap up, here’s a video tutorial that will guide you through the step-by-step process in case anything wasn’t clear. Feel free to ask your questions in our [**official Astar Discord**](https://discord.com/invite/AstarNetwork). -