@neuraiproject/neurai-rpc 0.4.7 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/neurai_methods.md CHANGED
@@ -85,6 +85,9 @@ Examples:
85
85
  ## addtagtoaddress
86
86
  &nbsp;<br/> addtagtoaddress tag_name to_address (change_address) (asset_data)
87
87
 
88
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
89
+
90
+
88
91
  Assign a tag to a address
89
92
 
90
93
  Arguments:
@@ -131,7 +134,8 @@ Examples:
131
134
 
132
135
  &nbsp;<br> &nbsp;<br/>
133
136
  ## bumpfee
134
- &nbsp;<br/> bumpfee has been deprecated on the XNA Wallet.
137
+ &nbsp;<br/> bumpfee has been deprecated on the XNA Wallet.
138
+
135
139
  &nbsp;<br> &nbsp;<br/>
136
140
  ## cancelsnapshotrequest
137
141
  &nbsp;<br/> cancelsnapshotrequest "asset_name" block_height
@@ -155,6 +159,9 @@ Examples:
155
159
  ## checkaddressrestriction
156
160
  &nbsp;<br/> checkaddressrestriction address restricted_name
157
161
 
162
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
163
+
164
+
158
165
  Checks to see if an address has been frozen by the given restricted asset
159
166
 
160
167
  Arguments:
@@ -172,6 +179,9 @@ Examples:
172
179
  ## checkaddresstag
173
180
  &nbsp;<br/> checkaddresstag address tag_name
174
181
 
182
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
183
+
184
+
175
185
  Checks to see if an address has the given tag
176
186
 
177
187
  Arguments:
@@ -189,10 +199,13 @@ Examples:
189
199
  ## checkdepinvalidity
190
200
  &nbsp;<br/> checkdepinvalidity "asset_name" "address"
191
201
 
192
- Check if a dedicated DePIN asset is valid/active for a specific address. Dedicated DePIN assets currently use the '&' prefix.
202
+ THIS COMMAND IS NOT YET ACTIVE!
203
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
204
+
205
+ Check if a DEPIN asset is valid/active for a specific address
193
206
 
194
207
  Arguments:
195
- 1. "asset_name" (string, required) The DePIN asset name
208
+ 1. "asset_name" (string, required) The DEPIN asset name (must start with &)
196
209
  2. "address" (string, required) The address to check
197
210
 
198
211
  Result:
@@ -205,12 +218,15 @@ Result:
205
218
 
206
219
  Examples:
207
220
  > neurai-cli checkdepinvalidity "&FRANCE" "address"
208
- > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "checkdepinvalidity", "params": ["&FRANCE", "address"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
221
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "checkdepinvalidity", "params": ["&FRANCE" "address"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
209
222
 
210
223
  &nbsp;<br> &nbsp;<br/>
211
224
  ## checkglobalrestriction
212
225
  &nbsp;<br/> checkglobalrestriction restricted_name
213
226
 
227
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
228
+
229
+
214
230
  Checks to see if a restricted asset is globally frozen
215
231
 
216
232
  Arguments:
@@ -247,6 +263,9 @@ Examples:
247
263
  ## clearmessages
248
264
  &nbsp;<br/> clearmessages
249
265
 
266
+ THIS COMMAND IS NOT YET ACTIVE!
267
+ https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
268
+
250
269
  Delete current database of messages
251
270
 
252
271
  Result:[
@@ -309,7 +328,8 @@ As a json rpc call
309
328
  &nbsp;<br> &nbsp;<br/>
310
329
  ## createrawtransaction
311
330
  &nbsp;<br/> createrawtransaction [{"txid":"id","vout":n},...] {"address":(amount or object),"data":"hex",...}
312
- ( locktime ) ( replaceable )
331
+ createrawtransaction [{"txid":"id","vout":n},...] [{"address":(amount or object)},{"data":"hex"},...]
332
+ ( locktime ) ( [{"txid":"id","vout":n},...] )
313
333
 
314
334
  Create a transaction spending the given inputs and creating new outputs.
315
335
  Outputs are addresses (paired with a XNA amount, data or object specifying an asset operation) or data.
@@ -323,16 +343,16 @@ Paying for Asset Operations:
323
343
  Operation Amount + Burn Address
324
344
  transfer 0
325
345
  transferwithmessage 0
326
- issue 500 to RXissueAssetXXXXXXXXXXXXXXXXXhhZGt
327
- issue (subasset) 100 to RXissueSubAssetXXXXXXXXXXXXXWcwhwL
328
- issue_unique 5 to RXissueUniqueAssetXXXXXXXXXXWEAe58
329
- reissue 100 to RXReissueAssetXXXXXXXXXXXXXXVEFAWu
330
- issue_restricted 1500 to RXissueRestrictedXXXXXXXXXXXXzJZ1q
331
- reissue_restricted 100 to RXReissueAssetXXXXXXXXXXXXXXVEFAWu
332
- issue_qualifier 1000 to RXissueQuaLifierXXXXXXXXXXXXUgEDbC
333
- issue_qualifier (sub) 100 to RXissueSubQuaLifierXXXXXXXXXVTzvv5
334
- tag_addresses 0.1 to RXaddTagBurnXXXXXXXXXXXXXXXXZQm5ya (per address)
335
- untag_addresses 0.1 to RXaddTagBurnXXXXXXXXXXXXXXXXZQm5ya (per address)
346
+ issue 1000 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy
347
+ issue (subasset) 200 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy
348
+ issue_unique 10 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy
349
+ reissue 200 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy
350
+ issue_restricted 3000 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy
351
+ reissue_restricted 200 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy
352
+ issue_qualifier 2000 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy
353
+ issue_qualifier (sub) 200 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy
354
+ tag_addresses 0.1 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy (per address)
355
+ untag_addresses 0.1 to tBURNXXXXXXXXXXXXXXXXXXXXXXXVZLroy (per address)
336
356
  freeze_addresses 0
337
357
  unfreeze_addresses 0
338
358
  freeze_asset 0
@@ -372,7 +392,7 @@ Arguments:
372
392
  }
373
393
  ,...
374
394
  ]
375
- 2. "outputs" (object, required) a json object with outputs
395
+ 2. "outputs" (object or array, required) outputs in object or ordered-array form
376
396
  {
377
397
  "address": (string, required) The destination neurai address.
378
398
  Each output must have a different address.
@@ -386,6 +406,7 @@ Arguments:
386
406
  ,...
387
407
  }
388
408
  }
409
+ }
389
410
  or
390
411
  { (object) A json object of describing the transfer and message contents to send
391
412
  "transferwithmessage":
@@ -537,7 +558,23 @@ Arguments:
537
558
  "data": "hex" (string, required) The key is "data", the value is hex encoded data
538
559
  ,...
539
560
  }
561
+ or
562
+ [
563
+ {"address":x.xxx}, (object, required) exactly one key per entry
564
+ {"address":{...}}, (object, required) ordered form allows duplicate addresses
565
+ {"data":"hex"},
566
+ ...
567
+ ]
568
+ Array form must be non-empty.
540
569
  3. locktime (numeric, optional, default=0) Raw locktime. Non-0 value also locktime-activates inputs
570
+ 4. "refinputs" (array, optional) NIP-014: reference inputs (forces v3 transaction)
571
+ [
572
+ {
573
+ "txid":"id", (string, required) The transaction id
574
+ "vout":n (number, required) The output number
575
+ }
576
+ ,...
577
+ ]
541
578
 
542
579
  Result:
543
580
  "transaction" (string) hex string of the transaction
@@ -551,6 +588,7 @@ Examples:
551
588
  > neurai-cli createrawtransaction "[{\"txid\":\"mycoin\",\"vout\":0},{\"txid\":\"myasset\",\"vout\":0}]" "{\"address\":{\"transfer\":{\"MYASSET\":50}}}"
552
589
  > neurai-cli createrawtransaction "[{\"txid\":\"mycoin\",\"vout\":0},{\"txid\":\"myasset\",\"vout\":0}]" "{\"address\":{\"transferwithmessage\":{\"MYASSET\":50,\"message\":\"hash\",\"expire_time\": utc_time}}}"
553
590
  > neurai-cli createrawtransaction "[{\"txid\":\"mycoin\",\"vout\":0},{\"txid\":\"myownership\",\"vout\":0}]" "{\"issuer_address\":{\"reissue\":{\"asset_name\":\"MYASSET\",\"asset_quantity\":2000000}}}"
591
+ > neurai-cli createrawtransaction "[{\"txid\":\"mycoin\",\"vout\":0}]" "[{\"address\":500},{\"address\":{\"issue\":{\"asset_name\":\"MYASSET\",\"asset_quantity\":1000000,\"units\":1,\"reissuable\":0,\"has_ipfs\":0}}}]"
554
592
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "createrawtransaction", "params": ["[{\"txid\":\"mycoin\",\"vout\":0}]", "{\"data\":\"00010203\"}"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
555
593
 
556
594
  &nbsp;<br> &nbsp;<br/>
@@ -682,7 +720,7 @@ Examples:
682
720
 
683
721
  &nbsp;<br> &nbsp;<br/>
684
722
  ## depinclearmsg
685
- &nbsp;<br/> depinclearmsg ( "all" | hours )
723
+ &nbsp;<br/> depinclearmsg ( "all" | hours ) ( "scope" )
686
724
 
687
725
  Remove messages from DePIN messaging pool
688
726
 
@@ -691,6 +729,9 @@ Arguments:
691
729
  - omitted: Remove only expired messages (default)
692
730
  - "all": Remove ALL messages from pool
693
731
  - <hours>: Remove messages older than specified hours (numeric)
732
+ 2. scope (string, optional) Section token. When given, only messages of that
733
+ section's subtree are removed; parents and siblings are untouched.
734
+ Omitted or "" keeps the historical pool-wide behavior.
694
735
 
695
736
  Result:
696
737
  {
@@ -699,10 +740,72 @@ Result:
699
740
  }
700
741
 
701
742
  Examples:
702
- > neurai-cli depinclearmsg
743
+ > neurai-cli depinclearmsg
703
744
  > neurai-cli depinclearmsg "all"
704
745
  > neurai-cli depinclearmsg 7
746
+ > neurai-cli depinclearmsg "all" "&TOKEN/GENERAL"
705
747
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinclearmsg", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
748
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinclearmsg", "params": ["all"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
749
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinclearmsg", "params": [7] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
750
+
751
+ &nbsp;<br> &nbsp;<br/>
752
+ ## depingetancestorrecipients
753
+ &nbsp;<br/> depingetancestorrecipients "token" ( max_results ) ( "stop_at" )
754
+
755
+ List the active holders of a DEPIN branch: the deduplicated union of the
756
+ holders of the given token and of every one of its '/'-separated ancestors,
757
+ each with the public key it has revealed on chain.
758
+
759
+ Active means: positive balance, public key revealed, and not blocked by an
760
+ owner freeze or by self-revocation. Restriction is per (asset, address), so an
761
+ address that is active in at least one ancestor is returned even if it revoked
762
+ itself in another -- holding the root already grants visibility over the branch.
763
+
764
+ The query is exact: '&TEST' returns holders of '&TEST' only, never of
765
+ '&TEST/APPLE', '&TESTING' or '&TEST.FOO'. Every derived ancestor must exist; a
766
+ missing intermediate level is an error rather than something skipped.
767
+
768
+ This command is informational. It does not know about -depinmsgmaxusers, does
769
+ not decide whether a message fits in a pool, and a truncated result must not be
770
+ treated as a complete recipient set.
771
+
772
+ Requires -assetindex and -pubkeyindex.
773
+
774
+ Arguments:
775
+ 1. "token" (string, required) DEPIN token, e.g. "&TEST/APPLE/GOLDEN"
776
+ 2. max_results (numeric, optional, default=1000) Maximum recipients to return
777
+ (1..10000)
778
+ 3. "stop_at" (string, optional) Stop deriving ancestors at this token,
779
+ inclusive. Must be the token itself or one of its ancestors.
780
+ Omitted: derive up to the absolute root.
781
+
782
+ Result:
783
+ {
784
+ "token": "name", (string) Token queried
785
+ "stop_at": "name", (string) Where derivation stopped ("" = root)
786
+ "ancestors": ["name", ...], (array) Token first, then each ancestor
787
+ "recipients": [ (array) Active holders, ordered by address
788
+ {
789
+ "address": "address", (string) Holder address
790
+ "pubkey": "hex" (string) Public key revealed on chain
791
+ }, ...
792
+ ],
793
+ "returned": n, (numeric) Number of recipients returned
794
+ "max_results": n, (numeric) Limit applied
795
+ "truncated": true|false, (boolean) True if more eligible recipients exist
796
+ "skipped_no_pubkey": n, (numeric) Addresses dropped for lacking a usable
797
+ revealed public key
798
+ "skipped_no_pubkey_complete": bool, (boolean) False when truncated: the count then
799
+ covers only the addresses examined
800
+ "skipped_restricted": n, (numeric) Addresses dropped as frozen or
801
+ self-revoked in every ancestor they hold
802
+ "skipped_restricted_complete": bool (boolean) Same rule as above
803
+ }
804
+
805
+ Examples:
806
+ > neurai-cli depingetancestorrecipients "&TEST/APPLE/GOLDEN"
807
+ > neurai-cli depingetancestorrecipients "&TEST/APPLE/GOLDEN" 50 "&TEST/APPLE"
808
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depingetancestorrecipients", "params": ["&TEST/APPLE/GOLDEN", 50, "&TEST/APPLE"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
706
809
 
707
810
  &nbsp;<br> &nbsp;<br/>
708
811
  ## depingetmsg
@@ -749,6 +852,7 @@ Result:
749
852
  "enabled": true|false, (boolean) Whether DePIN messaging is enabled
750
853
  "token": "name", (string) Active token name
751
854
  "port": n, (numeric) Listening port
855
+ "cipher": "name", (string) Encryption cipher used by the pool
752
856
  "maxrecipients": n, (numeric) Maximum recipients per message
753
857
  "maxmessagesize": n, (numeric) Maximum message size in bytes
754
858
  "messageexpiryhours": n, (numeric) Message expiry time in hours
@@ -761,7 +865,7 @@ Result:
761
865
  }
762
866
 
763
867
  Examples:
764
- > neurai-cli depingetmsginfo
868
+ > neurai-cli depingetmsginfo
765
869
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depingetmsginfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
766
870
 
767
871
  &nbsp;<br> &nbsp;<br/>
@@ -784,21 +888,80 @@ Result (verbose=false):
784
888
  {
785
889
  "hash": "hex",
786
890
  "sender": "address",
891
+ "message_type": "private|group",
787
892
  "timestamp": n,
788
893
  "date": "YYYY-MM-DD HH:MM:SS",
789
894
  "expires": "YYYY-MM-DD HH:MM:SS",
790
- "encryption_type": "ECIES_shared",
895
+ "recipients": n,
791
896
  "size": n
792
897
  },
793
898
  ...
794
899
  ]
795
900
 
901
+ Result (verbose=true):
902
+ [
903
+ {
904
+ "hash": "hex",
905
+ "sender": "address",
906
+ "message_type": "private|group",
907
+ "timestamp": n,
908
+ "date": "YYYY-MM-DD HH:MM:SS",
909
+ "expires": "YYYY-MM-DD HH:MM:SS",
910
+ "recipients": [
911
+ {
912
+ "address": "address",
913
+ "encrypted_size": n
914
+ },
915
+ ...
916
+ ],
917
+ "signature_size": n,
918
+ "total_encrypted_size": n,
919
+ "total_size": n
920
+ },
921
+ ...
922
+ ]
923
+
796
924
  Examples:
797
- > neurai-cli depingetpoolcontent
925
+ > neurai-cli depingetpoolcontent
798
926
  > neurai-cli depingetpoolcontent true
799
- > neurai-cli depingetpoolcontent "all"
927
+ > neurai-cli depingetpoolcontent all
928
+ > neurai-cli depingetpoolcontent raw
929
+ > neurai-cli depingetpoolcontent false "NXXaddress..."
800
930
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depingetpoolcontent", "params": [true] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
801
931
 
932
+ &nbsp;<br> &nbsp;<br/>
933
+ ## depinlistsections
934
+ &nbsp;<br/> depinlistsections ( "address" )
935
+
936
+ List the sections (sub-assets) of the pool's active token, for UI tabs.
937
+ The list is served from a per-tip snapshot; section names are public on
938
+ chain, so no address is needed to see them. Message counters, however,
939
+ are only exposed for sections the given address has access to -- counts
940
+ of an unreadable section would leak metadata. For the same reason the
941
+ address mode is only served over node RPC: the DePIN port is
942
+ unauthenticated and answers the bare form (names only) there.
943
+
944
+ Arguments:
945
+ 1. "address" (string, optional) Report this address's access per section
946
+
947
+ Result:
948
+ [
949
+ {
950
+ "name": "&TOKEN/GENERAL", (string) Full section token
951
+ "label": "GENERAL", (string) Name relative to the pool root ("" = root)
952
+ "depth": n, (numeric) Levels below the pool root (0 = root)
953
+ "access": true|false, (boolean, only with address) Active inherited access
954
+ "messages": n (numeric, only with address and access) Messages in
955
+ this section's subtree
956
+ },
957
+ ...
958
+ ]
959
+
960
+ Examples:
961
+ > neurai-cli depinlistsections
962
+ > neurai-cli depinlistsections "NXyouraddress..."
963
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinlistsections", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
964
+
802
965
  &nbsp;<br> &nbsp;<br/>
803
966
  ## depinmcpstatus
804
967
  &nbsp;<br/> depinmcpstatus
@@ -816,13 +979,40 @@ Result:
816
979
  "poll_interval": n, (numeric) Polling interval in seconds
817
980
  "commands_processed": n, (numeric) Total commands processed
818
981
  "total_errors": n, (numeric) Total errors encountered
982
+ "rate_limited": n, (numeric) Commands rejected by rate limiting
983
+ "concurrency": n, (numeric) Number of parallel task threads
984
+ "tasks_in_flight": n, (numeric) AI requests currently being processed
985
+ "processed_cache": n, (numeric) Size of the processed-message dedup cache
986
+ "context_sessions": n, (numeric) Active conversation contexts
819
987
  "last_poll_time": n (numeric) Unix timestamp of last poll
820
988
  }
821
989
 
822
990
  Examples:
823
- > neurai-cli depinmcpstatus
991
+ > neurai-cli depinmcpstatus
824
992
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinmcpstatus", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
825
993
 
994
+ &nbsp;<br> &nbsp;<br/>
995
+ ## depinpoolpkey
996
+ &nbsp;<br/> depinpoolpkey
997
+
998
+ Returns the public key of the DePIN pool address from the internal wallet.
999
+ This command only works if the wallet is loaded and unlocked at node startup.
1000
+
1001
+ Derived path:
1002
+ Mainnet: m/44'/0'/200'/0/0
1003
+ Testnet: m/44'/0'/200'/1/0
1004
+
1005
+ Result:
1006
+ {
1007
+ "pubkey": "hex", (string) Public key in hex format
1008
+ "address": "address", (string) Corresponding Neurai address
1009
+ "path": "derivation_path" (string) BIP44 derivation path used
1010
+ }
1011
+
1012
+ Examples:
1013
+ > neurai-cli depinpoolpkey
1014
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinpoolpkey", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
1015
+
826
1016
  &nbsp;<br> &nbsp;<br/>
827
1017
  ## depinpoolstats
828
1018
  &nbsp;<br/> depinpoolstats
@@ -844,14 +1034,67 @@ Result:
844
1034
  "last_week": n
845
1035
  },
846
1036
  "unique_senders": n,
1037
+ "unique_recipients": n,
1038
+ "avg_recipients_per_message": n.nn,
847
1039
  "avg_message_size": n,
848
1040
  "expiring_in_24h": n
849
1041
  }
850
1042
 
851
1043
  Examples:
852
- > neurai-cli depinpoolstats
1044
+ > neurai-cli depinpoolstats
853
1045
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinpoolstats", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
854
1046
 
1047
+ &nbsp;<br> &nbsp;<br/>
1048
+ ## depinreceivemsg
1049
+ &nbsp;<br/> depinreceivemsg "token" "address" (timestamp) ("after_hash") (limit)
1050
+
1051
+ Retrieve DePIN messages from the pool with optional pagination
1052
+
1053
+ This endpoint returns the messages. If the server has a DePIN pool key
1054
+ and the requester's address has a revealed public key, the response will be
1055
+ fully encrypted using the privacy layer.
1056
+
1057
+ Arguments:
1058
+ 1. "token" (string, required) Token name
1059
+ 2. "address" (string, required) Neurai address (used as access selector and encryption target)
1060
+ 3. timestamp (numeric, optional) Unix time. Return only messages with timestamp >= (timestamp-1 if timestamp>0)
1061
+ 4. "after_hash" (string, optional) Hash of last received message for pagination. Empty "" starts from beginning
1062
+ 5. limit (numeric, optional) Maximum messages to return. 0 or omitted = no limit (return all)
1063
+
1064
+ Result (without pagination - backward compatible):
1065
+ [
1066
+ {
1067
+ "hash": "...", (string) Message hash
1068
+ "token": "...", (string) Token
1069
+ "sender": "...", (string) Sender address
1070
+ "timestamp": n, (numeric) Unix timestamp
1071
+ "message_type": "private|group", (string) Message type (private=1-to-1, group=broadcast)
1072
+ "encrypted_payload_hex": "...", (string) Encrypted payload (hex)
1073
+ "signature_hex": "..." (string) Message signature (hex)
1074
+ },
1075
+ ...
1076
+ ]
1077
+
1078
+ Result (with pagination - when limit > 0):
1079
+ {
1080
+ "messages": [...], (array) Array of message objects (same structure as above)
1081
+ "has_more": true|false (boolean) Whether more messages are available
1082
+ }
1083
+
1084
+ Note: Both message types are filtered by recipientKeys membership; the sender always sees their own messages.
1085
+
1086
+ Result (privacy layer active):
1087
+ {
1088
+ "encrypted": "hex_blob" (string) Full JSON response encrypted with ECIES
1089
+ }
1090
+
1091
+ Examples:
1092
+ > neurai-cli depinreceivemsg "TOKEN" "NeuraiAddress"
1093
+ > neurai-cli depinreceivemsg "TOKEN" "NeuraiAddress" 1730000000
1094
+ > neurai-cli depinreceivemsg "TOKEN" "NeuraiAddress" 0 "" 5
1095
+ > neurai-cli depinreceivemsg "TOKEN" "NeuraiAddress" 0 "abc123..." 5
1096
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinreceivemsg", "params": ["TOKEN", "NeuraiAddress", 0, "", 5] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
1097
+
855
1098
  &nbsp;<br> &nbsp;<br/>
856
1099
  ## depinsendmsg
857
1100
  &nbsp;<br/> depinsendmsg "token" "ip[:port]" "message" "fromaddress" (port)
@@ -880,15 +1123,23 @@ Examples:
880
1123
 
881
1124
  &nbsp;<br> &nbsp;<br/>
882
1125
  ## depinsubmitmsg
883
- &nbsp;<br/> depinsubmitmsg "hexmessage"
1126
+ &nbsp;<br/> depinsubmitmsg "hexmessage"|{"sender":"...","encrypted":"..."}
884
1127
 
885
1128
  Submit a pre-encrypted and signed DePIN message to the pool
886
1129
 
887
1130
  This is the secure protocol where the client prepares the complete message
888
1131
  (encryption + signature) and the server only validates and stores it.
889
1132
 
1133
+ This command also supports an optional privacy layer where the entire message
1134
+ is wrapped in a second layer of encryption for the server's pool key.
1135
+
890
1136
  Arguments:
891
- 1. "hexmessage" (string, required) Hex-encoded serialized CDepinMessage
1137
+ 1. "hexmessage" (string) Hex-encoded serialized CDepinMessage
1138
+ OR
1139
+ { (json object) Wrapped encrypted message
1140
+ "sender": "...", (string, required) Sender address
1141
+ "encrypted": "..." (string, required) Hex-encoded ECIES wrapper
1142
+ }
892
1143
 
893
1144
  Result:
894
1145
  {
@@ -897,11 +1148,9 @@ Result:
897
1148
  "timestamp": n (numeric) Unix timestamp
898
1149
  }
899
1150
 
900
- Note: This endpoint is typically called by remote nodes after challenge/response authentication.
901
-
902
1151
  Examples:
903
1152
  > neurai-cli depinsubmitmsg "0a3f2e..."
904
- > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinsubmitmsg", "params": ["0a3f2e..."] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
1153
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinsubmitmsg", "params": [{"sender":"NX...","encrypted":"..."}] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
905
1154
 
906
1155
  &nbsp;<br> &nbsp;<br/>
907
1156
  ## disconnectnode
@@ -961,6 +1210,20 @@ Examples:
961
1210
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "distributereward", "params": ["TRONCO" 34987 "DIVIDENDS" 100000] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
962
1211
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "distributereward", "params": ["PHATSTACKS" 34987 "XNA" 100000 "mwN7xC3yomYdvJuVXkVC7ymY9wNBjWNduD,n4Rf18edydDaRBh7t6gHUbuByLbWEoWUTg"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
963
1212
 
1213
+ &nbsp;<br> &nbsp;<br/>
1214
+ ## dumpextkeypq
1215
+ &nbsp;<br/> dumpextkeypq
1216
+
1217
+ Returns the master PQ extended private key (xpqpriv) for this wallet.
1218
+ WARNING: exposes the master secret — keep it safe.
1219
+
1220
+ Result:
1221
+ "xpqpriv..." (string) Base58Check-encoded master CExtKeyPQ
1222
+
1223
+ Examples:
1224
+ > neurai-cli dumpextkeypq
1225
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "dumpextkeypq", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
1226
+
964
1227
  &nbsp;<br> &nbsp;<br/>
965
1228
  ## dumpprivkey
966
1229
  &nbsp;<br/> dumpprivkey "address"
@@ -1087,10 +1350,31 @@ have been observed to make an estimate for any number of blocks.
1087
1350
  Example:
1088
1351
  > neurai-cli estimatesmartfee 6
1089
1352
 
1353
+ &nbsp;<br> &nbsp;<br/>
1354
+ ## exportxpqpub
1355
+ &nbsp;<br/> exportxpqpub count ( chain offset )
1356
+
1357
+ Generates a batch of count ML-DSA-44 public keys and returns the xpqpub blob.
1358
+
1359
+ Arguments:
1360
+ 1. count (numeric, required) Number of pubkeys to generate (max 1000)
1361
+ 2. chain (numeric, optional, default=0) Chain index (0=external, 1=change)
1362
+ 3. offset (numeric, optional, default=0) Starting index
1363
+
1364
+ Result:
1365
+ "hex" (string) Hex-encoded xpqpub binary blob
1366
+
1367
+ Examples:
1368
+ > neurai-cli exportxpqpub 20
1369
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "exportxpqpub", "params": [20, 0, 0] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
1370
+
1090
1371
  &nbsp;<br> &nbsp;<br/>
1091
1372
  ## freezeaddress
1092
1373
  &nbsp;<br/> freezeaddress asset_name address (change_address) (asset_data)
1093
1374
 
1375
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
1376
+
1377
+
1094
1378
  Freeze an address from transferring a restricted asset
1095
1379
 
1096
1380
  Arguments:
@@ -1112,14 +1396,17 @@ Examples:
1112
1396
  ## freezedepin
1113
1397
  &nbsp;<br/> freezedepin "asset_name" "address" ("change_address")
1114
1398
 
1115
- Freeze a dedicated DePIN asset for a specific address (owner only)
1399
+ THIS COMMAND IS NOT YET ACTIVE!
1400
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
1401
+
1402
+ Freeze a DEPIN asset for a specific address (owner only)
1116
1403
 
1117
1404
  The address will still hold the asset but it will be marked as invalid
1118
1405
 
1119
- Requires the owner token for the DePIN asset (for example, '&FRANCE!' for '&FRANCE') in the wallet
1406
+ Requires the owner token (&ASSET!) in the wallet
1120
1407
 
1121
1408
  Arguments:
1122
- 1. "asset_name" (string, required) The DePIN asset name
1409
+ 1. "asset_name" (string, required) The DEPIN asset name (must start with &)
1123
1410
  2. "address" (string, required) The address to freeze
1124
1411
  3. "change_address" (string, optional) The change address for the owner token
1125
1412
 
@@ -1128,12 +1415,15 @@ Result:
1128
1415
 
1129
1416
  Examples:
1130
1417
  > neurai-cli freezedepin "&FRANCE" "address"
1131
- > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "freezedepin", "params": ["&FRANCE", "address"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
1418
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "freezedepin", "params": ["&FRANCE" "address"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
1132
1419
 
1133
1420
  &nbsp;<br> &nbsp;<br/>
1134
1421
  ## freezerestrictedasset
1135
1422
  &nbsp;<br/> freezerestrictedasset asset_name (change_address) (asset_data)
1136
1423
 
1424
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
1425
+
1426
+
1137
1427
  Freeze all trading for a specific restricted asset
1138
1428
 
1139
1429
  Arguments:
@@ -1363,7 +1653,7 @@ Arguments:
1363
1653
  "start" (number) The start block height
1364
1654
  "end" (number) The end block height
1365
1655
  "chainInfo" (boolean) Include chain info in results, only applies if start and end specified
1366
- "assetName" (string, optional) Get deltas for a particular asset instead of XNA.
1656
+ "assetName" (string, optional) Get deltas for a particular asset instead of XNA ('*' for all assets).
1367
1657
  }
1368
1658
 
1369
1659
  Result:
@@ -1509,6 +1799,9 @@ Examples:
1509
1799
  ## getassetdata
1510
1800
  &nbsp;<br/> getassetdata "asset_name"
1511
1801
 
1802
+ THIS COMMAND IS NOT YET ACTIVE!
1803
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
1804
+
1512
1805
  Returns assets metadata if that asset exists
1513
1806
 
1514
1807
  Arguments:
@@ -1864,6 +2157,9 @@ Examples:
1864
2157
  ## getcacheinfo
1865
2158
  &nbsp;<br/> getcacheinfo
1866
2159
 
2160
+ THIS COMMAND IS NOT YET ACTIVE!
2161
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
2162
+
1867
2163
  Result:
1868
2164
  [
1869
2165
  uxto cache size:
@@ -2057,6 +2353,8 @@ Result:
2057
2353
  "bip32_root_private" : (string) extended master private key,
2058
2354
  "bip32_root_public" : (string) extended master public key,
2059
2355
  "account_derivation_path" : (string) The derivation path to the account public/private keys
2356
+ "external_derivation_path" : (string) The derivation path prefix for receiving addresses
2357
+ "internal_derivation_path" : (string) The derivation path prefix for change addresses
2060
2358
  "account_extended_private_key" : (string) extended account private key,
2061
2359
  "account_extended_public_key" : (string) extended account public key,
2062
2360
  }
@@ -2436,8 +2734,8 @@ Result:
2436
2734
  {
2437
2735
  "address": "address", (string) The Neurai address
2438
2736
  "pubkey": "hex", (string) The public key in hex format
2439
- "revealed": true|false, (boolean) Whether the public key has been revealed
2440
- "height": n, (numeric) Block height where it was revealed
2737
+ "revealed": true|false, (boolean) Whether the public key has been revealed
2738
+ "height": n, (numeric) Block height where it was revealed
2441
2739
  "txid": "hash" (string) Transaction ID where it was revealed
2442
2740
  }
2443
2741
 
@@ -2647,6 +2945,9 @@ Result:
2647
2945
  ## getsnapshot
2648
2946
  &nbsp;<br/> getsnapshot "asset_name" block_height
2649
2947
 
2948
+ THIS COMMAND IS NOT YET ACTIVE!
2949
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
2950
+
2650
2951
  Returns details for the asset snapshot, at the specified height
2651
2952
 
2652
2953
  Arguments:
@@ -2862,6 +3163,9 @@ Returns the server's total unconfirmed balance
2862
3163
  ## getverifierstring
2863
3164
  &nbsp;<br/> getverifierstring restricted_name
2864
3165
 
3166
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
3167
+
3168
+
2865
3169
  Retrieve the verifier string that belongs to the given restricted asset
2866
3170
 
2867
3171
  Arguments:
@@ -3067,12 +3371,14 @@ Import using the json rpc call
3067
3371
  ## issue
3068
3372
  &nbsp;<br/> issue "asset_name" qty "( to_address )" "( change_address )" ( units ) ( reissuable ) ( has_ipfs ) "( ipfs_hash )"
3069
3373
 
3374
+ THIS COMMAND IS NOT YET ACTIVE!
3375
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3376
+
3070
3377
  Issue an asset, subasset or unique asset.
3071
3378
  Asset name must not conflict with any existing asset.
3072
3379
  Unit as the number of decimals precision for the asset (0 for whole units ("1"), 8 for max precision ("1.00000000")
3073
3380
  Reissuable is true/false for whether additional units can be issued by the original issuer.
3074
3381
  If issuing a unique asset these values are required (and will be defaulted to): qty=1, units=0, reissuable=false.
3075
- Dedicated DePIN assets (name starts with '&') are documented here as enabled for mainnet and testnet, with qty > 0 and units=0.
3076
3382
 
3077
3383
  Arguments:
3078
3384
  1. "asset_name" (string, required) a unique name
@@ -3100,6 +3406,9 @@ Examples:
3100
3406
  ## issuequalifierasset
3101
3407
  &nbsp;<br/> issuequalifierasset "asset_name" qty "( to_address )" "( change_address )" ( has_ipfs ) "( ipfs_hash )"
3102
3408
 
3409
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
3410
+
3411
+
3103
3412
  Issue an qualifier or sub qualifier asset
3104
3413
  If the '#' character isn't added, it will be added automatically
3105
3414
  Amount is a number between 1 and 10
@@ -3131,6 +3440,9 @@ Examples:
3131
3440
  ## issuerestrictedasset
3132
3441
  &nbsp;<br/> issuerestrictedasset "asset_name" qty "verifier" "to_address" "( change_address )" (units) ( reissuable ) ( has_ipfs ) "( ipfs_hash )"
3133
3442
 
3443
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
3444
+
3445
+
3134
3446
  Issue a restricted asset.
3135
3447
  Restricted asset names must not conflict with any existing restricted asset.
3136
3448
  Restricted assets have units set to 0.
@@ -3161,6 +3473,9 @@ Examples:
3161
3473
  ## issueunique
3162
3474
  &nbsp;<br/> issueunique "root_name" [asset_tags] ( [ipfs_hashes] ) "( to_address )" "( change_address )"
3163
3475
 
3476
+ THIS COMMAND IS NOT YET ACTIVE!
3477
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3478
+
3164
3479
  Issue unique asset(s).
3165
3480
  root_name must be an asset you own.
3166
3481
  An asset will be created for each element of asset_tags.
@@ -3185,6 +3500,9 @@ Examples:
3185
3500
  ## isvalidverifierstring
3186
3501
  &nbsp;<br/> isvalidverifierstring verifier_string
3187
3502
 
3503
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
3504
+
3505
+
3188
3506
  Checks to see if the given verifier string is valid
3189
3507
 
3190
3508
  Arguments:
@@ -3244,6 +3562,9 @@ As json rpc call
3244
3562
  ## listaddressesbyasset
3245
3563
  &nbsp;<br/> listaddressesbyasset "asset_name" (onlytotal) (count) (start)
3246
3564
 
3565
+ THIS COMMAND IS NOT YET ACTIVE!
3566
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3567
+
3247
3568
  Returns a list of all address that own the given asset (with balances)
3248
3569
  Or returns the total size of how many address own the given asset
3249
3570
  Arguments:
@@ -3266,6 +3587,9 @@ Examples:
3266
3587
  ## listaddressesfortag
3267
3588
  &nbsp;<br/> listaddressesfortag tag_name
3268
3589
 
3590
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
3591
+
3592
+
3269
3593
  List all addresses that have been assigned a given tag
3270
3594
 
3271
3595
  Arguments:
@@ -3309,6 +3633,9 @@ Examples:
3309
3633
  ## listaddressrestrictions
3310
3634
  &nbsp;<br/> listaddressrestrictions address
3311
3635
 
3636
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
3637
+
3638
+
3312
3639
  List all assets that have frozen this address
3313
3640
 
3314
3641
  Arguments:
@@ -3327,6 +3654,9 @@ Examples:
3327
3654
  ## listassetbalancesbyaddress
3328
3655
  &nbsp;<br/> listassetbalancesbyaddress "address" (onlytotal) (count) (start)
3329
3656
 
3657
+ THIS COMMAND IS NOT YET ACTIVE!
3658
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3659
+
3330
3660
  Returns a list of all asset balances for an address.
3331
3661
 
3332
3662
  Arguments:
@@ -3350,6 +3680,9 @@ Examples:
3350
3680
  ## listassets
3351
3681
  &nbsp;<br/> listassets "( asset )" ( verbose ) ( count ) ( start )
3352
3682
 
3683
+ THIS COMMAND IS NOT YET ACTIVE!
3684
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3685
+
3353
3686
  Returns a list of all assets
3354
3687
 
3355
3688
  This could be a slow/expensive operation as it reads from the database
@@ -3399,43 +3732,50 @@ Examples:
3399
3732
  ## listdepinaddresses
3400
3733
  &nbsp;<br/> listdepinaddresses "asset_name" (count) (start)
3401
3734
 
3402
- Returns a list of addresses that own the given asset and have a revealed public key on-chain.
3403
- Useful for DePIN messaging recipient discovery. Requires -assetindex and -pubkeyindex.
3735
+ THIS COMMAND IS NOT YET ACTIVE!
3736
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3737
+
3738
+ Returns a list of addresses that own the given asset AND have a revealed public key on the blockchain.
3739
+ This is useful for DePIN messaging systems where only addresses with revealed public keys can participate.
3404
3740
 
3405
3741
  Arguments:
3406
- 1. "asset_name" (string, required) name of asset
3407
- 2. "count" (integer, optional, default=50000, MAX=50000) truncates results to include only the first _count_ addresses found
3408
- 3. "start" (integer, optional, default=0) results skip over the first _start_ addresses found (if negative it skips back from the end)
3742
+ 1. "asset_name" (string, required) name of asset
3743
+ 2. "count" (integer, optional, default=50000, MAX=50000) truncates results to include only the first _count_ addresses found
3744
+ 3. "start" (integer, optional, default=0) results skip over the first _start_ addresses found (if negative it skips back from the end)
3409
3745
 
3410
3746
  Result:
3411
3747
  [
3412
3748
  {
3413
- "address": "address", (string) The address
3414
- "pubkey": "pubkey_hex" (string) The revealed public key in hex
3749
+ "address": "address", (string) The Neurai address
3750
+ "pubkey": "pubkey_hex" (string) The public key in hex format
3415
3751
  },
3416
3752
  ...
3417
3753
  ]
3418
3754
 
3419
3755
  Examples:
3420
- > neurai-cli listdepinaddresses "&FRANCE"
3421
- > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listdepinaddresses", "params": ["&FRANCE"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
3756
+ > neurai-cli listdepinaddresses "ASSET_NAME"
3757
+ > neurai-cli listdepinaddresses "ASSET_NAME" 10 0
3758
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listdepinaddresses", "params": ["ASSET_NAME"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
3422
3759
 
3423
3760
  &nbsp;<br> &nbsp;<br/>
3424
3761
  ## listdepinholders
3425
3762
  &nbsp;<br/> listdepinholders "asset_name"
3426
3763
 
3427
- Returns all addresses holding a dedicated DePIN asset with validity status
3764
+ THIS COMMAND IS NOT YET ACTIVE!
3765
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3766
+
3767
+ Returns all addresses holding a DEPIN asset with validity status
3428
3768
 
3429
- Dedicated DePIN assets are soulbound and can be frozen/revoked. They currently use the '&' prefix.
3769
+ DEPIN assets are soulbound (non-transferable except by owner) and can be frozen/revoked
3430
3770
 
3431
3771
  Arguments:
3432
- 1. "asset_name" (string, required) The DePIN asset name
3772
+ 1. "asset_name" (string, required) The DEPIN asset name (must start with &)
3433
3773
 
3434
3774
  Result:
3435
3775
  [
3436
3776
  {
3437
3777
  "address": "address", (string) The address
3438
- "amount": n, (numeric) The amount held
3778
+ "amount": n, (numeric) The amount held at the address
3439
3779
  "valid": 1|0 (numeric) 1 = active/valid, 0 = blocked/revoked
3440
3780
  },
3441
3781
  ...
@@ -3449,6 +3789,9 @@ Examples:
3449
3789
  ## listglobalrestrictions
3450
3790
  &nbsp;<br/> listglobalrestrictions
3451
3791
 
3792
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
3793
+
3794
+
3452
3795
  List all global restricted assets
3453
3796
 
3454
3797
  Result:
@@ -3497,6 +3840,9 @@ As a json rpc call
3497
3840
  ## listmyassets
3498
3841
  &nbsp;<br/> listmyassets "( asset )" ( verbose ) ( count ) ( start ) (confs)
3499
3842
 
3843
+ THIS COMMAND IS NOT YET ACTIVE!
3844
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3845
+
3500
3846
  Returns a list of all asset that are owned by this wallet
3501
3847
 
3502
3848
  Arguments:
@@ -3540,16 +3886,16 @@ Examples:
3540
3886
  ## listpqaddresses
3541
3887
  &nbsp;<br/> listpqaddresses
3542
3888
 
3543
- Returns post-quantum (ML-DSA-44) Bech32m addresses in the wallet.
3889
+ Returns the list of post-quantum (ML-DSA-44) Bech32m addresses in the wallet.
3544
3890
 
3545
3891
  Result:
3546
- [
3547
- "nq1...", (string) A post-quantum wallet address
3892
+ [ (json array of strings)
3893
+ "address" (string) A post-quantum Bech32m address (nq1...)
3548
3894
  ...
3549
3895
  ]
3550
3896
 
3551
3897
  Examples:
3552
- > neurai-cli listpqaddresses
3898
+ > neurai-cli listpqaddresses
3553
3899
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listpqaddresses", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
3554
3900
 
3555
3901
  &nbsp;<br> &nbsp;<br/>
@@ -3691,6 +4037,9 @@ Examples:
3691
4037
  ## listtagsforaddress
3692
4038
  &nbsp;<br/> listtagsforaddress address
3693
4039
 
4040
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
4041
+
4042
+
3694
4043
  List all tags assigned to an address
3695
4044
 
3696
4045
  Arguments:
@@ -3996,6 +4345,9 @@ Examples:
3996
4345
  ## purgesnapshot
3997
4346
  &nbsp;<br/> purgesnapshot "asset_name" block_height
3998
4347
 
4348
+ THIS COMMAND IS NOT YET ACTIVE!
4349
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
4350
+
3999
4351
  Removes details for the asset snapshot, at the specified height
4000
4352
 
4001
4353
  Arguments:
@@ -4016,10 +4368,12 @@ Examples:
4016
4368
  ## reissue
4017
4369
  &nbsp;<br/> reissue "asset_name" qty "to_address" "change_address" ( reissuable ) ( new_units) "( new_ipfs )"
4018
4370
 
4371
+ THIS COMMAND IS NOT YET ACTIVE!
4372
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
4373
+
4019
4374
  Reissues a quantity of an asset to an owned address if you own the Owner Token
4020
4375
  Can change the reissuable flag during reissuance
4021
4376
  Can change the ipfs hash during reissuance
4022
- For dedicated DePIN assets (name starts with '&'), qty must stay positive and units must remain 0.
4023
4377
  Arguments:
4024
4378
  1. "asset_name" (string, required) name of asset that is being reissued
4025
4379
  2. "qty" (numeric, required) number of assets to reissue
@@ -4040,6 +4394,9 @@ Examples:
4040
4394
  ## reissuerestrictedasset
4041
4395
  &nbsp;<br/> reissuerestrictedasset "asset_name" qty to_address ( change_verifier ) ( "new_verifier" ) "( change_address )" ( new_units ) ( reissuable ) "( new_ipfs )"
4042
4396
 
4397
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
4398
+
4399
+
4043
4400
  Reissue an already created restricted asset
4044
4401
  Reissuable is true/false for whether additional asset quantity can be created and if the verifier string can be changed
4045
4402
 
@@ -4083,6 +4440,9 @@ As a JSON-RPC call
4083
4440
  ## removetagfromaddress
4084
4441
  &nbsp;<br/> removetagfromaddress tag_name to_address (change_address) (asset_data)
4085
4442
 
4443
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
4444
+
4445
+
4086
4446
  Remove a tag from a address
4087
4447
 
4088
4448
  Arguments:
@@ -4153,14 +4513,29 @@ Examples:
4153
4513
  ## selfrevokedepin
4154
4514
  &nbsp;<br/> selfrevokedepin "asset_name"
4155
4515
 
4156
- Self-revoke a dedicated DePIN asset held in this wallet
4516
+ THIS COMMAND IS NOT YET ACTIVE!
4517
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
4518
+
4519
+ Self-revoke a DEPIN asset held in this wallet
4520
+
4521
+ Builds a self-transfer: one UTXO of the asset is spent and returned to its own
4522
+
4523
+ address together with the revocation marker. Spending that UTXO is the proof of
4524
+
4525
+ ownership, so the address needs no XNA of its own; the fee is paid by the wallet.
4157
4526
 
4158
4527
  The asset will be marked as invalid but will remain in the address
4159
4528
 
4160
- This action can only be undone by the asset owner
4529
+ This action can only be undone by the asset owner (unfreezedepin). If the
4530
+
4531
+ revoked address also held the owner token, the owner must first move the owner
4532
+
4533
+ token to another address and then unfreeze; this wallet refuses to auto-pick
4534
+
4535
+ that address for exactly that reason.
4161
4536
 
4162
4537
  Arguments:
4163
- 1. "asset_name" (string, required) The DePIN asset name
4538
+ 1. "asset_name" (string, required) The DEPIN asset name (must start with &)
4164
4539
 
4165
4540
  Result:
4166
4541
  "txid" (string) The transaction id
@@ -4286,6 +4661,9 @@ As a json rpc call
4286
4661
  ## sendmessage
4287
4662
  &nbsp;<br/> sendmessage "channel_name" "ipfs_hash" (expire_time)
4288
4663
 
4664
+ THIS COMMAND IS NOT YET ACTIVE!
4665
+ https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
4666
+
4289
4667
  Creates and broadcasts a message transaction to the network for a channel this wallet owns
4290
4668
  Arguments:
4291
4669
  1. "channel_name" (string, required) Name of the channel that you want to send a message with (message channel, administrator asset), if a non administrator asset name is given, the administrator '!' will be added to it
@@ -4553,13 +4931,14 @@ Examples:
4553
4931
  ## stop
4554
4932
  &nbsp;<br/> stop
4555
4933
 
4556
- Stop Neurai server.
4934
+ Stop Neurai server.
4935
+
4557
4936
  &nbsp;<br> &nbsp;<br/>
4558
4937
  ## submitblock
4559
4938
  &nbsp;<br/> submitblock "hexdata" ( "dummy" )
4560
4939
 
4561
4940
  Attempts to submit new block to network.
4562
- See https://en.neurai.it/wiki/BIP_0022 for full specification.
4941
+ See https://en.bitcoin.it/wiki/BIP_0022 for full specification.
4563
4942
 
4564
4943
  Arguments
4565
4944
  1. "hexdata" (string, required) the hex-encoded block data to submit
@@ -4575,6 +4954,9 @@ Examples:
4575
4954
  ## subscribetochannel
4576
4955
  &nbsp;<br/> subscribetochannel
4577
4956
 
4957
+ THIS COMMAND IS NOT YET ACTIVE!
4958
+ https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
4959
+
4578
4960
  Subscribe to a certain message channel
4579
4961
 
4580
4962
  Arguments:
@@ -4630,6 +5012,9 @@ As a json rpc call
4630
5012
  ## transfer
4631
5013
  &nbsp;<br/> transfer "asset_name" qty "to_address" "message" expire_time "change_address" "asset_change_address"
4632
5014
 
5015
+ THIS COMMAND IS NOT YET ACTIVE!
5016
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
5017
+
4633
5018
  Transfers a quantity of an owned asset to a given address
4634
5019
  Arguments:
4635
5020
  1. "asset_name" (string, required) name of asset
@@ -4653,6 +5038,9 @@ Examples:
4653
5038
  ## transferfromaddress
4654
5039
  &nbsp;<br/> transferfromaddress "asset_name" "from_address" qty "to_address" "message" expire_time "xna_change_address" "asset_change_address"
4655
5040
 
5041
+ THIS COMMAND IS NOT YET ACTIVE!
5042
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
5043
+
4656
5044
  Transfer a quantity of an owned asset in a specific address to a given address
4657
5045
  Arguments:
4658
5046
  1. "asset_name" (string, required) name of asset
@@ -4677,6 +5065,9 @@ Examples:
4677
5065
  ## transferfromaddresses
4678
5066
  &nbsp;<br/> transferfromaddresses "asset_name" ["from_addresses"] qty "to_address" "message" expire_time "xna_change_address" "asset_change_address"
4679
5067
 
5068
+ THIS COMMAND IS NOT YET ACTIVE!
5069
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
5070
+
4680
5071
  Transfer a quantity of an owned asset in specific address(es) to a given address
4681
5072
  Arguments:
4682
5073
  1. "asset_name" (string, required) name of asset
@@ -4701,6 +5092,9 @@ Examples:
4701
5092
  ## transferqualifier
4702
5093
  &nbsp;<br/> transferqualifier "qualifier_name" qty "to_address" ("change_address") ("message") (expire_time)
4703
5094
 
5095
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
5096
+
5097
+
4704
5098
  Transfer a qualifier asset owned by this wallet to the given address
4705
5099
  Arguments:
4706
5100
  1. "qualifier_name" (string, required) name of qualifier asset
@@ -4723,6 +5117,9 @@ Examples:
4723
5117
  ## unfreezeaddress
4724
5118
  &nbsp;<br/> unfreezeaddress asset_name address (change_address) (asset_data)
4725
5119
 
5120
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
5121
+
5122
+
4726
5123
  Unfreeze an address from transferring a restricted asset
4727
5124
 
4728
5125
  Arguments:
@@ -4744,14 +5141,17 @@ Examples:
4744
5141
  ## unfreezedepin
4745
5142
  &nbsp;<br/> unfreezedepin "asset_name" "address" ("change_address")
4746
5143
 
4747
- Unfreeze a dedicated DePIN asset for a specific address (owner only)
5144
+ THIS COMMAND IS NOT YET ACTIVE!
5145
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
5146
+
5147
+ Unfreeze a DEPIN asset for a specific address (owner only)
4748
5148
 
4749
5149
  The asset will be marked as valid again
4750
5150
 
4751
- Requires the owner token for the DePIN asset (for example, '&FRANCE!' for '&FRANCE') in the wallet
5151
+ Requires the owner token (&ASSET!) in the wallet
4752
5152
 
4753
5153
  Arguments:
4754
- 1. "asset_name" (string, required) The DePIN asset name
5154
+ 1. "asset_name" (string, required) The DEPIN asset name (must start with &)
4755
5155
  2. "address" (string, required) The address to unfreeze
4756
5156
  3. "change_address" (string, optional) The change address for the owner token
4757
5157
 
@@ -4760,12 +5160,15 @@ Result:
4760
5160
 
4761
5161
  Examples:
4762
5162
  > neurai-cli unfreezedepin "&FRANCE" "address"
4763
- > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "unfreezedepin", "params": ["&FRANCE", "address"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
5163
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "unfreezedepin", "params": ["&FRANCE" "address"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
4764
5164
 
4765
5165
  &nbsp;<br> &nbsp;<br/>
4766
5166
  ## unfreezerestrictedasset
4767
5167
  &nbsp;<br/> unfreezerestrictedasset asset_name (change_address) (asset_data)
4768
5168
 
5169
+ THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
5170
+
5171
+
4769
5172
  Unfreeze all trading for a specific restricted asset
4770
5173
 
4771
5174
  Arguments:
@@ -4786,6 +5189,9 @@ Examples:
4786
5189
  ## unsubscribefromchannel
4787
5190
  &nbsp;<br/> unsubscribefromchannel
4788
5191
 
5192
+ THIS COMMAND IS NOT YET ACTIVE!
5193
+ https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
5194
+
4789
5195
  Unsubscribe from a certain message channel
4790
5196
 
4791
5197
  Arguments:
@@ -4911,6 +5317,9 @@ Result:
4911
5317
  ## viewallmessagechannels
4912
5318
  &nbsp;<br/> viewallmessagechannels
4913
5319
 
5320
+ THIS COMMAND IS NOT YET ACTIVE!
5321
+ https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
5322
+
4914
5323
  View all message channels the wallet is subscribed to
4915
5324
 
4916
5325
  Result:[
@@ -4926,6 +5335,9 @@ Examples:
4926
5335
  ## viewallmessages
4927
5336
  &nbsp;<br/> viewallmessages
4928
5337
 
5338
+ THIS COMMAND IS NOT YET ACTIVE!
5339
+ https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
5340
+
4929
5341
  View all messages that the wallet contains
4930
5342
 
4931
5343
  Result:
@@ -4945,6 +5357,9 @@ Examples:
4945
5357
  ## viewmyrestrictedaddresses
4946
5358
  &nbsp;<br/> viewmyrestrictedaddresses
4947
5359
 
5360
+ THIS COMMAND IS NOT YET ACTIVE!
5361
+ https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
5362
+
4948
5363
  View all addresses this wallet owns that have been restricted
4949
5364
 
4950
5365
  Result:
@@ -4963,6 +5378,9 @@ Examples:
4963
5378
  ## viewmytaggedaddresses
4964
5379
  &nbsp;<br/> viewmytaggedaddresses
4965
5380
 
5381
+ THIS COMMAND IS NOT YET ACTIVE!
5382
+ https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
5383
+
4966
5384
  View all addresses this wallet owns that have been tagged
4967
5385
 
4968
5386
  Result: