query_sui_events
Query and filter blockchain events on the Sui network to monitor transactions, track smart contract interactions, and analyze on-chain activity across mainnet and testnet environments.
Instructions
Query Sui events
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Optional: Pagination cursor | |
| descendingOrder | No | Optional: Sort order (default: false) | |
| limit | No | Optional: Number of results to return | |
| network | No | Network type (defaults to mainnet) | |
| query | Yes | Event query filter |
Implementation Reference
- src/handlers/sui-handlers.ts:472-490 (handler)Tool handler logic: extracts arguments, invokes SuiService.queryEvents, and formats the response for MCP.case 'query_sui_events': { const query = args?.query as any; const cursor = args?.cursor as string | undefined; const limit = args?.limit as number | undefined; const descendingOrder = args?.descendingOrder as boolean | undefined; const network = (args?.network as 'mainnet' | 'testnet') || 'mainnet'; const result = await suiService.queryEvents(query, cursor, limit, descendingOrder, network); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], isError: !result.success, }; }
- src/handlers/sui-handlers.ts:241-271 (schema)Tool schema definition including input parameters for querying Sui events.{ name: 'query_sui_events', description: 'Query Sui events', inputSchema: { type: 'object', properties: { query: { type: 'object', description: 'Event query filter', }, cursor: { type: 'string', description: 'Optional: Pagination cursor', }, limit: { type: 'number', description: 'Optional: Number of results to return', }, descendingOrder: { type: 'boolean', description: 'Optional: Sort order (default: false)', }, network: { type: 'string', enum: ['mainnet', 'testnet'], description: 'Network type (defaults to mainnet)', }, }, required: ['query'], }, },
- src/services/sui-service.ts:296-318 (helper)SuiService.queryEvents method: resolves the Sui RPC service and invokes the suix_queryEvents RPC method with constructed parameters.async queryEvents( query: any, cursor?: string, limit?: number, descendingOrder?: boolean, network: 'mainnet' | 'testnet' = 'mainnet' ): Promise<EndpointResponse> { const service = this.blockchainService.getServiceByBlockchain('sui', network); if (!service) { return { success: false, error: `Sui service not found for ${network}`, }; } const params: any[] = [query]; if (cursor !== undefined) params.push(cursor); if (limit !== undefined) params.push(limit); if (descendingOrder !== undefined) params.push(descendingOrder); return this.blockchainService.callRPCMethod(service.id, 'suix_queryEvents', params); }