You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Remix plugin to deploy smart contracts using OpenZeppelin Defender. For documentation about usage please visit the [Defender Docs](https://docs.openzeppelin.com/defender/remix-plugin).
7
+
Plugin to deploy smart contracts using OpenZeppelin Defender. Currently supported in:
8
+
9
+
-[Remix IDE](https://remix.ethereum.org/) - As a plugin listed in plugins directory, for more information please visit [our docs](https://docs.openzeppelin.com/defender/remix-plugin).
10
+
-[Contracts Wizard](https://wizard.openzeppelin.com/) - Integrated in code editor, for more information please visit [our docs](https://docs.openzeppelin.com/defender/remix-plugin).
8
11
9
12
## Getting Started
10
13
@@ -16,7 +19,7 @@ pnpm install
16
19
pnpm dev
17
20
```
18
21
19
-
The interface is ugly, but don't worry! it's not meant to be used directly, it's used embedded in a Remix iframe instead, and adopts its styles.
22
+
NOTE: This project is meant to be embedded in other UIs, just running the project won't be enough to see and debug it. You must embed the UI on an external iframe.
20
23
21
24
## Testing in Remix
22
25
@@ -31,4 +34,38 @@ Url: http://localhost:5173 # or live version https://defeder-remix-deploy.netlif
31
34
Type of connection: Iframe
32
35
Location in Remix: Side Panel
33
36
```
34
-
5. You should see the plugin added to the sidebar (new icon with ? symbol).
37
+
5. You should see the plugin added to the sidebar (new icon with ? symbol).
38
+
39
+
## Testing in Contracts Wizard
40
+
41
+
For testing in Contracts Wizard, you must also run the Contracts Wizard UI locally to point to your local plugin.
42
+
43
+
1. Run Contracts Wizard locally.
44
+
- a. Go to [https://github.com/OpenZeppelin/contracts-wizard](Contracts Wizard Repo).
45
+
- b. Clone the latest `master` branch and follow steps to setup the project.
46
+
- c. Move to `pacakges/ui` and run it with `yarn dev`.
47
+
2. In another terminal, run this project using `pnpm dev`, make sure the app is served in `http://localhost:5173`.
48
+
3. Open Contracts Wizard local UI, generally in `http://localhost:8080`.
49
+
4. Click on "Deploy with Defender" button, you should be able to see embedded the local plugin.
50
+
51
+
## Development
52
+
53
+
Many parts of codebase are shared across plugins (server side code, state definition, ethereum interactions, etc.), but UI components have a separated implementation to make them more flexible and prevent side-effects.
54
+
55
+
We have some bootstrap logic to expose one UI or another depending on the parent iframe domain.
56
+
57
+
### Remix
58
+
The entrypoint for Remix plugin is `src/routes/remix.svelte`. Its components mainly use [bootstrap](https://getbootstrap.com/) for styling, Remix UI injects bootstrap dependency as a <link> html tag when embedded.
59
+
60
+
### Wizard
61
+
The entrypoint for Contracts Wizard plugin is `src/routes/wizard.svelte`. Its components mainly use [tailwind CSS](https://tailwindcss.com/) for styling, this is mainly for convenience, since Contracts Wizard was made using this CSS framework.
62
+
63
+
## Release
64
+
65
+
The repo has a CI/CD connected to our netlify account, when we merge `main` to some of the release branches, a new version of the plugin is released to live. Branches:
66
+
67
+
- Remix IDE Plugin - `release-remix`
68
+
- Contracts Wizard Plugin - `release-wizard`
69
+
70
+
> [!WARNING]
71
+
> We use `main` branch as the single source of truth and it's the only branch allowed to be merged to release branches. It should be tested carefully before triggering a new release.
0 commit comments