Skip to main content

Earn and claim BitView tokens

You watch streams. You should get paid for it.

One-time setup — link your wallet​

You only do this once.

  1. Open the BitView app and connect a Solana wallet (Phantom, Solflare, Backpack…).
  2. Sign in with Twitch — the app uses Twitch's standard OAuth flow and only asks for the user:read:email scope to verify your identity.
  3. Click Link wallet. Your wallet pops up a "Sign Message" prompt asking you to sign a short string that includes your Twitch user id. Approve it.
  4. Done. The backend now knows that this Twitch identity owns this wallet.

What happens behind the scenes:

  • Frontend → POST /bitview-api/user/link with the Twitch bearer token, the signed message, and your wallet's signature.
  • Backend verifies the bearer with https://api.twitch.tv/helix/users and verifies the ed25519 signature against your wallet pubkey.

Importantly, only signing both proves the link. Someone with your Twitch token alone can't steal accruals to a wallet they own — they'd have to sign with your wallet's private key too.

Watching → earning​

  1. Open the BitView app and find a stream with an active distribution.
  2. Watch. The bot sees you in chat (you'll be credited as soon as you join).
  3. Pop in a chat message every now and then. Many distributions weight or gate on Privmsg events to filter pure lurkers.

You don't have to do anything else. The backend tallies your accrued tokens in the background.

Checking your balance​

The viewer page shows your accruals across every distribution. Or hit the API:

curl http://api.bitview.so/bitview-api/viewer/<your-wallet>/accruals

Claiming​

Once a distribution is claimable (the streamer or operator has finalized it and the root is published on-chain), the Claim button lights up.

  1. Click claim.
  2. Frontend fetches the proof — GET /claims-api/proof/{your-wallet}.
  3. It builds the new_claim instruction and asks your wallet to sign + send.
  4. Tokens land in your associated token account for that mint.

You pay the Solana network fee (a fraction of a cent). Most token accounts need a small amount of SOL for rent — the merkle distributor's typical claim costs roughly 0.000010 SOL.

Troubleshooting​

"User not found" when I try to claim. You linked your wallet after the distribution snapshot. Future events are fine; past ones aren't retroactive.

Tokens didn't land. Check your wallet on the relevant cluster. Some wallets hide tokens with a zero balance until you manually add the mint. Add the mint and refresh.

Twitch reauthorization keeps popping up. Twitch user-access tokens last hours, not days. Re-sign in is normal.