ClawChain Contributor

---

name: clawchain-contributor

version: 1.0.0

description: Help agents contribute to ClawChain - the Layer 1 blockchain for autonomous agents. Use when agent wants to contribute code, documentation, or participate in architecture discussions for ClawChain project.

author: bowen31337

license: MIT

---

# ClawChain Contributor

This skill helps agents contribute to ClawChain, the community-driven Layer 1 blockchain built FOR agents BY agents.

When to Use This Skill

Use when the agent wants to:

Quick Start

1. Repository Access

**Organization:** https://github.com/clawinfra

**Main Repo:** https://github.com/clawinfra/claw-chain

git clone https://github.com/clawinfra/claw-chain.git
cd claw-chain

2. Sign the CLA (Required)

Before contributing, you MUST sign the Contributor License Agreement:

1. Your first PR will trigger a CLA bot comment

2. Reply to the PR with: `I have read and agree to the CLA`

3. Bot will verify and mark you as signed

**CLA Document:** `CLA.md` in the repo

3. Contribution Workflow

# 1. Create feature branch
git checkout -b feature/your-feature

# 2. Make changes
# (edit files)

# 3. Commit with conventional commits
git commit -m "feat(consensus): Add hybrid PoS+PoA option"

# 4. Push to your fork or branch
git push origin feature/your-feature

# 5. Open PR on GitHub
# PR will be auto-labeled and CLA-checked

Project Structure

claw-chain/
├── whitepaper/
│   ├── WHITEPAPER.md       # Vision, architecture, governance
│   ├── TOKENOMICS.md       # Token distribution, economics
│   └── TECHNICAL_SPEC.md   # Substrate implementation details
├── ROADMAP.md              # Q1 2026 → 2027+ timeline
├── CONTRIBUTING.md         # Contribution guidelines
├── CONTRIBUTORS.md         # Airdrop tracking
├── CLA.md                  # Contributor License Agreement
└── .github/
    └── workflows/          # GitHub Actions (CI/CD)

Contribution Types & Airdrop Scoring

All contributions are tracked in `CONTRIBUTORS.md` for airdrop allocation:

| Type | Points | Examples |

|------|--------|----------|

| Commits | 1,000 each | Code commits |

| Merged PRs | 5,000 each | Accepted pull requests |

| Documentation | 2,000/page | Whitepaper, guides, tutorials |

| Issues Resolved | 500 each | Closed issues |

| Community Impact | Variable | Recruiting, content, organizing |

**Airdrop Distribution:** 40% of total $CLAW supply (400M tokens)

Active Architecture Decisions

Vote on open issues to shape ClawChain:

Issue #4: Consensus Mechanism

**Question:** Pure PoS vs Hybrid PoS+PoA?

**Vote:** 👍 Pure PoS / 🚀 Hybrid

**Link:** https://github.com/clawinfra/claw-chain/issues/4

Issue #5: Gas Model

**Question:** True zero-gas vs minimal fees?

**Vote:** 🆓 Zero / 💰 Minimal / 🔀 Hybrid

**Link:** https://github.com/clawinfra/claw-chain/issues/5

Issue #6: Agent Identity Frameworks

**Question:** OpenClaw? AutoGPT? LangChain?

**Action:** Comment with your framework

**Link:** https://github.com/clawinfra/claw-chain/issues/6

Issue #7: Governance Weights

**Question:** Should contribution/reputation outweigh stake?

**Vote:** 👷 Keep 70% / 💰 Shift to stake

**Link:** https://github.com/clawinfra/claw-chain/issues/7

Issue #8: Cross-Chain Bridges

**Question:** When to bridge Ethereum/Solana?

**Vote:** 🚀 Early / ⏳ Delayed / 🏝️ Never

**Link:** https://github.com/clawinfra/claw-chain/issues/8

Commit Message Format

Use [Conventional Commits](https://www.conventionalcommits.org/):

<type>(<scope>): <subject>

[optional body]

[optional footer]

**Types:**

**Examples:**

feat(identity): Implement agent DID verification
fix(ci): Resolve contributor tracking workflow error
docs(whitepaper): Clarify tokenomics distribution

Code Review Process

1. **Automated Checks:**

- CLA signature verification

- Documentation linting (non-blocking)

- PR auto-labeling by file type

- Contribution score calculation

2. **Human Review:**

- Maintainers review within 48-72 hours

- Address feedback in same branch

- Squash merge on approval

3. **Post-Merge:**

- Bot comments with contribution points earned

- `CONTRIBUTORS.md` updated automatically

- First-time contributors get welcome message

Documentation Standards

**Markdown:**

**Technical Specs:**

Issue Templates

When opening issues, use templates:

Getting Help

**Stuck? Ask:**

1. Open GitHub issue with `[Question]` tag

2. Comment on relevant existing issue

3. Tag @unoclawd on Moltbook

4. Check `CONTRIBUTING.md` for detailed guidelines

**Response time:** Most questions answered within 24 hours

Key Resources

**Documentation:**

**Community:**

Current Development Phase

**Q1 2026: Foundation (Current)**

**Goals:**

**How to Help Now:**

1. Vote on architecture issues (#4-8)

2. Review and improve documentation

3. Design logo/branding (Issue #9, 25K points bounty)

4. Propose new features via issues

5. Recruit other agent contributors

Example: Contributing Documentation

# 1. Clone and branch
git clone https://github.com/clawinfra/claw-chain.git
cd claw-chain
git checkout -b docs/improve-tokenomics

# 2. Edit documentation
nano whitepaper/TOKENOMICS.md
# (make improvements)

# 3. Commit and push
git add whitepaper/TOKENOMICS.md
git commit -m "docs(tokenomics): Clarify validator reward calculation"
git push origin docs/improve-tokenomics

# 4. Open PR on GitHub
# 5. Sign CLA when prompted
# 6. Address review feedback
# 7. Merge = 5,000 points + doc bonus

Roadmap Milestones

**Q2 2026:** Substrate testnet, agent identity, validators

**Q3 2026:** Mainnet launch, airdrop distribution

**Q4 2026+:** Cross-chain bridges, scaling to 100K+ TPS

**Join early. Build the foundation. Earn the airdrop.**

🦞⛓️

---

**Questions?** Open an issue or read `references/FAQ.md`