diff --git a/CHANGELOG.md b/CHANGELOG.md
index 37e00b5..cc2bd2e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## 2026-11-06 — SDK 0.3.1 migration
+
+- Updated the workspace to `xfetch-effect-api` 0.3.1.
+- SDK dependencies now resolve from crates.io; the temporary git branch is no
+  longer required.
+- The JSON protocol remains version 1 and the WIT remains
+  `xfetch:runtime@0.1.0`.
+- Effect code, manifests and catalog versions are unchanged.
+
 ## 2026-11-06 — CI and wasm validation
 
 - Added a `Tests` workflow: fmt, clippy, workspace tests and catalog
diff --git a/Cargo.lock b/Cargo.lock
index 9134001..cb6a0b2 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -94,9 +94,9 @@ checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"
 
 [[package]]
 name = "xfetch-api-common"
-version = "0.3.0"
+version = "0.3.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3d7a35b6c4f442aea26e73bb821978a637bd31261d80d4e97c11185876dd684c"
+checksum = "d67a2db2341dd5b8d6ae933c35dcd75670b4379e206ac59ffc1f42c94021315d"
 dependencies = [
  "serde",
  "serde_json",
@@ -104,9 +104,9 @@ dependencies = [
 
 [[package]]
 name = "xfetch-effect-api"
-version = "0.3.0"
+version = "0.3.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0bf8aacbdb2bfeef6a3139f24528786826a0db89a3d5ba2cde47948fa9093534"
+checksum = "858f9c4671b66205a1985683eacf119af7a2b87a60953d8965c1d839d7e49310"
 dependencies = [
  "serde",
  "serde_json",
diff --git a/Cargo.toml b/Cargo.toml
index 5469ba9..4bddc3e 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -8,6 +8,6 @@ members = [
 resolver = "2"
 
 [workspace.dependencies]
-xfetch-effect-api = { version = "0.3.0", package = "xfetch-effect-api" }
+xfetch-effect-api = { version = "0.3.1", package = "xfetch-effect-api" }
 xfetch-effects-lib = { version = "0.2.0", path = "effects/effects-lib", package = "xfetch-effects-lib" }
 
diff --git a/docs/compatibility.md b/docs/compatibility.md
index fbde191..6b935c2 100644
--- a/docs/compatibility.md
+++ b/docs/compatibility.md
@@ -3,10 +3,11 @@
 <h2>SDK compatibility</h2>
 
 <p>
-  The effects in this repository target <code>xfetch-effect-api 0.3.0</code>.
+  The effects in this repository target <code>xfetch-effect-api 0.3.1</code>.
   The JSON protocol remains <code>1</code> and the WIT package remains
   <code>xfetch:runtime@0.1.0</code>. Effects built against the previous
-  <code>0.2.0</code> SDK remain runtime-compatible.
+  <code>0.2.0</code> SDK remain runtime-compatible. SDK dependencies resolve
+  from crates.io; no git branch is required.
 </p>
 
 <p>