NAME

dogeutils - command-line utility to work with Dogecoin Core nodes

SYNOPSIS

  dogeutils setlabel <address> <label name>
  dogeutils getreceivedbylabel <label name>

COMMANDS

The Dogecoin Core provides several useful RPC features, but they're often building blocks and sometimes incomplete. This program (and the associated libraries) allow you to wrap, extend, and modify those features with your own code.

For example, the current Dogecoin Core releases (1.14.x series) do not provide mechanisms to get, set, or query address labels.

If you set up and run dogeutils (this file) correctly, you can fix that.

Authentication and Authorization

This code expects you to have configured a running node with authentication. See the rpcuser documentation for more information.

https://github.com/dogecoin/dogecoin/tree/master/share/rpcuser

Create a JSON file named auth.json in the appropriate configuration directory (run dogeutils --confdir to see where). This file should contain a JSON object where the keys are usernames and the values are passwords.

Set the DOGEUTILS_USER to the username you want to use to authenticate. For example:

  $ DOGEUTILS_USER=lisasimpson dogeutils getreceivedbylabel 'Saxophone Lesson Fund'

Limitations

Currently this expects that your node is running on localhost on port 22555. This will be configurable in future versions.

Available Commands

This suite supports a few commands right now:

• setlabel

  Given a Dogecoin address and a label, associates the label with this address. Yes, this matches the Bitcoin RPC method. That's no accident.

• getreceivedbylabel

  Given a label corresponding to a Dogecoin address (already set with setlabel), returns the JSON from the getreceivedbyaddress RPC call.

• decodetransaction

  Given a transaction hash, decodes the transaction. Note that this transaction must be in your wallet or you must have txindex enabled on your Core node.

SEE ALSO

Finance::Dogecoin::Utils::ProxyActions

Finance::Dogecoin::Utils::NodeRPC

AUTHOR

chromatic