chore: update midnight indexer api to v4

Author: slowbackspace

blockfrost-openapi.yaml

@@ -240,7 +240,7 @@ info:
 
     The Midnight Indexer API exposes a GraphQL API that enables clients to query and subscribe to blockchain data—blocks, transactions, contracts, and wallet-related events—indexed from the Midnight blockchain.
 
-    The deployed version is **v3**. 
+     The deployed version of the Midnight Indexer API is **v4**.
 
     [![Open Midnight GraphQL API Reference](https://img.shields.io/badge/Open_Midnight_GraphQL_API_Reference_→-0033AD?style=for-the-badge)](./midnight/)
 

docs/blockfrost-openapi.yaml

@@ -317,9 +317,7 @@ info:
     and subscribe to blockchain data—blocks, transactions, contracts, and
     wallet-related events—indexed from the Midnight blockchain.
 
-
-    The deployed version is **v3**. 
-
+     The deployed version of the Midnight Indexer API is **v4**.
 
     [![Open Midnight GraphQL API
     Reference](https://img.shields.io/badge/Open_Midnight_GraphQL_API_Reference_→-0033AD?style=for-the-badge)](./midnight/)

docs/midnight/index.html

@@ -23,6 +23,10 @@ type Block {
 	"""
 	author: HexEncoded
 	"""
+	The hex-encoded ledger parameters for this block.
+	"""
+	ledgerParameters: HexEncoded!
+	"""
 	The parent of this block.
 	"""
 	parent: Block
@@ -31,10 +35,6 @@ type Block {
 	"""
 	transactions: [Transaction!]!
 	"""
-	The hex-encoded ledger parameters for this block.
-	"""
-	ledgerParameters: HexEncoded!
-	"""
 	The system parameters (governance) at this block height.
 	"""
 	systemParameters: SystemParameters!
@@ -75,6 +75,19 @@ type CollapsedMerkleTree {
 	protocolVersion: Int!
 }
 
+"""
+Committee member for an epoch.
+"""
+type CommitteeMember {
+	epochNo: Int!
+	position: Int!
+	sidechainPubkeyHex: String!
+	expectedSlots: Int!
+	auraPubkeyHex: String
+	poolIdHex: String
+	spoSkHex: String
+}
+
 """
 A contract action.
 """
@@ -257,6 +270,10 @@ type DustGenerationDtimeUpdate implements DustLedgerEvent {
 	The maximum ID of all dust ledger events.
 	"""
 	maxId: Int!
+	"""
+	The protocol version.
+	"""
+	protocolVersion: Int!
 }
 
 """
@@ -315,6 +332,10 @@ type DustInitialUtxo implements DustLedgerEvent {
 	"""
 	maxId: Int!
 	"""
+	The protocol version.
+	"""
+	protocolVersion: Int!
+	"""
 	The dust output.
 	"""
 	output: DustOutput!
@@ -327,6 +348,7 @@ interface DustLedgerEvent {
 	id: Int!
 	raw: HexEncoded!
 	maxId: Int!
+	protocolVersion: Int!
 }
 
 """
@@ -352,6 +374,41 @@ type DustSpendProcessed implements DustLedgerEvent {
 	The maximum ID of all dust ledger events.
 	"""
 	maxId: Int!
+	"""
+	The protocol version.
+	"""
+	protocolVersion: Int!
+}
+
+"""
+Current epoch information.
+"""
+type EpochInfo {
+	epochNo: Int!
+	durationSeconds: Int!
+	elapsedSeconds: Int!
+}
+
+"""
+SPO performance for an epoch.
+"""
+type EpochPerf {
+	epochNo: Int!
+	spoSkHex: String!
+	produced: Int!
+	expected: Int!
+	identityLabel: String
+	stakeSnapshot: String
+	poolIdHex: String
+	validatorClass: String
+}
+
+"""
+First valid epoch for an SPO identity.
+"""
+type FirstValidEpoch {
+	idKey: String!
+	firstValidEpoch: Int!
 }
 
 scalar HexEncoded
@@ -380,6 +437,32 @@ type ParamChange implements DustLedgerEvent {
 	The maximum ID of all dust ledger events.
 	"""
 	maxId: Int!
+	"""
+	The protocol version.
+	"""
+	protocolVersion: Int!
+}
+
+"""
+Pool metadata from Cardano.
+"""
+type PoolMetadata {
+	poolIdHex: String!
+	hexId: String
+	name: String
+	ticker: String
+	homepageUrl: String
+	logoUrl: String
+}
+
+"""
+Presence event for an SPO in an epoch.
+"""
+type PresenceEvent {
+	epochNo: Int!
+	idKey: String!
+	source: String!
+	status: String
 }
 
 type Query {
@@ -407,6 +490,107 @@ type Query {
 	Get the full history of Terms and Conditions changes for governance auditability.
 	"""
 	termsAndConditionsHistory: [TermsAndConditionsChange!]!
+	"""
+	List SPO identities with pagination.
+	"""
+	spoIdentities(limit: Int, offset: Int): [SpoIdentity!]!
+	"""
+	Get SPO identity by pool ID.
+	"""
+	spoIdentityByPoolId(poolIdHex: String!): SpoIdentity
+	"""
+	Get total count of SPOs.
+	"""
+	spoCount: Int
+	"""
+	Get pool metadata by pool ID.
+	"""
+	poolMetadata(poolIdHex: String!): PoolMetadata
+	"""
+	List pool metadata with pagination.
+	"""
+	poolMetadataList(limit: Int, offset: Int, withNameOnly: Boolean): [PoolMetadata!]!
+	"""
+	Get SPO with metadata by pool ID.
+	"""
+	spoByPoolId(poolIdHex: String!): Spo
+	"""
+	List SPOs with optional search.
+	"""
+	spoList(limit: Int, offset: Int, search: String): [Spo!]!
+	"""
+	Get composite SPO data (identity + metadata + performance).
+	"""
+	spoCompositeByPoolId(poolIdHex: String!): SpoComposite
+	"""
+	Get SPO identifiers ordered by performance.
+	"""
+	stakePoolOperators(limit: Int): [String!]!
+	"""
+	Get latest SPO performance entries.
+	"""
+	spoPerformanceLatest(limit: Int, offset: Int): [EpochPerf!]!
+	"""
+	Get SPO performance by SPO key.
+	"""
+	spoPerformanceBySpoSk(spoSkHex: String!, limit: Int, offset: Int): [EpochPerf!]!
+	"""
+	Get epoch performance for all SPOs.
+	"""
+	epochPerformance(epoch: Int!, limit: Int, offset: Int): [EpochPerf!]!
+	"""
+	Get current epoch information.
+	"""
+	currentEpochInfo: EpochInfo
+	"""
+	Get epoch utilization (produced/expected ratio).
+	"""
+	epochUtilization(epoch: Int!): Float
+	"""
+	Get committee membership for an epoch.
+	"""
+	committee(epoch: Int!): [CommitteeMember!]!
+	"""
+	Get cumulative registration totals for an epoch range.
+	"""
+	registeredTotalsSeries(fromEpoch: Int!, toEpoch: Int!): [RegisteredTotals!]!
+	"""
+	Get registration statistics for an epoch range.
+	"""
+	registeredSpoSeries(fromEpoch: Int!, toEpoch: Int!): [RegisteredStat!]!
+	"""
+	Get raw presence events for an epoch range.
+	"""
+	registeredPresence(fromEpoch: Int!, toEpoch: Int!): [PresenceEvent!]!
+	"""
+	Get first valid epoch for each SPO identity.
+	"""
+	registeredFirstValidEpochs(uptoEpoch: Int): [FirstValidEpoch!]!
+	"""
+	Get stake distribution with search and ordering.
+	"""
+	stakeDistribution(limit: Int, offset: Int, search: String, orderByStakeDesc: Boolean): [StakeShare!]!
+}
+
+"""
+Registration statistics for an epoch.
+"""
+type RegisteredStat {
+	epochNo: Int!
+	federatedValidCount: Int!
+	federatedInvalidCount: Int!
+	registeredValidCount: Int!
+	registeredInvalidCount: Int!
+	dparam: Float
+}
+
+"""
+Cumulative registration totals for an epoch.
+"""
+type RegisteredTotals {
+	epochNo: Int!
+	totalRegistered: Int!
+	newlyRegistered: Int!
 }
 
 """
@@ -539,6 +723,96 @@ type ShieldedTransactionsProgress {
 	highestRelevantEndIndex: Int!
 }
 
+"""
+SPO with optional metadata.
+"""
+type Spo {
+	poolIdHex: String!
+	validatorClass: String!
+	sidechainPubkeyHex: String!
+	auraPubkeyHex: String
+	name: String
+	ticker: String
+	homepageUrl: String
+	logoUrl: String
+}
+
+"""
+Composite SPO data (identity + metadata + performance).
+"""
+type SpoComposite {
+	identity: SpoIdentity
+	metadata: PoolMetadata
+	performance: [EpochPerf!]!
+}
+
+"""
+SPO identity information.
+"""
+type SpoIdentity {
+	poolIdHex: String!
+	mainchainPubkeyHex: String!
+	sidechainPubkeyHex: String!
+	auraPubkeyHex: String
+	validatorClass: String!
+}
+
+"""
+Stake share information for an SPO.
+
+Values are sourced from mainchain pool data (e.g., Blockfrost) and keyed by Cardano pool_id.
+"""
+type StakeShare {
+	"""
+	Cardano pool ID (56-character hex string).
+	"""
+	poolIdHex: String!
+	"""
+	Pool name from metadata.
+	"""
+	name: String
+	"""
+	Pool ticker from metadata.
+	"""
+	ticker: String
+	"""
+	Pool homepage URL from metadata.
+	"""
+	homepageUrl: String
+	"""
+	Pool logo URL from metadata.
+	"""
+	logoUrl: String
+	"""
+	Current live stake in lovelace.
+	"""
+	liveStake: String
+	"""
+	Current active stake in lovelace.
+	"""
+	activeStake: String
+	"""
+	Number of live delegators.
+	"""
+	liveDelegators: Int
+	"""
+	Saturation ratio (0.0 to 1.0+).
+	"""
+	liveSaturation: Float
+	"""
+	Declared pledge in lovelace.
+	"""
+	declaredPledge: String
+	"""
+	Current live pledge in lovelace.
+	"""
+	livePledge: String
+	"""
+	Stake share as a fraction of total stake.
+	"""
+	stakeShare: Float
+}
+
 type Subscription {
 	"""
 	Subscribe to blocks starting at the given offset or at the latest block if the offset is
@@ -833,6 +1107,10 @@ type ZswapLedgerEvent {
 	The maximum ID of all zswap ledger events.
 	"""
 	maxId: Int!
+	"""
+	The protocol version.
+	"""
+	protocolVersion: Int!
 }
 
 """