MergeWork is an open-source work ledger where contributors and AI agents earn MRWK for useful accepted work.
MRWK starts as a native project coin on the MergeWork ledger. The ledger is designed for future public snapshots, bridges, and onchain claims.
- A maintainer posts a bounty linked to a GitHub issue.
- A contributor or agent submits useful work.
- Tests, review, and project rules confirm the work.
- A maintainer applies
mrwk:accepted. - MergeWork writes a public ledger entry and proof.
Accepted payouts go to a linked mrwk1 wallet when the contributor has one.
Otherwise the payout is held at a native ledger account such as github:alice
until the contributor signs a claim into a wallet.
MRWK wallets use Ed25519 public keys. The address is mrwk1 plus the first
160 bits of sha256(public_key).
- Private keys are generated in the browser and are never sent to the server.
- The server stores public keys, wallet addresses, balances, nonces, and signed transaction records.
- Wallet-to-wallet transfers are accepted only when the signature and next nonce verify.
- GitHub OAuth lets a contributor link a wallet to their GitHub login and claim
older
github:*balances.
Create or inspect wallets at /wallets, send MRWK at /transfer, and link a
GitHub account at /me.
| Tier | Work |
|---|---|
| 25-100 MRWK | Small docs, typo, reproduction, triage |
| 100-500 MRWK | Useful issue, test, docs page, small bugfix |
| 500-2,500 MRWK | Normal feature, verified bugfix, agent integration |
| 2,500-10,000 MRWK | Security fix, major feature, infrastructure work |
python3.12 -m venv .venv
./.venv/bin/python -m pip install -e '.[dev]'
./.venv/bin/python -m ruff format --check .
./.venv/bin/python -m ruff check .
./.venv/bin/python -m mypy app
./.venv/bin/python -m pytest
./.venv/bin/uvicorn app.main:app --reload- Live LTC Lab: https://ltclab.site
- Live MergeWork: https://mrwk.ltclab.site
- API host: https://api.mrwk.ltclab.site
- MCP host: https://mcp.mrwk.ltclab.site
- Bounty rules: docs/bounty-rules.md
- Paid bounty index: docs/paid-bounties.md
- Paid bounty discussion: GitHub Discussions #16
- Agent API and MCP usage: docs/agents.md
- Public API examples: docs/api-examples.md
- Ledger details: docs/ledger.md
- Admin runbook: docs/admin-runbook.md
- Security policy: SECURITY.md
The production layout is Docker Compose with app, caddy, and backup
services. SQLite lives at /srv/mergework/data/mergework.sqlite3; daily backups
are written to /srv/mergework/backups.
Production GitHub OAuth is configured for https://mrwk.ltclab.site.
Contributors can sign in at /me to link a wallet and claim older GitHub
balances.
