BlockFact Docs

Installation

Install BlockFact SDKs for your platform

React Native (Mobile)

PRO SDK (Content Registration)

For capturing and registering content with blockchain verification:

npm install @blockfact/react-native-facti-pro blockfact-core mopro-ffi

📦 Peer Dependencies (v5.0.0)

blockfact-core (on-device Poseidon hash, watermark, .facti builder, MobileCLIP embedding) and mopro-ffi (native ZKP via Rust/Arkworks) are required peer dependencies. Both require native module linking.

Then run the setup script to install native ZKP libraries, circuit files, and the MobileCLIP embedding model:

npx @blockfact/setup

🔐 On-Device Processing (v5.0.0)

All processing happens on-device — images never leave the phone. The SDK generates ZKP proofs, watermarks, embeddings, and builds .facti files locally using native Rust modules. Only a few KB of metadata (hash + proof) are sent to the backend. See the Native Module Setup Guide for platform-specific instructions.

⚠️ Expo Users

Native ZKP requires a dev client or prebuild — Expo Go is not supported. Run npx expo prebuild before installing.

Viewer SDK (Display .facti Files)

For displaying and verifying .facti files:

npm install @blockfact/react-native-facti

React Web

For displaying .facti files in web applications:

npm install @blockfact/react-facti

iOS Native

Add to your Podfile:

pod 'BlockFactSDK', '~> 1.0'

Then run:

pod install

🚧 Coming Soon

Native iOS SDK is under development. Use React Native SDK for now.

Android Native

Add to your build.gradle:

dependencies {
    implementation 'io.blockfact:sdk:1.0.0'
}

🚧 Coming Soon

Native Android SDK is under development. Use React Native SDK for now.

Chrome Extension

View .facti files directly in your browser:

Install Chrome Extension

🚧 Coming Soon

Chrome extension is pending review. Available soon on Chrome Web Store.

Requirements

React Native

  • • React Native 0.70+
  • • React 16.8+
  • • iOS 13+ (for native ZKP + DeviceCheck)
  • • Android 5.0+ (API 21+, arm64-v8a for native ZKP)
  • • mopro-ffi native module (for on-device ZKP)
  • • blockfact-core native module (for on-device processing)

React Web

  • • React 16.8+
  • • Modern browser with ES6 support

Verification

Verify your installation:

import { useBlockFact } from '@blockfact/react-native-facti-pro';

console.log('BlockFact SDK loaded successfully');

Next Steps