Skip to content

docs: Add AIP-6 referrals and client attribution - #12

Merged
kotevcode merged 2 commits into
mainfrom
feat/aip-6-referrals-client-attribution
Oct 4, 2026
Merged

kotevcode merged 2 commits into
mainfrom
feat/aip-6-referrals-client-attribution

Conversation

@kotevcode

Copy link
Copy Markdown
Contributor

Adds AIP-6 (Draft, Standards Track / Contracts, requires AIP-2): referral and client attribution through a buyer-signed metadata tail.

  • Five-word attribution tail in SpendingAuth v1/v2/v3 and FreeUsage v1 metadata (clientId + optional EIP-2098 invite), decoded by AntseedStatsV2
  • AntseedAttributionUsage: per-epoch recognized weighted points per client, referrer and referee (cursor, credit-epoch roll forward, first usage, pause)
  • Two new emissions-gate controllers, AntseedReferrals and AntseedClientRewards, on the shared AntseedEpochShareRewards pro rata split
  • Two-sided referrals (50/50 during a 12-epoch referee window), activity-based single-use invites, new-buyer rule, shared-operator self-referral guard
  • Fixed invite and 416-byte metadata test vectors

Reference implementation: Antseed/antseed#1080

Open issues (listed in the AIP):

  1. Minter ids and share values for the referral and client buckets are not defined in the repo; the AIP-2 default shares already sum to 100%, so existing editable buckets must give up share.
  2. The reference TypeScript encoder (packages/protocol/src/signatures.ts) still emits the retired two-word tail and must move to the five-word tail (plus an invite signer) checked against the vectors.
  3. Whether to cap a single claimant's share per epoch (neither controller does today).

node scripts/validate.mjs passes for all six AIPs.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 4, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
aips 55c5b30 Commit Preview URL

Branch Preview URL
Oct 04 2026, 05:24 AM

@kotevcode
kotevcode merged commit 92e5ea7 into main Oct 4, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant