contrib/spendfrom/README.md

   1 ### SpendFrom ###
   2
   3 Use the raw transactions API to send coins received on a particular
   4 address (or addresses).
   5
   6 ### Usage: ###
   7 Depends on [jsonrpc](http://json-rpc.org/).
   8
   9         spendfrom.py --from=FROMADDRESS1[,FROMADDRESS2] --to=TOADDRESS --amount=amount \
  10                      --fee=fee --datadir=/path/to/.bitcoin --testnet --dry_run
  11
  12 With no arguments, outputs a list of amounts associated with addresses.
  13
  14 With arguments, sends coins received by the `FROMADDRESS` addresses to the `TOADDRESS`.
  15
  16 ### Notes ###
  17
  18 - You may explicitly specify how much fee to pay (a fee more than 1% of the amount
  19 will fail,  though, to prevent bitcoin-losing accidents). Spendfrom may fail if
  20 it thinks the transaction would never be confirmed (if the amount being sent is
  21 too small, or if the transaction is too many bytes for the fee).
  22
  23 - If a change output needs to be created, the change will be sent to the last
  24 `FROMADDRESS` (if you specify just one `FROMADDRESS`, change will go back to it).
  25
  26 - If `--datadir` is not specified, the default datadir is used.
  27
  28 - The `--dry_run` option will just create and sign the transaction and print
  29 the transaction data (as hexadecimal), instead of broadcasting it.
  30
  31 - If the transaction is created and broadcast successfully, a transaction id
  32 is printed.
  33
  34 - If this was a tool for end-users and not programmers, it would have much friendlier
  35 error-handling.