feat: fund mcms pdas [CLD-2765]

mcms/changesets/doc.go

@@ -0,0 +1,34 @@
+// Package changesets provides multi-family MCMS changesets.
+//
+// Start here when looking for a changeset to use. Each subdirectory is a
+// self-contained changeset with a chain-agnostic entrypoint ([Changeset], Config,
+// and optionally a registry for per-family sequences).
+//
+// # Multi-family changesets (this directory)
+//
+//   - set-config — configure MCMS contracts across chains
+//   - deploy — deploy the standard MCMS topology
+//   - deploy-custom-topology — deploy an arbitrary MCMS topology
+//   - transfer-to-timelock — transfer contract ownership to a timelock
+//   - firedrill — MCMS firedrill operations
+//
+// Import path pattern:
+//
+//	github.com/smartcontractkit/cld-changesets/mcms/changesets/<name>
+//
+// Blank-import the chain families you need, for example:
+//
+//	_ "github.com/smartcontractkit/cld-changesets/mcms/evm/set-config"
+//	_ "github.com/smartcontractkit/cld-changesets/mcms/solana/set-config"
+//
+// # Family-only changesets
+//
+// Some changesets are inherently specific to one chain family and have no
+// chain-agnostic wrapper. Solana-only changesets live under
+// mcms/solana/changesets (for example fund-mcm-pdas). EVM-only changesets
+// would follow mcms/evm/changesets if added in the future.
+//
+// Family implementation packages (mcms/evm/<name>, mcms/solana/<name>) contain
+// sequences and operations registered by multi-family changesets via init.
+// Solana-only changesets live under mcms/solana/changesets.
+package changesets

mcms/solana/changesets/doc.go

@@ -0,0 +1,16 @@
+// Package changesets holds Solana-only MCMS changesets.
+//
+// Multi-family changesets (set-config, deploy, firedrill, and others) live under
+// mcms/changesets and register per-family implementations from mcms/solana/<name>
+// and mcms/evm/<name>. Solana-only changesets that have no chain-agnostic layer
+// — because the concept is inherently Solana-specific — live here instead.
+//
+// # Available changesets
+//
+//   - fund-mcm-pdas — fund MCMS signer PDAs with lamports
+//     (github.com/smartcontractkit/cld-changesets/mcms/solana/changesets/fund-mcm-pdas)
+//
+// Import path pattern:
+//
+//	github.com/smartcontractkit/cld-changesets/mcms/solana/changesets/<name>
+package changesets

mcms/solana/changesets/fund-mcm-pdas/changeset.go

@@ -0,0 +1,91 @@
+package fundmcmpdas
+
+import (
+	"errors"
+	"fmt"
+
+	"github.com/smartcontractkit/chainlink-deployments-framework/changeset/sequenceutils"
+	"github.com/smartcontractkit/chainlink-deployments-framework/datastore"
+	cldf "github.com/smartcontractkit/chainlink-deployments-framework/deployment"
+
+	"github.com/smartcontractkit/cld-changesets/internal/maputil"
+)
+
+var _ cldf.ChangeSetV2[Config] = Changeset{}
+
+// Changeset funds MCMS signer PDAs on each configured Solana chain.
+type Changeset struct{}
+
+func (Changeset) VerifyPreconditions(env cldf.Environment, config Config) error {
+	if len(config.FundingPerChain) == 0 {
+		return errors.New("no funding config provided")
+	}
+
+	for chainSelector, chainCfg := range config.FundingPerChain {
+		if _, ok := env.BlockChains.SolanaChains()[chainSelector]; !ok {
+			return fmt.Errorf("solana chain %d not found in environment", chainSelector)
+		}
+		if err := validateMCMSRefs(env, chainSelector, chainCfg); err != nil {
+			return err
+		}
+		if err := validateDeployerBalance(env, chainSelector, chainCfg); err != nil {
+			return err
+		}
+	}
+
+	return nil
+}
+
+func (Changeset) Apply(e cldf.Environment, config Config) (cldf.ChangesetOutput, error) {
+	deps := Deps{
+		BlockChains: e.BlockChains,
+		DataStore:   e.DataStore,
+	}
+
+	var agg sequenceutils.OnChainOutput
+
+	for _, chainSelector := range maputil.SortedMapKeys(config.FundingPerChain) {
+		chainCfg := config.FundingPerChain[chainSelector]
+
+		var mergeErr error
+		agg, mergeErr = sequenceutils.ExecuteOnChainSequenceAndMerge(
+			e.OperationsBundle,
+			deps,
+			SeqFundMCMPDAs,
+			ChainInput{
+				ChainSelector: chainSelector,
+				FundingConfig: chainCfg,
+			},
+			agg,
+		)
+		if mergeErr != nil {
+			return buildOutput(e, agg, mergeErr)
+		}
+	}
+
+	return buildOutput(e, agg, nil)
+}
+
+func buildOutput(
+	e cldf.Environment,
+	agg sequenceutils.OnChainOutput,
+	err error,
+) (cldf.ChangesetOutput, error) {
+	ds := datastore.NewMemoryDataStore()
+	if metaErr := ds.WriteMetadata(agg.Metadata); metaErr != nil {
+		return cldf.ChangesetOutput{DataStore: ds},
+			fmt.Errorf("failed to write metadata to datastore: %w", metaErr)
+	}
+
+	partialOutput := cldf.ChangesetOutput{DataStore: ds}
+	if err != nil {
+		return partialOutput, err
+	}
+
+	out, buildErr := cldf.NewOutputBuilder(e, ds).Build()
+	if buildErr != nil {
+		return out, fmt.Errorf("build changeset output: %w", buildErr)
+	}
+
+	return out, nil
+}