org.bitcoinj.protocols.channels

Class StoredPaymentChannelClientStates

java.lang.Object

org.bitcoinj.protocols.channels.StoredPaymentChannelClientStates

All Implemented Interfaces:

WalletExtension

public class StoredPaymentChannelClientStates
extends Object
implements WalletExtension

This class maintains a set of StoredClientChannels, automatically (re)broadcasting the contract transaction and broadcasting the refund transaction over the given TransactionBroadcaster.

Field Summary

Fields

Modifier and Type	Field and Description
protected ReentrantLock	lock

Constructor Summary

Constructors

Constructor and Description
StoredPaymentChannelClientStates(Wallet containingWallet) Creates a new StoredPaymentChannelClientStates and associates it with the given Wallet Use this constructor if you use WalletAppKit, it will provide the broadcaster for you (no need to call the setter)
StoredPaymentChannelClientStates(Wallet containingWallet, TransactionBroadcaster announcePeerGroup) Creates a new StoredPaymentChannelClientStates and associates it with the given Wallet and TransactionBroadcaster which are used to complete and announce contract and refund transactions.

Method Summary

Modifier and Type	Method and Description
void	deserializeWalletExtension(Wallet containingWallet, byte[] data) Loads the contents of this object from the wallet.
Coin	getBalanceForServer(Sha256Hash id) Returns the outstanding amount of money sent back to us for all channels to this server added together.
org.bitcoinj.protocols.channels.StoredClientChannel	getChannel(Sha256Hash id, Sha256Hash contractHash) Finds a channel with the given id and contract hash and returns it, or returns null.
Multimap<Sha256Hash,org.bitcoinj.protocols.channels.StoredClientChannel>	getChannelMap() Get a copy of all StoredClientChannels
static StoredPaymentChannelClientStates	getFromWallet(Wallet wallet) Returns this extension from the given wallet, or null if no such extension was added.
long	getSecondsUntilExpiry(Sha256Hash id) Returns the number of seconds from now until this servers next channel will expire, or zero if no unexpired channels found.
String	getWalletExtensionID() Returns a Java package/class style name used to disambiguate this extension from others.
boolean	isWalletExtensionMandatory() If this returns true, the mandatory flag is set when the wallet is serialized and attempts to load it without the extension being in the wallet will throw an exception.
byte[]	serializeWalletExtension() Returns bytes that will be saved in the wallet.
void	setTransactionBroadcaster(TransactionBroadcaster transactionBroadcaster) Use this setter if the broadcaster is not available during instantiation and you're not using WalletAppKit.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

lock

protected final ReentrantLock lock

Constructor Detail

StoredPaymentChannelClientStates

public StoredPaymentChannelClientStates(@Nullable
                                        Wallet containingWallet,
                                        TransactionBroadcaster announcePeerGroup)

Creates a new StoredPaymentChannelClientStates and associates it with the given Wallet and TransactionBroadcaster which are used to complete and announce contract and refund transactions.

StoredPaymentChannelClientStates

public StoredPaymentChannelClientStates(@Nullable
                                        Wallet containingWallet)

Creates a new StoredPaymentChannelClientStates and associates it with the given Wallet Use this constructor if you use WalletAppKit, it will provide the broadcaster for you (no need to call the setter)

Method Detail

setTransactionBroadcaster

public final void setTransactionBroadcaster(TransactionBroadcaster transactionBroadcaster)

Use this setter if the broadcaster is not available during instantiation and you're not using WalletAppKit. This setter will let you delay the setting of the broadcaster until the Bitcoin network is ready.

Parameters:

transactionBroadcaster - which is used to complete and announce contract and refund transactions.

getFromWallet

@Nullable
public static StoredPaymentChannelClientStates getFromWallet(Wallet wallet)

Returns this extension from the given wallet, or null if no such extension was added.

getBalanceForServer

public Coin getBalanceForServer(Sha256Hash id)

Returns the outstanding amount of money sent back to us for all channels to this server added together.

getSecondsUntilExpiry

public long getSecondsUntilExpiry(Sha256Hash id)

Returns the number of seconds from now until this servers next channel will expire, or zero if no unexpired channels found.

getChannel

@Nullable
public org.bitcoinj.protocols.channels.StoredClientChannel getChannel(Sha256Hash id,
                                                                                Sha256Hash contractHash)

Finds a channel with the given id and contract hash and returns it, or returns null.

getChannelMap

public Multimap<Sha256Hash,org.bitcoinj.protocols.channels.StoredClientChannel> getChannelMap()

Get a copy of all StoredClientChannels

getWalletExtensionID

public String getWalletExtensionID()

Description copied from interface: WalletExtension

Returns a Java package/class style name used to disambiguate this extension from others.

Specified by:

getWalletExtensionID in interface WalletExtension

isWalletExtensionMandatory

public boolean isWalletExtensionMandatory()

Description copied from interface: WalletExtension

If this returns true, the mandatory flag is set when the wallet is serialized and attempts to load it without the extension being in the wallet will throw an exception. This method should not change its result during the objects lifetime.

Specified by:

isWalletExtensionMandatory in interface WalletExtension

serializeWalletExtension

public byte[] serializeWalletExtension()

Description copied from interface: WalletExtension

Returns bytes that will be saved in the wallet.

Specified by:

serializeWalletExtension in interface WalletExtension

deserializeWalletExtension

public void deserializeWalletExtension(Wallet containingWallet,
                                       byte[] data)
                                throws Exception

Description copied from interface: WalletExtension

Loads the contents of this object from the wallet.

Specified by:

deserializeWalletExtension in interface WalletExtension

Throws:

Exception

toString

public String toString()

Overrides:

toString in class Object