From 4a64d5e31e328b1623487b2b33ed06bb4fc7d3a7 Mon Sep 17 00:00:00 2001
From: Pavel Hornak <pavel.hornak@clabs.co>
Date: Wed, 28 Jan 2026 13:40:36 +0100
Subject: [PATCH 1/2] docs: add Ledger EIP-712 workaround guide and rebrand
 Ledger Live to Ledger Wallet

Add comprehensive documentation for the Celo Ledger app EIP-712 signing
limitation and the Eth Recovery app workaround:

- Create new dedicated guide (tooling/wallets/ledger/eip712-workaround.mdx)
- Document the issue: Celo Ledger app doesn't support EIP-712 typed data
- Explain this only affects users with Celo app + Celo derivation path
- Provide step-by-step instructions for installing Eth Recovery app
- Add derivation path configuration guidance
- Include troubleshooting section and tested configurations

Update Ledger documentation to reflect current branding:

- Rename all "Ledger Live" references to "Ledger Wallet" (98 occurrences)
- Update Developer Mode instructions to match current Ledger UI
- Add official Ledger developer documentation image

Add EIP-712 limitation warnings with links to workaround guide:

- tooling/wallets/ledger/setup.mdx
- tooling/wallets/ledger/to-celo-terminal.mdx
- tooling/wallets/index.mdx
- home/wallets.mdx
---
 home/wallets.mdx                              |   2 +-
 tooling/libraries-sdks/cli/account.mdx        |  48 +++---
 tooling/libraries-sdks/cli/election.mdx       |   8 +-
 tooling/libraries-sdks/cli/epochs.mdx         |  10 +-
 tooling/libraries-sdks/cli/governance.mdx     |  30 ++--
 tooling/libraries-sdks/cli/identity.mdx       |   2 +-
 tooling/libraries-sdks/cli/lockedcelo.mdx     |  16 +-
 tooling/libraries-sdks/cli/multisig.mdx       |   6 +-
 tooling/libraries-sdks/cli/node.mdx           |   2 +-
 tooling/libraries-sdks/cli/oracle.mdx         |   6 +-
 tooling/libraries-sdks/cli/releasecelo.mdx    |  30 ++--
 tooling/libraries-sdks/cli/transfer.mdx       |  12 +-
 tooling/libraries-sdks/cli/validator.mdx      |  14 +-
 tooling/libraries-sdks/cli/validatorgroup.mdx |  10 +-
 tooling/overview/migrate/from-ethereum.mdx    |   2 +-
 tooling/wallets/index.mdx                     |   2 +-
 tooling/wallets/ledger/eip712-workaround.mdx  | 151 ++++++++++++++++++
 tooling/wallets/ledger/setup.mdx              |  16 +-
 tooling/wallets/ledger/to-celo-cli.mdx        |   4 +-
 tooling/wallets/ledger/to-celo-terminal.mdx   |  10 +-
 20 files changed, 274 insertions(+), 107 deletions(-)
 create mode 100644 tooling/wallets/ledger/eip712-workaround.mdx

diff --git a/home/wallets.mdx b/home/wallets.mdx
index 697138016..81ec1e3dc 100644
--- a/home/wallets.mdx
+++ b/home/wallets.mdx
@@ -50,7 +50,7 @@ Celo Terminal is a wallet and dApp platform designed as a hub for managing and r
 - Homepage: [celoterminal.com](https://celoterminal.com)
 - Platforms: MacOS, Linux, Windows
 - Maintainers: [WOTrust](https://x.com/wotrust1)
-- Ledger support: Yes
+- Ledger support: Yes (Note: [EIP-712 signing requires workaround](/wallet/ledger/eip712-workaround))
 - [Source Code](https://github.com/zviadm/celoterminal)
 
 ---
diff --git a/tooling/libraries-sdks/cli/account.mdx b/tooling/libraries-sdks/cli/account.mdx
index bf161a881..226a97692 100644
--- a/tooling/libraries-sdks/cli/account.mdx
+++ b/tooling/libraries-sdks/cli/account.mdx
@@ -77,7 +77,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --signature=0x
       (required) Signature (a.k.a proof-of-possession) of the signer key
@@ -195,7 +195,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --publicKey=<value>
       The public key of the account that others may use to send you encrypted messages
@@ -265,7 +265,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -328,7 +328,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -394,7 +394,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --name=<value>
       (required) The name you want to claim
@@ -460,7 +460,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --rpcUrl=https://www.celo.org
       (required) The RPC URL to claim
@@ -526,7 +526,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --url=https://www.celo.org
       (required) The URL of the storage root you want to claim
@@ -592,7 +592,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -658,7 +658,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --signer=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Account Address
@@ -720,7 +720,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -792,7 +792,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --no-header
       hide table header from output
@@ -879,7 +879,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --no-header
       hide table header from output
@@ -948,7 +948,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --[no-]local
       If set, only show local and hardware wallet accounts. Use no-local to only show
@@ -1007,7 +1007,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -1157,7 +1157,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --signer=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Address of the signer key to prove possession of.
@@ -1220,7 +1220,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --name=<value>
 
@@ -1285,7 +1285,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --publicKey=<value>
       (required) The public key you want to register
@@ -1365,7 +1365,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --no-header
       hide table header from output
@@ -1441,7 +1441,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --name=<value>
       (required)
@@ -1511,7 +1511,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -1572,7 +1572,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --signature=0x
       Signature (a.k.a. proof-of-possession) of the signer key
@@ -1673,7 +1673,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -1781,7 +1781,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --password=<value>
       Password used to unlock the account. If not specified, you will be prompted for a
@@ -1847,7 +1847,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --signature=0x
       (required) Signature (a.k.a. proof-of-possession) of the signer key
diff --git a/tooling/libraries-sdks/cli/election.mdx b/tooling/libraries-sdks/cli/election.mdx
index 5ffa394c6..004c4f9d5 100644
--- a/tooling/libraries-sdks/cli/election.mdx
+++ b/tooling/libraries-sdks/cli/election.mdx
@@ -55,7 +55,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -133,7 +133,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --no-header
       hide table header from output
@@ -254,7 +254,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -398,7 +398,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
diff --git a/tooling/libraries-sdks/cli/epochs.mdx b/tooling/libraries-sdks/cli/epochs.mdx
index 58f0909ad..2115d807b 100644
--- a/tooling/libraries-sdks/cli/epochs.mdx
+++ b/tooling/libraries-sdks/cli/epochs.mdx
@@ -90,7 +90,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -149,7 +149,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -211,7 +211,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -274,7 +274,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -377,7 +377,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
diff --git a/tooling/libraries-sdks/cli/governance.mdx b/tooling/libraries-sdks/cli/governance.mdx
index aa12aa0c0..8ca1576c6 100644
--- a/tooling/libraries-sdks/cli/governance.mdx
+++ b/tooling/libraries-sdks/cli/governance.mdx
@@ -69,7 +69,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --proposalID=<value>
       UUID of proposal to approve
@@ -155,7 +155,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --proposalID=<value>
       UUID of proposal to approve
@@ -238,7 +238,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --output=<value>
       [default: proposalTransactions.tson] Path to output
@@ -300,7 +300,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -359,7 +359,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --proposalID=<value>
       (required) UUID of proposal to execute
@@ -424,7 +424,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --salt=<value>
       (required) Secret salt associated with hotfix
@@ -489,7 +489,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --salt=<value>
       (required) Secret salt associated with hotfix
@@ -561,7 +561,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --no-header
       hide table header from output
@@ -636,7 +636,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -721,7 +721,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --noInfo
       Skip printing the proposal info
@@ -794,7 +794,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -1062,7 +1062,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --proposalID=<value>
       (required) UUID of proposal to upvote
@@ -1332,7 +1332,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --proposalID=10000000000000000000000
       (required) UUID of proposal to vote on
@@ -1402,7 +1402,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --no=<value>
       No votes
@@ -1475,7 +1475,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --safeAddress=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       Address of the safe.
diff --git a/tooling/libraries-sdks/cli/identity.mdx b/tooling/libraries-sdks/cli/identity.mdx
index e1d75c103..1dec9f2d7 100644
--- a/tooling/libraries-sdks/cli/identity.mdx
+++ b/tooling/libraries-sdks/cli/identity.mdx
@@ -47,7 +47,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --tokenAddress=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       The address of the token that will be withdrawn. Defaults to cUSD
diff --git a/tooling/libraries-sdks/cli/lockedcelo.mdx b/tooling/libraries-sdks/cli/lockedcelo.mdx
index 6d930fb96..9eaca4186 100644
--- a/tooling/libraries-sdks/cli/lockedcelo.mdx
+++ b/tooling/libraries-sdks/cli/lockedcelo.mdx
@@ -54,7 +54,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --percent=<value>
       (required) 1-100% of locked celo to be delegated
@@ -122,7 +122,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -184,7 +184,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -245,7 +245,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -308,7 +308,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --percent=<value>
       (required) 1-100% of locked celo to be revoked from currently delegated amount
@@ -414,7 +414,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -481,7 +481,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --to=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Account Address
@@ -548,7 +548,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
diff --git a/tooling/libraries-sdks/cli/multisig.mdx b/tooling/libraries-sdks/cli/multisig.mdx
index 0f9345dcf..4c837af8c 100644
--- a/tooling/libraries-sdks/cli/multisig.mdx
+++ b/tooling/libraries-sdks/cli/multisig.mdx
@@ -52,7 +52,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --tx=10000000000000000000000
       (required) Transaction to approve (index)
@@ -118,7 +118,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --to=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Destination address of the transaction
@@ -229,7 +229,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --sender=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       Identify sender if performing transferFrom
diff --git a/tooling/libraries-sdks/cli/node.mdx b/tooling/libraries-sdks/cli/node.mdx
index 06a1683de..f57e544ed 100644
--- a/tooling/libraries-sdks/cli/node.mdx
+++ b/tooling/libraries-sdks/cli/node.mdx
@@ -89,7 +89,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
diff --git a/tooling/libraries-sdks/cli/oracle.mdx b/tooling/libraries-sdks/cli/oracle.mdx
index cd10bbafd..a931b7e65 100644
--- a/tooling/libraries-sdks/cli/oracle.mdx
+++ b/tooling/libraries-sdks/cli/oracle.mdx
@@ -89,7 +89,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -155,7 +155,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -234,7 +234,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --no-header
       hide table header from output
diff --git a/tooling/libraries-sdks/cli/releasecelo.mdx b/tooling/libraries-sdks/cli/releasecelo.mdx
index 33afa7236..b095b6cd1 100644
--- a/tooling/libraries-sdks/cli/releasecelo.mdx
+++ b/tooling/libraries-sdks/cli/releasecelo.mdx
@@ -61,7 +61,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --role=<option>
       (required)
@@ -136,7 +136,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -199,7 +199,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -274,7 +274,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -347,7 +347,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -407,7 +407,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -483,7 +483,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -554,7 +554,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -618,7 +618,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --pop=<value>
       ECDSA PoP for signer over contract's account
@@ -691,7 +691,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -756,7 +756,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -822,7 +822,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -889,7 +889,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -989,7 +989,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --to=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Address of the recipient of Celo Dollars transfer
@@ -1055,7 +1055,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
diff --git a/tooling/libraries-sdks/cli/transfer.mdx b/tooling/libraries-sdks/cli/transfer.mdx
index fb6ec921f..b708ab128 100644
--- a/tooling/libraries-sdks/cli/transfer.mdx
+++ b/tooling/libraries-sdks/cli/transfer.mdx
@@ -54,7 +54,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --to=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Address of the receiver
@@ -124,7 +124,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --to=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Address of the receiver
@@ -194,7 +194,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --to=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Address of the receiver
@@ -263,7 +263,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --to=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Address of the receiver
@@ -332,7 +332,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --to=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
       (required) Address of the receiver
@@ -401,7 +401,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --stableToken=<option>
       (required) Name of the stable to be transferred
diff --git a/tooling/libraries-sdks/cli/validator.mdx b/tooling/libraries-sdks/cli/validator.mdx
index da7b47f11..856e53304 100644
--- a/tooling/libraries-sdks/cli/validator.mdx
+++ b/tooling/libraries-sdks/cli/validator.mdx
@@ -58,7 +58,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -170,7 +170,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -230,7 +230,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -339,7 +339,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -397,7 +397,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -509,7 +509,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -623,7 +623,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --no-header
       hide table header from output
diff --git a/tooling/libraries-sdks/cli/validatorgroup.mdx b/tooling/libraries-sdks/cli/validatorgroup.mdx
index 60eca7f2e..73f60e673 100644
--- a/tooling/libraries-sdks/cli/validatorgroup.mdx
+++ b/tooling/libraries-sdks/cli/validatorgroup.mdx
@@ -56,7 +56,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --queue-update=<value>
       Queues an update to the commission, which can be applied after the update delay.
@@ -172,7 +172,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -282,7 +282,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --remove
       Remove a validator from the members list
@@ -358,7 +358,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
@@ -419,7 +419,7 @@ FLAGS
   --ledgerLiveMode
       When set, the 4th postion of the derivation path will be iterated over instead of
       the 5th. This is useful to use same address on you Ledger with celocli as you do on
-      Ledger Live
+      Ledger Wallet
 
   --useLedger
       Set it to use a ledger wallet
diff --git a/tooling/overview/migrate/from-ethereum.mdx b/tooling/overview/migrate/from-ethereum.mdx
index b7c9801a9..3f321fcde 100644
--- a/tooling/overview/migrate/from-ethereum.mdx
+++ b/tooling/overview/migrate/from-ethereum.mdx
@@ -83,7 +83,7 @@ You can [view the implementation here.](https://celo.blockscout.com/address/0xaa
 
 2.  Celo supports a broad range of Ethereum-compatible transaction types to ensure seamless integration with existing Ethereum tooling. In addition to standard Ethereum tx types like legacy (type 0), EIP-2930 (type 1), and EIP-1559 (type 2), Celo also supports OP Stack-specific deposited transactions (type 126) and introduces its own Celo-native tx type (type 123) to enable features like Fee Abstraction. While most Ethereum transactions work out of the box on Celo, developers can also take advantage of extended functionality such as paying gas fees in ERC-20 tokens.  For a more detailed overview, check out the full breakdown of supported (transaction types)[/what-is-celo/using-celo/protocol/transaction/transaction-types].
 
-1)  Mnemonic seed phrases can derive different accounts depending on the key derivation path used. While Ethereum wallets typically use the path `m/44'/60'/0'/0`, Celo defines its own path as `m/44'/52752'/0'/0`. Despite this, **most Celo wallets—including Valora—default to the Ethereum derivation path**, except in the case of some legacy accounts. Ledger Live, when used with the **Celo Ledger app**, strictly uses the Celo path. Tools like the **Celo CLI and the Celo Ledger app**, however, offer flexibility and allow users to specify either path explicitly.
+1)  Mnemonic seed phrases can derive different accounts depending on the key derivation path used. While Ethereum wallets typically use the path `m/44'/60'/0'/0`, Celo defines its own path as `m/44'/52752'/0'/0`. Despite this, **most Celo wallets—including Valora—default to the Ethereum derivation path**, except in the case of some legacy accounts. Ledger Wallet, when used with the **Celo Ledger app**, strictly uses the Celo path. Tools like the **Celo CLI and the Celo Ledger app**, however, offer flexibility and allow users to specify either path explicitly.
 
 2)  The Valora wallet uses two types of accounts: externally owned accounts and meta-transaction wallets. There are important consequences for wallet developers and dapp developers building on Celo as Valora is one of the main interfaces for Celo users. You can find more information about [Valora accounts here](/legacy/protocol/identity/smart-contract-accounts).
 
diff --git a/tooling/wallets/index.mdx b/tooling/wallets/index.mdx
index 981c5158e..6bbef2427 100644
--- a/tooling/wallets/index.mdx
+++ b/tooling/wallets/index.mdx
@@ -55,7 +55,7 @@ Celo Terminal is a wallet and dApp platform designed as a hub for managing and r
 - Homepage: [celoterminal.com](https://celoterminal.com)
 - Platforms: MacOS, Linux, Windows
 - Maintainers: [WOTrust](https://x.com/wotrust1)
-- Ledger support: Yes
+- Ledger support: Yes (Note: [EIP-712 signing requires workaround](/wallet/ledger/eip712-workaround))
 - [Source Code](https://github.com/zviadm/celoterminal)
 
 
diff --git a/tooling/wallets/ledger/eip712-workaround.mdx b/tooling/wallets/ledger/eip712-workaround.mdx
new file mode 100644
index 000000000..ac12627d6
--- /dev/null
+++ b/tooling/wallets/ledger/eip712-workaround.mdx
@@ -0,0 +1,151 @@
+---
+title: Ledger EIP-712 Signing Workaround
+og:description: How to sign EIP-712 typed data with Ledger using the Eth Recovery app.
+sidebarTitle: "EIP-712 Workaround"
+---
+
+Workaround for signing EIP-712 typed data with Ledger hardware wallets on Celo.
+
+---
+
+## The Issue
+
+The **Celo Ledger app** (when using the Celo-specific derivation path) currently does not support signing EIP-712 typed data, which is required for certain operations including:
+
+- Signing transactions in Safe multisigs via WalletConnect
+- Other dApps that require EIP-712 signature support
+- Smart contract interactions that use typed data signing
+
+If you encounter errors when trying to sign transactions (particularly with Safe multisigs), you'll need to use the **Eth Recovery** app as a workaround.
+
+<Note>
+**Important**: This issue only affects users using the **Celo app** with the Celo derivation path (`m/44'/52752'/0'/0`). If you're using the **Ethereum app** to interact with the Celo network (using the standard Ethereum derivation path `m/44'/60'/0'/0`), you do not need this workaround as the Ethereum app already supports EIP-712 signing.
+</Note>
+
+<Warning>
+This is a temporary workaround until the Celo Ledger app adds native EIP-712 typed data support. Future updates to the Celo Ledger app may add this functionality natively.
+</Warning>
+
+## When You DON'T Need This Workaround
+
+You do **not** need this workaround if:
+
+- You're using the **Ethereum app** on your Ledger to interact with Celo (using Ethereum derivation path)
+- Your wallet or dApp connects to Celo using the standard Ethereum derivation path (`m/44'/60'/0'/0`)
+- You're not using the Celo-specific Ledger app
+
+The Ethereum app natively supports EIP-712 signing and works with Celo network since Celo is EVM-compatible.
+
+## Solution: Using the Eth Recovery App
+
+This workaround is specifically for users who need to use the **Celo app** with the Celo derivation path but also need EIP-712 signing support.
+
+The Eth Recovery app provides the necessary EIP-712 signing capabilities that the Celo app currently lacks.
+
+### Step 1: Enable Developer Mode in Ledger Wallet
+
+1. Open **Ledger Wallet** on your computer
+2. Go to **Settings** → **About**
+3. Click **10 times** on the Ledger Wallet version number
+4. A new **Developer** tab will appear in the settings menu
+
+<Frame>
+![Ledger Wallet Developer Mode](https://developers.ledger.com/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Fdeveloper_mode_tab.18db0467.png&w=1920&q=75)
+</Frame>
+
+<Note>
+Developer Mode is available in Ledger Wallet version 2.32 and above. If you don't see the Developer tab appear after clicking on the version number, ensure your Ledger Wallet is updated to the latest version.
+</Note>
+
+### Step 2: Install the Eth Recovery App
+
+1. **Plug in your Ledger** device and unlock it
+2. Go to the **My Ledger** menu
+3. Search in the App Catalog for **"Eth Recovery"**
+4. If no app is found, check if your Ledger is prompting to upgrade firmware. If so, upgrade and return to step 3
+5. Click **Install** to install the Eth Recovery app
+
+<Note>
+The Eth Recovery app requires Developer Mode to be enabled in Ledger Wallet. This is a Ledger feature, not specific to Celo.
+</Note>
+
+### Step 3: Sign Transactions Using Eth Recovery
+
+When you need to sign a transaction that requires EIP-712 support (such as Safe multisig transactions):
+
+1. Connect to your Celo application (Celo Terminal, Safe, etc.) as you normally would
+2. **Instead of opening the Celo app** on your Ledger device, **open the Eth Recovery app**
+3. Proceed with your transaction signing as normal
+
+The key difference is which app you have open on your Ledger device when signing the transaction.
+
+### Important: Derivation Path Configuration
+
+<Warning>
+When using the Eth Recovery app to sign for an account originally created with the Celo app, you must ensure your wallet software is configured to use the **Celo derivation path** (`m/44'/52752'/0'/0`).
+</Warning>
+
+The Eth Recovery app can sign transactions for any derivation path - it's your wallet software (Celo Terminal, MetaMask, etc.) that determines which derivation path to use when requesting signatures.
+
+**If your account was created with the Celo app:**
+- Your address was derived using the Celo path: `m/44'/52752'/0'/0`
+- Your wallet software must continue using this path when connecting via the Eth Recovery app
+- Most Celo-native wallets (like Celo Terminal) will automatically use the correct Celo derivation path
+
+**If you're having trouble accessing the same address:**
+1. Check your wallet's derivation path settings
+2. Ensure it's set to use the Celo derivation path (`m/44'/52752'/0'/0`) rather than Ethereum (`m/44'/60'/0'/0`)
+3. In Celo Terminal, the derivation path should be preserved from your original account setup
+
+## Tested Configurations
+
+This workaround has been verified to work with:
+
+- **Celo Terminal**: versions 2.5.2 and 2.5.3
+- **Ledger Hardware**: Ledger Nano S on firmware 2.1.0
+- **Celo App**: version 1.3.2
+- **Safe**: multisig transactions via WalletConnect
+
+## Technical Background
+
+The issue occurs because the Celo Ledger app's library (`@celo/wallet-ledger`) checks for EIP-712 signing capabilities and errors out early if the feature isn't implemented, rather than returning a random error from the Ledger app itself. The specific method `signEIP712HashedMessage` is not implemented in the Celo Ledger app.
+
+This was introduced in this commit: [developer-tooling@25bf8e3](https://github.com/celo-org/developer-tooling/commit/25bf8e32ce76d5fb46de018714ed5aa71a715bc0)
+
+### Why This Affects Only the Celo App
+
+The Celo Ledger app uses a Celo-specific derivation path (`m/44'/52752'/0'/0`) to generate addresses. This is different from the Ethereum derivation path (`m/44'/60'/0'/0`) used by the Ethereum app.
+
+- **Celo app** (Celo derivation path): Does not support EIP-712 signing ❌
+- **Ethereum app** (Ethereum derivation path): Supports EIP-712 signing ✅
+
+Since Celo is EVM-compatible, you can use either derivation path to interact with the Celo network, but each has trade-offs:
+- **Celo path**: Celo-specific optimizations but lacks EIP-712 support
+- **Ethereum path**: Full EIP-712 support but uses standard Ethereum derivation
+
+## Troubleshooting
+
+### "Eth Recovery app not found"
+
+Make sure you have:
+- Enabled Developer Mode in Ledger Wallet settings
+- Updated your Ledger firmware to the latest version
+- Properly connected and unlocked your Ledger device
+
+### "Transaction still failing with Eth Recovery app"
+
+Verify that:
+- The Eth Recovery app is actually open on your Ledger device (not the Celo app)
+- Your Ledger device is unlocked and ready
+- You're using a supported version of Celo Terminal or other wallet software
+
+### Need Additional Help?
+
+If you continue to experience issues:
+- Check the [Celo Discord](https://chat.celo.org) for community support
+- Review the [Ledger Support](https://support.ledger.com/) documentation
+- File an issue in the relevant GitHub repository
+
+## Future Updates
+
+The Celo community is working on adding native EIP-712 support to the Celo Ledger app. Once this feature is implemented, this workaround will no longer be necessary.
diff --git a/tooling/wallets/ledger/setup.mdx b/tooling/wallets/ledger/setup.mdx
index 7aabca3bd..d4ee4d875 100644
--- a/tooling/wallets/ledger/setup.mdx
+++ b/tooling/wallets/ledger/setup.mdx
@@ -23,7 +23,7 @@ Make sure to have the following before you begin:
 
 - Initialized your [Ledger Nano X or S](https://support.ledger.com/hc/en-us/articles/360018784134)
 - The [latest firmware](https://support.ledger.com/hc/en-us/articles/360013349800) is installed
-- [Ledger Live](https://www.ledger.com/ledger-live) is ready to be used.
+- [Ledger Wallet](https://www.ledger.com/ledger-live) is ready to be used.
 
 ## Installation Instructions
 
@@ -35,7 +35,7 @@ Start by installing the Celo application and setting a PIN on your Ledger device
 Make sure to securely back up both the PIN and the recovery phrase (also known as a backup key or mnemonic). If you lose them, or they are stolen, you lose access to your Celo assets with no recovery possible. The recovery phrase will be shown only once.
 </Danger>
 
-Open the Ledger Live App on your computer and follow the instructions on the screen.
+Open the Ledger Wallet App on your computer and follow the instructions on the screen.
 
 Search for “Celo” in the app store.
 
@@ -57,7 +57,7 @@ The installation is completed once you see the green tick and **Installed** labe
 
 You should now see on your device’s screen `Celo app`. You may need to toggle left or right using the buttons on the device to find the app.
 
-Quit the Ledger Live app on your compute but keep the Ledger wallet connected to your computer.
+Quit the Ledger Wallet app on your compute but keep the Ledger wallet connected to your computer.
 
 ### Setting up the Celo app
 
@@ -71,4 +71,12 @@ The Celo app is now ready for use and you should see `Application is ready` on t
 
 - [Celo Terminal App](/wallet/ledger/to-celo-terminal)
 - [Celo Web Wallet](/wallet/ledger/to-celo-web)
-- [Celo CLI](/wallet/ledger/to-celo-cli)
\ No newline at end of file
+- [Celo CLI](/wallet/ledger/to-celo-cli)
+
+## Known Limitations
+
+<Warning>
+The Celo Ledger app currently does not support signing EIP-712 typed data, which is required for certain operations like signing Safe multisig transactions via WalletConnect.
+
+If you need to sign EIP-712 transactions, you'll need to use the **Eth Recovery app** as a workaround. See the [EIP-712 Signing Workaround guide](/wallet/ledger/eip712-workaround) for detailed instructions.
+</Warning>
\ No newline at end of file
diff --git a/tooling/wallets/ledger/to-celo-cli.mdx b/tooling/wallets/ledger/to-celo-cli.mdx
index 6e576a83d..848081faf 100644
--- a/tooling/wallets/ledger/to-celo-cli.mdx
+++ b/tooling/wallets/ledger/to-celo-cli.mdx
@@ -153,10 +153,10 @@ You'll then get a transaction hash when it's confirmed that the transaction was
 If you have issues connecting to the Ledger, try the following:
 
 - Check that the Ledger device is connected, powered on, and that you've unlocked it using the PIN.
-- Check that no other applications are using the device. Close Ledger Live. Stop any local Celo Blockchain node, or ensure it is run with the `--usb` option.
+- Check that no other applications are using the device. Close Ledger Wallet. Stop any local Celo Blockchain node, or ensure it is run with the `--usb` option.
 - Try unplugging and replugging the device. Some devices appear to trigger a warning on Macs saying: “USB Devices Disabled. Unplug the device using too much power to re-enable USB devices” which is usually resolved by reconnecting.
 - Ensure that you are using the original cable supplied with your Ledger.
 - Ensure that your Ledger has the [latest firmware](https://support.ledger.com/hc/en-us/articles/360002731113-Update-device-firmware). For Ledger Nano S, a firmware version of 1.6 or later is required.
 - Ensure that you are running the latest version of the Celo CLI.
 
-There have been reports of a possible [issue](https://github.com/celo-org/celo-ledger-spender-app-archived) that appears to affect developer store apps on the Ledger Nano X including the Celo Ledger App. This is believed to be fixed in version 1.0.3. In earlier versions, a user clicking through the `Pending Ledger review` notice too rapidly can cause the device to freeze. If this occurs, wait until the device's battery is depleted, then charge and power up again. Then use Ledger Live Manager to update the installed version of the Celo Ledger App.
\ No newline at end of file
+There have been reports of a possible [issue](https://github.com/celo-org/celo-ledger-spender-app-archived) that appears to affect developer store apps on the Ledger Nano X including the Celo Ledger App. This is believed to be fixed in version 1.0.3. In earlier versions, a user clicking through the `Pending Ledger review` notice too rapidly can cause the device to freeze. If this occurs, wait until the device's battery is depleted, then charge and power up again. Then use Ledger Wallet Manager to update the installed version of the Celo Ledger App.
\ No newline at end of file
diff --git a/tooling/wallets/ledger/to-celo-terminal.mdx b/tooling/wallets/ledger/to-celo-terminal.mdx
index 41b187ab5..31f28ee5b 100644
--- a/tooling/wallets/ledger/to-celo-terminal.mdx
+++ b/tooling/wallets/ledger/to-celo-terminal.mdx
@@ -43,4 +43,12 @@ A new window will appear listing available accounts, the default is selected (in
 
 After selecting “Add” you will need to confirm the address with your ledger device.
 
-Congrats, you have successfully attached your Ledger account to Celo Terminal.
\ No newline at end of file
+Congrats, you have successfully attached your Ledger account to Celo Terminal.
+
+## Known Limitations
+
+<Warning>
+The Celo Ledger app currently does not support signing EIP-712 typed data, which is required for Safe multisig transactions and certain dApps.
+
+If you need to sign EIP-712 transactions, see the [EIP-712 Signing Workaround guide](/wallet/ledger/eip712-workaround) for detailed instructions on using the Eth Recovery app.
+</Warning>
\ No newline at end of file

From 0665be072d339b3f13409070bbf6b2c309b06c15 Mon Sep 17 00:00:00 2001
From: Pavel Hornak <pavel.hornak@clabs.co>
Date: Thu, 29 Jan 2026 16:42:24 +0100
Subject: [PATCH 2/2] docs: add note about Developer Mode requirement for Eth
 Recovery app in EIP-712 workaround guide

Enhance the EIP-712 workaround documentation by including a note that the Eth Recovery app requires Developer Mode to be enabled in Ledger Wallet. This clarification helps users understand the necessary steps for proper functionality.
---
 tooling/wallets/ledger/eip712-workaround.mdx | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tooling/wallets/ledger/eip712-workaround.mdx b/tooling/wallets/ledger/eip712-workaround.mdx
index ac12627d6..b329d9376 100644
--- a/tooling/wallets/ledger/eip712-workaround.mdx
+++ b/tooling/wallets/ledger/eip712-workaround.mdx
@@ -42,6 +42,10 @@ This workaround is specifically for users who need to use the **Celo app** with
 
 The Eth Recovery app provides the necessary EIP-712 signing capabilities that the Celo app currently lacks.
 
+<Note>
+The Eth Recovery app requires Developer Mode to be enabled in Ledger Wallet. This is a Ledger feature, not specific to Celo.
+</Note>
+
 ### Step 1: Enable Developer Mode in Ledger Wallet
 
 1. Open **Ledger Wallet** on your computer
@@ -65,10 +69,6 @@ Developer Mode is available in Ledger Wallet version 2.32 and above. If you don'
 4. If no app is found, check if your Ledger is prompting to upgrade firmware. If so, upgrade and return to step 3
 5. Click **Install** to install the Eth Recovery app
 
-<Note>
-The Eth Recovery app requires Developer Mode to be enabled in Ledger Wallet. This is a Ledger feature, not specific to Celo.
-</Note>
-
 ### Step 3: Sign Transactions Using Eth Recovery
 
 When you need to sign a transaction that requires EIP-712 support (such as Safe multisig transactions):