diff --git a/CHANGELOG.md b/CHANGELOG.md
index f93d282be..57a9f5c2e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,31 @@
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project (kinda) adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0]
+
+### Changed
+
+- Network layer prevents createConnection if already connected
+- Fixed crash when config path does not exist
+- yowsup-cli will interpret -c as phone if load_path fails
+- Allow keypair in credentials to be bytes
+- Noise layer now uses credential's client_static_keypair if set, instead of loading it from stored config
+- Improved config type detection logic, refs #2664
+- Fixed some python2-related problems (long-type phone numbers, missing list.clear() method), refs #2664
+- Updated consonance to fix dissononce's machine.next and enforce cryptography>=0.25
+
+### Added
+
+- Complete asyncore dispatcher implementation.
+- Support for decoding deflate compressed data, fixes #2671
+- Specifying a connection dispatcher (asyncore/socket) using YowNetworkLayer.PROP_DISPATCHER
+- --layer-network-dispatcher to cli demos
+
+### Removed
+
+- threading from socket dispatcher, connecting application should ensure the connection is not blocking, for
+example by triggering connect in a bg thread.
+
 ## [3.0.0]
 
 ### Changed
diff --git a/README.md b/README.md
index 3d2a963e9..9d0f03b53 100644
--- a/README.md
+++ b/README.md
@@ -8,9 +8,9 @@ The project started as the protocol engine behind [Wazapp for Meego](https://wik
 library it can be used to power any custom WhatsApp client.
 
 ```
-updated: 2019-04-23
-yowsup version: 3.0.0
-yowsup-cli version: 3.0.0
+updated: 2019-04-25
+yowsup version: 3.1.0
+yowsup-cli version: 3.1.0
 requires:
 - python>=2.7,<=3.7
 - consonance==0.1.0
diff --git a/yowsup/__init__.py b/yowsup/__init__.py
index 325cf355b..a5433f273 100644
--- a/yowsup/__init__.py
+++ b/yowsup/__init__.py
@@ -1,6 +1,6 @@
 import logging
 
-__version__ = "3.0.0"
+__version__ = "3.1.0"
 __author__ = "Tarek Galal"
 
 logger = logging.getLogger(__name__)