Cartouche.Solana.Signer (Cartouche v0.2.0)

GenServer that wraps Ed25519 signing backends for Solana.

Follows the same MFA (module, function, args) backend pattern as the Ethereum Cartouche.Signer, but much simpler: no recovery bit brute-force, no chain ID encoding.

Delegates to a backend module (e.g., Cartouche.Solana.Signer.Ed25519 for local keys, or Cartouche.Solana.Signer.CloudKMS for GCP KMS). Caches the public key on first use.

Examples

# Start via supervisor or manually:
{:ok, pid} = Cartouche.Solana.Signer.start_link(
  mfa: {Cartouche.Solana.Signer.Ed25519, :sign, [seed]},
  name: MySolSigner
)

# Sign a message:
{:ok, signature} = Cartouche.Solana.Signer.sign(message, MySolSigner)

# Get the signer's public key:
pub_key = Cartouche.Solana.Signer.address(MySolSigner)

Summary

Functions

address(name \\ Default)

Get the 32-byte public key (Solana address) for this signer.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

sign(message, name \\ Default)

Sign raw message bytes. Returns a 64-byte Ed25519 signature.

start_link(opts)

Starts a new Solana signer process.

verify(message, arg1, arg2)

Verify an Ed25519 signature. Standalone function, no GenServer needed.

Functions

address(name \\ Default)

@spec address(GenServer.name()) :: <<_::256>>

Get the 32-byte public key (Solana address) for this signer.

Examples

iex> signer = Cartouche.Solana.Test.Signer.start_signer()
iex> address = Cartouche.Solana.Signer.address(signer)
iex> byte_size(address)
32

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

sign(message, name \\ Default)

@spec sign(binary(), GenServer.name()) :: {:ok, <<_::512>>} | {:error, term()}

Sign raw message bytes. Returns a 64-byte Ed25519 signature.

Examples

iex> signer = Cartouche.Solana.Test.Signer.start_signer()
iex> {:ok, sig} = Cartouche.Solana.Signer.sign("test", signer)
iex> byte_size(sig)
64

start_link(opts)

@spec start_link(keyword()) :: GenServer.on_start()

Starts a new Solana signer process.

verify(message, arg1, arg2)

@spec verify(binary(), <<_::512>>, <<_::256>>) :: boolean()

Verify an Ed25519 signature. Standalone function, no GenServer needed.

Examples

iex> seed = Base.decode16!("9D61B19DEFFD5A60BA844AF492EC2CC44449C5697B326919703BAC031CAE7F60")
iex> pub = Base.decode16!("D75A980182B10AB7D54BFED3C964073A0EE172F3DAA62325AF021A68F707511A")
iex> {:ok, sig} = Cartouche.Solana.Signer.Ed25519.sign("test", seed)
iex> Cartouche.Solana.Signer.verify("test", sig, pub)
true