Struct solders_transaction::VersionedTransaction

pub struct VersionedTransaction(pub VersionedTransaction);

An atomic transaction

The __init__ method signs a versioned message to create a signed transaction.

Args: message (Message | MessageV0): The message to sign. keypairs (Sequence[Keypair | Presigner]): The keypairs that are to sign the transaction.

Tuple Fields

0: VersionedTransaction

Implementations

impl VersionedTransaction

pub fn new(message: VersionedMessage, keypairs: Vec<Signer>) -> PyResult<Self>

pub fn message(&self) -> VersionedMessage

Message | MessageV0: The transaction message.

pub fn signatures(&self) -> Vec<Signature>

ListSignature: The transaction signatures.

pub fn populate(message: VersionedMessage, signatures: Vec<Signature>) -> Self

Create a fully-signed transaction from a message and its signatures.

Args: message (Message | MessageV0): The transaction message. signatures (SequenceSignature): The message’s signatures.

Returns: Transaction: The signed transaction.

Example:

>>> from solders.pubkey import Pubkey
>>> from solders.instruction import Instruction
>>> from solders.message import MessageV0
>>> from solders.hash import Hash
>>> from solders.keypair import Keypair
>>> from solders.transaction import VersionedTransaction
>>> payer = Keypair()
>>> program_id = Pubkey.default()
>>> instructions = [Instruction(program_id, bytes([]), [])]
>>> recent_blockhash = Hash.new_unique()
>>> message = MessageV0.try_compile(payer.pubkey(), instructions, [], recent_blockhash)
>>> tx = VersionedTransaction(message, [payer])
>>> assert VersionedTransaction.populate(message, tx.signatures) == tx

pub fn sanitize(&self) -> PyResult<()>

Sanity checks the Transaction properties.

pub fn version(&self) -> TransactionVersion

Returns the version of the transaction.

Returns: Legacy | int: Transaction version.

pub fn into_legacy_transaction(&self) -> Option<Transaction>

Returns a legacy transaction if the transaction message is legacy.

Returns: OptionalTransaction: The legacy transaction.

pub fn verify_and_hash_message(&self) -> PyResult<SolderHash>

Verify the transaction and hash its message

pub fn verify_with_results(&self) -> Vec<bool>

Verify the transaction and return a list of verification results

pub fn new_default() -> Self

Return a new default transaction.

Returns: VersionedTransaction: The default transaction.

pub fn from_legacy(tx: Transaction) -> Self

Convert a legacy transaction to a VersionedTransaction.

Returns: VersionedTransaction: The versioned tx.

pub fn uses_durable_nonce(&self) -> bool

Returns true if transaction begins with a valid advance nonce instruction.

Returns: bool

pub fn __richcmp__(&self, other: &Self, op: CompareOp) -> PyResult<bool>

pub fn __bytes__<'a>(&self, py: Python<'a>) -> &'a PyBytes

pub fn __str__(&self) -> String

pub fn __repr__(&self) -> String

pub fn __reduce__(&self) -> PyResult<(PyObject, PyObject)>

pub fn from_bytes(data: &[u8]) -> PyResult<Self>

Deserialize from bytes.

Args: data (bytes): the serialized object.

Returns: the deserialized object.

pub fn to_json(&self) -> String

Convert to a JSON string.

pub fn from_json(raw: &str) -> PyResult<Self>

Build from a JSON string.

Trait Implementations

impl Clone for VersionedTransaction

fn clone(&self) -> VersionedTransaction

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CommonMethods<'_> for VersionedTransaction

fn py_to_json(&self) -> String

fn py_from_json(raw: &'a str) -> Result<Self, PyErr>

impl CommonMethodsCore for VersionedTransaction

fn pybytes<'b>(&self, py: Python<'b>) -> &'b PyBytes

fn pystr(&self) -> String

fn pyrepr(&self) -> String

fn py_from_bytes(raw: &[u8]) -> Result<Self, PyErr>

fn pyreduce(&self) -> Result<(Py<PyAny>, Py<PyAny>), PyErr>

impl Debug for VersionedTransaction

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for VersionedTransaction

fn default() -> VersionedTransaction

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for VersionedTransaction

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for VersionedTransaction

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Transaction> for VersionedTransaction

fn from(t: Transaction) -> Self

Converts to this type from the input type.

impl From<VersionedTransaction> for VersionedTransaction

fn from(original: VersionedTransaction) -> Self

Converts to this type from the input type.

impl From<VersionedTransaction> for VersionedTransaction

fn from(original: VersionedTransactionOriginal) -> VersionedTransaction

Converts to this type from the input type.

impl IntoPy<Py<PyAny>> for VersionedTransaction

fn into_py(self, py: Python<'_>) -> PyObject

Performs the conversion.

impl PartialEq for VersionedTransaction

fn eq(&self, other: &VersionedTransaction) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PyBytesBincode for VersionedTransaction

fn pybytes_bincode<'a>(&self, py: Python<'a>) -> &'a PyBytes

impl PyBytesGeneral for VersionedTransaction

fn pybytes_general<'a>(&self, py: Python<'a>) -> &'a PyBytes

impl PyClass for VersionedTransaction

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for VersionedTransaction

const IS_BASETYPE: bool = true

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

type Layout = PyCell<VersionedTransaction>

Layout

type BaseType = PyAny

Base class

type ThreadChecker = ThreadCheckerStub<VersionedTransaction>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn doc(py: Python<'_>) -> PyResult<&'static CStr>

Rendered class doc

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl PyClassNewTextSignature<VersionedTransaction> for PyClassImplCollector<VersionedTransaction>

fn new_text_signature(self) -> Option<&'static str>

impl PyFromBytesBincode<'_> for VersionedTransaction

fn py_from_bytes_bincode(raw: &'b [u8]) -> Result<Self, PyErr>

impl PyFromBytesGeneral for VersionedTransaction

fn py_from_bytes_general(raw: &[u8]) -> PyResult<Self>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a VersionedTransaction

type Holder = Option<PyRef<'py, VersionedTransaction>>

fn extract(obj: &'py PyAny, holder: &'a mut Self::Holder) -> PyResult<Self>

impl<'a, 'py> PyFunctionArgument<'a, 'py> for &'a mut VersionedTransaction

type Holder = Option<PyRefMut<'py, VersionedTransaction>>

fn extract(obj: &'py PyAny, holder: &'a mut Self::Holder) -> PyResult<Self>

impl PyMethods<VersionedTransaction> for PyClassImplCollector<VersionedTransaction>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for VersionedTransaction

type AsRefTarget = PyCell<VersionedTransaction>

Utility type to make Py::as_ref work.

const NAME: &'static str = "VersionedTransaction"

Class name.

const MODULE: Option<&'static str> = _

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> &PyType

Returns the safe abstraction over the type object.

fn is_type_of(object: &PyAny) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &PyAny) -> bool

Checks if object is an instance of this type.

impl RichcmpEqualityOnly for VersionedTransaction

fn richcmp(&self, other: &Self, op: CompareOp) -> Result<bool, PyErr>

impl Serialize for VersionedTransaction

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for VersionedTransaction

impl StructuralEq for VersionedTransaction

impl StructuralPartialEq for VersionedTransaction