org.hyperledger.fabric.sdk

Class Channel

java.lang.Object

org.hyperledger.fabric.sdk.Channel

All Implemented Interfaces:

Serializable

public class Channel
extends Object
implements Serializable

The class representing a channel with which the client SDK interacts.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Channel.AnchorPeersConfigUpdateResult
static class	Channel.DiscoveryOptions Options for doing service discovery.
static class	Channel.NOfEvents NofEvents may be used with @see TransactionOptions#nOfEvents(NOfEvents) to control how reporting Peer service events and Eventhubs will complete the future acknowledging the transaction has been seen by those Peers.
static class	Channel.PeerOptions Options for the peer.
static class	Channel.SDOPeerDefaultAddition
static interface	Channel.SDOrdererAddition
static interface	Channel.SDOrdererAdditionInfo
static class	Channel.SDOrdererDefaultAddition
static interface	Channel.SDPeerAddition
static interface	Channel.SDPeerAdditionInfo
static class	Channel.ServiceDiscoveryChaincodeCalls Additional metadata used by service discovery to find the endorsements needed.
static class	Channel.TransactionOptions TransactionOptions class can be used to change how the SDK processes the Transaction.

Method Summary

Modifier and Type	Method and Description
Channel	addOrderer(Orderer orderer) Add an Orderer to this channel.
Channel	addPeer(Peer peer) Add a peer to the channel
Channel	addPeer(Peer peer, Channel.PeerOptions peerOptions) Add a peer to the channel
Collection<String>	getBlockListenerHandles()
byte[]	getChannelConfigurationBytes()
byte[]	getChannelConfigurationBytes(User userContext) Channel Configuration bytes.
byte[]	getChannelConfigurationBytes(User userContext, Orderer orderer) Get channel configuration from a specific Orderer
byte[]	getChannelConfigurationBytes(User userContext, Peer peer) Get channel configuration from a specific peer
Channel.AnchorPeersConfigUpdateResult	getConfigUpdateAnchorPeers(Peer peer, User userContext, Collection<String> peersToAdd, Collection<String> peersToRemove) Get a channel configuration update to add or remove peers.
Collection<String>	getDiscoveredChaincodeNames() Collection of discovered chaincode names.
String	getName() Get the channel name
Collection<Orderer>	getOrderers()
Collection<Orderer>	getOrderersForOrganization(String mspid) Get orderers that belong to an organization from the organization's MSPID These values may not be available till after the channel is initialized.
Collection<String>	getOrderersOrganizationMSPIDs() Collection of strings which are the MSPIDs of all the orderer organization added.
Collection<Peer>	getPeers() Get the peers for this channel.
Collection<Peer>	getPeers(EnumSet<Peer.PeerRole> roles) Get the peers for this channel.
Collection<Peer>	getPeersForOrganization(String mspid) Get peers that belong to an organization from the organization's MSPID These values may not be available till after the channel is initialized.
Channel.PeerOptions	getPeersOptions(Peer peer)
Collection<String>	getPeersOrganizationMSPIDs() Collection of strings which are the MSPIDs of all the peer organization added.
Channel.SDOrdererAddition	getSDOrdererAddition() Get current service discovery orderer addition override.
Channel.SDPeerAddition	getSDPeerAddition() Get current service discovery peer addition override.
Properties	getServiceDiscoveryProperties()
byte[]	getUpdateChannelConfigurationSignature(UpdateChannelConfiguration updateChannelConfiguration, User signer) Get signed byes of the update channel.
Channel	initialize() Initialize the Channel.
boolean	isInitialized() Is channel initialized.
boolean	isShutdown() Is the channel shutdown.
Channel	joinPeer(Orderer orderer, Peer peer, Channel.PeerOptions peerOptions) Join peer to channel
Channel	joinPeer(Peer peer) Join the peer to the channel.
Channel	joinPeer(Peer peer, Channel.PeerOptions peerOptions)
Collection<LifecycleQueryChaincodeDefinitionProposalResponse>	lifecycleQueryChaincodeDefinition(QueryLifecycleQueryChaincodeDefinitionRequest queryLifecycleQueryChaincodeDefinitionRequest, Collection<Peer> peers) lifecycleQueryChaincodeDefinition get definition of chaincode.
Collection<LifecycleQueryChaincodeDefinitionsProposalResponse>	lifecycleQueryChaincodeDefinitions(LifecycleQueryChaincodeDefinitionsRequest proposalRequest, Collection<Peer> peers) Query namespaces.
org.hyperledger.fabric.sdk.transaction.TransactionContext	newTransactionContext() Create a new transaction context based on the client user context.
BlockInfo	queryBlockByHash(byte[] blockHash) query this channel for a Block by the block hash.
BlockInfo	queryBlockByHash(byte[] blockHash, User userContext) query this channel for a Block by the block hash.
BlockInfo	queryBlockByHash(Collection<Peer> peers, byte[] blockHash) Query a peer in this channel for a Block by the block hash.
BlockInfo	queryBlockByHash(Collection<Peer> peers, byte[] blockHash, User userContext) Query a peer in this channel for a Block by the block hash.
BlockInfo	queryBlockByHash(Peer peer, byte[] blockHash) Query a peer in this channel for a Block by the block hash.
BlockInfo	queryBlockByNumber(Collection<Peer> peers, long blockNumber) query a peer in this channel for a Block by the blockNumber This method may not be thread safe if client context is changed!
BlockInfo	queryBlockByNumber(Collection<Peer> peers, long blockNumber, User userContext) query a peer in this channel for a Block by the blockNumber
BlockInfo	queryBlockByNumber(long blockNumber) query this channel for a Block by the blockNumber.
BlockInfo	queryBlockByNumber(long blockNumber, User userContext) query this channel for a Block by the blockNumber.
BlockInfo	queryBlockByNumber(Peer peer, long blockNumber) Query a peer in this channel for a Block by the blockNumber This method may not be thread safe if client context is changed!
BlockInfo	queryBlockByNumber(Peer peer, long blockNumber, User userContext) query a peer in this channel for a Block by the blockNumber
BlockInfo	queryBlockByTransactionID(Collection<Peer> peers, String txID) query a peer in this channel for a Block by a TransactionID contained in the block This method may not be thread safe if client context is changed!
BlockInfo	queryBlockByTransactionID(Collection<Peer> peers, String txID, User userContext) query a peer in this channel for a Block by a TransactionID contained in the block
BlockInfo	queryBlockByTransactionID(Peer peer, String txID) query a peer in this channel for a Block by a TransactionID contained in the block This method may not be thread safe if client context is changed!
BlockInfo	queryBlockByTransactionID(Peer peer, String txID, User userContext) query a peer in this channel for a Block by a TransactionID contained in the block
BlockInfo	queryBlockByTransactionID(String txID) query this channel for a Block by a TransactionID contained in the block The request is tried on on each peer till successful.
BlockInfo	queryBlockByTransactionID(String txID, User userContext) query this channel for a Block by a TransactionID contained in the block The request is sent to a random peer in the channel
BlockchainInfo	queryBlockchainInfo() query this channel for chain information.
BlockchainInfo	queryBlockchainInfo(Collection<Peer> peers, User userContext) query for chain information
BlockchainInfo	queryBlockchainInfo(Peer peer) query for chain information This method may not be thread safe if client context is changed!
BlockchainInfo	queryBlockchainInfo(Peer peer, User userContext) query for chain information
BlockchainInfo	queryBlockchainInfo(User userContext) query this channel for chain information.
Collection<ProposalResponse>	queryByChaincode(QueryByChaincodeRequest queryByChaincodeRequest) Send Query proposal
Collection<ProposalResponse>	queryByChaincode(QueryByChaincodeRequest queryByChaincodeRequest, Collection<Peer> peers) Send Query proposal
CollectionConfigPackage	queryCollectionsConfig(String chaincodeName, Peer peer, User userContext) Get information on the collections used by the chaincode.
List<org.hyperledger.fabric.protos.peer.Query.ChaincodeInfo>	queryInstantiatedChaincodes(Peer peer) Query peer for chaincode that has been instantiated This method may not be thread safe if client context is changed!
List<org.hyperledger.fabric.protos.peer.Query.ChaincodeInfo>	queryInstantiatedChaincodes(Peer peer, User userContext) Query peer for chaincode that has been instantiated
TransactionInfo	queryTransactionByID(Collection<Peer> peers, String txID, User userContext) Query for a Fabric Transaction given its transactionID
TransactionInfo	queryTransactionByID(Peer peer, String txID) Query for a Fabric Transaction given its transactionID This method may not be thread safe if client context is changed!
TransactionInfo	queryTransactionByID(Peer peer, String txID, User userContext) Query for a Fabric Transaction given its transactionID
TransactionInfo	queryTransactionByID(String txID) Query this channel for a Fabric Transaction given its transactionID.
TransactionInfo	queryTransactionByID(String txID, User userContext) Query this channel for a Fabric Transaction given its transactionID.
String	registerBlockListener(BlockingQueue<QueuedBlockEvent> blockEventQueue) Register a Queued block listener.
String	registerBlockListener(BlockingQueue<QueuedBlockEvent> blockEventQueue, long timeout, TimeUnit timeUnit) Register a Queued block listener.
String	registerBlockListener(BlockListener listener) Register a block listener.
String	registerChaincodeEventListener(Pattern chaincodeId, Pattern eventName, ChaincodeEventListener chaincodeEventListener) Register a chaincode event listener.
void	removeOrderer(Orderer orderer)
void	removePeer(Peer peer) Removes the peer connection from the channel.
Collection<ProposalResponse>	sendInstantiationProposal(InstantiateProposalRequest instantiateProposalRequest) Deprecated. See new lifecycle chaincode management. LifecycleInstallChaincodeRequest
Collection<ProposalResponse>	sendInstantiationProposal(InstantiateProposalRequest instantiateProposalRequest, Collection<Peer> peers) Deprecated. See new lifecycle chaincode management. LifecycleInstallChaincodeRequest
Collection<LifecycleApproveChaincodeDefinitionForMyOrgProposalResponse>	sendLifecycleApproveChaincodeDefinitionForMyOrgProposal(LifecycleApproveChaincodeDefinitionForMyOrgRequest lifecycleApproveChaincodeDefinitionForMyOrgRequest, Collection<Peer> peers) Approve chaincode to be run on this peer's organization.
LifecycleApproveChaincodeDefinitionForMyOrgProposalResponse	sendLifecycleApproveChaincodeDefinitionForMyOrgProposal(LifecycleApproveChaincodeDefinitionForMyOrgRequest lifecycleApproveChaincodeDefinitionForMyOrgRequest, Peer peer) Approve chaincode to be run on this peer's organization.
Collection<LifecycleCheckCommitReadinessProposalResponse>	sendLifecycleCheckCommitReadinessRequest(LifecycleCheckCommitReadinessRequest lifecycleCheckCommitReadinessRequest, Collection<Peer> peers) Query approval status for all organizations.
Collection<LifecycleCommitChaincodeDefinitionProposalResponse>	sendLifecycleCommitChaincodeDefinitionProposal(LifecycleCommitChaincodeDefinitionRequest lifecycleCommitChaincodeDefinitionRequest, Collection<Peer> peers) Commit chaincode final approval to run on all organizations that have approved.
CompletableFuture<BlockEvent.TransactionEvent>	sendTransaction(Collection<? extends ProposalResponse> proposalResponses) Send transaction to one of the orderers on the channel using the usercontext set on the client.
CompletableFuture<BlockEvent.TransactionEvent>	sendTransaction(Collection<? extends ProposalResponse> proposalResponses, Channel.TransactionOptions transactionOptions) Send transaction to one of a specified set of orderers with the specified user context.
CompletableFuture<BlockEvent.TransactionEvent>	sendTransaction(Collection<? extends ProposalResponse> proposalResponses, Collection<Orderer> orderers) Send transaction to one of the specified orderers using the usercontext set on the client..
CompletableFuture<BlockEvent.TransactionEvent>	sendTransaction(Collection<? extends ProposalResponse> proposalResponses, Collection<Orderer> orderers, User userContext) Send transaction to one of a specified set of orderers with the specified user context.
CompletableFuture<BlockEvent.TransactionEvent>	sendTransaction(Collection<ProposalResponse> proposalResponses, User userContext) Send transaction to one of the orderers on the channel using a specific user context.
Collection<ProposalResponse>	sendTransactionProposal(TransactionProposalRequest transactionProposalRequest) Send a transaction proposal.
Collection<ProposalResponse>	sendTransactionProposal(TransactionProposalRequest transactionProposalRequest, Collection<Peer> peers) Send a transaction proposal to specific peers.
Collection<ProposalResponse>	sendTransactionProposalToEndorsers(TransactionProposalRequest transactionProposalRequest, Channel.DiscoveryOptions discoveryOptions) Send a transaction proposal.
Collection<ProposalResponse>	sendUpgradeProposal(UpgradeProposalRequest upgradeProposalRequest) Deprecated. See new Lifecycle chaincode management. sendLifecycleApproveChaincodeDefinitionForMyOrgProposal(LifecycleApproveChaincodeDefinitionForMyOrgRequest, Peer)
Collection<ProposalResponse>	sendUpgradeProposal(UpgradeProposalRequest upgradeProposalRequest, Collection<Peer> peers) Deprecated. See new Lifecycle chaincode management. sendLifecycleApproveChaincodeDefinitionForMyOrgProposal(LifecycleApproveChaincodeDefinitionForMyOrgRequest, Peer)
byte[]	serializeChannel() Serialize channel to a byte array using Java serialization.
void	serializeChannel(File file) Serialize channel to a file using Java serialization.
ServiceDiscovery.EndorsementSelector	setSDEndorserSelector(ServiceDiscovery.EndorsementSelector endorsementSelector)
Channel.SDOrdererAddition	setSDOrdererAddition(Channel.SDOrdererAddition sdOrdererAddition) Set service discovery orderer addition override.
Channel.SDPeerAddition	setSDPeerAddition(Channel.SDPeerAddition sdPeerAddition) Set service discovery peer addition override.
void	setServiceDiscoveryProperties(Properties serviceDiscoveryProperties)
void	shutdown(boolean force) Shutdown the channel with all resources released.
String	toString()
boolean	unregisterBlockListener(String handle) Unregister a block listener.
boolean	unregisterChaincodeEventListener(String handle) Unregister an existing chaincode event listener.
void	updateChannelConfiguration(UpdateChannelConfiguration updateChannelConfiguration, byte[]... signers) Update channel with specified channel configuration.
void	updateChannelConfiguration(UpdateChannelConfiguration updateChannelConfiguration, Orderer orderer, byte[]... signers) Update channel with specified channel configuration
void	updateChannelConfiguration(User userContext, UpdateChannelConfiguration updateChannelConfiguration, Orderer orderer, byte[]... signers) Update channel with specified channel configuration

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

toString

public String toString()

Overrides:

toString in class Object

updateChannelConfiguration

public void updateChannelConfiguration(UpdateChannelConfiguration updateChannelConfiguration,
                                       byte[]... signers)
                                throws TransactionException,
                                       InvalidArgumentException

Update channel with specified channel configuration.

Note This is not a thread safe operation

Parameters:

updateChannelConfiguration - Updated Channel configuration

signers - signers

Throws:

TransactionException

InvalidArgumentException

updateChannelConfiguration

public void updateChannelConfiguration(UpdateChannelConfiguration updateChannelConfiguration,
                                       Orderer orderer,
                                       byte[]... signers)
                                throws TransactionException,
                                       InvalidArgumentException

Update channel with specified channel configuration

Note This is not a thread safe operation

Parameters:

updateChannelConfiguration - Channel configuration

signers - signers

orderer - The specific orderer to use.

Throws:

TransactionException

InvalidArgumentException

updateChannelConfiguration

public void updateChannelConfiguration(User userContext,
                                       UpdateChannelConfiguration updateChannelConfiguration,
                                       Orderer orderer,
                                       byte[]... signers)
                                throws TransactionException,
                                       InvalidArgumentException

Update channel with specified channel configuration

Parameters:

userContext - The specific user to use.

updateChannelConfiguration - Channel configuration

signers - signers

orderer - The specific orderer to use.

Throws:

TransactionException

InvalidArgumentException

isInitialized

public boolean isInitialized()

Is channel initialized.

Returns:

true if the channel has been initialized.

getName

public String getName()

Get the channel name

Returns:

The name of the channel

addPeer

public Channel addPeer(Peer peer)
                throws InvalidArgumentException

Add a peer to the channel

Parameters:

peer - The Peer to add.

Returns:

Channel The current channel added.

Throws:

InvalidArgumentException

addPeer

public Channel addPeer(Peer peer,
                       Channel.PeerOptions peerOptions)
                throws InvalidArgumentException

Add a peer to the channel

Parameters:

peer - The Peer to add.

peerOptions - see Peer.PeerRole

Returns:

Channel The current channel added.

Throws:

InvalidArgumentException

getPeersForOrganization

public Collection<Peer> getPeersForOrganization(String mspid)
                                         throws InvalidArgumentException

Get peers that belong to an organization from the organization's MSPID These values may not be available till after the channel is initialized.

Parameters:

mspid - The organizaiions MSPID

Returns:

A collection of Peers that belong to the organization with that mspid.

Throws:

InvalidArgumentException

getPeersOrganizationMSPIDs

public Collection<String> getPeersOrganizationMSPIDs()

Collection of strings which are the MSPIDs of all the peer organization added. These values may not be available till after the channel is initialized.

Returns:

The collection of mspids

joinPeer

public Channel joinPeer(Peer peer)
                 throws ProposalException

Join the peer to the channel. The peer is added with all roles see Channel.PeerOptions

Parameters:

peer - the peer to join the channel.

Returns:

Throws:

ProposalException

joinPeer

public Channel joinPeer(Peer peer,
                        Channel.PeerOptions peerOptions)
                 throws ProposalException

Parameters:

peer - the peer to join the channel.

peerOptions - see Channel.PeerOptions

Returns:

Throws:

ProposalException

joinPeer

public Channel joinPeer(Orderer orderer,
                        Peer peer,
                        Channel.PeerOptions peerOptions)
                 throws ProposalException

Join peer to channel

Parameters:

orderer - The orderer to get the genesis block.

peer - the peer to join the channel.

peerOptions - see Channel.PeerOptions

Returns:

Throws:

ProposalException

removePeer

public void removePeer(Peer peer)
                throws InvalidArgumentException

Removes the peer connection from the channel. This does NOT unjoin the peer from from the channel. Fabric does not support that at this time -- maybe some day, but not today

Parameters:

peer -

Throws:

InvalidArgumentException

addOrderer

public Channel addOrderer(Orderer orderer)
                   throws InvalidArgumentException

Add an Orderer to this channel.

Parameters:

orderer - the orderer to add.

Returns:

this channel.

Throws:

InvalidArgumentException

removeOrderer

public void removeOrderer(Orderer orderer)
                   throws InvalidArgumentException

Throws:

InvalidArgumentException

getOrderersForOrganization

public Collection<Orderer> getOrderersForOrganization(String mspid)
                                               throws InvalidArgumentException

Get orderers that belong to an organization from the organization's MSPID These values may not be available till after the channel is initialized.

Parameters:

mspid - The organizaiions MSPID

Returns:

A collection of Orderers that belong to the organization with that mspid.

Throws:

InvalidArgumentException

getOrderersOrganizationMSPIDs

public Collection<String> getOrderersOrganizationMSPIDs()

Collection of strings which are the MSPIDs of all the orderer organization added. These values may not be available till after the channel is initialized.

Returns:

The collection of mspids

getPeersOptions

public Channel.PeerOptions getPeersOptions(Peer peer)

getPeers

public Collection<Peer> getPeers()

Get the peers for this channel.

Returns:

the peers.

getPeers

public Collection<Peer> getPeers(EnumSet<Peer.PeerRole> roles)

Get the peers for this channel.

Returns:

the peers.

initialize

public Channel initialize()
                   throws InvalidArgumentException,
                          TransactionException

Initialize the Channel. Starts the channel. event hubs will connect.

Returns:

this channel.

Throws:

InvalidArgumentException

TransactionException

getServiceDiscoveryProperties

public Properties getServiceDiscoveryProperties()

setServiceDiscoveryProperties

public void setServiceDiscoveryProperties(Properties serviceDiscoveryProperties)

setSDOrdererAddition

public Channel.SDOrdererAddition setSDOrdererAddition(Channel.SDOrdererAddition sdOrdererAddition)

Set service discovery orderer addition override.

Any service discovery properties setServiceDiscoveryProperties(Properties) should be set before calling this.

Parameters:

sdOrdererAddition -

Returns:

getSDOrdererAddition

public Channel.SDOrdererAddition getSDOrdererAddition()

Get current service discovery orderer addition override.

Any service discovery properties setServiceDiscoveryProperties(Properties) should be set before calling this.

Returns:

SDOrdererAddition

setSDPeerAddition

public Channel.SDPeerAddition setSDPeerAddition(Channel.SDPeerAddition sdPeerAddition)

Set service discovery peer addition override.

Any service discovery properties setServiceDiscoveryProperties(Properties) should be set before calling this.

Parameters:

sdPeerAddition -

Returns:

getSDPeerAddition

public Channel.SDPeerAddition getSDPeerAddition()

Get current service discovery peer addition override.

Any service discovery properties setServiceDiscoveryProperties(Properties) should be set before calling this.

Returns:

SDOrdererAddition

isShutdown

public boolean isShutdown()

Is the channel shutdown.

Returns:

return true if the channel is shutdown.

getUpdateChannelConfigurationSignature

public byte[] getUpdateChannelConfigurationSignature(UpdateChannelConfiguration updateChannelConfiguration,
                                                     User signer)
                                              throws InvalidArgumentException

Get signed byes of the update channel.

Parameters:

updateChannelConfiguration -

signer -

Returns:

Throws:

InvalidArgumentException

getConfigUpdateAnchorPeers

public Channel.AnchorPeersConfigUpdateResult getConfigUpdateAnchorPeers(Peer peer,
                                                                        User userContext,
                                                                        Collection<String> peersToAdd,
                                                                        Collection<String> peersToRemove)
                                                                 throws Exception

Get a channel configuration update to add or remove peers. If both peersToAdd AND peersToRemove are null then only the current anchor peers are reported with @see Channel.AnchorPeersConfigUpdateResult.getCurrentPeers()

Parameters:

peer - peer to use to the channel configuration from.

userContext - The usercontext to use.

peersToAdd - Peers to add as Host:Port peer1.org2.com:7022

peersToRemove - Peers to remove as Host:Port peer1.org2.com:7022

Returns:

The AnchorPeersConfigUpdateResult @see Channel.AnchorPeersConfigUpdateResult

Throws:

Exception

getChannelConfigurationBytes

public byte[] getChannelConfigurationBytes(User userContext,
                                           Orderer orderer)
                                    throws InvalidArgumentException,
                                           TransactionException

Get channel configuration from a specific Orderer

Parameters:

userContext - The user to sign the action.

orderer - To retrieve the configuration from.

Returns:

Configuration block.

Throws:

InvalidArgumentException

TransactionException

getChannelConfigurationBytes

public byte[] getChannelConfigurationBytes(User userContext,
                                           Peer peer)
                                    throws InvalidArgumentException,
                                           TransactionException

Get channel configuration from a specific peer

Parameters:

userContext - The user to sign the action.

peer - To retrieve the configuration from.

Returns:

Configuration block.

Throws:

InvalidArgumentException

TransactionException

getChannelConfigurationBytes

public byte[] getChannelConfigurationBytes()
                                    throws InvalidArgumentException,
                                           TransactionException

Throws:

InvalidArgumentException

TransactionException

getChannelConfigurationBytes

public byte[] getChannelConfigurationBytes(User userContext)
                                    throws InvalidArgumentException,
                                           TransactionException

Channel Configuration bytes. Bytes that can be used with configtxlator tool to upgrade the channel. If Peers exist on the channel config block will be retrieved from them. If only Orderers exist the configblock is retrieved from them. Convert to Json for editing with: <p> curl -v POST --data-binary @fooConfig http://host/protolator/decode/common.Config <p> See http://hyperledger-fabric.readthedocs.io/en/latest/configtxlator.html

Returns:

Channel configuration bytes.

Throws:

TransactionException

InvalidArgumentException

getOrderers

public Collection<Orderer> getOrderers()

sendInstantiationProposal

@Deprecated
public Collection<ProposalResponse> sendInstantiationProposal(InstantiateProposalRequest instantiateProposalRequest)
                                                                   throws InvalidArgumentException,
                                                                          ProposalException

Deprecated. See new lifecycle chaincode management. LifecycleInstallChaincodeRequest

Send instantiate request to the channel. Chaincode is created and initialized.

Parameters:

instantiateProposalRequest - send instantiate chaincode proposal request.

Returns:

Collections of proposal responses

Throws:

InvalidArgumentException

ProposalException

sendInstantiationProposal

@Deprecated
public Collection<ProposalResponse> sendInstantiationProposal(InstantiateProposalRequest instantiateProposalRequest,
                                                                          Collection<Peer> peers)
                                                                   throws InvalidArgumentException,
                                                                          ProposalException

Deprecated. See new lifecycle chaincode management. LifecycleInstallChaincodeRequest

Send instantiate request to the channel. Chaincode is created and initialized.

Parameters:

instantiateProposalRequest -

peers -

Returns:

responses from peers.

Throws:

InvalidArgumentException

ProposalException

newTransactionContext

public org.hyperledger.fabric.sdk.transaction.TransactionContext newTransactionContext()

Create a new transaction context based on the client user context. The transaction context can be set on a TransactionRequest prior to calling sendTransactionProposal(TransactionProposalRequest) so that the caller can know the transaction ID in advance.

Returns:

A transaction context.

sendUpgradeProposal

@Deprecated
public Collection<ProposalResponse> sendUpgradeProposal(UpgradeProposalRequest upgradeProposalRequest)
                                                             throws ProposalException,
                                                                    InvalidArgumentException

Deprecated. See new Lifecycle chaincode management. sendLifecycleApproveChaincodeDefinitionForMyOrgProposal(LifecycleApproveChaincodeDefinitionForMyOrgRequest, Peer)

Send Upgrade proposal proposal to upgrade chaincode to a new version.

Parameters:

upgradeProposalRequest -

Returns:

Collection of proposal responses.

Throws:

ProposalException

InvalidArgumentException

sendUpgradeProposal

@Deprecated
public Collection<ProposalResponse> sendUpgradeProposal(UpgradeProposalRequest upgradeProposalRequest,
                                                                    Collection<Peer> peers)
                                                             throws InvalidArgumentException,
                                                                    ProposalException

Deprecated. See new Lifecycle chaincode management. sendLifecycleApproveChaincodeDefinitionForMyOrgProposal(LifecycleApproveChaincodeDefinitionForMyOrgRequest, Peer)

Send Upgrade proposal proposal to upgrade chaincode to a new version.

Parameters:

upgradeProposalRequest -

peers - the specific peers to send to.

Returns:

Collection of proposal responses.

Throws:

ProposalException

InvalidArgumentException

queryBlockByHash

public BlockInfo queryBlockByHash(byte[] blockHash)
                           throws InvalidArgumentException,
                                  ProposalException

query this channel for a Block by the block hash. The request is retried on each peer on the channel till successful. This method may not be thread safe if client context is changed!

Parameters:

blockHash - the hash of the Block in the chain

Returns:

the BlockInfo with the given block Hash

Throws:

InvalidArgumentException

ProposalException

queryBlockByHash

public BlockInfo queryBlockByHash(byte[] blockHash,
                                  User userContext)
                           throws InvalidArgumentException,
                                  ProposalException

query this channel for a Block by the block hash. The request is tried on multiple peers.

Parameters:

blockHash - the hash of the Block in the chain

userContext - the user context.

Returns:

the BlockInfo with the given block Hash

Throws:

InvalidArgumentException

ProposalException

queryBlockByHash

public BlockInfo queryBlockByHash(Peer peer,
                                  byte[] blockHash)
                           throws InvalidArgumentException,
                                  ProposalException

Query a peer in this channel for a Block by the block hash. This method may not be thread safe if client context is changed!

Parameters:

peer - the Peer to query.

blockHash - the hash of the Block in the chain.

Returns:

the BlockInfo with the given block Hash

Throws:

InvalidArgumentException - if the channel is shutdown or any of the arguments are not valid.

ProposalException - if an error occurred processing the query.

queryBlockByHash

public BlockInfo queryBlockByHash(Collection<Peer> peers,
                                  byte[] blockHash)
                           throws InvalidArgumentException,
                                  ProposalException

Query a peer in this channel for a Block by the block hash. Each peer is tried until successful response. This method may not be thread safe if client context is changed!

Parameters:

peers - the Peers to query.

blockHash - the hash of the Block in the chain.

Returns:

the BlockInfo with the given block Hash

Throws:

InvalidArgumentException - if the channel is shutdown or any of the arguments are not valid.

ProposalException - if an error occurred processing the query.

queryBlockByHash

public BlockInfo queryBlockByHash(Collection<Peer> peers,
                                  byte[] blockHash,
                                  User userContext)
                           throws InvalidArgumentException,
                                  ProposalException

Query a peer in this channel for a Block by the block hash.

Parameters:

peers - the Peers to query.

blockHash - the hash of the Block in the chain.

userContext - the user context

Returns:

the BlockInfo with the given block Hash

Throws:

InvalidArgumentException - if the channel is shutdown or any of the arguments are not valid.

ProposalException - if an error occurred processing the query.

queryBlockByNumber

public BlockInfo queryBlockByNumber(long blockNumber)
                             throws InvalidArgumentException,
                                    ProposalException

query this channel for a Block by the blockNumber. The request is retried on all peers till successful This method may not be thread safe if client context is changed!

Parameters:

blockNumber - index of the Block in the chain

Returns:

the BlockInfo with the given blockNumber

Throws:

InvalidArgumentException

ProposalException

queryBlockByNumber

public BlockInfo queryBlockByNumber(long blockNumber,
                                    User userContext)
                             throws InvalidArgumentException,
                                    ProposalException

query this channel for a Block by the blockNumber. The request is sent to a random peer in the channel.

Parameters:

blockNumber - index of the Block in the chain

userContext - the user context to be used.

Returns:

the BlockInfo with the given blockNumber

Throws:

InvalidArgumentException

ProposalException

queryBlockByNumber

public BlockInfo queryBlockByNumber(Peer peer,
                                    long blockNumber)
                             throws InvalidArgumentException,
                                    ProposalException

Query a peer in this channel for a Block by the blockNumber This method may not be thread safe if client context is changed!

Parameters:

peer - the peer to send the request to

blockNumber - index of the Block in the chain

Returns:

the BlockInfo with the given blockNumber

Throws:

InvalidArgumentException

ProposalException

queryBlockByNumber

public BlockInfo queryBlockByNumber(Peer peer,
                                    long blockNumber,
                                    User userContext)
                             throws InvalidArgumentException,
                                    ProposalException

query a peer in this channel for a Block by the blockNumber

Parameters:

peer - the peer to send the request to

blockNumber - index of the Block in the chain

userContext - the user context.

Returns:

the BlockInfo with the given blockNumber

Throws:

InvalidArgumentException

ProposalException

queryBlockByNumber

public BlockInfo queryBlockByNumber(Collection<Peer> peers,
                                    long blockNumber)
                             throws InvalidArgumentException,
                                    ProposalException

query a peer in this channel for a Block by the blockNumber This method may not be thread safe if client context is changed!

Parameters:

peers - the peers to try and send the request to

blockNumber - index of the Block in the chain

Returns:

the BlockInfo with the given blockNumber

Throws:

InvalidArgumentException

ProposalException

queryBlockByNumber

public BlockInfo queryBlockByNumber(Collection<Peer> peers,
                                    long blockNumber,
                                    User userContext)
                             throws InvalidArgumentException,
                                    ProposalException

query a peer in this channel for a Block by the blockNumber

Parameters:

peers - the peers to try and send the request to

blockNumber - index of the Block in the chain

userContext - the user context to use.

Returns:

the BlockInfo with the given blockNumber

Throws:

InvalidArgumentException

ProposalException

queryBlockByTransactionID

public BlockInfo queryBlockByTransactionID(String txID)
                                    throws InvalidArgumentException,
                                           ProposalException

query this channel for a Block by a TransactionID contained in the block The request is tried on on each peer till successful. This method may not be thread safe if client context is changed!

Parameters:

txID - the transactionID to query on

Returns:

the BlockInfo for the Block containing the transaction

Throws:

InvalidArgumentException

ProposalException

queryBlockByTransactionID

public BlockInfo queryBlockByTransactionID(String txID,
                                           User userContext)
                                    throws InvalidArgumentException,
                                           ProposalException

query this channel for a Block by a TransactionID contained in the block The request is sent to a random peer in the channel

Parameters:

txID - the transactionID to query on

userContext - the user context.

Returns:

the BlockInfo for the Block containing the transaction

Throws:

InvalidArgumentException

ProposalException

queryBlockByTransactionID

public BlockInfo queryBlockByTransactionID(Peer peer,
                                           String txID)
                                    throws InvalidArgumentException,
                                           ProposalException

query a peer in this channel for a Block by a TransactionID contained in the block This method may not be thread safe if client context is changed!

Parameters:

peer - the peer to send the request to

txID - the transactionID to query on

Returns:

the BlockInfo for the Block containing the transaction

Throws:

InvalidArgumentException

ProposalException

queryBlockByTransactionID

public BlockInfo queryBlockByTransactionID(Peer peer,
                                           String txID,
                                           User userContext)
                                    throws InvalidArgumentException,
                                           ProposalException

query a peer in this channel for a Block by a TransactionID contained in the block

Parameters:

peer - the peer to send the request to

txID - the transactionID to query on

userContext - the user context.

Returns:

the BlockInfo for the Block containing the transaction

Throws:

InvalidArgumentException

ProposalException

queryBlockByTransactionID

public BlockInfo queryBlockByTransactionID(Collection<Peer> peers,
                                           String txID)
                                    throws InvalidArgumentException,
                                           ProposalException

query a peer in this channel for a Block by a TransactionID contained in the block This method may not be thread safe if client context is changed!

Parameters:

peers - the peers to try to send the request to.

txID - the transactionID to query on

Returns:

the BlockInfo for the Block containing the transaction

Throws:

InvalidArgumentException

ProposalException

queryBlockByTransactionID

public BlockInfo queryBlockByTransactionID(Collection<Peer> peers,
                                           String txID,
                                           User userContext)
                                    throws InvalidArgumentException,
                                           ProposalException

query a peer in this channel for a Block by a TransactionID contained in the block

Parameters:

peers - the peer to try to send the request to

txID - the transactionID to query on

userContext - the user context.

Returns:

the BlockInfo for the Block containing the transaction

Throws:

InvalidArgumentException

ProposalException

queryBlockchainInfo

public BlockchainInfo queryBlockchainInfo()
                                   throws ProposalException,
                                          InvalidArgumentException

query this channel for chain information. The request is sent to a random peer in the channel This method may not be thread safe if client context is changed!

Returns:

a BlockchainInfo object containing the chain info requested

Throws:

InvalidArgumentException

ProposalException

queryBlockchainInfo

public BlockchainInfo queryBlockchainInfo(User userContext)
                                   throws ProposalException,
                                          InvalidArgumentException

query this channel for chain information. The request is sent to a random peer in the channel

Parameters:

userContext - the user context to use.

Returns:

a BlockchainInfo object containing the chain info requested

Throws:

InvalidArgumentException

ProposalException

queryBlockchainInfo

public BlockchainInfo queryBlockchainInfo(Peer peer)
                                   throws ProposalException,
                                          InvalidArgumentException

query for chain information This method may not be thread safe if client context is changed!

Parameters:

peer - The peer to send the request to

Returns:

a BlockchainInfo object containing the chain info requested

Throws:

InvalidArgumentException

ProposalException

queryBlockchainInfo

public BlockchainInfo queryBlockchainInfo(Peer peer,
                                          User userContext)
                                   throws ProposalException,
                                          InvalidArgumentException

query for chain information

Parameters:

peer - The peer to send the request to

userContext - the user context to use.

Returns:

a BlockchainInfo object containing the chain info requested

Throws:

InvalidArgumentException

ProposalException

queryBlockchainInfo

public BlockchainInfo queryBlockchainInfo(Collection<Peer> peers,
                                          User userContext)
                                   throws ProposalException,
                                          InvalidArgumentException

query for chain information

Parameters:

peers - The peers to try send the request.

userContext - the user context.

Returns:

a BlockchainInfo object containing the chain info requested

Throws:

InvalidArgumentException

ProposalException

queryTransactionByID

public TransactionInfo queryTransactionByID(String txID)
                                     throws ProposalException,
                                            InvalidArgumentException

Query this channel for a Fabric Transaction given its transactionID. The request is sent to a random peer in the channel. This method may not be thread safe if client context is changed!

Parameters:

txID - the ID of the transaction

Returns:

a TransactionInfo

Throws:

ProposalException

InvalidArgumentException

queryTransactionByID

public TransactionInfo queryTransactionByID(String txID,
                                            User userContext)
                                     throws ProposalException,
                                            InvalidArgumentException

Query this channel for a Fabric Transaction given its transactionID. The request is sent to a random peer in the channel. This method may not be thread safe if client context is changed!

Parameters:

txID - the ID of the transaction

userContext - the user context used.

Returns:

a TransactionInfo

Throws:

ProposalException

InvalidArgumentException

queryTransactionByID

public TransactionInfo queryTransactionByID(Peer peer,
                                            String txID)
                                     throws ProposalException,
                                            InvalidArgumentException

Query for a Fabric Transaction given its transactionID This method may not be thread safe if client context is changed!

Parameters:

txID - the ID of the transaction

peer - the peer to send the request to

Returns:

a TransactionInfo

Throws:

ProposalException

InvalidArgumentException

queryTransactionByID

public TransactionInfo queryTransactionByID(Peer peer,
                                            String txID,
                                            User userContext)
                                     throws ProposalException,
                                            InvalidArgumentException

Query for a Fabric Transaction given its transactionID

Parameters:

peer - the peer to send the request to

txID - the ID of the transaction

userContext - the user context

Returns:

a TransactionInfo

Throws:

ProposalException

InvalidArgumentException

queryTransactionByID

public TransactionInfo queryTransactionByID(Collection<Peer> peers,
                                            String txID,
                                            User userContext)
                                     throws ProposalException,
                                            InvalidArgumentException

Query for a Fabric Transaction given its transactionID

Parameters:

txID - the ID of the transaction

peers - the peers to try to send the request.

userContext - the user context

Returns:

a TransactionInfo

Throws:

ProposalException

InvalidArgumentException

sendLifecycleApproveChaincodeDefinitionForMyOrgProposal

public LifecycleApproveChaincodeDefinitionForMyOrgProposalResponse sendLifecycleApproveChaincodeDefinitionForMyOrgProposal(LifecycleApproveChaincodeDefinitionForMyOrgRequest lifecycleApproveChaincodeDefinitionForMyOrgRequest,
                                                                                                                           Peer peer)
                                                                                                                    throws ProposalException,
                                                                                                                           InvalidArgumentException

Approve chaincode to be run on this peer's organization.

Parameters:

lifecycleApproveChaincodeDefinitionForMyOrgRequest - the request see LifecycleApproveChaincodeDefinitionForMyOrgRequest

peer -

Returns:

A LifecycleApproveChaincodeDefinitionForMyOrgProposalResponse

Throws:

ProposalException

InvalidArgumentException

sendLifecycleApproveChaincodeDefinitionForMyOrgProposal

public Collection<LifecycleApproveChaincodeDefinitionForMyOrgProposalResponse> sendLifecycleApproveChaincodeDefinitionForMyOrgProposal(LifecycleApproveChaincodeDefinitionForMyOrgRequest lifecycleApproveChaincodeDefinitionForMyOrgRequest,
                                                                                                                                       Collection<Peer> peers)
                                                                                                                                throws ProposalException,
                                                                                                                                       InvalidArgumentException

Approve chaincode to be run on this peer's organization.

Parameters:

lifecycleApproveChaincodeDefinitionForMyOrgRequest - the request see LifecycleApproveChaincodeDefinitionForMyOrgRequest

peers - to send the request to.

Returns:

A LifecycleApproveChaincodeDefinitionForMyOrgProposalResponse

Throws:

ProposalException

InvalidArgumentException

sendLifecycleCommitChaincodeDefinitionProposal

public Collection<LifecycleCommitChaincodeDefinitionProposalResponse> sendLifecycleCommitChaincodeDefinitionProposal(LifecycleCommitChaincodeDefinitionRequest lifecycleCommitChaincodeDefinitionRequest,
                                                                                                                     Collection<Peer> peers)
                                                                                                              throws InvalidArgumentException,
                                                                                                                     ProposalException

Commit chaincode final approval to run on all organizations that have approved.

Parameters:

lifecycleCommitChaincodeDefinitionRequest - The request see LifecycleCommitChaincodeDefinitionRequest

peers - to send the request to.

Returns:

A LifecycleCommitChaincodeDefinitionProposalResponse

Throws:

InvalidArgumentException

ProposalException

lifecycleQueryChaincodeDefinitions

public Collection<LifecycleQueryChaincodeDefinitionsProposalResponse> lifecycleQueryChaincodeDefinitions(LifecycleQueryChaincodeDefinitionsRequest proposalRequest,
                                                                                                         Collection<Peer> peers)
                                                                                                  throws InvalidArgumentException,
                                                                                                         ProposalException

Query namespaces. Takes no specific arguments returns namespaces including chaincode names that have been committed.

Parameters:

proposalRequest - the request.

peers - The peers to which the request will be sent.

Returns:

Peer responses.

Throws:

InvalidArgumentException - if the channel is in an invalid state.

ProposalException

sendLifecycleCheckCommitReadinessRequest

public Collection<LifecycleCheckCommitReadinessProposalResponse> sendLifecycleCheckCommitReadinessRequest(LifecycleCheckCommitReadinessRequest lifecycleCheckCommitReadinessRequest,
                                                                                                          Collection<Peer> peers)
                                                                                                   throws InvalidArgumentException,
                                                                                                          ProposalException

Query approval status for all organizations.

Parameters:

lifecycleCheckCommitReadinessRequest - The request see LifecycleCheckCommitReadinessRequest

peers - Peers to send the request. Usually only need one.

Returns:

A LifecycleCheckCommitReadinessProposalResponse

Throws:

InvalidArgumentException

ProposalException

lifecycleQueryChaincodeDefinition

public Collection<LifecycleQueryChaincodeDefinitionProposalResponse> lifecycleQueryChaincodeDefinition(QueryLifecycleQueryChaincodeDefinitionRequest queryLifecycleQueryChaincodeDefinitionRequest,
                                                                                                       Collection<Peer> peers)
                                                                                                throws InvalidArgumentException,
                                                                                                       ProposalException

lifecycleQueryChaincodeDefinition get definition of chaincode.

Parameters:

queryLifecycleQueryChaincodeDefinitionRequest - The request see QueryLifecycleQueryChaincodeDefinitionRequest

peers - The peers to send the request to.

Returns:

A LifecycleQueryChaincodeDefinitionProposalResponse

Throws:

InvalidArgumentException

ProposalException

queryInstantiatedChaincodes

public List<org.hyperledger.fabric.protos.peer.Query.ChaincodeInfo> queryInstantiatedChaincodes(Peer peer)
                                                                                         throws InvalidArgumentException,
                                                                                                ProposalException

Query peer for chaincode that has been instantiated This method may not be thread safe if client context is changed!

Parameters:

peer - The peer to query.

Returns:

A list of ChaincodeInfo @see Query.ChaincodeInfo

Throws:

InvalidArgumentException

ProposalException

queryInstantiatedChaincodes

public List<org.hyperledger.fabric.protos.peer.Query.ChaincodeInfo> queryInstantiatedChaincodes(Peer peer,
                                                                                                User userContext)
                                                                                         throws InvalidArgumentException,
                                                                                                ProposalException

Query peer for chaincode that has been instantiated

Parameters:

peer - The peer to query.

userContext - the user context.

Returns:

A list of ChaincodeInfo @see Query.ChaincodeInfo

Throws:

InvalidArgumentException

ProposalException

queryCollectionsConfig

public CollectionConfigPackage queryCollectionsConfig(String chaincodeName,
                                                      Peer peer,
                                                      User userContext)
                                               throws InvalidArgumentException,
                                                      ProposalException

Get information on the collections used by the chaincode.

Parameters:

chaincodeName - The name of the chaincode to query.

peer - Peer to query.

userContext - The context of the user to sign the request.

Returns:

CollectionConfigPackage with information on the collection used by the chaincode.

Throws:

InvalidArgumentException

ProposalException

sendTransactionProposal

public Collection<ProposalResponse> sendTransactionProposal(TransactionProposalRequest transactionProposalRequest)
                                                     throws ProposalException,
                                                            InvalidArgumentException

Send a transaction proposal.

Parameters:

transactionProposalRequest - The transaction proposal to be sent to all the required peers needed for endorsing.

Returns:

responses from peers.

Throws:

InvalidArgumentException

ProposalException

sendTransactionProposalToEndorsers

public Collection<ProposalResponse> sendTransactionProposalToEndorsers(TransactionProposalRequest transactionProposalRequest,
                                                                       Channel.DiscoveryOptions discoveryOptions)
                                                                throws ProposalException,
                                                                       InvalidArgumentException,
                                                                       ServiceDiscoveryException

Send a transaction proposal.

Parameters:

transactionProposalRequest - The transaction proposal to be sent to all the required peers needed for endorsing.

discoveryOptions -

Returns:

responses from peers.

Throws:

InvalidArgumentException

ProposalException

ServiceDiscoveryException

getDiscoveredChaincodeNames

public Collection<String> getDiscoveredChaincodeNames()

Collection of discovered chaincode names.

Returns:

sendTransactionProposal

public Collection<ProposalResponse> sendTransactionProposal(TransactionProposalRequest transactionProposalRequest,
                                                            Collection<Peer> peers)
                                                     throws ProposalException,
                                                            InvalidArgumentException

Send a transaction proposal to specific peers.

Parameters:

transactionProposalRequest - The transaction proposal to be sent to the peers.

peers -

Returns:

responses from peers.

Throws:

InvalidArgumentException

ProposalException

queryByChaincode

public Collection<ProposalResponse> queryByChaincode(QueryByChaincodeRequest queryByChaincodeRequest)
                                              throws InvalidArgumentException,
                                                     ProposalException

Send Query proposal

Parameters:

queryByChaincodeRequest -

Returns:

Collection proposal responses.

Throws:

InvalidArgumentException

ProposalException

queryByChaincode

public Collection<ProposalResponse> queryByChaincode(QueryByChaincodeRequest queryByChaincodeRequest,
                                                     Collection<Peer> peers)
                                              throws InvalidArgumentException,
                                                     ProposalException

Send Query proposal

Parameters:

queryByChaincodeRequest -

peers -

Returns:

responses from peers.

Throws:

InvalidArgumentException

ProposalException

setSDEndorserSelector

public ServiceDiscovery.EndorsementSelector setSDEndorserSelector(ServiceDiscovery.EndorsementSelector endorsementSelector)

sendTransaction

public CompletableFuture<BlockEvent.TransactionEvent> sendTransaction(Collection<ProposalResponse> proposalResponses,
                                                                      User userContext)

Send transaction to one of the orderers on the channel using a specific user context.

Parameters:

proposalResponses - The proposal responses to be sent to the orderer.

userContext - The usercontext used for signing transaction.

Returns:

a future allowing access to the result of the transaction invocation once complete.

sendTransaction

public CompletableFuture<BlockEvent.TransactionEvent> sendTransaction(Collection<? extends ProposalResponse> proposalResponses)

Send transaction to one of the orderers on the channel using the usercontext set on the client.

Parameters:

proposalResponses - .

Returns:

a future allowing access to the result of the transaction invocation once complete.

sendTransaction

public CompletableFuture<BlockEvent.TransactionEvent> sendTransaction(Collection<? extends ProposalResponse> proposalResponses,
                                                                      Collection<Orderer> orderers)

Send transaction to one of the specified orderers using the usercontext set on the client..

Parameters:

proposalResponses - The proposal responses to be sent to the orderer

orderers - The orderers to send the transaction to.

Returns:

a future allowing access to the result of the transaction invocation once complete.

sendTransaction

public CompletableFuture<BlockEvent.TransactionEvent> sendTransaction(Collection<? extends ProposalResponse> proposalResponses,
                                                                      Collection<Orderer> orderers,
                                                                      User userContext)

Send transaction to one of a specified set of orderers with the specified user context. IF there are no eventing peers this future returns immediately completed indicating that orderer has accepted the transaction only.

Parameters:

proposalResponses -

orderers -

Returns:

Future allowing access to the result of the transaction invocation.

sendTransaction

public CompletableFuture<BlockEvent.TransactionEvent> sendTransaction(Collection<? extends ProposalResponse> proposalResponses,
                                                                      Channel.TransactionOptions transactionOptions)

Send transaction to one of a specified set of orderers with the specified user context. IF there are no eventing peers this future returns immediately completed indicating that orderer has accepted the transaction only.

Parameters:

proposalResponses -

transactionOptions -

Returns:

Future allowing access to the result of the transaction invocation.

registerBlockListener

public String registerBlockListener(BlockListener listener)
                             throws InvalidArgumentException

Register a block listener.

Parameters:

listener - function with single argument with type BlockEvent

Returns:

The handle of the registered block listener.

Throws:

InvalidArgumentException - if the channel is shutdown.

registerBlockListener

public String registerBlockListener(BlockingQueue<QueuedBlockEvent> blockEventQueue)
                             throws InvalidArgumentException

Register a Queued block listener. This queue should never block insertion of events.

Parameters:

blockEventQueue - the queue

Returns:

return a handle to ungregister the handler.

Throws:

InvalidArgumentException

registerBlockListener

public String registerBlockListener(BlockingQueue<QueuedBlockEvent> blockEventQueue,
                                    long timeout,
                                    TimeUnit timeUnit)
                             throws InvalidArgumentException

Register a Queued block listener. This queue should never block insertion of events.

Parameters:

blockEventQueue - the queue

timeout - The time that is waited on for event to be waited on the queue

timeUnit - the time unit for timeout.

Returns:

return a handle to ungregister the handler.

Throws:

InvalidArgumentException

unregisterBlockListener

public boolean unregisterBlockListener(String handle)
                                throws InvalidArgumentException

Unregister a block listener.

Parameters:

handle - of Block listener to remove.

Returns:

false if not found.

Throws:

InvalidArgumentException - if the channel is shutdown or invalid arguments.

getBlockListenerHandles

public Collection<String> getBlockListenerHandles()
                                           throws InvalidArgumentException

Throws:

InvalidArgumentException

registerChaincodeEventListener

public String registerChaincodeEventListener(Pattern chaincodeId,
                                             Pattern eventName,
                                             ChaincodeEventListener chaincodeEventListener)
                                      throws InvalidArgumentException

Register a chaincode event listener. Both chaincodeId pattern AND eventName pattern must match to invoke the chaincodeEventListener

Parameters:

chaincodeId - Java pattern for chaincode identifier also know as chaincode name. If ma

eventName - Java pattern to match the event name.

chaincodeEventListener - The listener to be invoked if both chaincodeId and eventName pattern matches.

Returns:

Handle to be used to unregister the event listener unregisterChaincodeEventListener(String)

Throws:

InvalidArgumentException

unregisterChaincodeEventListener

public boolean unregisterChaincodeEventListener(String handle)
                                         throws InvalidArgumentException

Unregister an existing chaincode event listener.

Parameters:

handle - Chaincode event listener handle to be unregistered.

Returns:

True if the chaincode handler was found and removed.

Throws:

InvalidArgumentException

shutdown

public void shutdown(boolean force)

Shutdown the channel with all resources released.

Parameters:

force - force immediate shutdown.

serializeChannel

public void serializeChannel(File file)
                      throws IOException,
                             InvalidArgumentException

Serialize channel to a file using Java serialization. Deserialized channel will NOT be in an initialized state.

Parameters:

file - file

Throws:

IOException

InvalidArgumentException

serializeChannel

public byte[] serializeChannel()
                        throws IOException,
                               InvalidArgumentException

Serialize channel to a byte array using Java serialization. Deserialized channel will NOT be in an initialized state.

Throws:

InvalidArgumentException

IOException