# bonuz SDK

**Your app already has superpowers.** Add the bonuz Human Layer and give your users self-custodial wallets, portable identity, and programmable engagement — without building any of it yourself. It's simple to integrate, and it unlocks new products, stronger communities, and features you can be creative with.

Wallets, identity, engagement, and a social graph — in one SDK. No blockchain expertise required. No seed phrases. No gas fees. No infrastructure to build.

**npm:** `npm install @bonuz/sdk`

```javascript
// sdk-demo.js

import { BonuzSDK } from '@bonuz/sdk';

const bonuz = new BonuzSDK({ appId });         // Initialize

const user = await bonuz.connect();             // Wallet + Identity ready

await bonuz.issueDNFT(user, 'loyalty-card');    // Engagement on-chain
```

***

### Not just wallets. The full Human Layer.

Other SDKs give you a wallet. bonuz gives you everything on top of it.

#### Self-Custodial Wallets

Users get a wallet through social login — email, Google, Apple. No seed phrases, no extensions, no custody risk for you. MPC/TSS key management ensures no single point of failure.

#### Portable Identity (bonuz ID)

Every user brings their bonuz ID — verified social handles, attestations, engagement history. Your app gets enriched profiles from day one. Write new attestations back: course completions, achievements, visit proofs.

#### Programmable Engagement (DNFTs)

Issue loyalty cards, vouchers, passes, memberships, tickets, and certificates as Dynamic NFTs. Built-in state machine handles progression, redemption, expiry, and anti-fraud. No smart contract writing required.

#### Social Graph

Query a user's connections and engagement within the bonuz graph (with permission). Enable friend discovery, social recommendations, and community-aware experiences.

***

### How bonuz compares.

| Feature                                      | MetaMask | Phantom     | Privy / Dynamic | MetaKeep | Traditional Loyalty | **bonuz SDK**   |
| -------------------------------------------- | -------- | ----------- | --------------- | -------- | ------------------- | --------------- |
| Self-custodial wallet                        | ✅        | ✅           | ✅               | ✅        | ✗                   | ✅               |
| Social login (no seed phrase)                | ✗        | ✗           | ✅               | ✅        | N/A                 | ✅               |
| Gas sponsorship                              | ✗        | ✗           | Partial         | ✅        | N/A                 | ✅ Built-in      |
| On-chain identity protocol                   | ✗        | ✗           | ✗               | ✗        | ✗                   | ✅ bonuz ID      |
| Attestations & reputation                    | ✗        | ✗           | ✗               | ✗        | ✗                   | ✅ Read & write  |
| Dynamic NFTs (loyalty, passes, vouchers)     | ✗        | ✗           | ✗               | ✗        | Siloed              | ✅ Full protocol |
| Social graph                                 | ✗        | ✗           | ✗               | ✗        | ✗                   | ✅ Permissioned  |
| Anti-fraud (signature-gated, on-chain state) | ✗        | ✗           | ✗               | ✗        | ✗                   | ✅               |
| Shared user network                          | ✗        | ✗           | ✗               | ✗        | ✗                   | ✅ bonuz graph   |
| Multi-chain (EVM + Solana + Bitcoin)         | EVM only | Solana only | EVM focus       | Multi    | N/A                 | ✅ All           |
| Brand dashboard (no-code)                    | ✗        | ✗           | ✗               | ✗        | Proprietary         | ✅               |
| White-label ready                            | ✗        | ✗           | ✗               | ✗        | ✗                   | ✅               |

**The pattern is clear:** Wallet SDKs stop at key management and transactions. Traditional loyalty platforms are siloed and off-chain. bonuz is the only SDK that combines self-custodial wallets, portable identity, programmable engagement, and a shared social graph in one integration.

***

### Every industry. Zero friction.

**Events & Entertainment** Issue passes, collect Proof-of-Visit attestations, distribute post-event rewards — all verifiable, all owned by attendees.

**F\&B & Retail** Loyalty punchcards, redeemable vouchers, tiered memberships — on-chain, fraud-proof, and portable across locations.

**Education & Training** Soul-bound certificates for course completion. Verifiable credentials that live in the user's wallet permanently.

**Gaming & Apps** In-app achievements as attestations. Reward systems backed by real on-chain assets. Cross-game reputation via bonuz ID.

**Creator Platforms** Membership passes, exclusive access tokens, and fan engagement rewards — issued through your platform, held in the user's wallet.

***

### Three calls. That's it.

While others require weeks of SDK integration, you're already in production.

#### 1 — Initialize

```
const bonuz = new BonuzSDK({ appId });
```

Single SDK import. Configure with your partner credentials.

#### 2 — Connect

```
const user = await bonuz.connect();
```

User logs in with their bonuz account. Wallet, identity, and attestation history arrive automatically.

#### 3 — Build

```
await bonuz.issueDNFT(user, 'loyalty-card');
await bonuz.writeAttestation(user, 'course-complete');
await bonuz.getConnections(user);
```

Issue DNFTs, write attestations, query the social graph. The SDK handles gas, state management, and protocol interactions.

***

### The difference is obvious.

#### Traditional Approach

✗ Weeks to integrate wallet infrastructure

✗ Build your own identity system from scratch

✗ No engagement tools — just raw transactions

✗ Seed phrase friction kills onboarding

✗ Siloed users — no shared graph

✗ Gas costs passed to users

#### bonuz SDK

✅ Hours to production

✅ Portable identity included (bonuz ID)

✅ Full engagement protocol — loyalty, passes, vouchers, certificates

✅ Social login — no seed phrases, no friction

✅ Shared bonuz graph — every integration grows the network

✅ Gas sponsored on core actions

***

### Infrastructure that just works.

#### Self-Custodial

Users own their keys. You own the business, without custody risk.

#### Gas Sponsored

Claiming, redeeming, attestations — all gas-sponsored. Users never think about fees.

#### Multi-Chain

EVM chains, Solana, and Bitcoin. One SDK for everything.

#### Audited

Smart contracts audited by Hacken. 10/10 security score. MPC/TSS key management with MFA.

#### Permissioned

All identity and graph access is scoped and revocable. Users control what your app can see.

#### Graph Growth

Every user interaction through the SDK strengthens the shared bonuz graph. More integrations → more users → more value.

***

### Every integration grows the network.

The bonuz SDK isn't just a developer tool — it's a distribution channel. Every app that integrates the SDK becomes an entry point into the bonuz ecosystem. Users bring their identity in. New attestations flow out. The graph gets richer. The network gets more valuable.

More apps → more users → more attestations → more reasons to integrate.

That's the flywheel.

***

### Go live today.

**npm:** [@bonuz/sdk](https://www.npmjs.com/package/@bonuz/sdk)

For partnership inquiries, custom integration support, or developer documentation: [partner form](https://tally.so/r/3jLPGQ)