wallet_standard 0.5.1

An implementation of the solana wallet standard in rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

use async_trait::async_trait;
use serde::Deserialize;
use serde::Serialize;
use solana_commitment_config::CommitmentLevel;
use solana_transaction::versioned::VersionedTransaction;
use typed_builder::TypedBuilder;

use super::SolanaSignTransactionOptions;
use crate::SolanaSignatureOutput;
use crate::WalletResult;

pub const SOLANA_SIGN_AND_SEND_TRANSACTION: &str = "solana:signAndSendTransaction";

pub trait SolanaSignAndSendTransactionOutput: SolanaSignatureOutput {}
impl<T> SolanaSignAndSendTransactionOutput for T where T: SolanaSignatureOutput {}

#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize, TypedBuilder)]
#[serde(rename_all = "camelCase")]
pub struct SolanaSignAndSendTransactionProps {
	/// The versioned transaction.
	#[builder(setter(into))]
	pub transaction: VersionedTransaction,
	/// Chain to use.
	#[builder(default, setter(into, strip_option(fallback = chain_opt)))]
	pub chain: Option<String>,
	#[builder(default, setter(into, strip_option(fallback = options_opt)))]
	pub options: Option<SolanaSignAndSendTransactionOptions>,
}

#[derive(Default, Debug, Clone, PartialEq, Eq, Serialize, Deserialize, TypedBuilder)]
#[serde(rename_all = "camelCase")]
pub struct SolanaSignAndSendTransactionOptions {
	/// Preflight commitment level.
	#[builder(default, setter(into, strip_option(fallback = preflight_commitment_opt)))]
	pub preflight_commitment: Option<CommitmentLevel>,
	/// The minimum slot that the request can be evaluated at.
	#[builder(default, setter(into, strip_option(fallback = min_context_slot_opt)))]
	pub min_context_slot: Option<u64>,
	/// Mode for signing and sending transactions.
	#[builder(default, setter(into, strip_option(fallback = mode_opt)))]
	pub mode: Option<SolanaSignAndSendTransactionMode>,
	/// Desired commitment level. If provided, confirm the transaction after
	/// sending.
	#[builder(default, setter(into, strip_option(fallback = commitment_opt)))]
	pub commitment: Option<CommitmentLevel>,
	/// Disable transaction verification at the RPC.
	#[builder(default, setter(into, strip_option(fallback = skip_preflight_opt)))]
	pub skip_preflight: Option<bool>,
	/// Maximum number of times for the RPC node to retry sending the
	/// transaction to the leader.
	#[builder(default, setter(into, strip_option(fallback = max_retries_opt)))]
	pub max_retries: Option<u8>,
}

impl From<SolanaSignAndSendTransactionOptions> for SolanaSignTransactionOptions {
	fn from(
		SolanaSignAndSendTransactionOptions {
			preflight_commitment,
			min_context_slot,
			..
		}: SolanaSignAndSendTransactionOptions,
	) -> Self {
		Self {
			preflight_commitment,
			min_context_slot,
		}
	}
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub enum SolanaSignAndSendTransactionMode {
	/// Sign and send the transaction.
	Parallel,
	/// Sign the transaction and return it.
	Serial,
}

#[async_trait(?Send)]
pub trait WalletSolanaSignAndSendTransaction {
	type Output: SolanaSignAndSendTransactionOutput;

	async fn sign_and_send_transaction(
		&self,
		props: SolanaSignAndSendTransactionProps,
	) -> WalletResult<Self::Output>;
	async fn sign_and_send_transactions(
		&self,
		inputs: Vec<SolanaSignAndSendTransactionProps>,
	) -> WalletResult<Vec<Self::Output>>;
}