Withdrawing

How funds get from Claimr to someone's wallet.

For users

Go to claimr.app:

1. Enter your Twitter handle to see the balance

2. Log in with Twitter

3. Enter destination wallet

4. Withdraw

Funds arrive in seconds. 2% fee deducted.

What happens

1. Backend confirms Twitter auth

2. Signs a withdrawal permit

3. Transaction goes on-chain with signature verification

4. Contract checks signature, transfers funds

5. 2% → treasury, rest → destination

For integrators

You can't build withdrawals yourself - they need Twitter OAuth. But you can prep users:

Check if they can withdraw:

curl "https://claimr.app/api/wallet/lookup?handle=theirhandle"

canWithdraw is true if balance >= 0.04 SOL.

Collect first:

curl -X POST https://claimr.app/api/collect \
  -H "Content-Type: application/json" \
  -d '{"twitterId": "their_id"}'

Then send them to claimr.app.

Common issues

"Minimum withdrawal is 0.04 SOL" - Not enough balance yet.

"Nothing to withdraw" - PDA is empty. Check if vault has funds to collect.

Twitter login fails - They need to use the account that matches the handle.