feat(governance/xc_admin): add initial support for solana receiver (#1365)

* feat(governance/xc_admin): add initial support for solana receiver

This change adds Solana Receiver IDL to xc-admin to support parsing
them in the xc-admin Frontend. Also adds two CLI commands to request
and accept governance authority transfer.

* chore: address comments

* chore: bump version

Author: ali-behjati

governance/xc_admin/packages/xc_admin_cli/package.json

@@ -28,6 +28,7 @@
     "@sqds/mesh": "^1.0.6",
     "commander": "^9.5.0",
     "typescript": "^4.9.4",
-    "xc_admin_common": "*"
+    "xc_admin_common": "*",
+    "@pythnetwork/pyth-solana-receiver": "*"
   }
 }

governance/xc_admin/packages/xc_admin_cli/src/index.ts

@@ -36,6 +36,13 @@ import {
   getMultisigCluster,
   getProposalInstructions,
 } from "xc_admin_common";
+
+import {
+  pythSolanaReceiverIdl,
+  getConfigPda,
+  DEFAULT_RECEIVER_PROGRAM_ID,
+} from "@pythnetwork/pyth-solana-receiver";
+
 import { LedgerNodeWallet } from "./ledger";
 
 export async function loadHotWalletOrLedger(
@@ -102,7 +109,7 @@ program
   .version("0.1.0");
 
 multisigCommand(
-  "accept-authority",
+  "escrow-program-accept-authority",
   "Accept authority from the program authority escrow"
 )
   .requiredOption(
@@ -150,6 +157,61 @@ multisigCommand(
     await vault.proposeInstructions([proposalInstruction], targetCluster);
   });
 
+multisigCommand(
+  "solana-receiver-program-accept-governance-authority-transfer",
+  "Accept governance authority transfer for the solana receiver program"
+).action(async (options: any) => {
+  const vault = await loadVaultFromOptions(options);
+  const targetCluster: PythCluster = options.cluster;
+
+  const programSolanaReceiver = new Program(
+    pythSolanaReceiverIdl,
+    DEFAULT_RECEIVER_PROGRAM_ID,
+    vault.getAnchorProvider()
+  );
+
+  const proposalInstruction = await programSolanaReceiver.methods
+    .acceptGovernanceAuthorityTransfer()
+    .accounts({
+      payer: await vault.getVaultAuthorityPDA(targetCluster),
+      config: getConfigPda(DEFAULT_RECEIVER_PROGRAM_ID),
+    })
+    .instruction();
+
+  await vault.proposeInstructions([proposalInstruction], targetCluster);
+});
+
+multisigCommand(
+  "solana-receiver-program-request-governance-authority-transfer",
+  "Request governance authority transfer for the solana receiver program"
+)
+  .requiredOption(
+    "-t, --target <pubkey>",
+    "The new governance authority to take over. " +
+      "If the target is another multisig, it will be the multisig's vault authority PDA."
+  )
+  .action(async (options: any) => {
+    const vault = await loadVaultFromOptions(options);
+    const targetCluster: PythCluster = options.cluster;
+    const target: PublicKey = new PublicKey(options.target);
+
+    const programSolanaReceiver = new Program(
+      pythSolanaReceiverIdl,
+      DEFAULT_RECEIVER_PROGRAM_ID,
+      vault.getAnchorProvider()
+    );
+
+    const proposalInstruction = await programSolanaReceiver.methods
+      .requestGovernanceAuthorityTransfer(target)
+      .accounts({
+        payer: await vault.getVaultAuthorityPDA(targetCluster),
+        config: getConfigPda(DEFAULT_RECEIVER_PROGRAM_ID),
+      })
+      .instruction();
+
+    await vault.proposeInstructions([proposalInstruction], targetCluster);
+  });
+
 multisigCommand("upgrade-program", "Upgrade a program from a buffer")
   .requiredOption(
     "-p, --program-id <pubkey>",

governance/xc_admin/packages/xc_admin_common/package.json

@@ -30,7 +30,8 @@
     "ethers": "^5.7.2",
     "lodash": "^4.17.21",
     "typescript": "^4.9.4",
-    "@pythnetwork/solana-utils": "*"
+    "@pythnetwork/solana-utils": "*",
+    "@pythnetwork/pyth-solana-receiver": "*"
   },
   "devDependencies": {
     "@types/bn.js": "^5.1.1",

governance/xc_admin/packages/xc_admin_common/src/multisig_transaction/MessageBufferMultisigInstruction.ts

@@ -11,6 +11,10 @@ import { Idl, BorshCoder } from "@coral-xyz/anchor";
 import { MESSAGE_BUFFER_PROGRAM_ID } from "../message_buffer";
 import meshIdl from "@sqds/mesh/lib/mesh-idl/mesh.json";
 import stakingIdl from "./idl/staking.json";
+import {
+  DEFAULT_RECEIVER_PROGRAM_ID,
+  pythSolanaReceiverIdl,
+} from "@pythnetwork/pyth-solana-receiver";
 
 export const MESH_PROGRAM_ID = new PublicKey(
   "SMPLVC8MxZ5Bf5EfF7PaMiTCxoBAcmkbM2vkrvMK8ho"
@@ -55,6 +59,10 @@ export class AnchorMultisigInstruction implements MultisigInstruction {
         idl = stakingIdl as Idl;
         program = MultisigInstructionProgram.Staking;
         break;
+      case DEFAULT_RECEIVER_PROGRAM_ID.toBase58():
+        idl = pythSolanaReceiverIdl as Idl;
+        program = MultisigInstructionProgram.SolanaReceiver;
+        break;
       default:
         return UnrecognizedProgram.fromTransactionInstruction(instruction);
     }

governance/xc_admin/packages/xc_admin_common/src/multisig_transaction/index.ts

@@ -22,6 +22,7 @@ import { BpfUpgradableLoaderInstruction } from "./BpfUpgradableLoaderMultisigIns
 import { BPF_UPGRADABLE_LOADER } from "../bpf_upgradable_loader";
 import { AnchorAccounts } from "./anchor";
 import { SolanaStakingMultisigInstruction } from "./SolanaStakingMultisigInstruction";
+import { DEFAULT_RECEIVER_PROGRAM_ID } from "@pythnetwork/pyth-solana-receiver";
 
 export const UNRECOGNIZED_INSTRUCTION = "unrecognizedInstruction";
 export enum MultisigInstructionProgram {
@@ -33,6 +34,7 @@ export enum MultisigInstructionProgram {
   SystemProgram,
   BpfUpgradableLoader,
   SolanaStakingProgram,
+  SolanaReceiver,
   UnrecognizedProgram,
 }
 
@@ -54,6 +56,8 @@ export function getProgramName(program: MultisigInstructionProgram) {
       return "Mesh Multisig Program";
     case MultisigInstructionProgram.Staking:
       return "Pyth Staking Program";
+    case MultisigInstructionProgram.SolanaReceiver:
+      return "Pyth Solana Receiver";
     case MultisigInstructionProgram.UnrecognizedProgram:
       return "Unknown";
   }
@@ -123,7 +127,8 @@ export class MultisigParser {
     } else if (
       instruction.programId.equals(MESSAGE_BUFFER_PROGRAM_ID) ||
       instruction.programId.equals(MESH_PROGRAM_ID) ||
-      instruction.programId.equals(STAKING_PROGRAM_ID)
+      instruction.programId.equals(STAKING_PROGRAM_ID) ||
+      instruction.programId.equals(DEFAULT_RECEIVER_PROGRAM_ID)
     ) {
       return AnchorMultisigInstruction.fromTransactionInstruction(instruction);
     } else if (instruction.programId.equals(SystemProgram.programId)) {

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@pythnetwork/pyth-solana-receiver",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Pyth solana receiver SDK",
   "homepage": "https://pyth.network",
   "main": "lib/index.js",

target_chains/solana/sdk/js/pyth_solana_receiver/package.json

@@ -6,3 +6,19 @@ export {
   TransactionBuilder,
   InstructionWithEphemeralSigners,
 } from "@pythnetwork/solana-utils";
+
+export {
+  getConfigPda,
+  DEFAULT_RECEIVER_PROGRAM_ID,
+  DEFAULT_WORMHOLE_PROGRAM_ID,
+} from "./address";
+
+export {
+  IDL as pythSolanaReceiverIdl,
+  PythSolanaReceiver as PythSolanaReceiverProgram,
+} from "./idl/pyth_solana_receiver";
+
+export {
+  IDL as wormholeCoreBridgeIdl,
+  WormholeCoreBridgeSolana as WormholeCoreBridgeProgram,
+} from "./idl/wormhole_core_bridge_solana";