Open-Source TraitSwap & LootBox Template for Algorand NFT Projects

We have built and open-sourced a production-ready, white-label template that gives any Algorand NFT project two powerful utilities: trait swapping and a loot box system.

Trait Swapping (ARC-19)

Holders can browse available traits, preview them on their NFT, and apply them with a single transaction. The system composites layered trait images, uploads to IPFS via Pinata, and updates on-chain metadata via an asset config transaction — all server-side, so the user only signs one payment. Projects configure their own trait catalog, pricing, and layer structure.

Loot Box (Commit-Reveal + VRF)

A commit-reveal system with verifiable on-chain randomness. The TEALScript smart contract uses a PCG32 RNG (based on Giorgio Ciotti's open-source lib-pcg-avm) seeded by Algorand's VRF beacon. Users pay, commit a round, wait 8+ rounds, then reveal — the contract derives a verifiable random value for weighted prize selection. Projects configure prize tiers, weights, and rarities; prizes (fungible tokens and unique NFTs) are distributed automatically from a server-side master wallet.

White-Label & Ready to Deploy

All configuration is centralized — collection addresses, trait definitions, prize tiers, site branding — so any project can swap in their assets and deploy without touching core logic. Supports Pera, Defly, and Lute wallets. Built on Next.js 14. Includes preview modes for safe testing before going live.

Admin Panel

Wallet-signature authenticated admin panel (no passwords) for prize configuration, treasury and master wallet balances, ASA opt-in, and prize pool inventory.

Why this matters for Algorand

Trait swapping and loot boxes are proven engagement and revenue tools, but building them from scratch requires deep knowledge of ARC-19 updates, IPFS pinning, commit-reveal patterns, VRF randomness, and server-side wallet management. This template packages all of that into a documented, deployable starting point — lowering the barrier for every NFT project on Algorand.

A key part of the MONSTRS model is reinvesting 50% of all loot box fees back into the Algorand NFT community by purchasing NFTs from other projects. Open-sourcing this template means any project can adopt the same flywheel — more loot boxes across the ecosystem means more revenue flowing back to NFT artists and builders.

Technical details of what's included:

• ARC-19 trait swapping: layered image composition, IPFS upload via Pinata, reserve address computation from CID, asset config transaction signed by server-side manager wallet.
• Commit-reveal loot box: TEALScript smart contract using PCG32 randomness (based on lib-pcg-avm by Giorgio Ciotti) seeded by Algorand's VRF beacon. Users commit, wait 8+ rounds, then reveal.
• Weighted random prize selection supporting fungible token prizes (repeatable) and unique NFT prizes (removed from pool when won). Automated distribution from server-side master wallet.
• Admin panel with wallet-signature authentication (challenge-response via signed zero-amount self-payment). Prize tier management, revenue dashboard, ASA opt-in, inventory inspection.
• Multi-wallet support for Pera, Defly, and Lute via @txnlab/use-wallet.
• Preview modes for both systems allowing safe development and testing without on-chain transactions.
• All sensitive operations (wallet signing, prize distribution, payment verification) run server-side. Mnemonics never exposed to client.
• Comprehensive README covering setup, environment variables, customization, smart contract deployment, architecture, security considerations, and production hardening.

Adoption Metrics

• 500+ traits swapped on MONSTRS (live 3 months)
• 1,000+ loot boxes opened by the community
• 100+ NFTs purchased from Algorand community creators through 50% fee reinvestment
• Multiple NFT project leads have directly requested access to similar tooling
• Live and verifiable at: https://monstrs.famverse.xyz