Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/joecars/nerman.js
Nouns SDK to access DAO events, contracts, and other related Nounish projects.
https://github.com/joecars/nerman.js
crypto dao ethereum governance js nft ts
Last synced: about 1 month ago
JSON representation
Nouns SDK to access DAO events, contracts, and other related Nounish projects.
- Host: GitHub
- URL: https://github.com/joecars/nerman.js
- Owner: JoeCars
- License: mit
- Created: 2022-09-06T23:39:10.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-12T20:47:03.000Z (7 months ago)
- Last Synced: 2024-04-13T02:34:51.749Z (7 months ago)
- Topics: crypto, dao, ethereum, governance, js, nft, ts
- Language: TypeScript
- Homepage: https://nerman.biz
- Size: 12.9 MB
- Stars: 10
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nerman.js
[![NPM Version](https://img.shields.io/npm/v/nerman.svg?style=flat)]()
Nerman.js is a JavaScript/TypeScript wrapper for Nouns projects like the Nouns DAO, LilNouns DAO, Propdates, and more. Our goal is to create an intuitive toolkit to interact with these contracts, lowering the barrier of entry to this community, and enabling developer creativity.
If there's a Nouns project you think should be a part of Nerman.js, feel free to open an issue so we can add support.
## Installation
Ensure you have `npm` installed and are in a node project.
```
npm install --save nerman
```## Examples
To use Nerman.js, you will need a `JSON_RPC_URL` from a blockchain development platform like [Alchemy](https://www.alchemy.com/).
To listen to an on-chain vote event for Nouns DAO, write the following:
```ts
import * as nerman from "nerman";const nouns = new nerman.Nouns("");
nouns.on("VoteCast", (vote: nerman.EventData.VoteCast) => {
console.log(
"NounsDAO | VoteCast | id:" +
vote.proposalId +
", voter: " +
vote.voter.id +
", votes: " +
vote.votes +
" , supportDetailed: " +
vote.supportDetailed +
", reason: " +
vote.reason
);
});
```For more details on events, see: [Event Types](./docs/types.md).
For more details on contract wrappers, see: [Contracts](./docs//contracts.md).
## License
Nerman.js is distributed under an [MIT](./LICENSE) license.
## Contribution
Nerman.js is currently not open to contribution.
If you have any suggestions or experience any bugs, please feel free to open a Github issue. We are always eager to better support the Nouns community.