Usage Scenarios

from ton_core import NetworkGlobalID, WalletV4Config

from tonutils.clients import ToncenterClient
from tonutils.contracts import WalletV4R2

client = ToncenterClient(network=NetworkGlobalID.TESTNET)

# Wallet configuration (default settings)
# Customize subwallet_id to derive multiple wallets from the same mnemonic
config = WalletV4Config()

wallet, public_key, private_key, mnemonic = WalletV4R2.create(client, config=config)

print(f"Address: {wallet.address.to_str(is_bounceable=False)}")
print(f"Mnemonic: {' '.join(mnemonic)}")

wallet, public_key, private_key, mnemonic = WalletV4R2.from_mnemonic(client, MNEMONIC)

from ton_core import PrivateKey

wallet = WalletV4R2.from_private_key(client, PrivateKey("<your private key>"))

from ton_core import Address, to_nano

msg = await wallet.transfer(
    destination=Address("UQ..."),
    amount=to_nano(0.01),
    body="Hello from tonutils!",
)
print(f"Transaction hash: {msg.normalized_hash}")

from ton_core import Address, to_nano

from tonutils.contracts import TONTransferBuilder

msg = await wallet.batch_transfer_message(
    [
        TONTransferBuilder(
            destination=Address("UQ..."),
            amount=to_nano(0.01),
            body="Hello from tonutils!",
        ),
        TONTransferBuilder(
            destination=Address("UQ..."),
            amount=to_nano(0.02),
            body="Hello from tonutils!",
        ),
    ]
)
print(f"Transaction hash: {msg.normalized_hash}")

await wallet.transfer(
    destination="UQ...",
    amount=0,
    send_mode=128,
)

from ton_core import to_amount

balance = (await client.get_info("UQ...")).balance
print(f"Balance: {balance} ({to_amount(balance)} TON)")

info = await client.get_info("UQ...")

result = await client.run_get_method(
    address="UQ...",
    method_name="get_my_data",
    stack=[0],
)