|
1 |
| -# Vue 3 + TypeScript + Vite |
2 |
| - |
3 |
| -## ⚙️ Development |
4 |
| - |
5 |
| -Install latest version `pnpm` and restart your terminal if necessary. |
6 |
| - |
7 |
| -### Install |
8 |
| - |
9 |
| -Install all packages in the repository. |
10 |
| - |
11 |
| -``` |
12 |
| -pnpm i |
13 |
| -``` |
14 |
| - |
15 |
| -### Dev |
16 |
| - |
17 |
| -``` |
18 |
| -pnpm dev |
| 1 | +# Gno Faucet Hub |
| 2 | +The Gno Faucet Hub serves as a collective access point where developers can obtain |
| 3 | +testnet coins to test and develop applications on a variety of Gno testnets. |
| 4 | + |
| 5 | +The Gno Faucet Hub deployment can be found [here](https://faucet.gnoteam.com). |
| 6 | + |
| 7 | +## Adding your faucet to the Hub |
| 8 | + |
| 9 | +### Running a faucet |
| 10 | +The Faucet Hub works with TM2 Faucets, or faucets using TM2 Faucets as a base. |
| 11 | +To set up a TM2 Faucet, check out the setup guide in the |
| 12 | +[TM2 Faucet repo](https://github.com/gnolang/faucet). |
| 13 | + |
| 14 | +### Setting up reCaptcha |
| 15 | +To prevent spam and abuse of the faucets, and subsequently the Hub itself, |
| 16 | +it is strongly advised for each faucet on the Hub to come with a |
| 17 | +[reCaptcha v2](https://developers.google.com/recaptcha/docs/display) set up. |
| 18 | + |
| 19 | +To set up a reCaptcha for your faucet, check out the [reCaptcha Developer |
| 20 | +guide](https://developers.google.com/recaptcha). Once you have completed setting it up, you should also enable the |
| 21 | +Faucet Hub domain (https://faucet.gnoteam.com) in the reCaptcha dashboard. With |
| 22 | +this you will be able to use the site key to add your faucet in the Hub configuration. |
| 23 | + |
| 24 | +### Adding your faucet to the Hub |
| 25 | +After setting up your faucet and obtaining a reCaptcha keypair, adding your faucet |
| 26 | +to the Hub is as simple as providing a PR with a JSON config to this repo. |
| 27 | + |
| 28 | +To add your faucet to the Hub, you need to provide your faucet configuration |
| 29 | +information in `src/data/faucets.json`. This includes the name of the network |
| 30 | +the faucet is serving on, the network chain ID, drip options for the faucet (in |
| 31 | +GNOT), the faucet URL, and the recaptcha site key. |
| 32 | + |
| 33 | +```json |
| 34 | +{ |
| 35 | + "name": "Gno Portal Loop", |
| 36 | + "chain_id": "portal-loop", |
| 37 | + "amounts": [1, 5, 10], |
| 38 | + "url": "https://faucet-api.portal.gnoteam.com", |
| 39 | + "recaptcha": "6Ldp0pgpAAAAANZxTw4oy4XkOKhhkmpDl8Yoq6uw" |
| 40 | +} |
19 | 41 | ```
|
20 | 42 |
|
21 |
| - |
22 |
| -## Recommended IDE Setup |
23 |
| - |
24 |
| -- [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin). |
25 |
| - |
26 |
| -## Type Support For `.vue` Imports in TS |
27 |
| - |
28 |
| -TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin) to make the TypeScript language service aware of `.vue` types. |
29 |
| - |
30 |
| -If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a [Take Over Mode](https://github.com/johnsoncodehk/volar/discussions/471#discussioncomment-1361669) that is more performant. You can enable it by the following steps: |
31 |
| - |
32 |
| -1. Disable the built-in TypeScript Extension |
33 |
| - 1. Run `Extensions: Show Built-in Extensions` from VSCode's command palette |
34 |
| - 2. Find `TypeScript and JavaScript Language Features`, right click and select `Disable (Workspace)` |
35 |
| -2. Reload the VSCode window by running `Developer: Reload Window` from the command palette. |
| 43 | +You can find an example PR [here](https://github.com/gnolang/faucet-hub/pull/16). |
0 commit comments