Skip to main content

command line tool and python library for sending hive engine tokens

Project description

⚙️ nectarengine

The modern Python library for Hive Engine tokens. Built for production. Made to last.

nectarengine is the high-performance companion to Nectar, specifically designed for interacting with the Hive Engine sidechain. While Nectar handles the core blockchain layer, nectarengine provides an opinionated, resilient, and simplified interface for token operations, market trading, and NFT management.

If you are building on Hive Engine, nectarengine is the tool you need.


PyPI version Python Versions License Documentation


Why nectarengine?

Three ways nectarengine simplifies sidechain development.

⚡ Built on Nectar

nectarengine is built on top of Nectar, inheriting its modern cryptography, connection pooling, and resilient transport layers. It replaces legacy sidechain tools with a clean, typed API.

🐳 Container-Native & Serverless Ready

Inheriting Nectar's philosophy, nectarengine is designed to run anywhere. It handles environment-specific challenges—like read-only filesystems in Docker or Kubernetes—by defaulting to in-memory fallbacks when local storage is unavailable.

🪙 Unified Sidechain Interface

Forget complex JSON-RPC calls. nectarengine provides dedicated objects for:

  • Tokens: Easy balance checks, transfers, and metadata lookups.
  • Market: Seamless buy/sell orders and order book management.
  • NFTs: Comprehensive support for minting, transferring, and querying digital assets.

🚀 Quick Start

Requires Python >= 3.10.

pip install nectarengine

Get sidechain status

from nectarengine.api import Api

api = Api()
print(f"Latest Block: {api.get_latest_block_info()['blockNumber']}")

Send Tokens

from nectar import Hive
from nectarengine.wallet import Wallet

# Initialize Hive with your active key
hive = Hive(keys=["your-active-private-key"])

# Create a wallet for the account
wallet = Wallet("youraccount", blockchain_instance=hive)

# Transfer 1.0 BEE to a recipient
wallet.transfer("recipient", 1.0, "BEE", memo="Sent with nectarengine")

Trade on the Market

from nectar import Hive
from nectarengine.market import Market

hive = Hive(keys=["your-active-private-key"])
market = Market(blockchain_instance=hive)

# Buy 100 SWAP.HIVE with BEE at a price of 0.5
market.buy("youraccount", 100, "SWAP.HIVE", 0.5)

🛠️ System Prerequisites

On platforms where binary wheels for coincurve and cryptography are not precompiled, build tools are required to compile the C extensions.

Debian / Ubuntu

sudo apt-get install build-essential libssl-dev python3-dev python3-pip libffi-dev libtool autoconf automake pkg-config

Fedora / RHEL

sudo dnf install gcc openssl-devel python3-devel libffi-devel libtool autoconf automake pkgconfig

🌐 Built by SRBDE

nectarengine is developed and maintained by the Sustainable Resource and Business Development Enterprise (SRBDE) — an open-source infrastructure organization building tools and platforms for communities that build things together.

We apply the logic of agricultural sustainability to software: the goal is always to return more to the ecosystem than we extract.

  • Open source is our value, not just our business model.
  • Our commercial products fund our open-source core. The open work is the mission.

Explore the Ecosystem

Project Description
Pollen The modern Hive TypeScript SDK
Anther The modern Hive Go SDK
Xylem The modern Hive Rust SDK
Nectar The modern Hive Python SDK
nectarengine The Hive-Engine sidechain library
ecoinstats.net SRBDE corporate hub
thecrazygm.com Open gaming tools & TTRPGs

🤝 Contributing

Audits, forks, and pull requests are welcome. If you find a security issue, please open a private advisory rather than a public issue.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nectarengine-1.0.1.tar.gz (33.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nectarengine-1.0.1-py3-none-any.whl (41.8 kB view details)

Uploaded Python 3

File details

Details for the file nectarengine-1.0.1.tar.gz.

File metadata

  • Download URL: nectarengine-1.0.1.tar.gz
  • Upload date:
  • Size: 33.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":null,"id":"forky","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for nectarengine-1.0.1.tar.gz
Algorithm Hash digest
SHA256 25c77cfbfe9c65fc992936ee87cc26ffd43c2a28d5cabd33379d7be3f71ab8ac
MD5 af6b9a4f45f624dcc6c209ef972558bc
BLAKE2b-256 07499c2f7c6429b54a5b25ff8b9b5a243e7132deb36b1bfe2997a1546b24815a

See more details on using hashes here.

File details

Details for the file nectarengine-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: nectarengine-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 41.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":null,"id":"forky","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for nectarengine-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c76a50bdefe0da3a2a1cbbf69383f3a7a2855348c4bf5d2619ef9b30c334518c
MD5 0e227bab265ce4853119552593b6ca57
BLAKE2b-256 b5bc2f669f8cc7a2d71cf094e452d7fb613f22b1e6627114b0e51cedd31ad188

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page