feat(oracle): wire corporate-action auto-pause into BasePythOracleAdapter (RAI-320)

[hardyjosh]

Implements SPEC § 16. Both PythOracleAdapter and MultiPythOracleAdapter inherit auto-pause behaviour through the shared base.

Storage on BasePythOracleAdapter (immutable post-init):

• corporateActionsVault — address implementing ICorporateActionsV1 (zero disables)
• actionTypeMask — bitmap of action types that trigger a pause
• pauseTimeBefore / pauseTimeAfter — window around an action's effectiveTime

_validateNotPaused now checks both:

1. The manual paused flag (cheap SLOAD, takes precedence) → reverts OraclePausedManual
2. LibCorporateActionsPause.inPauseWindow on the configured vault → reverts OraclePausedCorporateAction(uint64 effectiveTime)

OraclePaused is removed. Distinct error selectors let integrators disambiguate via static-call introspection or simulation. The breaking-change implications are flagged for the migration plan (RAI-323).

Both adapter Config structs gain a CorporateActionPauseConfig pauseConfig field. All-zero is the legacy/manual-only mode.

The OracleUnifiedDeployer and MultiOracleUnifiedDeployer pass through an empty pauseConfig for now — RAI-322 extends their signatures to accept the four fields. Existing callers see no behaviour change.

7 new adapter-level tests in PythOracleAdapter.autoPause.t.sol exercise the wiring against a MockCorporateActions stub: zero-vault short-circuit, pending/completed in-window reverts on both latestAnswer and latestRoundData, manual-pause precedence, and that lifting the manual flag re-surfaces the auto-pause error. Algorithm correctness lives in the lib's tests (PR for RAI-319).

Existing tests are migrated to the new config shape via a default-empty pauseConfig helper on each test fixture; OraclePaused selectors are renamed to OraclePausedManual.

[linear]

RAI-320

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: e64b75eb-be50-42dd-a2cf-d879ba5d3520

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/auto-pause-base-adapter

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[hardyjosh]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• docs: README refresh + integrator notes for corporate-action auto-pause (RAI-325) #26 : 2 dependent PRs (#221 , #238 )
• feat(deploy): thread CorporateActionPauseConfig through unified deployers (RAI-322) #25
• test: auto-pause revert propagation through protocol adapters (RAI-321) #24
• feat(oracle): wire corporate-action auto-pause into BasePythOracleAdapter (RAI-320) #23 👈 (View in Graphite)
• feat(lib): LibCorporateActionsPause reader helper (RAI-319) #22
• docs(spec): corporate-action-aware auto-pause semantics (RAI-318) #21
• deps: migrate from git submodules to soldeer #237
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.