> For the complete documentation index, see [llms.txt](https://adlotto.gitbook.io/adlotto-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adlotto.gitbook.io/adlotto-docs/getting-started/readme.md).

# Welcome to AdLotto

### The Zero-Loss Attention Marketplace

AdLotto is a decentralized protocol built on Sui that transforms advertising from a "sunk cost" into a yield-bearing asset. By leveraging Walrus for decentralized storage and Seal for privacy, we have built a marketplace where Advertisers stake capital to broadcast data, and Viewers earn yield for verifying attention.

We are building the first Attention-to-Yield economy, ensuring advertisers preserve their principal while viewers own and monetize their attention data.

### 🎯 The Elevator Pitch

The Problem: The "Ad Spend Black Hole." In the current Web3 marketing landscape, projects burn millions on user acquisition with zero guaranteed ROI. Once the money is spent, it’s gone. Furthermore, ad creatives are public by default (leaking data), and "impressions" are easily faked by bots.

The Solution: AdLotto turns Ad Spend into TVL (Total Value Locked).

1. For Advertisers: You don't spend principal; you stake it. The opportunity cost (Yield) pays for the ad slot. If you don't win the spotlight, you simply unstake.
2. For Viewers: You are the Data Producer. By decrypting an ad and signing a proof, you sell your attention directly to the protocol in exchange for yield.
3. For the Economy: We replace vague "views" with cryptographic Proofs of Attention.

### 🏆 Walrus Haulout Hackathon

AdLotto is built specifically for the Walrus Haulout Hackathon, targeting two specific prize tracks:

#### Data Economy & Marketplaces

We treat "Attention" as a verified asset class. Instead of opaque "impressions," we generate cryptographic proofs (decryption signatures) that certify a user actually viewed the data. We have created a transparent exchange where Liquidity (Advertisers) buys Verified Attention Data (Users) using the native yield of the Sui network as the settlement currency.

### 📦 The "Mystery Box" Economy

To understand AdLotto, think of it as an on-chain Mystery Box protocol:

| Component | Analogy   | Technical Implementation                                                                                                                                                 |
| --------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| The Box   | Walrus    | Advertisers put their content inside a decentralized, immutable box (`Blob`).                                                                                            |
| The Lock  | Seal      | The box is cryptographically locked using Identity-Based Encryption (IBE). It cannot be opened by bots, scrapers, or competitors.                                        |
| The Key   | Attention | The only way to open the box is to prove you are paying attention. The user performs a decryption, generating a unique signature that unlocks the content and the yield. |

### 🔗 Quick Links

| Live Demo        | [adlotto.xyz](https://www.google.com/search?q=https://www.adlotto.xyz)                                                                                        |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Smart Contracts  | [github.com/Sui-AdLotto/adlotto-move](https://www.google.com/search?q=https://github.com/Sui-AdLotto/adlotto-move)                                            |
| Frontend Repo    | [github.com/Sui-AdLotto/adlotto-frontend](https://www.google.com/search?q=https://github.com/Sui-AdLotto/adlotto-frontend)                                    |
| Testnet Explorer | [Suivision Package](https://www.google.com/search?q=https://testnet.suivision.xyz/package/0xddea4232d33dc364dc18f0ad70c8b38093e5e126da8bd56aa943b9fe9670fde0) |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://adlotto.gitbook.io/adlotto-docs/getting-started/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.