Skip to content

Commit 67632af

Browse files
authored
Merge pull request #106 from blinklabs-io/chore/docs-readme-timeout
chore(docs): document binary releases and node timeouts in readme
2 parents f895816 + c492a83 commit 67632af

File tree

1 file changed

+18
-4
lines changed

1 file changed

+18
-4
lines changed

README.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,24 +7,30 @@ payload body and submits it to a Cardano full node using the Ouroboros
77
LocalTxSubmission Node-to-Client (NtC) protocol.
88

99
## Usage
10+
1011
The recommended method of using this application is via the published
11-
container images.
12+
container images, coupled with Blink Labs container images for the Cardano
13+
Node.
1214

1315
```
14-
docker run -p 8090 ghcr.io/blinklabs-io/tx-submit-api
16+
docker run -p 8090:8090 ghcr.io/blinklabs-io/tx-submit-api
1517
```
1618

17-
Binaries can be executed directly.
19+
Binaries can be executed directly and are available from
20+
[Releases](https://github.com/blinklabs-io/tx-submit-api/releases).
1821

1922
```
2023
./tx-submit-api
2124
```
2225

2326
### Configuration
27+
2428
Configuration can be done using either a `config.yaml` file or setting
25-
environment variables. Our recommendation is environment variables.
29+
environment variables. Our recommendation is environment variables to adhere
30+
to the 12-factor application philisophy.
2631

2732
#### Environment variables
33+
2834
Configuration via environment variables can be broken into two sets of
2935
variables. The first set controls the behavior of the application, while the
3036
second set controls the connection to the Cardano node instance.
@@ -35,6 +41,7 @@ Application configuration:
3541
- `API_LISTEN_PORT` - Port to bind for API calls (default: 8090)
3642
- `DEBUG_ADDRESS` - Address to bind for pprof debugging (default: localhost)
3743
- `DEBUG_PORT` - Port to bind for pprof debugging, disabled if 0 (default: 0)
44+
- `LOGGING_HEALTHCHECKS` - Log requests to `/healthcheck` endpoint (default: false)
3845
- `LOGGING_LEVEL` - Logging level for log output (default: info)
3946
- `METRICS_LISTEN_ADDRESS` - Address to bind for Prometheus format metrics, all
4047
addresses if empty (default: empty)
@@ -66,6 +73,8 @@ Cardano node configuration:
6673
(default: unset)
6774
- `CARDANO_NODE_SOCKET_TCP_PORT` - Port to Cardano node NtC via TCP (default:
6875
unset)
76+
- `CARDANO_NODE_SOCKET_TIMEOUT` - Sets a timeout in seconds for waiting on
77+
requests to the Cardano node (default: 30)
6978

7079
### Connecting to a cardano-node
7180

@@ -128,6 +137,11 @@ curl -X POST \
128137

129138
There is a Makefile to provide some simple helpers.
130139

140+
Run from checkout:
141+
```
142+
go run .
143+
```
144+
131145
Create a binary:
132146
```
133147
make

0 commit comments

Comments
 (0)