#transaction #near #signing #facilitate #creation #blockchain #builder

near-transactions

High-level abstractions to facilitate the creation, manipulation, and signing of transactions on the NEAR blockchain

1 unstable release

0.1.0-alpha Mar 20, 2024

#33 in #facilitate


Used in 2 crates (via near-accounts)

MIT/Apache

10KB
107 lines

near-transactions

The near-transactions crate is a Rust crate designed to facilitate the creation, manipulation, and signing of transactions on the NEAR blockchain. Leveraging the builder pattern, this crate provides a fluent and flexible way to construct transactions programmatically, simplifying the process of interacting with the blockchain.

Features

  • Transaction Builder: At the heart of this crate is the TransactionBuilder, a struct that guides users through the construction of transactions. Starting with essential details like signer and receiver IDs, it incrementally builds up a transaction by adding actions such as token transfers, contract deployments, and function calls.

  • Comprehensive Action Support: Supports a wide array of actions including creating accounts, deploying contracts, transferring tokens, staking tokens, adding keys, deleting keys, and deleting accounts. This allows for the execution of complex operations on the NEAR blockchain.

  • Signing Transactions: Once a transaction is fully constructed, it can be signed using a Signer.

  • Extensibility: Designed with extensibility in mind, enabling the addition of more actions and features in the future without breaking existing implementations.

Getting Started

Add near-transactions to your Cargo.toml to start building and signing transactions:

[dependencies]
near-transactions = "0.1.0-alpha"

Example Usage

use near_transactions::TransactionBuilder;
use near_crypto::{InMemorySigner, KeyType};
use near_primitives::types::{AccountId, Balance, Gas};

fn main() {
    // Initialize a signer
    let signer = InMemorySigner::from_seed("example.signer", KeyType::ED25519, "seed");

    // Build a transaction
    let transaction = TransactionBuilder::new(
            "example.signer.near".parse().unwrap(),
            signer.public_key(),
            "example.receiver.near".parse().unwrap(),
            1, // nonce
            "e...".parse().unwrap(), // block hash
        )
        .transfer(100_000_000_000_000_000_000_000_000) // transferring 100 NEAR
        .sign_transaction(&signer); // Sign the transaction

    // Now `transaction` is ready to be sent to the blockchain
}

This example demonstrates how to construct and sign a simple transaction for transferring tokens. The process involves creating a TransactionBuilder, adding the desired actions, and finally signing the transaction with a signer.

Contributing

We welcome contributions to the near-transactions crate! Please feel free to submit pull requests or open issues to suggest improvements or add new features.

Dependencies

~31–44MB
~654K SLoC