Skip to content

Commit

Permalink
Merge branch 'anoma:master' into master
Browse files Browse the repository at this point in the history
  • Loading branch information
RuslanGlaznyov authored Jul 24, 2024
2 parents 667933b + d184c71 commit 8c84427
Show file tree
Hide file tree
Showing 128 changed files with 3,329 additions and 1,348 deletions.
2 changes: 1 addition & 1 deletion packages/community/pages/cb-rpgf-round-1.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# CB RPGF Round 1

The Namada protocol could not be built without public goods and the community wouldn’t be where it is today without the help of the early Community Builders – brought together by the [shared mission](https://namada.net/vision) of using, educating, and collaborating to build privacy. Namada’s native token is not only used for proof-of-stake and governance, but also to [align the incentives](https://namada.net/blog/namada-s-positive-sum-economics) of the community with the network.
The Namada protocol could not be built without public goods and the community wouldn’t be where it is today without the help of the early Community Builders – brought together by a shared mission of using, educating, and collaborating to build technology for user data protection. Namada’s native token is not only used for proof-of-stake and governance, but also to [align the incentives](https://namada.net/blog/namada-s-positive-sum-economics) of the community with the network.

The [Anoma Foundation](https://anoma.foundation/) has announced they will allocate 10,000,000 of Namada’s native token in the genesis block proposal to the selected recipients of the first Namada Community Builder RPGF Round – every active Community Builder member can be a potential recipient, dating back to the beginning of the community’s history. This includes early validators who have participated in previous testnets and have meaningfully worked to assist other validators in gaining access to, raising issues with, or triaging solutions for previous testnets.

Expand Down
13 changes: 6 additions & 7 deletions packages/community/pages/community-builder-handbook.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
## Joining the Namada Community Builders[](https://namada.net/community/docs/community-builder-handbook#joining-the-namada-community-builders)

Namada Community Builders are individuals who are aligned with Namada’s [mission and vision(opens in a new tab)](https://namada.net/vision). They actively collaborate to support and grow the Namada community. Signups are currently closed, but if you were/are interested signing up for the program, the below information will still apply in future situations.
Namada Community Builders are individuals who are aligned with Namada’s mission and vision. They actively collaborate to support and grow the Namada community. Signups are currently closed, but if you were/are interested in signing up for the program, the below information will still apply in future situations.

Taking part in the program means aligning yourself with the Namada network such that you are working toward ensuring that the protocol exists in the long-term. The aim of the program is not to have hundred of contributors, but instead to have a core contingent who are committed to the work. The RPGF program is a means through which to do so, as Community Builders are filtered out based on their level of contribution.

Expand Down Expand Up @@ -44,7 +44,7 @@ If you’re selected to join the Community Builders, an existing member of the C

### Contribution Guidelines[](https://namada.net/community/docs/community-builder-handbook#contribution-guidelines)

**Content Relevance:** Ensure your submissions align with Namada's values and mission, with a focus on its commitment to privacy and blockchain utility, and remember that helping others is also a kind of work. Namada seeks to make privacy cozy and accessible, not an act of fear, and the culture of our community should reflect this.
**Content Relevance:** Ensure your submissions align with Namada's values and mission, with a focus on its commitment to data rights and blockchain utility, and remember that helping others is also a kind of work. Namada seeks to make data protection cozy and accessible, not an act of fear, and the culture of our community should reflect this.

**Avoid Price Speculation:** Discussions involving cryptocurrency pricing or 'moon' references are not permitted. The focus should be on the impact and value proposition of Namada's technology, not on financial gains. We are not looking to increase the value of the token associated with the network, we are seeking to ensure that the network stays around in the long term.

Expand Down Expand Up @@ -101,19 +101,18 @@ Here are some ideas for contributions.
- Actively participate in community channels like Twitter, Discord and Telegram, guiding conversations and disseminating important information.
- Share successful methods of community engagement with other Community Builders to foster a learning environment.
- Launch regional campaigns tailored to local culture and issues to attract a more diversified audience
- Collaborate with local educational institutions to offer workshops, or courses about privacy in blockchain
- Collaborate with local educational institutions to offer workshops, or courses about data protection in blockchain
- Collab with Namada core contributors (Marketing in this case fyi) by conducting outreach efforts for Namada to be covered by different publications, podcasts, media etc.

### Content Creation and Amplification:[](https://namada.net/community/docs/community-builder-handbook#content-creation-and-amplification)

- Create content that helps educate a broader community about Namada and the broader vision on why privacy is paramount in decentralized systems.
- Create content that helps educate a broader community about Namada and the broader vision on why data protection is paramount in decentralized systems.
- Visual media that is digestible and demonstrates an understanding of the protocol and its effect.
- Distill the technical articles written at [blog.namada.net](https://blog.namada.net) into more accessible media. Namada doesn't need re-works of the articles that have already been written, but reflective pieces that speak to the effect of Namada on other networks, or on the culture of the space more broadly.
- Engage in journalistic endeavors to create articles or interviews focused on Namada.
- Write technical documentation or guides related to Namada's ecosystem.
- Speak about Namada's privacy-centric features at blockchain events, workshops, or meetups.
- Speak about Namada's data protection features at blockchain events, workshops, or meetups.
- Live stream discussions, tutorials, or reviews related to Namada. (this can be Twitter Spaces / youtube / twitch / etc.)
- Leading Private Library discussions.

### Development and Technical Contributions:[](https://namada.net/community/docs/community-builder-handbook#development-and-technical-contributions)

Expand All @@ -133,7 +132,7 @@ Don’t forget that you’re not alone! Use these Discord channels for jamming o

* **Low-effort contributions** - While creating visual media is helpful, creating a pretty image with our tagline, or stickers for different social media platforms only helps so much. If you are going to create contributions, let them be vehicles for understanding the protocol. If your entire post history is only Midjourney images with the Namada logo pasted in frame, this is considered low-effort. Take the chance to experiment! Tell a story with your images.
* **Inaccurate contributions** - If you are posting material that explains the protocol, it needs to be accurate - if you are unsure you understand the technology, check with the rest of those in the Community Builders programme. The aim is that by taking part in this programme, you should know the protocol back and forward by the end of your participation.
* **Contributions that target other protocols** - This is particularly egregious and would be grounds for losing CB membership. *We never compare ourselves to other protocols as a means of bettering our offering, and we believe that all other privacy tech is working toward the same mission.*
* **Contributions that target other protocols** - This is particularly egregious and would be grounds for losing CB membership. *We never compare ourselves to other protocols as a means of bettering our offering, and we believe that all similar tech is working toward the same mission.*

## Losing CB Membership[](https://namada.net/community/docs/community-builder-handbook#losing-cb-membership)

Expand Down
4 changes: 2 additions & 2 deletions packages/community/pages/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@

## What is the Namada Community?

The Namada community is composed of ecosystems, communities, researchers, builders, creators, advocates, users of privacy, and just people – who want to see a future in which decentralized systems can serve as real alternatives to existing financial systems. To achieve this, privacy is paramount.
The Namada community is composed of ecosystems, communities, researchers, builders, creators, advocates, users and everyday people – who want to see a future in which decentralized systems can serve as real alternatives to existing financial systems. To achieve this, protecting users’ personally identifiable information is paramount.

We are brought together by the [Namada Vision](https://forum.namada.net/t/the-namada-mission/275). Together we make privacy as a public good a reality by building open-source tools, operating protocols, teaching people about privacy, using privacy, and funding privacy.
We are brought together by the Namada Vision of restoring the freedom to reveal. Together we make data rights a reality by building open-source tools, operating protocols, teaching people about privacy, using privacy, and funding tools for shielding users’ sensitive data.

Do you want to join us?
5 changes: 2 additions & 3 deletions packages/community/pages/trusted-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

A key component of the Namada protocol is the MASP circuit, which enables the features of asset-agnostic shielded transfers and shielded set rewards. For the MASP to work, it needs two sets of parameters: the first set is phase I from Zcash’s Powers of Tau ceremony, conducted in 2018, and the second ones are the ones generated in Namada’s Trusted Setup ceremony, which was announced in November 2022 and coordinated by the Anoma Foundation with the help of devs at Heliax.

The ceremony encouraged everyone to participate, but specifically the ones who wanted to use privacy on Namada – because participants in the ceremony only need to trust themselves to have effectively destroyed the toxic waste. The ceremony started on the 19th of November 2022 and concluded on the 21st of December 2022 with no less than 2,510 participants – making it the largest trusted setup at the time (more details in the recap).
The ceremony encouraged everyone to participate, but specifically the ones who wanted to use shielded set on Namada – because participants in the ceremony only need to trust themselves to have effectively destroyed the toxic waste. The ceremony started on the 19th of November 2022 and concluded on the 21st of December 2022 with no less than 2,510 participants – making it the largest trusted setup at the time (more details in the recap).

The Namada Community grew in size and diversity, everyone who participated contributed to the security of the privacy features on Namada. Participants in the Trusted Setup were requested to generate a seed phrase – and the next step will be the instructions for claiming the rewards for participating in the ceremony.
The Namada Community grew in size and diversity, everyone who participated contributed to the security of the shielded features on Namada. Participants in the Trusted Setup were requested to generate a seed phrase – and the next step will be the instructions for claiming the rewards for participating in the ceremony.

**Resources:**

Expand All @@ -18,5 +18,4 @@ The Namada Community grew in size and diversity, everyone who participated contr
**Engage:**

- Join the community on Discord
- Join the weekly Private Library on [Discord](https://discord.gg/namada)
- Join the monthly community calls
2 changes: 1 addition & 1 deletion packages/community/pages/validators.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Validators

The development of Namada started in 2022, back then it went by the codename of “M1”. After months of development, throughout summer and fall we launched a series of [private testnets](https://github.com/anoma/namada-testnets/tree/main/namada-close-quarters-testnet-1) with the help of a handful of early validators who believed in the vision of bringing asset agnostic privacy. The community at this stage was composed by the core developers at Heliax and [the few validators](https://namada.net/blog/announcing-namada-public-testnets) (7 team members from Heliax and [11 validators](https://github.com/anoma/namada-testnets/tree/main/namada-close-quarters-testnet-5)) who joined and coordinated through the Validator Hangout on Element. The last private testnets ran until December 2022, the protocol version was `v0.11`.
The development of Namada started in 2022, back then it went by the codename of “M1”. After months of development, throughout summer and fall we launched a series of [private testnets](https://github.com/anoma/namada-testnets/tree/main/namada-close-quarters-testnet-1) with the help of a handful of early validators who believed in the vision of bringing asset agnostic shielding. The community at this stage was composed by the core developers at Heliax and [the few validators](https://namada.net/blog/announcing-namada-public-testnets) (7 team members from Heliax and [11 validators](https://github.com/anoma/namada-testnets/tree/main/namada-close-quarters-testnet-5)) who joined and coordinated through the Validator Hangout on Element. The last private testnets ran until December 2022, the protocol version was `v0.11`.

In December 2022, the first [public testnet](https://namada.net/blog/announcing-namada-public-testnets) was launched with a few more validators joining forces ([29 in total](https://github.com/anoma/namada-testnets/tree/main/namada-public-testnet-1), with a few team-run nodes). Ever since, the core developers have published numerous protocol releases from `v0.12.0`, until the latest `v0.23.1` and more than 13 testnets launches/upgrades. The number of validators grew a lot, a total of [253 validators](https://github.com/anoma/namada-testnets/tree/main/namada-public-testnet-13) submitted their genesis keys for testnet 13.

Expand Down
5 changes: 3 additions & 2 deletions packages/docs/pages/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,6 @@
"users": "User Guide",
"operators": "Operator Guide",
"integrating-with-namada" : "Integration Guide",
"networks": "Networks"
}
"networks": "Networks",
"utils": "Utils"
}
15 changes: 6 additions & 9 deletions packages/docs/pages/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,33 +4,30 @@ import { DocsAscii } from '../components/DocsAscii'

## About Namada

[Namada](https://namada.net/) is a privacy-for-assets centric blockchain using zero-knowledge proof technology.
Namada's cryptographical features give users asset-agnostic, interchain privacy, and is being built by the Anoma foundation.
[Namada](https://namada.net/) is a data-protection blockchain using zero-knowledge proof technology.
Namada's cryptographical features give users asset-agnostic, multichain data protection, and is being built by the Anoma foundation.

### Key innovations:

- Zcash-like transfers for any assets (fungible and non-fungible)
- Rewarded usage of privacy as a public good
- Interoperability with Ethereum via a custom bridge with trust-minimization
- Zcash-like shielded transfers for any assets (fungible and non-fungible)
- Rewards for keeping assets in the shielded set

## Overview of features

- [Proof-of-Stake](./operators/validators/proof-of-stake.mdx) with [governance](./users/governance.mdx) to secure and evolve Namada
- [Proof-of-Stake](./introduction/protocol-intro.mdx) with [governance](./users/governance.mdx) to secure and evolve Namada
- Fast-finality BFT with 4-second blocks
- Trust-minimized 2-way Ethereum bridge
- IBC connections to chains that already speak IBC (all Cosmos chains)
- [Multi-Asset Shielded Pool](./users/shielded-accounts/shielded-transfers.mdx) (MASP)
- Convert Circuit ([shielded set rewards](./users/shielded-accounts/shielded-rewards.mdx))
- [Ledger](./users/wallet/hardware-wallet.mdx) application

For high-level introductions, we recommend:

- Article: [Introducing Namada: Interchain Asset-agnostic Privacy](https://blog.namada.net/introducing-namada-interchain-asset-agnostic-privacy/)
- Article: [Introducing Namada: Multichain Asset-agnostic Data Protection](https://namada.net/blog/introducing-namada-multichain-asset-agnostic-data-protection)
- Article: [What is Namada?](https://blog.namada.net/what-is-namada/)
- [Talks & Podcasts](https://namada.net/talks)

To learn more about the protocol, we recommend the following in-depth resources:

- Talk at ZK8 [Namada: asset-agnostic interchain privacy](https://youtu.be/5K6YxmZPFkE)
- [Namada's specifications](https://specs.namada.net)
- [Codebase](https://github.com/anoma/namada)
5 changes: 4 additions & 1 deletion packages/docs/pages/integrating-with-namada/_meta.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
{
"sdk" : "Using the SDK"
"sdk" : "Using the SDK",
"light-sdk": "Using the Light SDK",
"indexer": "Using the Indexer",
"interface": "Namada Interface"
}
34 changes: 34 additions & 0 deletions packages/docs/pages/integrating-with-namada/interface.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Namada Interface

## Front end development with Namada
The [namada-interface repository](https://github.com/anoma/namada-interface) is a monorepo which contains the Namada browser extension
and associated Namada-Interface web app. It's a great resource for developers wishing to understand how to incorporate the Namada SDK
into their front-end applications.

### Installing from source (for development and experiment purposes)

#### Connect to a testnet or run a local node
1. Follow the instructions for the [testnets](../networks/testnets.mdx) to connect to a testnet or [set up a local node](../operators/networks/local-network.mdx).
2. Figure out where the base directory is stored and save its location as a variable such as `export BASE_DIR=<path/to/base/dir>`.
You can follow [these docs](../networks/testnets/migrating-testnets.mdx) to save this variable. Go ahead and save the chain id as a variable as well. You can find the chain id by running `cat $BASE_DIR/global-config.toml`. Save this chain-id to the variable `export CHAIN_ID=<CHAIN_ID>`.
3. You will need to edit the CometBFT config in order to allow the web wallet to connect to your node.
The CometBFT config will be located in `$BASE_DIR/$CHAIN_ID/cometbft/config/config.toml`. You will need to change the `cors_allowed_origins` field to `["*"]`. You can do this by running
```shell copy
sed -i 's/cors_allowed_origins = \[\]/cors_allowed_origins = ["*"]/' \
$BASE_DIR/$CHAIN_ID/cometbft/config/config.toml
```

#### Setting up the extension
1. Clone the [namada-interface repository](https://github.com/anoma/namada-interface).
2. Follow the installation instructions in `README.md`.
3. `cd` into the `namada-interface/apps/extension` directory and run `yarn start:chrome`. This will build the extension and place it in the `namada-interface/apps/extension/build` directory. It also starts the dev server which will watch for changes.
4. `cd` into the `namada-interface/apps/namada-interface` directory and run `yarn dev:local` in order to launch a local instance of the web wallet.
4. Add the extension to the browser. For example, in Chrome, you can go to `chrome://extensions/` and click `Load unpacked` and select the `namada-interface/apps/extension/build/chrome/` folder.

## Receiving tokens
You can show the address of any account by pressing the `Receive` button in the initial view under the "Total Balances" tab. You can copy the address by clicking the copy icon next to the address.
This will also display a QR code that can be scanned by a mobile wallet.

## Sending Transactions

In order to send transactions, you can press the `Send` button in the initial view under the "Total Balances" tab. This will open a modal that will allow you to send tokens to any account, from any account in your wallet that has a positive balance.
14 changes: 14 additions & 0 deletions packages/docs/pages/integrating-with-namada/light-sdk.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
import { Callout } from 'nextra-theme-docs';

# The Namada Light SDK

The namada light sdk was developed to provide a simple way to interact with the Namada API.
It provides pre-built functions that can be used in a more "out of the box" way than the SDK, but still requires some knowledge of the API.

This documentation aims to provide that knowledge.

## Sections

- [Setup](./light-sdk/setup.mdx)
- [Usage](./light-sdk/usage.mdx)
- [Examples](./light-sdk/examples.mdx)
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
{
"setup": "Setup",
"usage": "Usage",
"examples": "Examples"
}
Loading

0 comments on commit 8c84427

Please sign in to comment.