Contract ERC-721 Plugin

The Contract ERC-721 plugin calls standard EIP-721 methods on an NFT collection contract deployed on Hedera. Deploy or import the contract first with the Contract plugin. For fungible (ERC-20) calls, see the Contract ERC-20 plugin.

Most Used Commands

Read collection metadata and token ownership

hcli contract-erc721 name --contract my-nft
hcli contract-erc721 owner-of --contract my-nft --token-id 1
hcli contract-erc721 token-uri --contract my-nft --token-id 1

Approve and transfer a specific token

hcli contract-erc721 approve --contract my-nft --to bob --token-id 1
hcli contract-erc721 safe-transfer-from --contract my-nft --from alice --to bob --token-id 1

Full Command Reference

Commands use the contract-erc721 namespace (for example hcli contract-erc721 name). --contract / -c accepts a local alias, Hedera contract ID (0.0.xxx), or EVM address (0x…) where the manifest allows it.

Contract ERC-721 Name

Call name() (read-only).

string

required

Smart contract ID or local alias.

Example

hcli contract-erc721 name --contract my-nft

Contract ERC-721 Symbol

Call symbol() (read-only).

string

required

Smart contract ID or local alias.

Example

hcli contract-erc721 symbol --contract my-nft

Contract ERC-721 Balance-Of

Call balanceOf(address) (read-only).

string

required

Smart contract ID or local alias.

string

required

Owner account: alias, account ID, or EVM address.

Example

hcli contract-erc721 balance-of --contract my-nft --owner alice

Contract ERC-721 Owner-Of

Call ownerOf(uint256 tokenId) (read-only).

string

required

Smart contract ID or local alias.

number

required

Token ID (uint256).

Example

hcli contract-erc721 owner-of --contract my-nft --token-id 1

Contract ERC-721 Get-Approved

Call getApproved(uint256 tokenId) (read-only).

string

required

Smart contract ID or local alias.

number

required

Token ID to query.

Example

hcli contract-erc721 get-approved --contract my-nft --token-id 1

Contract ERC-721 Is-Approved-For-All

Call isApprovedForAll(address owner, address operator) (read-only).

string

required

Smart contract ID, alias, or EVM address.

string

required

Owner account: alias, account ID, or EVM address.

string

required

Operator account: alias, account ID, or EVM address.

Example

hcli contract-erc721 is-approved-for-all --contract my-nft --owner alice --operator bob

Contract ERC-721 Token-URI

Call tokenURI(uint256 tokenId) (read-only).

string

required

Smart contract ID or local alias.

number

required

Token ID to query.

Example

hcli contract-erc721 token-uri --contract my-nft --token-id 1

Contract ERC-721 Approve

Call approve(address to, uint256 tokenId). State-changing (operator signs).

string

required

Smart contract ID, alias, or EVM address.

string

required

Address approved to transfer the token: alias, account ID, or EVM address.

number

required

Token ID to approve.

number

default:"100000"

Gas for the contract call.

Example

hcli contract-erc721 approve --contract my-nft --to bob --token-id 1

Contract ERC-721 Set-Approval-For-All

Call setApprovalForAll(address operator, bool approved). State-changing.

string

required

Smart contract ID, alias, or EVM address.

string

required

Operator account: alias, account ID, or EVM address.

string

required

Must be the string true or false.

number

default:"100000"

Gas for the contract call.

Example

hcli contract-erc721 set-approval-for-all --contract my-nft --operator bob --approved true

Contract ERC-721 Safe-Transfer-From

Call safeTransferFrom (with or without the extra bytes argument). State-changing.

string

required

Smart contract ID, alias, or EVM address.

string

required

Current owner: alias, account ID, or EVM address.

string

required

New owner: alias, account ID, or EVM address.

number

required

Token ID to transfer.

number

default:"100000"

Gas for the contract call.

string

Optional data payload for the 4-argument safeTransferFrom overload.

Example

hcli contract-erc721 safe-transfer-from --contract my-nft --from alice --to bob --token-id 1

Contract ERC-721 Transfer-From

Call transferFrom(address from, address to, uint256 tokenId). State-changing.

string

required

Smart contract ID, alias, or EVM address.

string

required

Current owner: alias, account ID, or EVM address.

string

required

Recipient: alias, account ID, or EVM address.

number

required

Token ID to transfer.

number

default:"100000"

Gas for the contract call.

Example

hcli contract-erc721 transfer-from --contract my-nft --from alice --to bob --token-id 1

Contract ERC-721 Mint

Calls a custom mint(address to, uint256 tokenId) style entry point (experimental). The manifest marks this command as experimental and assumes a contract that exposes a compatible mint used for testing.

string

required

Smart contract ID, alias, or EVM address.

string

required

Recipient of the minted token: alias, account ID, or EVM address.

number

required

Token ID to mint.

number

default:"100000"

Gas for the contract call.

Example

hcli contract-erc721 mint --contract my-nft --to alice --token-id 42

Fungible token helpers: Contract ERC-20 plugin. Deploy and import: Contract plugin.

Overview

Tokenization

Finance Workflows

AI & Agents

Governance

Sustainability

Developer Tools

Examples

Contract ERC-721 Plugin

Most Used Commands

Full Command Reference

Most Used Commands

Full Command Reference

Related