get_sui_checkpoint

Instructions

Implementation Reference

• src/handlers/sui-handlers.ts:222-240 (schema)

  Tool schema definition including name, description, and inputSchema for validating get_sui_checkpoint parameters.

  {
    name: 'get_sui_checkpoint',
    description: 'Get checkpoint details by ID',
    inputSchema: {
      type: 'object',
      properties: {
        checkpointId: {
          type: ['string', 'number'],
          description: 'Checkpoint ID or sequence number',
        },
        network: {
          type: 'string',
          enum: ['mainnet', 'testnet'],
          description: 'Network type (defaults to mainnet)',
        },
      },
      required: ['checkpointId'],
    },
  },

• src/handlers/sui-handlers.ts:455-470 (handler)

  Handler logic for the get_sui_checkpoint tool. Extracts parameters, calls SuiService.getCheckpoint, and formats the response.

  case 'get_sui_checkpoint': {
    const checkpointId = args?.checkpointId as string | number;
    const network = (args?.network as 'mainnet' | 'testnet') || 'mainnet';
  
    const result = await suiService.getCheckpoint(checkpointId, network);
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
      isError: !result.success,
    };
  }

• src/services/sui-service.ts:277-291 (helper)

  Supporting method in SuiService that performs the RPC call to sui_getCheckpoint via the blockchain service.

  async getCheckpoint(
    checkpointId: string | number,
    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}`,
      };
    }
  
    return this.blockchainService.callRPCMethod(service.id, 'sui_getCheckpoint', [checkpointId]);
  }

• src/index.ts:88-101 (registration)

  Registers all tools including Sui tools (via registerSuiHandlers) into the MCP server's tool list.

  const tools: Tool[] = [
    ...registerBlockchainHandlers(server, blockchainService),
    ...registerDomainHandlers(server, domainResolver),
    ...registerTransactionHandlers(server, advancedBlockchain),
    ...registerTokenHandlers(server, advancedBlockchain),
    ...registerMultichainHandlers(server, advancedBlockchain),
    ...registerContractHandlers(server, advancedBlockchain),
    ...registerUtilityHandlers(server, advancedBlockchain),
    ...registerEndpointHandlers(server, endpointManager),
    ...registerSolanaHandlers(server, solanaService),
    ...registerCosmosHandlers(server, cosmosService),
    ...registerSuiHandlers(server, suiService),
    ...registerDocsHandlers(server, docsManager),
  ];

• src/index.ts:114-127 (registration)

  Routes tool calls to the appropriate handler, including handleSuiTool for Sui tools like get_sui_checkpoint.

  let result =
    (await handleBlockchainTool(name, args, blockchainService)) ||
    (await handleDomainTool(name, args, domainResolver)) ||
    (await handleTransactionTool(name, args, advancedBlockchain)) ||
    (await handleTokenTool(name, args, advancedBlockchain)) ||
    (await handleMultichainTool(name, args, advancedBlockchain)) ||
    (await handleContractTool(name, args, advancedBlockchain)) ||
    (await handleUtilityTool(name, args, advancedBlockchain)) ||
    (await handleEndpointTool(name, args, endpointManager)) ||
    (await handleSolanaTool(name, args, solanaService)) ||
    (await handleCosmosTool(name, args, cosmosService)) ||
    (await handleSuiTool(name, args, suiService)) ||
    (await handleDocsTool(name, args, docsManager));