This page uses machine translation from English, which may contain errors or unclear language. For the most accurate information, please see the original English version. Some content may be in the original English due to frequent updates. Help us improve this page's translation by joining our effort on Crowdin. (Crowdin translation page, Contributing guide)

Smart Contract Execution

TxTypeSmartContractExecution executes a smart contract with the given data. TxTypeSmartContractExecution is accepted only if "to" is a smart contract account.

Import extend from web3py_ext to extend web3 to kaia web3

Import necessary utils from eth_account, web3py_ext and cytoolz

Create a Web3 instance with the specified kairos testnet URL

Also, you can change the provider URL from kairos to quicknode

Load an account from private key

Create an empty transaction of type TxType.SMART_CONTRACT_EXECUTION. You can use empty_tx util to get a tx with default fields filled.

Merge the additional fields like from, to and data into the empty tx by using the merge util.

Set the contract address you want to execute into the to field

In this tutorial, the data to call a function of the contract is encoded into bytes stream. Please refer to the write tutorial in the Smart Contract section to make the encoded data

Use fill_transaction to add more params to transaction object like gas limit...

Sign the value transfer tx by user's private key

Recover the signer's address from the signature in signed tx

You can decode the RLP-encoded tx by the Account.decode_transaction util and if you want to make the output format pretty, use the to_pretty util

Send the tx to the blockchain. It will return the tx hash, which will be used to wait the receipt

The wait_for_transaction_receipt method returns the tx receipt if it is completed in the blockchain

Finally, get the result.

smart_contract_execution_sign_recover.py


from web3py_ext import extend
from web3 import Web3
from eth_account import Account
from web3py_ext.transaction.transaction import (
    empty_tx,
    fill_transaction,
    TxType
)
from web3py_ext.utils.klaytn_utils import to_pretty
from cytoolz import merge
w3 = Web3(Web3.HTTPProvider(
    'https://public-en-kairos.node.kaia.io'
    ))
def web3_smart_contract_execution_sign_recover():
    user = Account.from_key('0x0e4ca6d38096ad99324de0dde108587e5d7c600165ae4cd6c2462c597458c2b8')
    smart_contract_execution_tx = empty_tx(TxType.SMART_CONTRACT_EXECUTION)
    smart_contract_execution_tx = merge(smart_contract_execution_tx, {
        'from' : user.address,
        'to' : '0x108bF12b50c9ef65525F0495C721aEc55015e111', # already deployed contract for test before
        'data' : '0x3d7403a30000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000c48656c6c6f204b6c6179746e0000000000000000000000000000000000000000',
    })
    smart_contract_execution_tx = fill_transaction(smart_contract_execution_tx, w3)
    # sign the kaia specific transaction type with web3py
    signed_tx = Account.sign_transaction(smart_contract_execution_tx, user.key)
    print("\nraw transaction of signed tx:", signed_tx.rawTransaction.hex())
    recovered_tx = Account.recover_transaction(signed_tx.rawTransaction)
    print("\nrecovered sender address", recovered_tx)
    decoded_tx = Account.decode_transaction(signed_tx.rawTransaction)
    print("\ndecoded transaction:", to_pretty(decoded_tx))
    tx_hash = w3.eth.send_raw_transaction(signed_tx.rawTransaction)
    tx_receipt = w3.eth.wait_for_transaction_receipt(tx_hash)
    print('tx hash: ', tx_hash, 'receipt: ', tx_receipt)
web3_smart_contract_execution_sign_recover()

output


❯ py smart_contract_execution_sign_recover.py
raw transaction of signed tx: 0x30f8e7820368850ba43b740083023eda94108bf12b50c9ef65525f0495c721aec55015e1118094a2a8854b1802d8cd5de631e690817c253d6a9153b8643d7403a30000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000c48656c6c6f204b6c6179746e0000000000000000000000000000000000000000f847f8458207f5a076bb764f64faba013dd74d29c5d446324fc6ea3acfff334b2344c8270402ab86a0287e81224d8a2156894ee38fd2b03a4ce3555755341a4b7a5c304f85e5fc31ff
recovered sender address 0xA2a8854b1802D8Cd5De631E690817c253d6a9153
decoded transaction: {
  "type": 48,
  "value": 0,
  "nonce": 872,
  "gasPrice": 50000000000,
  "gas": 147162,
  "to": "0x108bF12b50c9ef65525F0495C721aEc55015e111",
  "from": "0xA2a8854b1802D8Cd5De631E690817c253d6a9153",
  "data": "0x3d7403a30000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000c48656c6c6f204b6c6179746e0000000000000000000000000000000000000000",
  "signatures": [
    {
      "v": 2037,
      "r": 53704133080478071789069753996858108922624268560525338682079935754802299054982,
      "s": 18316027923575524564170275051333963542245959777309578523749620923746446225919
    }
  ],
  "chainId": 1001
}
tx hash:  0xde228b907506204482ec8e82a7409c3ab887b4c0e586d8d85287ef46c3549b3e receipt:  AttributeDict({'blockHash': HexBytes('0xeaa9de93191210426570cc0078448e104f1cf839d0833eae91382e7650f59ffd'), 'blockNumber': 147348464, 'contractAddress': None, 'cumulativeGasUsed': 39454, 'effectiveGasPrice': 25000000000, 'from': '0xA2a8854b1802D8Cd5De631E690817c253d6a9153', 'gasUsed': 39454, 'logs': [], 'logsBloom': HexBytes('0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000'), 'status': 1, 'to': '0x108bF12b50c9ef65525F0495C721aEc55015e111', 'transactionHash': HexBytes('0xde228b907506204482ec8e82a7409c3ab887b4c0e586d8d85287ef46c3549b3e'), 'transactionIndex': 0, 'type': 0})