diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6db52b9..c688c34 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # CHANGELOG
+
+## v1.2.3
+
+* Refactored SPG into "workflow" contracts and introduced `RoyaltyWorkflows` for IP Revenue Claiming
+* Fixed and enhanced tests and upgrade scripts: changed mock IPGraph precompile address, added integration tests, improved test logs, and added missing `run` function calls.
+* Optimized royalty and licensing: removed `currencyTokens` parameter, extracted batch claim functions, and removed `hasIpAttachedLicenseTerms` check
+* Added `registerGroupAndAttachLicense` function for grouping
+* repo enhancement and bumped solidity version to 0.8.26
+
+**Full Changelog**: [v1.2.2...v1.2.3](https://github.com/storyprotocol/protocol-periphery-v1/compare/v1.2.2...v1.2.3)
+
 ## v1.2.2
+
 * Introduced `RoyaltyWorkflows` for IP Revenue Claiming
 
 **Full Changelog**: [v1.2.1...v1.2.2](https://github.com/storyprotocol/protocol-periphery-v1/compare/v1.2.1...v1.2.2)
diff --git a/README.md b/README.md
index 09b0a35..b8bcf40 100644
--- a/README.md
+++ b/README.md
@@ -40,12 +40,15 @@ Batch calling functions is supported both natively and through the `Multicall3`
 
 ```json
 {
-  "GroupingWorkflows": "0xDed2AF44142489d5c380322A22cB9A0B8f22111A",
-  "RoyaltyWorkflows": "0xA07f6f4258440d8128Ab86362F17361391F4CA2B",
-  "SPG": "0xAceb5E631d743AF76aF69414eC8D356c13435E59",
-  "SPGNFTBeacon": "0x769A0F5197D427a7fC4378317437e924c8c74b33",
-  "SPGNFTImpl": "0xbE0EB11e256093e22c8802977023970Da6B97fAB",
-  "Multicall3": "0xcA11bde05977b3631167028862bE2a173976CA11"
+  "main": {
+    "DerivativeWorkflows": "0xdAe4A3134c33C4aD24cF2907C8f73Acdb58649be",
+    "GroupingWorkflows": "0x81d717d320Af60805c85B5aD60b506D6e9920584",
+    "LicenseAttachmentWorkflows": "0x96D26F998a56D6Ee34Fb581d26aAEb94e71e3929",
+    "RegistrationWorkflows": "0x601C24bFA5Ae435162A5dC3cd166280C471d16c8",
+    "RoyaltyWorkflows": "0x24f571e4982163bC166E594De289D6b754cB82A5",
+    "SPGNFTBeacon": "0xEFd61b92F619e374e37E2475A8d7e46FD8Be7939",
+    "SPGNFTImpl": "0x92C7c6805DF9B936888e5daC865111dF028846E5"
+  }
 }
 ```
 
diff --git a/deploy-out/deployment-1513.json b/deploy-out/deployment-1513.json
index db9ed80..3f44103 100644
--- a/deploy-out/deployment-1513.json
+++ b/deploy-out/deployment-1513.json
@@ -1,9 +1,11 @@
 {
   "main": {
-    "GroupingWorkflows": "0xDed2AF44142489d5c380322A22cB9A0B8f22111A",
-    "RoyaltyWorkflows": "0xA07f6f4258440d8128Ab86362F17361391F4CA2B",
-    "SPG": "0xAceb5E631d743AF76aF69414eC8D356c13435E59",
-    "SPGNFTBeacon": "0x769A0F5197D427a7fC4378317437e924c8c74b33",
-    "SPGNFTImpl": "0xbE0EB11e256093e22c8802977023970Da6B97fAB"
+    "DerivativeWorkflows": "0xdAe4A3134c33C4aD24cF2907C8f73Acdb58649be",
+    "GroupingWorkflows": "0x81d717d320Af60805c85B5aD60b506D6e9920584",
+    "LicenseAttachmentWorkflows": "0x96D26F998a56D6Ee34Fb581d26aAEb94e71e3929",
+    "RegistrationWorkflows": "0x601C24bFA5Ae435162A5dC3cd166280C471d16c8",
+    "RoyaltyWorkflows": "0x24f571e4982163bC166E594De289D6b754cB82A5",
+    "SPGNFTBeacon": "0xEFd61b92F619e374e37E2475A8d7e46FD8Be7939",
+    "SPGNFTImpl": "0x92C7c6805DF9B936888e5daC865111dF028846E5"
   }
 }
\ No newline at end of file
diff --git a/package.json b/package.json
index d9095f6..773b56e 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@story-protocol/protocol-periphery",
-  "version": "v1.2.2",
+  "version": "v1.2.3",
   "description": "Story Proof-of-Creativity protocol periphery smart contracts",
   "main": "",
   "directories": {
diff --git a/yarn.lock b/yarn.lock
index 1cae3ba..374c7e6 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -1158,9 +1158,9 @@ ethereum-cryptography@^2.0.0, ethereum-cryptography@^2.1.2:
     "@scure/bip39" "1.3.0"
 
 ethers@^6.10.0:
-  version "6.13.2"
-  resolved "https://registry.yarnpkg.com/ethers/-/ethers-6.13.2.tgz#4b67d4b49e69b59893931a032560999e5e4419fe"
-  integrity sha512-9VkriTTed+/27BGuY1s0hf441kqwHJ1wtN2edksEtiRvXx+soxRX3iSXTfFqq2+YwrOqbDoTHjIhQnjJRlzKmg==
+  version "6.13.3"
+  resolved "https://registry.yarnpkg.com/ethers/-/ethers-6.13.3.tgz#b87afdadb91cc8df5f56b9c59c96e5b206f4a600"
+  integrity sha512-/DzbZOLVtoO4fKvvQwpEucHAQgIwBGWuRvBdwE/lMXgXvvHHTSkn7XqAQ2b+gjJzZDJjWA9OD05bVceVOsBHbg==
   dependencies:
     "@adraffy/ens-normalize" "1.10.1"
     "@noble/curves" "1.2.0"