Horizon v2.17.0 Release Candidate

Upgrading to this version from <= v2.8.3 will trigger a state rebuild. During this process (which will take at least 10 minutes), Horizon will not ingest new ledgers.

This Horizon release includes support for the Stellar network's upcoming Protocol 19 (4340):

• Account records can now contain two new, optional fields:

    "sequence_ledger": 0, // uint32 ledger number
    "sequence_time": "0"  // uint64 unix time in seconds, as a string

The absence of these fields indicates that the account hasn't taken any actions since prior to the Protocol 19 release. Note that they'll either be both present or both absent.

• Transaction records can now contain the following optional object:

    "preconditions": {
      "timebounds": {
        "min_time": "0",  // uint64 unix time in seconds, as a string
        "max_time": "0"   // as above
      },
      "ledgerbounds": {
        "min_ledger": 0,  // uint32 ledger number
        "max_ledger": 0   // as above
      },
      "min_account_sequence": "0",          // int64 sequence number, as a string
      "min_account_sequence_age": "0",      // uint64 unix time in seconds, as a string
      "min_account_sequence_ledger_gap": 0, // uint32 ledger count

      "extra_signers": [] // list of signers as StrKeys
    }

All of the top-level fields within this object are also optional. However, the "ledgerbounds" object will always have its inner values set.

Note that the existing "valid_before_time" and "valid_after_time" fields on the top-level object will be identical to the "preconditions.timebounds.min_time" and "preconditions.timebounds.min_time" fields, respectively, if those exist. The "valid_before_time" and "valid_after_time" fields are now considered deprecated and will be removed in Horizon v3.0.0.

Full Diff: horizon-v2.16.1...horizon-v2.17.0-rc1
Full Changelog: services/horizon/CHANGELOG.md

horizonclient & txnbuild v10.0.0

v10.0.0 - 2022-04-18

horizonclient

This release adds support for Protocol 19:

• The library is updated to align with breaking changes to txnbuild.

txnbuild

Adds support for Protocol 19 transaction preconditions (CAP-21).

Breaking changes

• There are many new ways for a transaction to be (in)valid (see the new Preconditions structure), and the corresponding breaking change is in how transactions are built:

 tx, err := NewTransaction(TransactionParams{
     SourceAccount: someAccount,
     // ... other parameters ...
-    Timebounds:    NewTimeout(5),
+    Preconditions: Preconditions{TimeBounds: NewTimeout(5)},
 })

• Timebounds has been renamed to TimeBounds, though a type alias remains.

• A *TimeBounds structure is no longer considered valid (via Validate()) if it's nil. This further reinforces the fact that transactions need timebounds.

Horizon v2.16.1

• Use Golang 1.18.1 with security fixes for CVE-2022-24675, CVE-2022-28327 and CVE-2022-27536. (4333)

Horizon v2.16.0

• Replace keybase with publicnode in the stellar core config. (4291)
• Add a rate limit for path finding requests. (4310)
• Horizonclient, fix multi-parameter url for claimable balance query. (4248)

Horizon v2.15.1

Upgrading to this version from <= v2.8.3 will trigger a state rebuild. During this process (which will take at least 10 minutes), Horizon will not ingest new ledgers.

Fixes

• Fixed a regression preventing running multiple concurrent captive-core ingestion instances. (4251)

Horizon v2.15.0

Upgrading to this version from <= v2.8.3 will trigger a state rebuild. During this process (which will take at least 10 minutes), Horizon will not ingest new ledgers.

DB Schema Migration

• DB migrations add columns to the history_trades table to enable filtering trades by "rounding slippage". This is very large table so migration may take a long time (depending on your DB hardware). Please test the migrations execution time on the copy of your production DB first.

Features

• New feature, enable captive core based ingestion to use remote db persistence rather than in-memory for ledger states. Essentially moves what would have been stored in RAM to the external db instead. Recent profiling on the two approaches shows an approximate space usgae of about 8GB for ledger states as of 02/2022 timeframe, but it will gradually continue to increase as more accounts/assets are added to network. Current horizon ingest behavior when configured for captive core usage will by default take this space from RAM, unless a new command line flag is specified --captive-core-use-db=true, which enables this space to be taken from the external db instead, and not RAM. The external db used is determined be setting DATABASE parameter in the captive core cfg/.toml file. If no value is set, then by default it uses sqlite and the db file is stored in --captive-core-storage-path - (4092)

Fixes

• Exclude trades with high "rounding slippage" from /trade_aggregations endpoint. (4178)
  • Note, to apply this change retroactively to existing data you will need to reingest starting from protocol 18 (ledger 38115806).
• Release DB connection in /paths when no longer needed. (4228)
• Fixed false positive warning during orderbook verification in the horizon log output whenever the in memory orderbook is inconsistent with the postgres liquidity pool and offers table. (4236)

Horizon v2.14.0

• Restart Stellar-Core when it's context is cancelled. (4192)
• Resume ingestion immediately when catching up. (4196)
• Check if there are newer ledger when requested ledger does not exist. (4198)
• Properly check against the HA array being empty. (4152)

Horizon v2.13.0

DB Schema Migration

• DB migrations add a column and index to the history_trades table to improve performance of some queries. This is very large table so migration may take a long time (depending on your DB hardware). Please test the migrations execution time on the copy of your production DB first.

Changes

• Improve performance of /trades?trade_type=liquidity_pool requests. (4149)
• Added absBeforeEpoch to ClaimableBalance API Resources. It will contain the Unix epoch representation of absolute before date. (4148)
• Path finding results contain empty paths again (removed in Horizon 2.9.0). (4137)
• Generate HTTP Status code of 499 for Client Disconnects, should propagate into horizon_http_requests_duration_seconds_count metric key with status="499" label. (4098)
• Fix incorrect counting of rate limited events in stream requests. (4163)
• Update cursor on every ledger when using old non Captive-Core ingestion backend. (4150)
• Fix the code responsible for updating Stellar-Core status that could stop the metrics updates on connectivity issues. (4180)

horizonclient & txnbuild v9.0.0

• Enable Muxed Accounts (SEP-23) by default (#4169):
  • Remove TransactionParams.EnableMuxedAccounts
  • Remove TransactionFromXDROptionEnableMuxedAccounts
  • Remove FeeBumpTransactionParams.EnableMuxedAccounts
  • Remove parameter withMuxedAccounts bool from all methods/functions.
  • Remove options ...TransactionFromXDROption parameter from TransactionFromXDR()
  • Rename SetOpSourceMuxedAccount() to (pre-existing) SetOpSourceAccount() which now accepts
    both G and M (muxed) account strkeys.
• Use xdr.Price to represent prices in txnbuild instead of strings (#4167).

Horizon v2.12.1

Fixes

• Fixes a critical vulnerability in HTTP server of Golang <=1.17.4. An attacker can cause unbounded memory growth in a Go server accepting HTTP/2 requests.