[DPA-1458]: feat(solana): auto deploy programs (#1519)

* feat(solana): auto deploy programs

By using `--upgradeable-program` , we can auto deploy programs detected in the mounted path `/programs`, this reduces the need for consumer of this library to have to deploy the programs themselves, especially with go sdk where deploying a program is not straightforward and involves a decent amount of code, the alternative is to ssh into the docker container and run `solana deploy ...` but this involves an extra step.

JIRA: https://smartcontract-it.atlassian.net/browse/DPA-1458

* feat(solana): auto deploy programs

By using `--upgradeable-program` , we can auto deploy programs detected in the mounted path `/programs`, this reduces the need for consumer of this library to have to deploy the programs themselves, especially with go sdk where deploying a program is not straightforward and involves a decent amount of code, the alternative is to ssh into the docker container and run `solana deploy ...` but this involves an extra step.

Inspired from https://github.com/smartcontractkit/chainlink-ccip/blob/609f7b0c9734b3cfc1d1a1aea0fd1ddf4c90bd0c/chains/solana/contracts/tests/testutils/anchor.go#L72-L72

JIRA: https://smartcontract-it.atlassian.net/browse/DPA-1458

Author: graham-chainlink

book/src/framework/components/blockchains/solana.md

@@ -16,6 +16,18 @@ arm64 f4hrenh9it/solana:latest - used locally
   contracts_dir = "."
   # optional, in case you need some custom image
   # image = "solanalabs/solana:v1.18.26"
+
+# optional
+# To deploy a solana program, we can provide a mapping of program name to program id.
+# The program name has to match the name of the .so file in the contracts_dir directory.
+# This example assumes there is a mcm.so in the mounted contracts_dir directory
+# value is the program_id to set for the deployed program, any valid public key can be used here.
+# this allows lookup via program_id during testing.
+# Alternative, we can use `solana deploy` instead of this field to deploy a program, but 
+# program_id will be auto generated.
+[blockchain_a.solana_programs]
+  mcm = "6UmMZr5MEqiKWD5jqTJd1WCR5kT8oZuFYBLJFi1o6GQX"
+
 ```
 
 ## Usage

framework/components/blockchain/blockchain.go

@@ -21,6 +21,10 @@ type Input struct {
 	// publickey to mint when solana-test-validator starts
 	PublicKey    string `toml:"public_key"`
 	ContractsDir string `toml:"contracts_dir"`
+	// programs to deploy on solana-test-validator start
+	// a map of program name to program id
+	// there needs to be a matching .so file in contracts_dir
+	SolanaPrograms map[string]string `toml:"solana_programs"`
 }
 
 // Output is a blockchain network output, ChainID and one or more nodes that forms the network

framework/components/blockchain/solana.go

@@ -6,6 +6,7 @@ import (
 	"os"
 	"path/filepath"
 	"strconv"
+	"strings"
 	"time"
 
 	"github.com/docker/docker/api/types/container"
@@ -80,6 +81,16 @@ func newSolana(in *Input) (*Output, error) {
 		return nil, err
 	}
 
+	flags := []string{}
+	for k, v := range in.SolanaPrograms {
+		flags = append(flags, "--upgradeable-program", v, filepath.Join("/programs", k+".so"), in.PublicKey)
+	}
+	args := append([]string{
+		"--reset",
+		"--rpc-port", in.Port,
+		"--mint", in.PublicKey,
+	}, flags...)
+
 	req := testcontainers.ContainerRequest{
 		AlwaysPullImage: in.PullImage,
 		Image:           in.Image,
@@ -127,7 +138,7 @@ func newSolana(in *Input) (*Output, error) {
 				FileMode:          0644,
 			},
 		},
-		Entrypoint: []string{"sh", "-c", fmt.Sprintf("mkdir -p /root/.config/solana/cli && solana-test-validator --rpc-port %s --mint %s", in.Port, in.PublicKey)},
+		Entrypoint: []string{"sh", "-c", fmt.Sprintf("mkdir -p /root/.config/solana/cli && solana-test-validator %s", strings.Join(args, " "))},
 	}
 
 	c, err := testcontainers.GenericContainer(ctx, testcontainers.GenericContainerRequest{

framework/examples/myproject/smoke_solana.toml

@@ -3,4 +3,7 @@
   type = "solana"
   public_key = "9n1pyVGGo6V4mpiSDMVay5As9NurEkY283wwRk1Kto2C"
   contracts_dir = "."
-  image = "solanalabs/solana:v1.18.26"
+  image = "solanalabs/solana:v1.18.26"
+
+[blockchain_a.solana_programs]
+  mcm = "6UmMZr5MEqiKWD5jqTJd1WCR5kT8oZuFYBLJFi1o6GQX"