Boneyard Docs

Boneyard is a performance-based growth marketplace. Projects escrow rewards for the onchain activity they need — swaps, deposits, volume, mints, transfers, sign-ups, bridges, liquidity — and promoters earn from that escrow by referring users who produce it.

Boney, the protocol underneath, handles attribution, KPI verification and reward settlement. Instead of paying for attention and guessing what converted, a project pays for measured outcomes.

A project escrows a reward pool and defines one or more KPIs — the outcomes it will pay for. Each KPI carries a ladder of tiers: thresholds that release progressively larger rewards as a promoter clears them. Nothing pays out on promises; rewards move only as verified milestones are met.

A campaign cannot be activated until the escrow vault actually holds the reward tokens, which is why funding is a distinct step from creation.

A campaign moves through Pending → Active → Ended, with Paused and Cancelled as off-ramps. Each transition is guarded on chain.

Create

Define the token, pool, window, KPIs, and minimum promoter BoneyScore.

Fund

Transfer the reward pool into the escrow vault.

Activate

Open the campaign to promoters.

End

Close the campaign. Opens the settlement grace window.

Reclaim

After the grace window closes, the project withdraws whatever escrow was never earned.

Promoting a campaign mints a promoter id— a hash binding the promoter’s address to that specific campaign. The id is the subject of every attribution and payout, and it is campaign-scoped by construction.

Campaigns may set a minimum BoneyScore, which combines two attested signals: Ethos credibility, reflecting vouches and reviews from other people, and social reach. Credibility counts for the most — followers are purchasable, vouches are not.

Verifying reads both figures and records them through the protocol’s attestation registry, so a campaign can require a track record without the project vetting anyone by hand. A claimed Ethos profile is required: Ethos returns a baseline score for any address it has never seen, and accepting those would let a freshly generated wallet clear a gate it never earned.

BoneyScore is powered by the Ethos credibility score, read alongside social reach.

Ethos

Attested credibility: vouches and reviews from other people.

Reach

Follower count, on a curve that flattens as an audience grows.

A rank is a band of the score, so read a badge as a statement about score rather than about character: a large audience can carry modest credibility several bands up. The reach-only ranks are the ones an account with no credibility at all can hold.

Both accounts hold a claimed Ethos profile, so both scores are ones the protocol would issue. Figures were read from Ethos and X in August 2026 and will have moved since — they illustrate rather than track.

frankdegods has 19.7× the audience and still scores lower. Vouches outweigh followers, which is the whole point of the gate.

The ranks are the caveat. Credibility alone would place the account in Runner, a reach-only band; its audience carries it up to Samurai. Nothing is wrong with the score, but a project reading that rank as exemplary standing has misread it.

The gate is immutable once the campaign is created and cannot be lowered afterwards, so a number chosen carelessly is a campaign nobody can promote. Two figures bracket the useful range:

8,400

The most an account with zero credibility can score, with a maximum audience. A gate at or below this is clearable on follower count alone: it looks like a credibility filter and is not one.

19,600

The most an account can score on perfect credibility with no audience. Above this, a promoter needs maximum Ethos and a large following at once, which is nearly nobody.

Set the gate between them. 12,601 — the Ronin floor — is a sound default: it takes reputable standing, or weaker standing carried by a genuine audience, and it is where the cost of each additional sybil wallet starts to bite, since every one needs its own claimed Ethos profile and X account. Promoters see ranks, so a rank floor reads better than a round number.

One threshold cannot separate trust from audience: an untrusted account with a large following and a neutral account with a small one can land at the same score. If credibility is the point, set the gate above 8,400 — clear of every reach-only rank.

Scores also expire. An attestation stops counting once it ages past its schema’s freshness window, because credibility is not constant — an Ethos score moves with vouches and slashing, and a follower count moves when an account changes hands. A promoter who qualified for a campaign last year may not qualify today until they re-verify.

Each promoter gets a boney link carrying the campaign address and their promoter id. A referral — someone who arrives through that link — signs a Touch: a message their wallet displays in full, stating that they were referred by that promoter.

The chain accepts a touch only when the signature recovers to the referral’s own address, so a promoter cannot claim someone who never signed. A touch expires after the campaign’s attribution window, and a fresher touch from another promoter replaces an older one, so credit reflects the most recent referral rather than the first.

When a promoter’s progress is reported, settlement happens inline: any tiers newly cleared transfer to the promoter’s wallet in the same transaction.

After a campaign ends, a grace window holds the remaining pool while any final progress is reported and settled. The project’s reclaim right opens only once that window closes, so unspent funds cannot be pulled out from under a tier that is still settling.