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.0.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.0-py3-none-any.whl (41.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nectarengine-1.0.0.tar.gz
  • Upload date:
  • Size: 33.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","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.0.tar.gz
Algorithm Hash digest
SHA256 9c913e9ed4f2aba689e3fac26af4ae6c4e96c0a210edda13ad4352c85fd1e915
MD5 9e3e10ab0f561b095aa671610109f3be
BLAKE2b-256 07d41a7cf1b82b32499a136ff73038a09634d69b49eeaa9aa0b4250eabc84db1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: nectarengine-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 41.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cf13061ebe3e2c9181a218fa2df8754caa10ff263d097cfe01682ef9ddfb9b59
MD5 650cea50994499ea3a0bb2f6b2c7b9b8
BLAKE2b-256 f623ff9fe9be6eec480bf5706eb0c912dfe59adcc1b231ebf00b051a17c96075

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