bonuz SDK
integrate bonuz login in minutes
One-tap, self-custodial login and Engagement-ready entitlements, with gasless sponsored flows when you choose.
Give users a normal login and return a user-owned identity. The bonuz SDK drops into any web/app stack; your product stays exactly as it is. When you want verifiable passes, vouchers, certificates or tickets, call one helper and bonuz handles the Engagement, sponsorship rules and verification.
Quickstart (JS/TS)
import { bonuzLogin } from "@bonuz/sdk";
const user = await bonuzLogin({
providers: ["email", "google", "apple"],
scopes: ["profile_basic", "email_verified", "entitlements_read"],
chains: ["base", "polygon", "ethereum"] // example; bonuz is chain-agnostic
});
// user.id, user.profile, user.entitlementsWhat's inside
Referrals & credits
Built-in, no contracts required
Entitlements API
hasEntitlement(featureId) checks Engagement state and rules
Webhooks
user_login, dnft_minted, voucher_redeemed, ticket_verified
Gas sponsorship policy
Allowlisted contracts/methods with per-wallet/day caps, campaign caps, cooldowns, and anti-abuse checks before sponsor. Users can always transact themselves.
{
"campaignId": "summer-2025",
"chainId": 8453,
"contracts": [
{"address":"0xAbC...", "methods":["mintPass","redeemVoucher","verifyTicket"]}
],
"perWalletDailyCap": 3,
"campaignCap": 10000,
"cooldownSeconds": 3600,
"denyIfRiskScoreAbove": 0.8
}