Contract ERC-20 Plugin

The Contract ERC-20 plugin calls standard EIP-20 methods on a contract already deployed on Hedera. Deploy or import the contract first with the Contract plugin.

Most Used Commands

Read token metadata and an account balance

hcli contract-erc20 name --contract my-token
hcli contract-erc20 decimals --contract my-token
hcli contract-erc20 balance-of --contract my-token --account alice

Transfer and approve (state-changing, signed by the operator)

hcli contract-erc20 transfer --contract my-token --to bob --value 1000000
hcli contract-erc20 approve --contract my-token --spender bob --value 500000

Full Command Reference

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

Contract ERC-20 Name

Call name() on the ERC-20 contract (read-only).

string

required

Smart contract ID or local alias.

Example

hcli contract-erc20 name --contract my-token

Contract ERC-20 Symbol

Call symbol() (read-only).

string

required

Smart contract ID or local alias.

Example

hcli contract-erc20 symbol --contract my-token

Contract ERC-20 Decimals

Call decimals() (read-only).

string

required

Smart contract ID or local alias.

Example

hcli contract-erc20 decimals --contract my-token

Contract ERC-20 Total-Supply

Call totalSupply() (read-only).

string

required

Smart contract ID or local alias.

Example

hcli contract-erc20 total-supply --contract my-token

Contract ERC-20 Balance-Of

Call balanceOf(address) (read-only).

string

required

Smart contract ID, alias, or EVM address.

string

required

Account to query: alias, Hedera account ID, or EVM address.

Example

hcli contract-erc20 balance-of --contract my-token --account 0.0.123456

Contract ERC-20 Allowance

Call allowance(owner, spender) (read-only).

string

required

Smart contract ID or local alias.

string

required

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

string

required

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

Example

hcli contract-erc20 allowance --contract my-token --owner alice --spender bob

Contract ERC-20 Transfer

Call transfer(to, value). Submits a contract call transaction (operator signs).

string

required

Smart contract ID, alias, or EVM address.

string

required

Recipient: alias, account ID, or EVM address.

number

required

Amount passed to transfer as configured by the token (often smallest units—confirm against decimals for your contract).

number

default:"100000"

Gas for the contract call.

Example

hcli contract-erc20 transfer --contract my-token --to bob --value 1000000

Contract ERC-20 Transfer-From

Call transferFrom(from, to, value). Requires a sufficient allowance from from for the signing account (typically the operator). Submits a contract call transaction.

string

required

Smart contract ID, alias, or EVM address.

string

required

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

string

required

Recipient: alias, account ID, or EVM address.

number

required

Amount for transferFrom.

number

default:"100000"

Gas for the contract call.

Example

hcli contract-erc20 transfer-from --contract my-token --from alice --to bob --value 500000

Contract ERC-20 Approve

Call approve(spender, value). Submits a contract call transaction.

string

required

Smart contract ID, alias, or EVM address.

string

required

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

number

required

Approved amount for approve.

number

default:"100000"

Gas for the contract call.

Example

hcli contract-erc20 approve --contract my-token --spender bob --value 1000000

NFT contract helpers are documented on the Contract ERC-721 plugin page.

Overview

Tokenization

Finance Workflows

AI & Agents

Governance

Sustainability

Developer Tools

Examples

Contract ERC-20 Plugin

Most Used Commands

Full Command Reference

Most Used Commands

Full Command Reference

Related