-
<async> evaluate( [args])
-
Evaluate a transaction function and return its results.
The transaction function will be evaluated on the endorsing peers but
the responses will not be sent to the ordering service and hence will
not be committed to the ledger.
This is used for querying the world state.
Parameters:
| Name |
Type |
Argument |
Description |
args |
string
|
<optional>
<repeatable>
|
Transaction function arguments. |
Returns:
Payload response from the transaction function.
-
Type
-
Promise.<Buffer>
-
getName()
-
Get the fully qualified name of the transaction function.
Returns:
Transaction name.
-
Type
-
string
-
getTransactionId()
-
Get the ID that will be used for this transaction invocation.
Returns:
A transaction ID.
-
Type
-
string
-
setEndorsingOrganizations(orgs)
-
Set the organizations that should be used for endorsement when this
transaction is submitted to the ledger.
Peers that are in the organizations will be used for the endorsement.
This will override the setEndorsingPeers if previously called. Setting
the endorsing organizations will not override discovery, however it will
filter the peers provided by discovery to be those in these organizatons.
Parameters:
| Name |
Type |
Argument |
Description |
orgs |
Array.<string>
|
<repeatable>
|
Endorsing organizations. |
Returns:
This object, to allow function chaining.
-
Type
-
module:fabric-network.Transaction
-
setEndorsingPeers(peers)
-
Set the peers that should be used for endorsement when this transaction
is submitted to the ledger.
Setting the peers will override the use of discovery and the submit will
send the proposal to these peers.
This will override the setEndorsingOrganizations if previously called.
Parameters:
| Name |
Type |
Description |
peers |
Array.<Endorser>
|
Endorsing peers. |
Returns:
This object, to allow function chaining.
-
Type
-
module:fabric-network.Transaction
-
setEventHandler(strategy)
-
Set an event handling strategy to use for this transaction instead of the default configured on the gateway.
Parameters:
| Name |
Type |
Description |
strategy |
|
An event handling strategy. |
Returns:
This object, to allow function chaining.
-
Type
-
module:fabric-network.Transaction
-
setTransient(transientMap)
-
Set transient data that will be passed to the transaction function
but will not be stored on the ledger. This can be used to pass
private data to a transaction function.
Parameters:
| Name |
Type |
Description |
transientMap |
Object
|
Object with String property names and
Buffer property values. |
Returns:
This object, to allow function chaining.
-
Type
-
module:fabric-network.Transaction
-
<async> submit( [args])
-
Submit a transaction to the ledger. The transaction function name
will be evaluated on the endorsing peers and then submitted to the ordering service
for committing to the ledger.
Parameters:
| Name |
Type |
Argument |
Description |
args |
string
|
<optional>
<repeatable>
|
Transaction function arguments. |
Throws:
-
If the transaction was successfully submitted to the orderer but
timed out before a commit event was received from peers.
-
-
Type
-
module:fabric-network.TimeoutError
Returns:
Payload response from the transaction function.
-
Type
-
Buffer