Quickstart
Start building on Story quickly.
You want to start building on Story quickly... so let's get started!
Looking to read up on Story first?
If you'd like to read up on Story before diving into the technical details, check out our awesome Learn Hub which will explain the who, what, and why of Story.
App Developers
If you want to deploy an app using Story, this section is for you.
Skip everything. Go to the code.
If you want to skip everything and go right to coding, we have 2 clone-able quickstarts for you to check out. You can clone these directly and follow the associated READMEs.
🛠️ TypeScript SDK Node.js Example ▶️ Here
⚛️ React SDK Next.js Example ▶️ Here
🏗️ Story Network Infra
The Story Network Guide provides all RPC, explorer, and faucet info.
💻 Use our SDKs
We have built 2 SDKs, all with their own in-depth tutorials for popular functions and use cases:
🌐 Use our API
Check out the entire API Reference for learning how to use our API.
📝 Register IP on Story
Let's start with the most basic question: "What does it take to register IP on Story in my app? How do I do this?"
To register IP on Story, you'll first need an NFT. If your IP is an ERC-721 NFT (ex. an Azuki or Pudgy Penguin on Story), you're already set. If not, you must mint an NFT to represent your off-chain IP. And don't worry, we'll help you do this.
Next you'd register that NFT on Story, ultimately creating an 🧩 IP Asset. An "IP Asset" is your IP registered on Story, empowered by:
- all of Story's 🧱 Modules like transparent licensing, automatic royalty payments, and disputing of wrongfully registered IP
- IP protection through the 💊 Programmable IP License (PIL)
To actually do this in code, our SDK tutorials will show you exactly how to do these things:
Difference Between IP Metadata vs. NFT Metadata
A common question we get from developers while registering their IP on Story is: "What metadata should be/is expected to be attached to the NFT, and then separately, the IP Asset?"
To answer that question, please see NFT vs. IP Metadata.
📜 Licensing Your IP
You may be wondering, "How do I take advantage of Story's on-chain licensing? How do I make sure my registered IP has a license ready to go?"
Before you attach any sort of licenses or license terms to your 🧩 IP Asset, it would be best to first understand what the 💊 Programmable IP License (PIL) actually is. This "PIL" is what defines the available License Terms on Story, which in turn - when attached to an IP Asset - is what defines how others can use (commercially, create derivatives, etc) that IP Asset.
Our SDK tutorials will show you exactly how to attach license terms to your IP Asset:
Learn More
For more information on licensing and the terminology behind it, check out the 📜 Licensing Module.
💸 Royalties / Revenue Sharing
Now you may be wondering, "How do I set up automatic royalty sharing between my IP Asset and someone else's? How do I then collect that payment?"
When you attach License Terms to your 🧩 IP Asset, you can specify certain commercial terms such as commercialRevShare, which is the amount of revenue (from any source, original & derivative) that must be shared by derivative works with the original IP. See the above section for licensing questions.
If someone then creates a derivative of my IP Asset - which has a commercialRevShare of let's say 10% in its license terms - and earns revenue on it, Story automatically handles the upstream revenue share. If the derivative work earns 100 $USDC, my original IP Asset could claim 10 $USDC.
Our SDK tutorials will show you exactly how to claim revenue:
Learn More
For more information on royalty and how it functions, check out the 💸 Royalty Module.
Smart Contract Developers
Warning: In Progress
For now, see the Smart Contracts section.
Updated 6 days ago