graphql-alt: ProtocolConfigs

## Description

Fetch protocol configs by protocol version, and by epoch.

## Test plan

New E2E tests:

```
sui$ cargo nextest run         \
  -p sui-indexer-alt-e2e-tests \
  -- graphql/epoch/protocol_configs
```

Author: amnn

crates/sui-indexer-alt-e2e-tests/tests/graphql/epochs/protocol_configs.move

@@ -0,0 +1,36 @@
+// Copyright (c) Mysten Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+//# init --protocol-version 70 --accounts A --simulator
+
+//# create-checkpoint
+
+//# run-graphql
+{ # Protocol Configs that don't exist (because they haven't been used in the
+  # chain being indexed) -- their config lists will be empty.
+  before: protocolConfigs(version: 69) {
+    protocolVersion
+    configs { key value }
+  }
+
+  after: protocolConfigs(version: 71) {
+    protocolVersion
+    configs { key value }
+  }
+}
+
+//# run-graphql
+{
+  protocolConfigs(version: 70) {
+    config(key: "max_move_object_size") { key value }
+    featureFlag(key: "enable_effects_v2") { key value }
+  }
+}
+
+//# run-graphql
+{ # Fetch protocol config version via epoch
+  epoch(epochId: 0) { protocolConfigs { protocolVersion } }
+
+  # Fetch protocol config via version
+  protocolConfigs(version: 70) { protocolVersion }
+}

crates/sui-indexer-alt-e2e-tests/tests/graphql/epochs/protocol_configs.snap

@@ -0,0 +1,58 @@
+---
+source: external-crates/move/crates/move-transactional-test-runner/src/framework.rs
+---
+processed 5 tasks
+
+init:
+A: object(0,0)
+
+task 1, line 6:
+//# create-checkpoint
+Checkpoint created: 1
+
+task 2, lines 8-20:
+//# run-graphql
+Response: {
+  "data": {
+    "before": {
+      "protocolVersion": 69,
+      "configs": []
+    },
+    "after": {
+      "protocolVersion": 71,
+      "configs": []
+    }
+  }
+}
+
+task 3, lines 22-28:
+//# run-graphql
+Response: {
+  "data": {
+    "protocolConfigs": {
+      "config": {
+        "key": "max_move_object_size",
+        "value": "256000"
+      },
+      "featureFlag": {
+        "key": "enable_effects_v2",
+        "value": true
+      }
+    }
+  }
+}
+
+task 4, lines 30-36:
+//# run-graphql
+Response: {
+  "data": {
+    "epoch": {
+      "protocolConfigs": {
+        "protocolVersion": 70
+      }
+    },
+    "protocolConfigs": {
+      "protocolVersion": 70
+    }
+  }
+}

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

@@ -61,6 +61,10 @@ type Epoch {
 	"""
 	epochId: UInt53!
 	"""
+	The epoch's corresponding protocol configuration, including the feature flags and the configuration options.
+	"""
+	protocolConfigs: ProtocolConfigs
+	"""
 	The minimum gas price that a quorum of validators are guaranteed to sign a transaction for in this epoch.
 	"""
 	referenceGasPrice: BigInt
@@ -74,6 +78,20 @@ type Epoch {
 	endTimestamp: DateTime
 }
 
+"""
+A boolean protocol configuration.
+"""
+type FeatureFlag {
+	"""
+	Feature flag name.
+	"""
+	key: String!
+	"""
+	Feature flag value.
+	"""
+	value: Boolean!
+}
+
 
 """
 Interface implemented by GraphQL types representing entities that are identified by an address.
@@ -298,6 +316,45 @@ type PageInfo {
 	endCursor: String
 }
 
+"""
+A protocol configuration that can hold an arbitrary value (or no value at all).
+"""
+type ProtocolConfig {
+	"""
+	Configuration name.
+	"""
+	key: String!
+	"""
+	Configuration value.
+	"""
+	value: String
+}
+
+"""
+Constants that control how the chain operates.
+
+These can only change during protocol upgrades which happen on epoch boundaries. Configuration is split into feature flags (which are just booleans), and configs which can take any value (including no value at all), and will be represented by a string.
+"""
+type ProtocolConfigs {
+	protocolVersion: UInt53!
+	"""
+	Query for the value of the configuration with name `key`.
+	"""
+	config(key: String!): ProtocolConfig
+	"""
+	List all available configurations and their values.
+	"""
+	configs: [ProtocolConfig!]!
+	"""
+	Query for the state of the feature flag with name `key`.
+	"""
+	featureFlag(key: String!): FeatureFlag
+	"""
+	List all available feature flags and their values.
+	"""
+	featureFlags: [FeatureFlag!]!
+}
+
 type Query {
 	"""
 	First four bytes of the network's genesis checkpoint digest (uniquely identifies the network), hex-encoded.
@@ -386,6 +443,10 @@ type Query {
 	"""
 	package(address: SuiAddress!, version: UInt53, atCheckpoint: UInt53): MovePackage
 	"""
+	Fetch the protocol config by protocol version.
+	"""
+	protocolConfigs(version: UInt53!): ProtocolConfigs
+	"""
 	Configuration for this RPC service.
 	"""
 	serviceConfig: ServiceConfig!

crates/sui-indexer-alt-graphql/src/api/query.rs

@@ -14,6 +14,7 @@ use super::{
         epoch::Epoch,
         move_package::{self, MovePackage, PackageKey},
         object::{self, Object, ObjectKey},
+        protocol_configs::ProtocolConfigs,
         service_config::ServiceConfig,
         transaction::Transaction,
         transaction_effects::TransactionEffects,
@@ -222,6 +223,11 @@ impl Query {
         .await
     }
 
+    /// Fetch the protocol config by protocol version.
+    async fn protocol_configs(&self, version: UInt53) -> Option<ProtocolConfigs> {
+        Some(ProtocolConfigs::with_protocol_version(version.into()))
+    }
+
     /// Configuration for this RPC service.
     async fn service_config(&self) -> ServiceConfig {
         ServiceConfig

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

@@ -17,6 +17,8 @@ use crate::{
     scope::Scope,
 };
 
+use super::protocol_configs::ProtocolConfigs;
+
 pub(crate) struct Epoch {
     pub(crate) epoch_id: u64,
     pub(crate) scope: Scope,
@@ -63,6 +65,17 @@ impl Epoch {
 
 #[Object]
 impl EpochStart {
+    /// The epoch's corresponding protocol configuration, including the feature flags and the configuration options.
+    async fn protocol_configs(&self) -> Option<ProtocolConfigs> {
+        let Some(contents) = &self.contents else {
+            return None;
+        };
+
+        Some(ProtocolConfigs::with_protocol_version(
+            contents.protocol_version as u64,
+        ))
+    }
+
     /// The minimum gas price that a quorum of validators are guaranteed to sign a transaction for in this epoch.
     async fn reference_gas_price(&self) -> Option<BigInt> {
         let Some(contents) = &self.contents else {

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

@@ -7,6 +7,7 @@ pub(crate) mod epoch;
 pub(crate) mod move_package;
 pub(crate) mod object;
 pub(crate) mod object_change;
+pub(crate) mod protocol_configs;
 pub(crate) mod service_config;
 pub(crate) mod transaction;
 pub(crate) mod transaction_effects;