USDC Token

O USDCToken é um wrapper ERC-20 de alto nível para o contrato USDC na Arc. Todos os valores usam Decimal com 6 casas decimais.

Importação

from arc_devkit.usdc.token import USDCToken
from decimal import Decimal

Operações de leitura

usdc = USDCToken(contract_address="0xUSDCContractAddress")

# Saldo de uma carteira
balance = usdc.balance("0xWalletAddress")
print(balance)  # Decimal("10.500000")

# Allowance
allowance = usdc.allowance("0xOwner", "0xSpender")
print(allowance)  # Decimal("100.000000")

Operações de escrita (requer chave privada)

# Transfer
tx_hash = usdc.transfer(
    to="0xRecipient",
    amount=Decimal("5.0"),
    private_key="0xPrivateKey",
)

# Approve
tx_hash = usdc.approve(
    spender="0xSpender",
    amount=Decimal("50.0"),
    private_key="0xPrivateKey",
)

Referência da API

USDCToken(contract_address)

balance(address)

Retorna: Decimal — saldo em USDC (6 casas decimais).

allowance(owner, spender)

Retorna: Decimal — allowance aprovado.

transfer(to, amount, private_key)

Retorna: str — hash da transação.

approve(spender, amount, private_key)

Retorna: str — hash da transação.