![Penumbra logo](docs/images/penumbra-dark.svg#gh-dark-mode-only)
![Penumbra logo](docs/images/penumbra-light-bw.svg#gh-light-mode-only)

[Penumbra] is a fully shielded zone for the Cosmos ecosystem, allowing anyone to securely transact,
stake, swap, or marketmake without broadcasting their personal information to the world.

## Getting involved

The primary communication hub is our [Discord]; click the link to join the
discussion there.

The guide to using the Penumbra software and interacting with the testnets can be found at [guide.penumbra.zone][guide].

The (evolving) protocol spec is rendered at [protocol.penumbra.zone][protocol].

The (evolving) API documentation is rendered at [rustdoc.penumbra.zone][rustdoc].

The (evolving) protobuf documentation is rendered at [buf.build/penumbra-zone/penumbra][protobuf].

To participate in our test network, use Penumbra command line client [`pcli`][pcli].

To join the test network as a full node, follow setup instructions for Penumbra node implementation [`pd`][pd].

## Current work and roadmap

For a high-level view of current work-in-progress and future items, check out our:

- [Tracking issues][Tracking]
- [Backlog][Backlog]

[Tracking]: https://github.com/orgs/penumbra-zone/projects/23/views/4
[Backlog]: https://github.com/orgs/penumbra-zone/projects/23/views/1
[Discord]: https://discord.gg/hKvkrqa3zC
[Penumbra]: https://penumbra.zone
[protocol]: https://protocol.penumbra.zone
[guide]: https://guide.penumbra.zone
[pcli]: https://guide.penumbra.zone/main/pcli.html
[pd]: https://guide.penumbra.zone/main/pd.html
[mdBook]: https://github.com/rust-lang/mdBook
[rustdoc]: https://rustdoc.penumbra.zone
[protobuf]: https://buf.build/penumbra-zone/penumbra
[tm-install]: https://github.com/tendermint/tendermint/blob/master/docs/introduction/install.md#from-source


## Security
If you believe you've found a security-related issue with Penumbra,
please disclose responsibly by contacting the Penumbra Labs team at
security@penumbralabs.xyz.

## License

By contributing to penumbra you agree that your contributions will be licensed
under the terms of both the [LICENSE-Apache-2.0](LICENSE-Apache-2.0) and the
[LICENSE-MIT](LICENSE-MIT) files in the root of this source tree.

If you're using penumbra you are free to choose one of the provided licenses:

`SPDX-License-Identifier: MIT OR Apache-2.0`