Crate signet_rs 

signet-rs

Minimal, no_std transaction builders for Bitcoin and EVM networks, ready for contracts, embedded clients, and signing services.

Crates.io • Documentation • Testing Guide

Documentation

• API reference: https://docs.rs/signet-rs
• Build locally: cargo doc --all-features --no-deps --open
• Doc notes: see docs/README.md

Installation

[dependencies]
signet-rs = "1.0.0"

Features

• ✅ EVM transaction builder with native EIP-1559 encoding and flexible access-list support.
• ✅ Bitcoin transaction builder with legacy + SegWit signing payloads, PSBT helpers, and DER utilities.
• ✅ no_std by default with opt-in std feature for integrations such as schemars.

Quick Start

EVM transaction

use signet_rs::evm::utils::parse_eth_address;
use signet_rs::{TransactionBuilder, TxBuilder, EVM};

let to_address_str = "d8dA6BF26964aF9D7eEd9e03E53415D37aA96045";
let to_address = parse_eth_address(to_address_str);
let max_gas_fee: u128 = 20_000_000_000;
let max_priority_fee_per_gas: u128 = 1_000_000_000;
let gas_limit: u128 = 21_000;
let chain_id: u64 = 1;
let nonce: u64 = 0;
let data: Vec<u8> = vec![];
let value: u128 = 10_000_000_000_000_000; // 0.01 ETH

let evm_tx = TransactionBuilder::new::<EVM>()
    .nonce(nonce)
    .to(to_address)
    .value(value)
    .input(data.clone())
    .max_priority_fee_per_gas(max_priority_fee_per_gas)
    .max_fee_per_gas(max_gas_fee)
    .gas_limit(gas_limit)
    .chain_id(chain_id)
    .build();

let rlp_encoded = evm_tx.build_for_signing();

Bitcoin transaction

use signet_rs::bitcoin::types::{
    Amount, Hash, LockTime, OutPoint, ScriptBuf, Sequence, TxIn, TxOut, Txid, Version, Witness,
    EcdsaSighashType,
};
use signet_rs::{TransactionBuilder, TxBuilder, BITCOIN};

let txid_str = "2ece6cd71fee90ff613cee8f30a52c3ecc58685acf9b817b9c467b7ff199871c";
let hash = Hash::from_hex(txid_str).unwrap();
let txid = Txid(hash);
let vout = 0;

let txin: TxIn = TxIn {
    previous_output: OutPoint::new(txid, vout as u32),
    script_sig: ScriptBuf::default(), // P2PKH script_sig is initially empty.
    sequence: Sequence::MAX,
    witness: Witness::default(),
};

let sender_script_pubkey_hex = "76a914cb8a3018cf279311b148cb8d13728bd8cbe95bda88ac";
let sender_script_pubkey = ScriptBuf(sender_script_pubkey_hex.as_bytes().to_vec());

let receiver_script_pubkey_hex = "76a914406cf8a18b97a230d15ed82f0d251560a05bda0688ac";
let receiver_script_pubkey = ScriptBuf(receiver_script_pubkey_hex.as_bytes().to_vec());

let spend_txout: TxOut = TxOut {
    value: Amount::from_sat(500_000_000),
    script_pubkey: receiver_script_pubkey,
};

let change_txout = TxOut {
    value: Amount::from_sat(100_000_000),
    script_pubkey: sender_script_pubkey,
};

let bitcoin_tx = TransactionBuilder::new::<BITCOIN>()
    .version(Version::One)
    .inputs(vec![txin])
    .outputs(vec![spend_txout, change_txout])
    .lock_time(LockTime::from_height(0).unwrap())
    .build();

let encoded_tx = bitcoin_tx.build_for_signing_legacy(EcdsaSighashType::All);

Testing

See TESTING.md for the unit, integration, and feature-flag test matrix plus the exact cargo commands we run in CI.

License

Licensed under the Apache License 2.0. Portions derive from omni-transaction-rs by NEAR Protocol and contributors.

Copyright 2024 Proximity Labs Limited

Modules

bitcoin

Transaction builder, encoders, types and utilities for Bitcoin.

evm

Transaction builder, encoders, types and utilities for EVM.

signer

Structs

TransactionBuilder

Type-erased entry point that hands back the requested chain builder.

Traits

TxBuilder

Trait implemented by chain-specific builders to produce a concrete transaction payload. Implementations usually hold a set of optional fields that are validated right before build.

Type Aliases

BITCOIN

Alias for BitcoinTransactionBuilder

EVM

Alias for EVMTransactionBuilder