⛓️ BAZINGA Blockchain & P2P Network

Join the decentralized knowledge network

What is the BAZINGA Network?

BAZINGA is a knowledge blockchain, not a cryptocurrency. Instead of mining coins, nodes contribute understanding and earn trust through Proof-of-Boundary (PoB) consensus.

⚠️ Important: This is NOT a cryptocurrency. There are no tokens, no ICO, no financial speculation. The blockchain records knowledge attestations and tracks trust scores based on the quality of contributions.

Key Concepts

Two Ways to Join the Network

Option 1: CLI Only (Recommended)

The simplest way - just run the command and you're in:

# Join the network (auto-discovers peers)
bazinga --join

# Or connect to a specific bootstrap node
bazinga --join node.example.com:8468
ℹ️ What happens:
  1. Generates your unique node ID
  2. Connects to bootstrap nodes (including HuggingFace Space)
  3. Discovers other peers via Kademlia DHT
  4. Starts with τ = 0.5 trust score

Option 2: Register via HuggingFace Space

You can also register through the web dashboard:

  1. Visit huggingface.co/spaces/bitsabhi/bazinga
  2. Enter your node name in the "Register Node" section
  3. Get your node ID and use it with CLI
# After registering on HF Space
bazinga --join --node-id YOUR_NODE_ID
✓ Both methods work! The CLI method is simpler. HF Space registration is useful if you want a memorable node name or want to see the web dashboard.

Complete Example: Joining and Participating

# Step 1: Install BAZINGA
pip install bazinga-indeed

# Step 2: Check your system
bazinga --check

# Step 3: Join the P2P network
bazinga --join

# Step 4: View your wallet/identity
bazinga --wallet

# Step 5: Generate a Proof-of-Boundary
bazinga --proof

# Step 6: Mine a block (after generating valid PoB)
bazinga --mine

# Step 7: Attest knowledge to the blockchain
bazinga --attest "Consciousness emerges at φ⁴ boundary"

# Step 8: View blockchain status
bazinga --chain

# Step 9: View connected peers
bazinga --peers

# Step 10: Sync knowledge with network
bazinga --sync

Network Architecture

Your Node
Bootstrap Nodes
DHT (Kademlia)
Other Peers

Bootstrap Nodes

When you run bazinga --join, BAZINGA automatically connects to:

How Peer Discovery Works

  1. Node generates unique ID from public key
  2. Connects to bootstrap nodes
  3. Bootstrap nodes return their known peers
  4. Kademlia DHT builds routing table
  5. Trust scores determine query routing priority

Trust Scores and φ Bonus

Your trust score (τ) determines your influence in the network:

Trust Level Score Range Privileges
New Node τ = 0.5 Can query, limited attestation
Established τ = 0.6-0.8 Full participation, can validate
Validator τ ≥ φ/2 (0.809) Can participate in triadic consensus
Oracle τ ≥ 0.95 Trusted for complex queries

φ Trust Bonus (1.618x)

Run a local LLM (like Ollama) and get a φ = 1.618x trust multiplier:

# Install Ollama + llama3
bazinga --bootstrap-local

# Check local model status
bazinga --local-status

# Now join - your trust is multiplied by φ!
bazinga --join
# Output: "Local model detected... You will receive the phi trust bonus (1.618x)!"
Why φ bonus? Local models can't be "spoofed" - they require actual computation on your hardware. This makes your proofs more trustworthy. "You can buy cloud API calls. You cannot fake local inference."

Proof-of-Boundary (PoB) Consensus

PoB is 70 BILLION times more efficient than Bitcoin's Proof-of-Work:

How It Works

  1. Generate Alpha (α) signature at time t₁
  2. Search for boundary in φ-steps (1.618ms each)
  3. Generate Omega (ω) signature at time t₂
  4. Valid if ratio ≈ φ⁴ = 6.854...
# Generate a Proof-of-Boundary
bazinga --proof

# Output:
# Proof-of-Boundary Generated
# Alpha: d8f3a2c1...
# Omega: 7b2e5f98...
# Ratio: 6.8541 (target: 6.8541)
# Valid: YES ✓

Triadic Consensus

Blocks require 3 valid PoB proofs from 3 different nodes (triadic group):

Node A
PoB ✓
Node B
PoB ✓
Node C
PoB ✓



Block Validated

Knowledge Attestation

Record your understanding permanently on the blockchain:

# Attest a piece of knowledge
bazinga --attest "The fine structure constant α = 1/137"

# Attest with email receipt
bazinga --attest "My discovery about consciousness" --email you@example.com

# Verify an attestation
bazinga --verify ATTESTATION_ID

# View blockchain
bazinga --chain
✓ Permanent Record: Once attested, knowledge is immutably recorded with your node ID, timestamp, and PoB proof. It cannot be altered or deleted.

Federated Learning

Nodes learn collectively without sharing raw data:

How It Works

  1. Each node trains locally on their own data
  2. Nodes share gradients (learning signals), not data
  3. Gradients are aggregated with φ-weighting
  4. All nodes update their models
  5. Network converges to shared understanding
# Index your local documents
bazinga --index ~/Documents

# Publish your topics to the network
bazinga --publish

# Sync knowledge with network
bazinga --sync
ℹ️ Privacy: Your actual documents never leave your machine. Only topic keywords and encrypted gradient updates are shared.

HuggingFace Space API

The HF Space provides REST endpoints for programmatic access:

Endpoint Method Description
/api/register POST Register a new node
/api/nodes GET List all registered nodes
/api/verify POST Verify a node ID
/api/heartbeat POST Update node last_seen
# Example: Register via API
curl -X POST https://bitsabhi515-bazinga-mesh.hf.space/api/register \
  -H "Content-Type: application/json" \
  -d '{"node_name": "my-node", "port": 8468}'

# Example: List nodes
curl https://bitsabhi515-bazinga-mesh.hf.space/api/nodes

Quick Command Reference

Command Description
bazinga --join Join the P2P network
bazinga --peers Show connected peers
bazinga --sync Sync knowledge with network
bazinga --chain Show blockchain status
bazinga --wallet Show your identity/wallet
bazinga --mine Mine a block (requires valid PoB)
bazinga --proof Generate Proof-of-Boundary
bazinga --attest "..." Attest knowledge to blockchain
bazinga --verify ID Verify an attestation
bazinga --trust Show your trust score
bazinga --publish Publish topics to network
bazinga --bootstrap-local Install Ollama for φ bonus

Ready to Join?

pip install bazinga-indeed && bazinga --join

"You can buy hashpower. You can buy stake.
You CANNOT BUY understanding."