Eclipse Program Registry Guide

What is the Eclipse Program Registry?

The Eclipse Program Registry serves as a somewhat comprehensive list of programs running on the Eclipse network. It can be found here.

This guide will walk you through the steps necessary to add your program to the registry.

Prerequisites

Before you submit your program to the registry, ensure you have:

  • A program deployed on the Eclipse blockchain.

  • A public GitHub repository for your program's code.

    • Your repository should be prepared according to this guide so the program can be verified against the source code.

  • A published IDL (Interface Definition Language) on-chain.

    • The Anchor CLI docs show you how to do this. You'll need to use initif it's your first time, or upgradeif you're updating the IDL.

    • When done correctly, a published IDL will look like this on our explorer.

Submission Process

To submit your program to the Eclipse Program Registry, you need to create a pull request (PR) with the following items completed:

  1. Update programs.yaml File

Add an entry for your program in the programs.yaml file. The example below uses our Canonical Bridge. Replace the info with your program's details.

- name: canonical_bridge
  description: The Eclipse Canonical Bridge facilitates depositing and withdrawing ether from the Eclipse Chain
  repo: https://github.com/Eclipse-Laboratories-Inc/syzygy/tree/main/solana-programs/canonical_bridge
  icon: https://i.imgur.com/y0JEPfQ.png
  framework: Anchor
  program_address: br1xwubggTiEZ6b7iNZUwfA3psygFfaXGfZ1heaN9AW
  categories:
    - Bridge

After Submission

After your pull request is created:

  • The Eclipse team will review your submission.

  • If all criteria are met, your PR will be merged.

  • Upon successful merging, your program will be eligible to be featured in the Eclipse Program Explorer.

Was this helpful?