diff --git a/README.md b/README.md
index bdcb74f..0bdaa87 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,10 @@ at https://www.blocktrail.com/api/docs/lang/php
 
 [![Build Status](https://travis-ci.org/blocktrail/blocktrail-sdk-php.svg?branch=master)](https://travis-ci.org/blocktrail/blocktrail-sdk-php)
 
+Upgrading from v2.x to v3.0.0
+-----------------------------
+**IMPORTANT** `v3.0.0` introduces a new **DEFAULT** wallet encryption, please make sure you upgrade the SDK everywhere you're using it!!
+
 Upgrading from v1.x to v2.0.0
 -----------------------------
 **IMPORTANT** `v2.0.0` has a few BC breaks, please check [docs/CHANGELOG.md](docs/CHANGELOG.md)!!
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 7e12782..a08fcce 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,6 +1,12 @@
 BlockTrail PHP SDK Changelog
 ============================
 
+v3.0.0
+------
+ - New [Default] Wallet Version 3  
+   Better encryption scheme / key derivation.
+ - Deprecated passing in `primaryPrivateKey`, should use `primarySeed` instead.
+
 v2.1.0
 ------
  - Replaced `bitcoin-lib-php` with `bitcoin-php`.