diff --git a/depends/packages/wolfssl.mk b/depends/packages/wolfssl.mk
index 6ffa1d9cd..21b95e0ab 100644
--- a/depends/packages/wolfssl.mk
+++ b/depends/packages/wolfssl.mk
@@ -1,10 +1,16 @@
 package=wolfssl
 
 ifeq ($(host_os),mingw32)
+# this is the highest version known to compile on windows
 $(package)_version=4.8.1
 $(package)_file_name=wolfssl-$($(package)_version).tar.gz
 $(package)_sha256_hash=50db45f348f47e00c93dd244c24108220120cb3cc9d01434789229c32937c444
 else
+# BEWARE: Updating this version could cause weird bugs where nodes
+# hang after a few days or do not respond to the "stop" RPC . 5.2.0
+# definitely has problems, versions between 4.8.1 and 5.2.0 have not
+# been tested yet. Make sure to do extensive testing when changing this
+# package version
 $(package)_version=4.8.1
 $(package)_file_name=wolfssl-$($(package)_version).tar.gz
 $(package)_sha256_hash=50db45f348f47e00c93dd244c24108220120cb3cc9d01434789229c32937c444