The most comprehensive, up-to-date resource for building on IOTA Rebased. No outdated Tangle/Stardust confusion. Just clean, accurate, actionable documentation — ready for any AI coding assistant.
IOTA underwent a massive architectural transformation in 2025 — from the legacy Tangle/Stardust protocol to IOTA Rebased: a Move VM-powered, object-oriented blockchain with DPoS consensus.
The problem? Most IOTA documentation online is outdated. Search results mix legacy concepts (Tangle, feeless, Coordinator, UTXO) with the new architecture (Move, Objects, Mysticeti, validators). This confuses developers and AI assistants alike.
This repository solves that. It provides:
- ✅ Only IOTA Rebased — zero legacy confusion
- ✅ 23 reference documents covering everything from Move basics to DeFi patterns
- ✅ Real code examples from the official iotaledger repositories
- ✅ AI-optimized format — works with Claude, ChatGPT, Cursor, Windsurf, and any LLM
- ✅ 6,800+ lines of curated, practical documentation
| Document | Description |
|---|---|
| architecture.md | Move VM, Object Model, Mysticeti/Starfish consensus, DPoS, PTBs, transaction lifecycle |
| old-vs-new.md | Essential — Legacy IOTA vs Rebased comparison table, API/SDK migration maps |
| tokenomics.md | Supply dynamics, staking rewards, gas fees, storage deposits, governance |
| networks.md | Mainnet, Testnet, Devnet endpoints, RPC URLs, faucets, Chain IDs |
| Document | Description |
|---|---|
| move-basics.md | Move 2024 syntax, packages, objects, ownership, collections |
| move-advanced.md | Witness, Hot Potato, Capability, Publisher, OTW, Generics |
| move-objects-fields.md | Object model deep dive, dynamic fields, wrapping, transfer |
| move-defi.md | Tokens (Coin<T>), NFTs, DEX/AMM, flash loans, Kiosk, oracles |
| move-testing.md | Unit tests, test_scenario, coverage, integration testing |
| move-security.md | Access control, validation, why Move prevents reentrancy |
| move-gas.md | Gas mechanics, optimization, owned vs shared objects |
| Document | Description |
|---|---|
| smart-contracts.md | Create → build → test → deploy workflow, 24 official examples |
| sdks-tools.md | CLI, TypeScript SDK, Rust SDK, GraphQL API, IDE setup |
| evm-layer2.md | IOTA EVM (Solidity L2), Chain IDs, Hardhat deploy, Move vs EVM |
| move-vs-sui.md | IOTA Move vs Sui Move differences, migration guide |
| Document | Description |
|---|---|
| wallets.md | IOTA Wallet (Chrome extension), Ledger, Firefly migration |
| staking.md | DPoS staking guide (wallet + CLI), validator selection, rewards |
| migration.md | Stardust → Rebased migration, NFT/Alias claiming, SDK mapping |
| identity.md | Decentralized Identity (DID), Verifiable Credentials (W3C) |
| twin.md | TWIN — global digital trade infrastructure on IOTA |
| roadmap-starfish.md | Starfish consensus (next-gen), 2026 roadmap |
| ecosystem.md | Official repos, explorers, DPP, community resources |
# Copy the skill folder to your workspace
cp -r references/ SKILL.md /path/to/your/workspace/skills/iota-rebased/The AI will automatically use it when you ask about IOTA development.
Upload all .md files from references/ as Project Knowledge files.
Upload all .md files from references/ as Knowledge files in your GPT configuration.
# Copy references to your project
cp -r references/ /path/to/your/project/docs/iota/The AI will reference them when you're coding.
Copy-paste the relevant .md file content into your conversation as context.
If you see any of these terms, you're looking at outdated IOTA documentation:
| ❌ Legacy Term | ✅ Rebased Equivalent |
|---|---|
| Tangle | IOTA blockchain |
| Coordinator | Mysticeti consensus (DPoS) |
| UTXO | Object Model |
| Feeless | Low fees (~0.005 IOTA per tx) |
| Hornet / Bee | IOTA node (Rust) |
| Firefly | IOTA Wallet (browser extension) |
| MIOTA | IOTA (1 IOTA = 1B Nanos) |
| Mana | Not used in Rebased |
| IOTA 2.0 | IOTA Rebased |
See old-vs-new.md for the complete comparison.
- Documentation: docs.iota.org
- GitHub: github.com/iotaledger
- Website: iota.org
- Explorer: explorer.iota.org
- TWIN: twin.org | twindev.org
- Starfish Paper: eprint.iacr.org/2025/567
- Whitepaper: IOTA Technical & Tokenomics
Found outdated information? Want to add more examples? PRs are welcome!
Please ensure all contributions:
- Reference IOTA Rebased only (not legacy Tangle/Stardust)
- Use
iota::namespaces in code examples (notsui::) - Include source links to docs.iota.org or official repos
- Are written in English
MIT — Use freely, share widely. See LICENSE.
Built with ❤️ for the IOTA developer community. Last updated: February 2026.