diff --git a/MMGen-command-help.md b/MMGen-command-help.md index f33d349..19307d2 100644 --- a/MMGen-command-help.md +++ b/MMGen-command-help.md @@ -5,6 +5,7 @@ * [mmgen-passchg](man-passchg) * [mmgen-passgen](man-passgen) * [mmgen-regtest](man-regtest) +* [mmgen-split](man-split) * [mmgen-tool](man-tool) * [mmgen-txbump](man-txbump) * [mmgen-txcreate](man-txcreate) diff --git a/man-addrgen.md b/man-addrgen.md index e31686f..419ff39 100644 --- a/man-addrgen.md +++ b/man-addrgen.md @@ -66,4 +66,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-ADDRGEN(1) + MMGEN v0.9.6 November 2017 MMGEN-ADDRGEN(1) diff --git a/man-addrimport.md b/man-addrimport.md index e9c5f6c..92677df 100644 --- a/man-addrimport.md +++ b/man-addrimport.md @@ -17,4 +17,4 @@ The --batch and --rescan options cannot be used together. - MMGEN v0.9.5 November 2017 MMGEN-ADDRIMPORT(1) + MMGEN v0.9.6 November 2017 MMGEN-ADDRIMPORT(1) diff --git a/man-autosign.md b/man-autosign.md index 34618a3..cb35d51 100644 --- a/man-autosign.md +++ b/man-autosign.md @@ -61,4 +61,4 @@ This command is currently available only on Linux-based platforms. - MMGEN v0.9.5 November 2017 MMGEN-AUTOSIGN(1) + MMGEN v0.9.6 November 2017 MMGEN-AUTOSIGN(1) diff --git a/man-keygen.md b/man-keygen.md index 7006f95..d48d6dd 100644 --- a/man-keygen.md +++ b/man-keygen.md @@ -70,4 +70,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-KEYGEN(1) + MMGEN v0.9.6 November 2017 MMGEN-KEYGEN(1) diff --git a/man-passchg.md b/man-passchg.md index f93a495..886847a 100644 --- a/man-passchg.md +++ b/man-passchg.md @@ -43,4 +43,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-PASSCHG(1) + MMGEN v0.9.6 November 2017 MMGEN-PASSCHG(1) diff --git a/man-passgen.md b/man-passgen.md index ee9fb6d..2b55625 100644 --- a/man-passgen.md +++ b/man-passgen.md @@ -78,4 +78,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-PASSGEN(1) + MMGEN v0.9.6 November 2017 MMGEN-PASSGEN(1) diff --git a/man-split.md b/man-split.md new file mode 100644 index 0000000..10bf122 --- /dev/null +++ b/man-split.md @@ -0,0 +1,47 @@ + MMGEN-SPLIT: Split funds in a MMGen wallet after a chain fork using a + timelocked transaction + USAGE: mmgen-split [opts] [output addr1] [output addr2] + OPTIONS: + -h, --help Print this help message + --longhelp Print help message for long options (common options) + -f, --tx-fees f The transaction fees for each chain (comma-separated) + -c, --other-coin c The coin symbol of the other chain (default: B2X) + -B, --no-blank Don't blank screen before displaying unspent outputs + -d, --outdir d Specify an alternate directory 'd' for output + -m, --minconf n Minimum number of confirmations required to spend + outputs (default: 1) + -q, --quiet Suppress warnings; overwrite files without prompting + -r, --rbf Make transaction BIP 125 replaceable (replace-by-fee) + -v, --verbose Produce more verbose output + -y, --yes Answer 'yes' to prompts, suppress non-essential output + -R, --rpc-host2 h Host the other coin daemon is running on (default: none) + -L, --locktime t Lock time (block height or unix seconds) + (default: current block height) + + This command creates two transactions: one (with the timelock) to be broadcast + on the long chain and one on the short chain after a replayable chain fork. + Only MMGen addresses may be spent to. + + The command must be run on the longest chain. The user is reponsible for + ensuring that the current chain is the longest. The other chain is specified + on the command line, or it defaults to the most recent replayable fork of the + current chain. + + For the split to have a reasonable chance of succeeding, the long chain should + be well ahead of the short one (by more than 20 blocks or so) and transactions + should have a good chance of confirming quickly on both chains. For this + larger than normal fees may be required. Fees may be specified on the command + line, or network fee estimation may be used. + + If the split fails (i.e. the long-chain TX is broadcast and confirmed on the + short chain), no funds are lost. A new split attempt can be made with the + long-chain transaction's output as an input for the new split transaction. + This process can be repeated as necessary until the split succeeds. + + IMPORTANT: Timelock replay protection offers NO PROTECTION against reorg + attacks on the majority chain or reorg attacks on the minority chain if the + minority chain is ahead of the timelock. If the reorg'd minority chain is + behind the timelock, protection is contingent on getting the non-timelocked + transaction reconfirmed before the timelock expires. Use at your own risk. + + MMGEN v0.9.6 November 2017 MMGEN-SPLIT(1) diff --git a/man-tool.md b/man-tool.md index e585382..7a51d77 100644 --- a/man-tool.md +++ b/man-tool.md @@ -91,4 +91,4 @@ Type 'mmgen-tool help for help on a particular command - MMGEN v0.9.5 November 2017 MMGEN-TOOL(1) + MMGEN v0.9.6 November 2017 MMGEN-TOOL(1) diff --git a/man-txbump.md b/man-txbump.md index 3f0a9bb..bf0112d 100644 --- a/man-txbump.md +++ b/man-txbump.md @@ -77,4 +77,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-TXBUMP(1) + MMGEN v0.9.6 November 2017 MMGEN-TXBUMP(1) diff --git a/man-txcreate.md b/man-txcreate.md index db70b45..368ecca 100644 --- a/man-txcreate.md +++ b/man-txcreate.md @@ -12,6 +12,7 @@ per byte (an integer followed by 's'). If omitted, fee will be calculated using bitcoind's 'estimatefee' call -i, --info Display unspent outputs and exit + -L, --locktime t Lock time (block height or unix seconds) (default: 0) -m, --minconf n Minimum number of confirmations required to spend outputs (default: 1) -q, --quiet Suppress warnings; overwrite files without prompting @@ -44,4 +45,4 @@ a plain decimal number, or as satoshis per byte, using an integer followed by the letter 's'. - MMGEN v0.9.5 November 2017 MMGEN-TXCREATE(1) + MMGEN v0.9.6 November 2017 MMGEN-TXCREATE(1) diff --git a/man-txdo.md b/man-txdo.md index 97a17d9..eb9d910 100644 --- a/man-txdo.md +++ b/man-txdo.md @@ -25,6 +25,7 @@ -K, --key-generator m Use method 'm' for public key generation Options: 1:python-ecdsa 2:secp256k1 (default: 2) + -L, --locktime t Lock time (block height or unix seconds) (default: 0) -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- @@ -101,4 +102,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-TXDO(1) + MMGEN v0.9.6 November 2017 MMGEN-TXDO(1) diff --git a/man-txsend.md b/man-txsend.md index 23ddf4e..b0ca453 100644 --- a/man-txsend.md +++ b/man-txsend.md @@ -8,4 +8,4 @@ -s, --status Get status of a sent transaction -y, --yes Answer 'yes' to prompts, suppress non-essential output - MMGEN v0.9.5 November 2017 MMGEN-TXSEND(1) + MMGEN v0.9.6 November 2017 MMGEN-TXSEND(1) diff --git a/man-txsign.md b/man-txsign.md index 9e03d7a..64effa6 100644 --- a/man-txsign.md +++ b/man-txsign.md @@ -67,4 +67,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-TXSIGN(1) + MMGEN v0.9.6 November 2017 MMGEN-TXSIGN(1) diff --git a/man-walletchk.md b/man-walletchk.md index 8aa85a3..a88f19a 100644 --- a/man-walletchk.md +++ b/man-walletchk.md @@ -42,4 +42,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-WALLETCHK(1) + MMGEN v0.9.6 November 2017 MMGEN-WALLETCHK(1) diff --git a/man-walletconv.md b/man-walletconv.md index eb32d09..7eaa94e 100644 --- a/man-walletconv.md +++ b/man-walletconv.md @@ -52,4 +52,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-WALLETCONV(1) + MMGEN v0.9.6 November 2017 MMGEN-WALLETCONV(1) diff --git a/man-walletgen.md b/man-walletgen.md index c6285ba..3afbb9f 100644 --- a/man-walletgen.md +++ b/man-walletgen.md @@ -45,4 +45,4 @@ SeedFile .mmseed mmseed,seed,s Wallet .mmdat wallet,w - MMGEN v0.9.5 November 2017 MMGEN-WALLETGEN(1) + MMGEN v0.9.6 November 2017 MMGEN-WALLETGEN(1)