iotaledger / iota / 29062660040

69%

Build Type

push

github

Committed by web-flow

Commit Message

feat(grpc): add `balance_changes` and `object_changes` to `ExecutedTransaction` (#12183)

# Description of change

Adds server-side support for `balance_changes` and `object_changes` on
the gRPC API, the equivalent of the JSON-RPC `showBalanceChanges` /
`showObjectChanges` response options. Both fields are strictly opt-in —
populated only when the request's read mask names them — and are not
part of any default read mask.

Companion PR adding the proto types: iotaledger/iota-rust-sdk#1255. This
PR bumps the `iota-rust-sdk` rev to pick up those types; the rev should
be re-pointed to the merge commit once
https://github.com/iotaledger/iota-rust-sdk/pull/1255 lands.

## What & how

- New synchronous derivation module
`crates/iota-grpc-server/src/changes.rs`. It computes both change sets
from data the server already holds in memory — the transaction effects
plus its input/output objects — so **no new lookup tables or indexes**
are introduced. Semantics mirror
`crates/iota-json-rpc/src/balance_changes.rs` and `object_changes.rs`,
including the gas-only balance change for failed transactions and the
mocked-gas-coin exclusion for simulations.
- Wired through all four `ExecutedTransaction` producers:
`get_transactions`, `execute_transactions`, `simulate_transactions`, and
the checkpoint endpoints (`get_checkpoint` / `stream_checkpoints`, as
`transactions.balance_changes` / `transactions.object_changes`).
- The derived fields force the fetch of effects and input/output objects
(and the transaction, for the sender) even when those aren't themselves
in the mask; over-fetched data never leaks into the response, as the
`Merge` impls only populate mask-requested fields.

## Completeness contract on pruned objects

Requesting `input_objects` / `output_objects` / `balance_changes` /
`object_changes` for a transaction whose objects the node no longer has
(e.g. pruned) now returns a per-item `FAILED_PRECONDITION` naming the
unavailable object, instead of a silently sho... (continued)

Coverage Stats

567 of 636 new or added lines in 6 files covered. (89.15%)

464 existing lines in 36 files now uncovered.

161656 of 237396 relevant lines covered (68.1%)

456174.28 hits per line