---
id: eciespy
version: "0.4.6"
license: MIT
license_treatment: permissive
maintenance: active
---

# eciespy — Elliptic Curve Integrated Encryption Scheme for secp256k1/curve25519 in Python

License: permissive · Maintenance: active · Downloads: 116.9K/mo

## What it is and what it does

eciespy is a Python implementation of the Elliptic Curve Integrated Encryption Scheme (ECIES), a hybrid encryption standard that combines elliptic curve cryptography with symmetric encryption. It supports three elliptic curves—secp256k1 (used in Bitcoin and Ethereum), x25519, and ed25519—and allows you to encrypt data with a recipient's public key and decrypt it with their private key. The library handles the complexity of key derivation, ephemeral key generation, and authenticated encryption internally.

The package is designed for developers who need public-key encryption in cryptocurrency, blockchain, or general security applications. It provides both a Python API and a command-line interface for key generation, encryption, and decryption. Configuration options let you choose between AES-256-GCM and XChaCha20-Poly1305 for symmetric encryption, and between compressed or uncompressed key formats for secp256k1. Runtime dependencies are typing-extensions, coincurve, and pycryptodome.

Use it for:

- Encrypt sensitive data in Ethereum or Bitcoin applications using secp256k1 keys.
- Build end-to-end encrypted messaging or file-sharing systems with x25519 key exchange.
- Generate and manage cryptographic key pairs for blockchain wallets or smart contract interactions.
- Implement encryption compatibility by matching configuration with other language implementations.
- Encrypt configuration or credential files in command-line workflows using the CLI tool.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Encrypts and decrypts data using Elliptic Curve Integrated Encryption Scheme (ECIES) with support for secp256k1, x25519, and ed25519 curves.

Yes. eciespy is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and provides a straightforward API for a well-defined cryptographic task. Install it if you need ECIES encryption with secp256k1 or curve25519 in Python—particularly for cryptocurrency or blockchain applications. The low install friction and stable maintenance history make it a reliable choice.

## Install

pip install eciespy
uv add eciespy
poetry add eciespy

## Installing eciespy

Before you install: Low install friction with a pure Python wheel distribution. Actively maintained with a recent commit on 2026-04-03 and regular releases; last version published 2025-07-21.

License in practice: MIT license (permissive) allows free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install eciespy

from eciespy.keys import PrivateKey
from eciespy import encrypt, decrypt

sk = PrivateKey('secp256k1')
data = b'hello world'
encrypted = encrypt(sk.public_key.to_bytes(True), data)
decrypted = decrypt(sk.secret, encrypted)

Requires Python 3.9 or later (supports up to 3.13); runtime dependencies typing-extensions, coincurve, and pycryptodome must be installed.

Verify before relying:

- Performance characteristics or throughput benchmarks for different curve/cipher combinations.
- Interoperability test results with other language implementations mentioned in the project.
- Security audit or formal verification status of the implementation.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 116.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

elliptic curve encryption, secp256k1 encryption, ECIES encryption scheme, curve25519 encryption, public key encryption python, cryptocurrency key encryption, AES-GCM encryption library, elliptic-curve-crypto, blockchain-ready

[View on SkillFed](https://skillfed.io/packages/eciespy) · [View on PyPI](https://pypi.org/project/eciespy/)