Interact with Solana Programs - Para Docs

You’re viewing the 2.0 (LTS) docs. View the current 3.0 version of this page.

Interact with Solana programs by calling instructions and working with Anchor IDLs. This guide covers manual instruction creation and Anchor’s type-safe program interaction.

@solana/kit
@solana/web3.js
Anchor

import { useParaSolanaSigner, useParaSolanaSignAndSend } from '@getpara/react-sdk';
import { PublicKey, SystemProgram, TransactionInstruction } from '@solana/web3.js';
import {
  createSolanaRpc,
  createTransactionMessage,
  setTransactionMessageFeePayerSigner,
  setTransactionMessageLifetimeUsingBlockhash,
  appendTransactionMessageInstructions,
  pipe,
} from '@solana/kit';
import { Buffer } from 'buffer';

const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");

function InteractWithProgram() {
  const { solanaSigner, isLoading } = useParaSolanaSigner({ rpc });
  const { signAndSendAsync, isPending } = useParaSolanaSignAndSend(solanaSigner);

  const callProgram = async () => {
    if (!solanaSigner) {
      console.error("No signer available. Connect wallet first.");
      return;
    }

    const programId = new PublicKey("YOUR_PROGRAM_ID");

    // Example: Initialize account with custom data
    const [pda] = PublicKey.findProgramAddressSync(
      [Buffer.from("seed"), solanaSigner.publicKey.toBuffer()],
      programId
    );

    // Create instruction data (program-specific)
    const instructionData = Buffer.alloc(9);
    instructionData.writeUInt8(0, 0); // Instruction index
    instructionData.writeBigUInt64LE(BigInt(1000), 1); // Example parameter

    const instruction = new TransactionInstruction({
      keys: [
        { pubkey: solanaSigner.publicKey, isSigner: true, isWritable: true },
        { pubkey: pda, isSigner: false, isWritable: true },
        { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
      ],
      programId,
      data: instructionData,
    });

    const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();

    const transaction = pipe(
      createTransactionMessage({ version: 0 }),
      (tx) => setTransactionMessageFeePayerSigner(solanaSigner.publicKey, tx),
      (tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx),
      (tx) => appendTransactionMessageInstructions([instruction], tx)
    );

    const result = await signAndSendAsync({ transactions: [transaction] });

    console.log("Program call signature:", result);
    console.log("Transaction confirmed");
  };

  return <button onClick={callProgram}>Call Program</button>;
}

import { useParaSolana } from './hooks/useParaSolana';
import { Transaction, TransactionInstruction, PublicKey, SystemProgram } from '@solana/web3.js';
import { Buffer } from 'buffer';

function InteractWithProgram() {
  const { connection, signer } = useParaSolana();

  const callProgram = async () => {
    const programId = new PublicKey("YOUR_PROGRAM_ID");

    // Example: Initialize account with custom data
    const [pda] = PublicKey.findProgramAddressSync(
      [Buffer.from("seed"), signer.sender.toBuffer()],
      programId
    );

    // Create instruction data (program-specific)
    const instructionData = Buffer.alloc(9);
    instructionData.writeUInt8(0, 0); // Instruction index
    instructionData.writeBigUInt64LE(BigInt(1000), 1); // Example parameter

    const instruction = new TransactionInstruction({
      keys: [
        { pubkey: signer.sender, isSigner: true, isWritable: true },
        { pubkey: pda, isSigner: false, isWritable: true },
        { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
      ],
      programId,
      data: instructionData,
    });

    const transaction = new Transaction().add(instruction);

    try {
      const signature = await signer.sendTransaction(transaction);
      console.log("Program call signature:", signature);

      const confirmation = await connection.confirmTransaction(signature, "confirmed");
      console.log("Transaction confirmed:", confirmation);
    } catch (error) {
      console.error("Program call failed:", error);
    }
  };

  return <button onClick={callProgram}>Call Program</button>;
}

Use Codama-generated typed instructions for type-safe program interaction:

import { useParaSolanaSigner } from "@getpara/react-sdk";
import { createSolanaRpc } from "@solana/kit";
import { pipe, createTransactionMessage, setTransactionMessageFeePayerSigner,
  setTransactionMessageLifetimeUsingBlockhash, appendTransactionMessageInstruction,
  signAndSendTransactionMessageWithSigners } from "@solana/kit";
// Generated from your Anchor IDL
import { getInitializeInstruction, getUpdateInstruction } from "./generated/instructions";

const rpc = createSolanaRpc("https://api.devnet.solana.com");

function InteractWithProgram() {
  const { solanaSigner, isLoading } = useParaSolanaSigner({ rpc });

  const callProgram = async () => {
    if (!solanaSigner) return;

    const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();

    // Codama generates typed instruction builders from your IDL
    const instruction = getInitializeInstruction({
      user: solanaSigner,
      data: { value: 1000 },
    });

    const tx = pipe(
      createTransactionMessage({ version: 0 }),
      tx => setTransactionMessageFeePayerSigner(solanaSigner, tx),
      tx => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx),
      tx => appendTransactionMessageInstruction(instruction, tx),
    );

    const signature = await signAndSendTransactionMessageWithSigners(tx);
    console.log("Transaction:", signature);
  };

  if (isLoading) return <p>Loading...</p>;
  return <button onClick={callProgram}>Call Program</button>;
}

Generate your client: npx codama idl path/to/idl.json -o src/generated

Next Steps