Biomapper

How to enable Uniqueness verification in your Manta dApp with Humanode Biomapper

Humanode Core

17 Apr 2025 • 3 min read

Manta Pacific is quickly becoming the go-to Layer 2. As an EVM-compatible L2 built on Optimism’s OP Stack, it’s optimized for low-cost, high-performance dApps that want to bring zero-knowledge proofs into the real world.

Whether you’re building DeFi, on-chain identity protocols, or decentralized social apps, one thing remains essential: ensuring that every user interacting with your dApp is a real, unique human.

That’s where Humanode Biomapper comes in. It allows you to verify the uniqueness of users on-chain without KYC, without docs, and without compromising privacy. Just cryptographic proof that one EVM wallet = one real person.

Why Sybil resistance matters on Manta

Manta dApps often rely on user privacy, on-chain identity. But without Sybil resistance, those same dApps can be gamed:

SBTs: Without uniqueness, people can mint multiple SBTs, undermining credential systems.
Private airdrops: While tools can hide identity, but not guarantee that users aren’t bots with 100 wallets.
DeFi and staking rewards: Incentives meant for a community can be drained by a few Sybil attackers.
Voting & governance: On-chain voting loses meaning if one person can vote 20 times or votes are based on number of tokens

By using Biomapper, you can ensure that each address claiming a benefit, voting, or participating in your protocol is backed by a unique human being while still respecting the privacy values Manta is known for.

Why Biomapper is a perfect match for Manta dApps

Biomapper is built with privacy and security at its core. It uses advanced cryptobiometrics to verify a user's uniqueness without exposing their biometric data. Here's how:

Encrypted Biometric Matching: All biometric data is processed inside a Confidential Virtual Machine (CVM) using AMD SEV-SNP. Even Humanode can't access the data.
No KYC or Identity Exposure: Biomapper proves that a user is unique, not who they are.
ZK-Compatible Trust Model: Because Biomapper only outputs biotoken tied to a wallet address, it aligns perfectly with Manta’s philosophy of minimal disclosure and maximum privacy.

This means developers on Manta can build powerful, privacy-respecting, Sybil-resistant dApps without sacrificing decentralization or user safety.

Since Biomapper is already live on Manta Pacific, integrating it into your dApp to verify unique participants is quick and straightforward. This guide will show you how.

Before integration, familiarize yourself with these Biomapper concepts:

Generations: Biomapper verifies uniqueness within defined, time-based periods, regularly resetting biometric mappings.
Integration Flow: Users verify once, bridge their biomapping to Manta Pacific, and use it seamlessly across multiple dApps.

What to do:

Write a smart contract that interacts with the Bridged Biomapper on HyperEVM.
Add a link to the Biomapper UI on your front end so users can complete their biomapping.

How to integrate Biomapper with your dApp on Manta

Step 1: Install Biomapper SDK

Install Biomapper SDK in your project.

Using npm:

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

Using yarn:

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

Using Foundry:

forge install humanode-network/biomapper-sdk

Step 2: Import Required Interfaces

Include Biomapper interfaces in your smart contract:

// SPDX-License-Identifier: MIT


pragma solidity ^0.8.20;

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

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

import { BiomapperLogLib } from "@biomapper-sdk/libraries/BiomapperLogLib.sol";

Step 3: Connect to the deployed Biomapper contract on Manta

Use the deployed BridgedBiomapper address on Manta Pacific.

Example: SBT Minting Eligibility

pragma solidity ^0.8.0;

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

contract UniqueCredentialIssuer {

    IBridgedBiomapperRead public biomapper;

    mapping(address => bool) public hasMinted;

    constructor(address _biomapperAddress) {

        biomapper = IBridgedBiomapperRead(_biomapperAddress);

    }

    function mintCredential() external {

        require(biomapper.isBridgedUnique(msg.sender), "Not a unique human");


        require(!hasMinted[msg.sender], "Already minted");
        hasMinted[msg.sender] = true;

        // Call SBT minting logic here

    }

}

Step 4: Use Mocks for Local Testing

You can use MockBridgedBiomapper during development to simulate verification.

Step 5: Frontend Link to Biomapper UI

Send users to the Biomapper App for uniqueness verification:

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

Once verified, they return to your dApp and can interact normally.

Deployment and Rollout

Deploy your contracts to Manta.
Connect to the correct Biomapper contract addresses.
Update your frontend link to the Biomapper mainnet verification app.
Thoroughly test integration on the Manta testnet.

Wrapping Up

Manta is building the foundation for privacy-focused Web3, but privacy without Sybil resistance is fragile. By integrating Humanode Biomapper, you get the best of both worlds: proof of personhood without compromising identity.

Biomapper is now live on Manta Pacific - ready when you are.