BSV Intel Cheat Sheet

Understanding your daily network health report

Bitcoin Basics

What is BSV?

BSV (Bitcoin SV) is a blockchain that follows the original Bitcoin protocol design. "SV" stands for "Satoshi Vision" - the goal of preserving Bitcoin as described in the 2008 whitepaper.

Unlike other Bitcoin variants that limit block sizes, BSV allows massive blocks (gigabytes), enabling high transaction throughput and data storage directly on-chain.

What is a transaction?

A transaction is a record of value moving on the blockchain. Every transaction has inputs (where the coins come from) and outputs (where they go).

Example: Alice sends 5 BSV to Bob. The transaction has 1 input (Alice's coins) and typically 2 outputs: one to Bob (5 BSV) and one back to Alice as "change" (leftover amount minus fees).
What is an output?

An output is a "lockbox" that holds coins until someone provides the right "key" to unlock them. The lock is defined by a script - a small program that specifies the spending conditions.

When you "own" Bitcoin, you really own the ability to unlock certain outputs because you have the private key that satisfies their scripts.

What is a block?

A block is a bundle of transactions that miners package together. Roughly every 10 minutes (on average), a miner finds a valid block and adds it to the chain. All transactions in that block become confirmed.

The report scans 144 blocks (approximately 24 hours) to give you a full-day picture of network activity.

What Are Scripts?

What is a Bitcoin script?

A script is a mini-program written in Bitcoin's scripting language. It defines the rules for spending an output. When someone tries to spend coins, the network runs the script to verify they have permission.

Think of it like this: A script is a puzzle. To spend the coins, you must provide the solution. The simplest puzzle is "prove you own this public key by signing with its private key."
Why do scripts matter?

Scripts are what make Bitcoin programmable money. Beyond simple payments, scripts can encode:

  • Multi-signature requirements (2-of-3 people must sign)
  • Time locks (coins can't move until a certain date)
  • Hash puzzles (reveal a secret to claim funds)
  • Complex contracts with conditional logic
What does a script look like?

Scripts are written as a sequence of operations (opcodes) and data. Here's the most common script type - a standard payment (P2PKH):

OP_DUP OP_HASH160 <pubkey-hash> OP_EQUALVERIFY OP_CHECKSIG

This says: "Duplicate the provided public key, hash it, check it matches the expected hash, then verify the signature."

Script Taxonomy

How does the report classify scripts?

We classify every output using a three-layer model:

Layer Question It Answers
Purpose What is this output trying to do?
Structure How is it technically implemented?
Protocol What application-layer meaning does it carry?
What are the three Purposes?
PAYMENT
Value transfer between parties. The core use case of money - sending coins from A to B. Includes standard payments (P2PKH), multi-signature setups, and legacy pay-to-pubkey.
DATA_PUBLICATION
Embedding data on the blockchain. The chain becomes a permanent, timestamped record. Includes OP_RETURN outputs, Ordinal inscriptions (images/files), and metadata attached to spendable outputs.
CONTRACTS
Programmable conditions beyond simple signatures. Scripts with conditional logic (IF/ELSE), hash puzzles, byte manipulation, or other advanced operations. These enable smart contracts on Bitcoin.
What is P2PKH?

Pay-to-Public-Key-Hash - the standard Bitcoin payment. Over 95% of value transfer uses this format.

It locks coins to the hash of a public key. To spend, you reveal the full public key and sign the transaction. This is more private than exposing your public key directly.

DUP HASH160 <hash> EQUALVERIFY CHECKSIG
What is OP_RETURN?

A special output type that stores data without locking any coins. The output is provably unspendable (it starts with OP_RETURN which immediately fails), but the data after it is permanently recorded on-chain.

Applications use OP_RETURN to store:

  • Document hashes (proof of existence)
  • Social media posts
  • Token metadata
  • Application state
What are Ordinal inscriptions?

A method of embedding files (images, text, HTML) inside transaction scripts using a special envelope format. Unlike OP_RETURN, inscriptions are attached to spendable outputs.

We classify these under DATA_PUBLICATION because their primary purpose is data storage, even though the output can technically be spent.

Opcodes Explained

What are opcodes?

Opcodes are the individual instructions in Bitcoin's scripting language. Each one performs a specific operation - pushing data, doing math, checking signatures, etc.

The colored tags in the report show which opcodes appear in a script, giving you a quick sense of what it does.

What do the opcode colors mean?
Color Category Examples
purple Cryptographic CHECKSIG, CHECKMULTISIG
amber Hashing HASH160, HASH256, SHA256
cyan Stack manipulation DUP, DROP, SWAP, PICK
blue Control flow IF, ELSE, VERIFY, EQUAL
emerald Byte operations SPLIT, CAT, SIZE
red Math ADD, MUL, DIV, MOD
Common opcodes quick reference
Opcode What it does
OP_DUP Duplicates the top item on the stack
OP_HASH160 Hashes data with SHA256 then RIPEMD160
OP_EQUALVERIFY Checks two items are equal, fails if not
OP_CHECKSIG Verifies a digital signature
OP_RETURN Marks output as unspendable (data carrier)
OP_IF / OP_ELSE Conditional execution (branching)
OP_CAT Concatenates two byte strings
OP_SPLIT Splits a byte string at position N

Whale Watch

What is a "whale" transaction?

Any transaction moving 100 BSV or more. These large movements can indicate significant market activity - exchange deposits/withdrawals, OTC trades, or large holders repositioning.

What do the whale tiers mean?
Tier Significance
>10,000 BSV Massive movement - likely exchange cold wallet, major holder, or institutional
1,000-10,000 BSV Large movement - significant holder activity
100-1,000 BSV Notable movement - active traders or medium holders
What are the whale patterns?
Consolidation (many inputs → few outputs)
Gathering coins from multiple addresses into fewer. Often indicates preparation for a large payment or exchange deposit.
Distribution (few inputs → many outputs)
Spreading coins across multiple addresses. Could be exchange withdrawals, payroll, or deliberate spreading for privacy.
Neutral (balanced inputs/outputs)
Standard transfer pattern - could be a simple payment or internal wallet reorganization.

Mining Distribution

How are miners identified?

Every block has a special transaction called the "coinbase" - the first transaction that creates new coins as the mining reward. Miners typically embed their name or pool identifier in this transaction.

We extract this signature from each block to track who mined it.

Why does mining distribution matter?

A healthy network has mining power spread across multiple independent miners. If one entity controls too much hash power (approaching 50%), they could theoretically:

  • Double-spend coins
  • Censor transactions
  • Reorganize the chain
Alert threshold: The report flags if any single miner exceeds 50% of blocks in the 24-hour period.

Block Timing

Why is the average block time ~10 minutes?

Bitcoin's difficulty adjustment algorithm targets an average of 10 minutes between blocks. This is a deliberate design choice balancing:

  • Fast enough for reasonable confirmation times
  • Slow enough for blocks to propagate globally before the next one
What does block timing variance indicate?

Mining is probabilistic - sometimes blocks come fast (1-2 minutes), sometimes slow (30+ minutes). This is normal.

Pattern What it means
Many fast blocks (<5 min) Hash rate may have recently increased, or just lucky variance
Many slow blocks (>20 min) Hash rate may have dropped, or unlucky variance
Consistent ~10 min average Network operating normally with stable hash rate

Data Protocols

What are the detected protocols?

Applications build on BSV using standardized data formats. We scan all DATA_PUBLICATION outputs (OP_RETURN, Ordinal envelopes, and spendable metadata scripts) for known marker patterns:

Protocol Purpose
B:// File storage - images, documents, media
MAP Magic Attribute Protocol - key-value metadata
AIP Author Identity Protocol - cryptographic authorship
TreeChat Decentralized chat/messaging
Bitcom Application namespacing system
Note: Protocol detection is based on known markers. Absence of a marker doesn't mean absence of meaning - some applications use custom formats.
Where does data actually live on-chain?

This is where it gets interesting. There are multiple ways to embed data in Bitcoin, and the ecosystem is evolving:

OP_RETURN (traditional)
The original method. Data goes in a provably unspendable output. Simple, but the coins are "burned" - the output can never be spent.
Ordinal Envelopes (newer)
Data is wrapped in an OP_FALSE OP_IF ... OP_ENDIF envelope inside a spendable script. The data rides along with real value that can move later.
Spendable Metadata (emerging)
Data pushed after the signature check and dropped via OP_DROP. The script validates normally, but carries extra payload. More efficient than OP_RETURN.

Our report classifies all of these under DATA_PUBLICATION because their purpose is the same - putting data on-chain. The structure (how they do it) varies.

Is OP_RETURN going away?

Probably not soon, but the trend is toward more efficient methods. OP_RETURN has drawbacks:

  • The output is unspendable - those satoshis are gone forever
  • Creates UTXO bloat that nodes must track
  • Originally designed as a "don't do this" escape valve, not a feature

Spendable data methods are perhaps more elegant — the data persists on-chain, but the value can still move. We feel this aligns better with Bitcoin's economic model, where every output theoretically could be spent.

Why this matters: Our Purpose → Structure taxonomy is designed to be future-proof. As data storage methods evolve, we track the intent (DATA_PUBLICATION) separately from the implementation (OP_RETURN vs Ordinal vs other).

How This Report Is Built

Where does the data come from?

The report is built on direct peer-to-peer connection to the BSV network — no centralized API dependencies for core data:

Data Source
Transactions & Scripts P2P Protocol — MSG_BLOCK messages from BSV nodes via Relay Federation Bridge
Block Headers & Timing Traceport header service
Mempool History Bridge LevelDB (sampled every 10 minutes, 24h retention)
Mining Pool Identification Coinbase transaction parsing (from P2P blocks)
Exchange Rate Bridge price endpoint (via CoinGecko)
Node Software Versions Bridge P2P peer connections
Why P2P matters: By connecting directly to BSV nodes using the native Bitcoin P2P protocol, this report doesn't depend on any third-party indexer or API. The blockchain is the source of truth. All data — transactions, blocks, mempool, peer info — comes from direct P2P connections.
What is the Relay Federation?

Relay Federation is a decentralized mesh network for BSV. Each bridge is a lightweight SPV node that:

  • Syncs headers and verifies transactions with Merkle proofs
  • Indexes inscriptions and tokens
  • Serves a full REST API — no full node required
  • Discovers other bridges via on-chain stake bonds
  • Coordinates data sharing through WebSocket peering

We run a bridge node that connects to the BSV P2P network and fetches full blocks for this report's analysis.

Join the Federation: Run your own infrastructure in three commands: github.com/zcoolz/relay-federation
What's the automation workflow?

The report is generated by an n8n workflow (open-source automation platform) that runs every morning:

1. Trigger — 6:15 AM Central, daily
2. Block Scanner — Requests last 144 blocks (~24h) from bridge via P2P
└─ Bridge fetches: MSG_BLOCK from BSV nodes, parses transactions
└─ Scanner extracts: outputs, scripts, whale movements, miner IDs, taxonomy
3. Chain Data Fetch — REST calls for mempool, tips, peers, exchange rate
4. Data Assembly — Merges scanner output with chain overview
5. AI Narrative — Gemini Pro generates the written analysis
6. Report Generation — Scanner service renders the HTML dashboard
Is AI involved in this report?

Yes, but in a specific, limited way:

What AI does:
Google's Gemini Pro writes the narrative analysis section — interpreting the raw data, identifying patterns, and explaining what the numbers mean in plain English.
What AI does NOT do:
The underlying data is not AI-generated. Every number in the report comes from direct blockchain queries. The scanner code deterministically processes transactions, classifies scripts, and calculates statistics. AI only writes the summary text.
How does the block scanner work?

The scanner requests parsed transactions from the bridge, which fetches full blocks directly from BSV nodes via the P2P protocol. For each block, it:

  1. Parses the coinbase transaction to identify the miner
  2. Iterates through every transaction
  3. Classifies each output by Purpose → Structure
  4. Detects known protocol markers (MAP, B://, AIP, etc.)
  5. Flags whale transactions (≥100 BSV)
  6. Collects sample scripts for the "Script of the Day" section

The result is a complete picture of on-chain activity — not a sample, but the full 24-hour dataset sourced directly from the blockchain.

Will this scale as BSV grows?

The P2P architecture handles current block sizes well. As BSV blocks grow larger:

Current approach: The bridge fetches full blocks via P2P and streams transaction parsing. This works efficiently for blocks up to several hundred MB.
Larger blocks: As blocks approach gigabyte scale, we may need to transition to running a local BSV node or using overlay network lookups for specific transaction types.

The taxonomy and analysis logic remain the same — only the data ingestion layer would need to evolve.

Why share the methodology?

Transparency builds trust. When you read a report that says "5 whale transactions detected" or "59% of outputs are payments," you should be able to understand:

  • Where those numbers came from (direct blockchain queries, not estimates)
  • How classifications are made (deterministic rules, not vibes)
  • What AI does and doesn't do (narrative writing, not data generation)

The goal is to help you understand BSV on-chain activity, not to obscure how that understanding is derived.