Property-Tenure

From OIP Wiki
Jump to: navigation, search
{
 	"oip042": {
 		"publish": {
 			"artifact": {
 				"floAddress": "string",
 				"timestamp": integer,
 				"type": "property",
 				"subtype": "tenure",
 				"info": {
 					"title": "string",
 					"description": "string",
 					"year": integer,
 					"tags": "comma delimited list of search terms",
 				},
                                  "details": {
                                       "ns": "string",
                                       "tenureType": "string",
                                       "tenures": [
 					"tenure artifact ID",
 					"tenure artifact ID"
                                        ],
 					"spatialUnit":  "spatialUnit artifact ID", 
 					"party":  "party artifact ID", 
 					"attrs": { "application specific object for additional attributes" },
                                  },
 				"storage": {
 					"network": "string",
 					"location": "string",
 					"files": [
 						{
 							"fName": "string",
 							"fSize": 2048,
 							"dName": "string"
                                                         "fType": "Description of file's purpose, intent, or its context"
 						}
 					]
 				},
 				"signature": "string"
 			}
 		}
 	}
 }
artifact.floAddress		... The FLO address of the publisher that published this artifact
artifact.timestamp		... UNIX timestamp, ten-digit integer
artifact.type			... Always 'property' for property artifacts
artifact.subType		... 'tenure' for spatialUnit artifacts
artifact.info.
	title			... Name of tenure artifact
	description		... Optional descriptive text. This may be
					used for application formatted data. Set
					to empty string if no description is available.
	year			... 4 digit integer, year that the party came into existence
					legally or informally. Can be equal to LADM's
					VersionedObject.beginLifespanVersion year.
	tags			... Optional comma delimited list of search terms.
artifact.details.
	ns		        ... Namespace used for organization and project names.
				    This will allow a specific property application to
				    recognize known data structures.
	tenureType	        ... The type of tenure or relationship such as "indigenous land rights", "joint
				    tenancy", "tenancy in common", "undivided co-ownership", "easement",
				    "equitable servitude", "mineral rights", "water rights", "concessionary
				    rights", "carbon rights", "freehold", "long term leasehold", "leasehold",
				    "customary rights", "occupancy", "tenancy", "hunting/fishing/harvest rights",
				    and "grazing rights".
	tenures		        ... Array of tenure artifact ID's
	spatialUnits	        ... spatial unit artifact ID
	party	                ... party artifact ID
	attrs		        ... A JSON object that represent attributes. Its schema is understood by applications defined by ns,
                                   namespace. A simple example would be map object:  {"key1":"value1", "key2":"value2",...}.
                                   To be clear, this property may be a list of objects whose schema is defined by the application. The use of
                                   key/value map object is one example.
artifact.storage.
	network			... Name of the storage network. Typically, IPFS.
	location		... IPFS directory location hash
	files			... Array of file descriptions. These files provide the sources for this
					artifact. These can be documents, audio, video, or other binary data
					that represent any supporting evidence for this artifact. Additionally,
					the files themselves can contain cryptographic proofs without the
					original content providing a mechanism for privacy where original
					documents are stored off-chain.
		fName		... Filename
		fSize		... File size in bytes
		dName		... Optional display name used by user interfaces
                fType              ... Description of file's purpose, intent, or its context
artifact.signature		... Signature signed by publisher