If you're coming from the EVM ecosystem, one thing you know well is ERC721. NFTs (non-fungible tokens) are at the heart of many blockchain applications, and ERC721 is one of the first standards developers learn when deploying NFT collections. On Solana, what is the ERC721 equivalent and how does it differ?
ERC721 sets a standard for Non-Fungible Tokens (NFTs), meaning each token is unique (in type and value) compared to another token. The ERC721 standard is utilized to represent individual tokens with distinct identifiers. Unlike ERC20 tokens, ERC721 tokens can possess unique characteristics and functions.
Trên Solana, không có hợp đồng thông minh mới cho mỗi bộ sưu tập NFT. Thay vào đó, NFT được tạo ra dưới một Token Program onchain duy nhất, cùng chương trình được sử dụng cho các token khả đổi - chỉ được đúc với nguồn cung là 1. Để lưu trữ các chi tiết NFT bổ sung (như tên, ký hiệu, URI hình ảnh, v.v.), các nhà phát triển sử dụng Metaplex Token Metadata Program.
Metaplex Metadata là một giao thức và nền tảng mã nguồn mở cho NFT (Non-Fungible Tokens) và tài sản kỹ thuật số. Được xây dựng trên blockchain Solana, Metaplex giúp thêm metadata bổ sung vào các token trên Solana.
Điều này khác với Ethereum, nơi bạn thường triển khai một hợp đồng ERC721 hoàn toàn mới cho mỗi bộ sưu tập. Tại sao lại có một chương trình chính duy nhất cho NFT trên Solana? Đó là do mô hình Account của Solana, phân tách trạng thái (dữ liệu) khỏi logic thực thi (chương trình). Vì Solana tái sử dụng Token Program cho tất cả các token, bạn không cần viết và triển khai một hợp đồng NFT mới - chỉ cần một mint account mới với nguồn cung = 1.
On Ethereum, each NFT collection is identified by its Contract Address, and each token has a unique tokenId within that contract. On Solana, each NFT is identified by a Mint Address. The difference is that you don't deploy a separate "NFT contract" - you just instruct the universal Token Program to create a new mint.
Because Solana's Token Program is universal, there's no concept of a unique "NFT contract address." Instead, each NFT is a special SPL token (supply of 1) with its own Mint Address.
If you want a "collection," you group multiple mint addresses together via a Collection Address in Metaplex, but each minted NFT is still just an SPL token with a unique Mint Address.
On Ethereum, ERC721 often relies on approve or setApprovalForAll for external marketplaces or dApps to transfer your NFTs. On Solana, each NFT is stored in a user's ATA(Associated token account), and a single transaction can include any necessary steps. There's no separate approval flow - one atomic transaction can handle all instructions (e.g. transfer ownership, update metadata, etc.).
A very rough translation of the Solana Token Program would look like this:
// SPDX-License-Identifier: MIT license
pragma solidity =0.8.28;
struct Mint {
uint8 decimals;
uint256 supply;
address mintAuthority;
address freezeAuthority;
address mintAddress;
}
struct TokenAccount {
address mintAddress;
address owner;
uint256 balance;
bool isFrozen;
}
struct Metadata {
string name;
string symbol;
string tokenURI;
}
contract Spl721 {
mapping(address => Mint) public mints;
mapping(address => TokenAccount) public tokenAccounts;
mapping(address => Metadata) public nftMetadata;
mapping(address => bool) public mintAddresses;
mapping(address => bool) public tokenAddresses;
function initializeMint(
uint8 decimals,
address mintAuthority,
address freezeAuthority,
address mintAddress
)
public
returns (Mint memory)
{
require(!mintAddresses[mintAddress], "Mint already exists");
mints[mintAddress] = Mint(decimals, 0, mintAuthority, freezeAuthority, mintAddress);
mintAddresses[mintAddress] = true;
return mints[mintAddress];
}
function setMetadata(
address mintAddress,
string memory name,
string memory symbol,
string memory tokenURI
)
public
{
require(mintAddresses[mintAddress], "Mint does not exist");
nftMetadata[mintAddress] = Metadata(name, symbol, tokenURI);
}
function mintNFT(address toMintTokens, address mintAddress) public {
require(mintAddresses[mintAddress], "NFT mint does not exist");
require(mints[mintAddress].mintAuthority == msg.sender, "Only the mint authority can mint");
require(mints[mintAddress].supply == 0, "NFT already minted");
mints[mintAddress].supply = 1;
address tokenAddress = address(uint160(uint256(keccak256(abi.encodePacked(toMintTokens, mintAddress)))));
if (!tokenAddresses[tokenAddress]) {
tokenAccounts[tokenAddress] = TokenAccount(mintAddress, toMintTokens, 0, false);
tokenAddresses[tokenAddress] = true;
}
tokenAccounts[tokenAddress].balance = 1;
tokenAccounts[tokenAddress].owner = toMintTokens;
}
function transfer(address to, address mintAddress, uint256 amount) public {
address toTokenAddress = address(uint160(uint256(keccak256(abi.encodePacked(to, mintAddress)))));
address fromTokenAddress = address(uint160(uint256(keccak256(abi.encodePacked(msg.sender, mintAddress)))));
require(tokenAccounts[fromTokenAddress].balance >= amount, "Insufficient balance");
require(amount == 1, "Only transferring 1 NFT at a time");
require(tokenAccounts[fromTokenAddress].owner == msg.sender, "Not the NFT owner");
require(!tokenAccounts[fromTokenAddress].isFrozen, "Sender token account is frozen");
if (tokenAddresses[toTokenAddress]) {
require(!tokenAccounts[toTokenAddress].isFrozen, "Receiver token account is frozen");
}
if (!tokenAddresses[toTokenAddress]) {
tokenAccounts[toTokenAddress] = TokenAccount(mintAddress, to, 0, false);
tokenAddresses[toTokenAddress] = true;
}
tokenAccounts[fromTokenAddress].balance -= amount;
tokenAccounts[toTokenAddress].balance += amount;
tokenAccounts[toTokenAddress].owner = to;
}
function freezeAccount(address owner, address mintAddress) public {
require(mintAddresses[mintAddress], "Mint does not exist");
require(mints[mintAddress].freezeAuthority == msg.sender, "Only the freeze authority can freeze");
address tokenAddress = address(uint160(uint256(keccak256(abi.encodePacked(owner, mintAddress)))));
require(tokenAddresses[tokenAddress], "Token account not found");
tokenAccounts[tokenAddress].isFrozen = true;
}
function getMint(address token) public view returns (Mint memory) {
return mints[token];
}
function getTokenAccount(address owner, address token) public view returns (TokenAccount memory) {
return tokenAccounts[address(uint160(uint256(keccak256(abi.encodePacked(owner, token)))))];
}
function getMetadata(address mintAddress) public view returns (Metadata memory) {
return nftMetadata[mintAddress];
}
}
As you can see in the contract, instead of an approval flow, there is only a transfer function to move tokens. On Solana, a single transaction can call multiple smart contract functions atomically, removing the need for the approval flow. Another difference is that everything is stored in a token account on Solana, keeping the details of the owner's tokens separate from the other state.
On Ethereum, ERC721 contracts often store a metadata URI or embed logic for fetching token metadata. On Solana, the Token Metadata Program (by Metaplex) handles NFT metadata in a separate account. You can include fields like name, symbol, description, image URI, and more--all without changing the underlying Token Program. This does mean there's a separate instruction in your minting transaction to attach metadata. Since Solana can handle multiple program calls atomically in one transaction, you can easily create the mint and set up metadata in a single go.
Now that you have a general idea of how the token program and metadata program on Solana works, let's go through some of the tradeoffs of each NFT standard.
ERC721
Solana NFT (SPL + Metaplex)
Below is a table comparing the basic steps of deploying an ERC-721 token on Ethereum vs. creating an NFT (SPL token with metadata) on Solana. (On Solana, you can freely mint SPL tokens by using the spl-token command in the command-line tool.)
| Bước | Ethereum (ERC-721) | Solana (SPL + Metaplex) |
|---|---|---|
| 1. Chuẩn Bị Mã Token | Thường sử dụng thư viện ERC721 của OpenZeppelin. Bạn tạo một tệp Solidity (ví dụ: MyNFT.sol). | Không cần hợp đồng tùy chỉnh cho chức năng NFT cơ bản. Token Program đã được triển khai sẵn. Bạn chỉ cần tạo mint account (cung cấp = 1). |
| 2. Biên Dịch & Triển Khai | Biên dịch và triển khai bằng Hardhat/Truffle (ví dụ: npx hardhat run deploy.js --network ...). | Sử dụng CLI (ví dụ: spl-token create-token --decimals 0) hoặc công cụ SDK (như Candy Machine của Metaplex). Không yêu cầu triển khai hợp đồng riêng biệt. |
| 3. Mint NFT | Gọi hàm mint() của hợp đồng, hàm này gán NFT cho một địa chỉ và thường đặt URI metadata của token. Phí gas có thể thay đổi. | Chạy spl-token mint <MINT_ADDRESS> 1 hoặc sử dụng lệnh mint của Metaplex để tạo chính xác 1 cung cấp. Phí giao dịch trên Solana thường rất thấp. |
| 4. Tạo Người Nhận | Thường chỉ là một địa chỉ Ethereum bình thường. Người dùng phải thêm địa chỉ hợp đồng NFT trong nhiều ví để nhìn thấy nó. | Mỗi người dùng có một associated token account (ATA). Các ví như Phantom tự động nhận diện ATA cho NFT. Không cần bước thêm để "thêm" token, mặc dù nó có thể xuất hiện trong tab "Collectibles" sau khi được nhận diện. |
| 5. Kiểm Tra Kết Quả | Xem trên Etherscan hoặc sử dụng thị trường NFT như OpenSea. Thường thì người dùng phải thêm địa chỉ hợp đồng theo cách thủ công để xem token trong một số ví. | Sử dụng solana balance <ADDRESS> hoặc spl-token accounts để xem số dư token. Bạn cũng có thể sử dụng Solana Explorer hoặc thị trường NFT (Magic Eden, OpenSea Solana, v.v.) để xác nhận sự hiện diện của NFT. |
| 6. Mã Định Danh Duy Nhất | Địa chỉ hợp đồng + tokenId. | Địa chỉ Mint. Mỗi NFT đơn giản là một SPL token với supply=1. |
| 7. Bộ Sưu Tập | Tất cả các token trong một hợp đồng thường đại diện cho một bộ sưu tập duy nhất. | Các bộ sưu tập được gán thông qua "địa chỉ bộ sưu tập" trong Metaplex. Bạn không triển khai hợp đồng chuyên dụng. |
| 8. Cập Nhật Mã | Đối với các nâng cấp lớn, bạn có thể sử dụng mẫu proxy hoặc triển khai lại hợp đồng. Chỉ các nhà phát triển nâng cao thường làm điều này. | Token Program là cố định. Nếu bạn cần các tính năng nâng cao (phí bản quyền, metadata động, v.v.), bạn có thể sử dụng hoặc xây dựng các chương trình onchain riêng biệt. Metaplex cũng hỗ trợ các tiện ích mở rộng như NFT có thể lập trình. |
| 9. Yêu Cầu Kiểm Toán | Mỗi hợp đồng thường yêu cầu kiểm toán, đặc biệt nếu bạn thêm logic mint tùy chỉnh, thị trường, v.v. | Token Program chính và Metaplex Metadata Program đã được kiểm toán nhiều lần. Đối với việc mint NFT tiêu chuẩn, thường không cần kiểm toán hợp đồng bổ sung. |
Want to mint your own NFT on Solana? Check out this guide!
Let's explore how to interact with the Token Program using solana/web3.js based on Ethereum's ERC721 interface structure.
As mentioned above, since NFT Collections on Solana are not tied to a specific contract, the concept of a tokenId does not exist. Therefore, to find the specific data of a token, you should use Mint Address or Collection Address.
name()function name() external view returns (string); // Returns the token collection nameYou can use @metaplex-foundation/umi-bundle-defaults and @metaplex-foundation/mpl-token-metadata to fetch and parse an NFT's off-chain metadata from its mint address.
import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
import { fetchDigitalAsset, mplTokenMetadata } from "@metaplex-foundation/mpl-token-metadata";
import { PublicKey } from "@metaplex-foundation/js";
const mintAddress = new PublicKey("Token Address");
async function name() {
try {
const umi = createUmi("https://api.devnet.solana.com");
umi.use(mplTokenMetadata());
const digitalAsset = await fetchDigitalAsset(umi, mintAddress);
return digitalAsset.metadata.name;
} catch (error) {
console.error("Error fetching NFT name:", error);
return null;
}
}
name().then(nftName => {
console.log("NFT Name:", nftName);
})
.catch(error => {
console.error("Error:", error);
});
symbol()function symbol() external view returns (string); // Returns the token collection symbolYou can also retrieve the symbol in the same way as name(), using @metaplex-foundation/umi-bundle-defaults and @metaplex-foundation/mpl-token-metadata.
import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
import { fetchDigitalAsset, mplTokenMetadata } from "@metaplex-foundation/mpl-token-metadata";
import { PublicKey } from "@metaplex-foundation/js";
const mintAddress = new PublicKey("Token Address");
async function symbol() {
try {
const umi = createUmi("https://api.devnet.solana.com");
umi.use(mplTokenMetadata());
const digitalAsset = await fetchDigitalAsset(umi, mintAddress);
return digitalAsset.metadata.symbol;
} catch (error) {
console.error("Error fetching NFT symbol:", error);
return null;
}
}
symbol().then(nftSymbol => {
console.log("NFT Symbol:", nftSymbol);
}).catch(error => {
console.error("Error:", error);
});
tokenURI()function tokenURI(uint256 _tokenId) external view returns (string); // Returns the tokenURI of the tokenYou can also retrieve the symbol in the same way as name(), using @metaplex-foundation/umi-bundle-defaults and @metaplex-foundation/mpl-token-metadata.
import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
import { fetchDigitalAsset, mplTokenMetadata } from "@metaplex-foundation/mpl-token-metadata";
import { PublicKey } from "@metaplex-foundation/js";
const mintAddress = new PublicKey("Token Address");
async function tokenURI( /* no tokenId */ ) {
try {
const umi = createUmi("https://api.devnet.solana.com");
umi.use(mplTokenMetadata());
const digitalAsset = await fetchDigitalAsset(umi, mintAddress);
return digitalAsset.metadata.uri;
} catch (error) {
console.error("Error fetching token URI:", error);
return null;
}
}
tokenURI()
.then(uri => {
console.log("Token URI:", uri);
})
.catch(error => {
console.error("Error:", error);
});
ownerOf()function ownerOf(uint256 _tokenId) public view returns (address) // Returns the owner of the tokenId tokenWe can check the owner of an NFT using the mint address instead of the tokenId.
import { Connection, PublicKey } from "@solana/web3.js";
const connection = new Connection("https://api.devnet.solana.com", "confirmed");
const mintAddress = new PublicKey("Token Address");
async function ownerOf( /*no tokenId*/ ){
const largestAccounts = await connection.getTokenLargestAccounts(new PublicKey(mintAddress));
const largestAccountInfo = await connection.getParsedAccountInfo(largestAccounts.value[0].address);
return largestAccountInfo.value.data.parsed.info.owner;
}
ownerOf().then(owner => {
console.log(owner);
}).catch(error => {
console.error("Error:", error);
});
transferFrom()function transferFrom(address _from, address _to, uint256 _tokenId) external payable; // Transfers tokenId token from _from to _toFirst, Let's look at this code for understanding logic:
On Solana, each token is identified by its unique Mint address, and users store their balances in an Associated Token Account (ATA). In a transaction, the ATA address is used as the sender or receiver for transferring tokens. Unlike on Ethereum, where you directly call an ERC-20 contract, Solana handles token transfer logic through its native system program.
We can make a transaction's transfer instruction through createTransferCheckedInstruction and send it through sendTransaction from @solana/spl-token.
import { Keypair, Transaction, Connection, PublicKey } from "@solana/web3.js";
import { createTransferCheckedInstruction } from "@solana/spl-token";
const connection = new Connection("https://api.devnet.solana.com", "confirmed");
// Replace with your real private key (as a Uint8Array)
const ownerSecretkey = [];
const ownerPrivatekeypair = Keypair.fromSecretKey(new Uint8Array(ownerSecretkey));
const fromPublicKey = ownerPrivatekeypair.publicKey; // The sender's public key
const toPublicKey = new PublicKey("Receiver's Wallet Address");
const mintAddress = new PublicKey("Token Address");
// Pre-existing ATA addresses (for `_from` and `_to`)
const ownerTokenAccount = new PublicKey("Associated Token Account of _from");
const receiverTokenAccount = new PublicKey("Associated Token Account of _to");
// For an NFT, decimals = 0 and amount = 1
async function transferFrom(_from, _to) {
try {
const tx = new Transaction().add(
createTransferCheckedInstruction(
ownerTokenAccount, // _from's ATA
mintAddress,
receiverTokenAccount, // _to's ATA
ownerPrivatekeypair.publicKey, // Authority for `_from` (the private key must match this public key)
1, // amount = 1 NFT
0 // decimals = 0 for NFT
)
);
// Send transaction (simple version)
await connection.sendTransaction(tx, [ownerPrivatekeypair]);
return true;
} catch (error) {
console.error("Error in transferFrom:", error);
return false;
}
}
transferFrom(fromPublicKey, toPublicKey)
.then(result => {
console.log("transferFrom result:", result);
})
.catch(error => {
console.error("Error:", error);
});
How we can check receiverTokenAddress through receiverAddress? We can use getOrCreateAssociatedTokenAccount. It will retrieve the associated token account, or create it if it doesn't exist.
import { Keypair, Transaction, Connection, PublicKey } from "@solana/web3.js";
import { createTransferCheckedInstruction, getOrCreateAssociatedTokenAccount } from "@solana/spl-token";
const connection = new Connection("https://api.devnet.solana.com", "confirmed");
// Insert your private key as a Uint8Array
const ownerSecretkey = [];
const ownerPrivatekeypair = Keypair.fromSecretKey(new Uint8Array(ownerSecretkey));
const fromAddress = ownerPrivatekeypair.publicKey; // The sender's public key
const toAddress = new PublicKey("Receiver's Wallet Address");
const mintAddress = new PublicKey("Token Address");
// For an NFT: decimals = 0, amount = 1
async function transferFrom(_from, _to) {
try {
// Retrieve (or create if missing) the sender's ATA
const ownerTokenAccount = await getOrCreateAssociatedTokenAccount(
connection,
ownerPrivatekeypair, // Fee payer
mintAddress,
_from
);
// Retrieve (or create if missing) the receiver's ATA
const receiverTokenAccount = await getOrCreateAssociatedTokenAccount(
connection,
ownerPrivatekeypair, // Fee payer (use the receiver if needed)
mintAddress,
_to
);
// Create transaction with a transfer of 1 NFT (decimals=0)
const tx = new Transaction().add(
createTransferCheckedInstruction(
ownerTokenAccount.address,
mintAddress,
receiverTokenAccount.address,
ownerPrivatekeypair.publicKey,
1, // Always transfer exactly 1 (NFT)
0 // decimals = 0 for an NFT
)
);
// Send the transaction
await connection.sendTransaction(tx, [ownerPrivatekeypair]);
return true;
} catch (error) {
console.error("Error in transferFrom:", error);
return false;
}
}
transferFrom(fromAddress, toAddress)
.then(result => {
console.log("Transaction result:", result);
})
.catch(error => {
console.error("Error:", error);
});
Want to explore more features? Check out this guide!