The terra-classic-sdk library (frequently called PyLunc or Terra.py for the classic network) is the essential toolkit python developers use to interact with the Terra Luna Classic ($LUNC) blockchain. It gives crypto developers an easy abstraction layer over the Tendermint RPC and Light Client Daemon (LCD).
Whether you are automating a trading bot, setting up a validator alert, or launching a decentralized application (dApp) on the classic network, here are the top 5 PyLunc code snippets you need to know. 🚀 Prerequisites
Before running any code, you need to install the SDK and the proper protobuf drop-in library to ensure compatibility with the updated network schemas: pip install terra-classic-sdk terra-classic-proto Use code with caution. 1. Initializing the LCD Connection
Every operation begins by creating an instance of the LCDClient. This client establishes a connection to a node endpoint on either the public Mainnet or Testnet.
from terra_classic_sdk.client.lcd import LCDClient # Connect to the Terra Classic Rebel Testnet (columbus-5 for mainnet) lcd = LCDClient( chain_id=“rebel-2”, url=”https://terra.dev” ) print(f”Connected to network: {lcd.config.chain_id}“) Use code with caution. 2. Creating a Wallet and Checking Balances
To perform write actions, you need a wallet derived from a cryptographic seed phrase (mnemonic key). This snippet loads a wallet and queries its remaining LUNCandcap L cap U cap N cap C a n d USTC balances.
from terra_classic_sdk.key.mnemonic import MnemonicKey # Generate or load a wallet from your 24-word seed phrase mnemonic = “your secret twenty four word mnemonic phrase goes here …” mk = MnemonicKey(mnemonic=mnemonic) wallet = lcd.wallet(mk) # Check the wallet balance balances, pagination = lcd.bank.balance(wallet.key.acc_address) print(f”Wallet Address: {wallet.key.acc_address}“) print(f”Current Balances: {balances.to_amino()}“) Use code with caution. 3. Signing and Sending LUNC Transactions
This snippet constructs, signs, and broadcasts a basic transfer transaction (MsgSend) to send tokens from your wallet to another address.
from terra_classic_sdk.core.bank import MsgSend from terra_classic_sdk.core.coins import Coins # Define receiver address and the exact amount (1 LUNC = 1,000,000 uuluna) recipient_address = “terra1…” amount = Coins(uuluna=1000000) # Create the send message tx_msg = MsgSend(wallet.key.acc_address, recipient_address, amount) # Create, sign, and broadcast the transaction tx = wallet.create_and_sign_tx(msgs=[tx_msg]) tx_result = lcd.tx.broadcast(tx) print(f”Transaction Success! Hash: {tx_result.txhash}“) Use code with caution. 4. Interacting with CosmWasm Smart Contracts
Terra Classic runs on CosmWasm smart contracts. This snippet lets you execute a read-only query to a deployed contract (like checking a user’s balance on a CW20 token).
import json # Define your target contract address contract_address = “terra1…” # Formulate the query as a Use code with caution. Python dictionary Use code with caution.
matching the contract schema query_msg = {“balance”: {“address”: wallet.key.acc_address}} # Execute the query response = lcd.wasm.contract_query(contract_address, query_msg) print(f”Contract Response: {json.dumps(response)}“) Use code with caution. 5. Automating Staking and Claiming Rewards
Validator management and passive income automation require interacting with the staking module. This snippet automates claiming all accrued staking rewards from a chosen validator.
from terra_classic_sdk.core.distribution import MsgWithdrawDelegatorReward validator_address = “terravaloper1…” # Build the reward withdrawal message reward_msg = MsgWithdrawDelegatorReward( delegator_address=wallet.key.acc_address, validator_address=validator_address ) # Broadcast the transaction with automatic gas calculation tx = wallet.create_and_sign_tx(msgs=[reward_msg], fee_denoms=[“uuluna”]) tx_result = lcd.tx.broadcast(tx) print(f”Rewards Claimed. Tx Hash: {tx_result.txhash}“) Use code with caution. 💡 Core Security and Best Practices
Gas Management: Always use fee_denoms=[“uuluna”] inside your transaction creation block so PyLunc can dynamically estimate gas fees using the network’s latest tax structures.
Environment Variables: Never hardcode your mnemonics inside your code script. Use python libraries like python-dotenv to fetch your keys safely via system variables.
What specific type of blockchain application are you planning to build using Python? If you tell me your project goals, I can provide custom code adjustments or help you map out the necessary smart contract interactions! terra-classic-sdk – PyPI
Leave a Reply