fix(mcms/transfer): change to datastore ref type

[graham-chainlink]

For the transfer to timelock changeset, the input type contains evm specific type which should be avoided. This commit changes the type into a generic datastore type.

Before

type Config struct {
	ContractsByChain map[uint64][]common.Address `json:"contractsByChain"`

After

type Config struct {
	// ContractsByChain lists contracts as datastore refs for every supported chain family.
	ContractsByChain map[uint64][]refkey.RefKey `json:"contractsByChain,omitempty"`

[Copilot]

Pull request overview

This PR updates the MCMS transfer-to-timelock changeset API to avoid EVM-specific address types by switching contract selection from common.Address to a generic datastore reference key (refkey.RefKey), and adds normalization/validation around those refs.

Changes:

• Replaced per-chain contract inputs from []common.Address to []refkey.RefKey and normalized refs to the chain selector.
• Added ref normalization helpers + tests, and updated documentation/examples to use ref keys.
• Updated EVM transfer-to-timelock implementation to resolve refs to EVM addresses at execution/validation time, and adjusted tests accordingly.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
mcms/evm/transfer-to-timelock/validate.go	Validates contract refs and resolves them to EVM addresses for ownership preconditions.
mcms/evm/transfer-to-timelock/validate_test.go	Updates validation tests to use refkey.RefKey and adds resolveEVMAddress coverage.
mcms/evm/transfer-to-timelock/sequence.go	Resolves contract refs to EVM addresses before building transfer operations.
mcms/evm/transfer-to-timelock/changeset_test.go	Updates EVM integration-style tests to pass contract refs instead of addresses.
mcms/evm/transfer-to-timelock/addresses.go	Introduces resolveEVMAddress helper for resolving datastore refs into EVM addresses.
mcms/changesets/transfer-to-timelock/types.go	Changes public config/input types to use refkey.RefKey (generic datastore refs).
mcms/changesets/transfer-to-timelock/refs.go	Adds normalizeContractRefs to enforce/fill chain selector on refs.
mcms/changesets/transfer-to-timelock/refs_test.go	Adds tests for normalizeContractRefs.
mcms/changesets/transfer-to-timelock/doc.go	Updates documentation example to use ref keys instead of EVM addresses.
mcms/changesets/transfer-to-timelock/changeset.go	Normalizes contract refs before executing per-chain sequences and during precondition grouping.
mcms/changesets/transfer-to-timelock/changeset_test.go	Updates changeset tests to use refkey.RefKey inputs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

[github-actions]

Release impact (release-please)

Current version	0.7.1 (on main)
After merge	0.7.2 (patch bump)

PR title: fix(mcms/transfer): change to datastore ref type

Merging this PR as-is will contribute a patch bump to the next release-please release PR.

Conventional commit → bump

Intent	PR title prefix	Bump
Bug fix	fix:	patch
New feature	feat:	minor
Breaking change	feat!: / fix!: or BREAKING CHANGE: / BREAKING-CHANGE: in description	major
No release	chore:, docs:, ci:, refactor:, etc.	none

Update the PR title before merge if you need a different bump (squash commit message = PR title).

Preview is based on this PR title only. The release-please release PR may include other unreleased commits already on main.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

[cl-sonarqube-production]

Quality Gate failed

Failed conditions
68.8% Coverage on New Code (required ≥ 75%)

See analysis details on SonarQube