Building a v4 hook? Four house hooks already earn on every swap: volatility fee, anti-snipe, agent rebate and weekend gap guard.Read the protocol.Building a v4 hook? Four house hooks already earn on every swap: volatility fee, anti-snipe, agent rebate and weekend gap guard.Read the protocol.
v4 Marketplace docs

Build on v4 Marketplace

Back a v4 hook

Stake $V4M behind a listed v4 hook and earn the backer share of its author royalties, up to 30%, split by stake.

hook #10, Flat fee: the author's part of each royalty, split by its vault
70% author, paid at each payout
30% backers, by stake
stake $V4M in the vault
earns from the next payout
distribute(currency), anyone
claims vested royalties, pays the author
unstake: stops earning at once
withdraw after 7 days

How it works

A hook listed with backing has its own vault, a BackedSplit contract, as its author in Storefronts and the royalty ledger. The vault receives the author's 80% of each royalty after the usual 7 days of vesting. Anyone can call distribute(currency): it claims what has vested, pays the author's part at once and credits the backer share to backers in proportion to their stake. Backers claim with claimRewards(currency), in the pool's tokens.

On Back a v4 hook or on a hook page under Back this hook, approve $V4M to the vault and stake. The page shows your share of the backers' part before you sign.

Rules

Backer share0 to 3,000 bps (30%) of the author's royalties, set by the author
Share changesa raise applies at once, a cut 7 days later, so backers see it coming
UnstakerequestUnstake(amount) stops earning at once; withdraw() after 7 days
Rewardsaccrue per currency from each distribution, by stake at that moment
Author actionsroyalty, listing stake and the hand-over to a new author go through the vault, author only

Listing with backing

In Build a v4 hook, turn on Let people back it at the listing step and pick the share. The hook is listed through the HookBacking registry 0xD216CDfB6CaD325BCdF9a5d3BA6c5A686efB1599 with listBacked, which deploys the vault and lists the hook from it. The 10,000 $V4M listing stake then goes in from your wallet with Storefronts.stake(hookId, amount). Backing cannot be combined with co-authors yet.

First backed hook

Hook #10, Flat fee, one fixed fee per pool (0.30% by default, set when it is stacked), is a house hook listed with a 30% backer share. Vault 0x3E7A7ad7ae7C30899a20b3E014b5Eb084Af34A7f. The first backing stake was 500 $V4M.

API, MCP, SDK

curl https://v4market.com/api/backing            # every backed hook
curl https://v4market.com/api/backing?hook=10    # one hook

const tx = await v4market.backHookTx(10, 1000);  // { approve, stake, ifYouStake }

The MCP tool is back_hook and the SDK methods backing() and backHookTx().