Wallet Management

Connect ICP-compatible wallets to your Hello World DAO account for self-custody authentication and on-chain interactions.

Supported Wallets

Wallet	Type	Platform	Description
Internet Identity	Browser (passkey)	All	ICP's native passwordless auth using biometrics or security keys
Plug	Browser extension	Chrome	Popular ICP wallet with token management and dApp browser
NFID	Browser (popup)	All	Email/passkey-based ICP wallet with delegation support
Ledger	Hardware (USB)	Desktop	Cold storage via Ledger Nano S/X with ICP app
Trezor	Hardware (USB)	Desktop	Cold storage via Trezor Model T/One with Trezor Bridge

Connecting a Wallet

Software Wallets (Plug, NFID)

1. Go to the login page at helloworlddao.com/login
2. Below the email/password form, find the Wallet Selector
3. Click the wallet you want to connect
4. Approve the connection in the wallet popup
5. You'll be redirected to the dashboard

Hardware Wallets (Ledger, Trezor)

Hardware wallets are only available on desktop (hidden on mobile viewports).

Ledger:

1. Connect your Ledger device via USB
2. Unlock the device and open the Internet Computer (ICP) app
3. Click the Ledger button in the Wallet Selector
4. Approve the WebUSB device access in your browser
5. Approve the connection on your Ledger device

Trezor:

1. Ensure Trezor Bridge is running
2. Connect your Trezor device via USB and unlock it
3. Click the Trezor button in the Wallet Selector
4. Approve the public key export in the Trezor Connect popup

Internet Identity

See the dedicated Internet Identity guide for setup and linking instructions.

How Wallet Login Works

When you log in with a wallet:

1. The wallet provides your ICP principal (your on-chain identity)
2. The system checks if your principal is already associated with an account
3. If yes: you're logged in to your existing account
4. If no: a new account is automatically created
5. A secure session is established via HttpOnly cookies (same as email/password login)

Your session works across all Hello World DAO apps (DAO Portal, Foundery OS, Governance, Otter Camp) without re-authenticating.

Multiple Wallets

You can log in with different wallets at different times. The system tracks your active wallet and remembers your last-used wallet for convenience.

Switching Wallets

1. Log out of your current session
2. Return to the login page
3. Select a different wallet — your last-used wallet will be highlighted
4. Log in with the new wallet

Wallet Linking

If you have multiple wallets, they can be linked to the same membership record. This means your membership status (Active, Registered) is recognized regardless of which wallet you log in with.

Wallet linking is currently managed by DAO administrators. Contact the team if you need to link a secondary wallet to your account.

Session Behavior

Wallet Type	Session Persistence	Page Refresh	Browser Restart
Software (Plug, NFID, II)	Delegation chain in browser + cookies	Session persists	Session persists (until delegation expires)
Hardware (Ledger, Trezor)	Cookies only (no stored delegation)	Session persists via cookies	Session persists via cookies

Hardware wallets don't store delegation chains in the browser for security — your session is maintained entirely via server-side cookies.

Troubleshooting

Wallet Not Appearing

• Plug not showing? Install the Plug extension for Chrome
• Ledger/Trezor not showing? Hardware wallets are desktop-only. Resize your browser window if it's too narrow.
• NFID popup blocked? Allow popups for helloworlddao.com in your browser settings

Connection Fails

• Plug: Make sure the extension is unlocked and not connected to another dApp
• Ledger: Ensure the ICP app is open on the device (screen shows "Internet Computer")
• Trezor: Verify Trezor Bridge is running (http://localhost:21325 should respond)
• NFID: Try a different browser if the popup fails to open

Login Succeeds but Dashboard Doesn't Load

1. Check browser console for errors (F12 → Console tab)
2. Clear cookies for helloworlddao.com and try again
3. If using a hardware wallet, ensure the device is still connected during redirect

"Wallet Not Found" After Login

Your wallet principal may not be linked to an existing account. The system should auto-create one, but if it fails:

1. Try registering first at helloworlddao.com/signup using the same wallet
2. Contact support if the issue persists

Security

• Wallet login uses the same HttpOnly cookie security as email/password login
• No private keys or seed phrases are ever sent to our servers
• Hardware wallet keys never leave the device
• Rate limiting protects the login endpoint from abuse
• All connections use HTTPS with Secure cookies