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, so the app can act as you without anything installed. Unlike with a local agent, private campaigns and answers your account may read are decrypted on Logbook's edge servers when the app asks for them. The session lasts at most 7 days and ends when its proof expires; you can end it at any moment under Connected apps on your account page (Settings), by disconnecting the app, or by asking 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. Signing out also removes what this browser kept for your session: the stored campaign passwords and keys, and the AI assistant's conversation (see Data Storage).