bea1903ac9
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
2.6 KiB
2.6 KiB
Safe (Gnosis) Packages Migration Plan
Last Updated: 2026-02-16
Status: Complete — migrated to @safe-global/protocol-kit v1 (ethers v5)
Current State
Package: smom-dbis-138/frontend-dapp (bridge-dapp)
| Package | Status | Replacement |
|---|---|---|
@safe-global/safe-core-sdk |
Deprecated | @safe-global/protocol-kit |
@safe-global/safe-ethers-lib |
Deprecated (bundled in protocol-kit) | @safe-global/protocol-kit |
@safe-global/safe-service-client |
Deprecated | @safe-global/api-kit |
@safe-global/api-kit |
In use | Already v4 — keep |
Migration Path
Step 1: Protocol Kit (replaces safe-core-sdk + safe-ethers-lib)
- Docs: https://docs.safe.global/sdk/protocol-kit/guides/migrate-to-v1
- Install:
pnpm add @safe-global/protocol-kit - Remove:
@safe-global/safe-core-sdk,@safe-global/safe-ethers-lib - Code changes:
- Replace
SafeFactory,SafeAccountConfigimports from safe-core-sdk with protocol-kit equivalents - Replace ethers adapters — protocol-kit uses ethers v6; bridge-dapp currently uses ethers v5 — may need adapter layer or upgrade ethers
- Replace
- Vite config: Update
vite.config.tsexclude/include lists (remove old, add protocol-kit if needed)
Step 2: API Kit (replaces safe-service-client)
- Docs: https://docs.safe.global/sdk/api-kit/guides/migrate-to-v1
- Already have:
@safe-global/api-kit@^4.0.1 - Remove:
@safe-global/safe-service-client - Code changes: Replace SafeServiceClient usage with ApiKit equivalents (see migration guide)
Step 3: Verification
- Run
pnpm run buildin smom-dbis-138/frontend-dapp - Test multisig / Safe deployment flows in admin panel
- Ensure WalletDeploymentEnhanced and any Safe-related components work
Affected Files
smom-dbis-138/frontend-dapp/package.jsonsmom-dbis-138/frontend-dapp/vite.config.tssmom-dbis-138/frontend-dapp/src/components/admin/WalletDeploymentEnhanced.tsx(SafeFactory import commented out)- Any component using SafeServiceClient or Safe SDK
Blockers / Notes
- ethers v5 vs v6: bridge-dapp uses ethers v5; protocol-kit prefers ethers v6. Check protocol-kit compatibility or use adapter.
- supertest migrated: token-aggregation report tests now use native fetch + http server (no deprecated supertest).