graphql-alt: Object.objectAt

## Description

Support fetching a different version of an existing object. This is
mostly helpful if you have fetched an object in response to some nested
query, and then want to modify the version of it you are looking at.

## Test plan

New E2E tests:

```
sui$ cargo nextest run         \
  -p sui-indexer-alt-e2e-tests \
  -- graphql/objects/object_at
```

Author: amnn

crates/sui-indexer-alt-e2e-tests/tests/graphql/objects/object_at.move

@@ -0,0 +1,41 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+//# init --protocol-version 70 --accounts A --simulator
+
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+
+//# create-checkpoint
+
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+
+//# create-checkpoint
+
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+
+//# create-checkpoint
+
+//# run-graphql
+{
+  object(address: "@{obj_0_0}") {
+    version
+
+    initial: objectAt(version: 1) { version }
+    byCheckpoint: objectAt(checkpoint: 2) { version }
+    byRootVersion: objectAt(rootVersion: 3) { version }
+  }
+}

crates/sui-indexer-alt-e2e-tests/tests/graphql/objects/object_at.snap

@@ -0,0 +1,73 @@
+---
+source: external-crates/move/crates/move-transactional-test-runner/src/framework.rs
+---
+processed 10 tasks
+
+init:
+A: object(0,0)
+
+task 1, lines 6-8:
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+mutated: object(0,0)
+gas summary: computation_cost: 1000000, storage_cost: 988000,  storage_rebate: 0, non_refundable_storage_fee: 0
+
+task 2, lines 10-12:
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+mutated: object(0,0)
+gas summary: computation_cost: 1000000, storage_cost: 988000,  storage_rebate: 978120, non_refundable_storage_fee: 9880
+
+task 3, line 14:
+//# create-checkpoint
+Checkpoint created: 1
+
+task 4, lines 16-18:
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+mutated: object(0,0)
+gas summary: computation_cost: 1000000, storage_cost: 988000,  storage_rebate: 978120, non_refundable_storage_fee: 9880
+
+task 5, lines 20-22:
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+mutated: object(0,0)
+gas summary: computation_cost: 1000000, storage_cost: 988000,  storage_rebate: 978120, non_refundable_storage_fee: 9880
+
+task 6, line 24:
+//# create-checkpoint
+Checkpoint created: 2
+
+task 7, lines 26-28:
+//# programmable --sender A --inputs 1
+//> SplitCoins(Gas, [Input(0)]);
+//> MergeCoins(Gas, [Result(0)])
+mutated: object(0,0)
+gas summary: computation_cost: 1000000, storage_cost: 988000,  storage_rebate: 978120, non_refundable_storage_fee: 9880
+
+task 8, line 30:
+//# create-checkpoint
+Checkpoint created: 3
+
+task 9, lines 32-41:
+//# run-graphql
+Response: {
+  "data": {
+    "object": {
+      "version": 6,
+      "initial": {
+        "version": 1
+      },
+      "byCheckpoint": {
+        "version": 5
+      },
+      "byRootVersion": {
+        "version": 3
+      }
+    }
+  }
+}

crates/sui-indexer-alt-graphql/schema.graphql

@@ -122,6 +122,10 @@ interface IObject {
 	"""
 	digest: String!
 	"""
+	Fetch the object with the same ID, at a different version, root version bound, or checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this object, as an `Object`.
 	"""
 	objectBcs: Base64
@@ -157,6 +161,12 @@ type MovePackage implements IAddressable & IObject {
 	"""
 	digest: String!
 	"""
+	Fetch the package as an object with the same ID, at a different version, root version bound, or checkpoint.
+	
+	If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this package, as an `Object`.
 	"""
 	objectBcs: Base64
@@ -201,6 +211,12 @@ type Object implements IAddressable & IObject {
 	"""
 	asMovePackage: MovePackage
 	"""
+	Fetch the object with the same ID, at a different version, root version bound, or checkpoint.
+	
+	If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this object, as an `Object`.
 	"""
 	objectBcs: Base64

crates/sui-indexer-alt-graphql/src/api/types/move_package.rs

@@ -80,6 +80,21 @@ impl MovePackage {
         ObjectImpl::from(&self.super_).digest()
     }
 
+    /// Fetch the package as an object with the same ID, at a different version, root version bound, or checkpoint.
+    ///
+    /// If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+    pub(crate) async fn object_at(
+        &self,
+        ctx: &Context<'_>,
+        version: Option<UInt53>,
+        root_version: Option<UInt53>,
+        checkpoint: Option<UInt53>,
+    ) -> Result<Option<Object>, RpcError<object::Error>> {
+        ObjectImpl::from(&self.super_)
+            .object_at(ctx, version, root_version, checkpoint)
+            .await
+    }
+
     /// The Base64-encoded BCS serialization of this package, as an `Object`.
     pub(crate) async fn object_bcs(
         &self,

crates/sui-indexer-alt-graphql/src/api/types/object.rs

@@ -56,6 +56,14 @@ use super::{
         ty = "String",
         desc = "32-byte hash that identifies the object's contents, encoded in Base58.",
     ),
+    field(
+        name = "object_at",
+        arg(name = "version", ty = "Option<UInt53>"),
+        arg(name = "root_version", ty = "Option<UInt53>"),
+        arg(name = "checkpoint", ty = "Option<UInt53>"),
+        ty = "Result<Option<Object>, RpcError<Error>>",
+        desc = "Fetch the object with the same ID, at a different version, root version bound, or checkpoint.",
+    ),
     field(
         name = "object_bcs",
         ty = "Result<Option<Base64>, RpcError>",
@@ -174,6 +182,21 @@ impl Object {
         MovePackage::from_object(self, ctx).await
     }
 
+    /// Fetch the object with the same ID, at a different version, root version bound, or checkpoint.
+    ///
+    /// If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+    async fn object_at(
+        &self,
+        ctx: &Context<'_>,
+        version: Option<UInt53>,
+        root_version: Option<UInt53>,
+        checkpoint: Option<UInt53>,
+    ) -> Result<Option<Self>, RpcError<Error>> {
+        ObjectImpl::from(self)
+            .object_at(ctx, version, root_version, checkpoint)
+            .await
+    }
+
     /// The Base64-encoded BCS serialization of this object, as an `Object`.
     async fn object_bcs(&self, ctx: &Context<'_>) -> Result<Option<Base64>, RpcError<Error>> {
         ObjectImpl::from(self).object_bcs(ctx).await
@@ -490,6 +513,23 @@ impl ObjectImpl<'_> {
         Base58::encode(self.0.digest.inner())
     }
 
+    pub(crate) async fn object_at(
+        &self,
+        ctx: &Context<'_>,
+        version: Option<UInt53>,
+        root_version: Option<UInt53>,
+        checkpoint: Option<UInt53>,
+    ) -> Result<Option<Object>, RpcError<Error>> {
+        let key = ObjectKey {
+            address: self.0.super_.address.into(),
+            version,
+            root_version,
+            at_checkpoint: checkpoint,
+        };
+
+        Object::by_key(ctx, self.0.super_.scope.clone(), key).await
+    }
+
     pub(crate) async fn object_bcs(
         &self,
         ctx: &Context<'_>,

crates/sui-indexer-alt-graphql/src/snapshots/sui_indexer_alt_graphql__tests__schema.graphql.snap

@@ -126,6 +126,10 @@ interface IObject {
 	"""
 	digest: String!
 	"""
+	Fetch the object with the same ID, at a different version, root version bound, or checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this object, as an `Object`.
 	"""
 	objectBcs: Base64
@@ -161,6 +165,12 @@ type MovePackage implements IAddressable & IObject {
 	"""
 	digest: String!
 	"""
+	Fetch the package as an object with the same ID, at a different version, root version bound, or checkpoint.
+	
+	If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this package, as an `Object`.
 	"""
 	objectBcs: Base64
@@ -205,6 +215,12 @@ type Object implements IAddressable & IObject {
 	"""
 	asMovePackage: MovePackage
 	"""
+	Fetch the object with the same ID, at a different version, root version bound, or checkpoint.
+	
+	If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this object, as an `Object`.
 	"""
 	objectBcs: Base64

crates/sui-indexer-alt-graphql/src/snapshots/sui_indexer_alt_graphql__tests__staging.graphql.snap

@@ -126,6 +126,10 @@ interface IObject {
 	"""
 	digest: String!
 	"""
+	Fetch the object with the same ID, at a different version, root version bound, or checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this object, as an `Object`.
 	"""
 	objectBcs: Base64
@@ -161,6 +165,12 @@ type MovePackage implements IAddressable & IObject {
 	"""
 	digest: String!
 	"""
+	Fetch the package as an object with the same ID, at a different version, root version bound, or checkpoint.
+	
+	If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this package, as an `Object`.
 	"""
 	objectBcs: Base64
@@ -205,6 +215,12 @@ type Object implements IAddressable & IObject {
 	"""
 	asMovePackage: MovePackage
 	"""
+	Fetch the object with the same ID, at a different version, root version bound, or checkpoint.
+	
+	If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this object, as an `Object`.
 	"""
 	objectBcs: Base64

crates/sui-indexer-alt-graphql/staging.graphql

@@ -122,6 +122,10 @@ interface IObject {
 	"""
 	digest: String!
 	"""
+	Fetch the object with the same ID, at a different version, root version bound, or checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this object, as an `Object`.
 	"""
 	objectBcs: Base64
@@ -157,6 +161,12 @@ type MovePackage implements IAddressable & IObject {
 	"""
 	digest: String!
 	"""
+	Fetch the package as an object with the same ID, at a different version, root version bound, or checkpoint.
+	
+	If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this package, as an `Object`.
 	"""
 	objectBcs: Base64
@@ -201,6 +211,12 @@ type Object implements IAddressable & IObject {
 	"""
 	asMovePackage: MovePackage
 	"""
+	Fetch the object with the same ID, at a different version, root version bound, or checkpoint.
+	
+	If no additional bound is provided, the latest version of this object is fetched at the latest checkpoint.
+	"""
+	objectAt(version: UInt53, rootVersion: UInt53, checkpoint: UInt53): Object
+	"""
 	The Base64-encoded BCS serialization of this object, as an `Object`.
 	"""
 	objectBcs: Base64