@@ -104,104 +104,3 @@ curl -X POST \
104
104
]
105
105
}
106
106
```
107
-
108
- ---
109
-
110
- ### 2. Steward Events
111
-
112
- ** Purpose** : Retrieves Jito Steward program events with filtering and pagination support. Returns detailed information about stakenet decisions and operations.
113
-
114
- ** Endpoint** : ` /api/v1/steward_events `
115
-
116
- ** Method** : ` GET or POST `
117
-
118
- ** Base URL** : ` https://kobe.mainnet.jito.network `
119
-
120
- #### Query Parameters
121
-
122
- | Parameter | Type | Required | Default | Description |
123
- | -------------- | ------ | -------- | -------- | ------------------------------------------------------------- |
124
- | ` event_type ` | string | No | - | Filter by specific steward event type (see Event Types below) |
125
- | ` vote_account ` | string | No | - | Filter by validator vote account public key |
126
- | ` epoch ` | number | No | - | Filter by specific epoch number |
127
- | ` limit ` | number | No | 100 | Number of results to return (used with skip for pagination) |
128
- | ` skip ` | number | No | 0 | Number of results to skip for pagination |
129
-
130
- #### Event Types
131
-
132
- | Event Type. | Versions Supported | Description |
133
- | -------------------------- | ------------------ | ------------------------------------------------------ |
134
- | ` ScoreComponents ` | V1, V2, V3 | Validator scoring calculations and performance metrics |
135
- | ` InstantUnstakeComponents ` | V1, V2, V3 | Emergency unstaking events for problematic validators |
136
- | ` RebalanceEvent ` | V1 | Stake rebalancing operations across validators |
137
- | ` DecreaseComponents ` | V1 | Stake reduction events for underperforming validators |
138
- | ` StateTransition ` | V1 | Steward operational state changes |
139
- | ` AutoAddValidatorEvent ` | V1 | Automatic validator additions to the stake pool |
140
- | ` AutoRemoveValidatorEvent ` | V1 | Automatic validator removals from the stake pool |
141
- | ` EpochMaintenanceEvent ` | V1 | Routine epoch-boundary maintenance operations |
142
-
143
- #### Special Event Type Handling
144
-
145
- - ** ScoreComponents** : Queries all versions (ScoreComponents, ScoreComponentsV2, ScoreComponentsV3)
146
- - ** InstantUnstakeComponents** : Queries all versions (InstantUnstakeComponents, InstantUnstakeComponentsV2, InstantUnstakeComponentsV3)
147
-
148
- #### Response Fields
149
-
150
- | Field | Type | Description |
151
- | -------- | -------- | ------------------------------ |
152
- | ` events ` | array | Array of steward event objects |
153
-
154
- #### Steward Event Object Fields
155
-
156
- | Field | Type | Description |
157
- | -------------- | ------------ | ----------------------------------------------------------------- |
158
- | ` signature ` | string | Transaction signature where the event occurred |
159
- | ` event_type ` | string | Type of steward event (e.g., "AutoAddValidatorEvent") |
160
- | ` vote_account ` | string | Validator vote account public key associated with the event |
161
- | ` timestamp ` | string | ISO 8601 timestamp when the event occurred |
162
- | ` epoch ` | number | Epoch number when the event took place |
163
- | ` slot ` | number | Blockchain slot number where the event occurred |
164
- | ` data ` | object | Event-specific data (varies by event type) |
165
- | ` tx_error ` | string/null | Transaction error message if the event failed, null if successful |
166
-
167
- #### Sorting and Pagination
168
-
169
- - ** Default Sort** : Events are sorted by slot number in descending order (newest first)
170
- - ** Pagination** : Use ` limit ` and ` skip ` parameters for pagination
171
- - ** Total Count** : Response includes total count for pagination calculation
172
-
173
- #### Example Request
174
-
175
- ``` bash
176
- curl -X POST \
177
- https://kobe.mainnet.jito.network/api/v1/steward_events \
178
- -H ' Content-Type: application/json' \
179
- -d ' {
180
- "event_type": "ScoreComponents",
181
- "epoch": 837,
182
- "limit": 50,
183
- "skip": 0
184
- }'
185
- ```
186
-
187
- #### Example Response
188
-
189
- ``` json
190
- {
191
- "events" : [
192
- {
193
- "signature" : " 48TciVTNG2kVVE8CnCbAQjRG7qCk7HMyunNRZR1zT8gYNWRvg2kPPjSDuwwrHnTjvXGAqQ6WJY18DQybQPBGw2Uc" ,
194
- "event_type" : " AutoAddValidatorEvent" ,
195
- "vote_account" : " Csp2hDVRX4cRitFEswJJcoH9ju4rcPUSsqU9pkh5JBQU" ,
196
- "timestamp" : " 2025-08-21T18:42:42Z" ,
197
- "data" : {
198
- "validator_list_index" : 1039
199
- },
200
- "epoch" : 837 ,
201
- "tx_error" : null
202
- },
203
- // …
204
- ]
205
- }
206
- ```
207
-
0 commit comments