About this release
Last updated
Was this helpful?
Last updated
Was this helpful?
is the stable Lima release that introduces FATE VM, as well as improving state channels
Changelog:
We now have FATE. The initial version of FATE is released as VM version 0x05.
The transaction can now be performed while the channel is not active on-chain (The channel solo closing sequence had been initiated and the channel is not yet closed), this is a consensus breaking change available after the Lima fork.
The state channel FSM after the Lima fork accepts a shutdown message while the channel is being closed unilaterally.
Introduces AEVM version 0x06, available from Lima consensus.
This is a fine-tuned version of the AEVM version 0x04 introduced in the Fortuna consensus.
Extends transaction signing - also allow signatures of the transaction hash. The transaction serialization is potentially long, so signing the transaction hash means less cryptographic work.
Obsoletes the old State Channel off-chain transaction type which contained
the list of updates that produced the latest state_hash. The new
transaction type is available since Fortuna hard fork and the FSM is
producing such transactions ever since. This detaches the off-chain protocol
from the on-chain one and allows development of unique off-chain protocols
that don't need their updates to be serializable on-chain.
For existing state channels where the latest co-authenticated state is an off-chain transaction based on the old version, it is suggested to make a new co-authenticated transaction which is using the new serialization. For currently existing state channels which latest co-authenticated state is an old version off-chain transaction is suggested to make a new co-authenticated transaction that is using the new serialization. If the other party refuses to authenticate a new round or is simply missing, one can use the solo closing sequence instead.
Metadata objects (of type binary) can now be added to an offchain update transfer request.
These objects serve as comments and are not part of the signed transaction, nor do they
affect the offchain state trees. This is an incompatible change in the serialization of offchain
updates, but old offchain updates can still be deserialized. When creating a channel with a party
running an older node version, add version_offchain_update=1 to the channel params.
Remove the rename_db migration command used to migrate Roma databases.
Remove the custom docker entrypoint.
To run the docker image with extra arguments the default command should be used as well, e.g.:docker run aeternity/aeternity bin/aeternity console -noinput -network_id ae_uat see the corresponding docs for details.
cat: docs/release-notes/next-lima/PT-168132312-new-name-hash: No such file or directory
No error messages in contract call objects - they will end up under consensus.
Run your contract in dry-run to get the detailed error message.
Name preclaims are no longer allowed to use 0 as salt value
New name hash computation
New governance function determining if a name is subject to direct claim or auction
New governance function determining initial price of a name
New name auction mechanism using subsequent claim transactions with salt equal to 0
State Channels: Changed configuration option name ws_handlers to sc_ws_handlers which
correctly implies that the limit applies to SC websocket connections.
State Channels: It is now possible to abort a signing request by replying with an error code.
State Channels: The FSMs now stay alive until a Close Mutual (shutdown) has been confirmed on-chain It is also possible to abort/reject a Close Mutual by rejecting the signing request. See https://github.com/aeternity/protocol/blob/master/node/api/channel_ws_api.md#signing-error-replies
State Channels: On-chain tx monitoring was broken after leave/reestablish. This has been fixed.
State Channels: Enhances the FSM with the optional pinned environment for execution off-chain transactions. This is to improve reaching off-chain consensus as both parties share a common view of what is considered to be a fork-safe block hash.
State Channels: Introduces on-disk state cache encryption
When a user leaves a state channel the off-chain state will be persisted on disk and protected
with a password. The password is provided by the user when opening a channel using the state_password
parameter.
When re-establishing the channel the same password MUST be provided, otherwise
the operation will fail with error code invalid_password.
The password MUST be at least 6 characters long. Providing a shorter password
will fail with error code invalid_password.
The password may be changed anytime by the user through the websocket connection after the channel has been opened. Please consult the documentation for more details. This operation is only allowed when the channel is established. If the user has left the channel, the channel must be re-established first before changing the password.
Until the lima fork the password will be optional. By not providing a password a default value is used:correct horse battery staple. After the Lima fork the password will become mandatory. Pre-Lima off-chain states
will be encrypted with the default password.
Because the password used for encrypting the persisted state cache is mandatory after the Lima fork,
state channels which were opened before Lima use the default password.
Not providing the password in the websocket connection will result in a missing_field error.
Keep in mind that an adversary with direct RAM access to the node may still steal the off-chain state. This change only protects the state against an adversary with direct disk access.
Added infrastructure for deploying contracts (with fresh tokens) during hard forks from Lima release. This will be used to finalize the token migration.
Added the migrated tokens in the Phase 3 of the token migration.
Adds one (1) percent of the total initial (ERC20) token supply to an account according to Pool D in https://hackmd.aepps.com/s/H1qF1w1j7#
Set Lima testnet hardfork height to 154300 (16th Oct 2019, 09:00 UTC)
Set Lima mainnet to 161150 (30th Oct 2019, 13:00 UTC)
Aligns AEVM store gas pricing with FATE.
ContractCallTX where the called contract uses FATE has a lower base cost (60% cheaper than a call to an AEVM contract).
State Channels: The support for state cache encryption (introduced in v5.0.0-rc.2) has been disabled. An improved approach is being developed which greatly improves API usability. This feature is expected to be released with v5.1.0.
Change top level namespace from .aet to .chain
Better handling of some errors w.r.t. illegal_salt_value
From Lima, catch crashes when processing inner transaction in GAMetaTx; the user should pay for a successful authentication despite the inner Tx crashing.
The node is able to start from a database produced by v4.* releases, otherwise this release is not backward compatible.
The instructions below describe:
You can run a node by either:
The node user API is documented:
A copy is located in the node at path usr/lib/aeternity/lib/aehttp-5.0.0/priv/swagger.yaml.
The JSON version can be obtained from a running node using the endpoint /api.
The release package comes preconfigured with seed nodes. Here is an example subset of the seed nodes:
Here are example nodes that can be used to inspect current top block and see information about e.g. height or target:
http://18.136.37.63:3013/v2/blocks/top
http://52.220.198.72:3013/v2/blocks/top
http://13.53.114.199:3013/v2/blocks/top
http://13.53.149.181:3013/v2/blocks/top
The release package comes preconfigured with testnet seed nodes, this is the list:
The core nodes of the public test network are accessible from the Internet.
Information, e.g. height, of the top block of the longest chain as seen by these core nodes of the testnet can be obtained by opening in the browser any of the following URLs:
http://52.10.46.160:3013/v2/blocks/top
http://13.250.162.250:3013/v2/blocks/top
http://13.53.161.215:3013/v2/blocks/top
Setting up your node consists of:
Please join the mainnet by following the instructions below, and let us know if you have any problems by . Troubleshooting of common issues is documented .
;
;
.
.
Installing the published corresponding to your platform; or
Running the published ; or
.
The instructions for configuring the node using the Docker image are in .
An interactive visualization of the specification is available .
HTTP API endpoints are specified ;
WebSocket API endpoints are ;
The intended usage of the user API (HTTP and WebSocket) is .
The instructions for installing a node using a release binary are in .
For installation of a node using the Docker image, please refer to the .
In order to join the mainnet follow the to run the node with default configuration as mainnet is the default network.
To join the mainnet by using the Docker image, please refer to .
The default that the node package is preconfigured with is mainnet with id ae_mainnet.
In order to join the testnet change the in the node configuration file to ae_uat.
To join the testnet by using the Docker image, please refer to the .
Configuring your node - see instructions in ;
Starting your node and verifying it works as expected - see instructions in .