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.

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 rangeUnlocks
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

Examplebob.eth · contributor · 90 daysfrom 300 to 612

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