https://gitlab.com/tezos/tezos
Tip revision: c34966fedf85e279d409e3ddf4dd64b5aba0906f authored by Albin Coquereau on 29 June 2023, 10:23:49 UTC
wip
wip
Tip revision: c34966f
CHANGES.rst
Development Changelog
'''''''''''''''''''''
**NB:** The changelog for releases can be found at: https://tezos.gitlab.io/CHANGES.html
This file lists the changes added to each version of octez-node,
octez-client, and the other Octez executables. The changes to the economic
protocol are documented in the ``docs/protocols/`` directory; in
particular in ``docs/protocols/alpha.rst``.
When you make a commit on master, you can add an item in one of the
following subsections (node, client, …) to document your commit or the
set of related commits. This will ensure that this change is not
forgotten in the final changelog, which can be found in ``docs/CHANGES.rst``.
By having your commits update this file you also make it easy to find the
commits which are related to your changes using ``git log -p -- CHANGES.rst``.
Relevant items are moved to ``docs/CHANGES.rst`` after each release.
Only describe changes which affect users (bug fixes and new features),
or which will affect users in the future (deprecated features),
not refactorings or tests. Changes to the documentation do not need to
be documented here either.
General
-------
Node
----
- Changed the bounding specification of valid operations in the mempool:
+ Before, the number of valid **manager operations** in the mempool
was at most ``max_prechecked_manager_operations`` (default 5_000),
with no other constraints. (Operations to keep were selected
according to a "weight" that consists in the ratio of fee over
"resources"; the latter is the maximum between the following
ratios: operation gas over maximal allowed gas, and operation size
over maximal allowed size. The baker uses the same notion of
"weight" to select operations.)
+ Now, the number of valid **operations of any kind** is at most
``max_operations`` (default 10_000), and also the **sum of the
sizes in bytes** of all valid operations is at most
``max_total_bytes`` (default 10_000_000). See
[src/lib_shell/prevalidator_bounding.mli] for the reasoning behind
the default values. (Operations are selected according to the
protocol's ``compare_operations`` function, which currently orders
operations according to their validation pass (consensus is
highest and manager is lowest); note that two manager operations
are ordered using their fee over gas ratio.)
The values of ``max_operations`` and ``max_total_bytes`` can be
retrieved with ``GET /chains/<chain>/mempool/filter`` and configured
with ``POST /chains/<chain>/mempool/filter`` (just as
``max_prechecked_manager_operations`` used to be). As a result, the
JSON format of the outputs of these two RPCs and the input of the
second one have slightly changed; see their updated descriptions.
(MR :gl:`!6787`)
- Errors ``prefilter.fees_too_low_for_mempool`` and
``plugin.removed_fees_too_low_for_mempool`` have been replaced with
``node.mempool.rejected_by_full_mempool`` and
``node.mempool.removed_from_full_mempool`` with different
descriptions and messages. The ``rejected_by_full_mempool`` error
still indicates the minimal fee that the operation would need to be
accepted by the full mempool, provided that such a fee exists. If
not, the error now states that the operation cannot be included no
matter its fee (e.g. if it is a non-manager operation). (MRs
:gl:`!6787`, :gl:`!8640`)
- Updated the message of the mempool's
``prevalidation.operation_conflict`` error. It now provides the
minimal fee that the operation would need to replace the
pre-existing conflicting operation, when such a fee exists. (This
fee indication used to be available before V16-rc1, where it had
been removed for technical reasons.) (MR :gl:`!9016`)
- RPC ``/helpers/forge/operations`` can now take JSON formatted operations with
``attestation``, ``preattestation``, ``double_attestation_evidence`` and
``double_preattestation_evidence`` kinds. Note that the existing kinds
``endorsement``, ``preendorsement``, ``double_endorsement_evidence``, and
``double_preendorsement_evidence`` are still accepted. (MR :gl:`!8746`)
- Simplified the peer to peer messages at head switch. The node now
systematically broadcasts only its new head (instead of sometime
broadcasting a sparse history of the chain).
- Added version ``1`` to RPC ``POST ../helpers/parse/operations``. It can be
used by calling the RPC with the parameter ``?version=1`` (default version is
still ``0``). Version ``1`` allows the RPC to output ``attestation``,
``preattestation``, ``double_attestation_evidence`` and
``double_preattestation_evidence`` kinds in the JSON result. (MR :gl:`!8840`)
- Added version ``2`` to RPC ``POST ../mempool/pending_operations``. It can be
used by calling the RPC with the parameter ``?version=2`` (default version is
still ``1``). Version ``2`` allows the RPC to output ``attestation``,
``preattestation``, ``double_attestation_evidence`` and
``double_preattestation_evidence`` kinds in the JSON result. (MR :gl:`!8960`)
- RPCs ``/helpers/scripts/run_operation`` and
``/helpers/scripts/simulate_operation`` can now take JSON formatted operations
with ``double_attestation_evidence`` and ``double_preattestation_evidence``
kinds. Even though consensus operations are not supported by the RPCs,
``attestation`` and ``preattestation`` are accepted in the input JSON. (MR
:gl:`!8768`)
- Removed ``lwt-log`` from the dependencies. The default logger has been updated
to use the ``file-descriptor-stdout`` sink instead of the previous ``lwt-log``
sink. This change has resulted in the removal of certain features from the log
implementation that were specific to "lwt-log". Some features, such as log
rules, syslog, and the output format, have been replaced with alternative
implementations. Additionally, the previous implementation of "syslog" had
some issues, including duplicated log headers or cropped messages, depending
on the file output. These issues have been addressed, and the new
implementation should now work correctly.
- Removed ``template`` field from ``log`` configuration with the removal of
``lwt-log`` library. Since it was believed to have low usage, no alternative
implementation has been provided.
- The configuration flag ``disable-mempool-precheck`` is now
deprecated, as well as the ``disable_precheck`` field of
``prevalidator`` in the shell limits of the configuration file. They
already didn't do anything since V16-rc1. (MR :gl:`!8963`)
- Added version ``1`` to RPCs ``POST ../helpers/scripts/run_operation`` and
``POST ../helpers/scripts/simulate_operation``. It can be used by calling the
RPC with the parameter ``?version=1`` (default version is still ``0``).
Version ``1`` allows the RPC to output ``attestation``, ``preattestation``,
``double_attestation_evidence`` and ``double_preattestation_evidence`` kinds
in the JSON result. (MR :gl:`!8949`)
- The error message when the local injection of an operation fails now
begins with ``Error while validating injected operation`` instead of
``Error while applying operation``. (MR :gl:`!8857`)
- Updated the description of the ``ban_operation`` RPC to better
reflect its behavior, which is unchanged. (More precisely, removed
the "reverting its effect if it was applied" part since operations
are never applied.) (MR :gl:`!8857`)
- Added version ``1`` to RPC ``POST ../mempool/monitor_operations``. It can be
used by calling the RPC with the parameter ``?version=1`` (default version is
still ``0``). Version ``1`` allows the RPC to output ``attestation``,
``preattestation``, ``double_attestation_evidence`` and
``double_preattestation_evidence`` kinds in the JSON result. (MR :gl:`!8980`)
- Improved the performances of JSON RPC calls by optimizing the
serialization to JSON. (MR :gl:`!9072`)
- Fixed the ``validation_pass`` argument usage of ``monitor_operations`` RPC.
Only operation that were in the mempool before the RPC call were filtered by
validation passes. (MR :gl:`!9012`)
- **Breaking change** Removed the ``octez_mempool_pending_applied``
metric, and renamed the ``octez_mempool_pending_prechecked`` one to
``octez_mempool_pending_validated``. (MR :gl:`!9137`)
- Added version ``1`` to RPC ``POST ../helpers/preapply/operations``. It can be
used by calling the RPC with the parameter ``?version=1`` (default version is
still ``0``). Version ``1`` allows the RPC to output ``attestation``,
``preattestation``, ``double_attestation_evidence`` and
``double_preattestation_evidence`` kinds in the JSON result. (MR :gl:`!8891`)
- Changed default stdout logs by adding simple coloration. The log header
header is now bold and warning and errors are highlighted. The
``--log-coloring`` command line argument can be used to enable or
disable logs coloration on default stdout logs; it is enabled by
default. (MR :gl:`!8685`)
- Improved the performance of block validation: the block validation time has
been reduced by half on average, resulting in a reduced propagation time
through the network. (MR :gl:`!9100`)
Client
------
- Adding client commands to generate, open and verify a time-lock.
- The ``typecheck script`` command can now be used to typecheck several scripts.
Baker
-----
- Changed the baker liquidity baking vote file
``per_block_votes.json`` lookup so that it also considers its client
data directory when searching an existing file. The previous
semantics, which looks for this file in the current working
directory, takes predecence.
- Bakers are now required to set their votes for the adoption of the
adaptive inflation feature. They may use the per block votes file,
or CLI option ``--adaptive-inflation-vote``.
- Rename ``endorsement`` into ``attestation`` for baker errors and events.
(MR :gl:`!9195`)
Accuser
-------
Signer
------
Proxy Server
------------
- Redirected not found replies (HTTP 404 answers) to the underlying
octez-node itself. Public visibility of the node is not required
anymore.
Protocol Compiler And Environment
---------------------------------
- Added a new version of the protocol environment (V10)
- Exposed a limited API to manipulate an Irmin binary tree within the
protocol.
- Expose encoding with legacy attestation name. (MR :gl:`!8620`)
Codec
-----
Docker Images
-------------
- Bump up base image to ``alpine:3.17``. In particular, this changes Rust
version to 1.64.0.
Smart Rollup node
-----------------
- Faster bootstrapping process. (MR :gl:`!8618`, MR :gl:`!8767`)
- Added a new metrics ``head_inbox_process_time`` to report the time the rollup
node spent to process a new Layer 1 head. (MR :gl:`!8971`)
- **Breaking change** Field ``"messages"`` of RPC ``/global/block/{block_id}``
now contains *serialized* messages (external messages start with ``01`` and
internal start with ``00``). (MR :gl:`!8876`)
Smart Rollup client
-------------------
Smart Rollup WASM Debugger
--------------------------
Data Availability Committee (DAC)
----------------------------------
- Released Data Availability Committee executables which include ``octez-dac-node``
and ``octez-dac-client`` as part of an experimental release. Users can experiment
with operating and using DAC in their Smart Rollup workflow to achieve higher data
throughput. It is not recommended to use DAC on Mainnet but instead on testnets
and lower environments.
Miscellaneous
-------------
- Updating and re-enabling the time-lock Michelson commands.
- Recommend rust version 1.64.0 instead of 1.60.0.
- Sapling parameters files are installed by ``make build-deps`` via opam