Solana Avatars

Solana Avatars is a decentralized identity system for the metaverse.
🚀 Try it live on Devnet — mint your own 3D Web3 avatar NFT and explore!

---

🧠 Overview

Solana Avatars enables users to create persistent, customizable identities for use across decentralized applications and virtual worlds. It combines two core smart contracts to power a flexible, user-centric avatar system:

• 🪪 Profile Contract — Acts as your Web3 passport, storing identity data such as usernames, bios, and chosen avatar NFTs on-chain via PDAs (Program Derived Addresses).
• 🛠 Avatar Minter Contract — Allows creators to deploy NFT avatar collections with configurable fees and total supply, enabling others to mint and use them in metaverses.

Creators earn rewards from minting fees (UI for claiming is coming soon).

---

⚙️ How It Works

1. Create Your Profile — Set up your Web3 passport with a username, description, and linked avatar NFT.
2. Deploy or Mint Avatars — Use the Minter UI to publish collections or mint from existing ones.
3. Explore the Metaverse — Represent yourself anywhere in the decentralized world using your 3D avatar.

---

✨ Features

• 🔐 Store on-chain user identities with Program Derived Addresses (PDAs)
• 🎭 Attach metadata: usernames, descriptions, and IPFS links to 2D/3D avatars
• 🧬 Customize avatars using NFT ownership
• 🌐 Seamlessly integrate identity across Web3 and metaverse platforms

---

🖼 Frontend Interface

We built a full-featured UI using Remix located in ./app. The interface allows users to:

• Mint their 3D avatar NFTs directly from the browser
• Create and update their Web3 profile (username, bio, avatar NFT)
• Dynamically manage and switch on-chain identities
• Deploy their own NFT avatar collections
• Set mint price and supply
• Mint avatars via UI for personal use

This intuitive interface lowers the barrier for both users and creators to participate in Web3 identity creation.

Try it with these sample models or use your own!

---

🧱 Smart Contracts

• avatar: Stores user data and links to avatar NFTs
• minter: Enables publishing and minting of NFT-based avatars

---

🔐 Mainnet Protocol Standard

The protocol now follows the security standard below for production releases:

1. Non-inflationary minting

   • Each NFT mint is created with decimals = 0.
   • After successful mint + metadata creation, both mint_authority and freeze_authority are revoked (None).
   • This prevents post-mint inflation and unilateral token freezing.

2. Canonical metadata integrity

   • The metadata account must be the canonical Metaplex PDA derived from the mint.
   • The mint URI must match the avatar hash policy (stored in AvatarData), preventing arbitrary metadata substitution.

3. Escrowed fee accounting

   • Mint fees are transferred atomically during minting.
   • total_unclaimed_fees is updated with checked arithmetic.
   • Fee claims are restricted to the avatar creator and validated against escrow balance.

4. On-chain avatar ownership proof for profiles

   • Profile creation and avatar updates require proof that the profile owner holds the selected avatar mint in their token account.
   • This prevents attaching arbitrary third-party mints to a profile.

5. PDA-scoped access control

   • All mutable state uses deterministic PDA seeds with signer checks and ownership constraints.
   • Profile updates/deletes are owner-only, and fee claims are creator-only.

6. Release gate requirements

   • Security tests must include negative paths (unauthorized access, URI mismatch, post-mint inflation attempts).
   • Mainnet deployments require passing contract + SDK integration tests.

---

🔧 Commands

Switch between networks

# Localnet
solana config set --url http://127.0.0.1:8899

# Devnet
solana config set --url https://api.devnet.solana.com

Generate and use a custom keypair for deployment

solana-keygen new --outfile target-deploy-keypair.json
solana-keygen pubkey target-deploy-keypair.json

---

📬 Feedback

We welcome issues, contributions, and feature suggestions. Let's build the future of identity together!