37 lines
1.7 KiB
Markdown
37 lines
1.7 KiB
Markdown
# Getting Started
|
|
|
|
To start a REST server, we need to specify the following parameters:
|
|
|
|
| Parameter | Type | Default | Required | Description |
|
|
| ----------- | --------- | ----------------------- | -------- | ---------------------------------------------------- |
|
|
| chain-id | string | null | true | chain id of the full node to connect |
|
|
| node | URL | "tcp://localhost:46657" | true | address of the full node to connect |
|
|
| laddr | URL | "tcp://localhost:1317" | true | address to run the rest server on |
|
|
| trust-node | bool | "false" | true | Whether this LCD is connected to a trusted full node |
|
|
| trust-store | DIRECTORY | "$HOME/.lcd" | false | directory for save checkpoints and validator sets |
|
|
|
|
For example::
|
|
|
|
```bash
|
|
gaiacli rest-server --chain-id=test \
|
|
--laddr=tcp://localhost:1317 \
|
|
--node tcp://localhost:26657 \
|
|
--trust-node=false
|
|
```
|
|
|
|
The server listens on HTTP by default. You can enable the secure layer by adding the `--tls` flag.
|
|
By default a self-signed certificate will be generated and its fingerprint printed out. You can
|
|
configure the server to use a SSL certificate by passing the certificate and key files via the
|
|
`--ssl-certfile` and `--ssl-keyfile` flags:
|
|
|
|
```bash
|
|
gaiacli rest-server --chain-id=test \
|
|
--laddr=tcp://localhost:1317 \
|
|
--node tcp://localhost:26657 \
|
|
--trust-node=false \
|
|
--tls \
|
|
--ssl-certfile=mycert.pem --ssl-keyfile=mykey.key
|
|
```
|
|
|
|
For more information about the Gaia-Lite RPC, see the [swagger documentation](https://cosmos.network/rpc/)
|