wake.ir.expressions.new_expression module

NewExpression class

Bases: ExpressionAbc

A new expression may create:

• a new contract, e.g. new ERC20(),
• a new array, e.g. new uint[](10),
• a new bytes or string, e.g. new bytes(10).

Source code in wake/ir/expressions/new_expression.py

class NewExpression(ExpressionAbc):
    """
    A new expression may create:

    - a new contract, e.g. `:::solidity new ERC20()`,
    - a new array, e.g. `:::solidity new uint[](10)`,
    - a new `:::solidity bytes` or `:::solidity string`, e.g. `:::solidity new bytes(10)`.
    """

    _ast_node: SolcNewExpression
    _parent: weakref.ReferenceType[SolidityAbc]  # TODO: make this more specific

    _type_name: TypeNameAbc

    def __init__(
        self, init: IrInitTuple, new_expression: SolcNewExpression, parent: SolidityAbc
    ):
        super().__init__(init, new_expression, parent)
        self._type_name = TypeNameAbc.from_ast(init, new_expression.type_name, self)

    def __iter__(self) -> Iterator[IrAbc]:
        yield self
        yield from self._type_name

    @property
    def parent(self) -> SolidityAbc:
        return super().parent

    @property
    def children(self) -> Iterator[TypeNameAbc]:
        """
        Yields:
            Direct children of this node.
        """
        yield self._type_name

    @property
    def type_name(self) -> TypeNameAbc:
        """
        Is:

        - [UserDefinedTypeName][wake.ir.type_names.user_defined_type_name.UserDefinedTypeName] referencing [ContractDefinition][wake.ir.declarations.contract_definition.ContractDefinition] when creating a new contract,
        - [ArrayTypeName][wake.ir.type_names.array_type_name.ArrayTypeName] when creating a new array,
        - [ElementaryTypeName][wake.ir.type_names.elementary_type_name.ElementaryTypeName] when creating new `:::solidity bytes` or `:::solidity string`.

        Returns:
            Type name of the object to be created.
        """
        return self._type_name

    @property
    def is_ref_to_state_variable(self) -> bool:
        return False

    @property
    def modifies_state(
        self,
    ) -> Set[Tuple[Union[ExpressionAbc, StatementAbc, YulAbc], ModifiesStateFlag]]:
        if isinstance(self.type, Contract):
            return {(self, ModifiesStateFlag.DEPLOYS_CONTRACT)}
        else:
            return set()

children: Iterator[TypeNameAbc] property

Yields:

Type	Description
TypeNameAbc	Direct children of this node.

type_name: TypeNameAbc property

Is:

• UserDefinedTypeName referencing ContractDefinition when creating a new contract,
• ArrayTypeName when creating a new array,
• ElementaryTypeName when creating new bytes or string.

Returns:

Type	Description
TypeNameAbc	Type name of the object to be created.