idl: Store deployment addresses for other clusters

Problem

It's currently not possible to store program address information for other clusters.

Solution

Initially, I thought of making the top-level address field an enum:

pub enum IdlAddress {
    Multiple {
        mainnet: Option<String>,
        testnet: Option<String>,
        devnet: Option<String>,
        localnet: Option<String>,
    },
    #[untagged]
    Single(String),
}

This way, we could support both string address as a default and an object type for more detailed (cluster based) information. However, the program's IDL may also exist in other clusters, which makes the current IDL (the one we got the other deployment addresses from) useless (because the IDL in the cluster should be fetched). For this reason, it made more sense to store this information in the metadata field compared to the top-level address field:

pub struct IdlDeployments {
    pub mainnet: Option<String>,
    pub testnet: Option<String>,
    pub devnet: Option<String>,
    pub localnet: Option<String>,
}

Summary of changes

Add metadata.deployments field that optionally stores deployment addresses in mainnet, testnet, devnet and localnet.

coral-xyz / anchor