Class MarriedKeyChain

java.lang.Object
org.bitcoinj.wallet.DeterministicKeyChain
org.bitcoinj.wallet.MarriedKeyChain
All Implemented Interfaces:
EncryptableKeyChain, KeyChain

public class MarriedKeyChain extends DeterministicKeyChain

A multi-signature keychain using synchronized HD keys (a.k.a HDM)

This keychain keeps track of following keychains that follow the account key of this keychain. You can get P2SH addresses to receive coins to from this chain. The threshold - sigsRequiredToSpend specifies how many signatures required to spend transactions for this married keychain. This value should not exceed total number of keys involved (one followed key plus number of following keys), otherwise IllegalArgumentException will be thrown.

IMPORTANT: As of Bitcoin Core 0.9 all bare (non-P2SH) multisig transactions which require more than 3 public keys are non-standard and such spends won't be processed by peers with default settings, essentially making such transactions almost nonspendable

This method will throw an IllegalStateException, if the keychain is already married or already has leaf keys issued.