BlueBox Logo
BlueBox

Loading...

© 2026 BlueBoxGG Co., Ltd.
NamesFor projectsDocsAboutContactSecurityTermsPrivacyDiscordX (Twitter)
Blue Pass / Developers

Build on Blue Pass

Recognise real, active people in your dApp. Three ways in — pick the one that fits your stack.

On chain

Your contract calls meetsTrust(), levelOf() or stampTier(). No backend, no API key.

REST API

GET /api/pass/{wallet|handle} from any origin. Live data, cached one minute.

Attestation

Verify BlueBox’s EIP-712 signature on the API response — no RPC needed.

Contract

NameBlueBoxPass (BPASS) · ERC-721 + ERC-5192 soulbound
NetworkKUB Chain · chainId 96
Address0xe7cBBA037CC410935bA26785f4797506d07712D4

A pass stores the snapshot its holder last synced. Always pass a maxAge to meetsTrust if freshness matters to you.

interface IBlueBoxPass {
    struct PassData {
        uint16 trustScore;   // 0-100
        uint8  trustLevel;   // 0 unverified, 1 basic, 2 verified, 3 trusted
        uint32 xp;
        uint16 level;
        uint256 stamps;      // 4 bits per stamp id
        uint64 updatedAt;    // unix seconds of the last sync
    }

    function hasPass(address holder) external view returns (bool);
    function passOf(address holder) external view returns (PassData memory);
    function trustLevelOf(address holder) external view returns (uint8);
    function levelOf(address holder) external view returns (uint16);
    function stampTier(address holder, uint8 stampId) external view returns (uint8);
    function meetsTrust(address holder, uint8 minTrustLevel, uint64 maxAge) external view returns (bool);
}
import {IBlueBoxPass} from "./IBlueBoxPass.sol";

contract MyAirdrop {
    IBlueBoxPass constant PASS = IBlueBoxPass(0xe7cBBA037CC410935bA26785f4797506d07712D4);

    function claim() external {
        // Verified or better, synced within the last 30 days.
        require(PASS.meetsTrust(msg.sender, 2, 30 days), "Blue Pass: verified required");
        // Optional: Questor stamp (id 0) at Gold or higher.
        require(PASS.stampTier(msg.sender, 0) >= 3, "Blue Pass: Gold Questor required");
        // ...
    }
}

REST API

Open CORS, 60 requests per minute per IP. Returns 404 for unknown or banned accounts.

GET https://www.blueboxgg.com/api/pass/somchai.bluebox
GET https://www.blueboxgg.com/api/pass/0xYourWallet

{
  "success": true,
  "pass": {
    "wallet": "0x…", "handle": "somchai.bluebox",
    "level": 12, "xp": 1480, "rank": { "key": "pathfinder", "name": "Pathfinder" },
    "trust": { "level": "verified", "label": "Verified", "score": 64 },
    "earnedStamps": 14, "totalStamps": 28,
    "stamps": [{ "id": 0, "key": "quests", "tier": 3, "value": 23, ... }],
    "packedStamps": "…", "computedAt": "…"
  },
  "onchain": { "tokenId": 42, "level": 11, "updatedAt": 1790000000, ... } | null,
  "attestation": { "domain": {...}, "types": {...}, "message": {...}, "signature": "0x…", "signer": "0x…" }
}

Card images: /api/pass/card/{wallet|handle} (1000×1000) and ?format=wide (1200×630). Token metadata: /api/pass/metadata/{tokenId}.

Verify an attestation

The attestation's primary type is PassAttestation; the contract only accepts PassUpdate, so an attestation can never be replayed to mint a pass.

import { ethers } from 'ethers';

const res = await fetch('https://www.blueboxgg.com/api/pass/' + wallet).then((r) => r.json());
const { domain, types, message, signature } = res.attestation;

const signer = ethers.verifyTypedData(domain, types, message, signature);
const pass = new ethers.Contract(domain.verifyingContract, ['function passSigner() view returns (address)'], provider);

const valid =
  signer === (await pass.passSigner()) &&           // signed by BlueBox
  message.holder.toLowerCase() === wallet.toLowerCase() &&
  Number(message.deadline) > Date.now() / 1000;      // not expired (24 h)

Reference

Trust levels
  • 0Unverified
  • 1Basic
  • 2Verified
  • 3Trusted
Stamp tiers
  • 0Not earned
  • 1Bronze
  • 2Silver
  • 3Gold
  • 4Diamond
Stamp ids
  • 0Questor
  • 1Collector
  • 2Unbroken
  • 3Completionist
  • 4Recruiter
  • 5Scout
  • 6Voice
  • 7Crowd Favourite
  • 8Conversationalist
  • 9Tipped
  • 10Influencer
  • 11Author
  • 12Amplifier
  • 13Active Wallet
  • 14Diamond Hands
  • 15Holder
  • 16Backer
  • 17Trader
  • 18Merchant
  • 19Critic
  • 20Loyalist
  • 21Named
  • 22OG
  • 23Decorated
  • 24Competitor
  • 25Champion
  • 26Rig Builder
  • 27Miner

Stamp ids are permanent: new stamps get new ids and retired ones are never reused.