Skip to content

rfc: Web3Auth social login integration for Hathor wallets#106

Open
andreabadesso wants to merge 3 commits into
masterfrom
feat/web3auth-integration
Open

rfc: Web3Auth social login integration for Hathor wallets#106
andreabadesso wants to merge 3 commits into
masterfrom
feat/web3auth-integration

Conversation

@andreabadesso
Copy link
Copy Markdown
Contributor

@andreabadesso andreabadesso commented Mar 15, 2026

Rendered

Summary

Foundation RFC for the Web3Auth integration: what Web3Auth is, how we talk to it, and what we have to do operationally to ship it. Implementation designs per layer live in companion RFCs.

Related work

# Type Link Scope
This Foundation RFC #106 What Web3Auth is + operational setup
2 Design RFC HathorNetwork/internal-rfcs#46 Wallet-lib single-key mode + mobile onboarding UI
3 Design RFC HathorNetwork/internal-rfcs#47 Wallet-service support (stacked on #46)
4 PoC HathorNetwork/hathor-wallet-lib#1062 Library implementation + tests

Test plan

  • Product review of open decisions (recovery-share policy, OAuth provider set, session lifetime)
  • Security review of trust model, verifier strategy (custom vs shared), SSS-vs-MPC launch posture
  • Ops review of account ownership, dashboard access, monitoring plan
  • Finance review of pricing-tier recommendation
  • Legal review of privacy policy / ToS updates + DPA with Web3Auth
  • Consistency check vs internal-rfcs#46 single-key architectural decision

Design document for integrating Web3Auth into Hathor wallets,
enabling social login (Google, Apple, email) as an alternative
to seed phrase management.
@andreabadesso andreabadesso changed the title RFC: Web3Auth social login integration for Hathor wallets rfc: Web3Auth social login integration for Hathor wallets Mar 16, 2026
@andreabadesso andreabadesso self-assigned this Mar 16, 2026
@andreabadesso andreabadesso added the enhancement New feature or request label Mar 16, 2026
@andreabadesso andreabadesso moved this from Todo to In Progress (Done) in Hathor Network Mar 16, 2026
@andreabadesso andreabadesso moved this from In Progress (Done) to In Progress (WIP) in Hathor Network Mar 16, 2026
@andreabadesso andreabadesso moved this from In Progress (WIP) to Todo in Hathor Network Apr 14, 2026
The original draft was 570 lines of open-ended exploration. Rewrite
to 277 lines focused on what we actually have to do.

Major changes:

- Fix architectural contradiction: replaced the "use raw Web3Auth key
  as BIP32 master entropy and derive a tree" approach with a pointer
  to the single-key wallet mode in internal-rfcs#46. Fabricating a
  chain code from the raw key breaks cross-app portability and is a
  non-standard crypto construction.

- Add operational setup section — the missing actionable piece. Covers
  Web3Auth dashboard registration, pricing tier selection, OAuth
  provider setup per platform, verifier strategy (recommend custom
  verifiers), recovery-share enforcement, monitoring, and legal/DPA
  requirements. These are company-level actions that have to happen
  before any code runs.

- Scope as cross-cutting foundation: link to internal-rfcs#46 (wallet-
  lib + mobile UI), internal-rfcs#47 (wallet-service support), and
  hathor-wallet-lib#1062 (library PoC) as the per-layer designs this
  foundation enables.

- Cut content that was exploratory but not actionable: full DKG
  protocol walkthrough with bivariate polynomials, Lagrange
  interpolation math, per-node endpoint tables, Electron smart
  contract registry address, the "what happens if Web3Auth
  disappears" Mermaid diagram (kept a concise table instead).

- Replace "Unresolved questions" with "Open decisions" — each item
  now names an owner (product / security / ops / finance) and is a
  choice, not a research question.

- Remove outdated desktop-specific file-level changes (/src/screens/
  WalletType.js, etc.) — the desktop wallet is now a future
  possibility, not phase 1 scope.
- Link the inline `internal-rfcs#46` and `hathor-wallet-lib#1062`
  references in the body text (previously linked only in the
  top-matter and in the Related work section).
- Add URLs to Prior art entries (MetaMask Embedded Wallets, Binance
  Web3 Wallet, Argent, Phantom) — they were bold labels without
  hrefs.
- Add URLs to Alternatives rejected entries (Magic, Privy, Dynamic,
  tss-lib) for consistency with the Prior art fix.
@andreabadesso andreabadesso moved this from Todo to In Progress (WIP) in Hathor Network Apr 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

Status: In Progress (WIP)

Development

Successfully merging this pull request may close these issues.

1 participant