Skill

calculate-mining-difficulty

This skill should be used when the user asks to "calculate mining difficulty", "convert target to difficulty", "analyze block difficulty", "BSV difficulty calculation", or needs to compute difficulty from block headers.

From bsv-skills

Install

Run in your terminal

npx claudepluginhub b-open-io/claude-plugins --plugin bsv-skills

Tool Access

This skill is limited to using the following tools:

Bash(bun:*)

Supporting Assets

View in Repository

scripts/difficulty.test.ts

scripts/difficulty.ts

Skill Content

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

138.7k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

bmad-help

Analyzes BMad project state from catalog CSV, configs, artifacts, and query to recommend next skills or answer questions. Useful for help requests, 'what next', or starting BMad.

bmad-pro-skills

43.8k

Stats

Stars1

Forks0

Last CommitJan 14, 2026

Actions

View Source View Plugin View on GitHub View README

Usage

# Get current network difficulty bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --current # Calculate from compact bits (e.g., genesis block) bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --bits 0x1d00ffff # Calculate from target hex (64 characters) bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --target 00000000ffff0000000000000000000000000000000000000000000000000000 # JSON output for scripting bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --bits 0x1d00ffff --json # Show help bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --help

Output

Default output:

Mining Difficulty Analysis ========================== Difficulty: 1 Target: 0x00000000ffff0000000000000000000000000000000000000000000000000000 Bits: 0x1d00ffff Expected hashes: 4.29e+9

JSON output (--json):

{ "difficulty": 1, "target": "00000000ffff0000000000000000000000000000000000000000000000000000", "bits": "1d00ffff", "expectedHashes": "4.29e+9" }

Difficulty Math

The script uses the standard Bitcoin difficulty formula:

Max target: 0x00000000FFFF0000000000000000000000000000000000000000000000000000 (difficulty 1)

Difficulty: max_target / current_target

Compact bits format: First byte = exponent, next 3 bytes = mantissa

target = mantissa * 2^(8*(exponent-3))

Expected hashes: difficulty * 2^32

Calculate Mining Difficulty

Calculate and analyze BSV mining difficulty from targets, bits, and network data.

When to Use

Get current network difficulty from WhatsOnChain
Convert between target and difficulty
Decode compact bits representation
Understand expected hash calculations for mining

Usage

# Get current network difficulty
bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --current

# Calculate from compact bits (e.g., genesis block)
bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --bits 0x1d00ffff

# Calculate from target hex (64 characters)
bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --target 00000000ffff0000000000000000000000000000000000000000000000000000

# JSON output for scripting
bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --bits 0x1d00ffff --json

# Show help
bun run skills/calculate-mining-difficulty/scripts/difficulty.ts --help

Output

Default output:

Mining Difficulty Analysis
==========================
Difficulty: 1
Target: 0x00000000ffff0000000000000000000000000000000000000000000000000000
Bits: 0x1d00ffff
Expected hashes: 4.29e+9

JSON output (--json):

{
  "difficulty": 1,
  "target": "00000000ffff0000000000000000000000000000000000000000000000000000",
  "bits": "1d00ffff",
  "expectedHashes": "4.29e+9"
}

Difficulty Math

The script uses the standard Bitcoin difficulty formula:

Max target: 0x00000000FFFF0000000000000000000000000000000000000000000000000000 (difficulty 1)
Difficulty: max_target / current_target
Compact bits format: First byte = exponent, next 3 bytes = mantissa
- target = mantissa * 2^(8*(exponent-3))
Expected hashes: difficulty * 2^32

API Integration

Uses WhatsOnChain API for current network data:

Chain info endpoint: GET https://api.whatsonchain.com/v1/bsv/main/chain/info

Status

Complete - All functionality implemented and tested.