CSV awards
Each row awards a share to a Base wallet. We issue entries after validation, not on upload receipt. Max 5 MB / 5,000 rows. Over cap on new rows → accepted: 0.
Columns
walletrequired (Base0x+ 40 hex) — the share identity and payout destinationpartner_user_refoptional — your own audit tag (not used as identity or for payout)idempotency_key,campaign_code,occurred_atoptional
If you omit idempotency_key we fingerprint the row for that calendar day so a second upload of the same file does not charge again.
- Same UTC calendar day (including post-lock re-upload): zero new debits.
- Next UTC day is new weight. Accidental next-day re-upload of yesterday’s file is a new debit.
- Partners who need exact replay across days must send an explicit idempotency_key column.
- Same wallet aggregates share weight for the week; different wallets are different identities.
wallet,partner_user_ref,campaign_code,occurred_at 0x1111111111111111111111111111111111111111,player-42,arcade-s2,2026-08-18T15:02:00.000Z 0x2222222222222222222222222222222222222222,player-99,arcade-s2,2026-08-18T15:04:11.000Z