Alchemy API

Synchronize transactions going through your Alchemy app with Ethernal

Alchemy API is a gateway to different Ethereum public networks (Mainnet, Kovan, ...), but unlike others, it also provides development tools on top of that. You can, for example, explore & replay raw transactions that you sent through their node, making it very useful for debugging decentralized apps.

One interesting feature that Alchemy provides is triggering a webhook every time a transaction going through their RPC endpoint is mined. So we built an endpoint that can receive those webhooks, fetch the corresponding block & transaction on the network, and combine it with your contract's metadata, turning all of this in a dashboard that can give you a complete, and easy to read view of what's going on with your dapp.


You can set up this integration in any workspace, but, to avoid mixing your data, we recommend that you create another one. A good practice is to have one workspace per Alchemy endpoint.

Get your Alchemy endpoint in your dashboard, and create a new workspace with it on Ethernal ( "Settings" > "Create Workspace").

Once this is done, in the "Integrations" panel, click on "Manage" next to "Alchemy API". Toggle the switch in the modal window, and your webhook endpoint will appear.

Alchemy Webhook Activation

Now, for the last step of the setup, go back to the "Notify" section of your Alchemy dashboard. (The link is in the top navigation bar).

Scroll down to "Mined Transaction Notifications", click on "Create Webhook", select the app, paste the webhook in the field, confirm, and you are done!

Now all your dapp transactions will appear on your Ethernal dashboard, a few seconds after they have been mined.

One last thing to note: as mentioned above, running your CLI on this workspace would synchronize every block of the network. If you want to only synchronize contract metadata, run the cli with the -l option: ethernal listen -d ~/solidity/token -l

If you run into any issues, feel free to send an email to [email protected], or to ask me (@antoinedc) on the Discord server. We'll also happily take integrations requests if you know of other Ethereum gateways that provide similar webhooks!