Skip to main content

💎 Human Reputation Layer (HIS API)

Purpose​

Provides a reputation system that measures and utilizes user trustworthiness, contribution, and participation across Web3 and Web2.

Limitations of Current Reputation Systems​

  • Fragmented Evaluation: Existing reputation systems are limited to specific platforms or activities, failing to reflect a user's overall trustworthiness.
  • Manipulation Vulnerability: Most reputation metrics can be easily manipulated, making them difficult to use as effective trust indicators.
  • Opaque Calculation Methods: Many reputation systems use black-box algorithms, making it difficult for users to improve their scores.
  • Lack of Human Verification: Most Web3 reputation systems don't verify whether accounts are operated by real humans.

HumanPass Approach​

The Human Reputation Layer provides a Human Identity Score (HIS) system that comprehensively evaluates users' various on-chain/off-chain activities based on HumanPass's human verification.

Core properties:

  • Human Identity Score (HIS): A trust score that comprehensively evaluates human verification status, activity history, and social connections.
  • Trait Unlock System: Allows visual expression by unlocking traits for HPFP NFTs based on accumulated scores and activities.
  • Developer API: Provides APIs for dApp developers to easily query and utilize user reputation data.
  • Dynamic Update: Automatically adjusts scores based on continuous activity and contribution to maintain current status.

Technical Implementation​

The technical implementation of the Human Reputation Layer consists of the following components:

  1. Score Calculation System

    • Human Points acquisition logic for various activity types
    • Time weighting and consistency bonus mechanisms
    • Anomaly detection algorithms to prevent manipulation

  2. Data Integration Layer

    • On-chain activity data collection and analysis
    • Off-chain social proof and contribution evaluation
    • SBT and HPFP NFT metadata integration

  3. Developer Interfaces

    • RESTful API and GraphQL endpoints
    • SDK and plugin libraries
    • Customizable reputation threshold setting tools
// Human Reputation API Usage Example
import { HumanReputation } from "@humanpass/reputation";

// Initialize reputation client
const reputation = new HumanReputation({
  apiKey: "YOUR_API_KEY",
});

// Query user reputation
const userReputation = await reputation.getUserScore({
  walletAddress: "0x...",
  includeDetails: true, // Include detailed score components
});

// Utilize results
if (userReputation.isHuman && userReputation.hisScore >= 70) {
  // Handle high-trust user
  console.log(`High trust: ${userReputation.hisScore} points`);
  console.log(`Activity score: ${userReputation.activityScore}`);
  console.log(`Social connections: ${userReputation.socialConnections.length}`);
  console.log(
    `Special achievements: ${userReputation.achievements.join(", ")}`
  );

  // Provide special features or benefits
  unlockPremiumFeatures(userWalletAddress);
} else {
  // Encourage reputation improvement
  suggestReputationImprovement(userReputation.improvementSuggestions);
}

Real-World Applications​

DeFi Protocols

  • Credit-based uncollateralized loan eligibility assessment
  • Risk-adjusted yield provision
  • Premium services for high-trust users

NFT and Creator Economy

  • Identifying trustworthy creators
  • Reputation-based marketplace access
  • Community curation and recommendation systems

DAOs and Governance

  • Reputation-weighted voting systems
  • Role and responsibility assignment criteria
  • Contributor rewards and incentive distribution

Games and Metaverse

  • Reputation-based access control and privileges
  • In-game role assignment based on trustworthiness
  • Community management and moderation mechanisms

Social Platforms

  • Trust-based content recommendations
  • Spam and malicious actor filtering
  • High-quality interaction promotion

Implementation Details​

HIS Score Components​

The HIS score consists of the following main components:

  1. Basic Human Verification Score (30 points)

    • HumanPass verification completion: +30 points
    • Bonus based on verification maintenance period: up to +5 points

  2. Activity Score (maximum 40 points)

    • On-chain transaction activity: up to 15 points
    • Community participation and contribution: up to 15 points
    • Governance participation: up to 10 points

  3. Social Connection Score (maximum 20 points)

    • Social account connections: +5 points per account (up to 15 points)
    • Social account activity and influence: up to 5 points

  4. Special Achievements (maximum 10 points)

    • Ecosystem contribution and development participation: up to 5 points
    • Community leadership and special activities: up to 5 points

HPFP NFT Trait System​

HIS scores are used to unlock visual traits for HPFP (HumanPass Profile Picture) NFTs:

  • 50+ points: Basic avatar customization
  • 60+ points: Background and frame options unlocked
  • 70+ points: Special accessories and effects unlocked
  • 80+ points: Rare traits and animations unlocked
  • 90+ points: Legendary traits and exclusive designs unlocked

Strategic Impact​

Human Reputation Layer provides the following strategic value to the Web3 ecosystem:

  • Trust-Based Web3 Reputation Economy: Creates a new economic model based on real human users' contributions and participation.
  • Integrated Trust Layer: Provides a comprehensive trust system combining "human verification + reputation + visualization."
  • Developer-Friendly Tools: Enables developers to easily integrate trust scores into their services for safer and more efficient user experiences.
  • Positive Behavior Encouragement: Encourages healthy user participation and contribution through a transparent reputation system.

Human Reputation Layer is not just a scoring system but foundational infrastructure for quantifying and utilizing trust and reputation across the Web3 ecosystem. This enables building a safer, more transparent, and human-centric digital economy.