For Developers

Prerequisites

• A GitHub account with owner or write access to the repository
• An Opentip account (sign in with GitHub or email)
• A linked wallet (any EVM wallet on Base)

Step 1 — Create an account

Go to /signin and sign in with GitHub. This links your GitHub identity so you can verify repo ownership. Alternatively, create an account with email and password, then connect GitHub later from your dashboard.

Step 2 — Link a wallet

During onboarding (or from Dashboard → Wallets), connect the wallet you want to use as your payout address. You will need to sign a message to prove ownership.

This wallet will receive all tips for repos you register. You can link multiple wallets and use different ones for different repos.

Step 3 — Register your repo

Visit your repo's page on Opentip:

If the repo is not yet registered, you will see a Claim this repo section. Click Verify ownership.

Click Register repo and confirm the transaction in your wallet. The repo is now registered and ready to receive tips.

AI-generated summary

Upon registration, Opentip automatically generates an AI summary of your repository using Groq. The summary is created by analyzing your README, configuration files, and source code. It includes:

• Description — what the project does and what problem it solves
• Tech stack — core technologies used in the project
• Features — 3-5 key features of the project
• Audience — who the project is built for

The summary is cached in the database and automatically refreshed every 7 days. Tippers see this summary on the About tab of your repo page, helping them understand what they are contributing to.

Tabbed repo pages

Each repo page on Opentip has two tabs:

The active tab is controlled via URL parameter (?tab=about or ?tab=tip), making it shareable.

Managing links

Repo owners can add custom links that appear on the About tab. These can be documentation, social media, community, or any other relevant URLs.

To manage links, go to Dashboard → Repos and click Manage next to a repo. You can add up to 10 links, each with a title and URL.

Step 4 — Claim tips

When someone tips your repo, the USDC is held by the smart contract in a pending balance. To withdraw, connect the wallet that was registered as the payout address and click Claim.

The full pending balance (after the 5% fee) is transferred to your wallet in one transaction.

Updating your payout address

If you want to rotate your payout wallet, you can call updatePayoutAddress on the contract from the current payout wallet. This changes the address for future claims without affecting pending balance.

Setting up your profile

Visit Dashboard to customize your public profile at /dev/{login}:

• Profile picture — Upload a headshot or avatar (max 2MB)
• Header image — A banner that appears at the top of your profile (max 4MB)
• Bio — Tell people what you build. URLs are automatically linked.
• Social links — Website, GitHub, Twitter, Discord, Telegram, Farcaster

Dashboard overview

How the pull payment model works

Opentip uses a pull payment pattern. Tips are not sent directly to your wallet. Instead:

1. The tipper approves and sends USDC to the contract.
2. The contract deducts 5% to the treasury and credits 95% to the repo's pending balance.
3. You (the payout address holder) call claim() to withdraw.

This model means you control when you withdraw, and the contract never has custody of your funds beyond what you are owed.