feat: Return ObjectChange in ExecuteTx and DryRun

[howjmay]

In the previous JSON RPC, iota_executeTransactionBlock and dry run would return
object changes and balance changes. However, thee fields are not returned in
the current GraphQL sdk.

[howjmay]

Hi @Thoralf-M I am meeting a problem, and I am having no idea how to solve it.
This PR aims to return ObjectChanges. However, the object type of a created object in the ObjectChanges is not returned.
I am not sure whether it is an issue in GraphQL side? Maybe it is just not possible based on the current GraphQL, or node impl?
Thank you

[Thoralf-M]

Hi @Thoralf-M I am meeting a problem, and I am having no idea how to solve it. This PR aims to return ObjectChanges. However, the object type of a created object in the ObjectChanges is not returned. I am not sure whether it is an issue in GraphQL side? Maybe it is just not possible based on the current GraphQL, or node impl? Thank you

GraphQL definitely supports that, seems like the SDK should be adjusted so TransactionEffectsV1::changed_objects contain the full objects for the input and output changes instead of the current ObjectIn, ObjectOut structs

[Thoralf-M]

I created this issue #314 to make the data available

[howjmay]

Thank you @Thoralf-M

[Thoralf-M]

We don't like to modify the TransactionBlockEffects struct like this as this would be requested for all requests then even if users don't care about the information
Instead an own request should be send, would this work for you?

// Copyright (c) 2025 IOTA Stiftung
// SPDX-License-Identifier: Apache-2.0

use cynic::QueryBuilder;
use eyre::Result;
use iota_graphql_client::{
    Client,
    query_types::{Base64, BigInt, schema},
};
use iota_types::Address;

#[derive(cynic::QueryVariables, Debug)]
pub struct TransactionBlockArgs {
    pub digest: String,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(
    schema = "rpc",
    graphql_type = "Query",
    variables = "TransactionBlockArgs"
)]
pub struct TransactionBlockEffectsQuery {
    #[arguments(digest: $digest)]
    pub transaction_block: Option<TxBlockEffects>,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "TransactionBlock")]
pub struct TxBlockEffects {
    pub effects: Option<TransactionBlockEffects>,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "TransactionBlockEffects")]
pub struct TransactionBlockEffects {
    #[cynic(rename = "objectChanges")]
    pub object_changes: Option<ObjectChangeConnection>,
    // here are more fields available, but we only care about object changes
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "ObjectChangeConnection")]
pub struct ObjectChangeConnection {
    pub nodes: Vec<ObjectChange>,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "ObjectChange")]
pub struct ObjectChange {
    pub address: Address,
    #[cynic(rename = "inputState")]
    pub input_state: Option<Object>,
    #[cynic(rename = "outputState")]
    pub output_state: Option<Object>,
    #[cynic(rename = "idCreated")]
    pub id_created: Option<bool>,
    #[cynic(rename = "idDeleted")]
    pub id_deleted: Option<bool>,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "Object")]
pub struct Object {
    pub address: Address,
    pub digest: Option<String>,
    pub version: u64,
    pub status: ObjectKind,
    pub owner: Option<ObjectOwner>,
    #[cynic(rename = "previousTransactionBlock")]
    pub previous_transaction_block: Option<TransactionBlock>,
    #[cynic(rename = "storageRebate")]
    pub storage_rebate: Option<BigInt>,
    pub display: Option<Vec<DisplayEntry>>,
    #[cynic(rename = "asMoveObject")]
    pub as_move_object: Option<MoveObject>,
    #[cynic(rename = "asMovePackage")]
    pub as_move_package: Option<MovePackage>,
    pub bcs: Option<Base64>,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "MoveObject")]
pub struct MoveObject {
    pub contents: Option<MoveValue>,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "MoveValue")]
pub struct MoveValue {
    #[cynic(rename = "type")]
    pub type_: MoveType,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "MoveType")]
pub struct MoveType {
    pub repr: String,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "TransactionBlock")]
pub struct TransactionBlock {
    pub digest: Option<String>,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "DisplayEntry")]
pub struct DisplayEntry {
    pub key: String,
    pub value: Option<String>,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "MovePackage")]
pub struct MovePackage {
    pub address: Address,
}

#[derive(cynic::Enum, Debug, Clone, Copy, PartialEq, Eq)]
#[cynic(schema = "rpc", graphql_type = "ObjectKind")]
pub enum ObjectKind {
    #[cynic(rename = "NOT_INDEXED")]
    NotIndexed,
    #[cynic(rename = "INDEXED")]
    Indexed,
    #[cynic(rename = "WRAPPED_OR_DELETED")]
    WrappedOrDeleted,
}

#[derive(cynic::InlineFragments, Debug)]
#[cynic(schema = "rpc")]
pub enum ObjectOwner {
    Immutable(Immutable),
    Shared(Shared),
    Parent(Parent),
    AddressOwner(AddressOwner),
    #[cynic(fallback)]
    Fallback,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "Immutable")]
pub struct Immutable {
    pub __typename: String,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "Shared")]
pub struct Shared {
    pub __typename: String,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "Parent")]
pub struct Parent {
    pub __typename: String,
}

#[derive(cynic::QueryFragment, Debug)]
#[cynic(schema = "rpc", graphql_type = "AddressOwner")]
pub struct AddressOwner {
    pub __typename: String,
}

#[tokio::main]
async fn main() -> Result<()> {
    let client = Client::new_devnet();

    let digest = "Agug2GETToZj4Ncw3RJn2KgDUEpVQKG1WaTZVcLcqYnf".to_string();
    let operation = TransactionBlockEffectsQuery::build(TransactionBlockArgs { digest });
    let response = client
        .run_query::<TransactionBlockEffectsQuery, TransactionBlockArgs>(&operation)
        .await;
    println!("{response:#?}");

    Ok(())
}