You're testing Logbook Beta on Sui Testnet. Learn more →
Documentation

Learn Logbook

Everything you need to create blockchain-verified surveys, understand the technology, and get the most out of Logbook.

DocsAuthentication
4 min read

Authentication Methods

Logbook supports two ways to authenticate: zkLogin with Google and traditional crypto wallets.

#zkLogin with Google

zkLogin is a technology developed by Mysten Labs that allows you to use your Google account as your blockchain identity.

#How It Works

  1. 1You click "Continue with Google"
  2. 2You sign in with your Google account
  3. 3Behind the scenes, a unique blockchain address is computed from your Google identity
  4. 4A zero-knowledge proof verifies your identity without exposing private data

#Benefits

  • No wallet needed: Use your existing Google account
  • No crypto knowledge required: Works just like any other Google sign-in
  • Secure: Your Google password is never shared with Logbook
  • Consistent address: Your Google account always maps to the same blockchain address within Logbook

#Address Uniqueness

Your zkLogin address is unique to each application. The same Google account will generate different blockchain addresses in different dApps. This is by design for privacy — different applications cannot link your accounts by comparing addresses.

#Privacy

zkLogin uses zero-knowledge cryptography. This means:

  • Logbook never sees your Google password
  • The blockchain doesn't store your email
  • Your identity is verified mathematically without exposing personal data

#Crypto Wallets

If you prefer using a traditional crypto wallet, Logbook supports many popular options:

#Supported Wallets

  • Slush (formerly Sui Wallet)
  • Phantom
  • Suiet
  • OKX Wallet
  • Backpack
  • Martian
  • Nightly
  • Any other wallet that supports the Sui Wallet Standard

#How to Connect

  1. 1Click "Log in" on the homepage
  2. 2Select your wallet from the list
  3. 3Approve the connection request in your wallet

#Benefits

  • Full control: You manage your own keys
  • Use existing wallet: If you already have a Sui wallet, use it directly
  • Advanced features: Access to all blockchain features

#Mobile Devices

On mobile phones, wallet browser extensions are not available. To connect with a crypto wallet on mobile:

  1. 1Open the Logbook website using your wallet's built-in browser (not Safari or Chrome)
  2. 2Most wallets have a "Browser" or "Explore" tab where you can enter the URL
  3. 3Connect as usual — the wallet will detect the connection request automatically
Popular mobile wallets with built-in browsers: Slush, Phantom, OKX Wallet.

#Signing to Read Private Data

Private campaigns keep their content and answers encrypted. To decrypt them, your browser has to prove your address to the Seal key servers by signing a short message. This is not a transaction and costs nothing.

  • Google users: the message is signed automatically in the background
  • Wallet users: your wallet shows a "sign message" request the first time you open private data; the signature stays valid for 15 minutes

#AI Agents Acting as Your Account

An AI agent can act as your Logbook account for a limited time. Nothing of your Google password or your web session is shared: the agent receives a time-limited proof that only works together with a temporary key. There are two kinds of sessions, and they differ in where that key lives.

  • Local agent (Claude Code, Claude Desktop, Cursor, your own agent): the agent opens a consent page on Logbook, you sign in with Google, and the proof goes to a listener on your own computer (127.0.0.1). The key never leaves your machine, so Logbook cannot act as you and cannot revoke the session either. It lasts 2 days by default (7 at most); signing the agent out deletes the key.
  • Connected app (claude.ai and other chats with connectors): the app sends you to Logbook's consent page. With "Continue with Google", Logbook keeps the session key on its servers, encrypted, for 7 days, so the app can act as you without anything installed. This session can be revoked at any moment: disconnect the app, or ask it to sign out of Logbook. "Continue without an account" connects the app read-only.
In both cases the consent page names the app, says what it will be able to do and for how long. Only approve a sign-in you started yourself. Campaigns the agent creates are yours, and its response counts as your one response.

#Logging Out

To disconnect, click on your address in the header and select "Disconnect". This ends your web session only: agent sessions are ended separately, as described above.