Blockchain Tutorials

Step-by-step guides that take you from zero to a working application on Elastos. Each tutorial is self-contained and can be completed in 15–30 minutes.

Use this section in order if you are new to the stack (tokens → NFTs → frontend → identity → storage), or jump to the topic that matches what you are shipping next. Every guide assumes you can run Node.js locally and use a browser wallet when a chain interaction is required.

What you should have ready

• A current LTS version of Node.js and a package manager (npm, pnpm, or yarn).
• MetaMask (or another EVM wallet) for signing transactions and adding ESC networks.
• For DID and Hive tutorials: ability to install npm packages and run small scripts or a minimal web server locally.
• Patience with testnet confirmations: blocks are fast, but faucets and explorers can rate-limit during busy periods.

Available tutorials

Tutorial	What You'll Build	Prerequisites	Time
Create an ERC-20 Token	A fungible token on ESC	MetaMask, Node.js	~15 min
Deploy an NFT	An ERC-721 NFT with IPFS metadata	MetaMask, Node.js	~20 min
Connect a Web Frontend	A React dApp connected to ESC	React basics, MetaMask	~20 min
Login with DID	DID-based authentication for a web app	Node.js, DID.JS.SDK	~25 min
Store Data in Hive	A personal data vault with CRUD operations	Node.js, Hive.JS.SDK	~25 min

Choosing where to start

If you only need assets on-chain, begin with Create an ERC-20 Token or Deploy an NFT. If you already have contracts and want a UI, open Connect a Web Frontend. For off-chain identity or user-owned storage, use Login with DID or Store Data in Hive.

Before you start

ESC is EVM-compatible

Elastos Smart Chain (ESC) is EVM-compatible. Use Chain ID 20 on mainnet and Chain ID 21 on testnet. The same RPC, wallet, and deployment patterns you use elsewhere on Ethereum apply here.

• Standard Ethereum tools work: Hardhat, Remix, ethers.js, web3.js, MetaMask, and typical CI or local dev setups.
• Testnet faucet (request tELA for fees and exercises): https://esc-faucet.elastos.io/
• Testnet RPC endpoint: https://api-testnet.elastos.io/esc
• Testnet block explorer: https://esc-testnet.elastos.io/

Testnet first

Run through each tutorial on ESC Testnet before using mainnet funds. Double-check chain ID and RPC in your wallet and scripts so you do not deploy to the wrong network.

Network Configuration

For MetaMask and wallet network setup, see Add ESC Network.

Fund the account you will use from the faucet, then repeat funding if you burn tELA during heavier contract tests.

Reference docs

These tutorials focus on hands-on steps. For deeper protocol detail, use the Learn and Develop sections in this site, especially smart contract basics, DID concepts, and Hive APIs, when you need specifications beyond the walkthrough.

Verifying your connection

Before you run deployment scripts or click “Confirm” in the wallet:

1. Confirm the wallet shows Chain ID 21 and the ESC Testnet name you configured.
2. Paste your address into the testnet explorer and confirm the faucet transaction appears when you request tELA.
3. In scripts, set the RPC URL to https://api-testnet.elastos.io/esc and instantiate your provider or Web3/ethers client against that URL only.

If something fails, wrong chain ID and stale RPC URLs are the most common causes; fix those before debugging application code.

Next steps

Pick one tutorial from the table, follow it end-to-end on testnet, and only then repeat the same flow against mainnet with real ELA at risk.