Struct MultiEd25519Account 

pub struct MultiEd25519Account { /* private fields */ }

Available on crate feature ed25519 only.

A multi-Ed25519 account supporting M-of-N threshold signatures.

This account type holds multiple Ed25519 keys and requires a threshold number of signatures to authorize transactions.

Example

use aptos_sdk::account::MultiEd25519Account;
use aptos_sdk::crypto::Ed25519PrivateKey;

// Create a 2-of-3 multisig account
let keys: Vec<_> = (0..3).map(|_| Ed25519PrivateKey::generate()).collect();
let account = MultiEd25519Account::new(keys, 2).unwrap();

println!("Address: {}", account.address());
println!("Threshold: {}/{}", account.threshold(), account.num_keys());

// Sign a message
let message = b"hello";
let signature = account.sign(message);

Implementations

impl MultiEd25519Account

pub fn new( private_keys: Vec<Ed25519PrivateKey>, threshold: u8, ) -> AptosResult<Self>

Creates a new multi-Ed25519 account from private keys.

All provided private keys will be used for signing. The threshold specifies how many signatures are required.

Arguments

• private_keys - The Ed25519 private keys
• threshold - The required number of signatures (M in M-of-N)

Example

// 2-of-3 multisig where we own all 3 keys
let keys: Vec<_> = (0..3).map(|_| Ed25519PrivateKey::generate()).collect();
let account = MultiEd25519Account::new(keys, 2).unwrap();

Errors

This function will return an error if:

• No private keys are provided
• The threshold exceeds the number of keys
• The multi-Ed25519 public key creation fails (e.g., too many keys, invalid threshold)

pub fn from_keys( public_keys: Vec<Ed25519PublicKey>, private_keys: Vec<(u8, Ed25519PrivateKey)>, threshold: u8, ) -> AptosResult<Self>

Creates a multi-Ed25519 account from public keys with a subset of private keys.

Use this when you don’t have all the private keys (e.g., a 2-of-3 where you only own 2 keys).

Arguments

• public_keys - All the Ed25519 public keys in the account
• private_keys - The private keys you own, with their indices
• threshold - The required number of signatures

Example

// 2-of-3 multisig where we own keys 0 and 2
let all_public_keys = vec![pk0, pk1, pk2];
let my_keys = vec![(0, sk0), (2, sk2)];
let account = MultiEd25519Account::from_keys(all_public_keys, my_keys, 2).unwrap();

Errors

This function will return an error if:

• The multi-Ed25519 public key creation fails
• A private key index is out of bounds
• A private key doesn’t match the public key at its index

pub fn view_only( public_keys: Vec<Ed25519PublicKey>, threshold: u8, ) -> AptosResult<Self>

Creates a view-only multi-Ed25519 account (no signing capability).

This is useful for verifying signatures or looking up account information when you don’t have any private keys.

Errors

Returns an error if the multi-Ed25519 public key creation fails (e.g., no keys provided, too many keys, invalid threshold).

pub fn address(&self) -> AccountAddress

Returns the account address.

pub fn public_key(&self) -> &MultiEd25519PublicKey

Returns the multi-Ed25519 public key.

pub fn num_keys(&self) -> usize

Returns the number of keys in the account.

pub fn threshold(&self) -> u8

Returns the signature threshold.

pub fn num_owned_keys(&self) -> usize

Returns the number of private keys we have.

pub fn can_sign(&self) -> bool

Checks if we can sign (have enough private keys to meet threshold).

pub fn owned_key_indices(&self) -> Vec<u8>

Returns the indices of the private keys we own.

pub fn sign_with_indices( &self, message: &[u8], indices: &[u8], ) -> AptosResult<MultiEd25519Signature>

Signs a message using specific key indices.

Arguments

• message - The message to sign
• indices - The indices of keys to use for signing

Errors

Returns an error if:

• We don’t own a key at the specified index
• Not enough indices are provided to meet threshold

pub fn verify( &self, message: &[u8], signature: &MultiEd25519Signature, ) -> AptosResult<()>

Verifies a signature against a message.

Errors

Returns an error if signature verification fails (e.g., invalid signature, insufficient signatures, signature mismatch).

pub fn sign(&self, message: &[u8]) -> AptosResult<MultiEd25519Signature>

Signs a message using the owned private keys.

Will use up to threshold keys for signing.

Errors

Returns an error if we don’t have enough keys to meet the threshold.

pub fn auth_key(&self) -> AuthenticationKey

Returns the authentication key for this account.

pub fn aggregate_signatures( signatures: Vec<(u8, Ed25519Signature)>, ) -> AptosResult<MultiEd25519Signature>

Collects individual signatures into a multi-signature.

Use this when collecting signatures from multiple parties.

Errors

This function will return an error if:

• No signatures are provided
• Too many signatures are provided (more than 32)
• Signer indices are out of bounds or duplicated

pub fn create_signature_contribution( &self, message: &[u8], key_index: u8, ) -> AptosResult<(u8, Ed25519Signature)>

Creates an individual signature contribution for this account.

Returns the signature with the signer index. Use this when contributing your signature to a multi-party signing flow.

Errors

Returns an error if we don’t have a private key at the specified index.

Trait Implementations

impl Account for MultiEd25519Account

fn address(&self) -> AccountAddress

Returns the account address.

fn public_key_bytes(&self) -> Vec<u8>

Returns the public key bytes.

fn sign(&self, message: &[u8]) -> AptosResult<Vec<u8>>

Signs a message and returns the signature bytes.

fn authentication_key(&self) -> AuthenticationKey

Returns the authentication key.

fn signature_scheme(&self) -> u8

Returns the scheme identifier for this account type.

impl Debug for MultiEd25519Account

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

Formats the value using the given formatter.

impl Display for MultiEd25519Account

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

Formats the value using the given formatter.

impl From<MultiEd25519Account> for AnyAccount

fn from(account: MultiEd25519Account) -> Self

Converts to this type from the input type.