Memo Program

spl.memo.instructions

Memo program instructions.

create_memo(params)

Creates a transaction instruction that creates a memo.

Message need to be encoded in bytes.

Example

from solders.pubkey import Pubkey from spl.memo.models import MemoParams leading_zeros = [0] * 31 signer, memo_program = Pubkey(leading_zeros + [1]), Pubkey(leading_zeros + [2]) message = bytes("test", encoding="utf8") params = MemoParams( ... program_id=memo_program, ... message=message, ... signer=signer ... ) type(create_memo(params))

Returns:

Type	Description
Instruction	The instruction to create a memo.

Source code in src/spl/memo/instructions.py

def create_memo(params: models.MemoParams) -> Instruction:
    """Creates a transaction instruction that creates a memo.

    Message need to be encoded in bytes.

    Example:
        >>> from solders.pubkey import Pubkey
        >>> from spl.memo.models import MemoParams
        >>> leading_zeros = [0] * 31
        >>> signer, memo_program = Pubkey(leading_zeros + [1]), Pubkey(leading_zeros + [2])
        >>> message = bytes("test", encoding="utf8")
        >>> params = MemoParams(
        ...     program_id=memo_program,
        ...     message=message,
        ...     signer=signer
        ... )
        >>> type(create_memo(params))
        <class 'solders.instruction.Instruction'>

    Returns:
        The instruction to create a memo.
    """
    keys = [
        AccountMeta(pubkey=params.signer, is_signer=True, is_writable=True),
    ]
    return Instruction(
        accounts=keys,
        program_id=params.program_id,
        data=params.message,
    )

decode_create_memo(instruction)

Decode a create_memo_instruction and retrieve the instruction params.

Parameters:

Name	Type	Description	Default
instruction	Instruction	The instruction to decode.	required

Returns:

Type	Description
MemoParams	The decoded instruction.

Source code in src/spl/memo/instructions.py

def decode_create_memo(instruction: Instruction) -> models.MemoParams:
    """Decode a create_memo_instruction and retrieve the instruction params.

    Args:
        instruction: The instruction to decode.

    Returns:
        The decoded instruction.
    """
    return models.MemoParams(
        signer=instruction.accounts[0].pubkey,
        message=instruction.data,
        program_id=instruction.program_id,
    )