Biomapper

How to integrate Biomapper with your Botanix app?

Humanode Core

24 Jul 2025 • 2 min read

Botanix is the first fully decentralized Bitcoin Layer 2, EVM-compatible, and built to enable lending, staking, yield generation, and other financial applications for the Bitcoin economy. As Botanix expands, defending against Sybil attacks and bot exploitation is crucial for builders in DeFi, rewards, and governance protocols.

Humanode Biomapper is now available on Botanix, bringing a privacy-preserving, biometric-based Sybil resistance layer that can be integrated into any dApp. Biomapper ensures every interaction comes from a real, unique human, with no KYC or personal data exposure.

Key Concepts

Generations: User uniqueness is verified for a limited period (“generation”), after which re-verification is required.

Integration Flow: Users verify once, bridge their uniqueness proof to Botanix, and can use that across all compatible 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

# or

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 Botanix. 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 Botanix (mainnet or testnet).
Use the correct BridgedBiomapper contract address for Botanix.
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/botanix

By integrating Biomapper with your Botanix dApp, you add Sybil resistance, enable fair access, and protect your platform from bots while keeping user data private and the onboarding process simple.

Need help? Join the Humanode Discord or refer to the documentation.