JoiaXJoiaX

How to sign in with a Web3 wallet

Connect the wallet, sign the sign in message and understand what makes a signature be refused.

Signing in with a wallet uses no password and moves no funds. You sign a text message that proves the address is yours, and that signature is what opens the session.

Step by step

  1. Open the sign in screen and choose to sign in with a wallet.
  2. Pick your wallet from the list, or search by name.
  3. Authorise the connection inside the wallet.
  4. Read the sign in message and sign it.
  5. If the wallet is already linked, the site opens signed in.
  6. If this is your first time, a screen asks for email, display name and acceptance of the terms.

Important points

The sign in message is text, not a transaction. It names the site, the wallet address, a random number and the validity. No fee is charged and no balance leaves the wallet.

Wallets detected on your device come first. Below them comes the catalog, which loads more items as you scroll and accepts a search by name.

On a computer you get a code to scan with your phone. On a phone you get the shortcut that opens the wallet. The code is good for one attempt and can be generated again.

Requesting sign in again returns the same message for that address, with the same validity. A new message is only minted once the previous one expires, so signing in one tab while asking again in another keeps working.

Once accepted, it is consumed. If the validity runs out while the wallet is open, the screen says it expired and offers to try again.

Many attempts in a row from the same device or the same network make the platform ask you to wait. The count is not per wallet address, so nobody can lock you out by trying with your address.

The wallet reports no email and no name. The next screen asks for a contact email, a display name and acceptance of the terms.

If you try to link an address that already sits on another account, the link is refused. The same holds the other way around: signing in with a linked wallet always takes you to its account.

If the wallet is your only method and you have no password, the removal is refused. Set a password, or link another method, first.

The platform stores the public address and the date of the link. Your private key and your recovery phrase never leave the wallet and are never asked for.

Common problems

Tap sign in with a wallet again. The same message is still valid and you can sign it now.

The connection window may have been left waiting in the background. Go back to the wallet, confirm the connection and, if the screen says it expired, generate the code again.

There is another connection in progress in the same app. Finish or cancel that connection and try again.

The message validity had already run out, or the signature came from a different address than the one the message names. Start again and sign the message that appears right then, with the same wallet account.

Too many attempts in a row from this device or this network. Wait and try again; nothing was blocked on your account.

Search by name, because the catalog is bigger than the first items shown. If it still does not show up, use the scan code, which works with any wallet that holds its own key. A wallet that is a contract on the network, such as smart account wallets, stays out of the list because its signature is not recognized here.

No. The link is with the address, not with the app. A different address is treated as a different method and leads to a new account, unless you link it to your account in Security.

Yes. Methods coexist, and having more than one is exactly what lets you remove any of them later.

See also

Let’s work through it together

Read the guides without signing in. Sign in to contact the team and follow the reply.