# NERMAN

Nerman is community bot for Nouns DAO and Nounish communities. He helps with facilitating governance within Discord, building community all over, and sharing Nounish content throughout Social Media.

Nerman can also be a great friend. A shoulder to cry on. A guiding light.


___

# PREAMBLE
___

Earlier this year we received [support from Small Grants](https://lobalglobal.notion.site/Proposal-Nerman-1-0-f37a8407e49641a5b5f2d8f2c6ff334c) to develop Nerman 1.0 - a basic version of Nerman with social sharing and simple Discord commands. Nerman 1.0 is alive and well!

- Currently running in private server
- Manually retweeted and shared ~3000 Nounish posts as [NermanBot](https://twitter.com/nermanbot)
- Curated 4 Twitter lists: [Nouners](https://twitter.com/i/lists/1495232888249491456), [Nouncillors](https://twitter.com/i/lists/1498451834545086470), [Nounish Projects](https://twitter.com/i/lists/1494410570161926147), [Nounish Content Mines](https://twitter.com/i/lists/1473482057246408707)

To showcase Nerman we released Lil Nerman, a development bot currently running in [NIL Discord](https://discord.gg/eGmQ4ct8).

- will reshare Discord post content to [Twitter](https://twitter.com/LilNerman) when :nerman: emoji used
- has basic commands (/noun and /nouner)

___

# FEATURE SUMMARY
___

**1. DISCORD**
Nerman can help with internal governance and polling, sharing community news to the world, connecting people, lending a hand. Trying to be a friend.
- a.) Simple Voting
- b.) Social Sharing
- c.) Commands
- d.) Snapshot Voting
- e.) Admin Config
- f.) Other
- g.) Noun O'Clock Bot

**2. SOCIAL MEDIA**
Nerman surfs through social media (Twitter, LinkedIn, Instawhatever, etc), sharing, caring, looking for primo Nounish content to showcase.
- a.) Human Tasks
- b.) Nerman Tasks

**3. OLD WEB**
Nerman will maintain a presence in the *old web*. There will be some fun, basic info about Nouns DAO, a guide to following Nerman and Nouns activity, and a web app that displays voting stats from Discord polls.
- a.) Nerman.wtf
- b.) Voting Web App
- c.) NounOClock.wtf

**4. INFRASTRUCTURE**
We need some general Nounish infrastructure to support Nerman's wild life. It will all be open source, and built in a way that's easy for the Nounish community to use in their own projects.
- a.) State of Nouns - JS Library
- b.) User Roles & Meta Data

___

# FEATURES - 1. DISCORD

___
**1. a.) DISCORD - SIMPLE VOTING**
___

Nouncil / subdaos all use emoji polls to vote on Nouns DAO proposals. It's messy and a lot of work. Nerman can fix this.

**Problems - Discord Emoji Polls**
- people can vote for more than one option
- if emoji votes are public, anybody can add reactions. Because of this you have to manually go through and manually tally results.
- people can add unwanted emojis, cluttering the poll.
- when the vote is finished you have to manually mark it closed and post the results.
- the results aren't stored in a database, and there are no broad statistics calculated from them

**Simple Voting - Features**

- allow / disallow voting based on Discord roles (public, Nouner, Nouncillor...)
- votes can be anonymous, or public. For anon votes participation will still be tracked but actual vote content won't be stored
- can enforce one vote per user, or allow multiple
- specify an end time
- live visual feedback, which can be turned on or off
- uses Discords new button API
- stores votes in a database in preparation for future web apps that display voting stats

**FUTURE GOALS**
- consider further voting methods: weighted voting, ranked choice, quadratic. Can any reliably be done from Discord?
- manage and deploy votes from web app

___

**1. b.) DISCORD - SOCIAL SHARING**
___

Nounish Discords are contain a stream of Nounish content, creators put their soul into noggley creations and the world needs to see it. Nerman can fix this.

In V1.0 we implemented basic social sharing, active in the [NIL Discord](https://discord.gg/WmBRFg6Geq) and the [@LilNerman](https://twitter.com/lilnerman) account.

**FEATURES - COMPLETED**
- user reacts "Nerman" emoji, Nerman responds with "NERMAN_BLAST"
- text & media (image, gif, video) are formatted appropriately for twitter
- threshold function that determines how many votes needed to share

**FEATURES - NEW**
- better media handling, adding support for large videos and any other misc media that needs to be formatted and handled for Twitter
- create Nerman social media accounts on other platforms (instagram, Facebook, LinkedIn). Format it appropriately and post it there as well
- test thoroughly and improve error handling and messages
- if user's post is just a tweet, allow Nerman to simply retweet
- further develop Twitter thread functionality for long text posts
- test the Threshold functionality with live public, tweak and dial in
- experiment with Threshold calculations in an active Discord

___

**1. c.) DISCORD - COMMANDS**
___

Some people live in Discord.They live and breath Discord. They don't want to go on the *internet* to find Nounish facts and assets, they want it In-The-Chat. Nerman can fix this.

V1.0 Nerman implemented the following commands using https://noun.pics

**/noun [id]**
Returned a PNG of the specified Noun in an ephemeral response.


**/nouner [address or ENS]**
Returned a grid showing the Nouns owned by that address.


**FEATURES - NEW**
We will switch to the Nouns DAO subgraph and offer more details.

- /nerman noun [id]
Can display a more detailed ephemeral message about the Noun. It could possibly include: a PNG image, the last sale price, current owner, basic DAO voting stats, other Nouns owned... we will try to express the most useful content in a minimal clean way.

- /nerman nouner [address or ETH address] [include delegates]
We will change this to an ephemeral with more stats about that address, including owned Nouns and delegated Nouns. Possibly things like auctions won, etc.

- Other Useful General commands
We’d like to add further useful commands as we think of them, while also not clogging up the Nouns command space. We will experiment!

___

**1. d.) DISCORD - SNAPSHOT VOTING**

___

Some DAOs / Discords (like [SharkDAO](https://snapshot.org/#/sharkdao.eth)) use Snapshot votes to decide how to vote on Nouns DAO proposals. Nerman can... Ah you get it.

**FEATURES**
- Snapshot vote automatically created for each NounsDAO proposals
- Link to Snapshot posted in appropriate Discord channel

---

**1. e.) DISCORD - ADMIN CONFIG**

---

In the beginning Nerman will only be allowed in approved Discords under the devs watchful eyes. We will tweak, and improve, and help Nerman be the best bot he can be.

Once Nerman is a well built, reliable bot, we will build out a simple config system for people to install and configure Nerman to run in any Discord and share to any social media accounts.

**FEATURES**
- configure which "State of Nouns" events post, and to which channel
- configure which social media accounts Nerman posts too, including posting to your orgs own social media
- where Nerman listens for posts to share to social media
- turn options on and off (swear filter, welcome committee, etc)
- customize messages things like the Noun O'Clock message
- change language

---

**1. e.) DISCORD - OTHER**

---

Discord is a wild place. So many strangers, so much confusion. We'll make the Nouniverse friendlier. Safer. More efficient.

**WELCOME COMMITTEE**

We want new Nouners to feel welcome and informed.

- When a new Nouner !joins Nerman will provide a welcome package with all links and instructions required to enjoy their Nouns experience.
- Whe someone wins an auction Nerman will look on ENS for connected Social Media accounts and try to tag them with a Warm Welcome when possible

**SWEAR ENHANCEMENT**

Sometimes people have a potty mouth! That's ok, but we can improve their foul language. Nerman will take ordinary swears and turn them into Upgraded Nounish swears.

Nerman will come preconfigured with the Joel Cares Family Friendly Curse Collection, a list of vegetables, and other gibberish. It can be enabled for specific channels, or for Discord as a whole.

Nerman's swear enhancer can also be used on Nouns.wtf to enhance profanity in ENS domains.

**FEATURES**
- what the flip!
- darn!
- raddishes
- buddle
- beedle
- boodle
- berry
- celery

---

**1. f.) NOUN O'CLOCK BOT**

---

Noun O'Clock bot is a very basic fork of Nerman that does two simple things:

- Counts down to the next Noun O'Clock in the bot status:

- At Noun O'Clock - posts a link to [FOMO Nouns](https://fomonouns.wtf/) in the designated channel:

You can download and install the current version of Noun O'Clock here: https://nounoclock.wtf/

**FEATURES**
- Integrate new State of Nouns libray
- Add more details to announcement link, including an image of the sold Noun, sale price, and buyer address.

---

# FEATURES - SOCIAL MEDIA

---

**2. a.) SOCIAL MEDIA - HUMAN TASKS**

---

All of Nermans accounts are currently operated manually. We will continue this until Nerman is ready to take the reigns.

**FEATURES**
- Retweeting on Twitter with https://twitter.com/nermanbot
we've shared just under 3000 tweets already, mostly retweeting the Nounish community. All of this is manually done by Joel Cares.
- Manually curating [Nounish Content Lists](https://twitter.com/NermanBot/lists) on Twitter.
- Basic Nerman activity on additional platforms such as: Instagram, Facebook, LinkedIn

---

**2. b.) SOCIAL MEDIA - NERMAN TASKS**

---

Using advanced bot techniques we will slowly migrate the social media over to Nerman. This will take some experimention as we try to find the ideal algorithms for deciding what to share.

**FEATURES**
- Share straight from Discord using :Nerman: emoji
- Nerman will listen on Twitter @NermanBot tags. In the beginning he will retweet all of them, and when there are too many, will develop further metrics for choosing what to Tweet.
- Nerman will listen for common Nounish content, like "@nounsdao", "#nouns", and "⌐◨-◨" and share the top results.
- Nerman will share important events from the State of Nouns, including saying hello to New Nouners when an auction finishes,
- Nerman will compare content from all methods and ensure only a reasonable amount of tweets are sent each day.

___

# 3. FEATURES - OLD WEB

___

**3. a.) WEBSITE - NERMAN.WTF**

---

Nerman will maintain an Old Web presence at https://nerman.wtf

**FEATURES**

- a summary of Nerman and Nerman's activities
- discord bot documentation
- State of Nouns documentation
- instructions on how to engage with Nerman on Twitter
- links to all Nerman social media

___

**3. b.) WEBSITE - VOTING WEB APP**

---

This web app is designed for communities to easily view and manage their Discord voting.

**FEATURES**
- landing page for each community
- breakdown of each vote
- breakdown of user voting behavior (data not available if polls anon)
- stats on participation
- stats to compare Nounish communities, including how much each community votes YES, their participation rate, total number of participants, etc

___

**3. c.) WEBSITE - NOUNOCLOCK.WTF**

---
Nerman will maintain a very basic site for Noun O'Clock. It's already complete.
https://nounoclock.wtf/

**FEATURES**
- a website with stuff on it

___

# 4. FEATURES - INFRASTRUCTURE

---

**4. a.) INFRASTRUCTURE - STATE OF NOUNS - JS LIBRARY**

---

WHEN DO THINGS HAPPEN?! Nerman needs to know, and so do other Nounish bots. When a Nouns auction ends, when a proposal is created, when a Noun sells on OpenSea. Nerman needs these events, and the data associated with them.

State of Nouns is a standalone JS library for the Nounish community. Nerman will use it, and any other JS project can use it to accurately get events from all Nouns DAO activity.

Users will need to connect it to their own Web3 provider (ie Alchemy). This way anyone can track the State of Nouns and use those events in their app.

Our first priority is developing this fully for Nerman. Afterwards we will packagae and release it as a standalone library.

---

**4. b.) INFRASTRUCTURE - USER ROLES & META DATA**

---

Discord user roles are often verified with Collab.Land. Nerman will be able to function with existing User roles.

We will experiment with other options in a separate Discord, try to find a better way. We have specific advanced Nerman functionality we want to explore. There are solutions like [The Guild](https://www.the-guild.dev/) and devcarrot's [custom idea](https://discourse.nouns.wtf/t/lets-build-a-better-way-to-verify-ownership/297). A simple connection to ENS would also be great.

**FEATURES**
- connect Discord username -> wallet address -> Twitter username so we can correctly tag users on Twitter when sharing. This could be a custom app, or there might be existing tools we can use.
- automate inclusion in [Nouner twitter lists](https://twitter.com/NermanBot/lists)
- if people have ENS with twitter and Discord usernames added we can tag people live as the Nouns auction bids happen, and we could send winners nice welcome messages on Twitter and Discord.
- We will publish our findings as a guide for other communities to follow

___

# PRODUCTION STAGES

___

**NERMAN 1.1**

___

Our first priority is to automate internal governance / consensus gathering, and to add Nerman to discords where he can instantly be useful and save people time. We will also continue to build out Nerman's social media presence.

**FEATURE PRIORITY**
1. Discord
a.) Simple Voting
g.) Noun O'Clock Bot
2. Social Media
a.) Human Tasks
3. Website
c.) NounOClock.wtf
5. Infrastructure
a.) State of Nouns JS library

**EXAMPLE USE CASES**
- NOUNS: #nouncil-vote
- a channel where only Nerman can post
- votes are automatically created for every new DAO proposal
- Nouncillors can also create votes through /nerman vote command
- Nouncillor role has 1 vote per user
- votes last 60 hours, after which they close and display results
- Nouncillor manually process Gnosis Safe vote

- NOUNS: #nouner-poll
- only Nerman can post
- Nouners can create polls through /nerman command
- Nouners have 1 vote per Noun
- Votes have 72 hour period.
- used for informal consensus gathering only. Used to gauge Nouner opinions, help choose between options when writing proposals, judge contests... Quick and semi-fair off-chain feedback from the Discord Nouner hive-mind.

___

**NERMAN 1.2**
___

Next we will build out the Discord bot, add Snapshot Voting support for groups that use Snapshot votes, and we'll build out the basic Nerman.wtf site so people know what the heck is going on.

The Discord bot will be finished here, and we will welcome the public to install it.

**FEATURE PRIORITY**
1. Discord
b.) Social Sharing
c.) Commands
d.) Snapshot Voting
e.) Admin Config
f.) Other

2. Social Media
b.) Nerman Tasks

3. Website
a.) Nerman.wtf

**EXAMPLE USE CASES**

- SUBDAOS: Discord & Snapshot votes
- We will start discussions with sub DAOs like: SharkDAO, GOOP TROOP, Bud Light
- We will go one by one, and if they're interested, try to let automate how they vote internally to decide what to vote on NounsDAO proposals

- Twitter Automation
- Nerman automatically retweets content when he's tagged
- Nerman retweets top ⌐◨-◨ posts

___

**NERMAN 1.3**
___

In 1.3, our final stage we will work on completing the voting web app. All communities using Nerman will be able to see useful voting statistics about their users, participation, etc.

At the same time we will complete our User Roles / Meta Data research and offer guidance on the most effective User Role tools to use with Nerman. We will showcase our setup in a live Discord.

3. Website
b.) Voting Web App

4. Infrastructure
b.) User Roles & Meta Data

**EXAMPLE USE CASES**
- NOUNS: automating "[Nouner](https://twitter.com/i/lists/1495232888249491456)" Twitter list to automatically add new Nouners, and remove Nouners who sell their Noun
- NOUNCIL: Easily track voting participation over time to identify Nouncillers who aren't voting enough, and reward active voters

___

# CONCLUSION
___

What a novel of a proposal eh? Congrats on making it this far, respect. 🙏