Skip to content
@theblitlabs

Blit Labs

Building the Cloudless-Cloud of Tomorrow

Parity Protocol

Go Version PostgreSQL Docker License

Introduction

Parity Protocol is a cutting-edge distributed computation network that enables secure and verifiable task execution across verified nodes. Built and maintained by Blit Labs, this protocol offers a cloudless architecture that prioritizes security, reliability, and efficient resource utilization.

📚 Read the Complete Documentation

System Architecture

The Parity Protocol ecosystem consists of five core components, each serving a specific purpose in the network:

Core Components

  • Manages secure task execution in isolated Docker environments
  • Provides comprehensive execution metrics and system usage analytics
  • Ensures computational integrity and optimal resource allocation
  • Orchestrates task distribution and validation processes
  • Handles node registration and reputation management
  • Implements real-time communication via webhooks
  • Delivers a seamless interface for task submission and monitoring
  • Provides robust APIs for comprehensive task management
  • Features real-time execution tracking and detailed analytics
  • Implements a custom ERC20 token for network operations
  • Powers protocol economics and staking mechanisms
  • Facilitates automated reward distribution
  • Provides secure token management capabilities
  • Features enterprise-grade authentication system
  • Enables efficient transaction handling

Supporting Tools

Tool Purpose
gologger Advanced structured logging for Go applications
deviceid Robust device identification system
keystore Secure cryptographic key management
go-wallet-sdk Comprehensive Go SDK for blockchain interactions

Getting Started

System Requirements

Before beginning, ensure your system meets these prerequisites:

  • Go: Version 1.22.7 or higher
  • PostgreSQL: Version 14.0 or higher
  • Docker: Latest stable version
  • Make: Latest version
  • Git: Latest version

Installation Guide

1. Repository Setup

mkdir parity-workspace && cd parity-workspace

# Clone core repositories
for repo in server runner client token wallet; do
    git clone https://github.com/theblitlabs/parity-${repo}.git
done

2. Initial Configuration

# Set up token and wallet first
cd parity-token
# Follow README instructions for:
# 1. Token contract deployment
# 2. Parameter configuration
# 3. Initial distribution setup

cd ../parity-wallet
# Follow README instructions for:
# 1. Wallet infrastructure setup
# 2. Authentication configuration
# 3. Token contract integration

# Copy example configs for core components
for component in server runner client; do
    cp parity-${component}/config/config.example.yaml \
       parity-${component}/config/config.yaml
done

3. Component Configuration

Each component requires specific configuration. Follow these steps carefully:

Server Setup
  1. Navigate to parity-server directory
  2. Open config/config.yaml
  3. Configure according to the server documentation
  4. Key focus areas:
    • Database configuration
    • Blockchain connection parameters
    • Network settings
Runner Setup
  1. Navigate to parity-runner directory
  2. Open config/config.yaml
  3. Configure according to the runner documentation
  4. Key focus areas:
    • Docker environment settings
    • Server connection parameters
    • Resource allocation limits
Client Setup
  1. Navigate to parity-client directory
  2. Open config/config.yaml
  3. Configure according to the client documentation
  4. Key focus areas:
    • API configurations
    • Server connection details
    • Client-specific parameters

⚠️ Important Configuration Notes:

  • Verify all placeholder values are replaced with actual configurations
  • Ensure no port conflicts between components
  • Double-check file permissions
  • Use secure values for authentication tokens and keys

4. Launch Services

Run each component in a separate terminal window:

# Terminal 1: Server
cd parity-server
make build
parity-server auth --private-key YOUR_PRIVATE_KEY
parity-server

# Terminal 2: Runner
cd parity-runner
make build
parity-runner auth --private-key YOUR_PRIVATE_KEY
parity-runner stake --amount 10
parity-runner

# Terminal 3: Client
cd parity-client
make build
parity-client

Contributing

We welcome contributions from the community! Here's how to get started:

  1. Find an Issue Browse our repositories for open issues:

  2. Fork & Clone Fork the relevant repository and create your feature branch:

    git checkout -b feature/amazing-feature
  3. Set Up Development Environment

    make install-hooks
  4. Submit Your Work

    • Follow Conventional Commits guidelines
    • Include comprehensive documentation updates
    • Provide clear descriptions of changes
    • Reference the issue being addressed

📝 For detailed information about each component, please refer to their respective documentation.

Popular repositories Loading

  1. parity-website parity-website Public

    Frontend for Parity Protocol

    TypeScript 1 1

  2. parity-server parity-server Public

    A decentralized compute network orchestrating trustless task execution with token incentives

    Go 1 4

  3. deviceid deviceid Public

    A Go package for generating and managing unique device identifiers

    Go 1 1

  4. parity-runner parity-runner Public

    Runner implementation for Parity Protocol's decentralized compute network

    Go 4

  5. parity-token parity-token Public

    ERC‑20 token implementation for Parity Token

    Solidity 1

  6. parity-wallet parity-wallet Public

    Upgradeable smart contract wallet implementation for managing token deposits, transfers, and withdrawals

    Solidity

Repositories

Showing 10 of 12 repositories
  • parity-runner Public

    Runner implementation for Parity Protocol's decentralized compute network

    theblitlabs/parity-runner’s past year of commit activity
    Go 0 MIT 4 5 (1 issue needs help) 2 Updated Apr 8, 2025
  • parity-server Public

    A decentralized compute network orchestrating trustless task execution with token incentives

    theblitlabs/parity-server’s past year of commit activity
    Go 1 MIT 4 9 (1 issue needs help) 0 Updated Apr 7, 2025
  • parity-client Public

    A high-performance client implementation for the Parity Protocol - a decentralized compute network enabling distributed task execution with blockchain-based incentives. Built in Go with Docker integration.

    theblitlabs/parity-client’s past year of commit activity
    Go 0 MIT 0 1 0 Updated Apr 7, 2025
  • parity-token Public

    ERC‑20 token implementation for Parity Token

    theblitlabs/parity-token’s past year of commit activity
    Solidity 0 1 0 0 Updated Apr 5, 2025
  • parity-wallet Public

    Upgradeable smart contract wallet implementation for managing token deposits, transfers, and withdrawals

    theblitlabs/parity-wallet’s past year of commit activity
    Solidity 0 0 1 0 Updated Apr 5, 2025
  • .github Public
    theblitlabs/.github’s past year of commit activity
    0 0 0 0 Updated Apr 3, 2025
  • theblitlabs/parity-protocol’s past year of commit activity
    0 0 0 0 Updated Apr 3, 2025
  • parity-website Public

    Frontend for Parity Protocol

    theblitlabs/parity-website’s past year of commit activity
    TypeScript 1 1 1 0 Updated Mar 30, 2025
  • gologger Public

    A flexible, feature-rich logging package for Go applications built on top of zerolog

    theblitlabs/gologger’s past year of commit activity
    Go 0 0 0 0 Updated Mar 21, 2025
  • deviceid Public

    A Go package for generating and managing unique device identifiers

    theblitlabs/deviceid’s past year of commit activity
    Go 1 1 0 0 Updated Mar 18, 2025

Top languages

Loading…

Most used topics

Loading…