Method step

xqvm_py/executor.py:264–308

Execute a single instruction. Returns: True if execution should continue, False if halted or at end Raises: XQVMError: On execution errors

(self)

        return self.state.steps

    def step(self) -> bool:
        """
        Execute a single instruction.

        Returns:
            True if execution should continue, False if halted or at end

        Raises:
            XQVMError: On execution errors
        """
        if self.program is None:
            return False

        if self.state.halted or self.state.pc >= len(self.program):
            return False

        instr = self.program[self.state.pc]

        if self.tracer:
            self.tracer.on_step_begin(self, instr)

        try:
            handler = self._dispatch.get(instr.opcode)
            if handler is None:
                raise InvalidOpcode(instr.opcode)

            old_pc = self.state.pc
            handler(instr)

            # Advance PC only if handler didn't modify it (via jump or halt)
            if not self.state.halted and self.state.pc == old_pc:
                self.state.advance_pc()

        except Exception as e:
            if self.tracer:
                self.tracer.on_error(self, instr, e)
            raise

        if self.tracer:
            if self.state.halted:
                self.tracer.on_halt(self)
            else:
                self.tracer.on_step_end(self, instr)

        return not self.state.halted

    # =========================================================================
    # Helper Methods