Crate monero_serai

monero-serai

A modern Monero transaction library intended for usage in wallets. It prides itself on accuracy, correctness, and removing common pit falls developers may face.

monero-serai also offers the following features:

• Featured Addresses
• A FROST-based multisig orders of magnitude more performant than Monero’s

Purpose and support

monero-serai was written for Serai, a decentralized exchange aiming to support Monero. Despite this, monero-serai is intended to be a widely usable library, accurate to Monero. monero-serai guarantees the functionality needed for Serai, yet will not deprive functionality from other users.

Various legacy transaction formats are not currently implemented, yet we are willing to add support for them. There aren’t active development efforts around them however.

Caveats

This library DOES attempt to do the following:

• Create on-chain transactions identical to how wallet2 would (unless told not to)
• Not be detectable as monero-serai when scanning outputs
• Not reveal spent outputs to the connected RPC node

This library DOES NOT attempt to do the following:

• Have identical RPC behavior when creating transactions
• Be a wallet

This means that monero-serai shouldn’t be fingerprintable on-chain. It also shouldn’t be fingerprintable if a targeted attack occurs to detect if the receiving wallet is monero-serai or wallet2. It also should be generally safe for usage with remote nodes.

It won’t hide from remote nodes it’s monero-serai however, potentially allowing a remote node to profile you. The implications of this are left to the user to consider.

It also won’t act as a wallet, just as a transaction library. wallet2 has several non-transaction-level policies, such as always attempting to use two inputs to create transactions. These are considered out of scope to monero-serai.

Modules

• block
  Block structs.
• ring_signatures
  Ring Signature structs and functionality.
• ringct
  RingCT structs and functionality.
• rpc
  Monero daemon RPC interface.
• transaction
  Transaction structs.
• wallet
  Wallet functionality, enabling scanning and sending transactions.

Structs

• Commitment
  Transparent structure representing a Pedersen commitment’s contents.

Enums

• Protocol
  Monero protocol version.

Constants

• BLOCK_TIME
• COINBASE_LOCK_WINDOW
• DEFAULT_LOCK_WINDOW

Functions

• H
  Monero’s alternate generator H, used for amounts in Pedersen commitments.
• decompress_point
  Decompress canonically encoded ed25519 point It does not check if the point is in the prime order subgroup
• hash_to_scalar
  Hash the provided data to a scalar via keccak256(data) % l.
• random_scalar
  Support generating a random scalar using a modern rand, as dalek’s is notoriously dated.