โš ๏ธ

You are viewing an archived page right now. Please use the sidebar to naviagate to the latest content in Avail's docs.

How to Deploy an Appchain using Madara & Karnot

Introduction

The "Karnot Appchain" challenge, part of the groundbreaking Clash of Nodes campaign, represents an exciting collaboration between Karnot (opens in a new tab) and Avail. This guide offers developers comprehensive instructions to deploy appchains using Avail as the data availability (DA) layer.

How to Participate

To partake in the Madara | Karnot Appchain Challenge, follow these key steps:

  1. Deploy a Madara Appchain: Use the Karnot CLI for rapid deployment. You can choose to host it yourself or request the Karnot team for hosting services.
  2. Deploy on Avail's Goldberg Testnet: Opt to post your chain data to the Avail Goldberg testnet.
  3. Fund Your Account: Use the Avail Goldberg faucet to acquire tokens for the Goldberg testnet.
  4. List Your Appchain for Clash of Nodes: Create a PR to list your app chain on the official repo for the Karnot CLI, following the specified JSON format.

WHAT QUALIFIES AS AN AVAIL-POWERED APPCHAIN?
To partake in the Madara | Karnot Appchain Challenge, follow these key steps:

  1. Deploy a Madara Appchain: Use the Karnot CLI for rapid deployment. You can choose to host it yourself or request the Karnot team for hosting services.
  2. Deploy on Avail's Goldberg Testnet: Opt to post your chain data to the Avail Goldberg testnet.
  3. Fund Your Account: Use the Avail Goldberg faucet to acquire tokens for the Goldberg testnet.
  4. List Your Appchain for Clash of Nodes: Create a PR to list your app chain on the official repo for the Karnot CLI, following the specified JSON format.

How to Deploy a Madara Appchain

  1. Create a New Appchain Instance: To begin, create a new appchain instance. Detailed instructions can be found here (opens in a new tab). This step involves setting up the environment and initializing your appchain using the Karnot CLI. Ensure you select 'Avail' as the DA layer.

For help in creating an AppId, check out the AppId guide.

  1. Fund Your Avail Account: You will also need to fund your Avail account for your appchain. Visit the Avail faucet with your Avail address and follow the faucet guide instructions to secure the necessary testnet tokens for the Goldberg network.

    The faucet requires meeting a mandatory threshold using the Gitcoin passport. If necessary, you can link your Avail account on your machine with the wallet you are using for this process. Exercise caution when exporting your account's key for any reason.

  2. If Needed, Host Your Appchain with Karnot: Karnot provides comprehensive, ready-to-use services for appchains, including RPC, proof, cross-chain capabilities, and more. Fill out this form (opens in a new tab) to request hosting services.

  3. Create a PR to Register Your Appchain: For your appchain to be recognized in the Clash of Nodes campaign, you must register it by submitting a pull request in the avail-campaign-listing (opens in a new tab) repository. The PR should include a JSON configuration file named "listing.json" with the following structure:

    {
      "name": "my_app_chain",
      "logo": "https://placehold.co/400x400",
      "rpc_url": "https://rpc.myappchain.xyz",
      "explorer_url": "https://explorer.myappchain.xyz",
      "metrics_endpoint": "https://metrics.myappchain.xyz",
      "id": "942ff35e-f048-4d10-ae61-6cb970cad2f0"
    }

    Karnot PR Submission

    This configuration file includes essential details about your appchain, such as its name, logo URL, RPC endpoint, explorer URL, metrics endpoint, and a unique identifier. Ensure all information is accurate and up-to-date to facilitate smooth registration and participation in the campaign. Once the PR is merged, the appchain will appear on the Clash of Nodes Leaderboard (opens in a new tab).