fix: update documentation and improve error message

[guoguojin]

Closes #10103

The API works as it should but the error returns a bad error that makes users think something has gone wrong. Also the API documentation is not consistent between the gRPC and GQL documentation and doesn't make it clear what is required in the GQL version.

The error message now returns:

{
  "errors": [
    {
      "message": "invalid filter",
      "path": [
        "ledgerEntries"
      ],
      "extensions": {
        "code": 3,
        "type": "InvalidArgument"
      }
    }
  ],
  "data": null
}