~/portfolio/projects/proto-circle
← cd ../projects

#04 · 2026

Proto-Circle - Instant Attribution & Micropayments Engine

Hackathon build (testnet)
view code →
readme.md

Hackathon prototype · Next.js · TypeScript · Circle Wallets · Arc Testnet

USDC

instant micropayments

1

transfer per influencer

100%

explainable attribution

my_role: Individual Contributor (IC) - designed the attribution policy, wired Circle wallets on Arc Testnet and built the evidence dashboard.

Proto-Circle is a hackathon prototype that proves the trust layer for creator commerce: transparent attribution plus instant USDC micropayments on Arc Testnet. Influencers register with their Arc wallet addresses and get unique tracking links; every click is logged with a timestamp against an anonymous browser cookie. On a qualifying conversion, a recency-weighted policy (or last-click fallback) resolves attribution, and each attributed influencer is paid out in USDC via Circle Developer-Controlled Wallets - one transfer per influencer. A single dashboard shows the evidence: timeline, rationale, and payout status, so the math is never a black box.

## Run campaigns. Pay on real engagement.

Fund a creator campaign, track clicks and conversions, and pay out USDC automatically - verified on-chain. Built as a hackathon prototype on Arc Testnet with Circle Developer-Controlled Wallets.

## What it does

  • ›Registers influencers with their Arc wallet addresses
  • ›Generates unique tracking links per influencer (e.g. /r/abc12345)
  • ›Logs every click with a timestamp, keyed to an anonymous browser cookie
  • ›Resolves attribution on a qualifying conversion event using a recency-weighted policy (or last-click)
  • ›Pays out USDC on Arc Testnet via Circle Developer-Controlled Wallets, one transfer per attributed influencer
  • ›Shows the evidence - timeline, rationale, and payout status - in a single dashboard

## Attribution policy

The default policy is recency-weighted: per-click weight is 1 / (age_hours + 1), and per-creator shares are the normalized sum multiplied by the conversion amount. The fallback is last-click - the most recent eligible click wins 100%. Both policies persist a human-readable rationale JSON that the dashboard renders verbatim, so the math is never a black box.

## Live demo: click → attribution → instant payout

A deterministic demo scenario walks through the same APIs the dashboard uses: two creators earn a conversion with two recency-different clicks, the engine splits $0.20 USDC roughly 30/70, and both shares land on Arc Testnet as independent Circle transactions - each verifiable on Arcscan.

## Stack

  • ›Next.js 15 (App Router) + TypeScript
  • ›SQLite via better-sqlite3 (file-based, zero setup)
  • ›Circle Developer-Controlled Wallets SDK on Arc Testnet
  • ›No auth, no background workers - single local process
meta.json
year
2026
status
Hackathon build (testnet)
tags
Stablecoin paymentsAttribution
gallery [4]
Proto-Circle - Instant Attribution & Micropayments Engine - figure 1Proto-Circle - Instant Attribution & Micropayments Engine - figure 2Proto-Circle - Instant Attribution & Micropayments Engine - figure 3Proto-Circle - Instant Attribution & Micropayments Engine - figure 4