Struct Address 

pub struct Address { /* private fields */ }

A Bitcoin P2PKH address.

Contains the 20-byte public key hash and the network prefix byte. Supports both mainnet (prefix 0x00, addresses start with 1) and testnet (prefix 0x6f, addresses start with m or n).

Cross-SDK Compatibility

This implementation is compatible with the Go SDK’s script.Address and the TypeScript SDK’s address handling. The same address strings are produced for the same public keys across all three SDKs.

Implementations

impl Address

pub fn new_from_string(address: &str) -> Result<Self>

Creates an Address from a Base58Check encoded address string.

Validates the checksum and ensures the address uses a supported version prefix (mainnet 0x00 or testnet 0x6f).

Arguments

• address - A P2PKH address string

Returns

The parsed Address, or an error if the string is invalid.

Example

use bsv_rs::script::Address;

let addr = Address::new_from_string("1BgGZ9tcN4rm9KBzDn7KprQz87SZ26SAMH").unwrap();
assert_eq!(addr.to_string(), "1BgGZ9tcN4rm9KBzDn7KprQz87SZ26SAMH");

pub fn new_from_public_key_hash(hash: &[u8], mainnet: bool) -> Result<Self>

Creates an Address from a raw 20-byte public key hash.

Arguments

• hash - The 20-byte public key hash (RIPEMD160(SHA256(pubkey)))
• mainnet - If true, creates a mainnet address; otherwise testnet

Returns

The Address, or an error if the hash is not 20 bytes.

Example

use bsv_rs::script::Address;

let hash = [0u8; 20];
let addr = Address::new_from_public_key_hash(&hash, true).unwrap();

pub fn new_from_public_key( public_key: &PublicKey, mainnet: bool, ) -> Result<Self>

Creates an Address from a PublicKey.

Computes the hash160 (RIPEMD160(SHA256(compressed_pubkey))) and creates a mainnet or testnet address.

Arguments

• public_key - The public key to derive the address from
• mainnet - If true, creates a mainnet address; otherwise testnet

Returns

The Address.

Example

use bsv_rs::script::Address;
use bsv_rs::primitives::ec::PrivateKey;

let key = PrivateKey::random();
let addr = Address::new_from_public_key(&key.public_key(), true).unwrap();

pub fn public_key_hash(&self) -> &[u8]

Returns the 20-byte public key hash.

This is the RIPEMD160(SHA256(compressed_pubkey)) value that is the same regardless of the network type (mainnet or testnet).

pub fn prefix(&self) -> u8

Returns the network prefix byte.

• 0x00 for mainnet
• 0x6f for testnet

pub fn is_mainnet(&self) -> bool

Returns true if this is a mainnet address.

pub fn is_valid_address(address: &str) -> bool

Validates whether a string is a valid P2PKH address.

Returns true if the address can be parsed successfully with a valid checksum and a supported version prefix.

Arguments

• address - The address string to validate

Example

use bsv_rs::script::Address;

assert!(Address::is_valid_address("1BgGZ9tcN4rm9KBzDn7KprQz87SZ26SAMH"));
assert!(!Address::is_valid_address("invalid"));

Trait Implementations

impl Clone for Address

fn clone(&self) -> Address

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Address

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

Formats the value using the given formatter.

impl Display for Address

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

Formats the value using the given formatter.

impl FromStr for Address

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl PartialEq for Address

fn eq(&self, other: &Address) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Address

impl StructuralPartialEq for Address