Welcome to the Starknet Remix Plugin repository! 🎉

This powerful tool seamlessly integrates with the Remix IDE, enabling developers to effortlessly deploy and interact with Starknet contracts! Whether you're a Cairo and Starknet wizard 🧙‍♂️ or taking your very first steps, this plugin supercharges your journey by providing an effortless way to deploy and interact with Starknet contracts. Happy coding! 🚀

If you're looking to utilize the capabilities of Starknet contracts within the Remix IDE, you've come to the right place. This section provides you with a straightforward guide to get started.

1. Installation: Get excited, folks, no complicated installations needed here! If you're a user, all you have to do is head over to the Remix IDE and locate the Starknet Remix Plugin in the plugins section. Want to make it even simpler? Click right through to Remix using this direct link and you're good to go! 🎉

2. Usage: Once the plugin is activated, you'll find a user-friendly interface that allows you to deploy and interact with Starknet contracts. Follow the on-screen prompts and tooltips for an effortlessly smooth experience!

3. Feedback: Your feedback is invaluable to us 🌟! If you encounter any issues or have game-changing suggestions, don't hesitate to reach out through our Discord or our Community Forum. Let's make something awesome together! 🤝

Most issues with Starknet plugin or Remix itself are caused by connectivity problems (also resulting from restricted networks, web-proxies blocking certain content, etc.) or browser plugin interference.

• A user should first attempt to disable any browser components & addons which may impact the connectivity or Javascript execution.
• Some networks may restrict connectivity to certain sites or domains. Using a VPN connection may resolve problems observed on restricted networks.

More specific potential error causes are also described in detail below.

Our API is built with Rocket, a web framework for Rust. So, you'll need to get Rust and Cargo on your machine to get started. 🛠️

The easiest way to install Rust and Cargo is by using rustup. It's the recommended tool for managing Rust versions and associated tools for your project.

Then:

cd api;
git submodule update --init;
cargo build;

The plugin it self is a React project, you'll need to install pnpm.

cd plugin;
pnpm install;

You need to be running both the server and the plugin in order to have a working environment.

For your dev environment:

cd plugin;
export API_SERVICE_URL=http://localhost:8000
export STARKNET_DEVNET_URL=http://localhost:5050
pnpm run start;

For an optimized build (will not listen to changes):

export API_SERVICE_URL=http://localhost:8000
export STARKNET_DEVNET_URL=http://localhost:5050
pnpm run deploy;
pnpm run serve;

Depending on cairo compiler nightly may be necessary to run locally

cd api;
export VITE_URL=http://localhost:3000
cargo run;

or alternatively, you can run the server in watch mode (with cargo watch):

export VITE_URL=http://localhost:3000
cargo install cargo-watch;
cargo watch -x run;

For devnet interactions, you'll need to use Starknet Devnet.

In Remix, go to the Plugin Manager at the bottom of the left panel, and click on Connect to a Local Plugin.

Then, chose a name for the plugin, and in the URL field, enter http://localhost:3000, the Type of Connection should iframe and the Location in remix Side Panel and click on Ok, see the image below.

You should be all set to see the magic happen! Activate the plugin and it should now be visible and ready to be hacked with! 🚀

Feel free to contribute! Spotted any issues? Head on over to our good first issues or read through our Contribution Guidelines to get started. 📝

Jump into our Discord channel and join our thriving community! Connect with other users, share insights, and get all your questions answered. Our community is always eager to help newcomers! 🤝

We're thrilled for you to experience the Starknet Remix Plugin, and we can't wait to see the inventive ways you'll engage with Starknet contracts! Happy coding! 💡