xmtp_id

[dependencies]
xmtp_id = "*"

use alloy::signers::local::PrivateKeySigner;
use xmtp_id::InboxOwner;

// PrivateKeySigner already implements InboxOwner
let wallet = PrivateKeySigner::random();

// Get the wallet's identifier
let identifier = wallet.get_identifier()?;

// Sign a message
let signature = wallet.sign("Hello XMTP")?;

use xmtp_id::{InboxId, InboxIdRef, AsIdRef};

// Create an inbox ID
let inbox_id: InboxId = String::from("inbox_123");

// Use as reference
let inbox_ref: InboxIdRef = inbox_id.as_ref();

// Pass to functions expecting InboxIdRef
fn process_inbox(id: InboxIdRef) {
    println!("Processing inbox: {}", id);
}

process_inbox(inbox_id.as_ref());

use xmtp_id::associations::{
    builder::SignatureRequestBuilder,
    AssociationState,
    Identifier,
};

// Create a new inbox
let create_request = SignatureRequestBuilder::new(inbox_id)
    .create_inbox(wallet_address.clone(), nonce)
    .build();

// Add a new wallet association
let add_request = SignatureRequestBuilder::new(inbox_id)
    .add_association(new_wallet_address)
    .build();

// Apply updates to get current state
let state = AssociationState::new(
    inbox_id.clone(),
    vec![update1, update2],
)?;

use xmtp_id::associations::unverified::UnverifiedIdentityUpdate;

// Receive an unverified update
let unverified_update: UnverifiedIdentityUpdate = /* from network */;

// Verify the update
let verified_update = unverified_update.verify()?;

// Apply to association state
let new_state = verified_update.update_state(
    Some(current_state),
    timestamp_ns,
)?;

use xmtp_id::scw_verifier::SmartContractSignatureVerifier;

// Create verifier with RPC endpoint
let verifier = SmartContractSignatureVerifier::new(
    "https://eth-mainnet.g.alchemy.com/v2/...",
)?;

// Verify a smart contract wallet signature
let is_valid = verifier.verify(
    contract_address,
    signature_bytes,
    message_hash,
    chain_id,
).await?;

use xmtp_id::IdentityError;

pub enum IdentityError {
    KeyGenerationError(CryptoError),
    UninitializedIdentity,
    Deserialization(DecodeError),
    UrlParseError(ParseError),
    Signing(SignerError),
}