Integrating Humanode Biomapper in Your dApp on Base

Humanode Core

26 Feb 2025 • 4 min read

Base an Ethereum Layer 2 built on the OP Stack is designed to make transactions faster and cheaper while having Ethereum’s security. There’s no doubt, that it’s the go-to network for DeFi, gaming, and social dApps, giving developers the tools they need to scale without the usual high fees and network congestion.

But with this increased accessibility comes a big problem: Sybil attacks. Bots and bad actors create multiple accounts to farm rewards, manipulate governance, and gain unfair advantages in decentralized systems. This is especially alarming for dApps like liquidity mining, DEXs, social platforms, and staking platforms, all of which can be easily exploited if there’s no way to verify that users are real, unique humans.

Humanode Biomapper provides a Sybil resistance layer that ensures that every participating wallet address in a dApp is a unique human – without requiring KYC or personal data collection. Users privacy and anonymity remains protected and dApp ensures uniqueness. A win-win for everyone.

Biomapper is now deployed on Base, bringing Sybil resistance to developers without the need for additional infrastructure. dApps can verify real users while maintaining a seamless, secure experience on-chain at the same time leverage Base’s low fees and scalability

How Sybil Resistance Benefits Apps

Stops Airdrop & Reward Farming → One person can't claim multiple rewards, keeping distributions fair.
Prevents Governance Manipulation → Voting remains one-person-one-vote, stopping whales from controlling DAOs.
Secures DeFi Protocols → No more wallet cycling exploits in staking and liquidity mining.
Ensures Fair NFT & Gaming Rewards → Stops bots from hoarding NFTs and in-game items meant for real players.
Protects Liquidity Incentives → Sybil attackers often set up multiple wallets to drain emissions unfairly. Biomapper ensures rewards go only to unique, real liquidity providers, keeping incentives sustainable.

For developers building on Base, integrating Biomapper means stronger tokenomics, better governance, and fairer reward systems – ultimately leading to more sustainable dApps.

This guide will help you understand how to integrate Biomapper in your dApps on Base.

How to Enable Sybil Resistance in Your dApps on Base

Before integrating Biomapper, familiarize yourself with core concepts such as:

Generations: Biomapper operates in fixed time-based generations. Each generation resets biometric mappings.
Integration Flow: Users verify uniqueness once, bridge their biomapping to Base, and can be verified across multiple dApps.

What You Need to Do

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

Development

Smart Contract Integration

Step 1: Install the Biomapper SDK

To get started, install the Biomapper SDK, which provides essential APIs for interacting with Humanode’s Bridged Biomapper on Base.

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 Biomapper Interfaces and Libraries

In your Solidity smart contract, import the required modules:

// 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";

These imports provide access to Biomapper functions, allowing your contract to check user uniqueness and fetch biomapping logs.

Step 3: Connect Your Smart Contract to Bridged Biomapper

The Bridged Biomapper contract on Base is already deployed, so you don't need to deploy your own. Instead, interact with it directly.

Example: Verifying User Uniqueness in a DEX Rewards Program

pragma solidity ^0.8.0;
import "@biomapper-sdk/core/IBridgedBiomapperRead.sol";
contract DexRewards {
    IBridgedBiomapperRead public biomapper;
    constructor(address _biomapperAddress) {
        biomapper = IBridgedBiomapperRead(_biomapperAddress);
    }
    function isUnique(address user) public view returns (bool) {
        return biomapper.isBridgedUnique(user);
    }
}

This contract:

Connects to the Bridged Biomapper contract on Base.
Ensures only unique human users can claim liquidity incentives or trading rewards.

Step 4: Using Mock Contracts for Local Development

For local testing, use the MockBridgedBiomapper contract to simulate biomapping verification before deploying to the testnet/mainnet.

Example usage:

function generationsBridgingTxPointsListItem(uint256 ptr) external view returns (GenerationBridgingTxPoint memory);

Refer to the Biomapper SDK Docs for more details on using mock contracts.

Frontend Integration

To complete the verification flow, add a link to the Biomapper UI where users can verify their uniqueness.

Example UI Implementation:

 < a href="https://biomapper.humanode.io" target="_blank">Verify Your Uniqueness< /a>

Once users verify their biomapping, they can return to your dApp and interact with your smart contract.

Deployment, Testing, and Rollout

Step 1: Deploy Your Smart Contract

Deploy your contract to Base and connect it to Bridged Biomapper.

Step 2: Retrieve and Use Contract Addresses

Retrieve the latest contract addresses from Biomapper SDK.

Step 3: Connect Frontend to Mainnet Biomapper

Ensure your frontend links users to the correct mainnet Biomapper UI before launching.

Step 4: Test Your Integration

Use testnet environments to verify that biomapping checks function correctly.
Confirm users can verify uniqueness and interact with smart contracts as expected.
Monitor transactions and logs to ensure proper execution.

Post-Rollout

App Listing: To have your dApp featured within the Biomapper ecosystem, contact the Humanode team.
Ongoing Support: Keep your contract updated with the latest Biomapper SDK improvements for enhanced functionality and security.

Conclusion

Integrating Biomapper on Base ensures that your dApp remains Sybil-resistant while preserving user privacy. Whether you're developing a DEX, lending protocol, DAO, or NFT marketplace, Biomapper makes fair and human-only participation possible.