func AdvertiserBalance
ActionAdvertiserBalance returns the ugnot balance for an advertiser address.
ads2 source realm
23
func ApproveTask
crossing ActionApproveTask marks a task claim as approved. Only the task's advertiser or the admin may approve. Coin reward is handled server-side via the minter.
func ClaimRefEarnings
crossing ActionClaimRefEarnings moves the caller's accumulated referral earnings into a pending payout queue. The treasury server reads RefPendingClaim(), sends GNOT from the treasury wallet, then calls ClearRefClaim() to zero it.
func ClearRefClaim
crossing ActionClearRefClaim is called by the admin/treasury after disbursing GNOT to a referrer. Zeroes the pending payout entry.
func DepositBid
crossing ActionDepositBid credits the caller's advertiser balance with the declared ugnot amount. The caller must attach matching coins to the MsgCall (the VM holds them in the realm's address). The amount is passed explicitly so the realm can credit it without importing chain/banker.
Security: the treasury server MUST verify the on-chain balance before approving any campaign spend — it should call AdvertiserBalance() to cross-check the declared amount matches what was actually deposited.
func GetCampaign
ActionGetCampaign returns the JSON string for a single campaign, or "null".
func GetTask
ActionGetTask returns the JSON for a single task, or "null".
func GetTaskClaim
ActionGetTaskClaim returns the claim status string for a taskId+claimerAddr pair.
func ListCampaigns
ActionListCampaigns returns a JSON array of campaigns submitted by advertiserAddr.
func ListTasks
ActionListTasks returns a JSON array of tasks submitted by advertiserAddr.
func PendingReviews
ActionPendingReviews returns a JSON array of campaigns awaiting admin review.
func RecordView
crossing ActionRecordView bills the advertiser one bid_per_view for a player watching an ad. Deduplicated per (campaignId, callerAddr, UTC day). Splits 50% of the bid to the referrer if one is registered for the advertiser.
func RefEarnings
ActionRefEarnings returns the claimable referral earnings for an address.
func RefPendingClaim
ActionRefPendingClaim returns the pending payout amount for a referrer address. The treasury server calls this before sending GNOT.
func RegisterReferral
crossing ActionRegisterReferral permanently links the calling advertiser to a referrer. Each advertiser may register exactly one referrer; cannot be changed.
func Render
func ReviewCampaign
crossing ActionReviewCampaign approves or rejects a campaign. Approved campaigns transition to "active" and can receive views.
func SelectAd
ActionSelectAd returns the JSON of the winning campaign for the given viewer level, chosen by weighted auction (higher bid_per_view = proportionally more weight). Returns "null" if no eligible campaign exists.
NOTE: uses time.Now().UnixNano() % totalWeight as deterministic pseudo-random. Not cryptographic — sufficient for ad placement.
func SetPaused
crossing Actionfunc SubmitCampaign
crossing ActionSubmitCampaign stores a campaign JSON and queues it for admin review. Returns the generated campaignId. Status is forced to "pending_review" regardless of what the client sends.
func SubmitTask
crossing ActionSubmitTask records a player's proof-of-completion claim on a paid task.
func SubmitTaskDef
crossing ActionSubmitTaskDef creates a new paid social task. Returns the taskId.
func TotalViews
ActionTotalViews returns the total recorded view count for a campaign.
