HashVerificationStrategy

Overview

The HashVerificationStrategy verifies data integrity by comparing SHA-256 hashes of fetched data against trusted gateway digest headers. This strategy provides fast, cryptographically secure verification for high-throughput applications.

How It Works

Fetch Data: Retrieve content from the selected gateway
Request Digest: Get the digest from trusted gateways via HTTP headers using HEAD/GET requests from a trusted gatweay
Compute Hash: Calculate the SHA-256 hash of the received data
Compare: Verify that both hashes match exactly
Result: Pass or fail based on hash comparison

Basic Usage

import { HashVerificationStrategy, Wayfinder } from '@ar.io/wayfinder-core'

const wayfinder = new Wayfinder({ /* ...global wayfinder configuration */  });
const verificationStrategy = new HashVerificationStrategy({
  trustedGateways: [new URL('https://arweave.net')],
})

// use it in a request
const verifiedData = await wayfinder.request('ar://<some-tx-id', {
  verificationSettings: {
    enabled: true,
    strategy: verificationStrategy,
    strict: true // block the flow of bytes until verification has passed
    events: {
      onVerificationProgress: (e) => {
        console.debug('Verification progress: ${ e.processBytes / e.totalBytes * 100}%)
      },
      onVerificationFailed: (e) => {
        console.error('Verification failed!, e)
      },
      onVerificationSucceeded: (e) => {
        console.log('Verification succeeded!, e)
      }
    }
  }
})

Signature Verification: Understand authenticity validation
Data Root Verification: Explore maximum security verification