Struct InMemorySigner

Source

pub struct InMemorySigner { /* private fields */ }

Expand description

A signer with a single key stored in memory.

This is the simplest signer implementation, suitable for scripts, bots, and testing.

§Example

use near_kit::InMemorySigner;

let signer = InMemorySigner::new(
    "alice.testnet",
    "ed25519:3D4YudUahN1nawWogh8pAKSj92sUNMdbZGjn7kERKzYoTy8tnFQuwoGUC51DowKqorvkr2pytJSnwuSbsNVfqygr"
).unwrap();

Implementations§

Source §

impl InMemorySigner

Source

pub fn new( account_id: impl TryIntoAccountId, secret_key: impl AsRef<str>, ) -> Result<Self, Error>

Create a new signer with an account ID and secret key.

§Arguments

account_id - The NEAR account ID (e.g., “alice.testnet”)
secret_key - The secret key in string format (e.g., “ed25519:…”)

§Errors

Returns an error if the account ID or secret key cannot be parsed.

Source

pub fn from_secret_key( account_id: impl TryIntoAccountId, secret_key: SecretKey, ) -> Result<Self, Error>

Create a signer from a SecretKey directly.

§Errors

Returns an error if account_id cannot be converted to a valid AccountId.

Source

pub fn generate_implicit() -> Self

Generate a random Ed25519 key and derive an implicit account ID.

The account ID is the hex-encoded Ed25519 public key bytes (64 characters).

§Example

use near_kit::{InMemorySigner, Signer};

let signer = InMemorySigner::generate_implicit();
assert_eq!(signer.account_id().as_str().len(), 64);

Source

pub fn implicit(secret_key: SecretKey) -> Self

Create a signer from an existing secret key, deriving an implicit account ID.

The account ID is the hex-encoded Ed25519 public key bytes (64 characters).

§Panics

Panics if the secret key is not Ed25519.

§Example

use near_kit::{InMemorySigner, SecretKey, Signer};

let secret_key = SecretKey::generate_ed25519();
let signer = InMemorySigner::implicit(secret_key);
assert_eq!(signer.account_id().as_str().len(), 64);

Source

pub fn from_seed_phrase( account_id: impl TryIntoAccountId, phrase: impl AsRef<str>, ) -> Result<Self, Error>

Create a signer from a BIP-39 seed phrase.

Uses SLIP-10 derivation with the default NEAR HD path (m/44'/397'/0').

§Arguments

account_id - The NEAR account ID (e.g., “alice.testnet”)
phrase - BIP-39 mnemonic phrase (12, 15, 18, 21, or 24 words)

§Example

use near_kit::InMemorySigner;

let signer = InMemorySigner::from_seed_phrase(
    "alice.testnet",
    "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
).unwrap();

Source

pub fn from_seed_phrase_with_path( account_id: impl TryIntoAccountId, phrase: impl AsRef<str>, hd_path: impl AsRef<str>, ) -> Result<Self, Error>

Create a signer from a BIP-39 seed phrase with custom HD path.

§Arguments

account_id - The NEAR account ID
phrase - BIP-39 mnemonic phrase
hd_path - BIP-32 derivation path (e.g., "m/44'/397'/0'")

§Example

use near_kit::InMemorySigner;

let signer = InMemorySigner::from_seed_phrase_with_path(
    "alice.testnet",
    "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",
    "m/44'/397'/1'"
).unwrap();

Source