Skip to content

Commit

Permalink
Add Blast API, Blast Faucet and Thirdweb Faucet
Browse files Browse the repository at this point in the history
  • Loading branch information
owans committed Dec 13, 2024
1 parent 6de8f1c commit f23e3c4
Show file tree
Hide file tree
Showing 21 changed files with 119 additions and 18 deletions.
3 changes: 2 additions & 1 deletion docs/01-concepts/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -162,7 +162,8 @@ This is a platform where users can trade cryptocurrencies and other digital asse

This is a tool that distributes small amounts of cryptocurrency for testing purposes on test networks, allowing developers and users to experiment without financial risk. In the context of Rootstock, faucets can be used to obtain test RBTC (tRBTC), enabling developers to test their applications in a realistic environment. This practice is crucial for ensuring that dApps function correctly before deployment on the mainnet.

<Button size="sm" href="https://faucet.rootstock.io/">Get tRBTC</Button>
<Button size="sm" href="/dev-tools/additional-tools/#faucets">Get tRBTC</Button>

<br/>
<br/>

Expand Down
7 changes: 7 additions & 0 deletions docs/01-concepts/rbtc/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,13 @@ sidebar_label: RBTC Token

RBTC is the token used to [pay for the execution](/concepts/rbtc/gas/) of transactions in Rootstock. You can [convert BTC into RBTC](conversion.md) by sending BTC through the [Powpeg](/concepts/powpeg/) (both in Testnet and Mainnet), or by using the [faucet in Testnet](https://faucet.rootstock.io/), or via decentralized exchanges.

:::info[Additional Faucet Options (Please note these faucets may have daily limits)]

* Use [Thirdweb Faucet](https://thirdweb.com/rootstock-testnet): This faucet offers a convenient way to get free test RBTC tokens for development and testing. Its max daily token allocation is `0.01` tRBTC.
* Use [Blast Faucet](https://blastapi.io/faucets/rootstock-testnet): This faucet offers a convenient way to get free test RBTC tokens for development and testing. It has a higher max daily token allocation of `0.1` tRBTC.

:::

See [supported wallets](/dev-tools/wallets/).

<Button href="https://rootstock.io/rbtc/#get-rbtc">Get RBTC</Button>
Expand Down
1 change: 0 additions & 1 deletion docs/02-developers/02-requirements/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,6 @@ This guide provides clear instructions for developers on the supported Solidity
<Step title="Software Requirements:">



Set up the necessary software for a seamless development experience:

- **Solidity Version:**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,13 @@ This is currently zero, which means that we cannot send any transactions to the

Now you should have a balance of tRBTC, and you will be able to send transactions on the Rootstock Testnet!

:::info[Additional Faucet Options (Please note these faucets may have daily limits)]

* Use [Thirdweb Faucet](https://thirdweb.com/rootstock-testnet): This faucet offers a convenient way to get free test RBTC tokens for development and testing. Its max daily token allocation is `0.01` tRBTC.
* Use [Blast Faucet](https://blastapi.io/faucets/rootstock-testnet): This faucet offers a convenient way to get free test RBTC tokens for development and testing. It has a higher max daily token allocation of `0.1` tRBTC.

:::

## Configure Custom Token for tRIF

The Rootstock Infrastructure Framework (RIF) includes multiple services for decentralised applications.
Expand Down
2 changes: 1 addition & 1 deletion docs/02-developers/04-quickstart/ape.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ If you do not want to see your mnemonic, select `n`. Alternatively, use the `--h

:::warning[Warning]

Don't forget to add funds to the account generated. To get tRBTC, use the [Rootstock Faucet](https://faucet.rootstock.io/).
Don't forget to add funds to the account generated. To get tRBTC, use the [Rootstock Faucet](https://faucet.rootstock.io/). Additional faucet options include; [Thirdweb](https://thirdweb.com/rootstock-testnet) and [Blast](https://blastapi.io/faucets/rootstock-testnet) Faucets.
To import an existing account check [Importing Existing Accounts](https://docs.apeworx.io/ape/stable/userguides/accounts.html#importing-existing-accounts) documentation.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -75,4 +75,4 @@ To configure your `rskMainnet` and `rskTestnet` private keys, you'll need to upd
- Mainnet
- You'll need RBTC, which you can obtain from an exchange. See [Get RBTC using Exchanges](https://rootstock.io/rbtc/).
- Testnet
- You can get tRBTC from the [Rootstock Faucet](https://faucet.rootstock.io/).
- You can get tRBTC from the [Rootstock Faucet](https://faucet.rootstock.io/). Additional faucet options include; [Thirdweb](https://thirdweb.com/rootstock-testnet) and [Blast](https://blastapi.io/faucets/rootstock-testnet) Faucets.
2 changes: 1 addition & 1 deletion docs/02-developers/06-integrate/01-rif-relay/deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ After deployment, you'll see a summary of the deployed contracts. This summary i
The deployment summary shows two sets of Smart Wallets, each paired with its verifiers. This is because the verifier is used for both deployment and transaction validation. For testing purposes, the focus will be on using these Smart Wallet Contracts.

#### Testnet
1. Ensure your account is funded. You can get funds from the [tRBTC Faucet](https://faucet.rootstock.io/).
1. Ensure your account is funded. You can get funds from the [tRBTC Faucet](https://faucet.rootstock.io/). Additional faucet options include; [Thirdweb](https://thirdweb.com/rootstock-testnet) and [Blast](https://blastapi.io/faucets/rootstock-testnet) Faucets.
2. Deploy on Testnet:
```bash
npx hardhat deploy --network testnet
Expand Down
2 changes: 1 addition & 1 deletion docs/03-node-operators/08-public-nodes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ and in accordance with the bitcoiners' maxim: **Don't trust. Verify.**

:::info[RPC Node Providers]
The Rootstock public nodes do not expose WebSockets, they are `HTTP` only.
To work around this, you may either [run your own Rootstock node](/node-operators/setup/node-runner/), or use the [Rootstock RPC API](/developers/rpc-api/rootstock/setup/) or use a third-party node provider, such as [Getblock](https://getblock.io/nodes/rsk/), [NowNodes](https://nownodes.io/nodes/rsk) or [dRPC](https://drpc.org/chainlist/rootstock?utm_source=docs&utm_medium=rootstock).
To work around this, you may either [run your own Rootstock node](/node-operators/setup/node-runner/), or use the [Rootstock RPC API](/developers/rpc-api/rootstock/setup/) or use a third-party node provider, such as [Getblock](https://getblock.io/nodes/rsk/), [NowNodes](https://nownodes.io/nodes/rsk), [dRPC](https://drpc.org/chainlist/rootstock?utm_source=docs&utm_medium=rootstock) or [Blast API](https://blastapi.io/).
:::

## Testnet
Expand Down
2 changes: 1 addition & 1 deletion docs/04-resources/06-guides/powpeg-app/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ See a list of terms about/related to the PowPeg App and their meanings.
<Accordion.Item eventKey="15">
<Accordion.Header as="h3">Testnet</Accordion.Header>
<Accordion.Body>
- This is a testing network used for testing and development purposes, assets on the Testnet have zero value, funds used in this network are called Test tokens (tRBTC), they can be gotten through a faucet that dispenses tokens. These tokens are utility tokens that are required to operate certain dApps. Developers of those dApps also need to test them on the Testnet, and hence these are provided as a convenience for them. The Rootstock network provides a cryptocurrency faucet. The tRBTC faucet provides the cryptocurrency required to pay for gas fees on the Rootstock Testnet. See how to get tRBTC using the [Rootstock Faucet](https://faucet.rootstock.io/).
- This is a testing network used for testing and development purposes, assets on the Testnet have zero value, funds used in this network are called Test tokens (tRBTC), they can be gotten through a faucet that dispenses tokens. These tokens are utility tokens that are required to operate certain dApps. Developers of those dApps also need to test them on the Testnet, and hence these are provided as a convenience for them. The Rootstock network provides a cryptocurrency faucet. The tRBTC faucet provides the cryptocurrency required to pay for gas fees on the Rootstock Testnet. See how to get tRBTC using the [Rootstock Faucet](https://faucet.rootstock.io/). Additional faucet options include; [Thirdweb](https://thirdweb.com/rootstock-testnet) and [Blast](https://blastapi.io/faucets/rootstock-testnet) Faucets.
</Accordion.Body>
</Accordion.Item>
<Accordion.Item eventKey="16">
Expand Down
2 changes: 2 additions & 0 deletions docs/04-resources/06-guides/powpeg-app/pegin/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,4 +38,6 @@ We will do the following:
* PowPeg App frontend [repo](https://github.com/rsksmart/2wp-app)
* PowPeg App backend [repo](https://github.com/rsksmart/2wp-api)
* [Rootstock Testnet Faucet](https://faucet.rootstock.io/)
* [Thirdweb Faucet](https://thirdweb.com/rootstock-testnet)
* [Blast Faucet](https://blastapi.io/faucets/rootstock-testnet)
* [Design architecture](/resources/guides/powpeg-app/advanced-operations/design-architecture/)
2 changes: 2 additions & 0 deletions docs/04-resources/06-guides/powpeg-app/pegout/ledger.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,4 +75,6 @@ Step 14: After finish the pegout transaction creation, click here to see how to
* PowPeg App frontend [repo](https://github.com/rsksmart/2wp-app)
* PowPeg App backend [repo](https://github.com/rsksmart/2wp-api)
* [Rootstock Testnet Faucet](https://faucet.rootstock.io/)
* [Thirdweb Faucet](https://thirdweb.com/rootstock-testnet)
* [Blast Faucet](https://blastapi.io/faucets/rootstock-testnet)
* [Design architecture](/resources/guides/powpeg-app/advanced-operations/design-architecture/)
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,6 @@ You may encounter the following errors when trying out the application:
* PowPeg App frontend [repo](https://github.com/rsksmart/2wp-app)
* PowPeg App backend [repo](https://github.com/rsksmart/2wp-api)
* [Rootstock Testnet Faucet](https://faucet.rootstock.io/)
* [Thirdweb Faucet](https://thirdweb.com/rootstock-testnet)
* [Blast Faucet](https://blastapi.io/faucets/rootstock-testnet)
* [Design architecture](/resources/guides/powpeg-app/advanced-operations/design-architecture/)
2 changes: 2 additions & 0 deletions docs/04-resources/06-guides/tokenbridge/contractaddresses.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,8 @@ See the [list of ABIs used](https://github.com/rsksmart/tokenbridge/tree/master/
- [stats.testnet.rootstock.io](https://stats.testnet.rootstock.io/)
- [faucet.rootstock.io](https://faucet.rootstock.io/)
- [faucet.rifos.org](https://faucet.rifos.org/)
- [Thirdweb Faucet](https://thirdweb.com/rootstock-testnet)
- [Blast Faucet](https://blastapi.io/faucets/rootstock-testnet)
- Sepolia (Ethereum Testnet), Explorer and Faucet
- [sepolia.etherscan.io](https://sepolia.etherscan.io/)
- [alchemy.com/faucets/ethereum-sepolia](https://www.alchemy.com/faucets/ethereum-sepolia)
Expand Down
1 change: 1 addition & 0 deletions docs/04-resources/07-hackathon/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,7 @@ These tools will make it easy for you to build on Rootstock:
- **[Web3.py](/developers/quickstart/web3-python/)**: JavaScript and Python libraries for interacting with the Ethereum blockchain.
- **[Rootstock Explorer](https://explorer.testnet.rootstock.io/)**: A blockchain explorer to view transaction details on the Rootstock network.
- **[RPC API](/developers/rpc-api/)**: The RPC API provides a seamless and intuitive web interface for developers to interact with Rootstock nodes via JSON-RPC methods.
- **[Faucets](/dev-tools/additional-tools/#faucets)**: Get test RBTC tokens for development and testing.

Explore the [full list of tools and libraries](/dev-tools/) available on Rootstock.

Expand Down
6 changes: 4 additions & 2 deletions docs/05-dev-tools/additional-tools/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 13
sidebar_position: 14
sidebar_label: General Tools
title: General Tools
description: "General tools to build on Rootstock"
Expand All @@ -8,8 +8,10 @@ tags: [hardhat, quick start, developer tools, rsk, rootstock, ethereum, dApps, s

## Faucets

* [Rootstock Faucet](https://faucet.rootstock.io/): Get free RBTC testnet tokens for development and testing.
* [Rootstock Faucet](https://faucet.rootstock.io/): Get free test RBTC tokens for development and testing.
* [RIF Testnet Faucet](https://faucet.rifos.org/): Obtain free RIF testnet tokens to explore the RIF ecosystem.
* [Thirdweb Faucet](https://thirdweb.com/rootstock-testnet): Get free test RBTC tokens for development and testing.
* [Blast Faucet](https://blastapi.io/faucets/rootstock-testnet): Get free test RBTC tokens for development and testing.

## Gas Fees
* [Rootstock Gas Station](https://rskgasstation.info/?AspxAutoDetectCookieSupport=1): Estimate gas fees for your transactions on the Rootstock network.
Expand Down
27 changes: 27 additions & 0 deletions docs/05-dev-tools/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,6 +131,15 @@ description: "Explore a curated selection of smart contract development tools an
linkTitle="Make First API Call"
description="dRPC provides access to a distributed network of node providers."
/>
<FilterItem
value="rpc"
title="Blast API"
subtitle="json rpc"
color="orange"
linkHref="https://blastapi.io/"
linkTitle="Make First API Call"
description="Blast API is a Blockchain-optimized cloud infrastructure for low-latency, cost-effective RPC services."
/>
<FilterItem
value="wallet, sc"
title="MetaMask"
Expand Down Expand Up @@ -329,6 +338,24 @@ description: "Explore a curated selection of smart contract development tools an
linkTitle="Get tRIF"
description="Get tRIF on the RIF Testnet Faucet"
/>
<FilterItem
value="faucet"
title="Blast Faucet"
subtitle="faucets"
color="orange"
linkHref="https://blastapi.io/faucets/rootstock-testnet"
linkTitle="Get tRBTC"
description="This faucet offers a convenient way to get free test RBTC tokens for development and testing. It has a higher max daily token allocation of `0.1` tRBTC."
/>
<FilterItem
value="faucet"
title="Thirdweb Faucet"
subtitle="faucets"
color="orange"
linkHref="https://thirdweb.com/rootstock-testnet"
linkTitle="Get tRBTC"
description="This faucet offers a convenient way to get free test RBTC tokens for development and testing. Its max daily token allocation is `0.01` tRBTC."
/>
<FilterItem
value="library, sc"
title="Ethers.js"
Expand Down
36 changes: 36 additions & 0 deletions docs/05-dev-tools/node-rpc/blast-api.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
sidebar_position: 6
title: Blast API
sidebar_label: Blast API
tags: [rsk, rootstock, resources, tutorials, setup, dApps, protocol, Blast API]
description: "Remote Procedure Call (RPC) is a protocol that allows a program to execute procedures (functions) on a remote server as if they were local calls."
---

Blast API is a Blockchain-optimized cloud infrastructure for low-latency, cost-effective RPC services on Rootstock.

## **Getting Started with Blast API**

<Steps>
<Step title="Sign Up and Get an API Key">
- Create an account at [Blast API](https://blastapi.io/login).
- Generate your API key from the dashboard.

</Step>
<Step title="Make Example cURL Request to get eth_blockNumber">
Here’s a sample request to get eth_blockNumber:
```curl
curl -X POST https://rootstock-mainnet.public.blastapi.io -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":0,"method":"eth_blockNumber"}'
```

Response:
```curl
{
"jsonrpc": "2.0",
"id": 0,
"result": "0x6b04c8"
}
```
</Step>
</Steps>

<Button href="https://blastapi.io/chains/rootstock">Get Free API</Button>
12 changes: 10 additions & 2 deletions docs/05-dev-tools/node-rpc/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Imagine a vast library filled with information about everything happening on the
## How Node Providers Work

* Full Nodes: Node providers operate by running full nodes on the Rootstock blockchain. These full nodes download and store the complete history of the blockchain, enabling them to verify transactions and maintain a consistent view of the network. To interact with these full nodes, developers and applications utilize a remote procedure call (RPC) mechanism, specifically the JSON-RPC protocol. This protocol allows remote communication with the node, enabling the submission of requests and the receipt of responses.
* API Access: Node providers like the Rootstock RPC API, Alchemy, GetBlock, NOWNodes, dRPC, etc offer an interface (API) that developers can use to communicate with these nodes and request specific data. This eliminates the need for developers to download the entire blockchain themselves, saving time and resources.
* API Access: Node providers like the Rootstock RPC API, Alchemy, GetBlock, NOWNodes, dRPC, and Blast API etc offer an interface (API) that developers can use to communicate with these nodes and request specific data. This eliminates the need for developers to download the entire blockchain themselves, saving time and resources.

## RPC Node Providers on Rootstock

Expand Down Expand Up @@ -54,14 +54,22 @@ Here you can find a list of rpc node providers on Rootstock.
linkHref="https://nownodes.io/nodes/rsk"
linkTitle="Make First API Call"
/>
<CardsGridItem
<CardsGridItem
title="dRPC"
subtitle="node-rpc"
color="cyan"
description="dRPC provides access to a distributed network of node providers."
linkHref="https://drpc.org/chainlist/rootstock?utm_source=docs&utm_medium=rootstock"
linkTitle="Make First API Call"
/>
<CardsGridItem
title="Blast API"
subtitle="node-rpc"
color="cyan"
description="Blast API is a Blockchain-optimized cloud infrastructure for low-latency, cost-effective RPC services on Rootstock."
linkHref="/dev-tools/node-rpc/blast-api/"
linkTitle="Make First API Call"
/>
</CardsGrid>


4 changes: 2 additions & 2 deletions docs/05-dev-tools/node-rpc/nownodes.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,12 +63,12 @@ Use the following base URLs for API requests:

To learn more about the NowNodes connection with Rootstock click the button below:

<Button href="https://nownodes.io/nodes/rsk" align="left">Rootstock dRPC Website</Button>
<Button href="https://nownodes.io/nodes/rsk" align="left">NOWNode Website</Button>

:::

#### REST: Retrieve account balance on Bitcoin
```
```bash
GET https://btc.nownodes.io/v1/balance/your-address?api_key=YOUR_API_KEY
```

Expand Down
7 changes: 3 additions & 4 deletions docs/05-dev-tools/node-rpc/rpc-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,20 @@
sidebar_position: 5
title: RPC API
sidebar_label: RPC API
tags: [rsk, rootstock, resources, tutorials, setup, dApps, protocol, RPC, API, ]
tags: [rsk, rootstock, resources, tutorials, setup, dApps, protocol, RPC API]
description: "Remote Procedure Call (RPC) is a protocol that allows a program to execute procedures (functions) on a remote server as if they were local calls."
---

Remote Procedure Call (RPC) is a protocol that allows a program to execute procedures (functions) on a remote server as if they were local calls. This eliminates the need for developers to handle low-level network communication.

### How Our API Works
## How Rootstock RPC API Works
Rootstock RPC API uses the JSON-RPC protocol, a lightweight, text-based standard for defining procedures and their parameters. This makes it easy to communicate with the API using JSON-formatted requests and receive structured responses.

### Use Cases
## Use Cases
- Building integrations for your product or service.
- Automating workflows with server-side commands.
- Extending your application’s capabilities with remote functions.


## **JSON-RPC Overview**

### What is JSON-RPC?
Expand Down
8 changes: 7 additions & 1 deletion docs/05-dev-tools/user-onboarding/index.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,10 @@
# User Onboarding
---
sidebar_position: 13
sidebar_label: User Onboarding
title: User Onboarding
description: "User Onboarding tools to build on Rootstock"
tags: [user onboarding, wallets, developer tools, rsk, rootstock, ethereum, dApps, smart contracts]
---

Web3 onboarding often faces challenges due to complex wallet setups, unfamiliarity with blockchain concepts, and intimidating security practices. To drive mainstream adoption, it’s crucial to offer intuitive solutions that reduce friction while maintaining security. Providing well thought out end-to-end wallet interaction flows is a key approach to make Web3 more accessible for everyday users.

Expand Down

0 comments on commit f23e3c4

Please sign in to comment.