|
| 1 | +--- |
| 2 | +category: 2024 |
| 3 | +date: 2024-12-12 |
| 4 | +seo: |
| 5 | + title: Introducing Clio version 2.3.0 |
| 6 | + description: Version 2.3.0 of Clio, an XRP Ledger API server optimized for HTTP and WebSocket API calls, is now available. This release adds new features and bug fixes. |
| 7 | +labels: |
| 8 | + - Clio Release Notes |
| 9 | +markdown: |
| 10 | + editPage: |
| 11 | + hide: true |
| 12 | +--- |
| 13 | + |
| 14 | +## Introducing Clio version 2.3.0 |
| 15 | + |
| 16 | +Version 2.3.0 of Clio, an XRP Ledger API server optimized for HTTP and WebSocket API calls, is now available. This release adds new features and bug fixes. |
| 17 | + |
| 18 | +## Notable New Features |
| 19 | + |
| 20 | +- [AmendmentCenter: central place to query amendment-related data](https://github.com/XRPLF/clio/pull/1418) |
| 21 | +- [`ledger_index` API: returns latest closed ledger index before the given date](https://github.com/XRPLF/clio/pull/1503) |
| 22 | +- [More verbose forwarding errors](https://github.com/XRPLF/clio/pull/1523) |
| 23 | +- [Native `feature` API](https://github.com/XRPLF/clio/pull/1526) |
| 24 | +- [Add `force_forward` field in requests](https://github.com/XRPLF/clio/pull/1647) |
| 25 | +- [Cache on `server_info` API](https://github.com/XRPLF/clio/pull/1671) |
| 26 | + |
| 27 | +## Amendment Support |
| 28 | + |
| 29 | +The following amendments have been introduced since Clio 2.2.5 and have transaction model changes. Clio 2.3.0 is built with `libxrpl` 2.3.0, which supports these amendments. |
| 30 | + |
| 31 | +- [AMMClawback](https://xrpl.org/resources/known-amendments#ammclawback) |
| 32 | +- [Credentials](https://xrpl.org/resources/known-amendments#credentials) |
| 33 | +- [MPTokensV1](https://xrpl.org/resources/known-amendments#mptokensv1) |
| 34 | +- [NFTokenMintOffer](https://xrpl.org/resources/known-amendments#nftokenmintoffer) |
| 35 | + |
| 36 | +If these amendments are enabled and you have not upgraded Clio to 2.3.0 or newer, the ETL will be amendment blocked and new ledgers will not be processed. |
| 37 | + |
| 38 | +To check the current voting status of these amendments on Mainnet, see the [XRPL Amendments Dashboard](https://livenet.xrpl.org/amendments). |
| 39 | + |
| 40 | +## Install / Upgrade |
| 41 | + |
| 42 | +| Package | |
| 43 | +|:--------| |
| 44 | +| [Clio server Linux package](https://github.com/XRPLF/clio/releases/download/2.3.0/clio_server_Linux.zip) | |
| 45 | + |
| 46 | +For other platforms, please [build from source](https://github.com/XRPLF/clio/releases/tag/2.3.0). The most recent commit in the git log should be: |
| 47 | + |
| 48 | +```text |
| 49 | +Author: Alex Kremer <akremer@ripple.com> |
| 50 | +Date: Tue Sep 10 22:33:11 2024 +0100 |
| 51 | +
|
| 52 | + fix: Add upper bound to limit |
| 53 | +``` |
| 54 | + |
| 55 | +## What's Changed |
| 56 | + |
| 57 | +See the [Full Changelog on GitHub](https://github.com/XRPLF/clio/compare/2.2.5...2.3.0). |
| 58 | + |
| 59 | +### Features |
| 60 | + |
| 61 | +- AmendmentCenter [(#1418)](https://github.com/XRPLF/clio/pull/1418) |
| 62 | +- Ledger index [(#1503)](https://github.com/XRPLF/clio/pull/1503) |
| 63 | +- More verbose forwarding errors [(#1523)](https://github.com/XRPLF/clio/pull/1523) |
| 64 | +- Native Feature RPC [(#1526)](https://github.com/XRPLF/clio/pull/1526) |
| 65 | +- Add stop to WorkQueue [(#1600)](https://github.com/XRPLF/clio/pull/1600) |
| 66 | +- Move/copy support in async framework [(#1609)](https://github.com/XRPLF/clio/pull/1609) |
| 67 | +- Delete-before support in data removal tool [(#1649)](https://github.com/XRPLF/clio/pull/1649) |
| 68 | +- Add `force_forward` field to request [(#1647)](https://github.com/XRPLF/clio/pull/1647) |
| 69 | +- Server info cache [(#1671)](https://github.com/XRPLF/clio/pull/1671) |
| 70 | +- ETLng Registry [(#1713)](https://github.com/XRPLF/clio/pull/1713) |
| 71 | +- Upgrade to `libxrpl 2.3.0-rc1` [(#1718)](https://github.com/XRPLF/clio/pull/1718) |
| 72 | +- Implement MPT changes [(#1147)](https://github.com/XRPLF/clio/pull/1147) |
| 73 | +- Add Support Credentials for Clio [(#1712)](https://github.com/XRPLF/clio/pull/1712) |
| 74 | +- Upgrade to `libxrpl 2.3.0-rc2` [(#1736)](https://github.com/XRPLF/clio/pull/1736) |
| 75 | + |
| 76 | +### Bug Fixes |
| 77 | + |
| 78 | +- Duplicate messages when subscribe both accounts and proposed_accounts ([#1415](https://github.com/XRPLF/clio/pull/1415)) |
| 79 | +- Remove unused file ([#1496](https://github.com/XRPLF/clio/pull/1496)) |
| 80 | +- Fix extra brackets in warnings ([#1519](https://github.com/XRPLF/clio/pull/1519)) |
| 81 | +- Fix the ledger_index timezone issue ([#1522](https://github.com/XRPLF/clio/pull/1522)) |
| 82 | +- Change the field name from "close_time_iso" to "closed ([#1531](https://github.com/XRPLF/clio/pull/1531)) |
| 83 | +- Compatible `feature` response ([#1539](https://github.com/XRPLF/clio/pull/1539)) |
| 84 | +- Relax error when `full` or `accounts` set to `false` ([#1540](https://github.com/XRPLF/clio/pull/1540)) |
| 85 | +- Add more account check ([#1543](https://github.com/XRPLF/clio/pull/1543)) |
| 86 | +- Support deleted object in ledger_entry ([#1483](https://github.com/XRPLF/clio/pull/1483)) |
| 87 | +- Fail to deduplicate the same nfts in `ttNFTOKEN_CANCEL_OFFER` ([#1542](https://github.com/XRPLF/clio/pull/1542)) |
| 88 | +- Static linkage ([#1551](https://github.com/XRPLF/clio/pull/1551)) |
| 89 | +- NftData unique bug ([#1550](https://github.com/XRPLF/clio/pull/1550)) |
| 90 | +- LedgerEntryNotExist unittest failure ([#1564](https://github.com/XRPLF/clio/pull/1564)) |
| 91 | +- Remove cassandra from log ([#1557](https://github.com/XRPLF/clio/pull/1557)) |
| 92 | +- Account_objects returns error when filter does not make sense ([#1579](https://github.com/XRPLF/clio/pull/1579)) |
| 93 | +- Use doxygen 1.12 ([#1587](https://github.com/XRPLF/clio/pull/1587)) |
| 94 | +- Support conan channels in `check_libxrpl` flow ([#1583](https://github.com/XRPLF/clio/pull/1583)) |
| 95 | +- AccountNFT with invalid marker ([#1589](https://github.com/XRPLF/clio/pull/1589)) |
| 96 | +- Not forward admin API ([#1628](https://github.com/XRPLF/clio/pull/1628)) |
| 97 | +- Fix logging in SubscriptionSource ([#1617](https://github.com/XRPLF/clio/pull/1617)) ([#1632](https://github.com/XRPLF/clio/pull/1632)) |
| 98 | +- Subscription source bugs fix ([#1626](https://github.com/XRPLF/clio/pull/1626)) ([#1633](https://github.com/XRPLF/clio/pull/1633)) |
| 99 | +- Don't forward ledger API if 'full' is a string ([#1640](https://github.com/XRPLF/clio/pull/1640)) |
| 100 | +- Add more restrictions to admin fields ([#1643](https://github.com/XRPLF/clio/pull/1643)) |
| 101 | +- No restriction on type field ([#1644](https://github.com/XRPLF/clio/pull/1644)) |
| 102 | +- Pre-push tag ([#1614](https://github.com/XRPLF/clio/pull/1614)) |
| 103 | +- Upgrade Cassandra driver ([#1646](https://github.com/XRPLF/clio/pull/1646)) |
| 104 | +- Add no lint to ignore clang-tidy ([#1660](https://github.com/XRPLF/clio/pull/1660)) |
| 105 | +- Workaround for gcc12 bug with defaulted destructors ([#1666](https://github.com/XRPLF/clio/pull/1666)) |
| 106 | +- Deletion script will not OOM ([#1679](https://github.com/XRPLF/clio/pull/1679)) |
| 107 | +- Remove log ([#1694](https://github.com/XRPLF/clio/pull/1694)) |
| 108 | +- Example config syntax ([#1696](https://github.com/XRPLF/clio/pull/1696)) |
| 109 | +- Fix timer spurious calls ([#1700](https://github.com/XRPLF/clio/pull/1700)) |
| 110 | +- Fix issues clang-tidy found ([#1708](https://github.com/XRPLF/clio/pull/1708)) |
| 111 | +- Add queue size limit for websocket ([#1701](https://github.com/XRPLF/clio/pull/1701)) |
| 112 | +- Support Delete NFT ([#1695](https://github.com/XRPLF/clio/pull/1695)) |
| 113 | +- Credential error message ([#1738](https://github.com/XRPLF/clio/pull/1738)) |
| 114 | +- Authorized_credential elements in array not objects bug ([#1744](https://github.com/XRPLF/clio/pull/1744)) ([#1747](https://github.com/XRPLF/clio/pull/1747)) |
| 115 | +- Add upper bound to limit |
| 116 | + |
| 117 | +### Refactor |
| 118 | + |
| 119 | +- Structure global validators better ([#1484](https://github.com/XRPLF/clio/pull/1484)) |
| 120 | +- Separate fixtures ([#1495](https://github.com/XRPLF/clio/pull/1495)) |
| 121 | +- Refactor main ([#1555](https://github.com/XRPLF/clio/pull/1555)) |
| 122 | +- Clio Config ([#1544](https://github.com/XRPLF/clio/pull/1544)) |
| 123 | +- Move interval timer into a separate class ([#1588](https://github.com/XRPLF/clio/pull/1588)) |
| 124 | +- Create interface for DOSGuard ([#1602](https://github.com/XRPLF/clio/pull/1602)) |
| 125 | +- Subscription Manager uses async framework ([#1605](https://github.com/XRPLF/clio/pull/1605)) |
| 126 | +- Remove SubscriptionManagerRunner ([#1623](https://github.com/XRPLF/clio/pull/1623)) |
| 127 | +- Clio Config ([#1593](https://github.com/XRPLF/clio/pull/1593)) |
| 128 | +- Coroutine based webserver ([#1699](https://github.com/XRPLF/clio/pull/1699)) |
| 129 | + |
| 130 | +### Documentation |
| 131 | + |
| 132 | +- Mention conventional commits ([#1490](https://github.com/XRPLF/clio/pull/1490)) |
| 133 | +- Use non-admin WS port ([#1592](https://github.com/XRPLF/clio/pull/1592)) |
| 134 | +- Document how to build with custom libxrpl ([#1572](https://github.com/XRPLF/clio/pull/1572)) |
| 135 | + |
| 136 | +### Testing |
| 137 | + |
| 138 | +- Add more tests for warnings ([#1532](https://github.com/XRPLF/clio/pull/1532)) |
| 139 | +- Make ForwardingSource tests more stable ([#1607](https://github.com/XRPLF/clio/pull/1607)) |
| 140 | +- Add test for WsConnection for ping response ([#1619](https://github.com/XRPLF/clio/pull/1619)) |
| 141 | + |
| 142 | +### Miscellaneous Tasks |
| 143 | + |
| 144 | +- Added conventional commits check ([#1487](https://github.com/XRPLF/clio/pull/1487)) |
| 145 | +- Upgrade to libxrpl 2.3.0-b1 ([#1489](https://github.com/XRPLF/clio/pull/1489)) |
| 146 | +- Add permissions to pr title check workflow ([#1491](https://github.com/XRPLF/clio/pull/1491)) |
| 147 | +- Turn off PR labelling ([#1492](https://github.com/XRPLF/clio/pull/1492)) |
| 148 | +- Clio docker image ([#1509](https://github.com/XRPLF/clio/pull/1509)) |
| 149 | +- Fix nightly ([#1514](https://github.com/XRPLF/clio/pull/1514)) |
| 150 | +- Fix bugs in nightly docker publishing ([#1520](https://github.com/XRPLF/clio/pull/1520)) |
| 151 | +- Setup dependabot for github-actions ([#1556](https://github.com/XRPLF/clio/pull/1556)) |
| 152 | +- Update clang-format and ccache ([#1559](https://github.com/XRPLF/clio/pull/1559)) |
| 153 | +- Bump peter-evans/create-pull-request from 5 to 6 ([#1560](https://github.com/XRPLF/clio/pull/1560)) |
| 154 | +- Bump crazy-max/ghaction-import-gpg from 5 to 6 ([#1561](https://github.com/XRPLF/clio/pull/1561)) |
| 155 | +- Bump actions/configure-pages from 4 to 5 ([#1562](https://github.com/XRPLF/clio/pull/1562)) |
| 156 | +- Bump wandalen/wretry.action from 1.4.10 to 3.5.0 ([#1563](https://github.com/XRPLF/clio/pull/1563)) |
| 157 | +- Fix errors in docker image uploading ([#1570](https://github.com/XRPLF/clio/pull/1570)) |
| 158 | +- Fix nightly release workflow ([#1577](https://github.com/XRPLF/clio/pull/1577)) |
| 159 | +- Bump peter-evans/create-pull-request from 6 to 7 ([#1636](https://github.com/XRPLF/clio/pull/1636)) |
| 160 | +- Revert Cassandra driver upgrade ([#1656](https://github.com/XRPLF/clio/pull/1656)) |
| 161 | +- Update libxrpl to 2.3.0-b4 ([#1667](https://github.com/XRPLF/clio/pull/1667)) |
| 162 | +- Apply commits for `2.3.0-b4` ([#1725](https://github.com/XRPLF/clio/pull/1725)) |
| 163 | +- Bump ytanikin/PRConventionalCommits from 1.2.0 to 1.3.0 ([#1670](https://github.com/XRPLF/clio/pull/1670)) |
| 164 | +- Upgrade to llvm 19 tooling ([#1681](https://github.com/XRPLF/clio/pull/1681)) |
| 165 | +- Remove unused static variables ([#1683](https://github.com/XRPLF/clio/pull/1683)) |
| 166 | +- Add counter for total messages waiting to be sent ([#1691](https://github.com/XRPLF/clio/pull/1691)) |
| 167 | +- Fix nightly build ([#1709](https://github.com/XRPLF/clio/pull/1709)) |
| 168 | +- Bump wandalen/wretry.action from 3.5.0 to 3.7.0 ([#1714](https://github.com/XRPLF/clio/pull/1714)) |
| 169 | +- Bump wandalen/wretry.action from 3.7.0 to 3.7.2 ([#1723](https://github.com/XRPLF/clio/pull/1723)) |
| 170 | +- Add relevant changes from develop ([#1762](https://github.com/XRPLF/clio/pull/1762)) |
| 171 | + |
| 172 | + |
| 173 | +## Feedback |
| 174 | + |
| 175 | +The Clio open-source project is seeking feedback and engagement from the XRPL community. |
| 176 | + |
| 177 | +- To provide feedback, please [fill out this survey](https://forms.gle/fnGPTUCAdmEzkFy57). |
| 178 | +- To report an issue or propose a new idea, please [open an issue](https://github.com/XRPLF/clio/issues). |
0 commit comments