Instructions

An instruction identifies a program, its account metadata, and the bytes that the program will execute.

from solathon.core.instructions import AccountMeta, Instruction
 
instruction = Instruction(
    keys=[AccountMeta(account, is_signer=True, is_writable=True)],
    program_id=program_id,
    data=b"program-specific bytes",
)

System Program helpers

Import helpers explicitly from solathon.core.instructions:

• create_account(from_public_key, new_account_public_key, lamports, space, program_id)
• create_account_with_seed(from_public_key, new_account_public_key, base_public_key, seed, lamports, space, program_id)
• assign(account_public_key, program_id) and assign_with_seed(account_public_key, base_public_key, seed, program_id)
• transfer(from_public_key, to_public_key, lamports) and transfer_with_seed(from_public_key, base_public_key, from_seed, from_owner, to_public_key, lamports)
• allocate(account_public_key, space) and allocate_with_seed(account_public_key, base_public_key, seed, space, program_id)
• advance_nonce_account, withdraw_nonce_account, initialize_nonce_account, authorize_nonce_account, and upgrade_nonce_account
• create_account_allow_prefund(new_account_public_key, lamports, space, program_id, payer_public_key=None)

create_account_allow_prefund requires a recent Agave runtime that supports System Program instruction 13. Check cluster support before submitting it.

Transfer example

from solathon import Client, Keypair, PublicKey, Transaction
from solathon.core.instructions import transfer
 
sender = Keypair.from_file("~/.config/solana/id.json")
recipient = PublicKey("B3BhJ1nvPvEhx3hq3nfK8hx4WYcKZdbhavSobZEA44ai")
transaction = Transaction(
    instructions=[transfer(sender.public_key, recipient, 10_000)],
    signers=[sender],
)
 
with Client("https://api.devnet.solana.com") as client:
    signature = client.send_and_confirm_transaction(
        transaction,
        commitment="confirmed",
    )

Memo Program

from solathon.core.instructions import create_memo
 
memo = create_memo("order-1042", signer_public_keys=[sender.public_key])

Compute Budget Program

from solathon.core import ComputeBudgetProgram
 
compute_limit = ComputeBudgetProgram.set_compute_unit_limit(200_000)
compute_price = ComputeBudgetProgram.set_compute_unit_price(1_000)
loaded_data_limit = (
    ComputeBudgetProgram.set_loaded_accounts_data_size_limit(128_000)
)

For legacy and v0 transactions, set_compute_unit_price is measured in micro-lamports per compute unit.