Withdrawals

How funds are transferred from Claimr to a user's wallet.

User Flow

At claimr.app:

1. Enter Twitter handle to view balance

2. Authenticate with Twitter

3. Specify destination wallet address

4. Confirm withdrawal

Funds arrive within seconds. A 2% protocol fee is deducted.

Process

1. Backend verifies Twitter authentication

2. Oracle signs a withdrawal permit

3. Transaction submitted with Ed25519 signature verification

4. Contract validates signature and transfers funds

5. 2% sent to treasury, remainder sent to destination

For Integrators

Withdrawals require Twitter OAuth and must go through claimr.app. However, you can prepare users:

Verify withdrawal eligibility:

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

canWithdraw is true when balance >= 0.04 SOL.

Collect before directing users:

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

Then redirect to claimr.app.

Troubleshooting

Error	Cause
"Minimum withdrawal is 0.04 SOL"	Insufficient balance
"Nothing to withdraw"	PDA is empty; check if vault needs collection
Twitter login fails	User must authenticate with the matching account