CLASSIC ↗VIBE.MARKETV6 IMMUTABLE · R4

INTEGRATION FIELD GUIDE

BUILD WITH
THE PACK MACHINE.

TL;DR

Every pack is 100,000 units of its collection token. Buying moves real WETH into that token's public Uniswap V4 pool. Opening sells the pack lot back, locks the realized ETH, then reveals a fixed reward or a collectible card.

01

START WITH DISCOVERY

Never choose a graph by array order or schema alone. New launches use v6-robinhood-20260909-r4-odds on Robinhood (4663). Verify that exact runtime is not retired, then use its chain, manifest and addresses together. Existing packs keep the graph recorded in their identity, including r1 and r3.

curl https://vibechain.com/api/vibemarket2/runtime/versions

HTTP reads are projections, not transaction receipts. Financial writes are signed by the user's wallet and sent directly to Robinhood Chain. There is no custodial REST endpoint for create, buy, sell, or open.

02

READ API

GET/api/vibemarket2/runtime/versionsDiscover graphs. New launches use v6-robinhood-20260909-r4-odds on chain 4663; existing packs keep their original graph.
GET/api/vibemarket2/runtime/{runtimeId}/healthIndexer and entropy-keeper readiness. Require ready: true before opening.
GET/api/vibemarket2/runtime/{runtimeId}/markets?limit=50Paginated V2.1 packs. Pass the returned before cursor unchanged.
GET/api/vibemarket2/runtime/{runtimeId}/markets/{dropId}One pack, its token, pool, odds, inventory, and opening totals.
GET/api/vibemarket2/runtime/{runtimeId}/board?resource=quoteBuy&dropId={dropId}&packs=1A one-to-ten pack buy quote in ETH.
GET/api/vibemarket2/runtime/{runtimeId}/sealed?owner={wallet}A wallet's sealed-pack balances.
GET/api/vibemarket2/runtime/{runtimeId}/claims?owner={wallet}Pending and revealed cash claims, including V2.1 funding state.
GET/api/vibemarket2/runtime/{runtimeId}/nfts?owner={wallet}Collected card NFTs owned by a wallet.
GET/api/vibemarket2/runtime/{runtimeId}/potShared reward assets, protected claims, free capital, and shortfall.
GET/api/vibemarket2/runtime/{runtimeId}/stream?topics=pot,market:{dropId}SSE invalidations. Re-read the affected bounded endpoint after an event.
03

WALLET CALLS

Quote immediately before the write, keep exact amounts as integers, simulate the exact call from the connected account, then wait for a successful receipt.

CREATEfactory.create(name, symbol, baseURI)

Gas only. V6 fixes the launch amount and odds in the factory manifest; creators supply metadata, not prices or odds.

CREATOR PREBUY · R4factory.createAndBuySealed(name, symbol, baseURI, count, maxEthIn, deadline)

Optional 1–100 sealed packs at the normal pool price. Send maxEthIn; unused ETH is refunded. Launch and purchase revert together on failure.

BUY + STASHmarket.buySealed(dropId, count, maxEthIn, deadline)

Send maxEthIn as value. The unused amount is refunded.

BUY + OPENmarket.buyAndOpen(dropId, count, maxEthIn, 0, deadline)

Send maxEthIn plus entropy.fee(). The V2.1 reserve argument is always zero.

OPEN STASHEDmarket.openSealed(dropId, count, 0, minOpeningProceeds, deadline)

Send entropy.fee(). The opening sells one 100,000-token lot per pack.

SELL STASHEDmarket.sellSealed(dropId, count, minProceeds, deadline, recipient)

Returns the pool's WETH proceeds as native ETH.

REVEALmarket.resolve(pullId)

Permissionless after entropy is ready. The keeper normally resolves first.

SELL CARDmarket.sell(cardId, minSaleProceeds, minPayout, deadline, recipient)

Pays the fixed, fully funded revealed reward.

KEEP CARDmarket.collect(cardId, minSaleProceeds, minCreatorPayout, deadline, nftRecipient)

R4: mints the NFT; 70% credits the creator and 30% remains in the pot. Earlier graphs retain 90/10.

04

CREATE METADATA

The official Studio publishes creator-signed metadata before calling the factory. External integrations can provide durable HTTPS metadata. Read the selected factory's manifest() and simulate create(name, symbol, baseURI) without sending ETH.

V6 does not accept creator-selected monetary odds, an ETH/USD reference, or a launch price. Do not use older multipart preparation parameters as V6 factory arguments. Metadata publication alone does not launch a pack; confirm the factory's successful receipt.

05

RULES THAT MATTER

  • 1–10 packs per buy/open call; one pack is 100,000 tokens with 18 decimals.
  • 2% pool fee on the buy and on the opening sale.
  • At reveal, the contract records the exact reward. If it is not fully funded, the amount stays fixed but cannot be sold or collected yet.
  • Sell pays the player. Collect mints the NFT. R4 credits 70% to the creator and retains 30% in the shared pot; older packs retain 90/10.
  • R4 has no collection count cap or expiry. Mint strictly before three days after onchain creation for a permanent isFirstEdition(tokenId) flag. Mints at or after that boundary remain available as standard editions. Opening early does not reserve an edition.
  • R3 retains its 500-card / seven-day collection window; r1 retains 300 cards / seven days. Ordinary buys, opens and sealed sells remain capped at 10 per call.
  • After a mined write, wait until runtime health has indexed past the receipt block before presenting the new state.