Update libraries and examples

README.md

@@ -49,7 +49,7 @@ Import the dependencies from the `@biomapper-sdk` like this:
 import {IBiomapperLogRead} from "@biomapper-sdk/core/IBiomapperLogRead.sol";
 import {IBridgedBiomapperRead} from "@biomapper-sdk/core/IBridgedBiomapperRead.sol";
 import {BiomapperLogLib} from "@biomapper-sdk/libraries/BiomapperLogLib.sol";
-import {BridgedBiomapperReadLib} from "@biomapper-sdk/libraries/BridgedBiomapperReadLib.sol";
+import {BridgedBiomapperLib} from "@biomapper-sdk/libraries/BridgedBiomapperLib.sol";
 ```
 
 ### With Foundry
@@ -66,7 +66,7 @@ Import the dependencies from `biomapper-sdk` like this:
 import {IBiomapperLogRead} from "biomapper-sdk/core/IBiomapperLogRead.sol";
 import {IBridgedBiomapperRead} from "biomapper-sdk/core/IBridgedBiomapperRead.sol";
 import {BiomapperLogLib} from "biomapper-sdk/libraries/BiomapperLogLib.sol";
-import {BridgedBiomapperReadLib} from "biomapper-sdk/libraries/BridgedBiomapperReadLib.sol";
+import {BridgedBiomapperLib} from "biomapper-sdk/libraries/BridgedBiomapperLib.sol";
 ```
 
 ## Usage

examples/sybil-resistant-airdrop/contracts/SybilResistantAirdrop.sol

@@ -48,11 +48,15 @@ contract SybilResistantAirdrop {
     event Claimed(address who);
 
     /**
-     * @dev Allows a user to claim their tokens if they haven't already claimed and are unique.
+     * @dev Allows a user to claim their tokens if they haven't already claimed
+     * and are unique in the last generation.
      */
     function claim() public {
         require(!isAlreadyClaimed[msg.sender], "User has already claimed");
-        require(BIOMAPPER_LOG.isUnique(msg.sender), "User is not unique");
+        require(
+            BIOMAPPER_LOG.isUniqueInLastGeneration(msg.sender),
+            "User is not unique"
+        );
 
         ERC20_TOKEN.safeTransferFrom(TOKEN_VAULT, msg.sender, AMOUNT_PER_USER);
 

examples/sybil-resistant-staking/contracts/SybilResistantStaking.sol

@@ -35,7 +35,10 @@ contract SybilResistantStaking {
     }
 
     modifier mustBeUnique() {
-        require(BIOMAPPER_LOG.isUnique(msg.sender), "User is not unique");
+        require(
+            BIOMAPPER_LOG.isUniqueInLastGeneration(msg.sender),
+            "User is not unique"
+        );
         _;
     }
 

libraries/BiomapperLogLib.sol

@@ -6,11 +6,17 @@ import {IBiomapperLogRead} from "@biomapper-sdk/core/IBiomapperLogRead.sol";
 /// @notice A utility library for the `BiomapperLog` contract.
 library BiomapperLogLib {
     /// @notice Determines the uniqueness status of a given address in the current biomapper generation.
-    /// The alternative way of using the `Biomapper` contract.
+    ///
+    /// @notice This call does not guarantee uniqueness across generations,
+    /// meaning the same person can pass this check more than once (perform a Sybil-attack):
+    /// with same biometrics but different account after each generation change.
+    /// Ensure you are fully understand the implications of generations and the security guarantees they provide,
+    /// and consider explicitly scoping your uniqueness check by a particular generation.
+    ///
     /// @param biomapperLog The `BiomapperLog` contract.
     /// @param who The address to check for uniqueness.
     /// @return A boolean value indicating whether the address is biomapped (true) or not (false).
-    function isUnique(
+    function isUniqueInLastGeneration(
         IBiomapperLogRead biomapperLog,
         address who
     ) external view returns (bool) {

libraries/BridgedBiomapperReadLib.sol → libraries/BridgedBiomapperLib.sol

@@ -4,7 +4,7 @@ pragma solidity ^0.8.20;
 import {IBridgedBiomapperRead} from "@biomapper-sdk/core/IBridgedBiomapperRead.sol";
 
 /// @notice A utility library for the `BridgedBiomapper` contract.
-library BridgedBiomapperReadLib {
+library BridgedBiomapperLib {
     /// @notice Determines the uniqueness status of a given address in the last known biomapper generation.
     ///
     /// @notice This call does not guarantee uniqueness across generations,

tests/hardhat/contracts/CanImport.sol

@@ -3,7 +3,7 @@ pragma solidity ^0.8.24;
 
 import {IBiomapperLogRead} from "@biomapper-sdk/core/IBiomapperLogRead.sol";
 import {BiomapperLogLib} from "@biomapper-sdk/libraries/BiomapperLogLib.sol";
-import {BridgedBiomapperReadLib} from "@biomapper-sdk/libraries/BridgedBiomapperReadLib.sol";
+import {BridgedBiomapperLib} from "@biomapper-sdk/libraries/BridgedBiomapperLib.sol";
 import {IGenerationChangeEvents} from "@biomapper-sdk/events/IGenerationChangeEvents.sol";
 import {IProveUniquenessEvents} from "@biomapper-sdk/events/IProveUniquenessEvents.sol";
 import {IBridgeBiomappingEvents} from "@biomapper-sdk/events/IBridgeBiomappingEvents.sol";