fluencelabs/tendermint
1
0
Fork 0
mirror of https://github.com/fluencelabs/tendermint synced 2025-04-25 06:42:16 +00:00
Code Issues Projects Releases Wiki Activity

docs: (rpc/broadcast_tx_*) write expectations for a client (#3749)

Browse Source 
Refs #3322
This commit is contained in:
Anton Kaliaev 2019-06-24 17:49:49 +04:00 committed by Ethan Buchman
parent a44c621d2d
commit c37faf3ac1
1 changed files with 25 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
rpc/core/mempool.go
View File

@ -19,6 +19,19 @@ import (
// Returns right away, with no response. Does not wait for CheckTx nor // Returns right away, with no response. Does not wait for CheckTx nor
// DeliverTx results. // DeliverTx results.
// //
// If you want to be sure that the transaction is included in a block, you can
// subscribe for the result using JSONRPC via a websocket. See
// https://tendermint.com/docs/app-dev/subscribing-to-events-via-websocket.html
// If you haven't received anything after a couple of blocks, resend it. If the
// same happens again, send it to some other node. A few reasons why it could
// happen:
//
// 1. malicious node can drop or pretend it had committed your tx
// 2. malicious proposer (not necessary the one you're communicating with) can
// drop transactions, which might become valid in the future
// (https://github.com/tendermint/tendermint/issues/3322)
// 3. node can be offline
//
// Please refer to // Please refer to
// https://tendermint.com/docs/tendermint-core/using-tendermint.html#formatting // https://tendermint.com/docs/tendermint-core/using-tendermint.html#formatting
// for formatting/encoding rules. // for formatting/encoding rules.
@ -69,6 +82,18 @@ func BroadcastTxAsync(ctx *rpctypes.Context, tx types.Tx) (*ctypes.ResultBroadca
// Returns with the response from CheckTx. Does not wait for DeliverTx result. // Returns with the response from CheckTx. Does not wait for DeliverTx result.
// //
// If you want to be sure that the transaction is included in a block, you can
// subscribe for the result using JSONRPC via a websocket. See
// https://tendermint.com/docs/app-dev/subscribing-to-events-via-websocket.html
// If you haven't received anything after a couple of blocks, resend it. If the
// same happens again, send it to some other node. A few reasons why it could
// happen:
//
// 1. malicious node can drop or pretend it had committed your tx
// 2. malicious proposer (not necessary the one you're communicating with) can
// drop transactions, which might become valid in the future
// (https://github.com/tendermint/tendermint/issues/3322)
//
// Please refer to // Please refer to
// https://tendermint.com/docs/tendermint-core/using-tendermint.html#formatting // https://tendermint.com/docs/tendermint-core/using-tendermint.html#formatting
// for formatting/encoding rules. // for formatting/encoding rules.