30572716388
89%
main: 89%

Ran 30 Jul 2026 07:01PM UTC

Jobs 4

Files 334

Run time 1min

Badge

Embed ▾

Committed 30 Jul 2026 06:57PM UTC coverage: 89.022% (+0.006%) from 89.016%

Build # 30572716388

Build Type

push

github

Committed by

web-flow

Commit Message

Improve QPY version mismatch error when deserializing jobs (#3002)

Peek the QPY header before `qpy.load` and raise a clear `QiskitError`
when the embedded Qiskit version is newer than the installed one. Fixes
#2426.

When job data includes circuits serialized with a newer Qiskit than the
client has installed, users used to get a vague warning from
`qiskit.qpy.load` about a "provided QPY file." This PR checks the QPY
header in `RuntimeDecoder` first and fails with a short message that
names both versions and suggests `pip install -U qiskit`.

###Changes

- Add `_validate_qpy_qiskit_version` / `_load_qpy` in `json.py`; use
them for `QuantumCircuit` and `Instruction` decoding.
- Release note: `release-notes/unreleased/2426.bug.rst`
- Tests: `TestQpyQiskitVersionValidation` (newer version → clear error;
matching version still decodes)
- Did not change when `job.inputs` loads data, `service.job()` already
skips params, so this covers the paths that actually call `qpy.load`.

Fixes #2426

### AI/LLM disclosure

- [x] I didn't use LLM tooling, or only used it privately.
- [ ] I used the following tool to help write this PR description:
- [ ] I used the following tool to generate or modify code:

Coverage Stats

9236 of 10375 relevant lines covered (89.02%)

3.53 hits per line

Coverage Regressions

Lines	Coverage	∆	File
34	88.06	0.18%	qiskit_ibm_runtime/json.py

Jobs

ID	Job ID	Ran	Files	Coverage
1	unit-tests_python3.12-windows-latest - 30572716388.1	30 Jul 2026 07:03PM UTC	334	87.58	GitHub Action Run
2	unit-tests_python3.10-ubuntu-latest - 30572716388.2	30 Jul 2026 07:01PM UTC	334	89.01	GitHub Action Run
3	unit-tests_python3.13-windows-latest - 30572716388.3	30 Jul 2026 07:03PM UTC	334	87.58	GitHub Action Run
4	unit-tests_python3.13-macos-latest - 30572716388.4	30 Jul 2026 07:02PM UTC	334	89.01	GitHub Action Run

Qiskit / qiskit-ibm-runtime / 30572716388
89%
main: 89%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 30572716388

Qiskit / qiskit-ibm-runtime / 30572716388 89% main: 89%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 30572716388

Qiskit / qiskit-ibm-runtime / 30572716388
89%
main: 89%

README BADGES
x