new file: man-split.md

philemon 2017-11-13 23:01:32 +03:00
commit 0b4dda759b
Signed by untrusted user who does not match committer: mmgen
GPG key ID: 62DBE9E5212F05BE
17 changed files with 65 additions and 15 deletions

@ -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)

@ -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)

@ -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)

@ -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)

@ -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)

@ -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)

@ -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)

47
man-split.md Normal file

@ -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)

@ -91,4 +91,4 @@
Type 'mmgen-tool help <command> for help on a particular command
MMGEN v0.9.5 November 2017 MMGEN-TOOL(1)
MMGEN v0.9.6 November 2017 MMGEN-TOOL(1)

@ -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)

@ -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)

@ -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)

@ -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)

@ -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)

@ -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)

@ -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)

@ -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)