Deprecate Contract Command

Deprecate Contract Command

Usage: /deprecate-contract <ContractName1> [ContractName2] [ContractName3] ...

Overview

This command completely removes one or more contracts (facets or periphery) from the codebase by:

• Dynamically discovering contract locations in src/ (works with any folder structure)
• Analyzing all references to determine what needs to be removed
• Replacing test files with similar bridge tests (for bridge facets) to maintain or increase test coverage
• Removing source files, deployment scripts, docs, and config entries
• Updating whitelist for periphery contracts
• Running test suite to verify remaining tests pass
• Parking the on-chain removal (facets) into the deferred diamond-cleanup queue so the facet can eventually be removed from the production diamonds that still register it — not just the codebase — once the parked task is later drained into a proposal and that proposal executes
• Searching for remaining occurrences for manual review

Quick Start

Examples

# Single contract
/deprecate-contract RelayFacet

# Multiple contracts
/deprecate-contract RelayFacet RelayDepositoryFacet

# Mix of facet and periphery
/deprecate-contract RelayFacet Permit2Proxy TokenWrapper

Execution Flow

The command performs these steps in order:

1. Discovery & Validation

   • Search src/ directory tree for {ContractName}.sol files
   • Determine contract type (facet if name contains "Facet", otherwise periphery)