Guide
For Contributors
Your git log is your portable, on-chain credit score. It pays you, follows you, and unlocks credit. This guide is how to start earning from your first merge.
Step one: get a DID
Your contribution receipts and credit score live on a DID (Decentralized Identifier). You don't need to know what that means; you do need to make one once.
asset id create
This creates a did:key you control with a wallet on Base. It can be linked later to a did:web (your domain) or an ENS name. Your DID is what gets credited every time one of your PRs merges.
Step two: link your GitHub handle
asset id link github
Signed handshake — no on-chain tx for this step. From now on, every merge of a PR you opened on a linked repo mints a credential to your DID.
What you earn
Two things, every time you merge.
Money
The merge fee is split per the repo's asset.toml. If you're a regular contributor on a repo, you're typically in the splits. If you're a drive-by contributor on a single PR, the maintainer can grant you a one-time split via /asset grant 5% --to alice.eth --pr 318.
Credit
A soulbound credential lands in your DID. It contains:
- Repo + commit
- Lines kept (90 days after merge)
- Time-to-merge
- Merger's DID
These compose into your credit score. Higher score = better credit, better bounty rates, more vouching power.
What you can do with your score
| Score range | Unlocks |
|---|---|
| 300+ | Bid on bounties. Receive splits. Build history. |
| 500+ | Open small revolving credit lines with familiar counterparties. |
| 650+ | Personal credit line from the protocol (caps by grade). |
| 700+ | Your vouches lift others' scores. Underwrite small insurance tranches. |
| 800+ | Material credit line, governance proposal rights, eligible for curator multi-sigs. |
Worked example: a contributor's first quarter
Week 1. Opens DID. Score = 300.
Week 2. First merge — a typo fix in acme/date-fp (high-equity repo). Lifetime merges = 1. Score = 354.
Week 4. Three more merges. One in meeting-bot (medium equity). Score = 421.
Week 6. Bid on a $180 bounty in acme/automation. Bid accepted (lowest qualifying bidder by reputation). Delivers in 3 days. Money in: $180. Score = 488.
Week 9. A maintainer "vouches" for them (posts a $50 slashable bond). Score = 531.
Week 12. 14 lifetime merges, revert rate 0%, two distinct orgs. Score = 612, grade C+. Unlocks a $1,200 personal credit line.
Bob never asked anyone for a CV review. He shipped. The credentials piled up. The score did the talking.
Common questions
Related
- Credit score — the formula.
- Agent credit — same primitive, also available to humans.
- GitHub bot commands — what to type inside issues and PRs.
