🧭Attribution Infrastructure

The Attribution Infrastructure is the core system that enables OneClick to track, reward, and optimize liquidity routing across DeFi protocols.

It ensures that every user deposit is linked to its origin — whether via direct frontend interaction, partner integrations, or SDK/API routes — enabling transparent boosts, rewards, and performance analytics.

Attribution is designed to function both offchain and onchain, depending on the integration path and protocol capabilities.

---

System Architecture

• Referral Metadata Layer: A data structure attached to each deposit event, capturing the source of the deposit (e.g., OneClick frontend, SDK partner, affiliate).

• Attribution Registry: A lightweight database (offchain or onchain) that logs referral relationships, eligible boost campaigns, and user-specific tracking IDs.

• Boost and Reward Processor: A calculation engine that matches deposits to campaigns, applies eligible multipliers, and processes allocation for boosts or points.

• Campaign Management Interface: Protocol-facing dashboard to set up, manage, and monitor boost campaigns tied to user flows and referral attribution.

---

How Attribution Works

1. User Initiates Deposit A user deposits into a listed vault via OneClick frontend, SDK partner, or referral campaign.

2. Attribution Captured Metadata is appended to the transaction (offchain via tracking link, or onchain via router contract).

3. Verification The system validates deposit execution and confirms eligibility against active campaign parameters.

4. Reward Calculation Boosts, multipliers, or points are assigned based on the deposit amount, vault ID, referral ID, and campaign rules.

5. Distribution Users can later claim accumulated rewards through a simple claiming mechanism — either onchain or through offchain snapshots.

---

Offchain Attribution Model

• Attribution captured via signed metadata on deposit links

• Lightweight and faster to deploy

• Boost eligibility stored and computed offchain

• Reward proofs verified periodically via snapshot exports

---

Onchain Attribution Model

• Attribution captured via router smart contract

• Referral ID embedded into deposit transaction

• Boost eligibility tracked onchain

• Merkle proof structures enable decentralized, verifiable reward claims

---

Security Considerations

• Attribution metadata is non-critical to transaction execution

• Even if attribution fails, user funds remain safely deposited into protocol vaults

• Router contracts (if used) are minimal, auditable, and purely logistical in function (no fund custody)

---

Benefits of Attribution Layer

• Transparent liquidity routing for protocols

• Performance-based rewards for partners

• Boosted yields and loyalty rewards for users

• Campaign control and tracking for ecosystem growth