Skip to content

docs: expand agent multichain safety guidance - #997

Closed
grayfoxd wants to merge 1 commit into
tronprotocol:feat/v4.13.0from
grayfoxd:feat/v4.13.0
Closed

docs: expand agent multichain safety guidance#997
grayfoxd wants to merge 1 commit into
tronprotocol:feat/v4.13.0from
grayfoxd:feat/v4.13.0

Conversation

@grayfoxd

@grayfoxd grayfoxd commented Sep 3, 2026

Copy link
Copy Markdown
Collaborator

No description provided.

Comment on lines +202 to +208
The catalog deliberately does not prescribe retry behavior. A transport `timeout` or `rpc_error`
only says that the CLI did not observe a successful response. For a read-only call, retrying the same
request is normally harmless. On a submit path, however, the node may have accepted the transaction
before the response was lost. Treat that outcome as unknown: reconcile by `txId` when available, or
by sender and nonce for EVM, before building and signing another transaction. Re-running a send does
not retry the same transaction; it creates a second transaction and can duplicate a payment.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a section more clearly to explain the same thing

retry describes the error, not the command. timeout and rpc_error are same because
for most calls that is correct — the node never acted, so resending is free. But a command that
may have already broadcast a transaction (tx send and anything else on the submit path) can hit
timeout or rpc_error after the node accepted the transaction and before the response made it
back. In that case the outcome is unknown, not failed, and resending does not retry the original
request — it builds and signs a new transaction, which on TRON is a second, distinct transfer.
retry: "same" is correct for a timeout/rpc_error that happens while resolving a network id or
reading a balance; it is not a license to resend a broadcast blind. Reconcile with
[tx status](https://github.com/tronprotocol/wallet-cli/pull/997/changes#script-safety-never-mistake-submitted-for-confirmed) before deciding whether to
retry, exactly as the four-state model below requires.

@grayfoxd grayfoxd closed this Sep 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants