◆ CHAINQUERY ◆

Advanced Bitcoin Blockchain Data Analysis & Query Platform

Scientific methodology for Blockchain research, cryptographic analysis, and digital asset exploration.

⚡ Overview

ChainQuery is a comprehensive, scientific-grade platform for querying, analyzing, and processing Bitcoin and cryptocurrency blockchain data. Leveraging advanced cryptographic analysis and distributed computing, ChainQuery provides researchers, developers, and security professionals with powerful tools for blockchain exploration, transaction analysis, and cryptographic security research.

Feature	Description
🔐 Cryptocurrency Analysis	Deep forensic analysis of blockchain transactions, addresses, and cryptographic signatures with military-grade precision.
🔍 Wallet Intelligence	Advanced Bitcoin Wallet tracking and analysis for security research and recovery methodologies.
🔑 Private Key Research	Cryptanalytic research on Private Key generation vulnerabilities and recovery techniques.
⛓️ Blockchain Parsing	Real-time synchronization and parsing of blockchain data with structured output formats.
📊 RPC Interface	User-friendly JSON-RPC interface for seamless integration with custom analysis applications and scripts.
🚀 High-Performance Processing	Distributed processing architecture capable of analyzing millions of transactions with sub-second latency.

📋 Installation & Setup

Prerequisites

Git version control system (any recent version)
Go 1.11+ (for building from source)
MySQL 8.0+ or compatible database
Bitcoin Core node (optional, for full node integration)
4GB+ RAM, 50GB+ SSD storage recommended

⚠️ Important: ChainQuery requires adequate system resources for optimal performance. Ensure your system meets the minimum specifications before deployment.

Installation by Platform

🐧 Linux / Ubuntu

git clone https://github.com/zoeir/chainquery.git
cd chainquery
./build.sh
make install

🪟 Windows (PowerShell)

git clone https://github.com/zoeir/chainquery.git
cd chainquery
go build -o chainquery.exe
.\chainquery.exe

🍎 macOS

brew install wget go
git clone https://github.com/zoeir/chainquery.git
cd chainquery
chmod +x build.sh
./build.sh

☁️ Google Colab

!apt-get update
!apt-get install -y golang-go
!git clone https://github.com/zoeir/chainquery.git
%cd chainquery
!go build

Quick Start Commands

# Initialize database schema
./chainquery migrate --up

# Start ChainQuery daemon
./chainquery start

# Enable debug logging
./chainquery start --debug

# Query blockchain height
./chainquery-cli query block-height

# Retrieve transaction details
./chainquery-cli query tx [TXID]

🚀 Programming Language Integration

Python Implementation

#!/usr/bin/env python3
import requests
import json

# Connect to ChainQuery RPC endpoint
rpc_url = "http://localhost:8080/rpc"
headers = {"Content-Type": "application/json"}

# Query blockchain data
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getblockcount",
    "params": []
}

response = requests.post(rpc_url, json=payload, headers=headers)
result = response.json()
print(f"Current block height: {result['result']}")

JavaScript / Node.js Implementation

const axios = require('axios');

const rpcCall = async (method, params = []) => {
    try {
        const response = await axios.post('http://localhost:8080/rpc', {
            jsonrpc: '2.0',
            id: 1,
            method: method,
            params: params
        });
        return response.data.result;
    } catch (error) {
        console.error('RPC Error:', error);
    }
};

(async () => {
    const blockHeight = await rpcCall('getblockcount');
    console.log(`Block Height: ${blockHeight}`);
})();

Go Implementation

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

type JSONRPCRequest struct {
    JSONRPC string        `json:"jsonrpc"`
    Method  string        `json:"method"`
    Params  []interface{} `json:"params"`
    ID      int           `json:"id"`
}

func main() {
    req := JSONRPCRequest{
        JSONRPC: "2.0",
        Method:  "getblockcount",
        Params:  []interface{}{},
        ID:      1,
    }

    body, _ := json.Marshal(req)
    resp, _ := http.Post("http://localhost:8080/rpc", "application/json", bytes.NewBuffer(body))
    defer resp.Body.Close()
}

PHP Implementation

<?php

$rpcURL = "http://localhost:8080/rpc";
$rpcRequest = array(
    "jsonrpc" => "2.0",
    "method" => "getblockcount",
    "params" => array(),
    "id" => 1
);

$options = array(
    'http' => array(
        'method' => 'POST',
        'header' => 'Content-Type: application/json',
        'content' => json_encode($rpcRequest)
    )
);

$context = stream_context_create($options);
$result = file_get_contents($rpcURL, false, $context);
$response = json_decode($result, true);
echo "Block Height: " . $response['result'];
?>

Java Implementation

import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import org.json.JSONObject;

public class ChainQueryClient {
    public static void main(String[] args) throws Exception {
        URL url = new URL("http://localhost:8080/rpc");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Content-Type", "application/json");

        JSONObject request = new JSONObject();
        request.put("jsonrpc", "2.0");
        request.put("method", "getblockcount");
        request.put("params", new org.json.JSONArray());
        request.put("id", 1);

        conn.setDoOutput(true);
        conn.getOutputStream().write(request.toString().getBytes(StandardCharsets.UTF_8));
    }
}

📚 Core Libraries & Dependencies

ChainQuery leverages specialized cryptographic and blockchain libraries for robust functionality:

Library	Description
🔗 go-ethereum/go	Ethereum client library providing low-level blockchain interaction, smart contract parsing, and transaction decoding. Essential for cross-chain analysis.
🔐 btcsuite/btcd	Bitcoin Core daemon implementation in Go. Provides complete Bitcoin protocol implementation, cryptographic functions, and blockchain parsing utilities.
📊 go-sql-driver/mysql	MySQL database driver for Go. Enables persistent storage and efficient querying of blockchain data with ACID transaction support.
⚡ gorilla/mux	HTTP router and multiplexer for Go. Provides RESTful API endpoint routing with middleware support for authentication and rate limiting.
🔑 secp256k1	Elliptic curve cryptography library implementing secp256k1 standard. Critical for private key derivation and signature verification.
🌐 websocket	WebSocket implementation for real-time blockchain data streaming, enabling live transaction notifications and event subscriptions.
🛡️ golang.org/x/crypto	Extended cryptographic library. Provides additional cryptographic primitives, hash functions, and secure random number generation.
📝 gorm/gorm	Object-relational mapping (ORM) library for Go. Simplifies database schema management and provides query builder functionality.
⚙️ viper	Configuration management library. Supports YAML, TOML, JSON configuration file formats with environment variable overrides.
📦 protobuf	Protocol Buffers serialization. Efficient binary data serialization for inter-process communication and data persistence.
🔍 logrus	Structured logging library. Provides comprehensive logging with multiple output levels, hooks, and formatters for debugging and monitoring.
✅ testify	Testing assertion library. Provides extended testing utilities for unit and integration testing with clear assertion syntax.

🎯 Key Features & Capabilities

1. Advanced Blockchain Parsing

Real-time synchronization of blockchain data from genesis block to current height
Atomic transaction processing with rollback support for forks
Support for SegWit, P2PKH, P2SH, and Taproot address formats
OP_RETURN data extraction and decoding

2. Wallet Analysis Tools

Comprehensive address clustering algorithms
Wallet fingerprinting using transaction patterns
Balance tracking and UTXO management
Transaction history reconstruction

3. Cryptographic Research Infrastructure

Private key vulnerability analysis framework
ECDSA signature verification and nonce analysis
Entropy weakness detection algorithms
Implementation of ring signature cryptanalysis

4. Data Query & Export

Flexible JSON-RPC API interface
SQL database queries for custom analysis
CSV, JSON, and Protocol Buffer export formats
Time-series data aggregation and analytics

5. Performance Optimization

Distributed parallel processing architecture
Intelligent caching mechanisms
Database query optimization with indexing
Horizontal scaling support

🔒 Security & Privacy

✓ Security First: ChainQuery implements military-grade encryption for all sensitive operations. No private keys are stored or transmitted outside the secure enclave.

Security Features

🔐 Feature	📋 Description	✓ Status
TLS/SSL Encryption	End-to-end encryption for all network communications	ENABLED
Authentication	Multi-factor authentication for API access	ENABLED
Rate Limiting	DDoS protection via connection throttling	ENABLED
Audit Logging	Comprehensive security event logging	ENABLED
Input Validation	Strict validation of all input parameters	ENABLED

⚠️ Educational Use: This tool is designed for cryptographic research and security analysis. Unauthorized access to cryptocurrency wallets is illegal. Always use responsibly and ethically.

🌐 API Examples

Query Transaction Details

curl -X POST http://localhost:8080/rpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "gettransaction",
    "params": ["TRANSACTION_ID"]
  }'

Retrieve Address Balance

curl -X POST http://localhost:8080/rpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getaddressbalance",
    "params": ["1A1z7agoat4QLB3jDtdHZJbArBk5cVKDHx"]
  }'

Query UTXO Set

curl -X POST http://localhost:8080/rpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getutxos",
    "params": ["ADDRESS", 0, 100]
  }'

📖 Documentation & Resources

Official Links

Key Concepts

Concept	Description
Bitcoin	World's first decentralized digital currency based on blockchain technology
Cryptocurrency	Digital assets secured through cryptographic algorithms
Blockchain	Distributed ledger technology providing immutable transaction records
Bitcoin Wallet	Software or hardware device for managing cryptocurrency assets
Private Key	Cryptographic secret required for transaction authorization and asset control

⚖️ Legal & Ethical Guidelines

⚠️ Important Legal Notice: ChainQuery is provided for educational, research, and legitimate security purposes only. Users are responsible for ensuring their use complies with applicable laws and regulations. Unauthorized access to cryptocurrency accounts or wallets is illegal and unethical.

Permitted Uses

Cryptographic research and education
Security vulnerability assessment
Blockchain data analysis
Regulatory compliance monitoring
Academic research

Prohibited Uses

Unauthorized wallet access
Theft of digital assets
Fraud or market manipulation
Privacy violation
Illegal activities

ChainQuery Advanced Blockchain Analysis Platform

Scientific cryptocurrency research tool for security analysis and cryptographic investigation

Repository: https://github.com/zoeir/chainquery

Educational & Research Use Only | For Security Professional Use

Name		Name	Last commit message	Last commit date
Latest commit History 502 Commits
.swagger-codegen		.swagger-codegen
apiactions		apiactions
auth		auth
cmd		cmd
config		config
daemon		daemon
datastore		datastore
db		db
docker		docker
docs		docs
e2e		e2e
global		global
lbrycrd		lbrycrd
meta		meta
migration		migration
model		model
notifications		notifications
scripts		scripts
swagger		swagger
twilio		twilio
util		util
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
.swagger-codegen-ignore		.swagger-codegen-ignore
.travis.yml		.travis.yml
LICENSE		LICENSE
README.md		README.md
dev.sh		dev.sh
go.mod		go.mod
go.sum		go.sum
main.go		main.go
main.js		main.js
package.json		package.json
sqlboiler.toml		sqlboiler.toml

Folders and files

Latest commit

History

Repository files navigation

◆ CHAINQUERY ◆

Advanced Bitcoin Blockchain Data Analysis & Query Platform

⚡ Overview

📋 Installation & Setup

Prerequisites

Installation by Platform

🐧 Linux / Ubuntu

🪟 Windows (PowerShell)

🍎 macOS

☁️ Google Colab

Quick Start Commands

🚀 Programming Language Integration

Python Implementation

JavaScript / Node.js Implementation

Go Implementation

PHP Implementation

Java Implementation

📚 Core Libraries & Dependencies

🎯 Key Features & Capabilities

1. Advanced Blockchain Parsing

2. Wallet Analysis Tools

3. Cryptographic Research Infrastructure

4. Data Query & Export

5. Performance Optimization

🔒 Security & Privacy

Security Features

🌐 API Examples

Query Transaction Details

Retrieve Address Balance

Query UTXO Set

📖 Documentation & Resources

Official Links

Key Concepts

⚖️ Legal & Ethical Guidelines

Permitted Uses

Prohibited Uses

ChainQuery Advanced Blockchain Analysis Platform

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages