dFusion Vericore: Semantic Intelligence for Fact Checking at Scale

Table of Contents

• Overview
• Project Structure
• Prerequisites
• Setup Instructions
  • Setting up a validator or miner
  • Register Wallets
• Monitoring and Logging
• Running a blockchain locally
• Notes and Considerations
• License

---

Overview

Vericore is a Bittensor subnet seeking to improve large-scale semantic fact-checking and verification. The subnet processes statements and returns evidence-based validation through relevant quotes and source materials that either support or contradict the input claims.

Key Features

• Semantic Analysis: Processes natural language statements and understands their semantic meaning
• Source Verification: Returns precise quotes and segments from sources
• Dual Validation: Provides both corroborating and contradicting evidence when available
• Scale-Oriented: Designed to incentivize high-volume fact-checking operations
• Source Attribution: All returned evidence includes traceable source information

Use Cases

• Media fact-checking
• Research validation
• Content verification
• Information integrity assessment
• Source validation and cross-referencing

Project Structure

Vericore/
├── miner/
    ├── perplexica/
        └── miner.py         # Sample implementation of a naive miner using Perplexica
    ├── perplexity/
        └── miner.py         # Sample implementation of a naive miner using Perplexity
├── shared/
    ├── log_data.py          # Log settings and format
    ├── proxy_log_handler.py # Log handler
    └── veridex_protocol.py  # Protocol for comms between Validator and Miner
└── validator
    ├── active_tester.py     # Produces tests for the miners
    ├── api_server.py        # Api Server for receiving statements as input
    ├── domain_validator.py  # Handles domain validation
    ├── quality_model.py     # Measure Corroboration or Refutation of statements
    ├── snippet_fetcher.py   # Fetches referenced source material for validation
    ├── validator_daemon.py  # Daemon that handles axons / server tasks
    └── verify_context_quality_model.py

Prerequisites

Before you begin, ensure you have the following installed:

• Python 3.10 or higher (Currently 3.13 isn't supported in certain packages)
• Git
• Bittensor SDK
  • Requirements for bittensor sdk includes Rust and Cargo

Setup Instructions

Setting up a validator or miner

Instructions for installing and setting up a miner can be found in Miner Installation

Instructions for installing and setting up a validator can be found in Validator Installation

Register Wallets

Register both the miner and validator on the Bittensor network.

• Register the Miner:

  btcli s register --wallet.name mywallet --wallet.hotkey miner_hotkey

Note: If you're not connecting to the Mainnet, add ws://127.0.0.1:9944 or specify the name of the network you wish to connect to.

• Register the Validator:

  btcli s register --wallet.name mywallet --wallet.hotkey validator_hotkey

Note: If you're not connecting to the Mainnet, add ws://127.0.0.1:9944 or specify the name of the network you wish to connect to.

---

Monitoring and Logging

Both the miner and validator will output logs to the console and save logs to files in the following directory structure:

~/.bittensor/wallets/<wallet.name>/<wallet.hotkey>/netuid<netuid>/<miner or validator>/

• Miner Logs: Located in the miner directory.
• Validator Logs: Located in the validator directory.

You can monitor these logs to observe the interactions and performance metrics.

---

Running a blockchain locally

This section is for running a local blockchain. The full tutorial is found here: https://github.com/opentensor/bittensor-subnet-template/blob/main/docs/running_on_staging.md

Install Substrate dependencies

Update your system packages:

sudo apt update

Install additional required libraries and tools

sudo apt install --assume-yes make build-essential git clang curl libssl-dev llvm libudev-dev protobuf-compiler

Install Rust and Cargo

Clone the subtensor repo

This step fetches the subtensor codebase to your local machine.

git clone https://github.com/opentensor/subtensor.git

Setup Rust

Update to the nightly version of Rust:

./subtensor/scripts/init.sh

Initialize local subtensor chain into development

First run localnet.sh to build the binary with fast-blocks switched off:

BUILD_BINARY=1 ./scripts/localnet.sh False

Note: You should first go into the subtensor directory before running this command.

Note: The --features pow-faucet option in the above is required if we want to use the command btcli wallet faucet See the below Mint tokens step.

Next, run the localnet script with build binary off, no fast block, and to not purge history:

BUILD_BINARY=0 ./scripts/localnet.sh False --no-purge

We are running with fast-block off and using localnet.sh due to the following issues:

opentensor/bittensor-subnet-template#118 (comment)

opentensor/bittensor-subnet-template#118 (comment)

Note: Watch for any build or initialization outputs in this step. If you are building the project for the first time, this step will take a while to finish building, depending on your hardware.

Mint tokens from faucet

Minting from the faucet requires torch

pip install torch

Mint faucet tokens for the wallet:

btcli wallet faucet --wallet.name owner --subtensor.chain_endpoint ws://127.0.0.1:9945

Look at localnet.sh to see which ports are running.

---

Notes and Considerations

TBD

---

License

This project is licensed under the MIT License. See the LICENSE file for details.

---

Feel free to contribute, raise issues, or suggest improvements to this template. Happy mining and validating on the Bittensor network!