Title: `[Draft] Retroactive Funding: Safe {Core} Migration Logic & ERC-4337 Toolkit`
Authors: JG_Cipher
Created: 2026-01-04
Abstract
This is a retroactive funding proposal for the creation of the Safe Smart Account Migration Toolkit. I have developed an open-source architectural reference implementation (live now) that bridges the gap between legacy Safe architectures and the new v1.5.0 Singleton logic, specifically solving the “Storage Collision” and “Guard Implementation” friction points for developers migrating to ERC-4337.
Proposal types
[ ] SEP: Constitutional Proposals
[ ] SEP: Governance Proposals
[x] Other SEPs
Proposal details
Purpose and Background: As Safe pivots to full ERC-4337 native support, there is a critical lack of technical documentation guiding developers on how to migrate safely.
The Problem: Developers struggle to implement correct “Guard” logic to prevent storage collisions during the `Proxy-to-Singleton` update.
The Solution: I have reverse-engineered the migration flow and built a dedicated repository that acts as a “Starter Kit” for institutional migration. This resource is already built and live to demonstrate Proof of Work.
Effects and Impact Analysis
Pros: Significantly reduces the support burden on the Safe Foundation team. Accelerates institutional adoption of v1.5.0 by providing copy-pasteable architectural patterns.
Risks: None. The repository is documentation and reference logic, not a protocol upgrade.
Impact: immediate availability of high-level technical resources for the community.
Alternative Solutions
Manual Migration Support: The Foundation could manually assist every integrator, which is unscalable and expensive.
Do Nothing: Leaves developers to guess the storage slot alignment, leading to potential “bricked” vaults and security incidents.
My Solution: An open-source, community-verified reference kit is the most scalable path.
Implementation:
[x] Own implementation possible
[ ] Own implementation but with funding
[ ] Request for technical support
Status: Complete & Live.
Deliverables:
1. Migration Logic: `Proxy-to-Singleton` update flow.
2. Guardrails Architecture: Transaction Guards to block unauthorized `delegatecall`.
3. UserOperation Lifecycle: ERC-4337 integration guide.
Funding Request: I am requesting a retroactive grant of 3,000 USDC to cover the engineering and documentation hours.
Wallet Address (ERC20):[0xddb0109bcb3e6ac4e5d1c5ec9c06fbcdf9c30289]
Open Questions
None. The work is completed and available for audit.
Copyright
Copyright and related rights waived via CC0.