Horizon v1.0.0 Compatibility

[abuiles]

The upcoming Horizon release is coming, and there are multiple breaking changes plus new features 🎉🎉🎉!

The following are the list of changes required to support this new release:

• ➕Update /fee_stats response.

  • ✂ Remove the following fields:

    min_accepted_fee
    mode_accepted_fee
    p10_accepted_fee
    p20_accepted_fee
    p30_accepted_fee
    p40_accepted_fee
    p50_accepted_fee
    p60_accepted_fee
    p70_accepted_fee
    p80_accepted_fee
    p90_accepted_fee
    p95_accepted_fee
    p99_accepted_fee

  • ➕Add support for max_fee and fee_charged fields. Each field contains a JSON object that looks like this:

    {
      "last_ledger": "22606298",
      "last_ledger_base_fee": "100",
      "ledger_capacity_usage": "0.97",
      "fee_charged": {
        "max": "100",
        "min": "100",
        "mode": "100",
        "p10": "100",
        "p20": "100",
        "p30": "100",
        "p40": "100",
        "p50": "100",
        "p60": "100",
        "p70": "100",
        "p80": "100",
        "p90": "100",
        "p95": "100",
        "p99": "100"
      },
      "max_fee": {
        "max": "100000",
        "min": "100",
        "mode": "100",
        "p10": "100",
        "p20": "100",
        "p30": "100",
        "p40": "100",
        "p50": "100",
        "p60": "100",
        "p70": "100",
        "p80": "100",
        "p90": "15000",
        "p95": "100000",
        "p99": "100000"
      }
     }

  See Update /fee_stats documentation. #2140 for more info.

• ✂ Remove deprecated fee_paid field from Transaction response (replace it with the fee_charged and max_fee fields, see #1372).

• 🚨Multiple fields changed from int64 to string. If your SDK has types, they need to be updated. If possible, we recommend implementing backward compatibility support, as we did here.

  • Attribute offer_id in manage buy offer and manage sell offer operations.

  • Attribute offer_id in Trade effect.

  • Attribute id in Offer resource.

  • Attribute timestamp and trade_count in Trade Aggregation resource.

  See Decide on use of int64 in JSON responses. #1609, protocols/horizon/effects: Add UnmarshalJSON to SequenceBumped. #1909, and Support String or Number Unmarshalling in Int64 fields #1912 for more info

• 🚨 Update operation types to canonical names (if needed) (see protocols/horizon: Apply deprecation on some operation types, updating them to the correct value #2134).

• ➕Add support for /accounts end-point with ?signer and ?asset filters. We recommend a method like .accounts(queryParams) (see documentation for accounts). clients/horizonclient: Add support for Accounts endpoint. #2229

• ➕Add support for /offers end-point with query parameters. We recommend a method like .offers(queryParams) (see documentation for offers).

• ➕Add support for /paths/strict-send end-point. See documentation.
  We recommend a method like

  strictSendPaths(sourceAsset, sourceAmount, [destinationAsset])
  

• ➕ Add support for /paths/strict-receive end-point. See documentation.
  We recommend a method like:

  strictReceivePaths(sourceAssets,destinationAsset, destinationAmount)
  

• ♻ Regenerate the XDR definitions to include MetaV2 support (also see #1902).

That's it! If you have any questions feel free to ping us on #dev-discussion in Keybase.

[abuiles]

@tamirms when you got a sec, can you check if there is anything that we need to do in the java-sdk for the new fields in /fee_stats and also for the ones we'll be removing.

[abuiles]

I think most of this are done for horizon-client if we branch off release-horizon-0.25.0

[abuiles]

horizonclient-2.1 is now available.