Provenance Playbooks
Create branching story games with verifiable original story assets minted onchain.
IPFS via Pinata· decentralized storage
Section · Onchain
full primer →The primitive.
Every game narrative design artifact is pinned to IPFS through Pinata; game designers get a permanent CID and a public gateway preview instead of a fragile cloud URL.
Why this primitivePinning the payload to IPFS via Pinata gives a permanent CID; the CID's hash gets anchored to Bitcoin testnet4 so the storage layer is verifiable.
Kernel
a Pinata JWT upload that pins images / JSON / manifests to IPFS and returns a permanent CID — the payload behind every OP_RETURN hash and inscription
Drives the UI as
a 'pinned to IPFS' chip with the CID and an ipfs.io gateway preview
Required keys.
PRIVY_APP_ID
Privy dashboard → your app. Configure with chainType 'spark' to mint Bitcoin L2 wallets on sign-in.
open ↗PRIVY_APP_SECRET
Server-side. Required for the merchant Spark wallet to observe incoming sats transfers via the Privy RPC.
open ↗Add these in your Lovable project under Settings → Secrets before pasting the prompt below.
Appendix · Mega-prompt
The build prompt.
self-contained
Paste into a fresh Lovable project — it carries its own feature spec, code, setup and checklist. read the build strategy →
loading the build spec…
Market sizing.
TAM
$3B
narrative-driven game market
SAM
$500M
indie narrative game developers
SOM
$50M
studios adopting blockchain for storytelling
Indicative figures for hackathon pitches — refine with your own research before raising.
Adjacent entries.
virtual galleries
Sponsored XR Exhibits
Host XR galleries that visitors explore with gasless wallet login and sponsored interaction tx.
player economiesPrivy Crafting Market
Trade crafted game items with gasless wallet sign-in and sponsored trades.
viewer incentivesGasless Streaming Rewards
Reward game stream viewers with gas-free wallet transactions sponsored by creators.
community engagementSponsored Fan Tokens
Issue fan engagement tokens to gamers using gasless wallet onboarding and sponsored mints.