Chain integration

How to add Biomapper to your dApp on Vanar?

Humanode Core

18 Jul 2025 • 2 min read

Vanar Chain is designed for real-world commerce and AI-native applications, offering smart execution, queryable storage, and dynamic payments. As Vanar’s ecosystem grows, Sybil attacks and bot exploitation remain critical challenges for builders in finance, marketplaces, and AI-powered services.

Humanode Biomapper is now available on Vanar, bringing a privacy-preserving, biometric-based Sybil resistance that can be integrated into any dApp. Biomapper ensures that every user interaction comes from a real, unique human without requiring KYC

Key Concepts

Generations: User uniqueness is verified for a limited time (“generation”), after which re-verification is required.
Integration Flow: Users verify once, bridge their uniqueness proof to Metis, and can use that across all dApps.

Step-by-Step Integration Guide

1. Install Biomapper SDK

Add the necessary packages to your project:

npm install --save @biomapper-sdk/core @biomapper-sdk/libraries @biomapper-sdk/events

yarn add @biomapper-sdk/core @biomapper-sdk/libraries @biomapper-sdk/events

For Foundry users:

forge install humanode-network/biomapper-sdk

2. Import Biomapper Interface

In your Solidity smart contract, add:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import { IBridgedBiomapperRead } from "@biomapper-sdk/core/IBridgedBiomapperRead.sol";

3. Connect to the Bridged Biomapper Contract

The Biomapper contract is deployed on Vanar. Connect using the contract address.

4. Add Biomapper UI Link for Users

Let users complete uniqueness verification through the Biomapper app:

< a href="https://biomapper.hmnd.app" target="_blank">Verify Uniqueness< /a>

After verification, users can return and interact with your dApp.

5. (Optional) Local Testing

Use the MockBridgedBiomapper contract from the SDK for local testing.

See the SDK docs for setup and usage.

6. Deploy Your dApp

Deploy your contract on Vanar (mainnet or testnet).
Use the correct BridgedBiomapper contract address for Vanar.
Link your frontend to the Biomapper UI for user onboarding.

Resources

Biomapper App: https://biomapper.hmnd.app
Docs: https://link.humanode.io/docs/biomapper
SDK: https://link.humanode.io/docs/biomapper-sdk
Integration Guide: https://link.humanode.io/docs/biomapper/integration/chains/vanar

By integrating Biomapper with your Vanar dApp, you can add Sybil resistance, ensure fair access, and protect your platform from bots, while keeping user data private and onboarding friction low.

If you need help, join the Humanode Discord or consult the documentation.