Loading...
Recognise real, active people in your dApp. Three ways in — pick the one that fits your stack.
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");
// ...
}
}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…" }
}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)