@@ -7,24 +7,30 @@ payload body and submits it to a Cardano full node using the Ouroboros
77LocalTxSubmission Node-to-Client (NtC) protocol.
88
99## Usage
10+
1011The 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+
2428Configuration 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+
2834Configuration via environment variables can be broken into two sets of
2935variables. The first set controls the behavior of the application, while the
3036second 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
129138There is a Makefile to provide some simple helpers.
130139
140+ Run from checkout:
141+ ```
142+ go run .
143+ ```
144+
131145Create a binary:
132146```
133147make
0 commit comments