[DIS] Pocket Node for iOS: a self-custody CKB light client for Apple and Identity/Signer for CCC web apps

Pocket Node for iOS: Milestone 2 complete and signed off

M2 (keys, security, onboarding, receive) is finished and has passed the Nervos testing team’s review. Thanks to yanli @Xcodes-chain for a thorough, two-round review: every finding below came from it.

Round 1 review (4 findings, all fixed)

  • P1: quitting during onboarding before the backup or PIN step could open the wallet without a PIN. It now resumes at the first unfinished step. (#546)
  • P1: a device backup could restore the wallet file without its device-only keys. The app now detects this and restores from the recovery phrase, which must match the stored address. The app folder is also excluded from iCloud backup. (#547)
  • P2: a recovery phrase reveal that finished after the app went to the background could still show the words. Late results are now dropped. (#545)
  • P2: after a permanent PIN lockout, a cold start could briefly offer Face ID. It no longer does. (#544)
  • Follow-ups: 14 smaller hardening fixes, including a PIN check that fails closed if its attempt counter cannot be read. (#549)

Round 2 verification (2 new findings, both fixed)

  • P1: a PIN or Face ID unlock that finished after the app was backgrounded could unlock it. All four unlock paths now refuse a stale result. (#556)

  • P1: no recovery path if the Secure Enclave key was invalidated, or if keys survived without their wallet file. The app now tells usable, missing, invalidated and temporarily unavailable keys apart, without prompting:

    • A wallet with a record restores behind the PIN with its own phrase.
    • Keys are only ever replaced on firm proof.
    • A temporary error never deletes anything.

    Verified on an iPhone 14 Pro. (#557)

Verification

  • 485 iOS unit tests plus UI tests, green in CI.
  • Device tests on real hardware for the Secure Enclave behaviour.
  • Every fix went through an independent adversarial code review before merging.

Next: M3 (send, sync, activity, TestFlight). The work is well underway and will land in the public repo soon.

3 Likes