v0.4.1

This release fixes a minor issue of v0.4.0 where an improperly formatted message could be retried indefinitely.

What's Changed

• Fix: do not retry pending messages failing validation by @odesenfans in #348

Full Changelog: v0.4.0...v0.4.1

How to upgrade

0.4.0 introduces a new service for P2P communication. This implies a few modifications to the configuration of your node.

Node private key file

This release includes a change in the private key format. The P2P service requires the key to be in PKCS8 DER format. This change is automatically managed in a migration script that you must run with the upgrade command (see below).

P2P topics

This release introduces new configuration options for the P2P service. We advise to set the following configuration options. Append these options to your config.yml file:

aleph:
    queue_topic: ALEPH-TEST

p2p:
  daemon_host: p2p-service
  http_port: 4024
  port: 4025
  control_port: 4030
  listen_port: 4031
  reconnect_delay: 60
  peers:
    - /dns/api1.aleph.im/tcp/4025/p2p/Qmaxufiqdyt5uVWcy1Xh2nh3Rs3382ArnSP2umjCiNG2Vs
    - /dns/api2.aleph.im/tcp/4025/p2p/QmZkurbY2G2hWay59yiTgQNaQxHSNzKZFt2jbnwJhQcKgV

Note that you are free to configure bootstrap peers as you wish. The two default servers listed above will fit most use cases.

RabbitMQ config

The Core Channel Node communicates with the new P2P service through an instance of RabbitMQ for P2P pubsub topics. We strongly advise to change the default username and password in the config.yml and docker-compose.yml files:

config.yml

rabbitmq:
    host: rabbitmq
    port: 5672
    username: <new-username>
    password: <new-password>

docker-compose.yml

services:
  rabbitmq:
    environment:
      RABBITMQ_DEFAULT_USER: <new-username>
      RABBITMQ_DEFAULT_PASS: <new-password>

Upgrade your node

From any version >= 0.2.0

Download the new Docker Compose file

mv docker-compose.yml docker-compose-old.yml
wget "https://raw.githubusercontent.com/aleph-im/pyaleph/v0.4.1/deployment/samples/docker-compose/docker-compose.yml"

Stop, upgrade and restart the node

docker-compose -f docker-compose-old.yml down --remove-orphans
docker-compose -f docker-compose.yml \
      run \
      --entrypoint /opt/pyaleph/migrations/config_updater.py \
      pyaleph \
      --key-dir /opt/pyaleph/keys \
      --key-file /opt/pyaleph/keys/node-secret.key \
      --config /opt/pyaleph/config.yml \
      upgrade
docker-compose -f docker-compose.yml up -d

From any version < 0.2.0: https://pyaleph.readthedocs.io/en/latest/guides/upgrade.html