github.com/gnolang/gno@v0.0.0-20240520182011-228e9d0192ce/docs/gno-tooling/cli/faucet/gnofaucet.md (about)

     1  ---
     2  id: gno-tooling-gnofaucet
     3  ---
     4  
     5  # gnofaucet
     6  
     7  `gnofaucet` is a server for distributing GNOT, the gas currency of Gnoland, to specific addresses in a local chain.
     8  Interact with the `gnofaucet` from an address with an empty balance in your locally built testnet to fuel it with GNOT
     9  to pay for transactions.
    10  
    11  ## Run `gnofaucet` Commands
    12  
    13  Enable the faucet using the following command.
    14  
    15  ```bash
    16  gnofaucet serve
    17  ```
    18  
    19  #### **Options**
    20  
    21  | Name                      | Type    | Description                                                                          |
    22  |---------------------------|---------|--------------------------------------------------------------------------------------|
    23  | `chain-id`                | String  | The id of the chain (required).                                                      |
    24  | `gas-wanted`              | Int64   | The maximum amount of gas to use for the transaction (default: `50000`)              |
    25  | `gas-fee`                 | String  | The gas fee to pay for the transaction.                                              |
    26  | `memo`                    | String  | Any descriptive text (default: `""`)                                                 |
    27  | `test-to`                 | String  | Test address (optional)                                                              |
    28  | `send`                    | String  | Coins to send (default: `"1000000ugnot"`).                                           |
    29  | `captcha-secret`          | String  | The secret key for the recaptcha. If empty, the captcha is disabled (default: `""`). |
    30  | `is-behind-proxy`         | Boolean | Uses X-Forwarded-For IP for throttling (default: `false`).                           |
    31  | `insecure-password-stdin` | Boolean | INSECURE! Takes password from stdin (default: `false`).                              |
    32  
    33  ## Example
    34  
    35  ### Step 1. Create an account named `test1` with the test seed phrase below.
    36  
    37  ```bash
    38  gnokey add test1 --recover
    39  ```
    40  
    41  > **Test Seed Phrase:** source bonus chronic canvas draft south burst lottery vacant surface solve popular case indicate
    42  > oppose farm nothing bullet exhibit title speed wink action roast
    43  > **Test Private key:** ea97b9fddb7e6bf6867090a7a819657047949fbb9466d617f940538efd888605
    44  ### **Step 2. Run `gnofaucet`**
    45  
    46  ```bash
    47  gnofaucet serve test1 --chain-id dev --send 500000000ugnot
    48  ```
    49  
    50  ### **Step 3. Receive GNOTs from the faucet**
    51  
    52  To receive funds through the `gnoweb` form GUI, you can request them on:
    53  `http://localhost:8888/faucet` (given `http://localhost:8888/` is the location where `gnoweb` is serving pages).
    54  
    55  Alternatively, you can request funds from the faucet by directly invoking a CURL command:
    56  
    57  ```bash
    58  curl --location --request POST 'http://localhost:5050' \
    59  --header 'Content-Type: application/x-www-form-urlencoded' \
    60  --data-urlencode 'toaddr={address to receive}'
    61  ```