PyCorda is a free, open-source Python framework for developers and data analysts who need to read and analyze data from the Corda distributed ledger. It pulls node and vault data into familiar Python workflows, so you can chart what is happening on a ledger without building a custom reader from scratch.
Before you install it, know the project's status: there have been no code updates since November 2020. That makes PyCorda an older tool that may not match newer Corda versions or current Python releases. It remains readable as a reference and a starting point, but treat it as unmaintained and test it carefully before relying on it for real analysis.
What Corda Is and Why Its Data Needs Special Tools
Corda is a distributed ledger platform designed for businesses that need to share certain records with specific parties rather than broadcast everything to the public. On a public blockchain, anyone can browse transactions with a general block explorer. Corda works differently: data is shared on a need-to-know basis between participants, so a general-purpose explorer often cannot show the records you need.
That gap is what PyCorda tries to fill. Analysts and developers who run or observe Corda nodes need a programmatic way to read node and vault records. A Python framework fits this role because most data work already happens in Python, and pandas gives you tables to work with immediately.
The exact structure of records depends on the Corda application you run. Before building dashboards, inspect a small sample of your own data so you know which fields exist and how they are named. This step prevents most of the errors that appear later in charts and summaries.
Real-World Use Cases for Corda Ledger Analytics
PyCorda is easiest to understand through concrete scenarios. Here are three common patterns:
- A compliance analyst at an organization running a Corda network might export vault records each week and chart how holdings change over time.
- A developer testing a Corda application might load node data into a DataFrame to confirm that test transactions produce the expected records.
- An internal reporting team might turn raw ledger extracts into charts for a monthly review meeting, keeping the same script for every period.
These workflows benefit from repeatability. Save each script with a clear name and a comment about the data it expects. Because the project is no longer updated, treat PyCorda as a learning base or prototype tool for these tasks, and plan to move to maintained tooling if the work becomes critical to operations.
Key Concepts: Ledger, Vault and DataFrame Explained
A ledger is the shared record of what happened on a network. In Corda, a node is a participant's server that holds its own part of that record, and the vault is the store of data a node keeps for its own use. When you read from a vault, you are reading the subset of the ledger that your node is entitled to see.
A DataFrame is a two-dimensional table with labeled columns, the most common structure for analysis in pandas. Converting raw records into a DataFrame lets you sort, filter and summarize without writing manual loops. It also makes results easier to share with colleagues who work in spreadsheets.
Understanding these terms helps you ask better questions. If you know that a vault holds only what your node can see, you will not expect a complete network picture from a single node. That expectation is a common source of confusion for newcomers to Corda analytics.
Key features
Node and Vault Data Access
DataFrame-Ready Output
Quick Charts and Graphs
Machine Learning on the Roadmap
Supported coins
PyCorda is built around the Corda distributed ledger rather than public coin networks, so it is not a multi-coin tool. If you need Bitcoin, Ethereum or exchange data, you will need other programs. Its narrow scope keeps its use cases focused on one platform, which makes the results easier to interpret.
How to install PyCorda on Windows
- 1
Get the source code
Download the project from its GitHub repository at github.com/chainhaus/pycorda, or start from the official website at PyCorda.com. Check the GitHub Releases page first if it lists packaged versions. Download only from the official website or GitHub.
- 2
Verify the file
Compare the SHA-256 checksum or signature with the value published by the source, if one is provided. If nothing is published, read the code before running it, paying attention to any part that opens network connections.
- 3
Prepare a Python environment
Create a dedicated Python environment for your project so PyCorda's dependencies stay separate from other work. Python is needed to run the framework, and the exact setup depends on how you obtained the code.
- 4
Add the H2 jar file
Place an h2.jar file in your project's local folder. If the jar is stored elsewhere on your filesystem, point your project to it. This step needs to be done only once per project.
-
Check platform notes
Read the platform-specific instructions in the documentation, since some additional software may be needed depending on your system. Windows is mentioned in the docs, so run a small read operation to confirm that it works before relying on it.
System requirements
- Windows is listed in the project documentation, but Windows support has not been verified, so test before depending on it
- An h2.jar file in the project folder, placed once per project
- Additional platform-specific software, depending on your system, as described in the project documentation
- Access to a Corda node or vault that you are permitted to read
How to use PyCorda
Once installed, a typical session follows the same pattern: connect to the data source, pull the records you need, convert them to a DataFrame and then chart the result. Keep each script small so you can check every step as you go.
- Confirm that your project folder contains the h2.jar file and that your Python environment is active.
- Connect PyCorda to the Corda node or vault you have permission to read.
- Query the node or vault data you want to analyze, starting with a small subset of records.
- Load the results into a pandas DataFrame and inspect column names and data types.
- Filter, group or summarize the data using standard pandas operations.
- Generate a chart or graph from the summarized table and save the output.
- Record which Corda version and PyCorda code version you used, so results can be reproduced later.
Pros & cons
- Free and open source, with public source code on GitHub
- Brings Corda data into familiar Python and pandas workflows
- Includes built-in chart and graph generation
- Focused on one platform, so its purpose is clear
- Covered in depth in the book Mastering Corda for further study
- No code updates since November 2020
- Windows support is mentioned in the docs but not verified
- Machine learning features are announced, not available
- Requires an H2 jar file setup for each project
- Narrow scope: it only covers the Corda ledger
Is PyCorda safe?
PyCorda is no longer actively maintained; its last code update was in November 2020. Treat it as an unmaintained project that may contain unfixed bugs and may not keep pace with newer Corda or Python releases. Download the code only from the official website, PyCorda.com, or from its GitHub repository. Before running anything, compare the SHA-256 checksum or signature with the value published by the source, if one is available. Review any code that touches credentials or network connections, and never enter a seed phrase or private key into a third-party website or script. If you connect to a production node, use a read-only account with limited access. For the latest version, check the official website.
- Official source only. Download from github.com/chainhaus/pycorda. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
PyCorda is the only program in this set built for the Corda distributed ledger. Chainhook is a reorg-aware indexing engine for Stacks and Bitcoin, aimed at developers who need reliable chain indexing rather than Corda records. Bitcoin Database Generator exports the Bitcoin blockchain into SQL Server, which suits teams that want their data in a relational database. Cshtop offers a terminal visualizer for Cosmos blocks, and BX is a command-line tool for Bitcoin. If your data lives on Corda, PyCorda is the closest fit. For Bitcoin or Cosmos, the alternatives match the chain you use. Because PyCorda has not been updated since 2020, check the status of each option before you choose.
Specifications
- Price
- Free
- Type
- Open source
- License
- —
- Latest version
- —
- Last update
- 24 Nov 2020
- Windows support
- Unverified (Windows mentioned in docs)
- Source code
- github.com/chainhaus/pycorda
Frequently asked questions
No. PyCorda has had no code updates since November 2020, so treat it as an unmaintained project. It may still run for simple tasks, but it may not work with newer Corda or Python versions. Test it on a copy of your data first, and check the official website for the latest version before deciding whether to use it for real work.
It can be, when you get it from the project's own GitHub repository and check a published checksum or signature. Since the code is public, you can read it before running anything. Avoid copies from unfamiliar sites, and never enter a seed phrase or private key into any script or web page you do not control.
PyCorda is used to read data from the Corda distributed ledger with Python, then turn that data into tables and charts. Typical uses include reviewing vault records, checking test data during development and building simple reports. It is a framework for analysts and developers who are comfortable writing code.
No. PyCorda is built for the Corda distributed ledger, not public coin networks like Bitcoin or Ethereum. For those chains, look at tools such as Bitcoin Database Generator or Chainhook instead. Check which chain your project uses before choosing a tool, so your analysis matches the data you actually need.
Yes. PyCorda is a Python framework, so you need to write and run Python code to use it. Basic familiarity with pandas DataFrames helps as well, since results are organized in that format. Beginners can start with small scripts that load a few records and print them before adding charts.
Yes, PyCorda is free and open source, and its source code is available on GitHub. There is no price to pay for the framework itself. Your main costs are the time spent on setup and access to the Corda environment you need to read from.
Verdict
PyCorda suits Python developers and analysts who work with Corda data and want a simple way to query and chart it. Its free license and open code make it a useful learning tool or prototype base. However, the project has had no code updates since November 2020, and Windows support has not been verified. Use it for experiments and training, and plan for maintained tooling before you rely on it for production reporting.