¶ Technical requirements
To be included in the DApp Browser, some technical hurdles have to be overcome.
First of all, the bridge:
cardano-dapp-connector-bridge
Browser extensions on desktop can inject any code into a host website. Wallets use that to inject their API into any dapp page. That's of course not possible, if we embed your page into Eternl. The only way to communicate is window.postMessage and that's what this bridge is all about. It follows its own small protocol, does a handshake and establishes comms between any wallet (that implements this) and the allowing dapp page.
Please take a look at
README.md
(for a technical "getting started") and
EternlDAppBrowser.md
(for the implementation of the Eternl "convenience fee").
¶ Testing
For integration tests, please use: https://staging.eternl.io/
The DApp Browser page has a URL input field on top. Enter the URL to your dapp staging/production page to see whether it loads properly. Please see the section about Response headers in the README.md of the bridge.
Please check the browser's dev console network section to find any erros (check the response headers of failing requests).
¶ Checklist
- no errors while loading the page in the DApp Browser
- the page works on mobile browsers (iOS: Safari, Android: Chrome)
- the Eternl convenience fee is implemented (or for minting projects a 0.5% commision is accepted)
¶ Integration
Please open a support ticket now and provide us with your staging/production URLs and please also provide an image (728x256px) for the DApp Browser entry.
We will put your entry in our staging environment and you can do the final tests. Once you are sure it works, we can move it to production.
