Skip to main content

Python package for Parity's Secret Store API calls and sessions.

Project description

Secret Store python package

This is a python library for interacting with Parity's secret store. It is an abstraction layer (API) on top of the official secretstore module RPC API and secretstore sessions. Naming conventions follow the underlying APIs'.

The documentation is for this library and its functions. For more information on how Secret Store works, please refer to the Parity wiki. Most of the function descriptions have been copied from there.


Primary: Adam Nagy (@ngyam)


Documentation Status



pip install secretstore

Then in your project:

from web3 import Web3, HTTPProvider
from secretstore import SecretStore

web3 = Web3(HTTPProvider(""))

# endpoint exposed by your Secret Store
ss = SecretStore(web3, "")

# secretstore API calls

# secretstore session calls

If you wonder how to set up a Secret Store cluster, check out the official config guide and peek into the nodes_ss_dev/ folder.


You can see some examples amongst the tests.


Please read contributing and our code of conduct for details.

Getting started (as a dev)


  • Python 3.5+


git clone
pip install -e .[dev]

Running the tests

ACHTUNG: make sure to start the local secret store cluster first.

  1. start nodes
cd nodes_ss_dev
  1. run tests
cd tests
python3 -m unittest
  1. When done fiddling around:
cd nodes_ss_dev && ./


We use SemVer for versioning. Version number is bumped with bumpversion tool.


This project is licensed under the GPLv3 License - see the LICENSE file for details.


  • Special thanks to Parity

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

secretstore-0.0.2.tar.gz (7.2 kB view hashes)

Uploaded Source

Built Distribution

secretstore-0.0.2-py3-none-any.whl (20.8 kB view hashes)

Uploaded Python 3

Supported by

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