contract

Nep11TransferEvent: Event

The NEP-11 Transfer event that should be triggered whenever a non-fungible token is transferred, minted or burned. It needs the addresses of the sender, receiver, amount transferred and the id of the token.

Check out the proposal or Neo’s Documentation about this NEP.

>>> Nep11TransferEvent(b'\xd1\x17\x92\x82\x12\xc6\xbe\xfa\x05\xa0\x23\x07\xa1\x12\x55\x41\x06\x55\x10\xe6',  # when calling, it will return None, but the event will be triggered
...                    b'\x18\xb7\x30\x14\xdf\xcb\xee\x01\x30\x00\x13\x9b\x8d\xa0\x13\xfb\x96\xac\xd1\xc0', 1, '01')
{
    'name': 'Transfer',
    'script hash': b'\x13\xb4\x51\xa2\x1c\x10\x12\xd6\x13\x12\x19\x0c\x15\x61\x9b\x1b\xd1\xa2\xf4\xb2',
    'state': {
        'from': b'\xd1\x17\x92\x82\x12\xc6\xbe\xfa\x05\xa0\x23\x07\xa1\x12\x55\x41\x06\x55\x10\xe6',
        'to': b'\x18\xb7\x30\x14\xdf\xcb\xee\x01\x30\x00\x13\x9b\x8d\xa0\x13\xfb\x96\xac\xd1\xc0',
        'amount': 1,
        'tokenId': '01'
    }
}

Nep17TransferEvent: Event

The NEP-17 Transfer event that should be triggered whenever a fungible token is transferred, minted or burned. It needs the addresses of the sender, receiver and the amount transferred.

Check out the proposal or Neo’s Documentation about this NEP.

>>> Nep17TransferEvent(b'\xd1\x17\x92\x82\x12\xc6\xbe\xfa\x05\xa0\x23\x07\xa1\x12\x55\x41\x06\x55\x10\xe6',  # when calling, it will return None, but the event will be triggered
...                    b'\x18\xb7\x30\x14\xdf\xcb\xee\x01\x30\x00\x13\x9b\x8d\xa0\x13\xfb\x96\xac\xd1\xc0', 100)
{
    'name': 'Transfer',
    'script hash': b'\x17\xe3\xca\x91\xca\xb7\xaf\xdd\xe6\xba\x07\xaa\xba\xa1\x66\xab\xcf\x00\x04\x50',
    'state': {
        'from': b'\xd1\x17\x92\x82\x12\xc6\xbe\xfa\x05\xa0\x23\x07\xa1\x12\x55\x41\x06\x55\x10\xe6',
        'to': b'\x18\xb7\x30\x14\xdf\xcb\xee\x01\x30\x00\x13\x9b\x8d\xa0\x13\xfb\x96\xac\xd1\xc0',
        'amount': 100
    }
}

Nep17Contract(): Deprecated since version 1.3.0: This module is deprecated. Use boa3.sc.types instead

NeoAccountState()

Represents the account state of NEO token in the NEO system.

Variables:

balance (int) – the current account balance, which equals to the votes cast
height (int) – the height of the block where the balance changed last time
vote_to (boa3.builtin.type.ECPoint) – the voting target of the account

Deprecated since version 1.3.0: This module is deprecated. Use boa3.sc.types instead

abort(msg: str | None = None)

Aborts the execution of a smart contract. Using this will cancel the changes made on the blockchain by the transaction.

>>> abort()     # abort doesn't return anything by itself, but the execution will stop and the VMState will be FAULT
VMState.FAULT

>>> abort('abort message')
VMState.FAULT

Deprecated since version 1.3.0: This module is deprecated. Use boa3.sc.utils instead

to_hex_str(data: bytes) → str

Converts bytes into its string hex representation.

>>> to_hex_str(ECPoint(bytes(range(33))))
'201f1e1d1c1b1a191817161514131211100f0e0d0c0b0a09080706050403020100'

>>> to_hex_str(b'1234567891')
'31393837363534333231'

Parameters:: data (bytearray or bytes) – data to represent as hex.
Returns:: the hex representation of the data
Return type:: str

Deprecated since version 1.3.0: This module is deprecated. Use boa3.sc.utils instead

to_script_hash(data_bytes: Any) → bytes

Converts a data to a script hash.

>>> to_script_hash(ECPoint(bytes(range(33))))
b'\x12\xc8z\xfb3k\x1e4>\xb3\x83\tK\xc7\xdch\xe5\xee\xc7\x98'

>>> to_script_hash(b'1234567891')
b'\x4b\x56\x34\x17\xed\x99\x7f\x13\x22\x67\x40\x79\x36\x8b\xa2\xcd\x72\x41\x25\x6d'

Parameters:: data_bytes (Any) – data to hash
Returns:: the script hash of the data
Return type:: bytes

Deprecated since version 1.3.0: This module is deprecated. Use boa3.sc.utils instead