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. stellar/go#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. stellar/go#1609, protocols/horizon/effects: Add UnmarshalJSON to SequenceBumped. stellar/go#1909, and Support String or Number Unmarshalling in Int64 fields stellar/go#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 stellar/go#2134).

• ➕Add support for /accounts end-point with ?signer and ?asset filters. We recommend a method like .accounts(queryParams) (see documentation for accounts).

• ➕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.

[Kirbyrawr]

• Fee Stats Response done in branch -> https://github.com/elucidsoft/dotnet-stellar-sdk/tree/fee-stats-horizon

[Kirbyrawr]

• Fee Paid Deprecation done in branch -> https://github.com/elucidsoft/dotnet-stellar-sdk/tree/fee-stats-horizon

[Kirbyrawr]

• Regenerate XDR files done in pr -> XDR Files updated with Stellar Core master branch .x files. #224

[Kirbyrawr]

• Update Type fields done in PR -> Added new tests to cover pre Horizon 1.0.0 type changes. #228

[fracek]

• Accounts filter endpoint in Add accounts endpoint #226
• Offers filter endpoint in Add offers filter endpoint #227
• Paths endpoints in Add new paths endpoints #229

[fracek]

We implemented all required changes and merged them into the horizon-1.0.0 branch. We just need to merge into master to release a new version of the SDK.