PlatON CLI

Overview

Use Foundry cast to query PlatON chain data from mainnet or devnet. Prefer explicit --rpc-url usage so every command is reproducible and does not depend on ambient shell state.

Setup

Install Foundry (includes cast):

curl -L https://foundry.paradigm.xyz | bash foundryup --install  v1.6.0-rc1

Set RPC (optional):

export ETH_RPC_URL="https://openapi2.platon.network/rpc"

When the user needs the latest validated PlatON endpoints, first use $platon-chainlist.

Check Balance

cast balance <ADDRESS> --rpc-url https://openapi2.platon.network/rpc

In LAT (human readable):

cast balance <ADDRESS> --ether --rpc-url https://openapi2.platon.network/rpc

Transaction Info

cast tx <TX_HASH> --rpc-url https://openapi2.platon.network/rpc

Transaction receipt:

cast receipt <TX_HASH> --rpc-url https://openapi2.platon.network/rpc

Gas Price

cast gas-price --rpc-url https://openapi2.platon.network/rpc

In gwei:

cast --to-unit $(cast gas-price --rpc-url https://openapi2.platon.network/rpc) gwei

Block Info

Latest block:

cast block latest --rpc-url https://openapi2.platon.network/rpc

Specific block:

cast block <BLOCK_NUMBER> --rpc-url https://openapi2.platon.network/rpc

Contract Call

cast call <CONTRACT> "balanceOf(address)(uint256)" <ADDRESS> --rpc-url https://openapi2.platon.network/rpc

Read another view function:

cast call <CONTRACT> "<FUNCTION_SIGNATURE>" <ARGS...> --rpc-url https://openapi2.platon.network/rpc

Publish Transaction

Broadcast a raw signed transaction:

cast publish <SIGNED_TX_HEX> --rpc-url https://openapi2.platon.network/rpc

Send Transaction

Send a state-changing transaction with a private key:

cast send <CONTRACT> "transfer(address,uint256)" <TO> <AMOUNT> \
  --private-key <PRIVATE_KEY> \
  --rpc-url https://openapi2.platon.network/rpc

Send native LAT:

cast send <TO> --value 1ether \
  --private-key <PRIVATE_KEY> \
  --rpc-url https://openapi2.platon.network/rpc

Estimate Gas

Estimate gas for a contract write:

cast estimate <CONTRACT> "transfer(address,uint256)" <TO> <AMOUNT> --rpc-url https://openapi2.platon.network/rpc

Estimate gas for native transfer:

cast estimate <TO> --value 1ether --rpc-url https://openapi2.platon.network/rpc

Contract Code

cast code <ADDRESS> --rpc-url https://openapi2.platon.network/rpc

Storage

cast storage <ADDRESS> <SLOT> --rpc-url https://openapi2.platon.network/rpc

Logs

cast logs --rpc-url https://openapi2.platon.network/rpc --address <ADDRESS> --from-block <START> --to-block <END>

Account Nonce

cast nonce <ADDRESS> --rpc-url https://openapi2.platon.network/rpc

Chain Info

cast chain-id --rpc-url https://openapi2.platon.network/rpc

Address Conversion

Convert between PlatON lat bech32 addresses and 0x hex addresses:

node platon-cli/scripts/address_convert.ts lat1jt5xgxdca0hvs9ffhsk0a70zykwd8vjfc5aefl

Convert 0x to lat:

node platon-cli/scripts/address_convert.ts 0x92e86419B8EbeEC81529bC2CfEf9E2259CD3B249

The script auto-detects the input format and prints the converted address.

Public RPC Endpoints

Network aliases:

• mainnet, main
• dev, testnet, devnet

Notes

• Addresses are 0x-prefixed hex (42 characters)
• Gas prices fluctuate; check before transactions
• Rate limits apply on public RPCs
• Use --rpc-url or set ETH_RPC_URL environment variable