Skip to content

Commit 2051230

Browse files
committed
fixed readme
1 parent 96c3d06 commit 2051230

File tree

2 files changed

+26
-0
lines changed

2 files changed

+26
-0
lines changed

README.md

+13
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ The option <code>--provider</code> must be set in all commands. It should be set
2525
### Commands:
2626
#### create
2727
Creates a new TIC account by generating a profile and a contacts channel and saving its channel roots on the tangle.
28+
2829
| Param | Type | Default | Description |
2930
| --- | --- | --- | --- |
3031
| seed | <code>string</code> | | The seed of the TIC account to create. It's used to create the public master channel of the account where the channel roots of the profile and contacts channel are published. |
@@ -36,13 +37,15 @@ $ ticCli-linux-x86 create --seed=THISISTHESEEDOFTHETICACCOUNTANDISHOULDNOTGIVEIT
3637
```
3738
#### read
3839
Reads the content of a TIC account from the tangle.
40+
3941
| Param | Type | Default | Description |
4042
| --- | --- | --- | --- |
4143
| seed | <code>string</code> | | The seed of the TIC account |
4244
| masterRoot | <code>string</code> | | The root of the master channel of the TIC account to read |
4345
| profileRoot | <code>string</code> | | The channel root of the profile channel to read |
4446
| contactsRoot | <code>string</code> | | The channel root of the contacts channel to read |
4547
| password | <code>string</code> | seed | The tryte-encoded password to get the seeds of profile and contacts channel in the restricted channel of the TIC account. If password is not given the seed is used as a default. If null is given the seeds aren't retrieved. |
48+
4649
One of these params is needed to read content from an account. The cli will look for them in descending order of the table. If profile and contacts root are given both channels are read.
4750
The password is only needed together with the seed.
4851

@@ -53,12 +56,14 @@ $ ticCli-linux-x86 read --profileRoot=RGHGRDSIUHGRDOINGGSOLHKZHSÖFJBRHVUFCFYVNE
5356
```
5457
#### putInfo
5558
Adds the given information in JSON format to the profile of a TIC account.
59+
5660
| Param | Type | Default | Description |
5761
| --- | --- | --- | --- |
5862
| seed | <code>string</code> | | The seed of the TIC account |
5963
| password | <code>string</code> | seed | The tryte-encoded password of the TIC account. It's used to retrieve the channel root from the restricted channel. If password is not given the seed is used as a default. If null is given the seed can't be retrieved. |
6064
| profileSeed | <code>string</code> | | The channel root of the profile channel to add information to |
6165
| content | <code>string</code> | | The information to add to the profile in form of key/value pairs formatted as a JSON object. '"' might be needed to escape and the content must be wraped in '' |
66+
6267
Only seed or profile seed is needed for this request. Seed can only be used if channel seeds are saved on the tangle with the
6368
given password.
6469

@@ -70,12 +75,14 @@ $ ticCli-linux-x86 putInfo --seed=DSFEDHKSZAGFZUAIUAAWBSFVHJHTRNDBGZUFGJSDGIGDHJ
7075
```
7176
#### removeInfo
7277
Removes the properties as a JSON array from the profile of a TIC account.
78+
7379
| Param | Type | Default | Description |
7480
| --- | --- | --- | --- |
7581
| seed | <code>string</code> | | The seed of the TIC account |
7682
| password | <code>string</code> | seed | The tryte-encoded password of the TIC account. It's used to retrieve the channel root from the restricted channel. If password is not given the seed is used as a default. If null is given the seed can't be retrieved. |
7783
| profileSeed | <code>string</code> | | The channel root of the profile channel to remove information from |
7884
| content | <code>string</code> | | The information to remove from the profile in form of the keys formatted as a JSON array. '"' might be needed to escape and the content must be wraped in '' |
85+
7986
Only seed or profile seed is needed for this request. Seed can only be used if channel seeds are saved on the tangle with the
8087
given password.
8188
Please note that the information is not really deleted from the tangle as that is not possible. The given information could be read on the mam channel as before by everyone. This request has the effect that the TIC library will not consider the given properties in information that has been published to this profile before, when compiling the profile information.
@@ -87,12 +94,14 @@ $ ticCli-linux-x86 removeInfo --profileSeed=THESEEDOFTHEPROFILECHANNELOFTHETICAC
8794
```
8895
#### trust
8996
Adds the given account to the trusted contacts of a TIC account.
97+
9098
| Param | Type | Default | Description |
9199
| --- | --- | --- | --- |
92100
| seed | <code>string</code> | | The seed of the TIC account |
93101
| password | <code>string</code> | seed | The tryte-encoded password of the TIC account. It's used to retrieve the channel root from the restricted channel. If password is not given the seed is used as a default. If null is given the seed can't be retrieved. |
94102
| contactsSeed | <code>string</code> | | The channel root of the contacts channel to add trusts to |
95103
| content | <code>string</code> | | The master channel roots of the accounts to add to the trusted contacts formatted as a JSON array. '"' might be needed to escape and the content must be wraped in '' |
104+
96105
Only seed or contacts seed is needed for this request. Seed can only be used if channel seeds are saved on the tangle with the
97106
given password.
98107

@@ -104,12 +113,14 @@ $ ticCli-linux-x86 trust --contactsSeed=THESEEDOFTHECONTACTSCHANNELOFTHETICACCOU
104113
```
105114
#### distrust
106115
Adds the given account to the distrusted contacts of a TIC account.
116+
107117
| Param | Type | Default | Description |
108118
| --- | --- | --- | --- |
109119
| seed | <code>string</code> | | The seed of the TIC account |
110120
| password | <code>string</code> | seed | The tryte-encoded password of the TIC account. It's used to retrieve the channel root from the restricted channel. If password is not given the seed is used as a default. If null is given the seed can't be retrieved. |
111121
| contactsSeed | <code>string</code> | | The channel root of the contacts channel to add distrusts to |
112122
| content | <code>string</code> | | The master channel roots of the accounts to add to the distrusted contacts formatted as a JSON array. '"' might be needed to escape and the content must be wraped in '' |
123+
113124
Only seed or contacts seed is needed for this request. Seed can only be used if channel seeds are saved on the tangle with the
114125
given password.
115126

@@ -122,12 +133,14 @@ $ ticCli-linux-x86 distrust --seed=EWIVBSDFIUGRUISAGAFKGRFZEAUKGFZERGFCFEUGICGFZ
122133
```
123134
#### rating
124135
Computes the trust rating for a given account by querying the contacts of a TIC account.
136+
125137
| Param | Type | Default | Description |
126138
| --- | --- | --- | --- |
127139
| masterRoot | <code>string</code> | | The root of the master channel of the TIC account to base the rating query on |
128140
| seed | <code>string</code> | | The seed of the TIC account to base the rating query on |
129141
| target | <code>string</code> | | The master channel root of the TIC account to compute a trust rating of |
130142
| depth | <code>number</code> | 5 | The maximum depth of recursive querying of contacts of contacts of contacts... |
143+
131144
Only masterRoot or seed is needed for this request. The CLI will look for the master root first.
132145

133146
**Example**

jsdoc2md/README.hbs

+13
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ The option <code>--provider</code> must be set in all commands. It should be set
2525
### Commands:
2626
#### create
2727
Creates a new TIC account by generating a profile and a contacts channel and saving its channel roots on the tangle.
28+
2829
| Param | Type | Default | Description |
2930
| --- | --- | --- | --- |
3031
| seed | <code>string</code> | | The seed of the TIC account to create. It's used to create the public master channel of the account where the channel roots of the profile and contacts channel are published. |
@@ -36,13 +37,15 @@ $ ticCli-linux-x86 create --seed=THISISTHESEEDOFTHETICACCOUNTANDISHOULDNOTGIVEIT
3637
```
3738
#### read
3839
Reads the content of a TIC account from the tangle.
40+
3941
| Param | Type | Default | Description |
4042
| --- | --- | --- | --- |
4143
| seed | <code>string</code> | | The seed of the TIC account |
4244
| masterRoot | <code>string</code> | | The root of the master channel of the TIC account to read |
4345
| profileRoot | <code>string</code> | | The channel root of the profile channel to read |
4446
| contactsRoot | <code>string</code> | | The channel root of the contacts channel to read |
4547
| password | <code>string</code> | seed | The tryte-encoded password to get the seeds of profile and contacts channel in the restricted channel of the TIC account. If password is not given the seed is used as a default. If null is given the seeds aren't retrieved. |
48+
4649
One of these params is needed to read content from an account. The cli will look for them in descending order of the table. If profile and contacts root are given both channels are read.
4750
The password is only needed together with the seed.
4851

@@ -53,12 +56,14 @@ $ ticCli-linux-x86 read --profileRoot=RGHGRDSIUHGRDOINGGSOLHKZHSÖFJBRHVUFCFYVNE
5356
```
5457
#### putInfo
5558
Adds the given information in JSON format to the profile of a TIC account.
59+
5660
| Param | Type | Default | Description |
5761
| --- | --- | --- | --- |
5862
| seed | <code>string</code> | | The seed of the TIC account |
5963
| password | <code>string</code> | seed | The tryte-encoded password of the TIC account. It's used to retrieve the channel root from the restricted channel. If password is not given the seed is used as a default. If null is given the seed can't be retrieved. |
6064
| profileSeed | <code>string</code> | | The channel root of the profile channel to add information to |
6165
| content | <code>string</code> | | The information to add to the profile in form of key/value pairs formatted as a JSON object. '"' might be needed to escape and the content must be wraped in '' |
66+
6267
Only seed or profile seed is needed for this request. Seed can only be used if channel seeds are saved on the tangle with the
6368
given password.
6469

@@ -70,12 +75,14 @@ $ ticCli-linux-x86 putInfo --seed=DSFEDHKSZAGFZUAIUAAWBSFVHJHTRNDBGZUFGJSDGIGDHJ
7075
```
7176
#### removeInfo
7277
Removes the properties as a JSON array from the profile of a TIC account.
78+
7379
| Param | Type | Default | Description |
7480
| --- | --- | --- | --- |
7581
| seed | <code>string</code> | | The seed of the TIC account |
7682
| password | <code>string</code> | seed | The tryte-encoded password of the TIC account. It's used to retrieve the channel root from the restricted channel. If password is not given the seed is used as a default. If null is given the seed can't be retrieved. |
7783
| profileSeed | <code>string</code> | | The channel root of the profile channel to remove information from |
7884
| content | <code>string</code> | | The information to remove from the profile in form of the keys formatted as a JSON array. '"' might be needed to escape and the content must be wraped in '' |
85+
7986
Only seed or profile seed is needed for this request. Seed can only be used if channel seeds are saved on the tangle with the
8087
given password.
8188
Please note that the information is not really deleted from the tangle as that is not possible. The given information could be read on the mam channel as before by everyone. This request has the effect that the TIC library will not consider the given properties in information that has been published to this profile before, when compiling the profile information.
@@ -87,12 +94,14 @@ $ ticCli-linux-x86 removeInfo --profileSeed=THESEEDOFTHEPROFILECHANNELOFTHETICAC
8794
```
8895
#### trust
8996
Adds the given account to the trusted contacts of a TIC account.
97+
9098
| Param | Type | Default | Description |
9199
| --- | --- | --- | --- |
92100
| seed | <code>string</code> | | The seed of the TIC account |
93101
| password | <code>string</code> | seed | The tryte-encoded password of the TIC account. It's used to retrieve the channel root from the restricted channel. If password is not given the seed is used as a default. If null is given the seed can't be retrieved. |
94102
| contactsSeed | <code>string</code> | | The channel root of the contacts channel to add trusts to |
95103
| content | <code>string</code> | | The master channel roots of the accounts to add to the trusted contacts formatted as a JSON array. '"' might be needed to escape and the content must be wraped in '' |
104+
96105
Only seed or contacts seed is needed for this request. Seed can only be used if channel seeds are saved on the tangle with the
97106
given password.
98107

@@ -104,12 +113,14 @@ $ ticCli-linux-x86 trust --contactsSeed=THESEEDOFTHECONTACTSCHANNELOFTHETICACCOU
104113
```
105114
#### distrust
106115
Adds the given account to the distrusted contacts of a TIC account.
116+
107117
| Param | Type | Default | Description |
108118
| --- | --- | --- | --- |
109119
| seed | <code>string</code> | | The seed of the TIC account |
110120
| password | <code>string</code> | seed | The tryte-encoded password of the TIC account. It's used to retrieve the channel root from the restricted channel. If password is not given the seed is used as a default. If null is given the seed can't be retrieved. |
111121
| contactsSeed | <code>string</code> | | The channel root of the contacts channel to add distrusts to |
112122
| content | <code>string</code> | | The master channel roots of the accounts to add to the distrusted contacts formatted as a JSON array. '"' might be needed to escape and the content must be wraped in '' |
123+
113124
Only seed or contacts seed is needed for this request. Seed can only be used if channel seeds are saved on the tangle with the
114125
given password.
115126

@@ -122,12 +133,14 @@ $ ticCli-linux-x86 distrust --seed=EWIVBSDFIUGRUISAGAFKGRFZEAUKGFZERGFCFEUGICGFZ
122133
```
123134
#### rating
124135
Computes the trust rating for a given account by querying the contacts of a TIC account.
136+
125137
| Param | Type | Default | Description |
126138
| --- | --- | --- | --- |
127139
| masterRoot | <code>string</code> | | The root of the master channel of the TIC account to base the rating query on |
128140
| seed | <code>string</code> | | The seed of the TIC account to base the rating query on |
129141
| target | <code>string</code> | | The master channel root of the TIC account to compute a trust rating of |
130142
| depth | <code>number</code> | 5 | The maximum depth of recursive querying of contacts of contacts of contacts... |
143+
131144
Only masterRoot or seed is needed for this request. The CLI will look for the master root first.
132145

133146
**Example**

0 commit comments

Comments
 (0)