Publishing Your Mod
Once your mod is deployed, publish it to the Mod Market so totem creators can discover and license it.
Mod Details
When publishing, you provide metadata that helps creators understand your mod:
struct ModDetails {
string name; // Display name (3-100 characters)
string summary; // Short description for listings (10-150 characters)
string markdown; // Full description (supports markdown)
string image; // Image URL or IPFS hash
string website; // Your website URL
string websiteTickerPath; // Path template - example: `/totems/{ticker}`
bool isMinter; // Whether this mod is a token minter
bool needsUnlimited; // Whether minter needs unlimited supply access
} Important
Your websiteTickerPath should use {ticker} as a placeholder that gets replaced with the totem’s ticker symbol,
but should not include the full URL. The base URL is provided by the website field.
Writing Good Descriptions
Your summary appears in search results and mod listings. Keep it concise and highlight the key benefit:
“Freeze transfers with a single toggle - perfect for launches and emergencies”
Your markdown description supports full markdown formatting and can include feature lists, usage instructions, configuration options, and links to documentation.
Hooks
You select which hooks your mod implements.
Only select hooks your contract actually implements. The market will not call your mod hooks to verify this for you, and if a totem uses your mod and the hook is missing, it will brick the totem!
Minter Settings
The isMinter and needsUnlimited fields in ModDetails control minter behavior:
- isMinter - Set
trueif your mod implementsIModMinterand has amint()function that distributes tokens - needsUnlimited - Set
trueif your minter creates new supply rather than distributing from an allocation
Warning
Unlimited minters display prominent warnings to users and cannot be added via Proxy Mod after totem creation. Only enable this if your mod truly needs to mint beyond allocated supply.
Pricing
The price is what totem creators pay to license your mod. Consider:
- Free mods - Great for building reputation and adoption
- One-time fee - Creators pay once when adding your mod to their totem
You can update your price anytime after publishing.
After Publishing
Once published, your mod appears in the marketplace. You receive the entire license fee whenever a creator licenses your mod.
You can update your mod’s price and details anytime. The contract address cannot be changed, if you need to deploy a new version, publish it as a new mod.