From bba3d57494182cdbb07a3d3bbc76836b9af9876f Mon Sep 17 00:00:00 2001
From: mbeylin <mark_beylin@hotmail.com>
Date: Mon, 9 Oct 2017 11:42:23 -0400
Subject: [PATCH] added data schema + mainnet address

---
 README.md | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5230816..e91dba6 100644
--- a/README.md
+++ b/README.md
@@ -63,7 +63,32 @@ A single bounty contract can be used to pay amounts of ETH or a given token, bas
 
 ## 3. Development
 
-All the extension bounty types **musn't** break the state transitions as described above.
+Any application can take advantage of the bounties network registry, which is currently deployed on the Main Ethereum Network at `0x8c9fe49Cd196BDafCD0B7C3078fa9823d247564a`. The `bountiesnetwork.eth` name will also always resolve to the most up-to-date registry version for the Bounties Network.
+
+#### Data Schema
+
+StandardBounties employs an off-chain storage data model, where the `data` field of each bounty and fulfillment, is a hash of a JSON object, which is stored in a distributed manner on IPFS.
+The schema for the bounty data field is:
+```
+{
+  title: // A string representing the title of the bounty
+  description: // A string representing the description of the bounty, including all requirements
+  sourceFileName: // A string representing the name of the file
+  sourceFileHash: // The IPFS hash of the file associated with the bounty
+  contact: // A string representing the preferred contact method of the issuer of the bounty
+  categories: // an array of strings, representing the categories of tasks which are being requested
+}
+```
+The data schema for the fulfillment data field is:
+```
+{
+  description: // A string representing the description of the fulfillment, and any necessary links to works
+  sourceFileName: // A string representing the name of the file being submitted
+  sourceFileHash: // A string representing the IPFS hash of the file being submitted
+}
+```
+
+If you're building on the StandardBounties and would like to add additional data fields, please submit a pull request on this repo.
 
 ## 4. Documentation