xmrstuff / monero-nats-publisher

Small CLI that publishes Monero transactions and blocks to NATS Streaming. It's intended to be passed as --tx-notify arg to Monero Wallet RPC, or --block-notify to Monero Daemon

Monero NATS Publisher CLI

CLI meant to be passed as --tx-notify argument to Monero Wallet, or --block-notify argument to Monero Daemon.

It fetches extra context about the tx from the Wallet RPC, or the block from the Monero Daemon RPC, and then pushes it to NATS

It's an early work in progress

Compiling

• Statically (production ready)

GOOS=linux GOARCH=amd64 go build -a -tags netgo -ldflags '-w -extldflags "-static"' -o publisher

• Dynamically (dev/testing)

go build -o publisher

• Run tests

go test -v

Usage

Run ./publisher help for detailed help.

It implements 3 CLI commands:

• ./publisher ping: Checks that it can connect to the NATS server properly
• ./publisher tx <txid>: Gathers extra context about the Tx and publishes it to NATS
• ./publisher block <blockHash>: Gathers extra context about the Block and publishes it to NATS

It takes the following optional flags:

• --wallet: URL to the Monero Wallet RPC
• --daemon: URL to the Monero Daemon RPC
• --nats: URL to the NATS Streaming server
• --ignore-below-height: Ignore Blocks and Transactions whose block height is below the configured value. Where ignoring means doing as little work as possible: Txs won't be published to nats; Blocks' ancestors won't be fetched, and then they won't be published to NATS
• --ancestors: Max number of ancestor blocks' hashes to include with every published block