io.nem.sdk.infrastructure

Class Listener

java.lang.Object

io.nem.sdk.infrastructure.Listener

public class Listener
extends java.lang.Object

Listener

Since:

1.0

Constructor Summary

Constructors

Constructor and Description
Listener(java.lang.String url)

Method Summary

Modifier and Type	Method and Description
io.reactivex.Observable<AggregateTransaction>	aggregateBondedAdded(Address address) Return an observable of AggregateTransaction for specific address.
io.reactivex.Observable<java.lang.String>	aggregateBondedRemoved(Address address) Returns an observable stream of Transaction Hashes for specific address.
void	close() Close webSocket connection
io.reactivex.Observable<Transaction>	confirmed(Address address) Returns an observable stream of Transaction for a specific address.
io.reactivex.Observable<CosignatureSignedTransaction>	cosignatureAdded(Address address) Returns an observable stream of CosignatureSignedTransaction for specific address.
java.lang.String	getUID() // TODO: should we remove it?
io.reactivex.Observable<BlockInfo>	newBlock() Returns an observable stream of BlockInfo.
java.util.concurrent.CompletableFuture<java.lang.Void>	open()
io.reactivex.Observable<TransactionStatusError>	status(Address address) Returns an observable stream of TransactionStatusError for specific address.
io.reactivex.Observable<Transaction>	unconfirmedAdded(Address address) Returns an observable stream of Transaction for a specific address.
io.reactivex.Observable<java.lang.String>	unconfirmedRemoved(Address address) Returns an observable stream of Transaction Hashes for specific address.

Methods inherited from class java.lang.Object

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

Constructor Detail

Listener

public Listener(java.lang.String url)
         throws java.net.MalformedURLException

Parameters:

url - nis host

Throws:

java.net.MalformedURLException

Method Detail

open

public java.util.concurrent.CompletableFuture<java.lang.Void> open()

Returns:

a CompletableFuture that resolves when the websocket connection is opened

getUID

public java.lang.String getUID()

// TODO: should we remove it?

Returns:

the UID connected to

close

public void close()

Close webSocket connection

newBlock

public io.reactivex.Observable<BlockInfo> newBlock()

Returns an observable stream of BlockInfo. Each time a new Block is added into the blockchain, it emits a new BlockInfo in the event stream.

Returns:

an observable stream of BlockInfo

confirmed

public io.reactivex.Observable<Transaction> confirmed(Address address)

Returns an observable stream of Transaction for a specific address. Each time a transaction is in confirmed state an it involves the address, it emits a new Transaction in the event stream.

Parameters:

address - address we listen when a transaction is in confirmed state

Returns:

an observable stream of Transaction with state confirmed

unconfirmedAdded

public io.reactivex.Observable<Transaction> unconfirmedAdded(Address address)

Returns an observable stream of Transaction for a specific address. Each time a transaction is in unconfirmed state an it involves the address, it emits a new Transaction in the event stream.

Parameters:

address - address we listen when a transaction is in unconfirmed state

Returns:

an observable stream of Transaction with state unconfirmed

unconfirmedRemoved

public io.reactivex.Observable<java.lang.String> unconfirmedRemoved(Address address)

Returns an observable stream of Transaction Hashes for specific address. Each time a transaction with state unconfirmed changes its state, it emits a new message with the transaction hash in the event stream.

Parameters:

address - address we listen when a transaction is removed from unconfirmed state

Returns:

an observable stream of Strings with the transaction hash

aggregateBondedAdded

public io.reactivex.Observable<AggregateTransaction> aggregateBondedAdded(Address address)

Return an observable of AggregateTransaction for specific address. Each time an aggregate bonded transaction is announced, it emits a new AggregateTransaction in the event stream.

Parameters:

address - address we listen when a transaction with missing signatures state

Returns:

an observable stream of AggregateTransaction with missing signatures state

aggregateBondedRemoved

public io.reactivex.Observable<java.lang.String> aggregateBondedRemoved(Address address)

Returns an observable stream of Transaction Hashes for specific address. Each time an aggregate bonded transaction is announced, it emits a new message with the transaction hash in the event stream.

Parameters:

address - address we listen when a transaction is confirmed or rejected

Returns:

an observable stream of Strings with the transaction hash

status

public io.reactivex.Observable<TransactionStatusError> status(Address address)

Returns an observable stream of TransactionStatusError for specific address. Each time a transaction contains an error, it emits a new message with the transaction status error in the event stream.

Parameters:

address - address we listen to be notified when some error happened

Returns:

an observable stream of TransactionStatusError

cosignatureAdded

public io.reactivex.Observable<CosignatureSignedTransaction> cosignatureAdded(Address address)

Returns an observable stream of CosignatureSignedTransaction for specific address. Each time a cosigner signs a transaction the address initialized, it emits a new message with the cosignatory signed transaction in the even stream.

Parameters:

address - address we listen when a cosignatory is added to some transaction address sent

Returns:

an observable stream of CosignatureSignedTransaction