- Register a music album as an IP collection
- Register a music track as an IP asset
This quickstart is under development as new features are added to the Story Protocol daily.
Preparation Steps
1
Create a Developer Account and Project
To get started, create a developer account in the Crossmint Staging Console. Open that link, sign in, and accept the dialog to continue.
Crossmint offers two consoles: staging, for development and testing, and
production.
2
Get an API Key
Create a server-side API key with these scopes:
collection.create
,
collection.update
,
collection.read
,
nfts.create
,
nfts.read
.This allows your API key to perform any kind of asset registration action.Register Music Album
1
Create an IP Collection
Register Song
1
Create a Song
Go to Suno, a music platform for AI-generated music, to create a song:
- Input a prompt to create a song
- Click on the final result to get the song’s URL (i.e.
https://suno.com/song/c001fd6e-d6cd-474f-a7b6-6e6a9b3e2515
) - Copy the song ID in the URL (i.e.
c001fd6e-d6cd-474f-a7b6-6e6a9b3e2515
) - Copy the following URL:
https://cdn1.suno.ai/${SONG_ID}.mp3
, making sure to replace SONG_ID with your own
2
Register Song on Story
Retrieve Your IP Asset
1
Get IP Asset Details
After registering your IP asset, you can retrieve its details to verify the information or display it in your application.Replace
{collectionId}
with your collection ID and {ipAssetId}
with the IP asset ID returned when you registered the asset. Then run the script:Confirm Song Registration
1
Get Action Status
You can easily check the IP asset registration status to ensure the action has completed before proceeding.Use the action ID returned in any of the previous steps and run the script: