Difference between revisions of "Blockchain Messages Format and Schemae"

From OIP Wiki
Jump to: navigation, search
(Autominer Block Reward)
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
+
__FORCETOC__
 
{| class="wikitable"
 
{| class="wikitable"
 
!
 
!
Line 6: Line 6:
 
!Transfer Control
 
!Transfer Control
 
!Deactivate
 
!Deactivate
 +
!Historian
 
|-
 
|-
 
!Publishers
 
!Publishers
 
|[[#Publisher Register|Publisher Register]]
 
|[[#Publisher Register|Publisher Register]]
 
|[[#Edit Publisher|Publisher Edit]]
 
|[[#Edit Publisher|Publisher Edit]]
 +
|
 
|
 
|
 
|
 
|
Line 18: Line 20:
 
|[[#Artifact Transfer|Artifact Transfer]]
 
|[[#Artifact Transfer|Artifact Transfer]]
 
|[[#Artifact Deactivate|Artifact Deactivate]]
 
|[[#Artifact Deactivate|Artifact Deactivate]]
 +
|
 
|-
 
|-
 
!Retailers
 
!Retailers
 
|[[#Retailer Register|Retailer Register]]
 
|[[#Retailer Register|Retailer Register]]
 
|[[#Retailer Edit|Retailer Edit]]
 
|[[#Retailer Edit|Retailer Edit]]
 +
|
 
|
 
|
 
|
 
|
Line 29: Line 33:
 
|[[#Promoter Edit|Promoter Edit]]
 
|[[#Promoter Edit|Promoter Edit]]
 
|
 
|
|
 
|-
 
!Autominers
 
|[[#Autominer Register|Autominer Register]]
 
|[[#Autominer Edit|Autominer Edit]]
 
 
|
 
|
 
|
 
|
Line 42: Line 41:
 
|
 
|
 
|
 
|
 +
|[[Blockchain Messages Format and Schemae#Autominer Pool Historian Datapoint|Datapoint]]
 +
|-
 +
!Autominers
 +
|[[#Autominer Register|Autominer Register]]
 +
|[[#Autominer Edit|Autominer Edit]]
 +
|
 +
|
 +
|[[#Autominer Block Reward|Block Reward]]
 
|}
 
|}
  
Line 48: Line 55:
  
 
You can find information on how Multipart messages are formed [[Multipart Message Format|here]].
 
You can find information on how Multipart messages are formed [[Multipart Message Format|here]].
 +
 +
[[message protocol]]
  
 
== Publisher Register ==
 
== Publisher Register ==
Line 53: Line 62:
 
To view the JSON schema for '''''Publisher Register''''', click Expand ->  
 
To view the JSON schema for '''''Publisher Register''''', click Expand ->  
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
{
+
  {
    "oip-041": {
+
  "[[Variable Definitions#oip.23.23.23|oip042]]": {
        "pub": {
+
  "[[Variable_Definitions#register|register]]": {
            "alias": "$PublisherAlias",
+
  "[[Variable_Definitions#pub|pub]]": {
            "address": "$PublisherAddress",
+
  "[[Variable_Definitions#alias|alias]]": "string",
            "timestamp": $UnixTime,
+
  "[[Variable_Definitions#address|address]]": "string",
            "info": {
+
  "[[Variable_Definitions#timestamp|timestamp]]": integer,
                "emailmd5": "$md5HashOfEmail",
+
  "[[Variable_Definitions#authorized|authorized]]": ["string", "string"],
                "avatarNetwork": "$IPFSorBittorrentorHTTP"
+
  "extraInfo": {
                "avatar": "$NetworkAddressOfAvatarImage
+
  "[[Variable_Definitions#emailmd5|emailmd5]]": "string",
                "bitmessage": "$bitmessageAddress",
+
  "[[Variable_Definitions#avatarNetwork|avatarNetwork]]": "string",
                },
+
  "[[Variable_Definitions#avatar|avatar]]": "string",
            "verification": {
+
  "[[Variable_Definitions#headerImageNetwork|headerImageNetwork]]": "string",
                "IMDB": "$IMDBArtistUrl",
+
  "[[Variable_Definitions#headerImage|headerImage]]": "string",
                "MusicBrainz": "$MusicBrainzArtistURL",
+
  "[[Variable_Definitions#bitmessage|bitmessage]]": "string"
                "Twitter": "$TwitterVerificationURL",
+
  },
                "Facebook": $FacebookVerificationURL"
+
  "verification": {
                }
+
  "[[Variable_Definitions#IMDB|IMDB]]": "string",
            },
+
  "[[Variable_Definitions#MusicBrainz|MusicBrainz]]": "string",
        "signature": "$RegisterPublisherSignature"
+
  "[[Variable_Definitions#Twitter|Twitter]]": "string",
    }
+
  "[[Variable_Definitions#Facebook|Facebook]]": "string"
}
+
  }
 +
  },
 +
  "[[Variable_Definitions#signature|signature]]": "string"
 +
  }
 +
  }
 +
  }
 
[[deprecated register publisher|deprecated '''''Publisher Register''''' schema]]
 
[[deprecated register publisher|deprecated '''''Publisher Register''''' schema]]
 
</div>
 
</div>
Line 85: Line 99:
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
  {
 
  {
     "[[Variable Definitions#oip-041|oip-041]]": {
+
     "[[Variable Definitions#oip.23.23.23|oip042]]": {
         "[[Variable Definitions#editPub|editPub]]": {
+
         "[[Variable Definitions#edit|edit]]": {
             "[[Variable Definitions#txid|txid]]": "string",
+
             "[[Variable Definitions#pub|pub]]": {
            "[[Variable Definitions#timestamp|timestamp]]": int,
+
                "[[Variable Definitions#address|address]]": "string",
            "[[Variable Definitions#patch|patch]]": {
+
                "[[Variable Definitions#timestamp|timestamp]]": int,
                // [[Squash Edit|Squashed Edit]] of JSON Patch Schema https://tools.ietf.org/html/rfc6902
+
                "[[Variable Definitions#patch|patch]]": {
 +
                    // [[Squash Edit|Squashed Edit]] of JSON Patch Schema https://tools.ietf.org/html/rfc6902
 +
                }
 
             }
 
             }
 
         }
 
         }
Line 119: Line 135:
 
                         "string",
 
                         "string",
 
                         "string"
 
                         "string"
                        ]
+
                    ]
                    }
+
                }
                },
+
            },
 
             "payment":{
 
             "payment":{
 
                 "[[Variable Definitions#fiat|fiat]]": "string",
 
                 "[[Variable Definitions#fiat|fiat]]": "string",
Line 138: Line 154:
 
                     "STRING": int
 
                     "STRING": int
 
                 }
 
                 }
                },
+
            },
 
             "storage":{
 
             "storage":{
 
                 "[[Variable Definitions#network|network]]": "string",
 
                 "[[Variable Definitions#network|network]]": "string",
Line 163: Line 179:
 
                         "tokenlyID": "string"
 
                         "tokenlyID": "string"
 
                     }
 
                     }
                 },
+
                 ]
            "[[Variable Definitions#signature_2|signature]]": "string"
+
            },
        }
+
        "[[Variable Definitions#signature_2|signature]]": "string"
 +
    }
 
  }
 
  }
 
</div>
 
</div>
Line 235: Line 252:
 
             "FLOaddress": "string",
 
             "FLOaddress": "string",
 
             "http-url": "string",
 
             "http-url": "string",
             "version": 1,
+
             "version": 2,
             "opt": {
+
             "extraInfo": {
 
                 "name": "string",
 
                 "name": "string",
 
                 "minimum-share": int
 
                 "minimum-share": int
 +
            },
 +
            "verification": {
 +
                "twitter": "string",
 +
                "facebook": "string"
 
             }
 
             }
 
         },
 
         },
Line 259: Line 280:
 
             "LTCaddress":"string",
 
             "LTCaddress":"string",
 
             "FLOaddress":"string",
 
             "FLOaddress":"string",
             "version":1,
+
             "version": 2,
             "social":{   
+
             "extraInfo": {
 +
                "name": "string",
 +
                "minimum-share": int
 +
            },
 +
            "verification":{   
 
                 "facebook":"string",
 
                 "facebook":"string",
                 "twitter":"string",
+
                 "twitter":"string"
                "instagram":"string"
 
 
             }
 
             }
 
         },
 
         },
Line 295: Line 319:
  
 
== Autominer Pool Register ==
 
== Autominer Pool Register ==
You can view information about the Register Autominer Pool Schema [[Autominer Pool Registration Message Format|here]]
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
To view the JSON schema for '''''Register Autominer Pool''''', click Expand ->
 +
<div class="mw-collapsible-content">
 +
{
 +
    "oip-041": {
 +
        "autominerPool": {
 +
            "FLOaddress": "string",
 +
            "webURL": "string",
 +
            "PoolName": "string",
 +
            "TargetMargin": integer,
 +
            "PoolShare": integer,
 +
            "version": 2
 +
        },
 +
        "signature": "string"
 +
    }
 +
}
 +
[[Deprecated register autominer pool|deprecated '''''Register Autominer Pool''''' schema]]
 +
</div>
 +
</div>
 
A list of Registered Autominer Pools can be found at [[Alexandrias_Hosted_APIs#Autominer_Pool|Alexandria's hosted API endpoint]]
 
A list of Registered Autominer Pools can be found at [[Alexandrias_Hosted_APIs#Autominer_Pool|Alexandria's hosted API endpoint]]
 
  
 
= Historian Messages =
 
= Historian Messages =
  
== Historian Datapoint ==
+
== Autominer Pool Historian Datapoint ==
 
Plaintext data, stored in the block reward (coinbase) transaction comment.
 
Plaintext data, stored in the block reward (coinbase) transaction comment.
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
Line 317: Line 358:
 
  [[results.fmd.usd]]:
 
  [[results.fmd.usd]]:
 
  [[historian-datapoint-signature]]
 
  [[historian-datapoint-signature]]
 +
}
 +
 +
{
 +
oip042Hd:
 +
pub:
 +
historypoint:
 +
[[pool_flo_address]]:
 +
[[results.mrr.last_10]]:
 +
[[results.mrr.last_24hr]]:
 +
[[results.pool.hashrate]]:
 +
[[results.fbd.networkhashps]]:
 +
[[results.fmd.weighted]]:
 +
[[results.ltc.price_usd]]:
 +
[[results.fmd.usd]]:
 +
[[historian-datapoint-signature]]
 +
}
 +
</div>
 +
</div>
 +
== Autominer Block Reward ==
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
To view the JSON schema for '''''Historian Block Reward''''', click Expand ->
 +
<div class="mw-collapsible-content">
 +
{
 +
    oip042Hb:
 +
    [[pool_flo_address]]:
 +
    [[block]]:
 +
    [[historian-blockreward-signature]]
 
  }
 
  }
 
</div>
 
</div>
 
</div>
 
</div>
== Historian Block Reward ==
 
Plaintext data, stored in a transaction comment. [[Historian Block Reward Message Format]]
 

Latest revision as of 23:32, 31 January 2018

Register/Publish Edit Transfer Control Deactivate Historian
Publishers Publisher Register Publisher Edit
Artifacts Artifact Publish Artifact Edit Artifact Transfer Artifact Deactivate
Retailers Retailer Register Retailer Edit
Promoters Promoter Register Promoter Edit
Autominer Pools Autominer Pool Register Autominer Pool Edit Datapoint
Autominers Autominer Register Autominer Edit Block Reward

Multipart Messages

All of the below blockchain messages are stored as plaintext in one or more transaction comments. If the total message length is larger than the 528 byte tx-comments currently supported by Florincoin, then the message will be split up into a Multipart message.

You can find information on how Multipart messages are formed here.

message protocol

Publisher Register

To view the JSON schema for Publisher Register, click Expand ->

 {
 	"oip042": {
 		"register": {
 			"pub": {
 				"alias": "string",
 				"address": "string",
 				"timestamp": integer,
 				"authorized": ["string", "string"],
 				"extraInfo": {
 					"emailmd5": "string",
 					"avatarNetwork": "string",
 					"avatar": "string",
 					"headerImageNetwork": "string",
 					"headerImage": "string",
 					"bitmessage": "string"
 				},
 				"verification": {
 					"IMDB": "string",
 					"MusicBrainz": "string",
 					"Twitter": "string",
 					"Facebook": "string"
 				}
 			},
 			"signature": "string"
 		}
 	}
 }

deprecated Publisher Register schema

A list of Registered Publishers can be found at Alexandria's hosted API endpoint

Publisher Edit

To view the JSON schema for Publisher Edit, click Expand ->

{
    "oip042": {
        "edit": {
            "pub": {
                "address": "string",
                "timestamp": int,
                "patch": {
                    // Squashed Edit of JSON Patch Schema https://tools.ietf.org/html/rfc6902
                }
            }
        }
    },
    "signature": "string"
}

Artifact Publish

To view the JSON schema for Artifact Publishing, click Expand ->

{
    "oip-041":{
        "artifact":{
            "publisher": "string",
            "timestamp": 10 digit int,
            "type": "string",
            "info":{
                "title": "string",
                "description": "string",
                "year": 4 digit int,
                "extraInfo":{
                    "artist": "string",
                    "company": "string",
                    "tags":[
                        "string",
                        "string"
                    ]
                }
            },
            "payment":{
                "fiat": "string",
                "scale": int,
                "sugTip":[
                    int,
                    int,
                    int
                    ],
                "addresses": {
                    "three letter string":"string",
                    "three letter string":"string"
                },
                "tokens": {
                    "STRING": int,
                    "STRING": int
                }
            },
            "storage":{
                "network": "string",
                "location": "string,
                "files":[
                    {
                        "disBuy": boolean,
                        "disPlay": boolean,
                        "dName": "string",
                        "duration": int,
                        "fName": "string",
                        "fSize": int,
                        "sugPlay": "int",
                        "minPlay": "int",
                        "sugBuy": "int",
                        "minBuy": "int",
                        "disPer": "int",
                        "promo": "int",
                        "retail": "int",
                        "ptpFT": int,
                        "ptpDT": int,
                        "ptpDA": int,
                        "type": "string",
                        "tokenlyID": "string"
                    }
                ]
            },
        "signature": "string"
    }
}

A list of Published Artifacts can be found at Alexandria's hosted API endpoint

Artifact Edit

To view the JSON schema for Artifact Edits, click Expand ->

{
    "oip-041": {
        "editArtifact": {
            "txid": "string",
            "timestamp": int,
            "patch": {
                // Squashed Edit of JSON Patch Schema https://tools.ietf.org/html/rfc6902
            }
        }
    },
    "signature": "string"
}

Artifact Transfer

To view the JSON schema for Artifact Transfers, click Expand ->

{
    "oip-041": {
    "transferArtifact": {
        "txid": "string",
            "to": "string",
            "from": "string",
            "timestamp": int
        },
        "signature": "string"
    }
}

Artifact Deactivate

To view the JSON schema for Artifact Deactivation, click Expand ->

{
    "oip-041": {
        "deactivateArtifact": {
            "txid": "string",
            "timestamp": int
        },
        "signature": "string"
    }
}

Retailer Register

Plaintext data, stored in a transaction comment.

To view the JSON schema for Register Retailer, click Expand ->

{
    "oip-041": {
        "retailer": {
            "FLOaddress": "string",
            "FLOaddress": "string",
            "http-url": "string",
            "version": 2,
            "extraInfo": {
                "name": "string",
                "minimum-share": int
            },
            "verification": {
                "twitter": "string",
                "facebook": "string"
            }
        },
        "signature": "string"
    }
}

deprecated Register Retailer schema

A list of Registered Retailers can be found at Alexandria's hosted API endpoint

Promoter Register

To view the JSON schema for Register Promoter, click Expand ->

{  
    "oip-041":{  
        "promoter":{  
            "BTCaddress":"string",
            "LTCaddress":"string",
            "FLOaddress":"string",
            "version": 2,
            "extraInfo": {
                "name": "string",
                "minimum-share": int
            },
            "verification":{  
                "facebook":"string",
                "twitter":"string"
            }
        },
        "signature":"string"
    }
}

deprecated Register Promoter schema

A list of Registered Promoters can be found at Alexandria's hosted API endpoint

Autominer Register

To view the JSON schema for Register Autominer, click Expand ->

{
    "oip-041": {
        "autominer": {
            "FLOaddress": "string",
            "BTCaddress": "string",
            "endpointURL": "string",
            "version": 2
        },
        "signature": "string"
    }
}

deprecated Register Autominer schema

A list of Registered Autominers can be found at Alexandria's hosted API endpoint

Autominer Pool Register

To view the JSON schema for Register Autominer Pool, click Expand ->

{
    "oip-041": {
        "autominerPool": {
            "FLOaddress": "string",
            "webURL": "string",
            "PoolName": "string",
            "TargetMargin": integer,
            "PoolShare": integer,
            "version": 2
        },
        "signature": "string"
    }
}

deprecated Register Autominer Pool schema

A list of Registered Autominer Pools can be found at Alexandria's hosted API endpoint

Historian Messages

Autominer Pool Historian Datapoint

Plaintext data, stored in the block reward (coinbase) transaction comment.

Autominer Block Reward

To view the JSON schema for Historian Block Reward, click Expand ->