> For the complete documentation index, see [llms.txt](https://whitepaper.bonuz.market/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.bonuz.market/bonuz-ecosystem/ecosystem-overview.md).
# Ecosystem Overview
The bonuz ecosystem is a layered system — protocol infrastructure at the base, consumer and brand applications on top, and a shared identity and engagement graph connecting everything.
Two entities operate the ecosystem:
* **Bonuz Inc. (St. Lucia)** operates the on-chain protocol suite: bonuz ID Protocol (identity, permissions, attestations) and bonuz Engagement Protocol / DNFT (programmable engagement assets, redemption, state management). These are the main rails that everything fundamental runs on.
* **Bonuz Technology (Dubai, UAE)** builds the applications and distribution layer: the bonuz Lifestyle Wallet, Brand Dashboard, SDK, and white-label apps for enterprise partners. All built on top of Bonuz Inc. protocols.
***
### The bonuz Human Layer — Architecture
The diagram above shows the full bonuz stack from bottom to top:
**Settlement Layers** — Base chains (Ethereum, EVM L1s) securing final state and asset settlement. The foundation for all higher-level applications.
**Execution Layers** — High-throughput, low-fee EVM-compatible execution environments (L1s, L2s, appchains/subnets). All upper layers inherit speed and scalability from these environments. bonuz is currently deployed on Base.
**Middleware Services** — Infrastructure and account abstraction layer. Key management (MPC/Passkeys), bundlers and paymasters, session keys, security, orchestration, monitoring, and indexing. Provider-agnostic, optimized for best consumer UX.
**bonuz — The Human Layer (Protocol & UX Rails)** — The core of the ecosystem. A chain-agnostic SDK surface providing:
* bonuz ID Protocol (identity, permissions, attestations)
* bonuz Engagement Protocol / DNFT (passes, vouchers, memberships, state management)
* Self-custodial wallet UX rails
* Gas sponsorship on core actions (optional gas abstraction)
* Loyalty, access, ticketing, quests, and programmable on-chain engagement
> "bonuz makes blockchains usable for real people and brands: 1-click login, self-custody, and programmable on-chain engagement."
The flow: 1-click social login → self-custodial wallet → dynamic NFTs for access, loyalty, ticketing, quests → gasless user experience → portable on-chain identity (bonuz ID).
**Application & Brand Layer** — Where the Human Layer meets users and brands:
* **bonuz Apps** (B2C) — Consumer apps built to showcase bonuz capabilities and onboard users directly. The flagship is bonuz: Lifestyle Wallet (bonuz.xyz).
* **bonuz Partner Dashboard** (SaaS / B2B2C) — Enables partners to run quests, issue rewards, and manage campaigns. On-chain and off-chain. Available at app.bonuz.market.
* **SDK** (SaaS / B2B) — Plug-in toolkit adding bonuz functionality to DApps and apps in hours: login, DNFTs, loyalty, social graph.
* **White-Label(s)** (Enterprise / B2B) — Fully branded bonuz app clones with custom feature sets. Brands may require fewer functionalities from the full technology stack.
bonuz enables endless applications and use cases — limited only by creativity, logic, and feasibility. The system is cross-device, cross-platform, and cross-language ready.
***
### How It All Connects
The ecosystem serves four main participant types:
**Users (Consumers)** download the bonuz: Lifestyle Wallet, onboard in seconds via email or social login, and receive a self-custodial smart account. They hold tokens, manage passes/vouchers/memberships as DNFTs, optionally activate their bonuz ID, and engage with brands through QR/NFC scanning at real-world venues or online campaigns.
**Brands & Partners** use the Brand Dashboard to create DNFT-based campaigns — loyalty programs, event passes, vouchers, Proof-of-Visit/Participation — using templates and rules. They distribute via QR, NFC, or links and monitor engagement with real-time analytics.
**Enterprise Partners** receive minimal custom white-label apps built by Bonuz Technology DMCC — brand-native, focused UX, running on bonuz protocols. These contribute users and data into the shared bonuz graph.
**Developers** integrate via the bonuz SDK, adding identity and engagement capabilities to their own apps. Every SDK integration contributes new users and graph growth into the Human Layer.
***
### Network Effects
Every participant strengthens the ecosystem. Users build identity and attestation history. Brand campaigns create engagement touchpoints. SDK integrations expand the graph. White-label apps bring new verticals. The **bonuz graph** — the shared network of identities, connections, attestations, and engagements — grows with each interaction, creating compounding value for everyone in the ecosystem.
***
### Quick Links
* [📱 bonuz: Lifestyle Wallet (Mobile App)](https://claude.ai/bonuz-ecosystem/mobile-app-social-wallet)
* [🤖 bonuz ID Protocol](https://claude.ai/bonuz-ecosystem/onchain-social-id-protocol)
* [😳 bonuz Engagement Protocol (DNFT)](https://claude.ai/bonuz-ecosystem/dynamic-nft-protocol)
* [🪄 Core Engagement Flow](https://claude.ai/bonuz-ecosystem/core-engagement-flow)
* [🛡️ Ecosystem / Wallet Security](https://claude.ai/bonuz-ecosystem/ecosystem-wallet-security)
* [🍕 Events & Communities](https://claude.ai/core-utilities-and-services/events-and-communities)
* [⭐ Merging the Real World with the Digital World](https://claude.ai/core-utilities-and-services/merging-the-real-world-with-the-digital-world)
* [🔌 bonuz SDK](https://claude.ai/bonuz-ecosystem/bonuz-sdk)
* [🚗 Product Roadmap](https://claude.ai/bonuz-ecosystem/product-roadmap)
bonuz Ecosystem Wallet & Functionality Logic Architechture - Version 3