crane-architecture

Structure upgradeable smart contracts by separating logic into Facet, Target, and Repo layers. Start with Repo-first storage management, then build the Target and Facet components to expose proxy functionality within the ERC2535 diamond pattern.

The Facet-Target-Repo separation is a modular contract pattern governing upgradeability and code organization. Repos manage storage slots, Targets handle logic, and Facets expose functions to the diamond proxy for clean separation of concerns.

Manage storage slots using dual layout functions and guard functions. This pattern ensures safe access control and prevents storage collisions when multiple Facets and Targets interact within a single diamond proxy contract.

Yes, Diamond Factory Package patterns support scalable deployments and integrations. They provide structured guidance for generating new diamond instances, incorporating AwareRepo and service patterns for extensible contract architectures.

The recommended workflow is to architect with Repo-first storage, then build the Target and Facet layers for proxy exposure. This ensures proper storage-slot management and access control before deploying the diamond pattern.

Use AwareRepo and service patterns when building scalable deployments that require complex integrations. These patterns extend the standard Facet-Target-Repo architecture to handle cross-component awareness and service-oriented contract interactions.