🏰 Ivan Tower NFT Collection (Ivan Asset)

A professional, production-ready ERC721 token implementation using the Foundry development framework and OpenZeppelin standards. A smart contract-based decentralized architecture designed to manage high-density architectural spaces across multiple specialized sector ecosystems on the Genesis Island.

---

📝 Overview

Ivan Tower represents a dynamic approach to virtual real estate within the Web3 ecosystem. The project currently features 3 fully deployed and active floors, with each floor accommodating up to 101 distinct units. Designed with future proofing and extreme scalability in mind, the architecture allows contract administrators to seamlessly expand the tower by adding new floors dynamically, without disrupting the existing ecosystem or on-chain state.

Each token represents a unique unit with customized metadata management, optimized using advanced Python generation scripts and standard JSON indexing for instant marketplace and multi-wallet rendering.

---

🚀 Technical Stack & Tools

• Language: Solidity ^0.8.20
• Framework: Foundry (Forge & Cast)
• Library: OpenZeppelin Contracts
• Storage Layer: IPFS (Pinata Pinning Service)
• Network: Polygon Amoy Testnet

---

✨ Key Features

• Dynamic Scalability: Currently features 3 active floors with modular logic to deploy additional floors in the future.

• Eco-Sector Metadata Partitioning: Mappings that partition active floors into specialized business sectors:

  • Floor 1: Technology & Decentralized Innovation Sector.
  • Floor 2: Digital Art & Virtual Entertainment Galleries.
  • Floor 3: DeFi & Decentralized Corporate Finance Hubs.

• Native Rental Engine: Built-in daily-rate utility allowing seamless unit rentals. Users can rent spaces for a specific duration securely on-chain.

• Security & Blacklist Mechanism: Robust compliance layer enabling administrators to blacklist malicious actors, instantly restricting them from transferring, minting, or interacting with tower assets.

• Architectural Differentiation: Automatically segregates and configures standard structural dimensions from high-value Penthouse layout types (Unit 101).

• On-Chain Rigidity: Rigorous input validation preventing out-of-bounds unit minting and strict admin-restricted access control.

---

📖 Smart Contract Logic & Metadata Indexing

🔒 Rental & Safety Workflows:

1. Rental Access: Users execute rentFloorUnit by streaming required native tokens. The contract locks occupancy and flags real-time status until rentalExpiresAt timestamp lapses.

2. Transfer Restraints (Blacklist): Every internal token transfer passes through an intensive verification check. If either the sender or the recipient is blacklisted, the transaction is immediately reverted.

📐 High-Efficiency Token Mechanics:

1. Admin Controlled Generation: Authorized system operators can mint explicit units across targeted floors using adminMintFloorUnit.

2. Formulaic Token Identification: Token IDs are structurally calculated using an mathematical layout formula: $$\text{Token ID} = (\text{Floor Number} \times 1000) + \text{Unit Number}$$ Examples: Token 1001 (Floor 1, Unit 1), Token 2001 (Floor 2, Unit 1), Token 3001 (Floor 3, Unit 1).

3. Optimized Token URI Resiliency: Resolves directly to distributed directories using standard native .json appending extensions to match explicit internal ledger states seamlessly.

---

🌐 Decentralized IPFS Resources

All programmatic property assets, dynamic visual concepts, and JSON metadata schemas are immutably distributed on the IPFS network:

• Contract Metadata (contractURI):

  • Protocol URI: ipfs://bafkreibsahqkdwjemwyi7q5c426h43lt6bn7blaymx4iucuftmtwjdowoq
  • Browser Link: View Global Contract Schema

• Floor 1 Metadata Directory (Technology): ipfs://bafybeibrxf6xdhcj5djdj6nggfi5gpg675doayarnmsqve3374kypdhdhq/

• Floor 2 Metadata Directory (Digital Art): ipfs://bafybeiasoxirmzwbezyvgemjk5xptox6t2kkb3b2og5atdse7kekmautku/

• Floor 3 Metadata Directory (DeFi Hub): ipfs://bafybeifhwuirhoihkqcg35yyfsqzbrnzjgbgau2elvugnfm6jm74igmjry/

---

🚀 Live Deployment (Amoy Testnet)

The contract has been officially deployed, verified, and thoroughly live-tested on the Polygon Amoy Network.

• Contract Address: 0xCf00774d5494f28f62021fb00753e3a36f3364e9
• Name: Ivan Tower
• Symbol: IVNT
• Network: Polygon Amoy (Chain ID: 80002)
• Verified Explorer Contract: Click here to view on PolygonScan ✅

---

🧪 Testing & Quality Assurance

Security, gas optimization, and logic assertions are guaranteed via Foundry's testing environment.

Run Test Executions:

forge test -vvvv

---

Installation & Usage

Prerequisites

• Foundry

curl -L https://foundry.paradigm.xyz | bash && foundryup

---

Clone & Build

git  clone https://github.com/alinasirlou2020/Ivan_Tower.git

cd  Ivan_Tower

forge  install

forge  build

---

📜 Deployment Script

The deployment is handled via Solidity scripts for idempotency and security.

forge script script/DeployMiddleTower.s.sol --rpc-url $AMOY_RPC_URL --private-key $PRIVATE_KEY --broadcast --verify

---

📜 License

This project is licensed under the MIT License.

Author

Ali Nasirlou

Github : alinasirlou2020 Linkedin : Ali Nasirlou