Gully Offerwall

The Offerwall is a marketplace on top of Quests. Advertisers (games, protocols, Gully's own apps) fund offers such as "reach level 5", "bridge to GullyChain" or "follow on X". Players complete them and earn glUSD on web and PC, or points on mobile. Publishers show the wall on their site or in their game and earn a share of every completion.

#How a campaign runs

1. Create the offer in the dashboard: type (game milestone by postback, on-chain action, social), reward, number of completions, end date. The quote shows the reward, the publisher share and the fees before you pay.
2. Pay with Gully Pay. Gully Pay confirms the payment with a signed webhook; the API checks the amount and dedupes the event.
3. Escrowed on Quests. The operator calls OfferwallManager.open, which pulls the budget in glUSD and creates the quest on the QuestRegistry with the manager as its creator.
4. Players complete it. Completions are attested by the Offerwall's own AttestedVerifier; crypto rewards are claimed on the registry, points go to the publisher's callback.
5. Unspent budget returns. At the end, or when you cancel, release sends everything the campaign no longer needs back to your Gully Chain account. Refunds can never get stuck in the manager.

Fees: the Quests protocol fee (5%) and the Offerwall service fee (10%). Publishers earn 25% of the reward of every completion on their placement.

#Add the wall to a site or web game

Create a placement in the dashboard (list the origins allowed to frame it), then paste its snippet:

<div id="gully-offerwall"></div>
<script src="https://offers.gullychain.xyz/widget/offerwall.js"
        data-placement="pk_…" data-target="#gully-offerwall" async></script>

The frame is served from offers.gullychain.xyz with Content-Security-Policy: frame-ancestors limited to your placement's origins; every other Offerwall page refuses to be framed. Options: data-mode="modal" with GullyOfferwall.open(), data-theme to override the kit colours. iOS and Android placements never show crypto actions: players earn points instead.

#Report game events (postbacks)

Game milestones are reported by your server, never by the client:

POST https://offers.gullychain.xyz/v1/postback
X-Gully-Key: pbk_…
X-Gully-Timestamp: <unix seconds, ±300 s>
X-Gully-Nonce: <16-64 chars, never reused>
X-Gully-Signature: hex HMAC-SHA256(secret, timestamp + "." + nonce + "." + rawBody)

{ "clickId": "clk_…", "event": "level_reached", "value": 5 }

Unity games use the Offerwall module of the Gully Game SDK (GullyOfferwallClient), with a Nakama postback hook. Points rewards arrive at your placement's callback URL, signed with your placement secret sk_…; grant once per completionId.

#Contracts (GullyChain Testnet, 485590)

The service and the operator wallet are on the status board (opens in a new tab).