This documentation provides a comprehensive guide to Decentraland's smart contract ecosystem and technical infrastructure. Whether you're a developer building on Decentraland, a creator designing wearables, or a user wanting to understand the underlying technology, this documentation will help you navigate the decentralized virtual world's blockchain foundation.
Decentraland is a decentralized virtual world powered by the Ethereum blockchain. Users can create, experience, and monetize content and applications. The virtual world is divided into parcels of LAND, permanently owned digital real estate that users can build upon.
The native cryptocurrency that powers all economic transactions in Decentraland, from purchasing LAND to buying wearables and names.
Virtual parcels represented as NFTs, each with unique coordinates in the world. Estates group multiple parcels for unified management.
Digital fashion and items for avatar customization, managed through a sophisticated collection system with rarity tiers.
Evolution from on-chain order books to efficient signature-based trading, supporting various asset types and trade formats.
System allowing LAND owners to lease their properties while maintaining ownership, enabling a vibrant builder economy.
Start with the Smart Contracts Overview to understand the architecture, then dive into specific contracts based on your integration needs.
Learn about MANA Token for understanding transactions, and LAND Registry for property ownership.
Explore the Wearables System to understand how to create and manage digital collectibles.
π Documentation
βββ ποΈ Foundation Layer
β βββ ERC721 Standard Implementation
β βββ MANA Token Economics
βββ π Virtual World Infrastructure
β βββ LAND Registry System
β βββ District Management
βββ π¨ Digital Assets
β βββ Wearables & Collections
βββ π° Economic Systems
β βββ Marketplace Evolution
β βββ Rental Mechanisms
βββ π§ Supporting Infrastructure
βββ Vesting Systems
βββ Administrative Tools
- True ownership of digital assets via NFTs
- No central authority can revoke ownership
- Transparent on-chain records
- Cross-chain bridges (Ethereum β Polygon)
- Standard interfaces (ERC20, ERC721)
- Open APIs and protocols
- Open marketplace for all assets
- Peer-to-peer transactions
- Creator royalties and revenues
- Community-driven decisions
- DAO treasury management
- Transparent voting mechanisms
- Blockchain: Ethereum (L1) and Polygon (L2)
- Standards: ERC20, ERC721, EIP712, EIP1967
- Languages: Solidity for smart contracts
- Tools: OpenZeppelin, Hardhat, ethers.js
All smart contracts are:
- Open source and verifiable
- Audited by security firms
- Battle-tested in production
- Upgradeable with safeguards
- GitHub: github.com/decentraland
- Discord: Join the developer community
- Forum: forum.decentraland.org
- Technical questions: Discord #developers
- Bug reports: GitHub Issues
- Security: [email protected]
Decentraland is open source and welcomes contributions:
- Code: Submit PRs to relevant repositories
- Documentation: Help improve these docs
- Testing: Report bugs and issues
- Ideas: Propose improvements in forums
The Decentraland smart contracts are open source under various licenses. Check individual repositories for specific license information.
This documentation is continuously updated. For the latest information, check the official Decentraland resources.