Skip to content

fix[venom]: guard sdiv/smod range eval at sign boundary#5093

Open
banteg wants to merge 2 commits into
vyperlang:masterfrom
banteg:fix/signed-range-boundary
Open

fix[venom]: guard sdiv/smod range eval at sign boundary#5093
banteg wants to merge 2 commits into
vyperlang:masterfrom
banteg:fix/signed-range-boundary

Conversation

@banteg

@banteg banteg commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

What I did

Fixes #5045.

The Venom variable-range domain can represent intervals like [0, 2**256 - 32] whose members above SIGNED_MAX are negative EVM words under signed interpretation. eval_sdiv and eval_smod reasoned about sign from raw lo/hi, so e.g. smod([0, 2**256 - 32], 10) folded to [0, 9] even though the member 2**256 - 32 (signed -32) yields -2 (2**256 - 2 as a word) — outside the claimed range.

How I did it

Both evaluators now guard ranges extending above SIGNED_MAX, using the same boundary idiom eval_sar already has: eval_sdiv bails to ValueRange.top(), and eval_smod falls back to the magnitude bound [-(|d|-1), |d|-1], which is sound for any dividend word (it is the same result the existing spans-zero branch returns, so smod(TOP, d) keeps its precision). Constant-dividend paths are unaffected (literals are normalized to signed representation before evaluation). Siblings audited: eval_sar already guarded; eval_and is tracked separately in #5012.

While auditing, one further candidate surfaced for a follow-up: the signed compare folding (slt/sgt) in eval_compare reasons from raw lo/hi with no hi > SIGNED_MAX guard — not touched here to keep the diff scoped.

How to verify it

Four new analysis-level tests (per the test_eval_byte.py convention) cover spanning and entirely-above-boundary dividend ranges for both opcodes; all fail on master (e.g. smod returned [0, 9]). Full tests/unit/venom/ and tests/unit/compiler/venom/ pass.

Commit message

the variable-range domain can represent intervals with lo >= 0 and
hi > SIGNED_MAX, whose high members are negative EVM words under
signed interpretation. eval_sdiv and eval_smod reasoned about sign
from raw lo/hi, so e.g. smod([0, 2**256 - 32], 10) was folded to
[0, 9] even though the member 2**256 - 32 (signed -32) yields -2,
i.e. 2**256 - 2 as a word.

guard ranges extending above SIGNED_MAX, matching the existing
eval_sar boundary guard: sdiv bails to TOP, and smod falls back to
the magnitude bound [-(|d|-1), |d|-1], which is sound for any
dividend word.

Description for the changelog

Fix: Venom range analysis no longer makes unsound sign-based claims for sdiv/smod when the dividend range crosses the signed boundary.

Cute Animal Picture

cute animal

@codecov

codecov Bot commented Jun 16, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.93%. Comparing base (242a4fa) to head (ffe75a1).
⚠️ Report is 16 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #5093   +/-   ##
=======================================
  Coverage   92.93%   92.93%           
=======================================
  Files         188      188           
  Lines       27840    27845    +5     
  Branches     4831     4833    +2     
=======================================
+ Hits        25874    25879    +5     
  Misses       1315     1315           
  Partials      651      651           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.


def test_smod_dividend_spanning_sign_boundary():
"""
Bug: smod narrowed based on raw lo/hi signs for ranges crossing the

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are there any venom optimization passes which were previously unsound but are sound after this PR? i would like to see those tests

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added optimizer-level coverage in d8e60d8. The new AssertEliminationPass tests cover both sdiv and smod: %x = and source, 2**256 - 32 creates a range that includes the signed word -32, and the pass must not remove assert (sgt result, -1). Validated with uv run --python 3.12 -m pytest tests/unit/venom/test_assert_elimination.py tests/unit/venom/test_variable_range_analysis.py -q, black check, and git diff --check.

@github-actions

Copy link
Copy Markdown

Gas Changes

No changes detected.

Summary

  • Total tests measured: 815
  • Changed: 0
  • Regressions (gas up): 0
  • Improvements (gas down): 0
  • New tests: 0
  • Deleted tests: 0
  • Newly failing: 0
  • Newly passing: 0

@github-actions

Copy link
Copy Markdown

📊 Bytecode Size Changes (venom)

Contract legacy-O2 legacy-Os -O2 -O3 -Os
curvefi/amm/twocryptoswap/math/math_v_210.vy 6800 6800 5619 (🔴+38) 5117 (🔴+10) 5122 (🔴+10)

Full bytecode sizes

Contract legacy-O2 legacy-Os -O2 -O3 -Os
curvefi/amm/stableswap/meta_implementation/meta_implementation_v_700.vy 23610 22805 20786 19755 19315
curvefi/legacy/CurveStableSwapMetaNG.vy 24952 23578 20490 19871 19175
curvefi/amm/stableswap/implementation/implementation_v_700.vy 24962 23769 20264 19393 18845
curvefi/legacy/CurveStableSwapNG.vy 24473 23298 19677 18844 18314
curvefi/amm/tricryptoswap/implementation/implementation_v_200.vy 20724 19959 18020 17518 16961
yearnfi/VaultV3.vy 19972 19063 17017 15131 14477
curvefi/amm/twocryptoswap/implementation/implementation_v_210.vy 17634 16894 15685 15132 14648
curvefi/legacy/CurveCryptoSwap2.vy 18947 18382 15634 15092 14711
yearnfi/VaultV2.vy 16676 15763 13863 13405 12574
curvefi/amm/stableswap/factory/factory_v_100.vy 14558 13978 13317 11825 11788
curvefi/gauge/child_gauge/implementation/implementation_v_110.vy 12338 11561 10270 9775 9182
curvefi/gauge/child_gauge/implementation/implementation_v_100.vy 12017 11249 9998 9502 8920
curvefi/amm/stableswap/views/views_v_120.vy 12784 12368 9970 9413 9532
curvefi/amm/tricryptoswap/math/math_v_200.vy 11189 11126 9520 8162 8424
curvefi/legacy/CurveCryptoMathOptimized3.vy 11188 11125 9519 8162 8424
curvefi/gauge/child_gauge/implementation/implementation_v_020.vy 10665 9947 9013 8565 8028
curvefi/helpers/router/router_v_110.vy 6717 6717 7003 6376 6607
curvefi/amm/tricryptoswap/views/views_v_200.vy 7821 7776 6697 6445 6514
curvefi/registries/metaregistry/metaregistry_v_110.vy 7590 6732 6651 5888 5727
curvefi/helpers/stable_swap_meta_zap/stable_swap_meta_zap_v_100.vy 7302 7067 6379 6012 6114
curvefi/amm/twocryptoswap/views/views_v_200.vy 6991 6946 6272 6026 6089
curvefi/amm/twocryptoswap/factory/factory_v_200.vy 5540 5252 5994 4697 4845
curvefi/amm/tricryptoswap/factory/factory_v_200.vy 5246 5021 5923 4926 5039
curvefi/registries/metaregistry/registry_handlers/stableswap/handler_v_110.vy 6633 6259 5859 5094 5562
curvefi/amm/twocryptoswap/math/math_v_210.vy 6800 6800 5619 5117 5122
curvefi/gauge/child_gauge/factory/factory_v_201.vy 4844 4547 4266 4014 3780
yearnfi/VaultFactory.vy 3765 3617 3985 2505 2965
curvefi/registries/metaregistry/registry_handlers/tricryptoswap/handler_v_110.vy 4241 3939 3838 3547 3547
curvefi/registries/metaregistry/registry_handlers/twocryptoswap/handler_v_110.vy 4186 3884 3777 3417 3433
curvefi/gauge/child_gauge/factory/factory_v_100.vy 4183 3914 3694 3428 3213
curvefi/helpers/rate_provider/rate_provider_v_101.vy 3260 3260 2779 2437 2450
curvefi/registries/address_provider/address_provider_v_201.vy 2973 2782 2713 2569 2424
curvefi/amm/stableswap/math/math_v_100.vy 3067 3046 2598 2403 2423
curvefi/helpers/rate_provider/rate_provider_v_100.vy 2847 2841 2357 2050 2058
curvefi/helpers/deposit_and_stake_zap/deposit_and_stake_zap_v_100.vy 2322 2316 2123 1889 1921
curvefi/governance/relayer/taiko/relayer_v_001.vy 2068 2064 1784 1579 1612
curvefi/governance/relayer/polygon_cdk/relayer_v_101.vy 1556 1523 1587 1405 1406
curvefi/governance/relayer/arb_orbit/relayer_v_101.vy 1266 1262 1280 1124 1155
curvefi/governance/relayer/op_stack/relayer_v_101.vy 1186 1182 1219 1066 1094
curvefi/governance/relayer/not_rollup/relayer_v_100.vy 1168 1153 1208 1061 1073
curvefi/governance/vault/vault_v_100.vy 964 941 885 866 864
curvefi/governance/relayer/relayer_v_100.vy 496 496 600 505 510
curvefi/governance/agent/agent_v_100.vy 541 541 443 415 419
curvefi/governance/agent/agent_v_101.vy 541 541 443 415 419

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Signed range evaluators for sdiv and smod ignore sign-boundary ranges

3 participants