# Index Jump to specific questions in our Guidebook, or check out our glossary. ## [The Basics](#the-basics) [What is Neighbourhoods?](/the-basics#what-is-neighbourhoods) [How will I be able to use neighbourhoods?](#how-will-i-be-able-to-use-neighbourhoods) [Why do we need decentralized social coordination platforms?](/the-basics#why-do-we-need-decentralized-social-coordination-platforms) [What is the relationship between Neighbourhoods and Holochain?](/the-basics#docs-internal-guid-1006fb0f-7fff-9fc7-c1ab-27d945c50a87) ## [Our Terminology](#our-terminology) [A glossary of terms used in Neighbourhoods' architecture and tooling](/our-terminology) ## [Future Uses & Features](#future-uses-and-features) [Who is neighbourhoods for? ](/future-uses-and-features#docs-internal-guid-bb23e92b-7fff-a5a3-4cd8-35dfa0344706) [How will groups use Neighbourhoods' infrastructure?](/future-uses-and-features#how-will-groups-use-neighbourhoods-infrastructure) [What types of communities might become neighbourhoods?](/future-uses-and-features#what-types-of-communities-might-become-neighbourhoods) [Do you have a roadmap?](/future-uses-and-features#do-you-have-a-roadmap) ## [$NHT](#usdnht-and-nh-credits) [What is $NHT?](/usdnht#docs-internal-guid-c2aafaf5-7fff-cd20-31c9-ebca2c37503a) [What is the contract address for $NHT?](/usdnht#what-is-the-contract-address-for-usdnht) [What wallet should I use to purchase or hodl $NHT?](/usdnht#what-wallet-should-i-use-to-purchase-or-hodl-usdnht) [Can I buy $NHT on a centralized exchange?](/usdnht#can-i-buy-usdnht-on-a-centralized-exchange) [Can I move my $NHT between Polygon and Ethereum chains?](/usdnht#can-i-move-my-usdnht-between-the-ethereum-and-polygon-chains) [What is the maximum total supply of $NHT?](/usdnht#what-is-the-maximum-total-supply-of-usdnht) [What is the total circulating supply](/usdnht#what-will-the-circulating-supply-be-once-the-tokens-are-generated) [Why is so much $NHT in reserve?](/usdnht#why-is-so-much-usdnht-in-reserve) [Who has funded Neighbourhoods so far?](/usdnht#who-has-funded-neighbourhoods-so-far) [Will I have to use $NHT to use Neighbourhoods? ](/usdnht#will-i-have-to-use-usdnht-to-use-neighbourhoods) [Are there benefits of using $NHT](/usdnht#are-there-benefits-of-using-usdnht) ## [Useful Links](#useful-links) [Docs](/useful-links#docs) [Medium Articles](/useful-links#medium-articles) [For Developers](/useful-links#for-developers) [Socials](/useful-links#socials) # The Basics ## What is Neighbourhoods? Neighbourhoods is a project building web3 native tools and services that enable online communities to do more together. Neighbourhoods makes it easy to bundle together different social coordination (or "groupware") modules and to pair these with tags, reactions, ratings, and reputation systems chosen to fit your group’s culture and purpose. ## How will I be able to use neighbourhoods? Imagine taking your average Discord server to the next level: You can add apps into your social space and customize everything from algorithms, to reactions, to visual skins. Neighbourhoods takes a 'group first' approach. Our tools are meant to provide a complete, ultra-configurable community hub. Still, there's no need to compromise individual data autonomy! Your activity conforms to group rules, but personal records are also stored locally, allowing you to take your social data with you wherever you go. ## Why do we need decentralized social coordination platforms? The distributed web offers users greater autonomy and control over their data. Supporting multiple reputation systems helps prevent centralized control and mitigates the potential harm that reputation systems can inflict on individuals. With our Community Activation Wizard, groups have the power to shape their own algorithms and data sharing protocols. This means they can determine how information is processed and prioritize specific aspects. These versatile tools cater to different cultures, enabling seamless transitions from group chats to decentralized autonomous organizations (DAOs). By fostering collective experimentation and evolution, they serve as incubators for group growth and innovation. ## What is the relationship between Neighbourhoods and Holochain? The concept of Neighbourhoods emerged from a weekly discussion series involving Holochain and other members of the peer-to-peer ecosystem as a response to the extractive practices of social apps in Web2. Neighbourhoods required an ultra-scalable distributed ledger capable of preserving the dynamism of Web2. Holochain's uniform data formatting simplifies the translation of reputation metrics across social spaces and facilitates data portability. Additionally, Holochain's trust-but-verify model for data integrity, along with its agent/group duality, align perfectly with Neighbourhoods' social ontology and commitment to safeguarding and persisting data. From a technical standpoint, each neighbourhood is comprised of a set of miniature Holochain apps (or 'applets') that streamline compatibility with Neighbourhoods' Social Sensemaker API. ## I am a Developer. How do I get started? If you want to start developing your own Neighbourhoods Applets or experiment with our framework, the best place to start is our GitHub repositories: * [Neighbourhoods Launcher](https://github.com/neighbour-hoods/nh-launcher): the starting point for launching Neighbourhoods and for starting real communities or testing NH Applets; * [Scaffolding Applet Template](https://github.com/neighbour-hoods/nh-applet-template): a great starting point for creating a brand new Applet from scratch; * [Todo Applet](https://github.com/neighbour-hoods/todo-applet): the most complete and up-to-date NH Applet example, with commented code to get you started on more advanced projects; * Or just explore our [GitHub organization](https://github.com/neighbour-hoods) to find more cool stuff to get you inspired such as new Applets under development, design templates and styles and the inner workings of the Social Sensemaker. # Our Terminology This page is an ongoing work-in-progress. ### Access grant Permits the ability to perform a certain action related to certain objects or resources. ### Applet A Holochain hApp that is built using the Applet Module Interface provided by Neighbourhoods framework, that is also employing reusable UI [assessment widgets](#assessment-widget) following the standards provided by the framework. Applets are installed in the [Neighbourhoods Launcher](#launcher) so that they can be enabled and composed by [community activators](#community-activator) into [neighbourhoods](#neighbourhood). An example applet is available [here](https://github.com/neighbour-hoods/todo-applet). ### Assessment An assessment is a thoughtful evaluation of a [resource](#resource), along a specified [dimension](#dimension). Agents can assess [resource](#resource)s on any of its input dimensions, resulting in a input assessment. Assessment entries are stored as links or anchors from the resource's entry hash with the dimension as a tag. ### Assessment control The UI component used for making assessments. There is a set of assessment controls provided by Neighbourhoods, but any applet developer can also create their own, following the [Neighbourhoods framework](#neighbourhoods-framework). ### Assessment tray A collection of assessment controls displayed next to a resource. ### Assessment tray config Details which assessment controls are mapped to which dimension and in what order. ### Badge A badge is a distinction added to a member which modifies the value of their [reactions ](#reaction)towards computing a [score](#scoring). ### Community activator Community activators are the real creators of [Neighbourhoods](#neighbourhood). Whether a single leader or a DAO-like group acting in concert, community activators create sets of generic tools to pair with intentional design of reputation and culture. Community activators and whole Neighbourhoods benefit from data portability across the distributed web by deciding to bridge to other Neighbourhoods. In all likelihood, community activators seek technical tools to promote group coordination, resource sharing, and advancement of common interests in communities. ### Community Activation Wizard A tool available inside the Neighbourhoods [Launcher ](#launcher)to enable community activators to create and change [social configurations ](#social-configuration)for a neighbourhood. Access to the Wizard is determined by the [Community Activator](#community-activator) role. Other members have access to the [Sensemaker Dashboard](#sensemaker-dashboard), enabling them to inspect and interact with the social configuration for any neighbourhoods they are [members ](#member-membership)of. The current implementation of the Wizard consists in a link from the [Dashboard ](#dashboard)that enables changing the assessment widget for each dimension defined for each resource provided by the applet. In a future implementation, it will allow defining [dimensions ](#dimension)and [assessment widgets](#assessment-widget) and customising every aspect of the applet [social sense-making](#social-sense-making) interactions. ### Cultural Context *Outdated; see instead* [*list configuration*](#list-configuration)*.* A cultural context serves to group and display [resources ](#resource)of a certain type, while defining a set of [thresholds ](#threshold)for filtering and ordering them. ### Dashboard See [Sensemaker Dashboard](#sensemaker-dashboard). ### Data Set A data set is a list of [assessments](#assessment), as hashes. Methods are applied to data sets to return objective assessments, which means publishing a data set as a validation package, or for audit, can increase trust in a given neighbourhood. Data external to holochain can also be grouped into a data set for later processing within a [neighbourhood](#neighbourhood). ### Dimension A named range along which assessments can be placed. Used to organize assessments into meaningful slices. ### Groupware Any software groups use to connect with each other, share information, ideas, memories, and goods, and coordinate their actions. In any given [neighbourhood](#neighbourhood), groupware applets are lightweight Holochain hApps. ### Identity Currently an identity is equivalent to a Holochain agent identity. It is unique per device, but this must change in the near future. ### Input Dimension An input dimension is a judgeable quality or character of an entry*,* expressed as a value in a agent-defined range. It is judged by an agent. Examples include 5-star ratings, upvote/downvotes, and 60 mark scales. ### Launcher This is an entry point application for any neighbourhood, where users can: * Create and access their personal Profiles * Search and join existing neighbourhoods * Create new neighbourhoods and configure them * Add applets to a neighbourhood and configure them * Invite more members and interact with them using applets * Inspect the Sensemaker Dashboard, gaining cultural insights for the neighbourhood ### Layout A template to compose resources, their views, their assessment controls, and other attached objects. ### List view A template for defining how resource views are laid out. Requires a [list configuration](#list-configuration). ### List configuration Defines: * [Orderings](#ordering) * [Thresholds](#threshold) * [Resource filters](#resource-filter) * [Resource views](#resource-view) used for each resource displayed which are used in association with a [list view](#list-view). Previously, this was a [cultural context.](#cultural-context) ### Member/ membership 1. A *member* is someone who uses a specific [neighbourhood](#neighbourhood). 2. *Membership* is the trait of *being a member* in a neighbourhood, particularly one which has admissions criteria (such as requiring credentials). ### Method A method is an algorithm for computing an output assessment along a certain dimension for a [resource](#resource), using [assessments](#assessment) from other dimensions of the resource as inputs. ### Navigation Navigation allows moving between pages in a culturally / community / goal / workflow sensitive way. By default, this is a list of pages created in a space. ### Neighbourhood A neighbourhood is a social context that consists of a network of agents who use Sensemaker and one or more Sensemaker-compatible [applets ](#applet)with each other. ### Neighbourhoods Framework The framework is an architecture made available via the [Neighbourhoods Launcher](#launcher) for Applet developers, that defines how [Applets ](#applet)should be build and what extra features are available to them. It currently includes: * **Applet Module Interface**: and interface that must be implemented by all Applets explaining how to render their resources, contexts and assessments * **Assessment controls**: an applet may or may not define brand new [assessment controls](#assessment-control) that can be packaged with their applet * **Configuration file**: A standard file format for describing the [Social Configuration](#social-configuration) for that applet * **Resource views**: A standard way to specify generic [resource views](#resource-view) for each of the applet defined [resources](#resource). ### Output Dimension An output dimension is a measurable quality or character of an entry*,* measured by an agent-defined [Method](#method). Examples include upvote ratios, mean ratings, and numbers of likes. ### Ordering When defining a list configuration, one can specify the order in which resources will be displayed. ### Page A way of interacting with resources in a space. ### Reaction A reaction is a colloquial way of talking about an [assessment ](#assessment)on a [subjective dimension.](#subjective-dimension) ### Resource A resource is a data/media item (entry) which users can make sense upon. ### Resource filter When defining a list configuration, one can specify which resource schemas can be seen in the list. ### Resource view OLD: This UI element specifies a generic way for how a specific [resource ](#resource)is rendered inside the [applet ](#applet)and within the [Sensemaker Dashboard](#sensemaker-dashboard). An applet must define at least one resource view. NEW: Views can be bundled with a schema, in order to bootstrap the use the object. In a sense they are like miniature tools for creating and displaying objects that conform to a particular schema. ### Role A role defines a *type of* [*member*](#member-membership), determining their access to [cultural contexts](#cultural-context) within a [neighbourhood](#neighbourhood), and their rights within those contexts. ### Schema A definition of the potential shape and kinds of values a resource can have. This will be specified in JSON-LD or RDF. ### Scoring Scoring is either of the following:\ 1\. The order in which [resources ](#resource)are shown in a[ cultural context](#cultural-context).\ 2\. The algorithm that determines how visible something is. ### Sensemaker The main engine for calculating social computations in neighbourhoods, taking as *inputs* the social configuration created by the community activator and the many assessments produced by community members, and as *outputs*, scoring resources according to the defined cultural contexts. The sensemaker is an internal holochain hApp that is part of the Neighbourhoods framework and made available for applet developers via interaction with the Launcher. ### Sensemaker Dashboard The Dashboard resides in the Launcher and is available to any neighbourhoods member to allow inspection and interaction with the [social configuration](#social-configuration), by viewing [assessments ](#assessment)made by other members on any [resources ](#resource)mapped by the configuration, switching from existing [cultural contexts](#cultural-context), and also running existing [methods ](#method)manually (if they have permission to do so). Each resource is displayed on the Dashboard according to the generic [resource view](#resource-view) defined by the applet. ### Social Configuration Configuration is an essential part of any Neighbourhoods applet. It is a file that defines the modes of social sense-making vis-a-vis the [resources](#resource), [dimensions](#dimension) and [cultural contexts](#cultural-context) applicable to the functionality of an applet. These can either be created (1) directly on the applet code or (2 - future) using the [Community Activation Wizard](#community-activation-wizard) provided by the Neighbourhoods [Launcher](#launcher). ### Social sense-making Social sense-making is social in two ways. First, it is *about* the social world. It is a process of orienting to people, spaces, scenarios, and representations. For this orientation to occur, the latter need to be defined in some way.\ \ Second, it is a social process, which is to say, articulable and/or visible *between* members of a social group.\ \ Individuals use their goals, aims, and desires, conscious or not, to make sense of the social world on their own. For social sense-making to be a group rather than an individual activity, the group must an have apparent, articulable set of common interests, goals, or values.\ \ Therefore, when groups pursue sense-making as a common activity, these interests, goals, and values are cultivated, becoming more refined and more actionable in the process. ### Space Spaces organize resources and people around a purpose, enabling them to work with resources more fluidly. Spaces also mediate access to resources and people within the space. ### Threshold A threshold is a value criterion in a given [output dimension](#output-dimension) or [input dimension](#input-dimension), to enable resource filtering in a [list view](#list-view). # Future Uses & Features ## Who is Neighbourhoods for? Anyone who seeks decentralized social coordination tools to use with their community! If you are looking to move your group, community, or cause from web 2.0 organizing tools to p2p alternatives, Neighbourhoods may be for you. Currently, Neighbourhoods will be of interest to developers and organizers who are keen to experiment with early-stage software and become pilot groups receiving high-touch engagement from the Neighbourhoods team. ## How will groups use Neighbourhoods' infrastructure? Groups can *create*, *customize*, and *manage* their neighbourhood:

Create a group and invite peers

Select mini apps to add to your neighbourhood

Manage your apps and configure settings

## What types of communities might become neighbourhoods? The NH framework enables a very wide range of use cases, depending on the hApp modules that developers contribute to the NH marketplace. Holochain "groupware" apps, like wikis, collaborative documents, and video chat already exist. So, it would be easier in the near-term to use the NH framework to spin up a "working group" for any shared cause. Prospective community activators have opened public conversations on using neighbourhoods for cases and group sizes when reputation accrual and accounting is critical, for example: developer communities, philanthropic communities, energy and carbon accounting projects, and gaming groups. The team also created a demo "meme sharing" neighbourhood to show how the framework applies to (social) media use cases, ## Do you have a roadmap? Yes, please see our full, 2023 roadmap [here](https://roadmap.neighbourhoods.network/). # $NHT ## What is $NHT? $NHT is an ERC-20 token that will serve as a pathway between the Neighbourhoods network and crypto market liquidity. $NHT is used to access tools created by the Neighbourhoods team and by developers participating in the NH low-code marketplace. These tools help you spin up your own neighbourhoods! Read about them [here](https://neighbourhoods.network/how-it-works/). ### What is the contract address for $NHT? Ethereum Network: 0x84342e932797FC62814189f01F0Fb05F52519708 Polygon network: 0x84342e932797FC62814189f01F0Fb05F52519708 ### What wallet should I use to purchase or hodl $NHT? We recommend MetaMask. Once you add the MetaMask wallet as a browser extension, you can purchase $NHT there. Please see our detailed instructions for buying $NHT in MetaMask, and on decentralized exchanges (DEXs), [here](https://neighbourhoods.network/how-to-dex/). ### Can I buy $NHT on a centralized exchange? Yes! $NHT is now trading on [MEXC Global](https://t.co/ioNsA4rNhP). ### Can I move my $NHT between the Ethereum and Polygon chains? Yes, we have enabled the bridge between Ethereum and Polygon. We will continue to facilitate bridges as we deploy $NHT on others chains, too. Be aware that using the bridge will incur gas fees. ### What is the maximum total supply of $NHT? 30B $NHT. ### What is the total circulating supply? 33% i.e. 10B tokens will freely circulate. The balance 20B will be held as reserves.
### Why is so much $NHT in reserve? Our intention is to use the reserve judiciously, and only as the community, and end-user needs grow. If Neighbourhoods takes off, and if we need to expand the team rapidly to support development, we may need to liquidate reserves. This will only occure in keeping with the growth in number of people wanting to support Neighbourhoods. ### Who has funded Neighbourhoods so far? Toward the end of 2021, we held a small and successful Community Offering for our existing supporters. We ran this sale prior to listing on a few DEXs. These supporters joined even earlier-stage backers of Sacred Capital, the company from which Neighbourhoods grew. You can read more about our longstanding community strategy and offering [here](https://medium.com/sacred-capital/neighbourhoods-token-sale-3a5943ffbdd5). ### Will I have to use $NHT to use Neighbourhoods? Nope. It is not mandatory to pay for applet use in $NHT. $NHT is one of many settlement currencies available to communities. But, to *request* and *create* features in the Neighbourhoods Bazaar, you will need to use $NHT. ### Are there benefits of using $NHT Yes! $NHT enables communities and organizers to articulate their needs directly to developers. $NHT can also be used to crowdfund apps and therefore to share costs with other neighbourhoods. Using $NHT also removes all transaction fees assessed by the Neighbourhoods organization. What's more, holding and staking $NHT confers governance benefits over the $NHT treasury. # Useful Links ## Docs [Social Data Primitives for Neighbourhoods](https://neighbourhoods.network/Distributed_Social_Sensemaking.pdf) [Neighbourhoods Whitepaper](https://whitepaper.neighbourhoods.network/) ## Medium Articles [Activating Mission-Driven Communities with Web 3.0](https://medium.com/p/223a5bb212ec) [Introduction to Neighbourhoods](https://blog.neighbourhoods.network/introducing-neighbourhoods-a7c577eae4c6?source=collection_home---4------2-----------------------) [Neighbourhoods' MVP](https://blog.neighbourhoods.network/neighbourhoods-mvp-cfab6f8ad1ab?source=collection_home---4------0-----------------------) [Neighbourhoods’ Token Sale](https://medium.com/sacred-capital/neighbourhoods-token-sale-3a5943ffbdd5) [The Reputation Economy (2019)](https://blog.neighbourhoods.network/how-does-the-reputation-economy-work-60bf8c43a84b?source=collection_home---4------3-----------------------) ## For Developers [Github](https://github.com/neighbour-hoods) [Developer Preview Release](/useful-links) ## Socials [YouTube](https://www.youtube.com/channel/UCM7Oc8aY4FZ6S7U9onj14cQ) [Substack](https://neighbourhoods.substack.com/) [Twitter](https://twitter.com/neighbour_hoods) [Discord](https://discord.gg/nKSGNaJz9D) [Telegram](https://t.me/Neighbourhoods) [Facebook](https://www.facebook.com/neighbourhoods.network/) [LinkedIn](https://www.linkedin.com/company/sacred-capital)