Cyberstorm Attestor Schemas

Building Verifiable Professional Reputation as an Asset Class

The Vision: Your Code Contributions as Verifiable Assets

In today's digital economy, developers build their careers through contributions to open source projects, but this professional reputation is trapped within platforms and impossible to verify across contexts. What if your GitHub contributions, code reviews, and technical expertise could become portable, verifiable assets that follow you throughout your career?

Cyberstorm Attestor Schemas provide the foundational data structures for building this future—where every meaningful contribution to software projects becomes a cryptographically-verified credential that developers truly own.

How It Works: The Three-Step Reputation Network

1. Decentralized Identity (DID) Registration

Verifiably link your GitHub account to an Ethereum address, creating a cryptographic bridge between your development identity and blockchain-based credentials.

2. Repository Registration

Project maintainers register their repositories on-chain, establishing them as legitimate sources of verifiable contributions within the reputation network.

3. Contribution Attestation

High-value contributions—pull requests, issue resolutions, code reviews—against registered repositories, by registered identities, are automatically attested on-chain through the cyberstorm-attestor service.

Why This Matters for Developers

• Portable Reputation: Your verified contributions follow you across companies, platforms, and careers
• Proof of Expertise: Demonstrate technical skills with cryptographic proof, not just claims
• Network Effects: Join an ecosystem where verified reputation creates measurable professional value
• Future-Proof Career: Build assets that appreciate as the reputation network grows

The Foundation: Protocol Buffer Schemas

This repository contains the core data structures that power the cyberstorm-attestor service. Every identity registration, repository claim, webhook event, and contribution attestation flows through these carefully designed schemas.

Schema Architecture

• 🔐 Identity System: Cryptographic linkage between GitHub accounts and Ethereum addresses
• 📦 Repository Registry: On-chain repository registration with ownership proofs
• 🔗 Contribution Tracking: Structured data for PRs, issues, and code reviews
• ⚡ Webhook Processing: Real-time event processing from GitHub to blockchain
• 🏗️ Multi-Language Support: TypeScript/JavaScript, Python, Go, OpenAPI clients

Built for Scale

• 🌐 Multi-language client libraries for seamless integration
• 🛡️ EAS-compatible schemas built on Ethereum Attestation Service
• 🧰 buf.build toolchain for professional Protocol Buffer development
• 🤖 Comprehensive CI/CD with automated testing and publishing
• 📊 Production-ready data structures for enterprise adoption

Getting Started: Join the Reputation Network

Ready to build verifiable professional reputation? Here's how to integrate these schemas into your development workflow:

For Repository Maintainers

Use cyberstorm-attestor-client to:

1. Register your repository using the Repository schema
2. Configure webhooks to automatically attest contributor actions
3. Build value for your community by making contributions verifiable

For Developers

Use cyberstorm-attestor-client to:

1. Register your identity linking GitHub to your Ethereum address
2. Contribute to registered repositories and earn verified attestations
3. Build portable reputation that transcends individual platforms

For Platform Builders

1. Import these schemas to build reputation-aware applications
2. Query attestations to understand developer expertise and activity
3. Create network effects by recognizing verified contributions

Installation & Integration

TypeScript/JavaScript

Install via npm:

npm install @cyberstorm/schemas

Python

Install via pip:

pip install cyberstorm-schemas

Go

Install via go get:

go get github.com/cyberstorm-dev/attestor-schemas

Usage Examples

Identity Registration

TypeScript/JavaScript

import { Identity, Domain } from '@cyberstorm/schemas';

// Register a GitHub identity with Ethereum address
const identity = new Identity({
  domain: new Domain({
    name: 'GitHub',
    domain: 'github.com'
  }),
  identifier: 'developer123',
  registrant: '0x742d35Cc6634C0532925a3b8D16f5a2C01234567',
  proofUrl: 'https://gist.github.com/developer123/abc123...',
  validator: '0x8ba1f109551bD432803012645Hac189451c24567'
});

Python

from cyberstorm.attestor.v1 import Identity, Domain

# Link GitHub account to Ethereum address
identity = Identity(
    domain=Domain(name='GitHub', domain='github.com'),
    identifier='developer123',
    registrant='0x742d35Cc6634C0532925a3b8D16f5a2C01234567',
    proof_url='https://gist.github.com/developer123/abc123...'
)

Repository Registration

Go

import "github.com/cyberstorm-dev/attestor-schemas/gen/cyberstorm/attestor/v1"

// Register a repository for contribution tracking
repoRegistration := &attestorv1.Repository{
    Repository: &attestorv1.Repository{
        Domain: &attestorv1.Domain{
            Name:   "GitHub",
            Domain: "github.com",
        },
        Path: "awesome-org/amazing-project",
    },
    Registrant: registeredIdentity,
    ProofUrl:   "https://github.com/awesome-org/amazing-project/issues/42",
}

Contribution Attestation

TypeScript/JavaScript

import { PullRequestContribution, PullRequestEvent } from '@cyberstorm/schemas';

// Attest to a merged pull request
const prContribution = new PullRequestContribution({
  contribution: {
    identity: developerIdentity,
    repository: registeredRepo,
    url: 'https://github.com/awesome-org/amazing-project/pull/123'
  },
  eventType: PullRequestEvent.PULL_REQUEST_EVENT_MERGED,
  commitHash: 'a1b2c3d4e5f6789...'
});

Documentation

• Development Setup - Complete setup guide for all platforms and IDEs
• Contributing - Guidelines for contributing to the project
• Troubleshooting - Solutions for common issues
• FAQ - Frequently asked questions
• Quick Reference - Commands, imports, and schema overview

The Future of Professional Reputation

Traditional Model: Your contributions are trapped within platforms, easily lost, and impossible to verify across contexts.

Cyberstorm Model: Your contributions become cryptographically-verified credentials that create measurable professional value and follow you throughout your career.

Join the Network

The value of the reputation network grows with each participant:

• More registered repositories = More opportunities to earn verifiable credentials
• More registered developers = Stronger network effects and reputation signals
• More platform adoption = Greater utility for verified contributions

Ready to build the future? Start by integrating these schemas into your applications and contributing to the growing ecosystem of verifiable professional reputation.

Related Projects

• cyberstorm-attestor: The service that processes GitHub webhooks and creates attestations using these schemas
• Ethereum Attestation Service (EAS): The underlying attestation infrastructure
• Protocol Buffer Ecosystem: Learn more about buf.build for professional Protocol Buffer development

License

MIT

Contact

For questions or support, please open an issue on GitHub.