InvestorMintContract

📋 Contract Overview

Property	Value
📁 File	src/InvestorMintContract.sol
🔧 Type	Upgradeable UUPS Proxy
⚙️ Solidity	0.8.33
📜 License	MIT

🎯 Purpose: Single entry point for all investor onboarding—receiving funds, determining tier, minting NFTs, allocating BLTBY tokens, and setting up vesting schedules.

---

⚙️ Specifications

⚙️ Technical Specifications

Property	Value
🔄 Upgradeable	✅ Yes (UUPS Proxy)
🔐 Reentrancy	Protected
🔗 Oracles	Chainlink price feeds

Inherits From

• Initializable

• AccessControlUpgradeable

• ReentrancyGuardUpgradeable

• UUPSUpgradeable

🔐 Roles

💰 Tiers

🆔 KYC Levels

---

💰 Investment Flow

Investor → InvestorMintContract → [Validation] → [Tier Determination]
                                       ↓
                              [NFT Minting] → AngelNFT / VentureOneNFT / TrustNFT
                                       ↓
                              [Token Allocation] → BLTBYToken
                                       ↓
                              [Vesting Setup] → TokenVesting
                                       ↓
                              [Funds Transfer] → Treasury

---

🔧 Functions

💰 Invest

💰 Investment Processing

Invest with Token

function invest(
    address paymentToken,
    uint256 paymentAmount,
    uint8 preferredSubtier,
    bool requestAdvisory
) external nonReentrant returns (uint256 nftTokenId)

Access: Any KYC-approved address

Flow:

1. Verify KYC approval and level

2. Transfer payment from investor

3. Convert to USD value

4. Determine tier and subtier

5. Mint appropriate NFT

6. Allocate BLTBY tokens

7. Setup vesting schedule

8. Transfer funds to treasury

Invest with ETH

function investETH(
    uint8 preferredSubtier,
    bool requestAdvisory
) external payable nonReentrant returns (uint256 nftTokenId)

Same flow but accepts ETH directly.

⬆️ Upgrade

🆔 KYC

⚙️ Config

👁️ View

---

🪙 BLTBY Allocation

Higher tiers receive better allocation rates as incentive for larger investments.

Tier	Rate	Example ($100k)
👼 Angel	100 BLTBY/$1	10,000,000 BLTBY
💰 VentureOne	120 BLTBY/$1	12,000,000 BLTBY
🏛️ Trust	150 BLTBY/$1	15,000,000 BLTBY

---

⏱️ Vesting Schedules

Tier	Cliff	Vesting Period	Schedule
👼 Angel	3 months	12 months	Linear after cliff
💰 VentureOne	6 months	24 months	Linear after cliff
🏛️ Trust	6 months	36 months	Custom schedule

---

🏷️ Tier Determination

👼 Angel

Investment Range	Subtier
$10,000 - $25,000	1
$25,001 - $50,000	2
$50,001 - $100,000	3
$100,001 - $175,000	4
$175,001 - $250,000	5

💰 VentureOne

🏛️ Trust

---

📜 Events & Errors

📢 Events

event InvestmentReceived(
    address indexed investor,
    uint256 amountUSD,
    InvestorTier tier,
    uint8 subtier,
    uint256 nftTokenId
);
event InvestmentUpgraded(
    address indexed investor,
    uint256 additionalAmount,
    InvestorTier oldTier,
    InvestorTier newTier
);
event KYCApproved(address indexed investor, uint8 level);
event KYCRevoked(address indexed investor);
event TokenAllocated(
    address indexed investor,
    uint256 bltbyAmount,
    uint256 vestingPeriod
);

⛔ Errors

---

🔗 Contract Interactions

Contract	Interaction
👼 AngelNFT	Mints Angel NFTs
💰 VentureOneNFT	Mints VentureOne NFTs
🏛️ TrustNFT	Mints Trust NFTs
🪙 BLTBYToken	Allocates tokens
⏱️ TokenVesting	Sets up vesting
🏦 Treasury	Receives funds
🔗 Chainlink	Price feeds

---

🔒 Security Features

Protection	How It Works
🔐 Reentrancy guard	All investment functions protected
📊 Price oracle	Chainlink for accurate USD conversion
🔐 Multi-sig	Required for large investments
🆔 KYC verification	Required before investing

---

💻 Integration Examples

Processing Investment

// Approve USDC spending
await usdc.approve(investorMintContract.address, amount);

// Invest
const tx = await investorMintContract.invest(
    usdcAddress,
    parseUnits("100000", 6), // $100,000
    3, // Subtier 3
    false // No advisory
);

Checking Investment Preview

const details = await investorMintContract.calculateInvestmentDetails(
    parseUnits("100000", 6)
);
console.log(`Tier: ${details.tier}, BLTBY: ${details.bltbyAllocation}`);

---

🔗 Related Pages

AngelNFTVentureOneNFTTrustNFThttps://github.com/urbanarray/builtbydocs/blob/main/docs/developers/contracts/token-vesting.mdKYC & ComplianceInvestment Tiers