Skip to content

Commit df91291

Browse files
pahor167Pavel Hornak
andauthored
docs: add Ledger EIP-712 workaround guide and rebrand Ledger Live to … (#2128)
* 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 * 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. --------- Co-authored-by: Pavel Hornak <pavel.hornak@clabs.co>
1 parent 211cb68 commit df91291

20 files changed

Lines changed: 274 additions & 107 deletions

home/wallets.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Celo Terminal is a wallet and dApp platform designed as a hub for managing and r
5050
- Homepage: [celoterminal.com](https://celoterminal.com)
5151
- Platforms: MacOS, Linux, Windows
5252
- Maintainers: [WOTrust](https://x.com/wotrust1)
53-
- Ledger support: Yes
53+
- Ledger support: Yes (Note: [EIP-712 signing requires workaround](/wallet/ledger/eip712-workaround))
5454
- [Source Code](https://github.com/zviadm/celoterminal)
5555

5656
---

tooling/libraries-sdks/cli/account.mdx

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ FLAGS
7777
--ledgerLiveMode
7878
When set, the 4th postion of the derivation path will be iterated over instead of
7979
the 5th. This is useful to use same address on you Ledger with celocli as you do on
80-
Ledger Live
80+
Ledger Wallet
8181

8282
--signature=0x
8383
(required) Signature (a.k.a proof-of-possession) of the signer key
@@ -195,7 +195,7 @@ FLAGS
195195
--ledgerLiveMode
196196
When set, the 4th postion of the derivation path will be iterated over instead of
197197
the 5th. This is useful to use same address on you Ledger with celocli as you do on
198-
Ledger Live
198+
Ledger Wallet
199199

200200
--publicKey=<value>
201201
The public key of the account that others may use to send you encrypted messages
@@ -265,7 +265,7 @@ FLAGS
265265
--ledgerLiveMode
266266
When set, the 4th postion of the derivation path will be iterated over instead of
267267
the 5th. This is useful to use same address on you Ledger with celocli as you do on
268-
Ledger Live
268+
Ledger Wallet
269269
270270
--useLedger
271271
Set it to use a ledger wallet
@@ -328,7 +328,7 @@ FLAGS
328328
--ledgerLiveMode
329329
When set, the 4th postion of the derivation path will be iterated over instead of
330330
the 5th. This is useful to use same address on you Ledger with celocli as you do on
331-
Ledger Live
331+
Ledger Wallet
332332

333333
--useLedger
334334
Set it to use a ledger wallet
@@ -394,7 +394,7 @@ FLAGS
394394
--ledgerLiveMode
395395
When set, the 4th postion of the derivation path will be iterated over instead of
396396
the 5th. This is useful to use same address on you Ledger with celocli as you do on
397-
Ledger Live
397+
Ledger Wallet
398398
399399
--name=<value>
400400
(required) The name you want to claim
@@ -460,7 +460,7 @@ FLAGS
460460
--ledgerLiveMode
461461
When set, the 4th postion of the derivation path will be iterated over instead of
462462
the 5th. This is useful to use same address on you Ledger with celocli as you do on
463-
Ledger Live
463+
Ledger Wallet
464464

465465
--rpcUrl=https://www.celo.org
466466
(required) The RPC URL to claim
@@ -526,7 +526,7 @@ FLAGS
526526
--ledgerLiveMode
527527
When set, the 4th postion of the derivation path will be iterated over instead of
528528
the 5th. This is useful to use same address on you Ledger with celocli as you do on
529-
Ledger Live
529+
Ledger Wallet
530530
531531
--url=https://www.celo.org
532532
(required) The URL of the storage root you want to claim
@@ -592,7 +592,7 @@ FLAGS
592592
--ledgerLiveMode
593593
When set, the 4th postion of the derivation path will be iterated over instead of
594594
the 5th. This is useful to use same address on you Ledger with celocli as you do on
595-
Ledger Live
595+
Ledger Wallet
596596

597597
--useLedger
598598
Set it to use a ledger wallet
@@ -658,7 +658,7 @@ FLAGS
658658
--ledgerLiveMode
659659
When set, the 4th postion of the derivation path will be iterated over instead of
660660
the 5th. This is useful to use same address on you Ledger with celocli as you do on
661-
Ledger Live
661+
Ledger Wallet
662662
663663
--signer=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
664664
(required) Account Address
@@ -720,7 +720,7 @@ FLAGS
720720
--ledgerLiveMode
721721
When set, the 4th postion of the derivation path will be iterated over instead of
722722
the 5th. This is useful to use same address on you Ledger with celocli as you do on
723-
Ledger Live
723+
Ledger Wallet
724724
725725
--useLedger
726726
Set it to use a ledger wallet
@@ -792,7 +792,7 @@ FLAGS
792792
--ledgerLiveMode
793793
When set, the 4th postion of the derivation path will be iterated over instead of
794794
the 5th. This is useful to use same address on you Ledger with celocli as you do on
795-
Ledger Live
795+
Ledger Wallet
796796
797797
--no-header
798798
hide table header from output
@@ -879,7 +879,7 @@ FLAGS
879879
--ledgerLiveMode
880880
When set, the 4th postion of the derivation path will be iterated over instead of
881881
the 5th. This is useful to use same address on you Ledger with celocli as you do on
882-
Ledger Live
882+
Ledger Wallet
883883
884884
--no-header
885885
hide table header from output
@@ -948,7 +948,7 @@ FLAGS
948948
--ledgerLiveMode
949949
When set, the 4th postion of the derivation path will be iterated over instead of
950950
the 5th. This is useful to use same address on you Ledger with celocli as you do on
951-
Ledger Live
951+
Ledger Wallet
952952
953953
--[no-]local
954954
If set, only show local and hardware wallet accounts. Use no-local to only show
@@ -1007,7 +1007,7 @@ FLAGS
10071007
--ledgerLiveMode
10081008
When set, the 4th postion of the derivation path will be iterated over instead of
10091009
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1010-
Ledger Live
1010+
Ledger Wallet
10111011
10121012
--useLedger
10131013
Set it to use a ledger wallet
@@ -1157,7 +1157,7 @@ FLAGS
11571157
--ledgerLiveMode
11581158
When set, the 4th postion of the derivation path will be iterated over instead of
11591159
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1160-
Ledger Live
1160+
Ledger Wallet
11611161
11621162
--signer=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
11631163
(required) Address of the signer key to prove possession of.
@@ -1220,7 +1220,7 @@ FLAGS
12201220
--ledgerLiveMode
12211221
When set, the 4th postion of the derivation path will be iterated over instead of
12221222
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1223-
Ledger Live
1223+
Ledger Wallet
12241224
12251225
--name=<value>
12261226
@@ -1285,7 +1285,7 @@ FLAGS
12851285
--ledgerLiveMode
12861286
When set, the 4th postion of the derivation path will be iterated over instead of
12871287
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1288-
Ledger Live
1288+
Ledger Wallet
12891289
12901290
--publicKey=<value>
12911291
(required) The public key you want to register
@@ -1365,7 +1365,7 @@ FLAGS
13651365
--ledgerLiveMode
13661366
When set, the 4th postion of the derivation path will be iterated over instead of
13671367
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1368-
Ledger Live
1368+
Ledger Wallet
13691369
13701370
--no-header
13711371
hide table header from output
@@ -1441,7 +1441,7 @@ FLAGS
14411441
--ledgerLiveMode
14421442
When set, the 4th postion of the derivation path will be iterated over instead of
14431443
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1444-
Ledger Live
1444+
Ledger Wallet
14451445
14461446
--name=<value>
14471447
(required)
@@ -1511,7 +1511,7 @@ FLAGS
15111511
--ledgerLiveMode
15121512
When set, the 4th postion of the derivation path will be iterated over instead of
15131513
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1514-
Ledger Live
1514+
Ledger Wallet
15151515
15161516
--useLedger
15171517
Set it to use a ledger wallet
@@ -1572,7 +1572,7 @@ FLAGS
15721572
--ledgerLiveMode
15731573
When set, the 4th postion of the derivation path will be iterated over instead of
15741574
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1575-
Ledger Live
1575+
Ledger Wallet
15761576
15771577
--signature=0x
15781578
Signature (a.k.a. proof-of-possession) of the signer key
@@ -1673,7 +1673,7 @@ FLAGS
16731673
--ledgerLiveMode
16741674
When set, the 4th postion of the derivation path will be iterated over instead of
16751675
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1676-
Ledger Live
1676+
Ledger Wallet
16771677
16781678
--useLedger
16791679
Set it to use a ledger wallet
@@ -1781,7 +1781,7 @@ FLAGS
17811781
--ledgerLiveMode
17821782
When set, the 4th postion of the derivation path will be iterated over instead of
17831783
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1784-
Ledger Live
1784+
Ledger Wallet
17851785
17861786
--password=<value>
17871787
Password used to unlock the account. If not specified, you will be prompted for a
@@ -1847,7 +1847,7 @@ FLAGS
18471847
--ledgerLiveMode
18481848
When set, the 4th postion of the derivation path will be iterated over instead of
18491849
the 5th. This is useful to use same address on you Ledger with celocli as you do on
1850-
Ledger Live
1850+
Ledger Wallet
18511851
18521852
--signature=0x
18531853
(required) Signature (a.k.a. proof-of-possession) of the signer key

tooling/libraries-sdks/cli/election.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ FLAGS
5555
--ledgerLiveMode
5656
When set, the 4th postion of the derivation path will be iterated over instead of
5757
the 5th. This is useful to use same address on you Ledger with celocli as you do on
58-
Ledger Live
58+
Ledger Wallet
5959
6060
--useLedger
6161
Set it to use a ledger wallet
@@ -133,7 +133,7 @@ FLAGS
133133
--ledgerLiveMode
134134
When set, the 4th postion of the derivation path will be iterated over instead of
135135
the 5th. This is useful to use same address on you Ledger with celocli as you do on
136-
Ledger Live
136+
Ledger Wallet
137137
138138
--no-header
139139
hide table header from output
@@ -254,7 +254,7 @@ FLAGS
254254
--ledgerLiveMode
255255
When set, the 4th postion of the derivation path will be iterated over instead of
256256
the 5th. This is useful to use same address on you Ledger with celocli as you do on
257-
Ledger Live
257+
Ledger Wallet
258258
259259
--useLedger
260260
Set it to use a ledger wallet
@@ -398,7 +398,7 @@ FLAGS
398398
--ledgerLiveMode
399399
When set, the 4th postion of the derivation path will be iterated over instead of
400400
the 5th. This is useful to use same address on you Ledger with celocli as you do on
401-
Ledger Live
401+
Ledger Wallet
402402
403403
--useLedger
404404
Set it to use a ledger wallet

tooling/libraries-sdks/cli/epochs.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ FLAGS
9090
--ledgerLiveMode
9191
When set, the 4th postion of the derivation path will be iterated over instead of
9292
the 5th. This is useful to use same address on you Ledger with celocli as you do on
93-
Ledger Live
93+
Ledger Wallet
9494
9595
--useLedger
9696
Set it to use a ledger wallet
@@ -149,7 +149,7 @@ FLAGS
149149
--ledgerLiveMode
150150
When set, the 4th postion of the derivation path will be iterated over instead of
151151
the 5th. This is useful to use same address on you Ledger with celocli as you do on
152-
Ledger Live
152+
Ledger Wallet
153153

154154
--useLedger
155155
Set it to use a ledger wallet
@@ -211,7 +211,7 @@ FLAGS
211211
--ledgerLiveMode
212212
When set, the 4th postion of the derivation path will be iterated over instead of
213213
the 5th. This is useful to use same address on you Ledger with celocli as you do on
214-
Ledger Live
214+
Ledger Wallet
215215
216216
--useLedger
217217
Set it to use a ledger wallet
@@ -274,7 +274,7 @@ FLAGS
274274
--ledgerLiveMode
275275
When set, the 4th postion of the derivation path will be iterated over instead of
276276
the 5th. This is useful to use same address on you Ledger with celocli as you do on
277-
Ledger Live
277+
Ledger Wallet
278278

279279
--useLedger
280280
Set it to use a ledger wallet
@@ -377,7 +377,7 @@ FLAGS
377377
--ledgerLiveMode
378378
When set, the 4th postion of the derivation path will be iterated over instead of
379379
the 5th. This is useful to use same address on you Ledger with celocli as you do on
380-
Ledger Live
380+
Ledger Wallet
381381

382382
--useLedger
383383
Set it to use a ledger wallet

0 commit comments

Comments
 (0)