Skip to content

Commit e3f6407

Browse files
authored
feat: add README instructions (#15)
* update readme * add link * rephrase * save * remove deployment link * update intro * update * update * add v2 link * strongly advise captcha * remove keypair, add sitekey * rephrase * public> site * reprhase * rephrase
1 parent e795a97 commit e3f6407

File tree

1 file changed

+41
-33
lines changed

1 file changed

+41
-33
lines changed

README.md

Lines changed: 41 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,43 @@
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+
}
1941
```
2042

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

Comments
 (0)