Claiming Tips

Learn how to verify your X account and claim your tips to any wallet.

How Claiming Works

Tips are held in escrow until you prove you own the X handle. The claim process uses:

X OAuth

Oracle Signature

Backend signs a claim authorization

Claim Process

Visit Claim Page

Go to /payx/claim on PayX

You can check if you have pending tips before signing in

Sign in with X

Click the "Sign in with X" button to authenticate via OAuth

We only request read access to your profile. No posting permissions.

View Pending Balance

See your total pending tips from all your fans

Pending Balance

$24.50

Connect Wallet & Claim

Connect your wallet and click "Claim" to receive your USDC

USDC will be sent directly to your connected wallet on Arc Network

Wallet Linking

The first time you claim, your wallet is linked to your X handle. This provides:

✓
Automatic future claims
Future tips can be claimed to the same wallet without re-verification
✓
Security
Only your linked wallet can claim tips for your handle

⚠️Choose your wallet carefully! Changing the linked wallet requires re-verification.

Technical Details

Claim Transaction

The claim function on the smart contract:

function claimTips(
    string calldata handle,    // Your X handle
    address wallet,            // Destination wallet
    bytes32 nonce,             // Unique nonce
    bytes calldata signature   // Oracle signature
) external

Signature Verification

The contract verifies that the signature was created by our oracle:

bytes32 messageHash = keccak256(
    abi.encodePacked(handle, wallet, nonce)
);
bytes32 ethSignedHash = messageHash.toEthSignedMessageHash();
address signer = ethSignedHash.recover(signature);
require(signer == oracleSigner, "Invalid signature");

On-Chain Events

Successful claims emit a TipsClaimed event:

event TipsClaimed(
    string indexed handleHash,  // Keccak256 of handle
    string handle,              // "@username"
    address indexed wallet,     // Recipient wallet
    uint256 amount,             // Total claimed
    uint256 timestamp           // Block timestamp
);

Common Questions

How long do tips stay in escrow?

Tips remain in escrow indefinitely until claimed. There's no expiration.

Can I claim partial amounts?

No, each claim withdraws your entire pending balance at once.

What if I change my X handle?

Tips are tied to your X user ID, not your handle. Handle changes don't affect existing tips.

Can someone else claim my tips?

No. Only the verified X account owner (via OAuth) can claim tips for that handle.