diff --git a/MMGen-command-help.md b/MMGen-command-help.md index a046ecb..1ce8ea2 100644 --- a/MMGen-command-help.md +++ b/MMGen-command-help.md @@ -6,5 +6,6 @@ * [mmgen-txcreate](man-txcreate) * [mmgen-txsend](man-txsend) * [mmgen-txsign](man-txsign) +* [mmgen-txdo](man-txdo) * [mmgen-walletchk](man-walletchk) * [mmgen-walletgen](man-walletgen) diff --git a/man-txdo.md b/man-txdo.md new file mode 100644 index 0000000..a7694ab --- /dev/null +++ b/man-txdo.md @@ -0,0 +1,91 @@ + MMGEN-TXDO: Create, sign and send an MMGen transaction + USAGE: mmgen-txdo [opts] ... [change addr] [addr file] ... [seed source] ... + OPTIONS: + -h, --help Print this help message + --longhelp Print help message for long options (common options) + -a, --tx-fee-adj f Adjust transaction fee by factor 'f' (see below) + -b, --brain-params l,p Use seed length 'l' and hash preset 'p' for brainwallet + input + -B, --no-blank Don't blank screen before displaying unspent outputs + -c, --comment-file f Source the transaction's comment from file 'f' + -C, --tx-confs c Desired number of confirmations (default: 3) + -d, --outdir d Specify an alternate directory 'd' for output + -e, --echo-passphrase Print passphrase to screen when typing it + -f, --tx-fee f Transaction fee (default: 0.0003 BTC (but see below)) + -H, --hidden-incog-input-params f,o Read hidden incognito data from file + 'f' at offset 'o' (comma-separated) + -i, --in-fmt f Input is from wallet format 'f' (see FMT CODES below) + -l, --seed-len l Specify wallet seed length of 'l' bits. This option + is required only for brainwallet and incognito inputs + with non-standard (< 256-bit) seed lengths. + -k, --keys-from-file f Provide additional keys for non-MMGen addresses + -K, --key-generator m Use method 'm' for public key generation + Options: 1:python-ecdsa 2:keyconv 3:secp256k1 (default: 3) + -m, --minconf n Minimum number of confirmations required to spend outputs (default: 1) + -M, --mmgen-keys-from-file f Provide keys for MMGen addresses in a key- + address file (output of 'mmgen-keygen'). Permits + online signing without an MMGen seed source. The + key-address file is also used to verify MMGen-to-BTC + mappings, so the user should record its checksum. + -O, --old-incog-fmt Specify old-format incognito input + -p, --hash-preset p Use the scrypt hash parameters defined by preset 'p' + for password hashing (default: '3') + -P, --passwd-file f Get MMGen wallet or bitcoind passphrase from file 'f' + -q, --quiet Suppress warnings; overwrite files without prompting + -v, --verbose Produce more verbose output + -z, --show-hash-presets Show information on available hash presets + + The transaction's outputs are specified on the command line, while its inputs + are chosen from a list of the user's unpent outputs via an interactive menu. + + If the transaction fee is not specified by the user, it will be calculated + using bitcoind's "estimatefee" function for the default (or user-specified) + number of confirmations. If "estimatefee" fails, the global default fee of + 0.0003 BTC will be used. + + Dynamic fees will be multiplied by the value of '--tx-fee-adj', if specified. + + Ages of transactions are approximate based on an average block discovery + interval of 9 minutes. + + All addresses on the command line can be either Bitcoin addresses or MMGen + addresses of the form :. + + To send the value of all inputs (minus TX fee) to a single output, specify + one address with no amount on the command line. + + Transactions may contain both MMGen or non-MMGen input addresses. + + To sign non-MMGen inputs, a bitcoind wallet dump or flat key list is used + as the key source ('--keys-from-file' option). + + To sign MMGen inputs, key data is generated from a seed as with the + mmgen-addrgen and mmgen-keygen commands. Alternatively, a key-address file + may be used (--mmgen-keys-from-file option). + + Multiple wallets or other seed files can be listed on the command line in + any order. If the seeds required to sign the transaction's inputs are not + found in these files (or in the default wallet), the user will be prompted + for seed data interactively. + + To prevent an attacker from crafting transactions with bogus MMGen-to-Bitcoin + address mappings, all outputs to MMGen addresses are verified with a seed + source. Therefore, seed files or a key-address file for all MMGen outputs + must also be supplied on the command line if the data can't be found in the + default wallet. + + Seed source files must have the canonical extensions listed in the 'FileExt' + column below: + + Format FileExt Valid codes + ------ ------- ----------- + Brainwallet .mmbrain mmbrain,brainwallet,brain,bw,b + HexSeedFile .mmhex seedhex,hexseed,hex,mmhex + IncogWallet .mmincog mmincog,incog,icg,i + IncogWalletHex .mmincox mmincox,incox,incog_hex,xincog,ix,xi + IncogWalletHidden None incog_hidden,hincog,ih,hi + Mnemonic .mmwords mmwords,words,mnemonic,mnem,mn,m + SeedFile .mmseed mmseed,seed,s + Wallet .mmdat wallet,w + + MMGEN v0.9.0 December 2016 MMGEN-TXDO(1)