DAOMembershipNFT

📋 Contract Overview

Property	Value
📁 File	src/DAOMembershipNFT.sol
🔧 Type	Non-Upgradeable Soul-Bound ERC-721
⚙️ Solidity	0.8.33
📜 License	MIT

🎯 Purpose: Identity and rank representation for Built By DAO members—a soul-bound NFT that tracks membership level within the 14-rank system.

---

⚙️ Specifications

⚙️ Technical Specifications

Property	Value
📜 Token Standard	ERC-721 (soul-bound)
🔄 Upgradeable	❌ No
📛 Name	"Built By DAO Membership"
📛 Symbol	"BLTBYMEMBER"
🔗 Transferable	❌ No

Inherits From

• ERC721 (OpenZeppelin)

• AccessControl (OpenZeppelin)

• ReentrancyGuard (OpenZeppelin)

🔐 Roles

🎯 Purpose

---

📊 Rank Token IDs

🏅 Core Ranks

🏅 14-Level Rank System

Level	Rank	Token ID
1A	🌱 Seeker	10
1B	🌿 Apprentice	15
2	🛠️ Contributor	20
3A	⚙️ Operator	30
3B	🔧 Specialist	35
4	👷 Crew Lead	40
5	📋 Project Lead	50
6	🧭 Guide	60
7	👥 Community Lead	70
8A	⚓ Anchor	80
8B	🖥️ Platform Lead	85
9A	🛡️ Guardian	90
9B	📈 Strategist	91
10	🏛️ Steward	92

⭐ Special Ranks

🎖️ Tier Permissions

---

🔧 Functions

🔧 Minting

🔧 Mint Membership

function mint(address to, uint256 rank) external

Access: PROMOTER_ROLE or appropriate tier role

Mints membership NFT at specified rank. New members typically start at Seeker (10).

Requirements:

• Valid rank token ID

• Recipient not already a member

• Caller has appropriate tier role

⬆️ Promotion

⬇️ Demotion

🔥 Burning

👁️ View

---

🔗 Transfer Restrictions

Membership NFTs are soul-bound. Normal transfers are blocked.

function _update(address to, uint256 tokenId, address auth) internal override {
    address from = _ownerOf(tokenId);
    if (from == address(0)) return super._update(to, tokenId, auth); // Mint OK
    if (to == address(0)) return super._update(to, tokenId, auth);   // Burn OK
    if (whitelistedAddresses[to]) return super._update(to, tokenId, auth); // Emergency
    revert TransferNotAllowed();
}

Allowed Operations

Operation	Allowed	Use Case
🔧 Minting	✅	New membership
🔥 Burning	✅	Membership removal
🚨 Emergency transfer	✅	To whitelisted addresses only
🔄 Normal transfer	❌	Blocked

---

📜 Events

event MembershipMinted(address indexed member, uint256 rank);
event MemberPromoted(address indexed member, uint256 oldRank, uint256 newRank);
event MemberDemoted(address indexed member, uint256 oldRank, uint256 newRank);
event MembershipBurned(address indexed member, uint256 rank);
event WhitelistUpdated(address indexed addr, bool status);

---

🔗 Contract Interactions

Contract	Interaction
🗳️ RankVotingWeightRegistry	Provides rank-based voting weight
⚖️ Governance	Checks membership for voting eligibility
🔐 AccessControlContract	Checks rank for tiered access
📋 All DAO contracts	May verify membership

---

💻 Integration Examples

Checking Membership

const isMember = await membershipNFT.isMember(userAddress);
const rank = await membershipNFT.getRank(userAddress);

Minting New Member

// Called by authorized onboarding system
await membershipNFT.mint(newMemberAddress, 10); // Seeker rank

Promoting Member

// Called by appropriate promoter role
await membershipNFT.promote(memberAddress, 20); // To Contributor

---

🔗 Related Pages

https://github.com/urbanarray/builtbydocs/blob/main/docs/developers/contracts/voting-registry.mdGovernanceAll Rankshttps://github.com/urbanarray/builtbydocs/blob/main/docs/membership/onboarding.md