SovAds Docs

Auth model

How wallets, fingerprints, and operator signatures authorise requests.

RoleDescription
Anonymous viewerIdentified by fingerprint only. Can earn points; cannot redeem.
Wallet viewerCalls ads.identify(wallet). Points migrate from the fingerprint. Can sign EIP-712 redeems.
PublisherWallet owner of the site record. Auth happens via wallet match on each request body.
AdvertiserWallet owner of the campaign record. Same wallet-ownership pattern.
Admin / operatorHolds the SOVADS_OPERATOR_PRIVATE_KEY. Signs claims, runs the AI plan generator.

SIWE is not used. Authentication is wallet-ownership on each request plus EIP-712 signatures for value-bearing actions.