feat(ads): rewarded video (VK) — client-attested credit + daily/hourly caps
CI / changes (pull_request) Successful in 4s
CI / unit (pull_request) Successful in 10s
CI / integration (pull_request) Successful in 26s
CI / ui (pull_request) Successful in 1m11s
CI / conformance (pull_request) Successful in 10s
CI / gate (pull_request) Successful in 0s
CI / deploy (pull_request) Successful in 1m53s
CI / changes (pull_request) Successful in 4s
CI / unit (pull_request) Successful in 10s
CI / integration (pull_request) Successful in 26s
CI / ui (pull_request) Successful in 1m11s
CI / conformance (pull_request) Successful in 10s
CI / gate (pull_request) Successful in 0s
CI / deploy (pull_request) Successful in 1m53s
The first ads slice: a voluntary rewarded video credits chips. VK Mini App ads (VKWebAppShowNativeAds) expose only a client-side watch result — no server-to-server verify — so the credit is client-attested, guarded by a server daily + hourly cap (config reward_daily_cap / reward_hourly_cap, default 50 / 10). The caps are both anti-abuse (bounding a forger who skips the ad and calls the endpoint directly) and an economic conversion lever (limiting free chips so a player who wants more buys). D29 amended to VK's reality. Backend: CreditReward (VK-only, order-less, idempotent on a client nonce, floored by the caps; payout from config rewarded_payout_chips, default 0 = off) + the wallet.reward edge op returning the updated wallet (reward_chips gates the "watch for chips" CTA). Additive migration (two config columns). Client: the ads-network abstraction (lib/ads.ts, VK impl) + the VK bridge (vkRewardedReady / vkShowRewarded) + the Wallet CTA + i18n. A contour test stub (VITE_ADS_STUB -> a toast instead of a real ad; prod always real) and a temporary diagnostic that logs the raw VK data, so we confirm on the contour exactly what VK returns (harden to signature-verify if it carries one). Tests: backend integration (credit, nonce idempotency, hourly cap, disabled, non-VK refusal) + codec unit (reward wire). Docs: PAYMENTS(+ru) §10, D29 amend, PLAN E6. Bundle: shared budget 30->31 (reward i18n strings).
This commit is contained in:
@@ -369,12 +369,14 @@ type WalletSegmentResp struct {
|
||||
}
|
||||
|
||||
// WalletResp is the caller's wallet: the context-visible chip segments and the context-applicable
|
||||
// benefits (no-ads term end as unix millis / forever flag, and the available hints).
|
||||
// benefits (no-ads term end as unix millis / forever flag, and the available hints), plus the
|
||||
// rewarded-video payout available in the current context (0 = unavailable — outside VK/unconfigured).
|
||||
type WalletResp struct {
|
||||
Segments []WalletSegmentResp `json:"segments"`
|
||||
AdsForever bool `json:"ads_forever"`
|
||||
AdsPaidUntil int64 `json:"ads_paid_until_ms"`
|
||||
Hints int `json:"hints"`
|
||||
RewardChips int `json:"reward_chips"`
|
||||
}
|
||||
|
||||
// walletBuyBody is the chip-spend request body.
|
||||
@@ -382,6 +384,21 @@ type walletBuyBody struct {
|
||||
ProductID string `json:"product_id"`
|
||||
}
|
||||
|
||||
// walletRewardBody is the rewarded-video credit request: the per-view idempotency nonce and the raw
|
||||
// VK ad result forwarded for the temporary contour diagnostic.
|
||||
type walletRewardBody struct {
|
||||
Nonce string `json:"nonce"`
|
||||
Diag string `json:"diag"`
|
||||
}
|
||||
|
||||
// WalletReward credits a watched rewarded video and returns the updated wallet (client-attested + a
|
||||
// backend daily cap). A reached cap or unconfigured payout surfaces as an APIError domain code.
|
||||
func (c *Client) WalletReward(ctx context.Context, userID, nonce, diag string) (WalletResp, error) {
|
||||
var out WalletResp
|
||||
err := c.do(ctx, http.MethodPost, "/api/v1/user/wallet/reward", userID, "", walletRewardBody{Nonce: nonce, Diag: diag}, &out)
|
||||
return out, err
|
||||
}
|
||||
|
||||
// Wallet fetches the caller's wallet in their current execution context.
|
||||
func (c *Client) Wallet(ctx context.Context, userID string) (WalletResp, error) {
|
||||
var out WalletResp
|
||||
|
||||
Reference in New Issue
Block a user