AngelNFT

📋 Contract Overview

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

🎯 Purpose: Soul-bound NFTs for Angel-tier investors ($10,000 - $250,000), unlocking governance participation and investor benefits.

---

💰 Investment Tier

💰 Angel Tier Details

Attribute	Value
💵 Investment Range	$10,000 - $250,000
🗳️ Governance Multiplier	1.5× - 3.0×
🆔 Token ID Range	1000 - 9999
📊 Max Supply	Unlimited

⚙️ Specifications

🔐 Roles

---

📊 Subtier System

Angel investments are divided into 5 subtiers with increasing governance power.

Subtier	Investment Range	Governance Multiplier
👼 Angel 1	$10,000 - $25,000	1.5×
👼 Angel 2	$25,001 - $50,000	1.8×
👼 Angel 3	$50,001 - $100,000	2.2×
👼 Angel 4	$100,001 - $175,000	2.6×
👼 Angel 5	$175,001 - $250,000	3.0×

All investor multipliers are capped at 5× maximum by the Governance contract.

---

🔧 Functions

🔧 Minting

🔧 Mint Angel NFT

function mint(
    address to,
    uint256 investmentAmountUSD,
    uint8 subtier
) external onlyRole(MINTER_ROLE) returns (uint256)

Access: MINTER_ROLE (InvestorMintContract only)

Parameters:

• to - Recipient wallet address

• investmentAmountUSD - Investment amount in USD (6 decimals)

• subtier - Subtier level (1-5)

Requirements:

• Investment amount within Angel tier range

• Subtier matches investment amount

• Recipient not already holding Angel NFT

⬆️ Upgrade

👁️ View

---

🔗 Soul-Bound Implementation

Angel NFTs cannot be transferred—ensuring investment status stays with original investor.

function _beforeTokenTransfer(
    address from,
    address to,
    uint256 tokenId,
    uint256 batchSize
) internal virtual override {
    // Only allow minting (from = 0) and burning (to = 0)
    if (from != address(0) && to != address(0)) {
        revert SoulBoundToken();
    }
    super._beforeTokenTransfer(from, to, tokenId, batchSize);
}

Soul-Bound Benefits

Concern	Solution
🛡️ Investment fraud	NFT proves investment
🗳️ Governance attacks	Can't buy governance power
👥 Sybil attacks	One NFT per investor
📈 Market manipulation	No secondary market

---

🖼️ Token Metadata

{
    "name": "Built By DAO Angel Investor #1234",
    "description": "Angel-tier investor in Built By DAO",
    "image": "ipfs://[hash]/angel-[subtier].png",
    "attributes": [
        { "trait_type": "Tier", "value": "Angel" },
        { "trait_type": "Subtier", "value": "3" },
        { "trait_type": "Investment Date", "display_type": "date", "value": 1704067200 },
        { "trait_type": "Governance Multiplier", "value": "2.2x" }
    ]
}

---

📜 Events & Errors

📢 Events

event AngelMinted(
    address indexed investor,
    uint256 indexed tokenId,
    uint256 investmentAmount,
    uint8 subtier
);
event SubtierUpgraded(
    uint256 indexed tokenId,
    uint8 oldSubtier,
    uint8 newSubtier
);
event BaseURIUpdated(string newBaseURI);

⛔ Errors

---

💰 Investment Flow

1. Investor completes KYC
2. Investor sends funds to InvestorMintContract
3. InvestorMintContract calls AngelNFT.mint()
4. NFT issued to investor wallet
5. BLTBY tokens vested according to schedule
6. Governance multiplier active immediately

---

🔗 Contract Interactions

Contract	Interaction
🔧 InvestorMintContract	Calls mint after investment
⚖️ Governance	Reads multiplier for voting power
🏦 Treasury	Investment proceeds deposited
🪙 BLTBYToken	Token allocation tied to investment

---

💻 Integration Examples

Checking Investment Status

const hasAngel = await angelNFT.balanceOf(investorAddress) > 0;
const tokenId = await angelNFT.tokenOfOwnerByIndex(investorAddress, 0);
const details = await angelNFT.getInvestmentDetails(tokenId);

Getting Governance Multiplier

const multiplier = await angelNFT.getGovernanceMultiplier(tokenId);
// Returns basis points: 22000 = 2.2×

---

🔗 Related Pages

VentureOneNFTTrustNFTInvestorMintContractGovernanceInvestment Tiers