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.
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
25c77cfbfe9c65fc992936ee87cc26ffd43c2a28d5cabd33379d7be3f71ab8ac
|
|
| MD5 |
af6b9a4f45f624dcc6c209ef972558bc
|
|
| BLAKE2b-256 |
07499c2f7c6429b54a5b25ff8b9b5a243e7132deb36b1bfe2997a1546b24815a
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c76a50bdefe0da3a2a1cbbf69383f3a7a2855348c4bf5d2619ef9b30c334518c
|
|
| MD5 |
0e227bab265ce4853119552593b6ca57
|
|
| BLAKE2b-256 |
b5bc2f669f8cc7a2d71cf094e452d7fb613f22b1e6627114b0e51cedd31ad188
|