@neuraiproject/neurai-rpc 0.7.0 → 0.9.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
@@ -1,7 +1,7 @@
1
- # Neurai remote procedure calls/methods
2
- [Home](README.md)
3
- &nbsp;<br> &nbsp;<br/>
4
- ## abandontransaction
1
+ # Neurai remote procedure calls/methods
2
+ [Home](README.md)
3
+ &nbsp;<br> &nbsp;<br/>
4
+ ## abandontransaction
5
5
  &nbsp;<br/> abandontransaction "txid"
6
6
 
7
7
  Mark in-wallet transaction <txid> as abandoned
@@ -18,9 +18,9 @@ Result:
18
18
  Examples:
19
19
  > neurai-cli abandontransaction "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"
20
20
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "abandontransaction", "params": ["1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
21
-
22
- &nbsp;<br> &nbsp;<br/>
23
- ## abortrescan
21
+
22
+ &nbsp;<br> &nbsp;<br/>
23
+ ## abortrescan
24
24
  &nbsp;<br/> abortrescan
25
25
 
26
26
  Stops current wallet rescan triggered e.g. by an importprivkey call.
@@ -31,13 +31,13 @@ Import a private key
31
31
  > neurai-cli importprivkey "mykey"
32
32
 
33
33
  Abort the running wallet rescan
34
- > neurai-cli abortrescan
34
+ > neurai-cli abortrescan
35
35
 
36
36
  As a JSON-RPC call
37
37
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "abortrescan", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
38
-
39
- &nbsp;<br> &nbsp;<br/>
40
- ## addmultisigaddress
38
+
39
+ &nbsp;<br> &nbsp;<br/>
40
+ ## addmultisigaddress
41
41
  &nbsp;<br/> addmultisigaddress nrequired ["key",...] ( "account" )
42
42
 
43
43
  Add a nrequired-to-sign multisignature address to the wallet.
@@ -63,9 +63,9 @@ Add a multisig address from 2 addresses
63
63
 
64
64
  As json rpc call
65
65
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "addmultisigaddress", "params": [2, "[\"16sSauSf5pF2UkUwvKGq4qjNRzBZYqgEL5\",\"171sgjn4YtPu27adkKGrdDwzRTxnRkBfKV\"]"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
66
-
67
- &nbsp;<br> &nbsp;<br/>
68
- ## addnode
66
+
67
+ &nbsp;<br> &nbsp;<br/>
68
+ ## addnode
69
69
  &nbsp;<br/> addnode "node" "add|remove|onetry"
70
70
 
71
71
  Attempts to add or remove a node from the addnode list.
@@ -80,9 +80,9 @@ Arguments:
80
80
  Examples:
81
81
  > neurai-cli addnode "192.168.0.6:19000" "onetry"
82
82
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "addnode", "params": ["192.168.0.6:19000", "onetry"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
83
-
84
- &nbsp;<br> &nbsp;<br/>
85
- ## addtagtoaddress
83
+
84
+ &nbsp;<br> &nbsp;<br/>
85
+ ## addtagtoaddress
86
86
  &nbsp;<br/> addtagtoaddress tag_name to_address (change_address) (asset_data)
87
87
 
88
88
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -104,9 +104,9 @@ Examples:
104
104
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "addtagtoaddress", "params": ["#TAG" "to_address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
105
105
  > neurai-cli addtagtoaddress "#TAG" "to_address" "change_address"
106
106
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "addtagtoaddress", "params": ["#TAG" "to_address" "change_address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
107
-
108
- &nbsp;<br> &nbsp;<br/>
109
- ## addwitnessaddress
107
+
108
+ &nbsp;<br> &nbsp;<br/>
109
+ ## addwitnessaddress
110
110
  &nbsp;<br/> addwitnessaddress "address"
111
111
 
112
112
  Add a witness address for a script (with pubkey or redeemscript known).
@@ -118,9 +118,9 @@ Arguments:
118
118
  Result:
119
119
  "witnessaddress", (string) The value of the new address (P2SH of witness script).
120
120
  }
121
-
122
- &nbsp;<br> &nbsp;<br/>
123
- ## backupwallet
121
+
122
+ &nbsp;<br> &nbsp;<br/>
123
+ ## backupwallet
124
124
  &nbsp;<br/> backupwallet "destination"
125
125
 
126
126
  Safely copies current wallet file to destination, which can be a directory or a path with filename.
@@ -131,13 +131,9 @@ Arguments:
131
131
  Examples:
132
132
  > neurai-cli backupwallet "backup.dat"
133
133
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "backupwallet", "params": ["backup.dat"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
134
-
135
- &nbsp;<br> &nbsp;<br/>
136
- ## bumpfee
137
- &nbsp;<br/> bumpfee has been deprecated on the XNA Wallet.
138
-
139
- &nbsp;<br> &nbsp;<br/>
140
- ## cancelsnapshotrequest
134
+
135
+ &nbsp;<br> &nbsp;<br/>
136
+ ## cancelsnapshotrequest
141
137
  &nbsp;<br/> cancelsnapshotrequest "asset_name" block_height
142
138
 
143
139
  Cancels the specified snapshot request.
@@ -154,9 +150,9 @@ Result:
154
150
  Examples:
155
151
  > neurai-cli cancelsnapshotrequest "TRONCO" 12345
156
152
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "cancelsnapshotrequest", "params": ["PHATSTACKS" 34987] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
157
-
158
- &nbsp;<br> &nbsp;<br/>
159
- ## checkaddressrestriction
153
+
154
+ &nbsp;<br> &nbsp;<br/>
155
+ ## checkaddressrestriction
160
156
  &nbsp;<br/> checkaddressrestriction address restricted_name
161
157
 
162
158
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -174,9 +170,9 @@ Result:
174
170
  Examples:
175
171
  > neurai-cli checkaddressrestriction "address" "restricted_name"
176
172
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "checkaddressrestriction", "params": ["address" "restricted_name"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
177
-
178
- &nbsp;<br> &nbsp;<br/>
179
- ## checkaddresstag
173
+
174
+ &nbsp;<br> &nbsp;<br/>
175
+ ## checkaddresstag
180
176
  &nbsp;<br/> checkaddresstag address tag_name
181
177
 
182
178
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -194,9 +190,9 @@ Result:
194
190
  Examples:
195
191
  > neurai-cli checkaddresstag "address" "tag_name"
196
192
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "checkaddresstag", "params": ["address" "tag_name"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
197
-
198
- &nbsp;<br> &nbsp;<br/>
199
- ## checkdepinvalidity
193
+
194
+ &nbsp;<br> &nbsp;<br/>
195
+ ## checkdepinvalidity
200
196
  &nbsp;<br/> checkdepinvalidity "asset_name" "address"
201
197
 
202
198
  THIS COMMAND IS NOT YET ACTIVE!
@@ -219,9 +215,9 @@ Result:
219
215
  Examples:
220
216
  > neurai-cli checkdepinvalidity "&FRANCE" "address"
221
217
  > 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:19001/
222
-
223
- &nbsp;<br> &nbsp;<br/>
224
- ## checkglobalrestriction
218
+
219
+ &nbsp;<br> &nbsp;<br/>
220
+ ## checkglobalrestriction
225
221
  &nbsp;<br/> checkglobalrestriction restricted_name
226
222
 
227
223
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -238,30 +234,30 @@ Result:
238
234
  Examples:
239
235
  > neurai-cli checkglobalrestriction "restricted_name"
240
236
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "checkglobalrestriction", "params": ["restricted_name"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
241
-
242
- &nbsp;<br> &nbsp;<br/>
243
- ## clearbanned
237
+
238
+ &nbsp;<br> &nbsp;<br/>
239
+ ## clearbanned
244
240
  &nbsp;<br/> clearbanned
245
241
 
246
242
  Clear all banned IPs.
247
243
 
248
244
  Examples:
249
- > neurai-cli clearbanned
245
+ > neurai-cli clearbanned
250
246
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "clearbanned", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
251
-
252
- &nbsp;<br> &nbsp;<br/>
253
- ## clearmempool
247
+
248
+ &nbsp;<br> &nbsp;<br/>
249
+ ## clearmempool
254
250
  &nbsp;<br/> clearmempool
255
251
 
256
252
  Removes all transaction from the mempool
257
253
 
258
254
  Examples:
259
- > neurai-cli clearmempool
255
+ > neurai-cli clearmempool
260
256
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "clearmempool", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
261
-
262
- &nbsp;<br> &nbsp;<br/>
263
- ## clearmessages
264
- &nbsp;<br/> clearmessages
257
+
258
+ &nbsp;<br> &nbsp;<br/>
259
+ ## clearmessages
260
+ &nbsp;<br/> clearmessages
265
261
 
266
262
  THIS COMMAND IS NOT YET ACTIVE!
267
263
  https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
@@ -273,15 +269,38 @@ Result:[
273
269
  ]
274
270
 
275
271
  Examples:
276
- > neurai-cli clearmessages
272
+ > neurai-cli clearmessages
277
273
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "clearmessages", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
278
-
279
- &nbsp;<br> &nbsp;<br/>
280
- ## combinerawtransaction
274
+
275
+ &nbsp;<br> &nbsp;<br/>
276
+ ## closedepin
277
+ &nbsp;<br/> closedepin "asset_name" ("change_address")
278
+
279
+ THIS COMMAND IS NOT YET ACTIVE!
280
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
281
+
282
+ Close transfers of a DEPIN asset (owner only): the asset becomes soulbound
283
+ again and only the owner can move it. Valid from the open state; takes effect
284
+ from the block after the one that confirms it. Pending holder transfers are
285
+ dropped from the mempool when the close confirms.
286
+
287
+ Arguments:
288
+ 1. "asset_name" (string, required) The DEPIN asset name (must start with &)
289
+ 2. "change_address" (string, optional) The change address for the owner token
290
+
291
+ Result:
292
+ "txid" (string) The transaction id
293
+
294
+ Examples:
295
+ > neurai-cli closedepin "&FRANCE"
296
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "closedepin", "params": ["&FRANCE"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
297
+
298
+ &nbsp;<br> &nbsp;<br/>
299
+ ## combinerawtransaction
281
300
  &nbsp;<br/> combinerawtransaction ["hexstring",...]
282
301
 
283
302
  Combine multiple partially signed transactions into one transaction.
284
- The combined transaction may be another partially signed transaction or a
303
+ The combined transaction may be another partially signed transaction or a
285
304
  fully signed transaction.
286
305
  Arguments:
287
306
  1. "txs" (string) A json array of hex strings of partially signed transactions
@@ -295,9 +314,61 @@ Result:
295
314
 
296
315
  Examples:
297
316
  > neurai-cli combinerawtransaction ["myhex1", "myhex2", "myhex3"]
298
-
299
- &nbsp;<br> &nbsp;<br/>
300
- ## createmultisig
317
+
318
+ &nbsp;<br> &nbsp;<br/>
319
+ ## createdistributionbatch
320
+ &nbsp;<br/> createdistributionbatch "plan_hash" {plan} batch_index ( {options} )
321
+
322
+ Builds, funds and signs one batch of a distribution plan from this wallet (NIP-048), and locks the inputs it
323
+ spends. It does NOT broadcast: store the result in your batch records first, then send it with
324
+ sendrawtransaction. The plan must still hash to plan_hash, so a payment is always bound to the plan the
325
+ operator approved.
326
+ To replace a version that left the mempool, build a new one with the same anchor: every version of a batch
327
+ spends the anchor, so at most one of them can confirm.
328
+
329
+ Arguments:
330
+ 1. "plan_hash" (string, required) The approved plan hash, from getdistributionplan
331
+ 2. plan (object, required) The plan parameters
332
+ {
333
+ "asset_name": "name", (string, required) as in getdistributionplan
334
+ "snapshot_height": n, (number, required)
335
+ "distribution_asset_name": "name", (string, required)
336
+ "amount": x.xxx, (numeric, required) gross_distribution_amount
337
+ "exception_addresses": "a,b", (string, optional)
338
+ "remainder": "payer"|"largest", (string, optional, default "payer")
339
+ "allow_legacy_snapshot": bool, (boolean, optional, default false)
340
+ "announcement": {"txid": "hex", "block_hash": "hex"} (object, optional) as in getdistributionplan
341
+ "qualifier": "#TAG", (string, optional) as in getdistributionplan
342
+ "weights": {"address": n, ...}, (object, optional) as in getdistributionplan
343
+ "report": {"txid": "hex", "block_hash": "hex"} (object, optional) as in getdistributionplan
344
+ "allocation": "holdings"|"equal", (string, optional, default "holdings") as in getdistributionplan
345
+ "min_held": x.xxx, (numeric, optional) as in getdistributionplan
346
+ }
347
+ 3. batch_index (number, required) The batch to build, from getdistributionbatches
348
+ 4. options (object, optional)
349
+ {
350
+ "max_outputs": n, (number, default 500) batch size, as in getdistributionbatches
351
+ "anchor": {"txid": "hex", "vout": n}, (object, optional) the anchor of earlier versions of this batch
352
+ "max_fee": x.xxx (numeric, optional) refuse a fee above this amount of XNA
353
+ }
354
+
355
+ Result:
356
+ {
357
+ "plan_hash": "hex",
358
+ "batch_index": n,
359
+ "batch_id": "hex",
360
+ "txid": "hex",
361
+ "hex": "hex", (string) the signed transaction, not broadcast
362
+ "fee": x.xxx,
363
+ "anchor": {"txid": "hex", "vout": n}, (object) the XNA input every later version must spend
364
+ "inputs": [ {"txid": "hex", "vout": n}, ... ] (array) inputs, now locked in this wallet
365
+ }
366
+
367
+ Examples:
368
+ > neurai-cli createdistributionbatch "planhash" '{"asset_name":"TRONCO","snapshot_height":12345,"distribution_asset_name":"XNA","amount":1000}' 0
369
+
370
+ &nbsp;<br> &nbsp;<br/>
371
+ ## createmultisig
301
372
  &nbsp;<br/> createmultisig nrequired ["key",...]
302
373
 
303
374
  Creates a multi-signature address with n signature of m keys required.
@@ -324,9 +395,9 @@ Create a multisig address from 2 addresses
324
395
 
325
396
  As a json rpc call
326
397
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "createmultisig", "params": [2, "[\"16sSauSf5pF2UkUwvKGq4qjNRzBZYqgEL5\",\"171sgjn4YtPu27adkKGrdDwzRTxnRkBfKV\"]"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
327
-
328
- &nbsp;<br> &nbsp;<br/>
329
- ## createrawtransaction
398
+
399
+ &nbsp;<br> &nbsp;<br/>
400
+ ## createrawtransaction
330
401
  &nbsp;<br/> createrawtransaction [{"txid":"id","vout":n},...] {"address":(amount or object),"data":"hex",...}
331
402
  createrawtransaction [{"txid":"id","vout":n},...] [{"address":(amount or object)},{"data":"hex"},...]
332
403
  ( locktime ) ( [{"txid":"id","vout":n},...] )
@@ -357,6 +428,9 @@ Paying for Asset Operations:
357
428
  unfreeze_addresses 0
358
429
  freeze_asset 0
359
430
  unfreeze_asset 0
431
+ open_depin 0
432
+ close_depin 0
433
+ seal_depin 0
360
434
 
361
435
  Assets For Authorization:
362
436
  These operations require a specific asset input for authorization:
@@ -369,6 +443,10 @@ Assets For Authorization:
369
443
  unfreeze_addresses
370
444
  freeze_asset
371
445
  unfreeze_asset
446
+ DEPIN Owner Token (&NAME!):
447
+ open_depin
448
+ close_depin
449
+ seal_depin
372
450
  Root Qualifier Token:
373
451
  issue_qualifier (when issuing subqualifier)
374
452
  Qualifier Token:
@@ -388,8 +466,10 @@ Arguments:
388
466
  {
389
467
  "txid":"id", (string, required) The transaction id
390
468
  "vout":n, (number, required) The output number
391
- "sequence":n (number, optional) The sequence number
392
- }
469
+ "sequence":n (number, optional) The sequence number. Once the no-RBF sequence rule
470
+ applies to the next block it must be 4294967295, 4294967294 or, in a
471
+ version 2 or 3 transaction, a BIP 68 relative lock (bit 31 clear)
472
+ }
393
473
  ,...
394
474
  ]
395
475
  2. "outputs" (object or array, required) outputs in object or ordered-array form
@@ -402,7 +482,7 @@ Arguments:
402
482
  "transfer":
403
483
  {
404
484
  "asset-name": (string, required) asset name
405
- asset-quantity (number, required) the number of raw units to transfer
485
+ asset-quantity (number or string, required) the number of raw units to transfer
406
486
  ,...
407
487
  }
408
488
  }
@@ -412,7 +492,7 @@ Arguments:
412
492
  "transferwithmessage":
413
493
  {
414
494
  "asset-name": (string, required) asset name
415
- asset-quantity, (number, required) the number of raw units to transfer
495
+ asset-quantity, (number or string, required) the number of raw units to transfer
416
496
  "message":"hash", (string, required) ipfs hash or a txid hash
417
497
  "expire_time": n (number, required) utc time in seconds to expire the message
418
498
  }
@@ -422,7 +502,7 @@ Arguments:
422
502
  "issue":
423
503
  {
424
504
  "asset_name":"asset-name", (string, required) new asset name
425
- "asset_quantity":n, (number, required) the number of raw units to issue
505
+ "asset_quantity":n, (number or string, required) the number of raw units to issue
426
506
  "units":[1-8], (number, required) display units, between 1 (integral) to 8 (max precision)
427
507
  "reissuable":[0-1], (number, required) 1=reissuable asset
428
508
  "has_ipfs":[0-1], (number, required) 1=passing ipfs_hash
@@ -433,10 +513,10 @@ Arguments:
433
513
  { (object) A json object describing new unique assets to issue
434
514
  "issue_unique":
435
515
  {
436
- "root_name":"root-name", (string, required) name of the asset the unique asset(s)
516
+ "root_name":"root-name", (string, required) name of the asset the unique asset(s)
437
517
  are being issued under
438
518
  "asset_tags":["asset_tag", ...], (array, required) the unique tag for each asset which is to be issued
439
- "ipfs_hashes":["hash", ...], (array, optional) ipfs hashes corresponding to each supplied tag
519
+ "ipfs_hashes":["hash", ...], (array, optional) ipfs hashes corresponding to each supplied tag
440
520
  (should be same size as "asset_tags")
441
521
  }
442
522
  }
@@ -445,11 +525,12 @@ Arguments:
445
525
  "reissue":
446
526
  {
447
527
  "asset_name":"asset-name", (string, required) name of asset to be reissued
448
- "asset_quantity":n, (number, required) the number of raw units to issue
528
+ "asset_quantity":n, (number or string, required) the number of raw units to issue
449
529
  "reissuable":[0-1], (number, optional) default is 1, 1=reissuable asset
450
- "ipfs_hash":"hash", (string, optional) An ipfs hash for discovering asset metadata,
530
+ "units":[-1-8], (number, optional) default is -1: keep the current units; 0-8 sets new units (never fewer than now)
531
+ "ipfs_hash":"hash", (string, optional) An ipfs hash for discovering asset metadata,
451
532
  Overrides the current ipfs hash if given
452
- "owner_change_address" (string, optional) the address where the owner token will be sent to.
533
+ "owner_change_address" (string, optional) the address where the owner token will be sent to.
453
534
  If not given, it will be sent to the output address
454
535
  }
455
536
  }
@@ -458,14 +539,14 @@ Arguments:
458
539
  "issue_restricted":
459
540
  {
460
541
  "asset_name":"asset-name",(string, required) new asset name
461
- "asset_quantity":n, (number, required) the number of raw units to issue
462
- "verifier_string":"text", (string, required) the verifier string to be used for a restricted
542
+ "asset_quantity":n, (number or string, required) the number of raw units to issue
543
+ "verifier_string":"text", (string, required) the verifier string to be used for a restricted
463
544
  asset transfer verification
464
545
  "units":[0-8], (number, required) display units, between 0 (integral) and 8 (max precision)
465
546
  "reissuable":[0-1], (number, required) 1=reissuable asset
466
547
  "has_ipfs":[0-1], (number, required) 1=passing ipfs_hash
467
548
  "ipfs_hash":"hash", (string, optional) an ipfs hash for discovering asset metadata
468
- "owner_change_address" (string, optional) the address where the owner token will be sent to.
549
+ "owner_change_address" (string, optional) the address where the owner token will be sent to.
469
550
  If not given, it will be sent to the output address
470
551
  }
471
552
  }
@@ -474,13 +555,14 @@ Arguments:
474
555
  "reissue_restricted":
475
556
  {
476
557
  "asset_name":"asset-name", (string, required) name of asset to be reissued
477
- "asset_quantity":n, (number, required) the number of raw units to issue
558
+ "asset_quantity":n, (number or string, required) the number of raw units to issue
478
559
  "reissuable":[0-1], (number, optional) default is 1, 1=reissuable asset
479
- "verifier_string":"text", (string, optional) the verifier string to be used for a restricted asset
560
+ "units":[-1-8], (number, optional) default is -1: keep the current units; 0-8 sets new units (never fewer than now)
561
+ "verifier_string":"text", (string, optional) the verifier string to be used for a restricted asset
480
562
  transfer verification
481
- "ipfs_hash":"hash", (string, optional) An ipfs hash for discovering asset metadata,
563
+ "ipfs_hash":"hash", (string, optional) An ipfs hash for discovering asset metadata,
482
564
  Overrides the current ipfs hash if given
483
- "owner_change_address" (string, optional) the address where the owner token will be sent to.
565
+ "owner_change_address" (string, optional) the address where the owner token will be sent to.
484
566
  If not given, it will be sent to the output address
485
567
  }
486
568
  }
@@ -489,15 +571,15 @@ Arguments:
489
571
  "issue_qualifier":
490
572
  {
491
573
  "asset_name":"asset_name", (string, required) a qualifier name (starts with '#')
492
- "asset_quantity":n, (numeric, optional, default=1) the number of units to be issued (1 to 10)
493
- "has_ipfs":[0-1], (boolean, optional, default=false), whether ifps hash is going
574
+ "asset_quantity":n, (number or string, optional, default=1) the number of units to be issued (1 to 10)
575
+ "has_ipfs":[0-1], (boolean, optional, default=false), whether ifps hash is going
494
576
  to be added to the asset
495
- "ipfs_hash":"hash", (string, optional but required if has_ipfs = 1), an ipfs hash or a
577
+ "ipfs_hash":"hash", (string, optional but required if has_ipfs = 1), an ipfs hash or a
496
578
  txid hash once RIP5 is activated
497
579
  "root_change_address" (string, optional) Only applies when issuing subqualifiers.
498
580
  The address where the root qualifier will be sent.
499
581
  If not specified, it will be sent to the output address.
500
- "change_quantity":"qty" (numeric, optional) the asset change amount (defaults to 1)
582
+ "change_quantity":"qty" (number or string, optional) the asset change amount (defaults to 1)
501
583
  }
502
584
  }
503
585
  or
@@ -507,7 +589,7 @@ Arguments:
507
589
  {
508
590
  "qualifier":"qualifier", (string, required) a qualifier name (starts with '#')
509
591
  "addresses":["addr", ...], (array, required) the addresses to be tagged (up to 10)
510
- "change_quantity":"qty", (numeric, optional) the asset change amount (defaults to 1)
592
+ "change_quantity":"qty", (number or string, optional) the asset change amount (defaults to 1)
511
593
  }
512
594
  }
513
595
  or
@@ -517,7 +599,7 @@ Arguments:
517
599
  {
518
600
  "qualifier":"qualifier", (string, required) a qualifier name (starts with '#')
519
601
  "addresses":["addr", ...], (array, required) the addresses to be untagged (up to 10)
520
- "change_quantity":"qty", (numeric, optional) the asset change amount (defaults to 1)
602
+ "change_quantity":"qty", (number or string, optional) the asset change amount (defaults to 1)
521
603
  }
522
604
  }
523
605
  or
@@ -555,6 +637,14 @@ Arguments:
555
637
  }
556
638
  }
557
639
  or
640
+ { (object) A json object describing a DEPIN transfer state operation.
641
+ The address in the key will be used as the owner token change address.
642
+ "open_depin" | "close_depin" | "seal_depin":
643
+ {
644
+ "asset_name":"asset_name", (string, required) a DEPIN asset name (starts with '&')
645
+ }
646
+ }
647
+ or
558
648
  "data": "hex" (string, required) The key is "data", the value is hex encoded data
559
649
  ,...
560
650
  }
@@ -590,9 +680,9 @@ Examples:
590
680
  > neurai-cli createrawtransaction "[{\"txid\":\"mycoin\",\"vout\":0},{\"txid\":\"myownership\",\"vout\":0}]" "{\"issuer_address\":{\"reissue\":{\"asset_name\":\"MYASSET\",\"asset_quantity\":2000000}}}"
591
681
  > neurai-cli createrawtransaction "[{\"txid\":\"mycoin\",\"vout\":0}]" "[{\"address\":500},{\"address\":{\"issue\":{\"asset_name\":\"MYASSET\",\"asset_quantity\":1000000,\"units\":1,\"reissuable\":0,\"has_ipfs\":0}}}]"
592
682
  > 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:19001/
593
-
594
- &nbsp;<br> &nbsp;<br/>
595
- ## decodeblock
683
+
684
+ &nbsp;<br> &nbsp;<br/>
685
+ ## decodeblock
596
686
  &nbsp;<br/> decodeblock "blockhex"
597
687
 
598
688
  Arguments:
@@ -620,9 +710,9 @@ Result:
620
710
  Examples:
621
711
  > neurai-cli decodeblock "xxxx"
622
712
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "decodeblock", "params": ["xxxx"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
623
-
624
- &nbsp;<br> &nbsp;<br/>
625
- ## decoderawtransaction
713
+
714
+ &nbsp;<br> &nbsp;<br/>
715
+ ## decoderawtransaction
626
716
  &nbsp;<br/> decoderawtransaction "hexstring"
627
717
 
628
718
  Return a JSON object representing the serialized, hex-encoded transaction.
@@ -678,9 +768,9 @@ Result:
678
768
  Examples:
679
769
  > neurai-cli decoderawtransaction "hexstring"
680
770
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "decoderawtransaction", "params": ["hexstring"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
681
-
682
- &nbsp;<br> &nbsp;<br/>
683
- ## decodescript
771
+
772
+ &nbsp;<br> &nbsp;<br/>
773
+ ## decodescript
684
774
  &nbsp;<br/> decodescript "hexstring"
685
775
 
686
776
  Decode a hex-encoded script.
@@ -717,148 +807,79 @@ Result:
717
807
  Examples:
718
808
  > neurai-cli decodescript "hexstring"
719
809
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "decodescript", "params": ["hexstring"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
720
-
721
- &nbsp;<br> &nbsp;<br/>
722
- ## depinchallenge
723
- &nbsp;<br/> depinchallenge "token" "address" timestamp "signature" ( "type" )
724
810
 
725
- Issues a single-use challenge for authenticated DePIN RPCs. The request must be signed over:
726
- "DEPIN-REQ|<type>|<token>|<address>|<timestamp>", where timestamp is Unix time in milliseconds and type is "receive" (default) or "admin".
811
+ &nbsp;<br> &nbsp;<br/>
812
+ ## decodesilentpaymentcode
813
+ &nbsp;<br/> decodesilentpaymentcode "code"
727
814
 
728
- The encrypted result contains challenge, expires_in and type. Decrypt it with depindecrypt, then sign the challenge with depinsignchallenge or signmessage.
815
+ Validates a silent payment code for this network and returns its keys.
729
816
 
730
- Examples:
731
- > neurai-cli depinchallenge "&TOKEN/SECTION" "NXholder..." 1730000000000 "<signature>"
732
-
733
- &nbsp;<br> &nbsp;<br/>
734
- ## depinclearmsg
735
- &nbsp;<br/> depinclearmsg "scope" "address" "challenge" "signature" ( "all" | hours )
736
-
737
- Removes messages from a DePIN pool. This owner-level operation requires an admin challenge issued for the exact scope. Use an empty scope for the pool root. Omit mode to remove expired messages, use "all" to remove every message in scope, or pass an age in hours.
817
+ Arguments:
818
+ 1. "code" (string, required) payment code
738
819
 
739
820
  Result:
740
821
  {
741
- "removed": n,
742
- "remaining": n
822
+ "isvalid": true|false, (boolean)
823
+ "error": "str", (string) reason when invalid
824
+ "network", "scan_pubkey", "spend_pubkey" when valid
743
825
  }
744
-
745
- &nbsp;<br> &nbsp;<br/>
746
- ## depindecrypt
747
- &nbsp;<br/> depindecrypt "address" "encrypted"
748
826
 
749
- Decrypts an encrypted DePIN reply with a wallet key. Verify the reply's poolsig before using this method; depindecrypt does not verify it.
750
-
751
- Result:
752
- The decrypted JSON value, or a string when the plaintext is not JSON.
753
-
754
- &nbsp;<br> &nbsp;<br/>
755
- ## depingetancestorrecipients
756
- &nbsp;<br/> depingetancestorrecipients "token" ( max_results ) ( "stop_at" )
757
-
758
- List the active holders of a DEPIN branch: the deduplicated union of the
759
- holders of the given token and of every one of its '/'-separated ancestors,
760
- each with the public key it has revealed on chain.
761
-
762
- Active means: positive balance, public key revealed, and not blocked by an
763
- owner freeze or by self-revocation. Restriction is per (asset, address), so an
764
- address that is active in at least one ancestor is returned even if it revoked
765
- itself in another -- holding the root already grants visibility over the branch.
827
+ Examples:
828
+ > neurai-cli decodesilentpaymentcode "tnsp1q..."
766
829
 
767
- The query is exact: '&TEST' returns holders of '&TEST' only, never of
768
- '&TEST/APPLE', '&TESTING' or '&TEST.FOO'. Every derived ancestor must exist; a
769
- missing intermediate level is an error rather than something skipped.
830
+ &nbsp;<br> &nbsp;<br/>
831
+ ## depinchallenge
832
+ &nbsp;<br/> depinchallenge request
770
833
 
771
- This command is informational. It does not know about -depinmsgmaxusers, does
772
- not decide whether a message fits in a pool, and a truncated result must not be
773
- treated as a complete recipient set.
834
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
835
+ Request fields: protocol, network (genesis), pool_pubkey, pool_root, instance_id, membership_revision, request_id, timestamp_ms, token, address, challenge, args, signature. Every private operation signs its method, target identity, revision and arguments. Public authentication fields are empty. Replies sign the exact request hash and served membership metadata. Verify before decoding/decrypting. See DEPIN_EXAMPLES.md for method-specific args and neurai-depin-msg integration.
836
+ &nbsp;<br> &nbsp;<br/>
837
+ ## depinclearmsg
838
+ &nbsp;<br/> depinclearmsg request
774
839
 
775
- Requires -assetindex and -pubkeyindex.
840
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
841
+ Request fields: protocol, network (genesis), pool_pubkey, pool_root, instance_id, membership_revision, request_id, timestamp_ms, token, address, challenge, args, signature. Every private operation signs its method, target identity, revision and arguments. Public authentication fields are empty. Replies sign the exact request hash and served membership metadata. Verify before decoding/decrypting. See DEPIN_EXAMPLES.md for method-specific args and neurai-depin-msg integration.
842
+ &nbsp;<br> &nbsp;<br/>
843
+ ## depindecrypt
844
+ &nbsp;<br/> depindecrypt "address" "encrypted"
776
845
 
777
- Arguments:
778
- 1. "token" (string, required) DEPIN token, e.g. "&TEST/APPLE/GOLDEN"
779
- 2. max_results (numeric, optional, default=1000) Maximum recipients to return
780
- (1..10000)
781
- 3. "stop_at" (string, optional) Stop deriving ancestors at this token,
782
- inclusive. Must be the token itself or one of its ancestors.
783
- Omitted: derive up to the absolute root.
846
+ Decrypts an encrypted DePIN reply with a wallet key. Verify the reply's poolsig before using this method; depindecrypt does not verify it.
784
847
 
785
848
  Result:
786
- {
787
- "token": "name", (string) Token queried
788
- "stop_at": "name", (string) Where derivation stopped ("" = root)
789
- "ancestors": ["name", ...], (array) Token first, then each ancestor
790
- "recipients": [ (array) Active holders, ordered by address
791
- {
792
- "address": "address", (string) Holder address
793
- "pubkey": "hex" (string) Public key revealed on chain
794
- }, ...
795
- ],
796
- "returned": n, (numeric) Number of recipients returned
797
- "max_results": n, (numeric) Limit applied
798
- "truncated": true|false, (boolean) True if more eligible recipients exist
799
- "skipped_no_pubkey": n, (numeric) Addresses dropped for lacking a usable
800
- revealed public key
801
- "skipped_no_pubkey_complete": bool, (boolean) False when truncated: the count then
802
- covers only the addresses examined
803
- "skipped_restricted": n, (numeric) Addresses dropped as frozen or
804
- self-revoked in every ancestor they hold
805
- "skipped_restricted_complete": bool (boolean) Same rule as above
806
- }
849
+ The decrypted JSON value, or a string when the plaintext is not JSON.
807
850
 
808
- Examples:
809
- > neurai-cli depingetancestorrecipients "&TEST/APPLE/GOLDEN"
810
- > neurai-cli depingetancestorrecipients "&TEST/APPLE/GOLDEN" 50 "&TEST/APPLE"
811
- > 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:19001/
812
-
813
- &nbsp;<br> &nbsp;<br/>
814
- ## depingetmsg
851
+ &nbsp;<br> &nbsp;<br/>
852
+ ## depingetancestorrecipients
853
+ &nbsp;<br/> depingetancestorrecipients request
854
+
855
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
856
+ Request fields: protocol, network (genesis), pool_pubkey, pool_root, instance_id, membership_revision, request_id, timestamp_ms, token, address, challenge, args, signature. Every private operation signs its method, target identity, revision and arguments. Public authentication fields are empty. Replies sign the exact request hash and served membership metadata. Verify before decoding/decrypting. See DEPIN_EXAMPLES.md for method-specific args and neurai-depin-msg integration.
857
+ &nbsp;<br> &nbsp;<br/>
858
+ ## depingetmsg
815
859
  &nbsp;<br/> depingetmsg "token" ( "fromaddress" )
816
860
 
817
861
  Uses the local node wallet to decrypt messages from the local DePIN pool. The optional address must belong to the wallet and hold the requested token or a related branch token.
818
-
819
- &nbsp;<br> &nbsp;<br/>
820
- ## depingetmsginfo
821
- &nbsp;<br/> depingetmsginfo
822
-
823
- Returns DePIN protocol and pool configuration. Protocol 2 publishes depinpoolpkey in this response; clients should pin it on first use. Responses are signed with the pool key.
824
-
825
- &nbsp;<br> &nbsp;<br/>
826
- ## depinlistsections
827
- &nbsp;<br/> depinlistsections ( "address" "scope" "challenge" "signature" )
828
-
829
- With no arguments, lists public section names. Address mode requires all four arguments, authenticates with a receive challenge for scope, limits results to that subtree, and returns encrypted personal access and message counters.
830
-
831
- &nbsp;<br> &nbsp;<br/>
832
- ## depinmcpstatus
833
- &nbsp;<br/> depinmcpstatus
834
-
835
- Get status information about the DePIN MCP (AI) worker
836
-
837
- Result:
838
- {
839
- "enabled": true|false, (boolean) Whether MCP worker is enabled
840
- "running": true|false, (boolean) Whether MCP worker is running
841
- "mcp_url": "url", (string) MCP server URL
842
- "model_name": "name", (string) Name of the loaded AI model
843
- "command_key": "key", (string) Command prefix (e.g. /ai)
844
- "depin_token": "token", (string) DePIN token being monitored
845
- "poll_interval": n, (numeric) Polling interval in seconds
846
- "commands_processed": n, (numeric) Total commands processed
847
- "total_errors": n, (numeric) Total errors encountered
848
- "rate_limited": n, (numeric) Commands rejected by rate limiting
849
- "concurrency": n, (numeric) Number of parallel task threads
850
- "tasks_in_flight": n, (numeric) AI requests currently being processed
851
- "processed_cache": n, (numeric) Size of the processed-message dedup cache
852
- "context_sessions": n, (numeric) Active conversation contexts
853
- "last_poll_time": n (numeric) Unix timestamp of last poll
854
- }
855
862
 
856
- Examples:
857
- > neurai-cli depinmcpstatus
858
- > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinmcpstatus", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
859
-
860
- &nbsp;<br> &nbsp;<br/>
861
- ## depinpoolpkey
863
+ &nbsp;<br> &nbsp;<br/>
864
+ ## depingetmsginfo
865
+ &nbsp;<br/> depingetmsginfo request
866
+
867
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
868
+ Bootstrap fields: protocol=5, request_id (32 random bytes in lowercase hex), timestamp_ms (integer milliseconds). Verify the response with the local request hash, expected genesis and pinned pool key before using its context.
869
+ &nbsp;<br> &nbsp;<br/>
870
+ ## depinlistsections
871
+ &nbsp;<br/> depinlistsections request
872
+
873
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
874
+ Request fields: protocol, network (genesis), pool_pubkey, pool_root, instance_id, membership_revision, request_id, timestamp_ms, token, address, challenge, args, signature. Every private operation signs its method, target identity, revision and arguments. Public authentication fields are empty. Replies sign the exact request hash and served membership metadata. Verify before decoding/decrypting. See DEPIN_EXAMPLES.md for method-specific args and neurai-depin-msg integration.
875
+ &nbsp;<br> &nbsp;<br/>
876
+ ## depinmcpstatus
877
+ &nbsp;<br/> depinmcpstatus request
878
+
879
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
880
+ Request fields: protocol, network (genesis), pool_pubkey, pool_root, instance_id, membership_revision, request_id, timestamp_ms, token, address, challenge, args, signature. Every private operation signs its method, target identity, revision and arguments. Public authentication fields are empty. Replies sign the exact request hash and served membership metadata. Verify before decoding/decrypting. See DEPIN_EXAMPLES.md for method-specific args and neurai-depin-msg integration.
881
+ &nbsp;<br> &nbsp;<br/>
882
+ ## depinpoolpkey
862
883
  &nbsp;<br/> depinpoolpkey
863
884
 
864
885
  Wallet-only operator helper that derives the dedicated DePIN pool public key from the loaded service wallet.
@@ -869,83 +890,43 @@ Result:
869
890
  "address": "address",
870
891
  "path": "derivation_path"
871
892
  }
872
-
873
- &nbsp;<br> &nbsp;<br/>
874
- ## depinpoolstats
875
- &nbsp;<br/> depinpoolstats
876
-
877
- Get statistical analysis of the DePIN message pool.
878
-
879
- Result:
880
- {
881
- "enabled": true|false,
882
- "token": "string",
883
- "total_messages": n,
884
- "total_size_bytes": n,
885
- "memory_usage_bytes": n,
886
- "oldest_message": "YYYY-MM-DD HH:MM:SS",
887
- "newest_message": "YYYY-MM-DD HH:MM:SS",
888
- "messages_by_age": {
889
- "last_hour": n,
890
- "last_day": n,
891
- "last_week": n
892
- },
893
- "unique_senders": n,
894
- "unique_recipients": n,
895
- "avg_recipients_per_message": n.nn,
896
- "avg_message_size": n,
897
- "expiring_in_24h": n
898
- }
899
893
 
900
- Examples:
901
- > neurai-cli depinpoolstats
902
- > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "depinpoolstats", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
903
-
904
- &nbsp;<br> &nbsp;<br/>
905
- ## depinreceivemsg
906
- &nbsp;<br/> depinreceivemsg "token" "address" "challenge" "signature" ( timestamp "after_hash" limit )
907
-
908
- Returns messages accessible to an address, encrypted for its revealed public key and signed by the pool key. Requires a receive challenge. Pagination uses timestamp, after_hash and limit. The decrypted reply includes next_challenge for subsequent calls.
909
-
910
- &nbsp;<br> &nbsp;<br/>
911
- ## depinsendmsg
894
+ &nbsp;<br> &nbsp;<br/>
895
+ ## depinpoolstats
896
+ &nbsp;<br/> depinpoolstats request
897
+
898
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
899
+ Request fields: protocol, network (genesis), pool_pubkey, pool_root, instance_id, membership_revision, request_id, timestamp_ms, token, address, challenge, args, signature. Every private operation signs its method, target identity, revision and arguments. Public authentication fields are empty. Replies sign the exact request hash and served membership metadata. Verify before decoding/decrypting. See DEPIN_EXAMPLES.md for method-specific args and neurai-depin-msg integration.
900
+ &nbsp;<br> &nbsp;<br/>
901
+ ## depinreceivemsg
902
+ &nbsp;<br/> depinreceivemsg request
903
+
904
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
905
+ Request fields: protocol, network (genesis), pool_pubkey, pool_root, instance_id, membership_revision, request_id, timestamp_ms, token, address, challenge, args, signature. Every private operation signs its method, target identity, revision and arguments. Public authentication fields are empty. Replies sign the exact request hash and served membership metadata. Verify before decoding/decrypting. See DEPIN_EXAMPLES.md for method-specific args and neurai-depin-msg integration.
906
+ &nbsp;<br> &nbsp;<br/>
907
+ ## depinreceiveseq
908
+ &nbsp;<br/> depinreceiveseq request
909
+
910
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
911
+ Request fields: protocol, network (genesis), pool_pubkey, pool_root, instance_id, membership_revision, request_id, timestamp_ms, token, address, challenge, args, signature. Every private operation signs its method, target identity, revision and arguments. Public authentication fields are empty. Replies sign the exact request hash and served membership metadata. Verify before decoding/decrypting. See DEPIN_EXAMPLES.md for method-specific args and neurai-depin-msg integration.
912
+ &nbsp;<br> &nbsp;<br/>
913
+ ## depinsendmsg
912
914
  &nbsp;<br/> depinsendmsg "token" "message" "fromaddress"
913
915
 
914
916
  Uses the local node wallet to sign and encrypt a message for eligible recipients, then adds it to the local DePIN pool. Remote host and port parameters were removed in protocol 2.
915
-
916
- &nbsp;<br> &nbsp;<br/>
917
- ## depinsignchallenge
918
- &nbsp;<br/> depinsignchallenge "address" "token" "challenge" ( "type" )
919
-
920
- Wallet helper that signs "DEPIN-GET|<token>|<address>|<challenge>" for receive access or "DEPIN-CLEAR|..." for admin access.
921
-
922
- Result:
923
- {
924
- "signature": "base64",
925
- "preimage": "text"
926
- }
927
-
928
- &nbsp;<br> &nbsp;<br/>
929
- ## depinsignrequest
930
- &nbsp;<br/> depinsignrequest "address" "token" ( "type" )
931
-
932
- Wallet helper that signs a depinchallenge request over the current Unix time in milliseconds.
933
917
 
934
- Result:
935
- {
936
- "timestamp": n,
937
- "signature": "base64",
938
- "preimage": "DEPIN-REQ|..."
939
- }
940
-
941
- &nbsp;<br> &nbsp;<br/>
942
- ## depinsubmitmsg
943
- &nbsp;<br/> depinsubmitmsg {"sender":"...","encrypted":"..."}
944
-
945
- Submits a client-prepared, signed DePIN message wrapped in an ECIES envelope for the pool key published by depingetmsginfo. Bare serialized hex is no longer accepted.
946
-
947
- &nbsp;<br> &nbsp;<br/>
948
- ## disconnectnode
918
+ &nbsp;<br> &nbsp;<br/>
919
+ ## depinsignrpc
920
+ &nbsp;<br/> depinsignrpc "method" request
921
+ Local unlocked-wallet helper: sign a complete RPC 5 request. Returns request, preimage and request_hash. Never expose this wallet helper through a public HTTP/WSS proxy.
922
+ &nbsp;<br> &nbsp;<br/>
923
+ ## depinsubmitmsg
924
+ &nbsp;<br/> depinsubmitmsg request
925
+
926
+ DePIN RPC protocol 5. Exactly one request object, passed as [request] or {"request": request}. Legacy positional arguments and protocols 2/3/4 are rejected.
927
+ Request fields: protocol, network (genesis), pool_pubkey, pool_root, instance_id, membership_revision, request_id, timestamp_ms, token, address, challenge, args, signature. Every private operation signs its method, target identity, revision and arguments. Public authentication fields are empty. Replies sign the exact request hash and served membership metadata. Verify before decoding/decrypting. See DEPIN_EXAMPLES.md for method-specific args and neurai-depin-msg integration.
928
+ &nbsp;<br> &nbsp;<br/>
929
+ ## disconnectnode
949
930
  &nbsp;<br/> disconnectnode "[address]" [nodeid]
950
931
 
951
932
  Immediately disconnects from the specified peer node.
@@ -963,47 +944,16 @@ Examples:
963
944
  > neurai-cli disconnectnode "" 1
964
945
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "disconnectnode", "params": ["192.168.0.6:19000"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
965
946
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "disconnectnode", "params": ["", 1] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
966
-
967
- &nbsp;<br> &nbsp;<br/>
968
- ## distributereward
969
- &nbsp;<br/> distributereward "asset_name" snapshot_height "distribution_asset_name" gross_distribution_amount ( "exception_addresses" ) ("change_address") ("dry_run")
970
-
971
- Splits the specified amount of the distribution asset to all owners of asset_name that are not in the optional exclusion_addresses
972
947
 
973
- Arguments:
974
- 1. "asset_name" (string, required) The reward will be distributed all owners of this asset
975
- 2. "snapshot_height" (number, required) The block height of the ownership snapshot
976
- 3. "distribution_asset_name" (string, required) The name of the asset that will be distributed, or XNA
977
- 4. "gross_distribution_amount" (number, required) The amount of the distribution asset that will be split amongst all owners
978
- 5. "exception_addresses" (string, optional) Ownership addresses that should be excluded
979
- 6. "change_address" (string, optional) If the rewards can't be fully distributed. The change will be sent to this address
948
+ &nbsp;<br> &nbsp;<br/>
949
+ ## distributereward
950
+ &nbsp;<br/> distributereward "asset_name" snapshot_height "distribution_asset_name" gross_distribution_amount ( "exception_addresses" ) ( "change_address" )
980
951
 
981
- Result:
982
- {
983
- error_txn_gen_failed: (string),
984
- error_nsf: (string),
985
- error_rejects: (string),
986
- error_db_update: (string),
987
- batch_results: [
988
- {
989
- transaction_id: (string),
990
- error_txn_rejected: (string),
991
- total_amount: (number),
992
- fee: (number),
993
- expected_count: (number),
994
- actual_count: (number),
995
- }
996
- ]
997
- }
952
+ Retired (NIP-048): the node no longer sends reward payments.
953
+ Use getdistributionplan to compute the payments, then send them from your wallet.
998
954
 
999
- Examples:
1000
- > neurai-cli distributereward "TRONCO" 12345 "XNA" 1000
1001
- > neurai-cli distributereward "PHATSTACKS" 12345 "DIVIDENDS" 1000 "mwN7xC3yomYdvJuVXkVC7ymY9wNBjWNduD,n4Rf18edydDaRBh7t6gHUbuByLbWEoWUTg"
1002
- > 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:19001/
1003
- > 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:19001/
1004
-
1005
- &nbsp;<br> &nbsp;<br/>
1006
- ## dumpextkeypq
955
+ &nbsp;<br> &nbsp;<br/>
956
+ ## dumpextkeypq
1007
957
  &nbsp;<br/> dumpextkeypq
1008
958
 
1009
959
  Returns the master PQ extended private key (xpqpriv) for this wallet.
@@ -1013,11 +963,11 @@ Result:
1013
963
  "xpqpriv..." (string) Base58Check-encoded master CExtKeyPQ
1014
964
 
1015
965
  Examples:
1016
- > neurai-cli dumpextkeypq
966
+ > neurai-cli dumpextkeypq
1017
967
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "dumpextkeypq", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1018
-
1019
- &nbsp;<br> &nbsp;<br/>
1020
- ## dumpprivkey
968
+
969
+ &nbsp;<br> &nbsp;<br/>
970
+ ## dumpprivkey
1021
971
  &nbsp;<br/> dumpprivkey "address"
1022
972
 
1023
973
  Reveals the private key corresponding to 'address'.
@@ -1033,9 +983,9 @@ Examples:
1033
983
  > neurai-cli dumpprivkey "myaddress"
1034
984
  > neurai-cli importprivkey "mykey"
1035
985
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "dumpprivkey", "params": ["myaddress"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1036
-
1037
- &nbsp;<br> &nbsp;<br/>
1038
- ## dumpwallet
986
+
987
+ &nbsp;<br> &nbsp;<br/>
988
+ ## dumpwallet
1039
989
  &nbsp;<br/> dumpwallet "filename"
1040
990
 
1041
991
  Dumps all wallet keys in a human-readable format to a server-side file. This does not allow overwriting existing files.
@@ -1051,13 +1001,13 @@ Result:
1051
1001
  Examples:
1052
1002
  > neurai-cli dumpwallet "test"
1053
1003
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "dumpwallet", "params": ["test"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1054
-
1055
- &nbsp;<br> &nbsp;<br/>
1056
- ## encryptwallet
1004
+
1005
+ &nbsp;<br> &nbsp;<br/>
1006
+ ## encryptwallet
1057
1007
  &nbsp;<br/> encryptwallet "passphrase"
1058
1008
 
1059
1009
  Encrypts the wallet with 'passphrase'. This is for first time encryption.
1060
- After this, any calls that interact with private keys such as sending or signing
1010
+ After this, any calls that interact with private keys such as sending or signing
1061
1011
  will require the passphrase to be set prior the making these calls.
1062
1012
  Use the walletpassphrase call for this, and then walletlock call.
1063
1013
  If the wallet is already encrypted, use the walletpassphrasechange call.
@@ -1078,13 +1028,13 @@ Now we can do something like sign
1078
1028
  > neurai-cli signmessage "address" "test message"
1079
1029
 
1080
1030
  Now lock the wallet again by removing the passphrase
1081
- > neurai-cli walletlock
1031
+ > neurai-cli walletlock
1082
1032
 
1083
1033
  As a json rpc call
1084
1034
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "encryptwallet", "params": ["my pass phrase"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1085
-
1086
- &nbsp;<br> &nbsp;<br/>
1087
- ## estimatefee
1035
+
1036
+ &nbsp;<br> &nbsp;<br/>
1037
+ ## estimatefee
1088
1038
  &nbsp;<br/> estimatefee nblocks
1089
1039
 
1090
1040
  DEPRECATED. Please use estimatesmartfee for more intelligent estimates.
@@ -1105,9 +1055,9 @@ a fee that is high enough to get reliably included in the next block.
1105
1055
 
1106
1056
  Example:
1107
1057
  > neurai-cli estimatefee 6
1108
-
1109
- &nbsp;<br> &nbsp;<br/>
1110
- ## estimatesmartfee
1058
+
1059
+ &nbsp;<br> &nbsp;<br/>
1060
+ ## estimatesmartfee
1111
1061
  &nbsp;<br/> estimatesmartfee conf_target ("estimate_mode")
1112
1062
 
1113
1063
  Estimates the approximate fee per kilobyte needed for a transaction to begin
@@ -1141,9 +1091,29 @@ have been observed to make an estimate for any number of blocks.
1141
1091
 
1142
1092
  Example:
1143
1093
  > neurai-cli estimatesmartfee 6
1144
-
1145
- &nbsp;<br> &nbsp;<br/>
1146
- ## exportxpqpub
1094
+
1095
+ &nbsp;<br> &nbsp;<br/>
1096
+ ## exportsilentpaymentviewkey
1097
+ &nbsp;<br/> exportsilentpaymentviewkey "acknowledge"
1098
+
1099
+ Returns the view key (b_scan and B_spend) of this wallet's silent payment code.
1100
+ Whoever holds it can find and link every payment to the code, but cannot spend them.
1101
+ Never combine it with an exported payment private key: together they reveal the spend key.
1102
+ The result is a secret: from a shell, prefer a terminal that is not recorded or logged.
1103
+
1104
+ Arguments:
1105
+ 1. "acknowledge" (string, required) must be "reveal view key"
1106
+
1107
+ Result:
1108
+ {
1109
+ "scan_private_key": "hex", "spend_pubkey": "hex", "network": "str"
1110
+ }
1111
+
1112
+ Examples:
1113
+ > neurai-cli exportsilentpaymentviewkey "reveal view key"
1114
+
1115
+ &nbsp;<br> &nbsp;<br/>
1116
+ ## exportxpqpub
1147
1117
  &nbsp;<br/> exportxpqpub count ( chain offset )
1148
1118
 
1149
1119
  Generates a batch of count ML-DSA-44 public keys and returns the xpqpub blob.
@@ -1159,9 +1129,9 @@ Result:
1159
1129
  Examples:
1160
1130
  > neurai-cli exportxpqpub 20
1161
1131
  > 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:19001/
1162
-
1163
- &nbsp;<br> &nbsp;<br/>
1164
- ## freezeaddress
1132
+
1133
+ &nbsp;<br> &nbsp;<br/>
1134
+ ## freezeaddress
1165
1135
  &nbsp;<br/> freezeaddress asset_name address (change_address) (asset_data)
1166
1136
 
1167
1137
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -1183,9 +1153,9 @@ Examples:
1183
1153
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "freezeaddress", "params": ["$RESTRICTED_ASSET" "address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1184
1154
  > neurai-cli freezeaddress "$RESTRICTED_ASSET" "address" "change_address"
1185
1155
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "freezeaddress", "params": ["$RESTRICTED_ASSET" "address" "change_address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1186
-
1187
- &nbsp;<br> &nbsp;<br/>
1188
- ## freezedepin
1156
+
1157
+ &nbsp;<br> &nbsp;<br/>
1158
+ ## freezedepin
1189
1159
  &nbsp;<br/> freezedepin "asset_name" "address" ("change_address")
1190
1160
 
1191
1161
  THIS COMMAND IS NOT YET ACTIVE!
@@ -1208,9 +1178,9 @@ Result:
1208
1178
  Examples:
1209
1179
  > neurai-cli freezedepin "&FRANCE" "address"
1210
1180
  > 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:19001/
1211
-
1212
- &nbsp;<br> &nbsp;<br/>
1213
- ## freezerestrictedasset
1181
+
1182
+ &nbsp;<br> &nbsp;<br/>
1183
+ ## freezerestrictedasset
1214
1184
  &nbsp;<br/> freezerestrictedasset asset_name (change_address) (asset_data)
1215
1185
 
1216
1186
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -1231,9 +1201,9 @@ Examples:
1231
1201
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "freezerestrictedasset", "params": ["$RESTRICTED_ASSET"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1232
1202
  > neurai-cli freezerestrictedasset "$RESTRICTED_ASSET" "change_address"
1233
1203
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "freezerestrictedasset", "params": ["$RESTRICTED_ASSET" "change_address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1234
-
1235
- &nbsp;<br> &nbsp;<br/>
1236
- ## fundrawtransaction
1204
+
1205
+ &nbsp;<br> &nbsp;<br/>
1206
+ ## fundrawtransaction
1237
1207
  &nbsp;<br/> fundrawtransaction "hexstring" ( options )
1238
1208
 
1239
1209
  Add inputs to a transaction until it has enough in value to meet its out value.
@@ -1262,7 +1232,6 @@ Arguments:
1262
1232
  Those recipients will receive less neurais than you enter in their corresponding amount field.
1263
1233
  If no outputs are specified here, the sender pays the fee.
1264
1234
  [vout_index,...]
1265
- Allows this transaction to be replaced by a transaction with higher fees
1266
1235
  "conf_target" (numeric, optional) Confirmation target (in blocks)
1267
1236
  "estimate_mode" (string, optional, default=UNSET) The fee estimate mode, must be one of:
1268
1237
  "UNSET"
@@ -1291,9 +1260,9 @@ Sign the transaction
1291
1260
 
1292
1261
  Send the transaction
1293
1262
  > neurai-cli sendrawtransaction "signedtransactionhex"
1294
-
1295
- &nbsp;<br> &nbsp;<br/>
1296
- ## generate
1263
+
1264
+ &nbsp;<br> &nbsp;<br/>
1265
+ ## generate
1297
1266
  &nbsp;<br/> generate nblocks ( maxtries )
1298
1267
 
1299
1268
  Mine up to nblocks blocks immediately (before the RPC call returns) to an address in the wallet.
@@ -1309,9 +1278,9 @@ Examples:
1309
1278
 
1310
1279
  Generate 11 blocks
1311
1280
  > neurai-cli generate 11
1312
-
1313
- &nbsp;<br> &nbsp;<br/>
1314
- ## generatetoaddress
1281
+
1282
+ &nbsp;<br> &nbsp;<br/>
1283
+ ## generatetoaddress
1315
1284
  &nbsp;<br/> generatetoaddress nblocks address (maxtries)
1316
1285
 
1317
1286
  Mine blocks immediately to a specified address (before the RPC call returns)
@@ -1328,9 +1297,9 @@ Examples:
1328
1297
 
1329
1298
  Generate 11 blocks to myaddress
1330
1299
  > neurai-cli generatetoaddress 11 "myaddress"
1331
-
1332
- &nbsp;<br> &nbsp;<br/>
1333
- ## getaccount
1300
+
1301
+ &nbsp;<br> &nbsp;<br/>
1302
+ ## getaccount
1334
1303
  &nbsp;<br/> getaccount "address"
1335
1304
 
1336
1305
  DEPRECATED. Returns the account associated with the given address.
@@ -1344,9 +1313,9 @@ Result:
1344
1313
  Examples:
1345
1314
  > neurai-cli getaccount "1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX"
1346
1315
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaccount", "params": ["1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1347
-
1348
- &nbsp;<br> &nbsp;<br/>
1349
- ## getaccountaddress
1316
+
1317
+ &nbsp;<br> &nbsp;<br/>
1318
+ ## getaccountaddress
1350
1319
  &nbsp;<br/> getaccountaddress "account"
1351
1320
 
1352
1321
  DEPRECATED. Returns the current Neurai address for receiving payments to this account.
@@ -1358,13 +1327,13 @@ Result:
1358
1327
  "address" (string) The account neurai address
1359
1328
 
1360
1329
  Examples:
1361
- > neurai-cli getaccountaddress
1330
+ > neurai-cli getaccountaddress
1362
1331
  > neurai-cli getaccountaddress ""
1363
1332
  > neurai-cli getaccountaddress "myaccount"
1364
1333
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaccountaddress", "params": ["myaccount"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1365
-
1366
- &nbsp;<br> &nbsp;<br/>
1367
- ## getaddednodeinfo
1334
+
1335
+ &nbsp;<br> &nbsp;<br/>
1336
+ ## getaddednodeinfo
1368
1337
  &nbsp;<br/> getaddednodeinfo ( "node" )
1369
1338
 
1370
1339
  Returns information about the given added node, or all added nodes
@@ -1391,9 +1360,9 @@ Result:
1391
1360
  Examples:
1392
1361
  > neurai-cli getaddednodeinfo "192.168.0.201"
1393
1362
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddednodeinfo", "params": ["192.168.0.201"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1394
-
1395
- &nbsp;<br> &nbsp;<br/>
1396
- ## getaddressbalance
1363
+
1364
+ &nbsp;<br> &nbsp;<br/>
1365
+ ## getaddressbalance
1397
1366
  &nbsp;<br/> getaddressbalance
1398
1367
 
1399
1368
  Returns the balance for an address(es) (requires addressindex to be enabled).
@@ -1428,9 +1397,9 @@ Examples:
1428
1397
  > neurai-cli getaddressbalance '{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}', true
1429
1398
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressbalance", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1430
1399
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressbalance", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}, true] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1431
-
1432
- &nbsp;<br> &nbsp;<br/>
1433
- ## getaddressdeltas
1400
+
1401
+ &nbsp;<br> &nbsp;<br/>
1402
+ ## getaddressdeltas
1434
1403
  &nbsp;<br/> getaddressdeltas
1435
1404
 
1436
1405
  Returns all changes for an address (requires addressindex to be enabled).
@@ -1465,9 +1434,9 @@ Examples:
1465
1434
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressdeltas", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1466
1435
  > neurai-cli getaddressdeltas '{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"],"assetName":"MY_ASSET"}'
1467
1436
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressdeltas", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"],"assetName":"MY_ASSET"}] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1468
-
1469
- &nbsp;<br> &nbsp;<br/>
1470
- ## getaddressesbyaccount
1437
+
1438
+ &nbsp;<br> &nbsp;<br/>
1439
+ ## getaddressesbyaccount
1471
1440
  &nbsp;<br/> getaddressesbyaccount "account"
1472
1441
 
1473
1442
  DEPRECATED. Returns the list of addresses for the given account.
@@ -1484,9 +1453,9 @@ Result:
1484
1453
  Examples:
1485
1454
  > neurai-cli getaddressesbyaccount "tabby"
1486
1455
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressesbyaccount", "params": ["tabby"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1487
-
1488
- &nbsp;<br> &nbsp;<br/>
1489
- ## getaddressmempool
1456
+
1457
+ &nbsp;<br> &nbsp;<br/>
1458
+ ## getaddressmempool
1490
1459
  &nbsp;<br/> getaddressmempool
1491
1460
 
1492
1461
  Returns all mempool deltas for an address (requires addressindex to be enabled).
@@ -1520,9 +1489,9 @@ Examples:
1520
1489
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressmempool", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1521
1490
  > neurai-cli getaddressmempool '{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}', true
1522
1491
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressmempool", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}, true] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1523
-
1524
- &nbsp;<br> &nbsp;<br/>
1525
- ## getaddresstxids
1492
+
1493
+ &nbsp;<br> &nbsp;<br/>
1494
+ ## getaddresstxids
1526
1495
  &nbsp;<br/> getaddresstxids
1527
1496
 
1528
1497
  Returns the txids for an address(es) (requires addressindex to be enabled).
@@ -1550,9 +1519,9 @@ Examples:
1550
1519
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddresstxids", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1551
1520
  > neurai-cli getaddresstxids '{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}', true
1552
1521
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddresstxids", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}, true] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1553
-
1554
- &nbsp;<br> &nbsp;<br/>
1555
- ## getaddressutxos
1522
+
1523
+ &nbsp;<br> &nbsp;<br/>
1524
+ ## getaddressutxos
1556
1525
  &nbsp;<br/> getaddressutxos
1557
1526
 
1558
1527
  Returns all unspent outputs for an address (requires addressindex to be enabled).
@@ -1586,9 +1555,9 @@ Examples:
1586
1555
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressutxos", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"]}] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1587
1556
  > neurai-cli getaddressutxos '{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"],"assetName":"MY_ASSET"}'
1588
1557
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getaddressutxos", "params": [{"addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"],"assetName":"MY_ASSET"}] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1589
-
1590
- &nbsp;<br> &nbsp;<br/>
1591
- ## getassetdata
1558
+
1559
+ &nbsp;<br> &nbsp;<br/>
1560
+ ## getassetdata
1592
1561
  &nbsp;<br/> getassetdata "asset_name"
1593
1562
 
1594
1563
  THIS COMMAND IS NOT YET ACTIVE!
@@ -1609,14 +1578,15 @@ Result:
1609
1578
  ipfs_hash: (hash), (only if has_ipfs = 1 and that data is a ipfs hash)
1610
1579
  txid_hash: (hash), (only if has_ipfs = 1 and that data is a txid hash)
1611
1580
  verifier_string: (string)
1581
+ transfer_state: (string) "closed" | "open" | "sealed" (only for DEPIN assets, names starting with &)
1612
1582
  }
1613
1583
 
1614
1584
  Examples:
1615
1585
  > neurai-cli getassetdata "ASSET_NAME"
1616
1586
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getassetdata", "params": ["ASSET_NAME"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1617
-
1618
- &nbsp;<br> &nbsp;<br/>
1619
- ## getbalance
1587
+
1588
+ &nbsp;<br> &nbsp;<br/>
1589
+ ## getbalance
1620
1590
  &nbsp;<br/> getbalance ( "account" minconf include_watchonly )
1621
1591
 
1622
1592
  If account is not specified, returns the server's total available balance.
@@ -1646,16 +1616,16 @@ amount (numeric) The total amount in XNA received for this account.
1646
1616
  Examples:
1647
1617
 
1648
1618
  The total amount in the wallet with 1 or more confirmations
1649
- > neurai-cli getbalance
1619
+ > neurai-cli getbalance
1650
1620
 
1651
1621
  The total amount in the wallet at least 6 blocks confirmed
1652
1622
  > neurai-cli getbalance "*" 6
1653
1623
 
1654
1624
  As a json rpc call
1655
1625
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getbalance", "params": ["*", 6] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1656
-
1657
- &nbsp;<br> &nbsp;<br/>
1658
- ## getbestblockhash
1626
+
1627
+ &nbsp;<br> &nbsp;<br/>
1628
+ ## getbestblockhash
1659
1629
  &nbsp;<br/> getbestblockhash
1660
1630
 
1661
1631
  Returns the hash of the best (tip) block in the longest blockchain.
@@ -1664,20 +1634,22 @@ Result:
1664
1634
  "hex" (string) the block hash hex encoded
1665
1635
 
1666
1636
  Examples:
1667
- > neurai-cli getbestblockhash
1637
+ > neurai-cli getbestblockhash
1668
1638
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getbestblockhash", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1669
-
1670
- &nbsp;<br> &nbsp;<br/>
1671
- ## getblock
1672
- &nbsp;<br/> getblock "blockhash" ( verbosity )
1639
+
1640
+ &nbsp;<br> &nbsp;<br/>
1641
+ ## getblock
1642
+ &nbsp;<br/> getblock "blockhash" ( verbosity )
1673
1643
 
1674
1644
  If verbosity is 0, returns a string that is serialized, hex-encoded data for block 'hash'.
1675
1645
  If verbosity is 1, returns an Object with information about block <hash>.
1676
- If verbosity is 2, returns an Object with information about block <hash> and information about each transaction.
1646
+ If verbosity is 2, returns an Object with information about block <hash> and information about each transaction.
1647
+ If verbosity is 3, returns the same as verbosity 2 plus a "prevout" object in each input with the spent output
1648
+ (generated, height, value, scriptPubKey), read from the block undo data. This works without -txindex.
1677
1649
 
1678
1650
  Arguments:
1679
1651
  1. "blockhash" (string, required) The block hash
1680
- 2. verbosity (numeric, optional, default=1) 0 for hex encoded data, 1 for a json object, and 2 for json object with transaction data
1652
+ 2. verbosity (numeric, optional, default=1) 0 for hex encoded data, 1 for a json object, 2 for json object with transaction data, and 3 for json object with transaction data and spent outputs
1681
1653
 
1682
1654
  Result (for verbosity = 0):
1683
1655
  "data" (string) A string that is serialized, hex-encoded data for block 'hash'.
@@ -1719,9 +1691,9 @@ Result (for verbosity = 2):
1719
1691
  Examples:
1720
1692
  > neurai-cli getblock "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"
1721
1693
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblock", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1722
-
1723
- &nbsp;<br> &nbsp;<br/>
1724
- ## getblockchaininfo
1694
+
1695
+ &nbsp;<br> &nbsp;<br/>
1696
+ ## getblockchaininfo
1725
1697
  &nbsp;<br/> getblockchaininfo
1726
1698
  Returns an object containing various state info regarding blockchain processing.
1727
1699
 
@@ -1729,6 +1701,7 @@ Result:
1729
1701
  {
1730
1702
  "chain": "xxxx", (string) current network name as defined in BIP70 (main, test, regtest)
1731
1703
  "blocks": xxxxxx, (numeric) the current number of blocks processed in the server
1704
+ "asset_marker": "xxxx", (string) marker required for new asset outputs in the next block ("rvn" or "xna")
1732
1705
  "headers": xxxxxx, (numeric) the current number of headers we have validated
1733
1706
  "bestblockhash": "...", (string) the hash of the currently best block
1734
1707
  "difficulty": xxxxxx, (numeric) the current difficulty
@@ -1737,6 +1710,11 @@ Result:
1737
1710
  "chainwork": "xxxx" (string) total amount of work in active chain, in hexadecimal
1738
1711
  "size_on_disk": xxxxxx, (numeric) the estimated size of the block and undo files on disk
1739
1712
  "pruned": xx, (boolean) if the blocks are subject to pruning
1713
+ "zk_public_tree": { (object) profile-2 public-transition activation
1714
+ "activation_height": n, (numeric or null) scheduled height, null when unscheduled
1715
+ "active_at_tip": b, (boolean) whether the current block uses profile 2
1716
+ "active_for_next_block": b (boolean) whether a candidate block uses profile 2
1717
+ },
1740
1718
  "pruneheight": xxxxxx, (numeric) lowest-height complete block stored (only present if pruning is enabled)
1741
1719
  "automatic_pruning": xx, (boolean) whether automatic pruning is enabled (only present if pruning is enabled)
1742
1720
  "prune_target_size": xxxxxx, (numeric) the target size used by pruning (only present if automatic pruning is enabled)
@@ -1757,23 +1735,34 @@ Result:
1757
1735
  "timeout": xx, (numeric) the median time past of a block at which the deployment is considered failed if not yet locked in
1758
1736
  "since": xx, (numeric) height of the first block to which the status applies
1759
1737
  "statistics": { (object) numeric statistics about BIP9 signalling for a softfork (only for "started" status)
1760
- "period": xx, (numeric) the length in blocks of the BIP9 signalling period
1761
- "threshold": xx, (numeric) the number of blocks with the version bit set required to activate the feature
1762
- "elapsed": xx, (numeric) the number of blocks elapsed since the beginning of the current period
1763
- "count": xx, (numeric) the number of blocks with the version bit set in the current period
1764
- "possible": xx (boolean) returns false if there are not enough blocks left in this period to pass activation threshold
1738
+ "period": xx, (numeric) the length in blocks of the BIP9 signalling period
1739
+ "threshold": xx, (numeric) the number of blocks with the version bit set required to activate the feature
1740
+ "elapsed": xx, (numeric) the number of blocks elapsed since the beginning of the current period
1741
+ "count": xx, (numeric) the number of blocks with the version bit set in the current period
1742
+ "possible": xx (boolean) returns false if there are not enough blocks left in this period to pass activation threshold
1765
1743
  }
1766
1744
  }
1767
1745
  }
1746
+ "asset_services": { (object) legacy asset modules (NIP-048)
1747
+ "messages": {
1748
+ "active": xx, (boolean) legacy asset messaging stores are open
1749
+ "store_on_disk": xx (boolean) the data directory has a messages store
1750
+ },
1751
+ "rewards": {
1752
+ "active": xx, (boolean) reward snapshot stores are open
1753
+ "store_on_disk": xx, (boolean) the data directory has a rewards store
1754
+ "assetindex": xx (boolean) -assetindex, which the reward RPCs require
1755
+ }
1756
+ },
1768
1757
  "warnings" : "...", (string) any network and blockchain warnings.
1769
1758
  }
1770
1759
 
1771
1760
  Examples:
1772
- > neurai-cli getblockchaininfo
1761
+ > neurai-cli getblockchaininfo
1773
1762
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockchaininfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1774
-
1775
- &nbsp;<br> &nbsp;<br/>
1776
- ## getblockcount
1763
+
1764
+ &nbsp;<br> &nbsp;<br/>
1765
+ ## getblockcount
1777
1766
  &nbsp;<br/> getblockcount
1778
1767
 
1779
1768
  Returns the number of blocks in the longest blockchain.
@@ -1782,11 +1771,11 @@ Result:
1782
1771
  n (numeric) The current block count
1783
1772
 
1784
1773
  Examples:
1785
- > neurai-cli getblockcount
1774
+ > neurai-cli getblockcount
1786
1775
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockcount", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1787
-
1788
- &nbsp;<br> &nbsp;<br/>
1789
- ## getblockhash
1776
+
1777
+ &nbsp;<br> &nbsp;<br/>
1778
+ ## getblockhash
1790
1779
  &nbsp;<br/> getblockhash height
1791
1780
 
1792
1781
  Returns hash of block in best-block-chain at height provided.
@@ -1800,9 +1789,9 @@ Result:
1800
1789
  Examples:
1801
1790
  > neurai-cli getblockhash 1000
1802
1791
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockhash", "params": [1000] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1803
-
1804
- &nbsp;<br> &nbsp;<br/>
1805
- ## getblockhashes
1792
+
1793
+ &nbsp;<br> &nbsp;<br/>
1794
+ ## getblockhashes
1806
1795
  &nbsp;<br/> getblockhashes timestamp
1807
1796
 
1808
1797
  Returns array of hashes of blocks within the timestamp range provided.
@@ -1831,9 +1820,9 @@ Examples:
1831
1820
  > neurai-cli getblockhashes 1231614698 1231024505
1832
1821
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockhashes", "params": [1231614698, 1231024505] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1833
1822
  > neurai-cli getblockhashes 1231614698 1231024505 '{"noOrphans":false, "logicalTimes":true}'
1834
-
1835
- &nbsp;<br> &nbsp;<br/>
1836
- ## getblockheader
1823
+
1824
+ &nbsp;<br> &nbsp;<br/>
1825
+ ## getblockheader
1837
1826
  &nbsp;<br/> getblockheader "hash" ( verbose )
1838
1827
 
1839
1828
  If verbose is false, returns a string that is serialized, hex-encoded data for blockheader 'hash'.
@@ -1867,9 +1856,9 @@ Result (for verbose=false):
1867
1856
  Examples:
1868
1857
  > neurai-cli getblockheader "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"
1869
1858
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockheader", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1870
-
1871
- &nbsp;<br> &nbsp;<br/>
1872
- ## getblocktemplate
1859
+
1860
+ &nbsp;<br> &nbsp;<br/>
1861
+ ## getblocktemplate
1873
1862
  &nbsp;<br/> getblocktemplate ( TemplateRequest )
1874
1863
 
1875
1864
  If the request parameters include a 'mode' key, that is used to explicitly select between the default 'template' request or a 'proposal'.
@@ -1910,7 +1899,7 @@ Result:
1910
1899
  "data" : "xxxx", (string) transaction data encoded in hexadecimal (byte-for-byte)
1911
1900
  "txid" : "xxxx", (string) transaction id encoded in little-endian hexadecimal
1912
1901
  "hash" : "xxxx", (string) hash encoded in little-endian hexadecimal (including witness data)
1913
- "depends" : [ (array) array of numbers
1902
+ "depends" : [ (array) array of numbers
1914
1903
  n (numeric) transactions before this one (by 1-based index in 'transactions' list) that must be present in the final block if this one is
1915
1904
  ,...
1916
1905
  ],
@@ -1928,7 +1917,7 @@ Result:
1928
1917
  "coinbasetxn" : { ... }, (json object) information for coinbase transaction
1929
1918
  "target" : "xxxx", (string) The hash target
1930
1919
  "mintime" : xxx, (numeric) The minimum timestamp appropriate for next block time in seconds since epoch (Jan 1 1970 GMT)
1931
- "mutable" : [ (array of string) list of ways the block template may be changed
1920
+ "mutable" : [ (array of string) list of ways the block template may be changed
1932
1921
  "value" (string) A way the block template may be changed, e.g. 'time', 'transactions', 'prevblock'
1933
1922
  ,...
1934
1923
  ],
@@ -1942,12 +1931,12 @@ Result:
1942
1931
  }
1943
1932
 
1944
1933
  Examples:
1945
- > neurai-cli getblocktemplate
1934
+ > neurai-cli getblocktemplate
1946
1935
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblocktemplate", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1947
-
1948
- &nbsp;<br> &nbsp;<br/>
1949
- ## getcacheinfo
1950
- &nbsp;<br/> getcacheinfo
1936
+
1937
+ &nbsp;<br> &nbsp;<br/>
1938
+ ## getcacheinfo
1939
+ &nbsp;<br/> getcacheinfo
1951
1940
 
1952
1941
  THIS COMMAND IS NOT YET ACTIVE!
1953
1942
  https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
@@ -1967,10 +1956,10 @@ Result:
1967
1956
 
1968
1957
  Examples:
1969
1958
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getcacheinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
1970
- > neurai-cli getcacheinfo
1971
-
1972
- &nbsp;<br> &nbsp;<br/>
1973
- ## getchaintips
1959
+ > neurai-cli getcacheinfo
1960
+
1961
+ &nbsp;<br> &nbsp;<br/>
1962
+ ## getchaintips
1974
1963
  &nbsp;<br/> getchaintips
1975
1964
  Return information about all known tips in the block tree, including the main chain as well as orphaned branches.
1976
1965
 
@@ -1997,11 +1986,11 @@ Possible values for status:
1997
1986
  5. "active" This is the tip of the active main chain, which is certainly valid
1998
1987
 
1999
1988
  Examples:
2000
- > neurai-cli getchaintips
1989
+ > neurai-cli getchaintips
2001
1990
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getchaintips", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2002
-
2003
- &nbsp;<br> &nbsp;<br/>
2004
- ## getchaintxstats
1991
+
1992
+ &nbsp;<br> &nbsp;<br/>
1993
+ ## getchaintxstats
2005
1994
  &nbsp;<br/> getchaintxstats ( nblocks blockhash )
2006
1995
 
2007
1996
  Compute statistics about the total number and rate of transactions in the chain.
@@ -2021,11 +2010,64 @@ Result:
2021
2010
  }
2022
2011
 
2023
2012
  Examples:
2024
- > neurai-cli getchaintxstats
2013
+ > neurai-cli getchaintxstats
2025
2014
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getchaintxstats", "params": [2016] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2026
-
2027
- &nbsp;<br> &nbsp;<br/>
2028
- ## getconnectioncount
2015
+
2016
+ &nbsp;<br> &nbsp;<br/>
2017
+ ## getchannelmessages
2018
+ &nbsp;<br/> getchannelmessages "channel" ( {options} )
2019
+
2020
+ Returns the messages of an asset channel from the chain-wide index (-channelmessageindex, NIP-048): every
2021
+ message an owner token (NAME!) or message channel token (NAME~CHANNEL) carried back to the address it came
2022
+ from, whatever the wallet. Expiry is decided at query time against reference_time, so nodes with the same
2023
+ chain answer alike.
2024
+
2025
+ Arguments:
2026
+ 1. "channel" (string, required) The owner token or message channel
2027
+ 2. options (object, optional)
2028
+ {
2029
+ "from_height": n, (number, default 0)
2030
+ "to_height": n, (number, default the tip)
2031
+ "include_expired": bool, (boolean, default false)
2032
+ "reference_time": n, (number, default the median time past of the tip) expiry reference
2033
+ "message": "hash", (string, optional) only messages with this payload
2034
+ "include_tx": bool, (boolean, default false) add the raw transaction
2035
+ "include_proof": bool, (boolean, default false) add a gettxoutproof-style proof
2036
+ "limit": n (number, default 1000, max 10000) messages per call;
2037
+ a block is never split, so the last block may go past it
2038
+ }
2039
+
2040
+ Result:
2041
+ {
2042
+ "channel": "name",
2043
+ "synced_height": n,
2044
+ "reference_time": n,
2045
+ "messages": [ (array) in chain order
2046
+ {
2047
+ "channel": "name",
2048
+ "authority": "owner"|"channel", (string) the token that carried the message
2049
+ "txid": "hex", "vout": n,
2050
+ "height": n, "block_hash": "hash", "block_time": n,
2051
+ "expire_time": n, (number) 0: never expires
2052
+ "expired": true|false,
2053
+ "message": "hash", (string) IPFS hash or 64-hex hash
2054
+ "address": "address", (string) the address that sent it to itself
2055
+ "op_return": "hex", (string, optional) data of the transaction's OP_RETURN output
2056
+ "op_return_matches": bool, (boolean, with op_return) the message is the SHA-256 of that data, so
2057
+ the data is content the token holder published in full (NIP-048 D1)
2058
+ "tx": "hex", (string, optional)
2059
+ "proof": "hex" (string, optional) checked with verifytxoutproof
2060
+ }, ...
2061
+ ],
2062
+ "next_from_height": n|null (number) the limit stopped here: pass it as from_height for the next page
2063
+ }
2064
+
2065
+ Examples:
2066
+ > neurai-cli getchannelmessages "ASSET!"
2067
+ > neurai-cli getchannelmessages "ASSET~NEWS" '{"from_height":1000,"include_expired":true}'
2068
+
2069
+ &nbsp;<br> &nbsp;<br/>
2070
+ ## getconnectioncount
2029
2071
  &nbsp;<br/> getconnectioncount
2030
2072
 
2031
2073
  Returns the number of connections to other nodes.
@@ -2034,11 +2076,11 @@ Result:
2034
2076
  n (numeric) The connection count
2035
2077
 
2036
2078
  Examples:
2037
- > neurai-cli getconnectioncount
2079
+ > neurai-cli getconnectioncount
2038
2080
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getconnectioncount", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2039
-
2040
- &nbsp;<br> &nbsp;<br/>
2041
- ## getdifficulty
2081
+
2082
+ &nbsp;<br> &nbsp;<br/>
2083
+ ## getdifficulty
2042
2084
  &nbsp;<br/> getdifficulty
2043
2085
 
2044
2086
  Returns the proof-of-work difficulty as a multiple of the minimum difficulty.
@@ -2047,11 +2089,11 @@ Result:
2047
2089
  n.nnn (numeric) the proof-of-work difficulty as a multiple of the minimum difficulty.
2048
2090
 
2049
2091
  Examples:
2050
- > neurai-cli getdifficulty
2092
+ > neurai-cli getdifficulty
2051
2093
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getdifficulty", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2052
-
2053
- &nbsp;<br> &nbsp;<br/>
2054
- ## getdistributestatus
2094
+
2095
+ &nbsp;<br> &nbsp;<br/>
2096
+ ## getdistributestatus
2055
2097
  &nbsp;<br/> getdistributestatus "asset_name" snapshot_height "distribution_asset_name" gross_distribution_amount ( "exception_addresses" )
2056
2098
 
2057
2099
  Give information about the status of the distribution
@@ -2068,9 +2110,185 @@ Examples:
2068
2110
  > neurai-cli getdistributestatus "PHATSTACKS" 12345 "DIVIDENDS" 1000 "mwN7xC3yomYdvJuVXkVC7ymY9wNBjWNduD,n4Rf18edydDaRBh7t6gHUbuByLbWEoWUTg"
2069
2111
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getdistributestatus", "params": ["TRONCO" 34987 "DIVIDENDS" 100000] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2070
2112
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getdistributestatus", "params": ["PHATSTACKS" 34987 "XNA" 100000 "mwN7xC3yomYdvJuVXkVC7ymY9wNBjWNduD,n4Rf18edydDaRBh7t6gHUbuByLbWEoWUTg"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2071
-
2072
- &nbsp;<br> &nbsp;<br/>
2073
- ## getgenerate
2113
+
2114
+ &nbsp;<br> &nbsp;<br/>
2115
+ ## getdistributionbatches
2116
+ &nbsp;<br/> getdistributionbatches {plan} ( {options} )
2117
+
2118
+ Splits the payments of a distribution plan into batches of at most max_outputs recipients, in plan order
2119
+ (NIP-048). Each batch pays all its recipients in one transaction. Nothing is spent or locked.
2120
+
2121
+ Arguments:
2122
+ 1. plan (object, required) The plan parameters
2123
+ {
2124
+ "asset_name": "name", (string, required) as in getdistributionplan
2125
+ "snapshot_height": n, (number, required)
2126
+ "distribution_asset_name": "name", (string, required)
2127
+ "amount": x.xxx, (numeric, required) gross_distribution_amount
2128
+ "exception_addresses": "a,b", (string, optional)
2129
+ "remainder": "payer"|"largest", (string, optional, default "payer")
2130
+ "allow_legacy_snapshot": bool, (boolean, optional, default false)
2131
+ "announcement": {"txid": "hex", "block_hash": "hex"} (object, optional) as in getdistributionplan
2132
+ "qualifier": "#TAG", (string, optional) as in getdistributionplan
2133
+ "weights": {"address": n, ...}, (object, optional) as in getdistributionplan
2134
+ "report": {"txid": "hex", "block_hash": "hex"} (object, optional) as in getdistributionplan
2135
+ "allocation": "holdings"|"equal", (string, optional, default "holdings") as in getdistributionplan
2136
+ "min_held": x.xxx, (numeric, optional) as in getdistributionplan
2137
+ }
2138
+ 2. options (object, optional)
2139
+ {
2140
+ "max_outputs": n (number, default 500, max 1000) recipients per batch
2141
+ }
2142
+
2143
+ Result:
2144
+ {
2145
+ "plan_hash": "hex",
2146
+ "max_outputs": n,
2147
+ "batches": [
2148
+ {
2149
+ "index": n,
2150
+ "batch_id": "hex", (string) SHA-256 of 0x04 || plan hash || max_outputs || index
2151
+ "first_recipient": n,
2152
+ "recipient_count": n,
2153
+ "amount": x.xxx, (numeric) total paid by the batch
2154
+ "outputs": { ... } (object) the payments in createrawtransaction format
2155
+ }, ...
2156
+ ]
2157
+ }
2158
+
2159
+ Examples:
2160
+ > neurai-cli getdistributionbatches '{"asset_name":"TRONCO","snapshot_height":12345,"distribution_asset_name":"XNA","amount":1000}'
2161
+
2162
+ &nbsp;<br> &nbsp;<br/>
2163
+ ## getdistributionplan
2164
+ &nbsp;<br/> getdistributionplan "asset_name" snapshot_height "distribution_asset_name" gross_distribution_amount ( "exception_addresses" {options} )
2165
+
2166
+ Computes, without spending anything, how gross_distribution_amount of the distribution asset is split among the
2167
+ holders of asset_name in its snapshot at snapshot_height (NIP-048). Each holder gets floor(amount * held / total)
2168
+ in whole units of the distribution asset, or floor(amount / holders) with equal allocation. The plan hash commits
2169
+ to the snapshot, the parameters and every payment;
2170
+ pay the recipients from any wallet, for instance with getdistributionbatches and createdistributionbatch.
2171
+
2172
+ Arguments:
2173
+ 1. "asset_name" (string, required) The asset whose holders receive the distribution
2174
+ 2. "snapshot_height" (number, required) The height of a snapshot taken with requestsnapshot
2175
+ 3. "distribution_asset_name" (string, required) The asset to distribute, or XNA
2176
+ 4. "gross_distribution_amount" (number, required) The amount to split, a multiple of the distribution asset's smallest unit
2177
+ 5. "exception_addresses" (string, optional) Comma-separated holder addresses to exclude
2178
+ 6. options (object, optional)
2179
+ {
2180
+ "remainder": "payer"|"largest", (string, default "payer") Where the undivided remainder goes: it stays with the
2181
+ payer, or one unit each to the largest fractional parts (ties by script)
2182
+ "allow_legacy_snapshot": bool, (boolean, default false) Accept a snapshot captured before NIP-048, which has no block identity
2183
+ "announcement": { (object, optional) The transaction that announced snapshot_height in advance
2184
+ "txid": "hex", (see getsnapshotannouncement); the plan then commits to it (format version 2)
2185
+ "block_hash": "hex" (optional) Its block, for nodes without -txindex
2186
+ },
2187
+ "qualifier": "#TAG", (string, optional) Only holders tagged with this qualifier at the height
2188
+ "weights": {"address": n, ...}, (object, optional) Weights of a work report, positive integers; they replace
2189
+ the holdings, and holders without a weight are excluded
2190
+ "report": {"txid": "hex", "block_hash": "hex"} (object, optional) The owner token transfer that anchored
2191
+ the report hash (SHA-256 of 0x07 || weights)
2192
+ "allocation": "holdings"|"equal", (string, default "holdings") Split in proportion to the holdings (or the
2193
+ report weights), or in equal shares among the eligible holders, whatever
2194
+ they hold; equal cannot be combined with weights
2195
+ "min_held": x.xxx, (numeric, optional) Only holders with at least this amount of asset_name
2196
+ }
2197
+
2198
+ A snapshot taken since NIP-048 D3 records, per holder, freezes, DEPIN self-revocations and qualifier tags; such
2199
+ holders are excluded. With a qualifier, report weights or both, the plan hash commits to them (format version 3);
2200
+ with equal allocation or a minimum holding, it commits to those too (format version 4).
2201
+
2202
+ Result:
2203
+ {
2204
+ "plan_hash": "hex", (string) SHA-256 commitment to the header and the Merkle root
2205
+ "merkle_root": "hex", (string) RFC 6962 root over the recipients, in order
2206
+ "version": n, (number) plan format version
2207
+ "network": "name", (string) network the plan belongs to
2208
+ "snapshot": {
2209
+ "asset_name": "name",
2210
+ "height": n,
2211
+ "block_hash": "hash", (string) block the snapshot was captured on; empty for a legacy snapshot
2212
+ "snapshot_hash": "hex", (string) commitment to the snapshot content
2213
+ "legacy": true|false,
2214
+ "confirmations": n
2215
+ },
2216
+ "distribution_asset_name": "name",
2217
+ "amount": x.xxx, (numeric) gross_distribution_amount
2218
+ "remainder_policy": "payer"|"largest",
2219
+ "allocation": "holdings"|"equal",
2220
+ "min_held": x.xxx, (numeric) minimum holding to be eligible, 0 if none
2221
+ "exception_addresses": [ "address", ... ], (array) sorted, as committed in the plan hash
2222
+ "total_held": x.xxx, (numeric) holdings of the eligible holders
2223
+ "distributed": x.xxx, (numeric) sum of the payments: the funds the payer needs, before fees
2224
+ "remainder": x.xxx, (numeric) amount left undistributed
2225
+ "recipients": [ (array) payments, ordered by output script
2226
+ { "address": "address", "script": "hex", "held": x.xxx, "amount": x.xxx }, ...
2227
+ ],
2228
+ "zero_amount": [ { "address": "address", "held": x.xxx }, ... ], (array) holders whose share rounds to zero
2229
+ "excluded": [ { "address": "address", "held": x.xxx, "reason": "..." }, ... ], (array) reason: exception, burn,
2230
+ globally_frozen, frozen, self_revoked, missing_qualifier, below_minimum or no_weight
2231
+ "announcement": { (object or null) The announcement, when given
2232
+ "txid": "hex", "height": n, "notice": n, "minimum_notice": n (notice: blocks between announcement and snapshot)
2233
+ },
2234
+ "verifiability": "announced"|"late_announcement"|"unannounced" (string) Whether other nodes could capture the
2235
+ same snapshot: without an announcement made with the minimum notice (-minsnapshotnotice),
2236
+ recipients rely on the issuer's snapshot or on replaysnapshot
2237
+ "qualifier": "#TAG"|null,
2238
+ "report": {"hash": "hex", "txid": "hex", "height": n}|null (recipients then also show their "weight")
2239
+ }
2240
+
2241
+ Examples:
2242
+ > neurai-cli getdistributionplan "TRONCO" 12345 "XNA" 1000
2243
+ > neurai-cli getdistributionplan "PHATSTACKS" 12345 "DIVIDENDS" 1000 "" '{"remainder":"largest"}'
2244
+ > neurai-cli getdistributionplan "&GRID" 12345 "XNA" 1000 "" '{"allocation":"equal","min_held":1}'
2245
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getdistributionplan", "params": ["TRONCO", 34987, "DIVIDENDS", 100000] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2246
+
2247
+ &nbsp;<br> &nbsp;<br/>
2248
+ ## getdistributionproof
2249
+ &nbsp;<br/> getdistributionproof {plan} "address"
2250
+
2251
+ Returns the RFC 6962 inclusion proof of one recipient of a distribution plan (NIP-048). With the plan's
2252
+ merkle_root it shows that the payment is part of the plan; it does not show that the amount is right or that
2253
+ no recipient is missing (recompute the plan for that).
2254
+
2255
+ Arguments:
2256
+ 1. plan (object, required) The plan parameters
2257
+ {
2258
+ "asset_name": "name", (string, required) as in getdistributionplan
2259
+ "snapshot_height": n, (number, required)
2260
+ "distribution_asset_name": "name", (string, required)
2261
+ "amount": x.xxx, (numeric, required) gross_distribution_amount
2262
+ "exception_addresses": "a,b", (string, optional)
2263
+ "remainder": "payer"|"largest", (string, optional, default "payer")
2264
+ "allow_legacy_snapshot": bool, (boolean, optional, default false)
2265
+ "announcement": {"txid": "hex", "block_hash": "hex"} (object, optional) as in getdistributionplan
2266
+ "qualifier": "#TAG", (string, optional) as in getdistributionplan
2267
+ "weights": {"address": n, ...}, (object, optional) as in getdistributionplan
2268
+ "report": {"txid": "hex", "block_hash": "hex"} (object, optional) as in getdistributionplan
2269
+ "allocation": "holdings"|"equal", (string, optional, default "holdings") as in getdistributionplan
2270
+ "min_held": x.xxx, (numeric, optional) as in getdistributionplan
2271
+ }
2272
+ 2. "address" (string, required) A recipient of the plan
2273
+
2274
+ Result:
2275
+ {
2276
+ "plan_hash": "hex",
2277
+ "merkle_root": "hex",
2278
+ "leaf_count": n,
2279
+ "index": n, (number) position of the recipient in the plan
2280
+ "address": "address",
2281
+ "script": "hex",
2282
+ "amount": x.xxx,
2283
+ "leaf_hash": "hex", (string) SHA-256 of 0x00 || script || amount
2284
+ "path": [ "hex", ... ] (array) sibling hashes, deepest first
2285
+ }
2286
+
2287
+ Examples:
2288
+ > neurai-cli getdistributionproof '{"asset_name":"TRONCO","snapshot_height":12345,"distribution_asset_name":"XNA","amount":1000}' "address"
2289
+
2290
+ &nbsp;<br> &nbsp;<br/>
2291
+ ## getgenerate
2074
2292
  &nbsp;<br/> getgenerate
2075
2293
 
2076
2294
  Return if the server is set to generate coins or not. The default is false.
@@ -2081,33 +2299,32 @@ Result
2081
2299
  true|false (boolean) If the server is set to generate coins or not
2082
2300
 
2083
2301
  Examples:
2084
- > neurai-cli getgenerate
2302
+ > neurai-cli getgenerate
2085
2303
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getgenerate", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2086
-
2087
- &nbsp;<br> &nbsp;<br/>
2088
- ## getibdstatus
2089
- &nbsp;<br/> getibdstatus
2090
2304
 
2305
+ &nbsp;<br> &nbsp;<br/>
2306
+ ## getibdstatus
2307
+ &nbsp;<br/> getibdstatus
2091
2308
  Returns header synchronization timing collected since process start.
2309
+ request_to_response_us includes peer response and local queueing time.
2092
2310
 
2093
2311
  Result:
2094
2312
  {
2095
- "blocks": n,
2096
- "headers": n,
2097
- "header_batches": n,
2098
- "headers_in_batches": n,
2099
- "unsolicited_header_responses": n,
2100
- "average_request_to_response_us": n,
2101
- "average_validation_us": n,
2102
- "peers": [...]
2313
+ "blocks": n, (numeric) current active-chain height
2314
+ "headers": n, (numeric) best validated header height
2315
+ "header_batches": n, (numeric) requested header batches received
2316
+ "headers_in_batches": n, (numeric) headers in those batches
2317
+ "average_request_to_response_us": n, (numeric) average request-to-response time
2318
+ "average_validation_us": n, (numeric) average local processing time
2319
+ "peers": [ ... ] (array) per-peer timing counters
2103
2320
  }
2104
2321
 
2105
2322
  Examples:
2106
2323
  > neurai-cli getibdstatus
2107
- > curl --user myusername --data-binary '{"jsonrpc":"2.0","id":1,"method":"getibdstatus","params":[]}' -H 'content-type: application/json' http://127.0.0.1:19001/
2108
-
2109
- &nbsp;<br> &nbsp;<br/>
2110
- ## getinfo
2324
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getibdstatus", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2325
+
2326
+ &nbsp;<br> &nbsp;<br/>
2327
+ ## getinfo
2111
2328
  &nbsp;<br/> getinfo
2112
2329
 
2113
2330
  DEPRECATED. Returns an object containing various state info.
@@ -2134,30 +2351,30 @@ Result:
2134
2351
  }
2135
2352
 
2136
2353
  Examples:
2137
- > neurai-cli getinfo
2354
+ > neurai-cli getinfo
2138
2355
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2139
-
2140
- &nbsp;<br> &nbsp;<br/>
2141
- ## getkawpowhash
2356
+
2357
+ &nbsp;<br> &nbsp;<br/>
2358
+ ## getkawpowhash
2142
2359
  &nbsp;<br/> getkawpowhash "header_hash" "mix_hash" nonce, height, "target"
2143
2360
 
2144
2361
  Get the kawpow hash for a block given its block data
2145
2362
 
2146
2363
  Arguments
2147
- 1. "header_hash" (string, required) the prow_pow header hash that was given to the gpu miner from this rpc client
2148
- 2. "mix_hash" (string, required) the mix hash that was mined by the gpu miner via rpc
2149
- 3. "nonce" (string, required) the hex nonce of the block that hashed the valid block
2364
+ 1. "header_hash" (string, required) the header hash given to the GPU miner (exactly 64 hex digits)
2365
+ 2. "mix_hash" (string, required) the mix hash mined by the GPU miner (exactly 64 hex digits)
2366
+ 3. "nonce" (string, required) 1 to 16 hex digits, optionally prefixed with 0x
2150
2367
  4. "height" (number, required) the height of the block data that is being hashed
2151
- 5. "target" (string, optional) the target of the block that is hash is trying to meet
2368
+ 5. "target" (string, optional) the target to meet (exactly 64 hex digits)
2152
2369
 
2153
2370
  Result:
2154
2371
 
2155
2372
  Examples:
2156
2373
  > neurai-cli getkawpowhash "header_hash" "mix_hash" "0x100000" 2456
2157
2374
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getkawpowhash", "params": ["header_hash" "mix_hash" "0x100000" 2456] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2158
-
2159
- &nbsp;<br> &nbsp;<br/>
2160
- ## getmasterkeyinfo
2375
+
2376
+ &nbsp;<br> &nbsp;<br/>
2377
+ ## getmasterkeyinfo
2161
2378
  &nbsp;<br/> getmasterkeyinfo
2162
2379
 
2163
2380
  Fetches and displays the master private key and the master public key.
@@ -2166,6 +2383,8 @@ Result:
2166
2383
  { (json object)
2167
2384
  "bip32_root_private" : (string) extended master private key,
2168
2385
  "bip32_root_public" : (string) extended master public key,
2386
+ "address_type" : (string) the wallet address type (-addresstype): legacy, pq or ecdsa
2387
+ "strict_ecdsa_derivation_path" : (string, ecdsa wallets) account path of its witness v3 keys
2169
2388
  "account_derivation_path" : (string) The derivation path to the account public/private keys
2170
2389
  "external_derivation_path" : (string) The derivation path prefix for receiving addresses
2171
2390
  "internal_derivation_path" : (string) The derivation path prefix for change addresses
@@ -2174,11 +2393,11 @@ Result:
2174
2393
  }
2175
2394
 
2176
2395
  Examples:
2177
- > neurai-cli getmasterkeyinfo
2396
+ > neurai-cli getmasterkeyinfo
2178
2397
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmasterkeyinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2179
-
2180
- &nbsp;<br> &nbsp;<br/>
2181
- ## getmemoryinfo
2398
+
2399
+ &nbsp;<br> &nbsp;<br/>
2400
+ ## getmemoryinfo
2182
2401
  &nbsp;<br/> getmemoryinfo ("mode")
2183
2402
  Returns an object containing information about memory usage.
2184
2403
  Arguments:
@@ -2202,11 +2421,11 @@ Result (mode "mallocinfo"):
2202
2421
  "<malloc version="1">..."
2203
2422
 
2204
2423
  Examples:
2205
- > neurai-cli getmemoryinfo
2424
+ > neurai-cli getmemoryinfo
2206
2425
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmemoryinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2207
-
2208
- &nbsp;<br> &nbsp;<br/>
2209
- ## getmempoolancestors
2426
+
2427
+ &nbsp;<br> &nbsp;<br/>
2428
+ ## getmempoolancestors
2210
2429
  &nbsp;<br/> getmempoolancestors txid (verbose)
2211
2430
 
2212
2431
  If txid is in the mempool, returns all in-mempool ancestors.
@@ -2235,6 +2454,7 @@ Result (for verbose=true):
2235
2454
  "ancestorcount" : n, (numeric) number of in-mempool ancestor transactions (including this one)
2236
2455
  "ancestorsize" : n, (numeric) virtual transaction size of in-mempool ancestors (including this one)
2237
2456
  "ancestorfees" : n, (numeric) modified fees (see above) of in-mempool ancestors (including this one)
2457
+ "poseidonwork" : n, (numeric) reserved Poseidon permutations for this transaction
2238
2458
  "wtxid" : hash, (string) hash of serialized transaction, including witness data
2239
2459
  "depends" : [ (array) unconfirmed transactions used as inputs for this transaction
2240
2460
  "transactionid", (string) parent transaction id
@@ -2245,9 +2465,9 @@ Result (for verbose=true):
2245
2465
  Examples:
2246
2466
  > neurai-cli getmempoolancestors "mytxid"
2247
2467
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempoolancestors", "params": ["mytxid"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2248
-
2249
- &nbsp;<br> &nbsp;<br/>
2250
- ## getmempooldescendants
2468
+
2469
+ &nbsp;<br> &nbsp;<br/>
2470
+ ## getmempooldescendants
2251
2471
  &nbsp;<br/> getmempooldescendants txid (verbose)
2252
2472
 
2253
2473
  If txid is in the mempool, returns all in-mempool descendants.
@@ -2276,6 +2496,7 @@ Result (for verbose=true):
2276
2496
  "ancestorcount" : n, (numeric) number of in-mempool ancestor transactions (including this one)
2277
2497
  "ancestorsize" : n, (numeric) virtual transaction size of in-mempool ancestors (including this one)
2278
2498
  "ancestorfees" : n, (numeric) modified fees (see above) of in-mempool ancestors (including this one)
2499
+ "poseidonwork" : n, (numeric) reserved Poseidon permutations for this transaction
2279
2500
  "wtxid" : hash, (string) hash of serialized transaction, including witness data
2280
2501
  "depends" : [ (array) unconfirmed transactions used as inputs for this transaction
2281
2502
  "transactionid", (string) parent transaction id
@@ -2286,9 +2507,9 @@ Result (for verbose=true):
2286
2507
  Examples:
2287
2508
  > neurai-cli getmempooldescendants "mytxid"
2288
2509
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempooldescendants", "params": ["mytxid"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2289
-
2290
- &nbsp;<br> &nbsp;<br/>
2291
- ## getmempoolentry
2510
+
2511
+ &nbsp;<br> &nbsp;<br/>
2512
+ ## getmempoolentry
2292
2513
  &nbsp;<br/> getmempoolentry txid
2293
2514
 
2294
2515
  Returns mempool data for given transaction
@@ -2309,6 +2530,7 @@ Result:
2309
2530
  "ancestorcount" : n, (numeric) number of in-mempool ancestor transactions (including this one)
2310
2531
  "ancestorsize" : n, (numeric) virtual transaction size of in-mempool ancestors (including this one)
2311
2532
  "ancestorfees" : n, (numeric) modified fees (see above) of in-mempool ancestors (including this one)
2533
+ "poseidonwork" : n, (numeric) reserved Poseidon permutations for this transaction
2312
2534
  "wtxid" : hash, (string) hash of serialized transaction, including witness data
2313
2535
  "depends" : [ (array) unconfirmed transactions used as inputs for this transaction
2314
2536
  "transactionid", (string) parent transaction id
@@ -2318,9 +2540,9 @@ Result:
2318
2540
  Examples:
2319
2541
  > neurai-cli getmempoolentry "mytxid"
2320
2542
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempoolentry", "params": ["mytxid"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2321
-
2322
- &nbsp;<br> &nbsp;<br/>
2323
- ## getmempoolinfo
2543
+
2544
+ &nbsp;<br> &nbsp;<br/>
2545
+ ## getmempoolinfo
2324
2546
  &nbsp;<br/> getmempoolinfo
2325
2547
 
2326
2548
  Returns details on the active state of the TX memory pool.
@@ -2335,11 +2557,11 @@ Result:
2335
2557
  }
2336
2558
 
2337
2559
  Examples:
2338
- > neurai-cli getmempoolinfo
2560
+ > neurai-cli getmempoolinfo
2339
2561
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempoolinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2340
-
2341
- &nbsp;<br> &nbsp;<br/>
2342
- ## getmininginfo
2562
+
2563
+ &nbsp;<br> &nbsp;<br/>
2564
+ ## getmininginfo
2343
2565
  &nbsp;<br/> getmininginfo
2344
2566
 
2345
2567
  Returns a json object containing mining-related information.
@@ -2358,11 +2580,11 @@ Result:
2358
2580
  }
2359
2581
 
2360
2582
  Examples:
2361
- > neurai-cli getmininginfo
2583
+ > neurai-cli getmininginfo
2362
2584
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmininginfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2363
-
2364
- &nbsp;<br> &nbsp;<br/>
2365
- ## getmywords
2585
+
2586
+ &nbsp;<br> &nbsp;<br/>
2587
+ ## getmywords
2366
2588
  &nbsp;<br/> getmywords ( "account" )
2367
2589
 
2368
2590
  Returns the 12 words and passphrase used by BIP39 to generate the wallets private keys
@@ -2373,11 +2595,11 @@ Result:
2373
2595
  "passphrase:" (optional) Only show if passphrase was used when creating the wallet
2374
2596
 
2375
2597
  Examples:
2376
- > neurai-cli getmywords
2598
+ > neurai-cli getmywords
2377
2599
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmywords", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2378
-
2379
- &nbsp;<br> &nbsp;<br/>
2380
- ## getnettotals
2600
+
2601
+ &nbsp;<br> &nbsp;<br/>
2602
+ ## getnettotals
2381
2603
  &nbsp;<br/> getnettotals
2382
2604
 
2383
2605
  Returns information about network traffic, including bytes in, bytes out,
@@ -2400,11 +2622,11 @@ Result:
2400
2622
  }
2401
2623
 
2402
2624
  Examples:
2403
- > neurai-cli getnettotals
2625
+ > neurai-cli getnettotals
2404
2626
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getnettotals", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2405
-
2406
- &nbsp;<br> &nbsp;<br/>
2407
- ## getnetworkhashps
2627
+
2628
+ &nbsp;<br> &nbsp;<br/>
2629
+ ## getnetworkhashps
2408
2630
  &nbsp;<br/> getnetworkhashps ( nblocks height )
2409
2631
 
2410
2632
  Returns the estimated network hashes per second based on the last n blocks.
@@ -2419,11 +2641,11 @@ Result:
2419
2641
  x (numeric) Hashes per second estimated
2420
2642
 
2421
2643
  Examples:
2422
- > neurai-cli getnetworkhashps
2644
+ > neurai-cli getnetworkhashps
2423
2645
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getnetworkhashps", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2424
-
2425
- &nbsp;<br> &nbsp;<br/>
2426
- ## getnetworkinfo
2646
+
2647
+ &nbsp;<br> &nbsp;<br/>
2648
+ ## getnetworkinfo
2427
2649
  &nbsp;<br/> getnetworkinfo
2428
2650
  Returns an object containing various state info regarding P2P networking.
2429
2651
 
@@ -2461,31 +2683,31 @@ Result:
2461
2683
  }
2462
2684
 
2463
2685
  Examples:
2464
- > neurai-cli getnetworkinfo
2686
+ > neurai-cli getnetworkinfo
2465
2687
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getnetworkinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2466
-
2467
- &nbsp;<br> &nbsp;<br/>
2468
- ## getnewaddress
2688
+
2689
+ &nbsp;<br> &nbsp;<br/>
2690
+ ## getnewaddress
2469
2691
  &nbsp;<br/> getnewaddress ( "account" "address_type" )
2470
2692
 
2471
2693
  Returns a new Neurai address for receiving payments.
2472
- If 'account' is specified (DEPRECATED), it is added to the address book
2694
+ If 'account' is specified (DEPRECATED), it is added to the address book
2473
2695
  so payments received with the address will be credited to 'account'.
2474
2696
 
2475
2697
  Arguments:
2476
2698
  1. "account" (string, optional) DEPRECATED. The account name for the address to be linked to. If not provided, the default account "" is used. It can also be set to the empty string "" to represent the default account. The account does not need to exist, it will be created if there is no account by the given name.
2477
- 2. "address_type" (string, optional) The address family: "legacy" (Base58, secp256k1), "pq" (strict post-quantum, witness v2, pq1.../tpq1...) or "ecdsa" (strict ECDSA, witness v3, nq1r.../tnq1r...). If omitted, the wallet's default family is used (legacy for classic wallets, generic AuthScript v1 for PQ wallets).
2699
+ 2. "address_type" (string, optional) The address family: "legacy" (Base58, secp256k1), "pq" (strict post-quantum, witness v2, pq1.../tpq1...) or "ecdsa" (strict ECDSA, witness v3, nq1r.../tnq1r...). If omitted, the wallet's address type (-addresstype when it was created, see getwalletinfo) is used. "pq" needs a pq wallet; an ecdsa wallet refuses "legacy". Strict addresses are handed out before the network activates them, but payments to them are refused until then. Generic AuthScript v1 (nc1p.../tnc1p...) is a contract family and is never handed out by the wallet.
2478
2700
 
2479
2701
  Result:
2480
2702
  "address" (string) The new neurai address
2481
2703
 
2482
2704
  Examples:
2483
- > neurai-cli getnewaddress
2705
+ > neurai-cli getnewaddress
2484
2706
  > neurai-cli getnewaddress "" "ecdsa"
2485
2707
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getnewaddress", "params": ["", "pq"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2486
-
2487
- &nbsp;<br> &nbsp;<br/>
2488
- ## getpeerinfo
2708
+
2709
+ &nbsp;<br> &nbsp;<br/>
2710
+ ## getpeerinfo
2489
2711
  &nbsp;<br/> getpeerinfo
2490
2712
 
2491
2713
  Returns data about each connected network node as a json array of objects.
@@ -2534,14 +2756,37 @@ Result:
2534
2756
  ]
2535
2757
 
2536
2758
  Examples:
2537
- > neurai-cli getpeerinfo
2759
+ > neurai-cli getpeerinfo
2538
2760
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getpeerinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2539
-
2540
- &nbsp;<br> &nbsp;<br/>
2541
- ## getpubkey
2761
+
2762
+ &nbsp;<br> &nbsp;<br/>
2763
+ ## getprivacypoolinfo
2764
+ &nbsp;<br/> getprivacypoolinfo pool ( limit )
2765
+
2766
+ Read public state-thread identity and confirmed state, without registering a pool.
2767
+ Requires -spentindex and -txindex and readable historical transactions.
2768
+ pool: {"txid": birth_txid, "vout": birth_output}
2769
+ limit: maximum transitions to follow (default 100, maximum 1000).
2770
+ history_complete=false means current_state is unknown; continue with next_cursor.
2771
+ The reported profile describes the transport, not an audited privacy circuit.
2772
+
2773
+ &nbsp;<br> &nbsp;<br/>
2774
+ ## getprivacypoolupdates
2775
+ &nbsp;<br/> getprivacypoolupdates pool ( cursor limit )
2776
+
2777
+ Return confirmed public pool transactions, including complete witnesses, in state-thread order.
2778
+ pool: {"txid": birth_txid, "vout": birth_output}; no registry or viewing key.
2779
+ cursor: null for birth, otherwise the unchanged next_cursor from a previous query.
2780
+ limit: maximum updates (default 100, maximum 1000); pages also have a 1 MiB raw-byte limit.
2781
+ Pages pin one chain snapshot; a completed cursor refreshes to the current tip.
2782
+ A reorganized snapshot or foreign/tampered cursor is rejected. Mempool spends are excluded.
2783
+ No matching successor ends this transport; it does not prove the contract is closed.
2784
+
2785
+ &nbsp;<br> &nbsp;<br/>
2786
+ ## getpubkey
2542
2787
  &nbsp;<br/> getpubkey "address"
2543
2788
 
2544
- Returns the public key for an address that has revealed it by spending (requires pubkeyindex to be enabled).
2789
+ Returns the public key for a Legacy, AuthScript v1 or strict ECDSA address that has revealed it by spending (requires pubkeyindex to be enabled).
2545
2790
 
2546
2791
  Arguments:
2547
2792
  1. "address" (string, required) The Neurai address
@@ -2558,26 +2803,26 @@ Result:
2558
2803
  Examples:
2559
2804
  > neurai-cli getpubkey "NXa1b2c3d4e5f6..."
2560
2805
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getpubkey", "params": ["NXa1b2c3d4e5f6..."] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2561
-
2562
- &nbsp;<br> &nbsp;<br/>
2563
- ## getrawchangeaddress
2806
+
2807
+ &nbsp;<br> &nbsp;<br/>
2808
+ ## getrawchangeaddress
2564
2809
  &nbsp;<br/> getrawchangeaddress ( "address_type" )
2565
2810
 
2566
2811
  Returns a new Neurai address, for receiving change.
2567
2812
  This is for use with raw transactions, NOT normal use.
2568
2813
 
2569
2814
  Arguments:
2570
- 1. "address_type" (string, optional) "legacy", "pq" (strict witness v2) or "ecdsa" (strict witness v3). Default: the wallet's default family.
2815
+ 1. "address_type" (string, optional) "legacy", "pq" (strict witness v2) or "ecdsa" (strict witness v3). Default: the wallet's address type (-addresstype when it was created).
2571
2816
 
2572
2817
  Result:
2573
2818
  "address" (string) The address
2574
2819
 
2575
2820
  Examples:
2576
- > neurai-cli getrawchangeaddress
2821
+ > neurai-cli getrawchangeaddress
2577
2822
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getrawchangeaddress", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2578
-
2579
- &nbsp;<br> &nbsp;<br/>
2580
- ## getrawmempool
2823
+
2824
+ &nbsp;<br> &nbsp;<br/>
2825
+ ## getrawmempool
2581
2826
  &nbsp;<br/> getrawmempool ( verbose )
2582
2827
 
2583
2828
  Returns all transaction ids in memory pool as a json array of string transaction ids.
@@ -2607,6 +2852,7 @@ Result: (for verbose = true):
2607
2852
  "ancestorcount" : n, (numeric) number of in-mempool ancestor transactions (including this one)
2608
2853
  "ancestorsize" : n, (numeric) virtual transaction size of in-mempool ancestors (including this one)
2609
2854
  "ancestorfees" : n, (numeric) modified fees (see above) of in-mempool ancestors (including this one)
2855
+ "poseidonwork" : n, (numeric) reserved Poseidon permutations for this transaction
2610
2856
  "wtxid" : hash, (string) hash of serialized transaction, including witness data
2611
2857
  "depends" : [ (array) unconfirmed transactions used as inputs for this transaction
2612
2858
  "transactionid", (string) parent transaction id
@@ -2617,9 +2863,9 @@ Result: (for verbose = true):
2617
2863
  Examples:
2618
2864
  > neurai-cli getrawmempool true
2619
2865
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getrawmempool", "params": [true] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2620
-
2621
- &nbsp;<br> &nbsp;<br/>
2622
- ## getrawtransaction
2866
+
2867
+ &nbsp;<br> &nbsp;<br/>
2868
+ ## getrawtransaction
2623
2869
  &nbsp;<br/> getrawtransaction "txid" ( verbose )
2624
2870
 
2625
2871
  NOTE: By default this function only works for mempool transactions. If the -txindex option is
@@ -2650,7 +2896,7 @@ Result (if verbose is set to true):
2650
2896
  "vin" : [ (array of json objects)
2651
2897
  {
2652
2898
  "txid": "id", (string) The transaction id
2653
- "vout": n, (numeric)
2899
+ "vout": n, (numeric)
2654
2900
  "scriptSig": { (json object) The script
2655
2901
  "asm": "asm", (string) asm
2656
2902
  "hex": "hex" (string) hex
@@ -2687,9 +2933,9 @@ Examples:
2687
2933
  > neurai-cli getrawtransaction "mytxid"
2688
2934
  > neurai-cli getrawtransaction "mytxid" true
2689
2935
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getrawtransaction", "params": ["mytxid", true] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2690
-
2691
- &nbsp;<br> &nbsp;<br/>
2692
- ## getreceivedbyaccount
2936
+
2937
+ &nbsp;<br> &nbsp;<br/>
2938
+ ## getreceivedbyaccount
2693
2939
  &nbsp;<br/> getreceivedbyaccount "account" ( minconf )
2694
2940
 
2695
2941
  DEPRECATED. Returns the total amount received by addresses with <account> in transactions with at least [minconf] confirmations.
@@ -2714,9 +2960,9 @@ The amount with at least 6 confirmations
2714
2960
 
2715
2961
  As a json rpc call
2716
2962
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getreceivedbyaccount", "params": ["tabby", 6] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2717
-
2718
- &nbsp;<br> &nbsp;<br/>
2719
- ## getreceivedbyaddress
2963
+
2964
+ &nbsp;<br> &nbsp;<br/>
2965
+ ## getreceivedbyaddress
2720
2966
  &nbsp;<br/> getreceivedbyaddress "address" ( minconf )
2721
2967
 
2722
2968
  Returns the total amount received by the given address in transactions with at least minconf confirmations.
@@ -2741,9 +2987,9 @@ The amount with at least 6 confirmations
2741
2987
 
2742
2988
  As a json rpc call
2743
2989
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getreceivedbyaddress", "params": ["1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX", 6] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2744
-
2745
- &nbsp;<br> &nbsp;<br/>
2746
- ## getrpcinfo
2990
+
2991
+ &nbsp;<br> &nbsp;<br/>
2992
+ ## getrpcinfo
2747
2993
  &nbsp;<br/> getrpcinfo
2748
2994
  Returns details of the RPC server.
2749
2995
 
@@ -2752,43 +2998,257 @@ Result:
2752
2998
  "active_commands" (array) All active commands
2753
2999
  [
2754
3000
  { (object) Information about an active command
2755
- "method" (string) The name of the RPC command
3001
+ "method" (string) The name of the RPC command
2756
3002
  "duration" (numeric) The running time in microseconds
2757
3003
  },...
2758
3004
  ],
2759
3005
  }
2760
- > neurai-cli getrpcinfo
3006
+ > neurai-cli getrpcinfo
2761
3007
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getrpcinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2762
-
2763
- &nbsp;<br> &nbsp;<br/>
2764
- ## getsnapshot
2765
- &nbsp;<br/> getsnapshot "asset_name" block_height
2766
3008
 
2767
- THIS COMMAND IS NOT YET ACTIVE!
2768
- https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3009
+ &nbsp;<br> &nbsp;<br/>
3010
+ ## getsilentpaymentcode
3011
+ &nbsp;<br/> getsilentpaymentcode
2769
3012
 
2770
- Returns details for the asset snapshot, at the specified height
3013
+ Returns the reusable silent payment code of this wallet (NIP-047).
3014
+ Every payment to the code lands on a new strict ECDSA (witness v3) output
3015
+ that only this wallet can link to the code.
2771
3016
 
2772
- Arguments:
2773
- 1. "asset_name" (string, required) the name of the asset
2774
- 2. block_height (int, required) the block height of the snapshot
3017
+ Result:
3018
+ {
3019
+ "code": "str", (string) payment code (nsp1... / tnsp1...)
3020
+ "network": "str", (string) main, test or regtest
3021
+ "scan_pubkey": "hex", (string) B_scan
3022
+ "spend_pubkey": "hex", (string) B_spend
3023
+ "view_only": true|false (boolean) imported view key: payments are detected, not spendable
3024
+ "verified": true (boolean) checked against the wallet seed in this session. An encrypted
3025
+ wallet shows its code only after one unlock in the session
3026
+ }
3027
+
3028
+ Examples:
3029
+ > neurai-cli getsilentpaymentcode
3030
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getsilentpaymentcode", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3031
+
3032
+ &nbsp;<br> &nbsp;<br/>
3033
+ ## getsilentpaymentindexinfo
3034
+ &nbsp;<br/> getsilentpaymentindexinfo
3035
+
3036
+ State of the NIP-047 silent payment index (-silentpaymentindex).
3037
+
3038
+ Result:
3039
+ {
3040
+ "enabled" : true|false, (boolean) whether the node maintains the index
3041
+ "state" : "str", (string) disabled, ready or incomplete (records missing and their blocks pruned)
3042
+ "schema" : n, (numeric) storage schema of the records
3043
+ "formats" : [n,...], (array) public formats served
3044
+ "context" : "hex", (string) NIP-047 context N: network id, genesis, profile and family
3045
+ "start_height" : n, (numeric) first indexed height: max(1, strict AuthScript activation)
3046
+ "synced_height" : n, (numeric) every active block from start_height to this height has a record
3047
+ "synced_hash" : "hash", (string) hash of the block at synced_height
3048
+ "complete" : true|false, (boolean) ready and synced up to the tip
3049
+ "missing" : [[n,n],...], (array) height ranges without a record or block data to rebuild it
3050
+ "pruned" : true|false (boolean) whether the node has deleted block files
3051
+ }
3052
+
3053
+ Examples:
3054
+ > neurai-cli getsilentpaymentindexinfo
3055
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getsilentpaymentindexinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3056
+
3057
+ &nbsp;<br> &nbsp;<br/>
3058
+ ## getsilentpaymentinfo
3059
+ &nbsp;<br/> getsilentpaymentinfo
3060
+
3061
+ Returns the silent payment scanning state of this wallet.
3062
+
3063
+ Result:
3064
+ {
3065
+ "enabled": true|false, (boolean) the wallet has an identity (own or view key)
3066
+ "view_only": true|false,
3067
+ "code": "str", (string) once checked against the seed in this session and while
3068
+ the identity is sound
3069
+ "code_verified": true|false,(boolean) code checked against the seed in this session
3070
+ "identity_error": "str", (string) damaged identity: the code must not be used
3071
+ "paused": true|false, (boolean) locked wallet: scanning waits for walletpassphrase
3072
+ "scanned_height": n, (numeric) last block really scanned (-1: none)
3073
+ "scanned_hash": "hex",
3074
+ "tip_height": n,
3075
+ "blocks_behind": n,
3076
+ "error": "str", (string) why scanning stopped (missing block or undo data)
3077
+ "payments": n
3078
+ }
3079
+
3080
+ Examples:
3081
+ > neurai-cli getsilentpaymentinfo
3082
+
3083
+ &nbsp;<br> &nbsp;<br/>
3084
+ ## getsilentpaymenttweaks
3085
+ &nbsp;<br/> getsilentpaymenttweaks "blockhash" ( "encoding" )
3086
+
3087
+ NIP-047 light client data of one block: every eligible transaction with a native v3 output,
3088
+ its public tweak T = h*A and all its native v3 outputs, plus every native v3 output the block spends.
3089
+ A receiver computes b_scan*T for each entry; the node learns nothing about it.
3090
+ Requires -silentpaymentindex.
3091
+
3092
+ Arguments:
3093
+ 1. "blockhash" (string, required) the block hash
3094
+ 2. "encoding" (string, optional, default=json) json, or hex for the binary message of type 1
3095
+
3096
+ Result (json):
3097
+ {
3098
+ "format" : 1,
3099
+ "context" : "hex", (string) NIP-047 context N
3100
+ "block" : { (object) immutable for this block hash
3101
+ "height" : n,
3102
+ "hash" : "hash",
3103
+ "prev" : "hash",
3104
+ "entries" : [
3105
+ {
3106
+ "txid" : "hex",
3107
+ "tweak" : "hex", (string) 33-byte compressed point T
3108
+ "outputs" : [{ "vout" : n, "commitment" : "hex", "value_sat" : "n" },...]
3109
+ },...
3110
+ ],
3111
+ "spent" : [{ "txid" : "hex", "vout" : n },...],
3112
+ "digest" : "hex" (string) tagged hash of the canonical block bytes
3113
+ },
3114
+ "in_active_chain" : true|false
3115
+ }
3116
+
3117
+ Result (hex):
3118
+ "hex" (string) binary message of type 1
3119
+
3120
+ Examples:
3121
+ > neurai-cli getsilentpaymenttweaks "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"
3122
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getsilentpaymenttweaks", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3123
+
3124
+ &nbsp;<br> &nbsp;<br/>
3125
+ ## getsilentpaymenttweaksrange
3126
+ &nbsp;<br/> getsilentpaymenttweaksrange start_height count ( "anchor_hash" "encoding" )
3127
+
3128
+ NIP-047 light client data of consecutive blocks of the active chain, as getsilentpaymenttweaks.
3129
+ The blocks come from one snapshot of the active chain. Whole blocks only: at least one, up to
3130
+ 1000 blocks and 4 MB. Requires -silentpaymentindex.
3131
+
3132
+ Arguments:
3133
+ 1. start_height (numeric, required) first height, from start_height of getsilentpaymentindexinfo
3134
+ up to the tip + 1 (an empty answer with status "tip")
3135
+ 2. count (numeric, required) number of blocks wanted
3136
+ 3. "anchor_hash" (string, optional) hash the client has at start_height - 1. If it left the active
3137
+ chain the answer is {"reorg": true, "fork_height": n}: continue from fork_height + 1
3138
+ 4. "encoding" (string, optional, default=json) json, or hex for the binary message of type 2
3139
+
3140
+ Result (json):
3141
+ {
3142
+ "format" : 1,
3143
+ "context" : "hex",
3144
+ "snapshot" : { "height" : n, "hash" : "hash" }, (object) tip when the request was served
3145
+ "synced_height" : n,
3146
+ "blocks" : [ {...},... ], (array) as "block" in getsilentpaymenttweaks
3147
+ "next_height" : n, (numeric) height after the last block returned
3148
+ "status" : "str" (string) more: ask again now; tip: wait for a new block;
3149
+ incomplete: the index lacks data from next_height
3150
+ }
3151
+
3152
+ Examples:
3153
+ > neurai-cli getsilentpaymenttweaksrange 1000 100
3154
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getsilentpaymenttweaksrange", "params": [1000, 100, "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3155
+
3156
+ &nbsp;<br> &nbsp;<br/>
3157
+ ## getsnapshot
3158
+ &nbsp;<br/> getsnapshot "asset_name" block_height
3159
+
3160
+ THIS COMMAND IS NOT YET ACTIVE!
3161
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
3162
+
3163
+ Returns details for the asset snapshot, at the specified height
3164
+
3165
+ Arguments:
3166
+ 1. "asset_name" (string, required) the name of the asset
3167
+ 2. block_height (int, required) the block height of the snapshot
2775
3168
 
2776
3169
  Result:
2777
3170
  {
2778
3171
  name: (string),
2779
3172
  height: (number),
3173
+ block_hash: (string) the block the snapshot was captured on; empty for a legacy snapshot
3174
+ snapshot_hash: (string) commitment to the snapshot content (NIP-048); empty for a legacy snapshot
3175
+ format: (number) 0 legacy, 1 bound to its block, 2 also with holder state (NIP-048 D3)
3176
+ global_frozen: (bool, format 2) the asset was globally frozen
2780
3177
  owners: [
2781
3178
  {
2782
3179
  address: (string),
2783
3180
  amount_owned: (number),
3181
+ frozen: (bool, format 2) frozen for the asset (restricted asset or DEPIN owner freeze)
3182
+ self_revoked: (bool, format 2) a DEPIN holder that revoked itself
3183
+ tags: [ (string), ... ] (format 2) qualifier tags of the address
2784
3184
  }
2785
3185
  }
2786
3186
 
2787
3187
  Examples:
2788
3188
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getsnapshot", "params": ["ASSET_NAME" 28546] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2789
-
2790
- &nbsp;<br> &nbsp;<br/>
2791
- ## getsnapshotrequest
3189
+
3190
+ &nbsp;<br> &nbsp;<br/>
3191
+ ## getsnapshotannouncement
3192
+ &nbsp;<br/> getsnapshotannouncement "asset_name" snapshot_height
3193
+
3194
+ Returns the message that announces a snapshot height before the chain reaches it (NIP-048). The holder of the
3195
+ owner token sends it to itself with that message, for instance:
3196
+ transfer "ASSET!" 1 "owner_token_address" "message"
3197
+ Other nodes that see the announcement request the same snapshot and can check the plan independently.
3198
+ A plan names the announcement with its "announcement" option.
3199
+
3200
+ Arguments:
3201
+ 1. "asset_name" (string, required) The asset whose holders will be snapshotted
3202
+ 2. snapshot_height (number, required) The future snapshot height
3203
+
3204
+ Result:
3205
+ {
3206
+ "asset_name": "name",
3207
+ "snapshot_height": n,
3208
+ "owner_token": "name", (string) the token that must carry the message
3209
+ "message": "hex", (string) SHA-256 of 0x05 || network || asset || height
3210
+ "minimum_notice": n, (number) blocks the announcement must precede the height (-minsnapshotnotice)
3211
+ "notice_if_mined_next": n (number) the notice if the announcement is mined in the next block
3212
+ }
3213
+
3214
+ Examples:
3215
+ > neurai-cli getsnapshotannouncement "TRONCO" 12345
3216
+
3217
+ &nbsp;<br> &nbsp;<br/>
3218
+ ## getsnapshotrecipients
3219
+ &nbsp;<br/> getsnapshotrecipients "asset_name" snapshot_height
3220
+
3221
+ The holders in a snapshot with what an encrypted bulletin to them needs (NIP-048 D5). Encryption follows DePIN
3222
+ messaging: a holder is ready when its address is P2PKH or strict ECDSA and its public key is in -pubkeyindex.
3223
+ The others are listed too, so no holder is skipped silently. Needs -pubkeyindex.
3224
+
3225
+ Arguments:
3226
+ 1. "asset_name" (string, required) The asset of the snapshot
3227
+ 2. snapshot_height (number, required) The snapshot height
3228
+
3229
+ Result:
3230
+ {
3231
+ "asset_name": "name",
3232
+ "height": n,
3233
+ "block_hash": "hash",
3234
+ "snapshot_hash": "hex",
3235
+ "ready": n, "key_not_revealed": n, "unsupported_type": n,
3236
+ "holders": [
3237
+ {
3238
+ "address": "address",
3239
+ "held": x.xxx,
3240
+ "state": "ready"|"key_not_revealed"|"unsupported_type",
3241
+ "pubkey": "hex", (string, when ready)
3242
+ "frozen": bool, "self_revoked": bool (snapshots with holder state)
3243
+ }, ...
3244
+ ]
3245
+ }
3246
+
3247
+ Examples:
3248
+ > neurai-cli getsnapshotrecipients "&TOKEN" 12345
3249
+
3250
+ &nbsp;<br> &nbsp;<br/>
3251
+ ## getsnapshotrequest
2792
3252
  &nbsp;<br/> getsnapshotrequest "asset_name" block_height
2793
3253
 
2794
3254
  Retrieves the specified snapshot request details.
@@ -2806,9 +3266,9 @@ Result:
2806
3266
  Examples:
2807
3267
  > neurai-cli getsnapshotrequest "TRONCO" 12345
2808
3268
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getsnapshotrequest", "params": ["PHATSTACKS" 34987] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2809
-
2810
- &nbsp;<br> &nbsp;<br/>
2811
- ## getspentinfo
3269
+
3270
+ &nbsp;<br> &nbsp;<br/>
3271
+ ## getspentinfo
2812
3272
  &nbsp;<br/> getspentinfo
2813
3273
 
2814
3274
  Returns the txid and index where an output is spent.
@@ -2829,9 +3289,9 @@ Result:
2829
3289
  Examples:
2830
3290
  > neurai-cli getspentinfo '{"txid": "0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9", "index": 0}'
2831
3291
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getspentinfo", "params": [{"txid": "0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9", "index": 0}] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2832
-
2833
- &nbsp;<br> &nbsp;<br/>
2834
- ## gettransaction
3292
+
3293
+ &nbsp;<br> &nbsp;<br/>
3294
+ ## gettransaction
2835
3295
  &nbsp;<br/> gettransaction "txid" ( include_watchonly )
2836
3296
 
2837
3297
  Get detailed information about in-wallet transaction <txid>
@@ -2843,7 +3303,7 @@ Arguments:
2843
3303
  Result:
2844
3304
  {
2845
3305
  "amount" : x.xxx, (numeric) The transaction amount in XNA
2846
- "fee": x.xxx, (numeric) The amount of the fee in XNA. This is negative and only available for the
3306
+ "fee": x.xxx, (numeric) The amount of the fee in XNA. This is negative and only available for the
2847
3307
  'send' category of transactions.
2848
3308
  "confirmations" : n, (numeric) The number of confirmations
2849
3309
  "blockhash" : "hash", (string) The block hash
@@ -2852,8 +3312,6 @@ Result:
2852
3312
  "txid" : "transactionid", (string) The transaction id.
2853
3313
  "time" : ttt, (numeric) The transaction time in seconds since epoch (1 Jan 1970 GMT)
2854
3314
  "timereceived" : ttt, (numeric) The time received in seconds since epoch (1 Jan 1970 GMT)
2855
- "bip125-replaceable": "yes|no|unknown", (string) Whether this transaction could be replaced due to BIP125 (replace-by-fee);
2856
- may be unknown for unconfirmed transactions not in the mempool
2857
3315
  "details" : [
2858
3316
  {
2859
3317
  "account" : "accountname", (string) DEPRECATED. The account name involved in the transaction, can be "" for the default account.
@@ -2862,9 +3320,9 @@ Result:
2862
3320
  "amount" : x.xxx, (numeric) The amount in XNA
2863
3321
  "label" : "label", (string) A comment for the address/transaction, if any
2864
3322
  "vout" : n, (numeric) the vout value
2865
- "fee": x.xxx, (numeric) The amount of the fee in XNA. This is negative and only available for the
3323
+ "fee": x.xxx, (numeric) The amount of the fee in XNA. This is negative and only available for the
2866
3324
  'send' category of transactions.
2867
- "abandoned": xxx (bool) 'true' if the transaction has been abandoned (inputs are respendable). Only available for the
3325
+ "abandoned": xxx (bool) 'true' if the transaction has been abandoned (inputs are respendable). Only available for the
2868
3326
  'send' category of transactions.
2869
3327
  }
2870
3328
  ,...
@@ -2887,9 +3345,9 @@ Examples:
2887
3345
  > neurai-cli gettransaction "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"
2888
3346
  > neurai-cli gettransaction "1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d" true
2889
3347
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "gettransaction", "params": ["1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2890
-
2891
- &nbsp;<br> &nbsp;<br/>
2892
- ## gettxout
3348
+
3349
+ &nbsp;<br> &nbsp;<br/>
3350
+ ## gettxout
2893
3351
  &nbsp;<br/> gettxout "txid" n ( include_mempool )
2894
3352
 
2895
3353
  Returns details about an unspent transaction output.
@@ -2905,8 +3363,8 @@ Result:
2905
3363
  "confirmations" : n, (numeric) The number of confirmations
2906
3364
  "value" : x.xxx, (numeric) The transaction value in XNA
2907
3365
  "scriptPubKey" : { (json object)
2908
- "asm" : "code", (string)
2909
- "hex" : "hex", (string)
3366
+ "asm" : "code", (string)
3367
+ "hex" : "hex", (string)
2910
3368
  "reqSigs" : n, (numeric) Number of required signatures
2911
3369
  "type" : "pubkeyhash", (string) The type, eg pubkeyhash
2912
3370
  "addresses" : [ (array of string) array of neurai addresses
@@ -2920,16 +3378,16 @@ Result:
2920
3378
  Examples:
2921
3379
 
2922
3380
  Get unspent transactions
2923
- > neurai-cli listunspent
3381
+ > neurai-cli listunspent
2924
3382
 
2925
3383
  View the details
2926
3384
  > neurai-cli gettxout "txid" 1
2927
3385
 
2928
3386
  As a json rpc call
2929
3387
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "gettxout", "params": ["txid", 1] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2930
-
2931
- &nbsp;<br> &nbsp;<br/>
2932
- ## gettxoutproof
3388
+
3389
+ &nbsp;<br> &nbsp;<br/>
3390
+ ## gettxoutproof
2933
3391
  &nbsp;<br/> gettxoutproof ["txid",...] ( blockhash )
2934
3392
 
2935
3393
  Returns a hex-encoded proof that "txid" was included in a block.
@@ -2949,9 +3407,9 @@ Arguments:
2949
3407
 
2950
3408
  Result:
2951
3409
  "data" (string) A string that is a serialized, hex-encoded data for the proof.
2952
-
2953
- &nbsp;<br> &nbsp;<br/>
2954
- ## gettxoutsetinfo
3410
+
3411
+ &nbsp;<br> &nbsp;<br/>
3412
+ ## gettxoutsetinfo
2955
3413
  &nbsp;<br/> gettxoutsetinfo
2956
3414
 
2957
3415
  Returns statistics about the unspent transaction output set.
@@ -2970,16 +3428,16 @@ Result:
2970
3428
  }
2971
3429
 
2972
3430
  Examples:
2973
- > neurai-cli gettxoutsetinfo
3431
+ > neurai-cli gettxoutsetinfo
2974
3432
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "gettxoutsetinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2975
-
2976
- &nbsp;<br> &nbsp;<br/>
2977
- ## getunconfirmedbalance
3433
+
3434
+ &nbsp;<br> &nbsp;<br/>
3435
+ ## getunconfirmedbalance
2978
3436
  &nbsp;<br/> getunconfirmedbalance
2979
3437
  Returns the server's total unconfirmed balance
2980
-
2981
- &nbsp;<br> &nbsp;<br/>
2982
- ## getverifierstring
3438
+
3439
+ &nbsp;<br> &nbsp;<br/>
3440
+ ## getverifierstring
2983
3441
  &nbsp;<br/> getverifierstring restricted_name
2984
3442
 
2985
3443
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -2996,9 +3454,9 @@ Result:
2996
3454
  Examples:
2997
3455
  > neurai-cli getverifierstring "restricted_name"
2998
3456
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getverifierstring", "params": ["restricted_name"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
2999
-
3000
- &nbsp;<br> &nbsp;<br/>
3001
- ## getwalletinfo
3457
+
3458
+ &nbsp;<br> &nbsp;<br/>
3459
+ ## getwalletinfo
3002
3460
  &nbsp;<br/> getwalletinfo
3003
3461
  Returns an object containing various wallet state info.
3004
3462
 
@@ -3006,6 +3464,7 @@ Result:
3006
3464
  {
3007
3465
  "walletname": xxxxx, (string) the wallet name
3008
3466
  "walletversion": xxxxx, (numeric) the wallet version
3467
+ "addresstype": "type", (string) the address type fixed when the wallet was created (-addresstype): legacy, pq or ecdsa
3009
3468
  "balance": xxxxxxx, (numeric) the total confirmed balance of the wallet in XNA
3010
3469
  "unconfirmed_balance": xxx, (numeric) the total unconfirmed balance of the wallet in XNA
3011
3470
  "immature_balance": xxxxxx, (numeric) the total immature balance of the wallet in XNA
@@ -3020,11 +3479,11 @@ Result:
3020
3479
  }
3021
3480
 
3022
3481
  Examples:
3023
- > neurai-cli getwalletinfo
3482
+ > neurai-cli getwalletinfo
3024
3483
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getwalletinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3025
-
3026
- &nbsp;<br> &nbsp;<br/>
3027
- ## help
3484
+
3485
+ &nbsp;<br> &nbsp;<br/>
3486
+ ## help
3028
3487
  &nbsp;<br/> help ( "command" )
3029
3488
 
3030
3489
  List all commands, or get help for a specified command.
@@ -3034,9 +3493,9 @@ Arguments:
3034
3493
 
3035
3494
  Result:
3036
3495
  "text" (string) The help text
3037
-
3038
- &nbsp;<br> &nbsp;<br/>
3039
- ## importaddress
3496
+
3497
+ &nbsp;<br> &nbsp;<br/>
3498
+ ## importaddress
3040
3499
  &nbsp;<br/> importaddress "address" ( "label" rescan p2sh )
3041
3500
 
3042
3501
  Adds a script (in hex) or address that can be watched as if it were in your wallet but cannot be used to spend.
@@ -3046,6 +3505,7 @@ Arguments:
3046
3505
  2. "label" (string, optional, default="") An optional label
3047
3506
  3. rescan (boolean, optional, default=true) Rescan the wallet for transactions
3048
3507
  4. p2sh (boolean, optional, default=false) Add the P2SH version of the script as well
3508
+ If the wallet already has the keys, registering the redeem script can make its P2SH output spendable.
3049
3509
 
3050
3510
  Note: This call can take minutes to complete if rescan is true.
3051
3511
  If you have the full public key, you should call importpubkey instead of this.
@@ -3063,9 +3523,9 @@ Import using a label without rescan
3063
3523
 
3064
3524
  As a JSON-RPC call
3065
3525
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "importaddress", "params": ["myscript", "testing", false] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3066
-
3067
- &nbsp;<br> &nbsp;<br/>
3068
- ## importmulti
3526
+
3527
+ &nbsp;<br> &nbsp;<br/>
3528
+ ## importmulti
3069
3529
  &nbsp;<br/> importmulti "requests" ( "options" )
3070
3530
 
3071
3531
  Import addresses/scripts (with private or public keys, redeem script (P2SH)), rescanning all addresses in one-shot-only (rescan can be disabled via options).
@@ -3101,9 +3561,9 @@ Examples:
3101
3561
 
3102
3562
  Response is an array with the same size as the input that has the execution result :
3103
3563
  [{ "success": true } , { "success": false, "error": { "code": -1, "message": "Internal Server Error"} }, ... ]
3104
-
3105
- &nbsp;<br> &nbsp;<br/>
3106
- ## importprivkey
3564
+
3565
+ &nbsp;<br> &nbsp;<br/>
3566
+ ## importprivkey
3107
3567
  &nbsp;<br/> importprivkey "privkey" ( "label" ) ( rescan )
3108
3568
 
3109
3569
  Adds a private key (as returned by dumpprivkey) to your wallet.
@@ -3131,9 +3591,9 @@ Import using default blank label and without rescan
3131
3591
 
3132
3592
  As a JSON-RPC call
3133
3593
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "importprivkey", "params": ["mykey", "testing", false] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3134
-
3135
- &nbsp;<br> &nbsp;<br/>
3136
- ## importprunedfunds
3594
+
3595
+ &nbsp;<br> &nbsp;<br/>
3596
+ ## importprunedfunds
3137
3597
  &nbsp;<br/> importprunedfunds
3138
3598
 
3139
3599
  Imports funds without rescan. Corresponding address or script must previously be included in wallet. Aimed towards pruned wallets. The end-user is responsible to import additional transactions that subsequently spend the imported outputs or rescan after the point in the blockchain the transaction is included.
@@ -3141,9 +3601,9 @@ Imports funds without rescan. Corresponding address or script must previously be
3141
3601
  Arguments:
3142
3602
  1. "rawtransaction" (string, required) A raw transaction in hex funding an already-existing address in wallet
3143
3603
  2. "txoutproof" (string, required) The hex output from gettxoutproof that contains the transaction
3144
-
3145
- &nbsp;<br> &nbsp;<br/>
3146
- ## importpubkey
3604
+
3605
+ &nbsp;<br> &nbsp;<br/>
3606
+ ## importpubkey
3147
3607
  &nbsp;<br/> importpubkey "pubkey" ( "label" rescan )
3148
3608
 
3149
3609
  Adds a public key (in hex) that can be watched as if it were in your wallet but cannot be used to spend.
@@ -3165,9 +3625,32 @@ Import using a label without rescan
3165
3625
 
3166
3626
  As a JSON-RPC call
3167
3627
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "importpubkey", "params": ["mypubkey", "testing", false] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3168
-
3169
- &nbsp;<br> &nbsp;<br/>
3170
- ## importwallet
3628
+
3629
+ &nbsp;<br> &nbsp;<br/>
3630
+ ## importsilentpaymentviewkey
3631
+ &nbsp;<br/> importsilentpaymentviewkey "scan_private_key" "spend_pubkey" ( start_height )
3632
+
3633
+ Turns this wallet into a watch wallet of a silent payment code: payments are
3634
+ detected and shown as watch-only, never spendable. Only for an unencrypted wallet
3635
+ without its own silent payment identity (or whose stored view key is damaged); the wallet
3636
+ can no longer be encrypted. Pass the secret with "neurai-cli -stdin importsilentpaymentviewkey"
3637
+ (one argument per line) so it stays out of the shell history and the process list.
3638
+
3639
+ Arguments:
3640
+ 1. "scan_private_key" (string, required) hex b_scan
3641
+ 2. "spend_pubkey" (string, required) hex B_spend
3642
+ 3. start_height (numeric, optional, default=0) first block to scan
3643
+
3644
+ Result:
3645
+ {
3646
+ "code": "str", "scanned_height": n, "found": n
3647
+ }
3648
+
3649
+ Examples:
3650
+ > neurai-cli importsilentpaymentviewkey "<hex>" "<hex>" 0
3651
+
3652
+ &nbsp;<br> &nbsp;<br/>
3653
+ ## importwallet
3171
3654
  &nbsp;<br/> importwallet "filename"
3172
3655
 
3173
3656
  Imports keys from a wallet dump file (see dumpwallet).
@@ -3185,9 +3668,9 @@ Import the wallet
3185
3668
 
3186
3669
  Import using the json rpc call
3187
3670
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "importwallet", "params": ["test"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3188
-
3189
- &nbsp;<br> &nbsp;<br/>
3190
- ## issue
3671
+
3672
+ &nbsp;<br> &nbsp;<br/>
3673
+ ## issue
3191
3674
  &nbsp;<br/> issue "asset_name" qty "( to_address )" "( change_address )" ( units ) ( reissuable ) ( has_ipfs ) "( ipfs_hash )"
3192
3675
 
3193
3676
  THIS COMMAND IS NOT YET ACTIVE!
@@ -3220,9 +3703,9 @@ Examples:
3220
3703
  > neurai-cli issue "ASSET_NAME" 1000 "myaddress" "changeaddress" 8 false true QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E
3221
3704
  > neurai-cli issue "ASSET_NAME/SUB_ASSET" 1000 "myaddress" "changeaddress" 2 true
3222
3705
  > neurai-cli issue "ASSET_NAME#uniquetag"
3223
-
3224
- &nbsp;<br> &nbsp;<br/>
3225
- ## issuequalifierasset
3706
+
3707
+ &nbsp;<br> &nbsp;<br/>
3708
+ ## issuequalifierasset
3226
3709
  &nbsp;<br/> issuequalifierasset "asset_name" qty "( to_address )" "( change_address )" ( has_ipfs ) "( ipfs_hash )"
3227
3710
 
3228
3711
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -3254,9 +3737,9 @@ Examples:
3254
3737
  > neurai-cli issuequalifierasset "#ASSET_NAME" 1000 "myaddress" "changeaddress" true QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E
3255
3738
  > neurai-cli issuequalifierasset "ASSET_NAME/SUB_QUALIFIER" 1000 "myaddress" "changeaddress"
3256
3739
  > neurai-cli issuequalifierasset "#ASSET_NAME"
3257
-
3258
- &nbsp;<br> &nbsp;<br/>
3259
- ## issuerestrictedasset
3740
+
3741
+ &nbsp;<br> &nbsp;<br/>
3742
+ ## issuerestrictedasset
3260
3743
  &nbsp;<br/> issuerestrictedasset "asset_name" qty "verifier" "to_address" "( change_address )" (units) ( reissuable ) ( has_ipfs ) "( ipfs_hash )"
3261
3744
 
3262
3745
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -3287,9 +3770,9 @@ Examples:
3287
3770
  > neurai-cli issuerestrictedasset "$ASSET_NAME" 1000 "#KYC & !#AML" "myaddress" "changeaddress" 5
3288
3771
  > neurai-cli issuerestrictedasset "$ASSET_NAME" 1000 "#KYC & !#AML" "myaddress" "changeaddress" 8 true
3289
3772
  > neurai-cli issuerestrictedasset "$ASSET_NAME" 1000 "#KYC & !#AML" "myaddress" "changeaddress" 0 false true QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E
3290
-
3291
- &nbsp;<br> &nbsp;<br/>
3292
- ## issueunique
3773
+
3774
+ &nbsp;<br> &nbsp;<br/>
3775
+ ## issueunique
3293
3776
  &nbsp;<br/> issueunique "root_name" [asset_tags] ( [ipfs_hashes] ) "( to_address )" "( change_address )"
3294
3777
 
3295
3778
  THIS COMMAND IS NOT YET ACTIVE!
@@ -3314,9 +3797,9 @@ Result:
3314
3797
  Examples:
3315
3798
  > neurai-cli issueunique "MY_ASSET" '["primo","secundo"]'
3316
3799
  > neurai-cli issueunique "MY_ASSET" '["primo","secundo"]' '["first_hash","second_hash"]'
3317
-
3318
- &nbsp;<br> &nbsp;<br/>
3319
- ## isvalidverifierstring
3800
+
3801
+ &nbsp;<br> &nbsp;<br/>
3802
+ ## isvalidverifierstring
3320
3803
  &nbsp;<br/> isvalidverifierstring verifier_string
3321
3804
 
3322
3805
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -3333,9 +3816,9 @@ Result:
3333
3816
  Examples:
3334
3817
  > neurai-cli isvalidverifierstring "verifier_string"
3335
3818
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "isvalidverifierstring", "params": ["verifier_string"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3336
-
3337
- &nbsp;<br> &nbsp;<br/>
3338
- ## keypoolrefill
3819
+
3820
+ &nbsp;<br> &nbsp;<br/>
3821
+ ## keypoolrefill
3339
3822
  &nbsp;<br/> keypoolrefill ( newsize )
3340
3823
 
3341
3824
  Fills the keypool.
@@ -3344,11 +3827,11 @@ Arguments
3344
3827
  1. newsize (numeric, optional, default=100) The new keypool size
3345
3828
 
3346
3829
  Examples:
3347
- > neurai-cli keypoolrefill
3830
+ > neurai-cli keypoolrefill
3348
3831
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "keypoolrefill", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3349
-
3350
- &nbsp;<br> &nbsp;<br/>
3351
- ## listaccounts
3832
+
3833
+ &nbsp;<br> &nbsp;<br/>
3834
+ ## listaccounts
3352
3835
  &nbsp;<br/> listaccounts ( minconf include_watchonly)
3353
3836
 
3354
3837
  DEPRECATED. Returns Object that has account names as keys, account balances as values.
@@ -3366,7 +3849,7 @@ Result:
3366
3849
  Examples:
3367
3850
 
3368
3851
  List account balances where there at least 1 confirmation
3369
- > neurai-cli listaccounts
3852
+ > neurai-cli listaccounts
3370
3853
 
3371
3854
  List account balances including zero confirmation transactions
3372
3855
  > neurai-cli listaccounts 0
@@ -3376,9 +3859,9 @@ List account balances for 6 or more confirmations
3376
3859
 
3377
3860
  As json rpc call
3378
3861
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listaccounts", "params": [6] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3379
-
3380
- &nbsp;<br> &nbsp;<br/>
3381
- ## listaddressesbyasset
3862
+
3863
+ &nbsp;<br> &nbsp;<br/>
3864
+ ## listaddressesbyasset
3382
3865
  &nbsp;<br/> listaddressesbyasset "asset_name" (onlytotal) (count) (start)
3383
3866
 
3384
3867
  THIS COMMAND IS NOT YET ACTIVE!
@@ -3401,9 +3884,9 @@ Examples:
3401
3884
  > neurai-cli listaddressesbyasset "ASSET_NAME" false 2 0
3402
3885
  > neurai-cli listaddressesbyasset "ASSET_NAME" true
3403
3886
  > neurai-cli listaddressesbyasset "ASSET_NAME"
3404
-
3405
- &nbsp;<br> &nbsp;<br/>
3406
- ## listaddressesfortag
3887
+
3888
+ &nbsp;<br> &nbsp;<br/>
3889
+ ## listaddressesfortag
3407
3890
  &nbsp;<br/> listaddressesfortag tag_name
3408
3891
 
3409
3892
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -3422,9 +3905,9 @@ Result:
3422
3905
  Examples:
3423
3906
  > neurai-cli listaddressesfortag "#TAG"
3424
3907
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listaddressesfortag", "params": ["#TAG"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3425
-
3426
- &nbsp;<br> &nbsp;<br/>
3427
- ## listaddressgroupings
3908
+
3909
+ &nbsp;<br> &nbsp;<br/>
3910
+ ## listaddressgroupings
3428
3911
  &nbsp;<br/> listaddressgroupings
3429
3912
 
3430
3913
  Lists groups of addresses which have had their common ownership
@@ -3445,11 +3928,11 @@ Result:
3445
3928
  ]
3446
3929
 
3447
3930
  Examples:
3448
- > neurai-cli listaddressgroupings
3931
+ > neurai-cli listaddressgroupings
3449
3932
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listaddressgroupings", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3450
-
3451
- &nbsp;<br> &nbsp;<br/>
3452
- ## listaddressrestrictions
3933
+
3934
+ &nbsp;<br> &nbsp;<br/>
3935
+ ## listaddressrestrictions
3453
3936
  &nbsp;<br/> listaddressrestrictions address
3454
3937
 
3455
3938
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -3468,9 +3951,9 @@ Result:
3468
3951
  Examples:
3469
3952
  > neurai-cli listaddressrestrictions "address"
3470
3953
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listaddressrestrictions", "params": ["address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3471
-
3472
- &nbsp;<br> &nbsp;<br/>
3473
- ## listassetbalancesbyaddress
3954
+
3955
+ &nbsp;<br> &nbsp;<br/>
3956
+ ## listassetbalancesbyaddress
3474
3957
  &nbsp;<br/> listassetbalancesbyaddress "address" (onlytotal) (count) (start)
3475
3958
 
3476
3959
  THIS COMMAND IS NOT YET ACTIVE!
@@ -3494,9 +3977,9 @@ Examples:
3494
3977
  > neurai-cli listassetbalancesbyaddress "myaddress" false 2 0
3495
3978
  > neurai-cli listassetbalancesbyaddress "myaddress" true
3496
3979
  > neurai-cli listassetbalancesbyaddress "myaddress"
3497
-
3498
- &nbsp;<br> &nbsp;<br/>
3499
- ## listassets
3980
+
3981
+ &nbsp;<br> &nbsp;<br/>
3982
+ ## listassets
3500
3983
  &nbsp;<br/> listassets "( asset )" ( verbose ) ( count ) ( start )
3501
3984
 
3502
3985
  THIS COMMAND IS NOT YET ACTIVE!
@@ -3536,19 +4019,19 @@ Examples:
3536
4019
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listassets", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3537
4020
  > neurai-cli listassets ASSET
3538
4021
  > neurai-cli listassets "ASSET*" true 10 20
3539
-
3540
- &nbsp;<br> &nbsp;<br/>
3541
- ## listbanned
4022
+
4023
+ &nbsp;<br> &nbsp;<br/>
4024
+ ## listbanned
3542
4025
  &nbsp;<br/> listbanned
3543
4026
 
3544
4027
  List all banned IPs/Subnets.
3545
4028
 
3546
4029
  Examples:
3547
- > neurai-cli listbanned
4030
+ > neurai-cli listbanned
3548
4031
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listbanned", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3549
-
3550
- &nbsp;<br> &nbsp;<br/>
3551
- ## listdepinaddresses
4032
+
4033
+ &nbsp;<br> &nbsp;<br/>
4034
+ ## listdepinaddresses
3552
4035
  &nbsp;<br/> listdepinaddresses "asset_name" (count) (start)
3553
4036
 
3554
4037
  THIS COMMAND IS NOT YET ACTIVE!
@@ -3567,6 +4050,7 @@ Result:
3567
4050
  {
3568
4051
  "address": "address", (string) The Neurai address
3569
4052
  "pubkey": "pubkey_hex" (string) The public key in hex format
4053
+ "valid": 1|0 (numeric) 1 = active/valid, 0 = blocked/revoked (only meaningful for DEPIN assets; always 1 for regular assets)
3570
4054
  },
3571
4055
  ...
3572
4056
  ]
@@ -3575,9 +4059,9 @@ Examples:
3575
4059
  > neurai-cli listdepinaddresses "ASSET_NAME"
3576
4060
  > neurai-cli listdepinaddresses "ASSET_NAME" 10 0
3577
4061
  > 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:19001/
3578
-
3579
- &nbsp;<br> &nbsp;<br/>
3580
- ## listdepinholders
4062
+
4063
+ &nbsp;<br> &nbsp;<br/>
4064
+ ## listdepinholders
3581
4065
  &nbsp;<br/> listdepinholders "asset_name"
3582
4066
 
3583
4067
  THIS COMMAND IS NOT YET ACTIVE!
@@ -3603,9 +4087,9 @@ Result:
3603
4087
  Examples:
3604
4088
  > neurai-cli listdepinholders "&FRANCE"
3605
4089
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listdepinholders", "params": ["&FRANCE"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3606
-
3607
- &nbsp;<br> &nbsp;<br/>
3608
- ## listglobalrestrictions
4090
+
4091
+ &nbsp;<br> &nbsp;<br/>
4092
+ ## listglobalrestrictions
3609
4093
  &nbsp;<br/> listglobalrestrictions
3610
4094
 
3611
4095
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -3619,11 +4103,11 @@ Result:
3619
4103
  ]
3620
4104
 
3621
4105
  Examples:
3622
- > neurai-cli listglobalrestrictions
4106
+ > neurai-cli listglobalrestrictions
3623
4107
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listglobalrestrictions", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3624
-
3625
- &nbsp;<br> &nbsp;<br/>
3626
- ## listlockunspent
4108
+
4109
+ &nbsp;<br> &nbsp;<br/>
4110
+ ## listlockunspent
3627
4111
  &nbsp;<br/> listlockunspent
3628
4112
 
3629
4113
  Returns list of temporarily unspendable outputs.
@@ -3641,23 +4125,23 @@ Result:
3641
4125
  Examples:
3642
4126
 
3643
4127
  List the unspent transactions
3644
- > neurai-cli listunspent
4128
+ > neurai-cli listunspent
3645
4129
 
3646
4130
  Lock an unspent transaction
3647
4131
  > neurai-cli lockunspent false "[{\"txid\":\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\",\"vout\":1}]"
3648
4132
 
3649
4133
  List the locked transactions
3650
- > neurai-cli listlockunspent
4134
+ > neurai-cli listlockunspent
3651
4135
 
3652
4136
  Unlock the transaction again
3653
4137
  > neurai-cli lockunspent true "[{\"txid\":\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\",\"vout\":1}]"
3654
4138
 
3655
4139
  As a json rpc call
3656
4140
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listlockunspent", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3657
-
3658
- &nbsp;<br> &nbsp;<br/>
3659
- ## listmyassets
3660
- &nbsp;<br/> listmyassets "( asset )" ( verbose ) ( count ) ( start ) (confs)
4141
+
4142
+ &nbsp;<br> &nbsp;<br/>
4143
+ ## listmyassets
4144
+ &nbsp;<br/> listmyassets "( asset )" ( verbose ) ( count ) ( start ) (confs)
3661
4145
 
3662
4146
  THIS COMMAND IS NOT YET ACTIVE!
3663
4147
  https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
@@ -3700,25 +4184,25 @@ Examples:
3700
4184
  > neurai-cli listmyassets ASSET
3701
4185
  > neurai-cli listmyassets "ASSET*" true 10 20
3702
4186
  > neurai-cli listmyassets "ASSET*" true 10 20 1
3703
-
3704
- &nbsp;<br> &nbsp;<br/>
3705
- ## listpqaddresses
4187
+
4188
+ &nbsp;<br> &nbsp;<br/>
4189
+ ## listpqaddresses
3706
4190
  &nbsp;<br/> listpqaddresses
3707
4191
 
3708
4192
  Returns the list of post-quantum (ML-DSA-44) Bech32m addresses in the wallet.
3709
4193
 
3710
4194
  Result:
3711
4195
  [ (json array of strings)
3712
- "address" (string) A generic AuthScript v1 address with a PQ key (nc1p.../tnc1p...)
4196
+ "address" (string) A strict post-quantum (witness v2) address of a PQ key (pq1.../tpq1...)
3713
4197
  ...
3714
4198
  ]
3715
4199
 
3716
4200
  Examples:
3717
- > neurai-cli listpqaddresses
4201
+ > neurai-cli listpqaddresses
3718
4202
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listpqaddresses", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3719
-
3720
- &nbsp;<br> &nbsp;<br/>
3721
- ## listreceivedbyaccount
4203
+
4204
+ &nbsp;<br> &nbsp;<br/>
4205
+ ## listreceivedbyaccount
3722
4206
  &nbsp;<br/> listreceivedbyaccount ( minconf include_empty include_watchonly)
3723
4207
 
3724
4208
  DEPRECATED. List balances by account.
@@ -3741,12 +4225,12 @@ Result:
3741
4225
  ]
3742
4226
 
3743
4227
  Examples:
3744
- > neurai-cli listreceivedbyaccount
4228
+ > neurai-cli listreceivedbyaccount
3745
4229
  > neurai-cli listreceivedbyaccount 6 true
3746
4230
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listreceivedbyaccount", "params": [6, true, true] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3747
-
3748
- &nbsp;<br> &nbsp;<br/>
3749
- ## listreceivedbyaddress
4231
+
4232
+ &nbsp;<br> &nbsp;<br/>
4233
+ ## listreceivedbyaddress
3750
4234
  &nbsp;<br/> listreceivedbyaddress ( minconf include_empty include_watchonly)
3751
4235
 
3752
4236
  List balances by receiving address.
@@ -3766,7 +4250,7 @@ Result:
3766
4250
  "confirmations" : n, (numeric) The number of confirmations of the most recent transaction included
3767
4251
  "label" : "label", (string) A comment for the address/transaction, if any
3768
4252
  "txids": [
3769
- n, (numeric) The ids of transactions received with the address
4253
+ n, (numeric) The ids of transactions received with the address
3770
4254
  ...
3771
4255
  ]
3772
4256
  }
@@ -3774,12 +4258,31 @@ Result:
3774
4258
  ]
3775
4259
 
3776
4260
  Examples:
3777
- > neurai-cli listreceivedbyaddress
4261
+ > neurai-cli listreceivedbyaddress
3778
4262
  > neurai-cli listreceivedbyaddress 6 true
3779
4263
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listreceivedbyaddress", "params": [6, true, true] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3780
-
3781
- &nbsp;<br> &nbsp;<br/>
3782
- ## listsinceblock
4264
+
4265
+ &nbsp;<br> &nbsp;<br/>
4266
+ ## listsilentpayments
4267
+ &nbsp;<br/> listsilentpayments ( include_spent )
4268
+
4269
+ Lists the silent payments received by this wallet.
4270
+
4271
+ Arguments:
4272
+ 1. include_spent (boolean, optional, default=true)
4273
+
4274
+ Result:
4275
+ [{
4276
+ "txid": "hex", "vout": n, "k": n, "amount": x.xxx, "address": "str",
4277
+ "status": "pending|unconfirmed|confirmed|spent|conflicted|abandoned|other_chain|unknown",
4278
+ "confirmations": n, "blockhash": "hex", "height": n, "view_only": true|false
4279
+ }, ...]
4280
+
4281
+ Examples:
4282
+ > neurai-cli listsilentpayments
4283
+
4284
+ &nbsp;<br> &nbsp;<br/>
4285
+ ## listsinceblock
3783
4286
  &nbsp;<br/> listsinceblock ( "blockhash" target_confirmations include_watchonly include_removed )
3784
4287
 
3785
4288
  Get all transactions in blocks since block [blockhash], or all transactions if omitted.
@@ -3799,7 +4302,7 @@ Result:
3799
4302
  "account":"accountname", (string) DEPRECATED. The account name associated with the transaction. Will be "" for the default account.
3800
4303
  "address":"address", (string) The neurai address of the transaction. Not present for move transactions (category = move).
3801
4304
  "category":"send|receive", (string) The transaction category. 'send' has negative amounts, 'receive' has positive amounts.
3802
- "amount": x.xxx, (numeric) The amount in XNA. This is negative for the 'send' category, and for the 'move' category for moves
4305
+ "amount": x.xxx, (numeric) The amount in XNA. This is negative for the 'send' category, and for the 'move' category for moves
3803
4306
  outbound. It is positive for the 'receive' category, and for the 'move' category for inbound funds.
3804
4307
  "vout" : n, (numeric) the vout value
3805
4308
  "fee": x.xxx, (numeric) The amount of the fee in XNA. This is negative and only available for the 'send' category of transactions.
@@ -3811,8 +4314,6 @@ Result:
3811
4314
  "txid": "transactionid", (string) The transaction id. Available for 'send' and 'receive' category of transactions.
3812
4315
  "time": xxx, (numeric) The transaction time in seconds since epoch (Jan 1 1970 GMT).
3813
4316
  "timereceived": xxx, (numeric) The time received in seconds since epoch (Jan 1 1970 GMT). Available for 'send' and 'receive' category of transactions.
3814
- "bip125-replaceable": "yes|no|unknown", (string) Whether this transaction could be replaced due to BIP125 (replace-by-fee);
3815
- may be unknown for unconfirmed transactions not in the mempool
3816
4317
  "abandoned": xxx, (bool) 'true' if the transaction has been abandoned (inputs are respendable). Only available for the 'send' category of transactions.
3817
4318
  "comment": "...", (string) If a comment is associated with the transaction.
3818
4319
  "label" : "label" (string) A comment for the address/transaction, if any
@@ -3826,12 +4327,12 @@ Result:
3826
4327
  }
3827
4328
 
3828
4329
  Examples:
3829
- > neurai-cli listsinceblock
4330
+ > neurai-cli listsinceblock
3830
4331
  > neurai-cli listsinceblock "000000000000000bacf66f7497b7dc45ef753ee9a7d38571037cdb1a57f663ad" 6
3831
4332
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listsinceblock", "params": ["000000000000000bacf66f7497b7dc45ef753ee9a7d38571037cdb1a57f663ad", 6] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3832
-
3833
- &nbsp;<br> &nbsp;<br/>
3834
- ## listsnapshotrequests
4333
+
4334
+ &nbsp;<br> &nbsp;<br/>
4335
+ ## listsnapshotrequests
3835
4336
  &nbsp;<br/> listsnapshotrequests ["asset_name" [block_height]]
3836
4337
 
3837
4338
  List snapshot request details.
@@ -3849,11 +4350,11 @@ Result:
3849
4350
  ]
3850
4351
 
3851
4352
  Examples:
3852
- > neurai-cli listsnapshotrequests
4353
+ > neurai-cli listsnapshotrequests
3853
4354
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listsnapshotrequests", "params": ["TRONCO" 345333] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3854
-
3855
- &nbsp;<br> &nbsp;<br/>
3856
- ## listtagsforaddress
4355
+
4356
+ &nbsp;<br> &nbsp;<br/>
4357
+ ## listtagsforaddress
3857
4358
  &nbsp;<br/> listtagsforaddress address
3858
4359
 
3859
4360
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -3872,9 +4373,9 @@ Result:
3872
4373
  Examples:
3873
4374
  > neurai-cli listtagsforaddress "address"
3874
4375
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listtagsforaddress", "params": ["address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3875
-
3876
- &nbsp;<br> &nbsp;<br/>
3877
- ## listtransactions
4376
+
4377
+ &nbsp;<br> &nbsp;<br/>
4378
+ ## listtransactions
3878
4379
  &nbsp;<br/> listtransactions ( "account" count skip include_watchonly)
3879
4380
 
3880
4381
  Returns up to 'count' most recent transactions skipping the first 'from' transactions for account 'account'.
@@ -3888,22 +4389,22 @@ Arguments:
3888
4389
  Result:
3889
4390
  [
3890
4391
  {
3891
- "account":"accountname", (string) DEPRECATED. The account name associated with the transaction.
4392
+ "account":"accountname", (string) DEPRECATED. The account name associated with the transaction.
3892
4393
  It will be "" for the default account.
3893
- "address":"address", (string) The neurai address of the transaction. Not present for
4394
+ "address":"address", (string) The neurai address of the transaction. Not present for
3894
4395
  move transactions (category = move).
3895
4396
  "category":"send|receive|move", (string) The transaction category. 'move' is a local (off blockchain)
3896
4397
  transaction between accounts, and not associated with an address,
3897
- transaction id or block. 'send' and 'receive' transactions are
4398
+ transaction id or block. 'send' and 'receive' transactions are
3898
4399
  associated with an address, transaction id and block details
3899
4400
  "amount": x.xxx, (numeric) The amount in XNA. This is negative for the 'send' category, and for the
3900
4401
  'move' category for moves outbound. It is positive for the 'receive' category,
3901
4402
  and for the 'move' category for inbound funds.
3902
4403
  "label": "label", (string) A comment for the address/transaction, if any
3903
4404
  "vout": n, (numeric) the vout value
3904
- "fee": x.xxx, (numeric) The amount of the fee in XNA. This is negative and only available for the
4405
+ "fee": x.xxx, (numeric) The amount of the fee in XNA. This is negative and only available for the
3905
4406
  'send' category of transactions.
3906
- "confirmations": n, (numeric) The number of confirmations for the transaction. Available for 'send' and
4407
+ "confirmations": n, (numeric) The number of confirmations for the transaction. Available for 'send' and
3907
4408
  'receive' category of transactions. Negative confirmations indicate the
3908
4409
  transaction conflicts with the block chain
3909
4410
  "trusted": xxx, (bool) Whether we consider the outputs of this unconfirmed transaction safe to spend.
@@ -3914,15 +4415,13 @@ Result:
3914
4415
  "blocktime": xxx, (numeric) The block time in seconds since epoch (1 Jan 1970 GMT).
3915
4416
  "txid": "transactionid", (string) The transaction id. Available for 'send' and 'receive' category of transactions.
3916
4417
  "time": xxx, (numeric) The transaction time in seconds since epoch (midnight Jan 1 1970 GMT).
3917
- "timereceived": xxx, (numeric) The time received in seconds since epoch (midnight Jan 1 1970 GMT). Available
4418
+ "timereceived": xxx, (numeric) The time received in seconds since epoch (midnight Jan 1 1970 GMT). Available
3918
4419
  for 'send' and 'receive' category of transactions.
3919
4420
  "comment": "...", (string) If a comment is associated with the transaction.
3920
- "otheraccount": "accountname", (string) DEPRECATED. For the 'move' category of transactions, the account the funds came
4421
+ "otheraccount": "accountname", (string) DEPRECATED. For the 'move' category of transactions, the account the funds came
3921
4422
  from (for receiving funds, positive amounts), or went to (for sending funds,
3922
4423
  negative amounts).
3923
- "bip125-replaceable": "yes|no|unknown", (string) Whether this transaction could be replaced due to BIP125 (replace-by-fee);
3924
- may be unknown for unconfirmed transactions not in the mempool
3925
- "abandoned": xxx (bool) 'true' if the transaction has been abandoned (inputs are respendable). Only available for the
4424
+ "abandoned": xxx (bool) 'true' if the transaction has been abandoned (inputs are respendable). Only available for the
3926
4425
  'send' category of transactions.
3927
4426
  }
3928
4427
  ]
@@ -3930,16 +4429,16 @@ Result:
3930
4429
  Examples:
3931
4430
 
3932
4431
  List the most recent 10 transactions in the systems
3933
- > neurai-cli listtransactions
4432
+ > neurai-cli listtransactions
3934
4433
 
3935
4434
  List transactions 100 to 120
3936
4435
  > neurai-cli listtransactions "*" 20 100
3937
4436
 
3938
4437
  As a json rpc call
3939
4438
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listtransactions", "params": ["*", 20, 100] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3940
-
3941
- &nbsp;<br> &nbsp;<br/>
3942
- ## listunspent
4439
+
4440
+ &nbsp;<br> &nbsp;<br/>
4441
+ ## listunspent
3943
4442
  &nbsp;<br/> listunspent ( minconf maxconf ["addresses",...] [include_unsafe] [query_options])
3944
4443
 
3945
4444
  Returns array of unspent transaction outputs
@@ -3967,7 +4466,7 @@ Arguments:
3967
4466
  Result
3968
4467
  [ (array of json object)
3969
4468
  {
3970
- "txid" : "txid", (string) the transaction id
4469
+ "txid" : "txid", (string) the transaction id
3971
4470
  "vout" : n, (numeric) the vout value
3972
4471
  "address" : "address", (string) the neurai address
3973
4472
  "account" : "account", (string) DEPRECATED. The associated account, or "" for the default account
@@ -3985,14 +4484,14 @@ Result
3985
4484
  ]
3986
4485
 
3987
4486
  Examples
3988
- > neurai-cli listunspent
4487
+ > neurai-cli listunspent
3989
4488
  > neurai-cli listunspent 6 9999999 "[\"1PGFqEzfmQch1gKD3ra4k18PNj3tTUUSqg\",\"1LtvqCaApEdUGFkpKMM4MstjcaL4dKg8SP\"]"
3990
4489
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listunspent", "params": [6, 9999999 "[\"1PGFqEzfmQch1gKD3ra4k18PNj3tTUUSqg\",\"1LtvqCaApEdUGFkpKMM4MstjcaL4dKg8SP\"]"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3991
4490
  > neurai-cli listunspent 6 9999999 '[]' true '{ "minimumAmount": 0.005 }'
3992
4491
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listunspent", "params": [6, 9999999, [] , true, { "minimumAmount": 0.005 } ] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
3993
-
3994
- &nbsp;<br> &nbsp;<br/>
3995
- ## listwallets
4492
+
4493
+ &nbsp;<br> &nbsp;<br/>
4494
+ ## listwallets
3996
4495
  &nbsp;<br/> listwallets
3997
4496
  Returns a list of currently loaded wallets.
3998
4497
  For full information on the wallet, use "getwalletinfo"
@@ -4004,11 +4503,11 @@ Result:
4004
4503
  ]
4005
4504
 
4006
4505
  Examples:
4007
- > neurai-cli listwallets
4506
+ > neurai-cli listwallets
4008
4507
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listwallets", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4009
-
4010
- &nbsp;<br> &nbsp;<br/>
4011
- ## lockunspent
4508
+
4509
+ &nbsp;<br> &nbsp;<br/>
4510
+ ## lockunspent
4012
4511
  &nbsp;<br/> lockunspent unlock ([{"txid":"txid","vout":n},...])
4013
4512
 
4014
4513
  Updates list of temporarily unspendable outputs.
@@ -4036,22 +4535,22 @@ true|false (boolean) Whether the command was successful or not
4036
4535
  Examples:
4037
4536
 
4038
4537
  List the unspent transactions
4039
- > neurai-cli listunspent
4538
+ > neurai-cli listunspent
4040
4539
 
4041
4540
  Lock an unspent transaction
4042
4541
  > neurai-cli lockunspent false "[{\"txid\":\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\",\"vout\":1}]"
4043
4542
 
4044
4543
  List the locked transactions
4045
- > neurai-cli listlockunspent
4544
+ > neurai-cli listlockunspent
4046
4545
 
4047
4546
  Unlock the transaction again
4048
4547
  > neurai-cli lockunspent true "[{\"txid\":\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\",\"vout\":1}]"
4049
4548
 
4050
4549
  As a json rpc call
4051
4550
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "lockunspent", "params": [false, "[{\"txid\":\"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0\",\"vout\":1}]"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4052
-
4053
- &nbsp;<br> &nbsp;<br/>
4054
- ## move
4551
+
4552
+ &nbsp;<br> &nbsp;<br/>
4553
+ ## move
4055
4554
  &nbsp;<br/> move "fromaccount" "toaccount" amount ( minconf "comment" )
4056
4555
 
4057
4556
  DEPRECATED. Move a specified amount from one account in your wallet to another.
@@ -4076,9 +4575,32 @@ Move 0.01 XNA timotei to akiko with a comment and funds have 6 confirmations
4076
4575
 
4077
4576
  As a json rpc call
4078
4577
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "move", "params": ["timotei", "akiko", 0.01, 6, "happy birthday!"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4079
-
4080
- &nbsp;<br> &nbsp;<br/>
4081
- ## ping
4578
+
4579
+ &nbsp;<br> &nbsp;<br/>
4580
+ ## opendepin
4581
+ &nbsp;<br/> opendepin "asset_name" ("change_address")
4582
+
4583
+ THIS COMMAND IS NOT YET ACTIVE!
4584
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
4585
+
4586
+ Open transfers of a DEPIN asset (owner only): while open, holders can move
4587
+ the asset like a regular asset without the owner token. Transfers from addresses
4588
+ frozen by the owner or self-revoked stay rejected. Valid from the closed state;
4589
+ takes effect from the block after the one that confirms it.
4590
+
4591
+ Arguments:
4592
+ 1. "asset_name" (string, required) The DEPIN asset name (must start with &)
4593
+ 2. "change_address" (string, optional) The change address for the owner token
4594
+
4595
+ Result:
4596
+ "txid" (string) The transaction id
4597
+
4598
+ Examples:
4599
+ > neurai-cli opendepin "&FRANCE"
4600
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "opendepin", "params": ["&FRANCE"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4601
+
4602
+ &nbsp;<br> &nbsp;<br/>
4603
+ ## ping
4082
4604
  &nbsp;<br/> ping
4083
4605
 
4084
4606
  Requests that a ping be sent to all other nodes, to measure ping time.
@@ -4086,28 +4608,28 @@ Results provided in getpeerinfo, pingtime and pingwait fields are decimal second
4086
4608
  Ping command is handled in queue with all other commands, so it measures processing backlog, not just network ping.
4087
4609
 
4088
4610
  Examples:
4089
- > neurai-cli ping
4611
+ > neurai-cli ping
4090
4612
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "ping", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4091
-
4092
- &nbsp;<br> &nbsp;<br/>
4093
- ## pprpcsb
4613
+
4614
+ &nbsp;<br> &nbsp;<br/>
4615
+ ## pprpcsb
4094
4616
  &nbsp;<br/> pprpcsb "header_hash" "mix_hash" "nonce"
4095
4617
 
4096
4618
  Attempts to submit new block to network mined by kawpow gpu miner via rpc.
4097
4619
 
4098
4620
  Arguments
4099
- 1. "header_hash" (string, required) the prow_pow header hash that was given to the gpu miner from this rpc client
4100
- 2. "mix_hash" (string, required) the mix hash that was mined by the gpu miner via rpc
4101
- 3. "nonce" (string, required) the nonce of the block that hashed the valid block
4621
+ 1. "header_hash" (string, required) the header hash given to the GPU miner (exactly 64 hex digits)
4622
+ 2. "mix_hash" (string, required) the mix hash mined by the GPU miner (exactly 64 hex digits)
4623
+ 3. "nonce" (string, required) 1 to 16 hex digits, optionally prefixed with 0x
4102
4624
 
4103
4625
  Result:
4104
4626
 
4105
4627
  Examples:
4106
- > neurai-cli pprpcsb "header_hash" "mix_hash" 100000
4107
- > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "pprpcsb", "params": ["header_hash" "mix_hash" 100000] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4108
-
4109
- &nbsp;<br> &nbsp;<br/>
4110
- ## preciousblock
4628
+ > neurai-cli pprpcsb "header_hash" "mix_hash" "0x100000"
4629
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "pprpcsb", "params": ["header_hash" "mix_hash" "0x100000"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4630
+
4631
+ &nbsp;<br> &nbsp;<br/>
4632
+ ## preciousblock
4111
4633
  &nbsp;<br/> preciousblock "blockhash"
4112
4634
 
4113
4635
  Treats a block as if it were received before others with the same work.
@@ -4124,9 +4646,9 @@ Result:
4124
4646
  Examples:
4125
4647
  > neurai-cli preciousblock "blockhash"
4126
4648
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "preciousblock", "params": ["blockhash"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4127
-
4128
- &nbsp;<br> &nbsp;<br/>
4129
- ## prioritisetransaction
4649
+
4650
+ &nbsp;<br> &nbsp;<br/>
4651
+ ## prioritisetransaction
4130
4652
  &nbsp;<br/> prioritisetransaction <txid> <dummy value> <fee delta>
4131
4653
  Accepts the transaction into mined blocks at a higher (or lower) priority
4132
4654
 
@@ -4144,9 +4666,9 @@ true (boolean) Returns true
4144
4666
  Examples:
4145
4667
  > neurai-cli prioritisetransaction "txid" 0.0 10000
4146
4668
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "prioritisetransaction", "params": ["txid", 0.0, 10000] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4147
-
4148
- &nbsp;<br> &nbsp;<br/>
4149
- ## pruneblockchain
4669
+
4670
+ &nbsp;<br> &nbsp;<br/>
4671
+ ## pruneblockchain
4150
4672
  &nbsp;<br/> pruneblockchain
4151
4673
 
4152
4674
  Arguments:
@@ -4159,9 +4681,9 @@ n (numeric) Height of the last block pruned.
4159
4681
  Examples:
4160
4682
  > neurai-cli pruneblockchain 1000
4161
4683
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "pruneblockchain", "params": [1000] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4162
-
4163
- &nbsp;<br> &nbsp;<br/>
4164
- ## purgesnapshot
4684
+
4685
+ &nbsp;<br> &nbsp;<br/>
4686
+ ## purgesnapshot
4165
4687
  &nbsp;<br/> purgesnapshot "asset_name" block_height
4166
4688
 
4167
4689
  THIS COMMAND IS NOT YET ACTIVE!
@@ -4182,10 +4704,10 @@ Result:
4182
4704
  Examples:
4183
4705
  > neurai-cli purgesnapshot "ASSET_NAME" 28546
4184
4706
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "purgesnapshot", "params": ["ASSET_NAME" 28546] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4185
-
4186
- &nbsp;<br> &nbsp;<br/>
4187
- ## reissue
4188
- &nbsp;<br/> reissue "asset_name" qty "to_address" "change_address" ( reissuable ) ( new_units) "( new_ipfs )"
4707
+
4708
+ &nbsp;<br> &nbsp;<br/>
4709
+ ## reissue
4710
+ &nbsp;<br/> reissue "asset_name" qty "to_address" "change_address" ( reissuable ) ( new_units) "( new_ipfs )"
4189
4711
 
4190
4712
  THIS COMMAND IS NOT YET ACTIVE!
4191
4713
  https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
@@ -4208,9 +4730,9 @@ Result:
4208
4730
  Examples:
4209
4731
  > neurai-cli reissue "ASSET_NAME" 20 "address"
4210
4732
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "reissue", "params": ["ASSET_NAME" 20 "address" "change_address" "true" 8 "Qmd286K6pohQcTKYqnS1YhWrCiS4gz7Xi34sdwMe9USZ7u"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4211
-
4212
- &nbsp;<br> &nbsp;<br/>
4213
- ## reissuerestrictedasset
4733
+
4734
+ &nbsp;<br> &nbsp;<br/>
4735
+ ## reissuerestrictedasset
4214
4736
  &nbsp;<br/> reissuerestrictedasset "asset_name" qty to_address ( change_verifier ) ( "new_verifier" ) "( change_address )" ( new_units ) ( reissuable ) "( new_ipfs )"
4215
4737
 
4216
4738
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -4235,13 +4757,13 @@ Result:
4235
4757
 
4236
4758
  Examples:
4237
4759
  > neurai-cli reissuerestrictedasset "$ASSET_NAME" 1000 "myaddress" true "KYC & !AML"
4238
- > neurai-cli reissuerestrictedasset "$ASSET_NAME" 1000 "myaddress" true "KYC & !AML"
4760
+ > neurai-cli reissuerestrictedasset "$ASSET_NAME" 1000 "myaddress" true "KYC & !AML"
4239
4761
  > neurai-cli reissuerestrictedasset "$ASSET_NAME" 1000 "myaddress" true "KYC & !AML" "changeaddress"
4240
4762
  > neurai-cli reissuerestrictedasset "$ASSET_NAME" 1000 "myaddress" true "KYC & !AML" "changeaddress" -1 true
4241
4763
  > neurai-cli reissuerestrictedasset "$ASSET_NAME" 1000 "myaddress" false "" "changeaddress" -1 false QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E
4242
-
4243
- &nbsp;<br> &nbsp;<br/>
4244
- ## removeprunedfunds
4764
+
4765
+ &nbsp;<br> &nbsp;<br/>
4766
+ ## removeprunedfunds
4245
4767
  &nbsp;<br/> removeprunedfunds "txid"
4246
4768
 
4247
4769
  Deletes the specified transaction from the wallet. Meant for use with pruned wallets and as a companion to importprunedfunds. This will affect wallet balances.
@@ -4254,9 +4776,9 @@ Examples:
4254
4776
 
4255
4777
  As a JSON-RPC call
4256
4778
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "removeprunedfunds", "params": ["a8d0c0184dde994a09ec054286f1ce581bebf46446a512166eae7628734ea0a5"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4257
-
4258
- &nbsp;<br> &nbsp;<br/>
4259
- ## removetagfromaddress
4779
+
4780
+ &nbsp;<br> &nbsp;<br/>
4781
+ ## removetagfromaddress
4260
4782
  &nbsp;<br/> removetagfromaddress tag_name to_address (change_address) (asset_data)
4261
4783
 
4262
4784
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -4278,12 +4800,59 @@ Examples:
4278
4800
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "removetagfromaddress", "params": ["#TAG" "to_address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4279
4801
  > neurai-cli removetagfromaddress "#TAG" "to_address" "change_address"
4280
4802
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "removetagfromaddress", "params": ["#TAG" "to_address" "change_address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4281
-
4282
- &nbsp;<br> &nbsp;<br/>
4283
- ## requestsnapshot
4803
+
4804
+ &nbsp;<br> &nbsp;<br/>
4805
+ ## repairsilentpaymentidentity
4806
+ &nbsp;<br/> repairsilentpaymentidentity
4807
+
4808
+ Rewrites the silent payment code of this wallet from its seed after an identity failure
4809
+ ("stored silent payment code does not match the wallet seed"). Payments sent to the
4810
+ replaced code did not reach this wallet: check your backups before repairing.
4811
+
4812
+ Result:
4813
+ {
4814
+ "previous_code": "str", (string) the code that was stored (do not use it)
4815
+ "code": "str" (string) the code derived from the seed
4816
+ }
4817
+
4818
+ Examples:
4819
+ > neurai-cli repairsilentpaymentidentity
4820
+
4821
+ &nbsp;<br> &nbsp;<br/>
4822
+ ## replaysnapshot
4823
+ &nbsp;<br/> replaysnapshot "asset_name" snapshot_height ( "expected_snapshot_hash" )
4824
+
4825
+ Rebuilds the holders of an asset at a height from the blocks and their undo data, without using any snapshot,
4826
+ and returns the snapshot hash they give (NIP-048). A node that did not capture the snapshot can so check a
4827
+ plan's snapshot_hash. It reads every block from asset activation to the height: it is slow, and a pruned node
4828
+ cannot do it.
4829
+
4830
+ Arguments:
4831
+ 1. "asset_name" (string, required) The asset
4832
+ 2. snapshot_height (number, required) The height to rebuild
4833
+ 3. "expected_snapshot_hash" (string, optional) A snapshot_hash to compare with, for instance from a plan
4834
+
4835
+ Result:
4836
+ {
4837
+ "asset_name": "name",
4838
+ "height": n,
4839
+ "block_hash": "hash",
4840
+ "snapshot_hash": "hex", (string) as in getsnapshot and getdistributionplan
4841
+ "holders": n,
4842
+ "scanned_blocks": n,
4843
+ "matches_stored": true|false|null, (null: this node holds no snapshot at that height)
4844
+ "matches_expected": true|false|null (null: no expected hash given)
4845
+ }
4846
+
4847
+ Examples:
4848
+ > neurai-cli replaysnapshot "TRONCO" 12345
4849
+
4850
+ &nbsp;<br> &nbsp;<br/>
4851
+ ## requestsnapshot
4284
4852
  &nbsp;<br/> requestsnapshot "asset_name" block_height
4285
4853
 
4286
- Schedules a snapshot of the specified asset at the specified block height.
4854
+ Schedules a snapshot of the specified asset at the specified block height. The node captures it while it
4855
+ connects that block, so at most -maxsnapshotrequests different assets are accepted at one height.
4287
4856
 
4288
4857
  Arguments:
4289
4858
  1. "asset_name" (string, required) The asset name for which the snapshot will be taken
@@ -4297,9 +4866,9 @@ Result:
4297
4866
  Examples:
4298
4867
  > neurai-cli requestsnapshot "TRONCO" 12345
4299
4868
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "requestsnapshot", "params": ["PHATSTACKS" 34987] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4300
-
4301
- &nbsp;<br> &nbsp;<br/>
4302
- ## rescanblockchain
4869
+
4870
+ &nbsp;<br> &nbsp;<br/>
4871
+ ## rescanblockchain
4303
4872
  &nbsp;<br/> rescanblockchain ("start_height") ("stop_height")
4304
4873
 
4305
4874
  Rescan the local blockchain for wallet related transactions.
@@ -4317,19 +4886,61 @@ Result:
4317
4886
  Examples:
4318
4887
  > neurai-cli rescanblockchain 100000 120000
4319
4888
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "rescanblockchain", "params": [100000, 120000] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4320
-
4321
- &nbsp;<br> &nbsp;<br/>
4322
- ## savemempool
4889
+
4890
+ &nbsp;<br> &nbsp;<br/>
4891
+ ## rescansilentpayments
4892
+ &nbsp;<br/> rescansilentpayments ( start_height )
4893
+
4894
+ Scans the active chain again for silent payments, from start_height to the tip.
4895
+ Reads blocks and their undo data; -txindex is not needed. Scanning stops, without
4896
+ advancing past it, at the first block whose data is not available (pruned node).
4897
+
4898
+ Arguments:
4899
+ 1. start_height (numeric, optional, default=0)
4900
+
4901
+ Result:
4902
+ {
4903
+ "start_height": n, "scanned_height": n, "found": n
4904
+ }
4905
+
4906
+ Examples:
4907
+ > neurai-cli rescansilentpayments 100
4908
+
4909
+ &nbsp;<br> &nbsp;<br/>
4910
+ ## savemempool
4323
4911
  &nbsp;<br/> savemempool
4324
4912
 
4325
4913
  Dumps the mempool to disk.
4326
4914
 
4327
4915
  Examples:
4328
- > neurai-cli savemempool
4916
+ > neurai-cli savemempool
4329
4917
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "savemempool", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4330
-
4331
- &nbsp;<br> &nbsp;<br/>
4332
- ## selfrevokedepin
4918
+
4919
+ &nbsp;<br> &nbsp;<br/>
4920
+ ## sealdepin
4921
+ &nbsp;<br/> sealdepin "asset_name" ("change_address")
4922
+
4923
+ THIS COMMAND IS NOT YET ACTIVE!
4924
+ https://github.com/NeuraiProject/rips/blob/master/rip-0002.mediawiki
4925
+
4926
+ Seal a DEPIN asset (owner only). WARNING: THIS IS IRREVERSIBLE.
4927
+ A sealed asset is soulbound like a closed one, but no transfer state operation
4928
+ (open, close or seal) is ever accepted for it again. Only valid from the closed
4929
+ state: an open asset must be closed first.
4930
+
4931
+ Arguments:
4932
+ 1. "asset_name" (string, required) The DEPIN asset name (must start with &)
4933
+ 2. "change_address" (string, optional) The change address for the owner token
4934
+
4935
+ Result:
4936
+ "txid" (string) The transaction id
4937
+
4938
+ Examples:
4939
+ > neurai-cli sealdepin "&FRANCE"
4940
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "sealdepin", "params": ["&FRANCE"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4941
+
4942
+ &nbsp;<br> &nbsp;<br/>
4943
+ ## selfrevokedepin
4333
4944
  &nbsp;<br/> selfrevokedepin "asset_name"
4334
4945
 
4335
4946
  THIS COMMAND IS NOT YET ACTIVE!
@@ -4362,9 +4973,9 @@ Result:
4362
4973
  Examples:
4363
4974
  > neurai-cli selfrevokedepin "&FRANCE"
4364
4975
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "selfrevokedepin", "params": ["&FRANCE"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4365
-
4366
- &nbsp;<br> &nbsp;<br/>
4367
- ## sendfrom
4976
+
4977
+ &nbsp;<br> &nbsp;<br/>
4978
+ ## sendfrom
4368
4979
  &nbsp;<br/> sendfrom "fromaccount" "toaddress" amount ( minconf "comment" "comment_to" )
4369
4980
 
4370
4981
  DEPRECATED (use sendtoaddress). Sent an amount from an account to a neurai address.
@@ -4377,10 +4988,10 @@ Arguments:
4377
4988
  2. "toaddress" (string, required) The neurai address to send funds to.
4378
4989
  3. amount (numeric or string, required) The amount in XNA (transaction fee is added on top).
4379
4990
  4. minconf (numeric, optional, default=1) Only use funds with at least this many confirmations.
4380
- 5. "comment" (string, optional) A comment used to store what the transaction is for.
4991
+ 5. "comment" (string, optional) A comment used to store what the transaction is for.
4381
4992
  This is not part of the transaction, just kept in your wallet.
4382
- 6. "comment_to" (string, optional) An optional comment to store the name of the person or organization
4383
- to which you're sending the transaction. This is not part of the transaction,
4993
+ 6. "comment_to" (string, optional) An optional comment to store the name of the person or organization
4994
+ to which you're sending the transaction. This is not part of the transaction,
4384
4995
  it is just kept in your wallet.
4385
4996
 
4386
4997
  Result:
@@ -4396,10 +5007,10 @@ Send 0.01 from the tabby account to the given address, funds must have at least
4396
5007
 
4397
5008
  As a json rpc call
4398
5009
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "sendfrom", "params": ["tabby", "1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd", 0.01, 6, "donation", "seans outpost"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4399
-
4400
- &nbsp;<br> &nbsp;<br/>
4401
- ## sendfromaddress
4402
- &nbsp;<br/> sendfromaddress "from_address" "to_address" amount ( "comment" "comment_to" subtractfeefromamount replaceable conf_target "estimate_mode")
5010
+
5011
+ &nbsp;<br> &nbsp;<br/>
5012
+ ## sendfromaddress
5013
+ &nbsp;<br/> sendfromaddress "from_address" "to_address" amount ( "comment" "comment_to" subtractfeefromamount conf_target "estimate_mode")
4403
5014
 
4404
5015
  Send an amount from a specific address to a given address. All xna change will get sent back to the from_address
4405
5016
 
@@ -4407,10 +5018,10 @@ Arguments:
4407
5018
  1. "from_address" (string, required) The neurai address to send from.
4408
5019
  2. "to_address" (string, required) The neurai address to send to.
4409
5020
  3. "amount" (numeric or string, required) The amount in XNA to send. eg 0.1
4410
- 4. "comment" (string, optional) A comment used to store what the transaction is for.
5021
+ 4. "comment" (string, optional) A comment used to store what the transaction is for.
4411
5022
  This is not part of the transaction, just kept in your wallet.
4412
- 5. "comment_to" (string, optional) A comment to store the name of the person or organization
4413
- to which you're sending the transaction. This is not part of the
5023
+ 5. "comment_to" (string, optional) A comment to store the name of the person or organization
5024
+ to which you're sending the transaction. This is not part of the
4414
5025
  transaction, just kept in your wallet.
4415
5026
  6. subtractfeefromamount (boolean, optional, default=false) The fee will be deducted from the amount being sent.
4416
5027
  The recipient will receive less neurais than you enter in the amount field.
@@ -4428,10 +5039,10 @@ Examples:
4428
5039
  > neurai-cli sendfromaddress "1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" "1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 "donation" "seans outpost"
4429
5040
  > neurai-cli sendfromaddress "1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" "1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 "" "" true
4430
5041
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "sendfromaddress", "params": ["1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" "1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd", 0.1, "donation", "seans outpost"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4431
-
4432
- &nbsp;<br> &nbsp;<br/>
4433
- ## sendmany
4434
- &nbsp;<br/> sendmany "fromaccount" {"address":amount,...} ( minconf "comment" ["address",...] replaceable conf_target "estimate_mode")
5042
+
5043
+ &nbsp;<br> &nbsp;<br/>
5044
+ ## sendmany
5045
+ &nbsp;<br/> sendmany "fromaccount" {"address":amount,...} ( minconf "comment" ["address",...] conf_target "estimate_mode")
4435
5046
 
4436
5047
  Send multiple times. Amounts are double-precision floating point numbers.
4437
5048
 
@@ -4459,7 +5070,7 @@ Arguments:
4459
5070
  "CONSERVATIVE"
4460
5071
 
4461
5072
  Result:
4462
- "txid" (string) The transaction id for the send. Only 1 transaction is created regardless of
5073
+ "txid" (string) The transaction id for the send. Only 1 transaction is created regardless of
4463
5074
  the number of addresses.
4464
5075
 
4465
5076
  Examples:
@@ -4475,9 +5086,9 @@ Send two amounts to two different addresses, subtract fee from amount:
4475
5086
 
4476
5087
  As a json rpc call
4477
5088
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "sendmany", "params": ["", "{\"1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX\":0.01,\"1353tsE8YMTA4EuV7dgUXGjNFf9KpVvKHz\":0.02}", 6, "testing"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4478
-
4479
- &nbsp;<br> &nbsp;<br/>
4480
- ## sendmessage
5089
+
5090
+ &nbsp;<br> &nbsp;<br/>
5091
+ ## sendmessage
4481
5092
  &nbsp;<br/> sendmessage "channel_name" "ipfs_hash" (expire_time)
4482
5093
 
4483
5094
  THIS COMMAND IS NOT YET ACTIVE!
@@ -4496,9 +5107,9 @@ txid
4496
5107
  Examples:
4497
5108
  > neurai-cli sendmessage "ASSET_NAME!" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E" 15863654
4498
5109
  > neurai-cli sendmessage "ASSET_NAME!" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E" 15863654
4499
-
4500
- &nbsp;<br> &nbsp;<br/>
4501
- ## sendrawtransaction
5110
+
5111
+ &nbsp;<br> &nbsp;<br/>
5112
+ ## sendrawtransaction
4502
5113
  &nbsp;<br/> sendrawtransaction "hexstring" ( allowhighfees )
4503
5114
 
4504
5115
  Submits raw transaction (serialized, hex-encoded) to local node and network.
@@ -4524,20 +5135,43 @@ Send the transaction (signed hex)
4524
5135
 
4525
5136
  As a json rpc call
4526
5137
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "sendrawtransaction", "params": ["signedhex"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4527
-
4528
- &nbsp;<br> &nbsp;<br/>
4529
- ## sendtoaddress
4530
- &nbsp;<br/> sendtoaddress "address" amount ( "comment" "comment_to" subtractfeefromamount replaceable conf_target "estimate_mode")
5138
+
5139
+ &nbsp;<br> &nbsp;<br/>
5140
+ ## sendsilentpayments
5141
+ &nbsp;<br/> sendsilentpayments [{"code":"str","amount":x},...] ( conf_target "estimate_mode" )
5142
+
5143
+ Pays one or more silent payment codes from strict ECDSA (v3) coins only.
5144
+ Several payments to the same code are allowed (up to 16 per code); the change
5145
+ returns to a new internal v3 address.
5146
+
5147
+ Arguments:
5148
+ 1. payments (array, required) [{"code": payment code, "amount": amount in XNA}, ...]
5149
+ 2. conf_target (numeric, optional) Confirmation target (in blocks)
5150
+ 3. "estimate_mode" (string, optional, default=UNSET) UNSET, ECONOMICAL or CONSERVATIVE
5151
+
5152
+ Result:
5153
+ {
5154
+ "txid": "hex",
5155
+ "fee": x.xxx,
5156
+ "payments": [{"code": "str", "amount": x.xxx, "vout": n, "k": n}, ...]
5157
+ }
5158
+
5159
+ Examples:
5160
+ > neurai-cli sendsilentpayments '[{"code":"tnsp1q...","amount":1.5}]'
5161
+
5162
+ &nbsp;<br> &nbsp;<br/>
5163
+ ## sendtoaddress
5164
+ &nbsp;<br/> sendtoaddress "address" amount ( "comment" "comment_to" subtractfeefromamount conf_target "estimate_mode")
4531
5165
 
4532
5166
  Send an amount to a given address.
4533
5167
 
4534
5168
  Arguments:
4535
5169
  1. "address" (string, required) The neurai address to send to.
4536
5170
  2. "amount" (numeric or string, required) The amount in XNA to send. eg 0.1
4537
- 3. "comment" (string, optional) A comment used to store what the transaction is for.
5171
+ 3. "comment" (string, optional) A comment used to store what the transaction is for.
4538
5172
  This is not part of the transaction, just kept in your wallet.
4539
- 4. "comment_to" (string, optional) A comment to store the name of the person or organization
4540
- to which you're sending the transaction. This is not part of the
5173
+ 4. "comment_to" (string, optional) A comment to store the name of the person or organization
5174
+ to which you're sending the transaction. This is not part of the
4541
5175
  transaction, just kept in your wallet.
4542
5176
  5. subtractfeefromamount (boolean, optional, default=false) The fee will be deducted from the amount being sent.
4543
5177
  The recipient will receive less neurais than you enter in the amount field.
@@ -4555,9 +5189,9 @@ Examples:
4555
5189
  > neurai-cli sendtoaddress "1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 "donation" "seans outpost"
4556
5190
  > neurai-cli sendtoaddress "1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd" 0.1 "" "" true
4557
5191
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "sendtoaddress", "params": ["1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd", 0.1, "donation", "seans outpost"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4558
-
4559
- &nbsp;<br> &nbsp;<br/>
4560
- ## setaccount
5192
+
5193
+ &nbsp;<br> &nbsp;<br/>
5194
+ ## setaccount
4561
5195
  &nbsp;<br/> setaccount "address" "account"
4562
5196
 
4563
5197
  DEPRECATED. Sets the account associated with the given address.
@@ -4569,9 +5203,9 @@ Arguments:
4569
5203
  Examples:
4570
5204
  > neurai-cli setaccount "1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX" "tabby"
4571
5205
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "setaccount", "params": ["1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX", "tabby"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4572
-
4573
- &nbsp;<br> &nbsp;<br/>
4574
- ## setban
5206
+
5207
+ &nbsp;<br> &nbsp;<br/>
5208
+ ## setban
4575
5209
  &nbsp;<br/> setban "subnet" "add|remove" (bantime) (absolute)
4576
5210
 
4577
5211
  Attempts to add or remove an IP/Subnet from the banned list.
@@ -4586,9 +5220,9 @@ Examples:
4586
5220
  > neurai-cli setban "192.168.0.6" "add" 86400
4587
5221
  > neurai-cli setban "192.168.0.0/24" "add"
4588
5222
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "setban", "params": ["192.168.0.6", "add", 86400] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4589
-
4590
- &nbsp;<br> &nbsp;<br/>
4591
- ## setgenerate
5223
+
5224
+ &nbsp;<br> &nbsp;<br/>
5225
+ ## setgenerate
4592
5226
  &nbsp;<br/> setgenerate generate ( genproclimit )
4593
5227
 
4594
5228
  Set 'generate' true or false to turn generation on or off.
@@ -4605,25 +5239,25 @@ Set the generation on with a limit of one processor
4605
5239
  > neurai-cli setgenerate true 1
4606
5240
 
4607
5241
  Check the setting
4608
- > neurai-cli getgenerate
5242
+ > neurai-cli getgenerate
4609
5243
 
4610
5244
  Turn off generation
4611
5245
  > neurai-cli setgenerate false
4612
5246
 
4613
5247
  Using json rpc
4614
5248
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "setgenerate", "params": [true, 1] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4615
-
4616
- &nbsp;<br> &nbsp;<br/>
4617
- ## setnetworkactive
5249
+
5250
+ &nbsp;<br> &nbsp;<br/>
5251
+ ## setnetworkactive
4618
5252
  &nbsp;<br/> setnetworkactive true|false
4619
5253
 
4620
5254
  Disable/enable all p2p network activity.
4621
5255
 
4622
5256
  Arguments:
4623
5257
  1. "state" (boolean, required) true to enable networking, false to disable
4624
-
4625
- &nbsp;<br> &nbsp;<br/>
4626
- ## settxfee
5258
+
5259
+ &nbsp;<br> &nbsp;<br/>
5260
+ ## settxfee
4627
5261
  &nbsp;<br/> settxfee amount
4628
5262
 
4629
5263
  Set the transaction fee per kB. Overwrites the paytxfee parameter.
@@ -4637,9 +5271,9 @@ true|false (boolean) Returns true if successful
4637
5271
  Examples:
4638
5272
  > neurai-cli settxfee 0.00001
4639
5273
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "settxfee", "params": [0.00001] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4640
-
4641
- &nbsp;<br> &nbsp;<br/>
4642
- ## signmessage
5274
+
5275
+ &nbsp;<br> &nbsp;<br/>
5276
+ ## signmessage
4643
5277
  &nbsp;<br/> signmessage "address" "message"
4644
5278
 
4645
5279
  Sign a message with the private key of an address
@@ -4664,9 +5298,9 @@ Verify the signature
4664
5298
 
4665
5299
  As json rpc
4666
5300
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "signmessage", "params": ["1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX", "my message"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4667
-
4668
- &nbsp;<br> &nbsp;<br/>
4669
- ## signmessagewithprivkey
5301
+
5302
+ &nbsp;<br> &nbsp;<br/>
5303
+ ## signmessagewithprivkey
4670
5304
  &nbsp;<br/> signmessagewithprivkey "privkey" "message"
4671
5305
 
4672
5306
  Sign a message with the private key of an address
@@ -4688,9 +5322,9 @@ Verify the signature
4688
5322
 
4689
5323
  As json rpc
4690
5324
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "signmessagewithprivkey", "params": ["privkey", "my message"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4691
-
4692
- &nbsp;<br> &nbsp;<br/>
4693
- ## signrawtransaction
5325
+
5326
+ &nbsp;<br> &nbsp;<br/>
5327
+ ## signrawtransaction
4694
5328
  &nbsp;<br/> signrawtransaction "hexstring" ( [{"txid":"id","vout":n,"scriptPubKey":"hex","redeemScript":"hex"},...] ["privatekey1",...] sighashtype )
4695
5329
 
4696
5330
  Sign inputs for raw transaction (serialized, hex-encoded).
@@ -4745,15 +5379,14 @@ Result:
4745
5379
  Examples:
4746
5380
  > neurai-cli signrawtransaction "myhex"
4747
5381
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "signrawtransaction", "params": ["myhex"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4748
-
4749
- &nbsp;<br> &nbsp;<br/>
4750
- ## stop
5382
+
5383
+ &nbsp;<br> &nbsp;<br/>
5384
+ ## stop
4751
5385
  &nbsp;<br/> stop
4752
5386
 
4753
5387
  Stop Neurai server.
4754
-
4755
- &nbsp;<br> &nbsp;<br/>
4756
- ## submitblock
5388
+ &nbsp;<br> &nbsp;<br/>
5389
+ ## submitblock
4757
5390
  &nbsp;<br/> submitblock "hexdata" ( "dummy" )
4758
5391
 
4759
5392
  Attempts to submit new block to network.
@@ -4768,10 +5401,10 @@ Result:
4768
5401
  Examples:
4769
5402
  > neurai-cli submitblock "mydata"
4770
5403
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "submitblock", "params": ["mydata"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4771
-
4772
- &nbsp;<br> &nbsp;<br/>
4773
- ## subscribetochannel
4774
- &nbsp;<br/> subscribetochannel
5404
+
5405
+ &nbsp;<br> &nbsp;<br/>
5406
+ ## subscribetochannel
5407
+ &nbsp;<br/> subscribetochannel
4775
5408
 
4776
5409
  THIS COMMAND IS NOT YET ACTIVE!
4777
5410
  https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
@@ -4788,9 +5421,9 @@ Result:[
4788
5421
  Examples:
4789
5422
  > neurai-cli subscribetochannel "ASSET_NAME!"
4790
5423
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "subscribetochannel", "params": ["ASSET_NAME!"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4791
-
4792
- &nbsp;<br> &nbsp;<br/>
4793
- ## testmempoolaccept
5424
+
5425
+ &nbsp;<br> &nbsp;<br/>
5426
+ ## testmempoolaccept
4794
5427
  &nbsp;<br/> testmempoolaccept ["rawtxs"] ( allowhighfees )
4795
5428
 
4796
5429
  Returns if raw transaction (serialized, hex-encoded) would be accepted by mempool.
@@ -4826,9 +5459,9 @@ Test acceptance of the transaction (signed hex)
4826
5459
 
4827
5460
  As a json rpc call
4828
5461
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "testmempoolaccept", "params": [["signedhex"]] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4829
-
4830
- &nbsp;<br> &nbsp;<br/>
4831
- ## transfer
5462
+
5463
+ &nbsp;<br> &nbsp;<br/>
5464
+ ## transfer
4832
5465
  &nbsp;<br/> transfer "asset_name" qty "to_address" "message" expire_time "change_address" "asset_change_address"
4833
5466
 
4834
5467
  THIS COMMAND IS NOT YET ACTIVE!
@@ -4845,16 +5478,16 @@ Arguments:
4845
5478
  7. "asset_change_address" (string, optional, default = "") the transactions Asset change will be sent to this address
4846
5479
 
4847
5480
  Result:
4848
- txid[
5481
+ txid[
4849
5482
  txid
4850
5483
  ]
4851
5484
 
4852
5485
  Examples:
4853
5486
  > neurai-cli transfer "ASSET_NAME" 20 "address" "" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E" 15863654
4854
5487
  > neurai-cli transfer "ASSET_NAME" 20 "address" "" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E" 15863654
4855
-
4856
- &nbsp;<br> &nbsp;<br/>
4857
- ## transferfromaddress
5488
+
5489
+ &nbsp;<br> &nbsp;<br/>
5490
+ ## transferfromaddress
4858
5491
  &nbsp;<br/> transferfromaddress "asset_name" "from_address" qty "to_address" "message" expire_time "xna_change_address" "asset_change_address"
4859
5492
 
4860
5493
  THIS COMMAND IS NOT YET ACTIVE!
@@ -4872,16 +5505,16 @@ Arguments:
4872
5505
  8. "asset_change_address" (string, optional, default = "") the transaction Asset change will be sent to this address
4873
5506
 
4874
5507
  Result:
4875
- txid[
5508
+ txid[
4876
5509
  txid
4877
5510
  ]
4878
5511
 
4879
5512
  Examples:
4880
5513
  > neurai-cli transferfromaddress "ASSET_NAME" "fromaddress" 20 "address" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E", 156545652
4881
5514
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "transferfromaddress", "params": ["ASSET_NAME" "fromaddress" 20 "address" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E", 156545652] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4882
-
4883
- &nbsp;<br> &nbsp;<br/>
4884
- ## transferfromaddresses
5515
+
5516
+ &nbsp;<br> &nbsp;<br/>
5517
+ ## transferfromaddresses
4885
5518
  &nbsp;<br/> transferfromaddresses "asset_name" ["from_addresses"] qty "to_address" "message" expire_time "xna_change_address" "asset_change_address"
4886
5519
 
4887
5520
  THIS COMMAND IS NOT YET ACTIVE!
@@ -4899,17 +5532,17 @@ Arguments:
4899
5532
  8. "asset_change_address" (string, optional, default = "") the transactions Asset change will be sent to this address
4900
5533
 
4901
5534
  Result:
4902
- txid[
5535
+ txid[
4903
5536
  txid
4904
5537
  ]
4905
5538
 
4906
5539
  Examples:
4907
5540
  > neurai-cli transferfromaddresses "ASSET_NAME" '["fromaddress1", "fromaddress2"]' 20 "to_address" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E" 154652365
4908
5541
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "transferfromaddresses", "params": ["ASSET_NAME" '["fromaddress1", "fromaddress2"]' 20 "to_address" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E" 154652365] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4909
-
4910
- &nbsp;<br> &nbsp;<br/>
4911
- ## transferqualifier
4912
- &nbsp;<br/> transferqualifier "qualifier_name" qty "to_address" ("change_address") ("message") (expire_time)
5542
+
5543
+ &nbsp;<br> &nbsp;<br/>
5544
+ ## transferqualifier
5545
+ &nbsp;<br/> transferqualifier "qualifier_name" qty "to_address" ("change_address") ("message") (expire_time)
4913
5546
 
4914
5547
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
4915
5548
 
@@ -4924,16 +5557,16 @@ Arguments:
4924
5557
  6. "expire_time" (numeric, optional) UTC timestamp of when the message expires
4925
5558
 
4926
5559
  Result:
4927
- txid[
5560
+ txid[
4928
5561
  txid
4929
5562
  ]
4930
5563
 
4931
5564
  Examples:
4932
5565
  > neurai-cli transferqualifier "#QUALIFIER" 20 "to_address" "" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E" 15863654
4933
5566
  > neurai-cli transferqualifier "#QUALIFIER" 20 "to_address" "change_address" "QmTqu3Lk3gmTsQVtjU7rYYM37EAW4xNmbuEAp2Mjr4AV7E" 15863654
4934
-
4935
- &nbsp;<br> &nbsp;<br/>
4936
- ## unfreezeaddress
5567
+
5568
+ &nbsp;<br> &nbsp;<br/>
5569
+ ## unfreezeaddress
4937
5570
  &nbsp;<br/> unfreezeaddress asset_name address (change_address) (asset_data)
4938
5571
 
4939
5572
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -4955,9 +5588,9 @@ Examples:
4955
5588
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "unfreezeaddress", "params": ["$RESTRICTED_ASSET" "address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4956
5589
  > neurai-cli unfreezeaddress "$RESTRICTED_ASSET" "address" "change_address"
4957
5590
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "unfreezeaddress", "params": ["$RESTRICTED_ASSET" "address" "change_address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
4958
-
4959
- &nbsp;<br> &nbsp;<br/>
4960
- ## unfreezedepin
5591
+
5592
+ &nbsp;<br> &nbsp;<br/>
5593
+ ## unfreezedepin
4961
5594
  &nbsp;<br/> unfreezedepin "asset_name" "address" ("change_address")
4962
5595
 
4963
5596
  THIS COMMAND IS NOT YET ACTIVE!
@@ -4980,9 +5613,9 @@ Result:
4980
5613
  Examples:
4981
5614
  > neurai-cli unfreezedepin "&FRANCE" "address"
4982
5615
  > 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:19001/
4983
-
4984
- &nbsp;<br> &nbsp;<br/>
4985
- ## unfreezerestrictedasset
5616
+
5617
+ &nbsp;<br> &nbsp;<br/>
5618
+ ## unfreezerestrictedasset
4986
5619
  &nbsp;<br/> unfreezerestrictedasset asset_name (change_address) (asset_data)
4987
5620
 
4988
5621
  THIS COMMAND IS NOT YET ACTIVE! Restricted assets must be active
@@ -5003,10 +5636,10 @@ Examples:
5003
5636
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "unfreezerestrictedasset", "params": ["$RESTRICTED_ASSET"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5004
5637
  > neurai-cli unfreezerestrictedasset "$RESTRICTED_ASSET" "change_address"
5005
5638
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "unfreezerestrictedasset", "params": ["$RESTRICTED_ASSET" "change_address"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5006
-
5007
- &nbsp;<br> &nbsp;<br/>
5008
- ## unsubscribefromchannel
5009
- &nbsp;<br/> unsubscribefromchannel
5639
+
5640
+ &nbsp;<br> &nbsp;<br/>
5641
+ ## unsubscribefromchannel
5642
+ &nbsp;<br/> unsubscribefromchannel
5010
5643
 
5011
5644
  THIS COMMAND IS NOT YET ACTIVE!
5012
5645
  https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
@@ -5023,9 +5656,9 @@ Result:[
5023
5656
  Examples:
5024
5657
  > neurai-cli unsubscribefromchannel "ASSET_NAME!"
5025
5658
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "unsubscribefromchannel", "params": ["ASSET_NAME!"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5026
-
5027
- &nbsp;<br> &nbsp;<br/>
5028
- ## uptime
5659
+
5660
+ &nbsp;<br> &nbsp;<br/>
5661
+ ## uptime
5029
5662
  &nbsp;<br/> uptime
5030
5663
 
5031
5664
  Returns the total uptime of the server.
@@ -5034,11 +5667,11 @@ Result:
5034
5667
  ttt (numeric) The number of seconds that the server has been running
5035
5668
 
5036
5669
  Examples:
5037
- > neurai-cli uptime
5670
+ > neurai-cli uptime
5038
5671
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "uptime", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5039
-
5040
- &nbsp;<br> &nbsp;<br/>
5041
- ## validateaddress
5672
+
5673
+ &nbsp;<br> &nbsp;<br/>
5674
+ ## validateaddress
5042
5675
  &nbsp;<br/> validateaddress "address"
5043
5676
 
5044
5677
  Return information about the given neurai address.
@@ -5077,9 +5710,9 @@ Result:
5077
5710
  Examples:
5078
5711
  > neurai-cli validateaddress "NLhdtwjgrcEkRqjJZkRY4sjhkJ93EytLeE"
5079
5712
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "validateaddress", "params": ["NLhdtwjgrcEkRqjJZkRY4sjhkJ93EytLeE"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5080
-
5081
- &nbsp;<br> &nbsp;<br/>
5082
- ## verifychain
5713
+
5714
+ &nbsp;<br> &nbsp;<br/>
5715
+ ## verifychain
5083
5716
  &nbsp;<br/> verifychain ( checklevel nblocks )
5084
5717
 
5085
5718
  Verifies blockchain database.
@@ -5092,11 +5725,79 @@ Result:
5092
5725
  true|false (boolean) Verified or not
5093
5726
 
5094
5727
  Examples:
5095
- > neurai-cli verifychain
5728
+ > neurai-cli verifychain
5096
5729
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "verifychain", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5097
-
5098
- &nbsp;<br> &nbsp;<br/>
5099
- ## verifymessage
5730
+
5731
+ &nbsp;<br> &nbsp;<br/>
5732
+ ## verifydistribution
5733
+ &nbsp;<br/> verifydistribution {plan} [batches] ( {options} )
5734
+
5735
+ Classifies the batches of a distribution plan from the operator's batch records (NIP-048): every signed
5736
+ version of each batch. Nothing is broadcast, rebuilt or spent.
5737
+ confirmed a version that pays the batch has the required confirmations
5738
+ confirming a version is in the active chain with fewer confirmations; its recipients stay reserved
5739
+ pending a version is in the mempool, or is signed and all its inputs are unspent; rebroadcast it
5740
+ conflicting every version has an input spent by another transaction (needs -txindex to tell apart
5741
+ from a confirmed version whose outputs were all spent)
5742
+ unknown no recorded version, or the node cannot tell; review before building anything
5743
+
5744
+ Arguments:
5745
+ 1. plan (object, required) The plan parameters
5746
+ {
5747
+ "asset_name": "name", (string, required) as in getdistributionplan
5748
+ "snapshot_height": n, (number, required)
5749
+ "distribution_asset_name": "name", (string, required)
5750
+ "amount": x.xxx, (numeric, required) gross_distribution_amount
5751
+ "exception_addresses": "a,b", (string, optional)
5752
+ "remainder": "payer"|"largest", (string, optional, default "payer")
5753
+ "allow_legacy_snapshot": bool, (boolean, optional, default false)
5754
+ "announcement": {"txid": "hex", "block_hash": "hex"} (object, optional) as in getdistributionplan
5755
+ "qualifier": "#TAG", (string, optional) as in getdistributionplan
5756
+ "weights": {"address": n, ...}, (object, optional) as in getdistributionplan
5757
+ "report": {"txid": "hex", "block_hash": "hex"} (object, optional) as in getdistributionplan
5758
+ "allocation": "holdings"|"equal", (string, optional, default "holdings") as in getdistributionplan
5759
+ "min_held": x.xxx, (numeric, optional) as in getdistributionplan
5760
+ }
5761
+ 2. batches (array, required) The operator's batch records
5762
+ [
5763
+ {
5764
+ "index": n, (number, required) batch index
5765
+ "versions": [ (array, required) every signed version, as hex or as
5766
+ "hex" | { "hex": "hex", "block_hash": "hash" }, ... an object with the block it was seen in
5767
+ ]
5768
+ }, ...
5769
+ ]
5770
+ 3. options (object, optional)
5771
+ {
5772
+ "max_outputs": n, (number, default 500) batch size used to build the batches
5773
+ "confirmations": n (number, default 6) confirmations a batch needs to count as paid
5774
+ }
5775
+
5776
+ Result:
5777
+ {
5778
+ "plan_hash": "hex",
5779
+ "complete": true|false, (boolean) every batch is confirmed
5780
+ "paid": x.xxx, (numeric) amount in confirmed batches
5781
+ "reserved": x.xxx, (numeric) amount in confirming and pending batches
5782
+ "unpaid": x.xxx, (numeric) amount in conflicting and unknown batches
5783
+ "batches": [
5784
+ {
5785
+ "index": n,
5786
+ "batch_id": "hex",
5787
+ "state": "confirmed"|"confirming"|"pending"|"conflicting"|"unknown",
5788
+ "txid": "hex", (string, optional) the version that decides the state
5789
+ "confirmations": n, (number, optional)
5790
+ "amount": x.xxx,
5791
+ "issues": [ "text", ... ]
5792
+ }, ...
5793
+ ]
5794
+ }
5795
+
5796
+ Examples:
5797
+ > neurai-cli verifydistribution '{"asset_name":"TRONCO","snapshot_height":12345,"distribution_asset_name":"XNA","amount":1000}' '[{"index":0,"versions":["0200..."]}]'
5798
+
5799
+ &nbsp;<br> &nbsp;<br/>
5800
+ ## verifymessage
5100
5801
  &nbsp;<br/> verifymessage "address" "signature" "message"
5101
5802
 
5102
5803
  Verify a signed message
@@ -5122,9 +5823,9 @@ Verify the signature
5122
5823
 
5123
5824
  As json rpc
5124
5825
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "verifymessage", "params": ["1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX", "signature", "my message"] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5125
-
5126
- &nbsp;<br> &nbsp;<br/>
5127
- ## verifytxoutproof
5826
+
5827
+ &nbsp;<br> &nbsp;<br/>
5828
+ ## verifytxoutproof
5128
5829
  &nbsp;<br/> verifytxoutproof "proof"
5129
5830
 
5130
5831
  Verifies that a proof points to a transaction in a block, returning the transaction it commits to
@@ -5135,10 +5836,10 @@ Arguments:
5135
5836
 
5136
5837
  Result:
5137
5838
  ["txid"] (array, strings) The txid(s) which the proof commits to, or empty array if the proof is invalid
5138
-
5139
- &nbsp;<br> &nbsp;<br/>
5140
- ## viewallmessagechannels
5141
- &nbsp;<br/> viewallmessagechannels
5839
+
5840
+ &nbsp;<br> &nbsp;<br/>
5841
+ ## viewallmessagechannels
5842
+ &nbsp;<br/> viewallmessagechannels
5142
5843
 
5143
5844
  THIS COMMAND IS NOT YET ACTIVE!
5144
5845
  https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
@@ -5151,12 +5852,12 @@ Result:[
5151
5852
  ]
5152
5853
 
5153
5854
  Examples:
5154
- > neurai-cli viewallmessagechannels
5855
+ > neurai-cli viewallmessagechannels
5155
5856
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "viewallmessagechannels", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5156
-
5157
- &nbsp;<br> &nbsp;<br/>
5158
- ## viewallmessages
5159
- &nbsp;<br/> viewallmessages
5857
+
5858
+ &nbsp;<br> &nbsp;<br/>
5859
+ ## viewallmessages
5860
+ &nbsp;<br/> viewallmessages
5160
5861
 
5161
5862
  THIS COMMAND IS NOT YET ACTIVE!
5162
5863
  https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
@@ -5173,12 +5874,12 @@ Result:
5173
5874
  "Expire UTC Time:" (Date, optional) If the message contains an expire date that is too large, the UTC number will be displayed
5174
5875
 
5175
5876
  Examples:
5176
- > neurai-cli viewallmessages
5877
+ > neurai-cli viewallmessages
5177
5878
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "viewallmessages", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5178
-
5179
- &nbsp;<br> &nbsp;<br/>
5180
- ## viewmyrestrictedaddresses
5181
- &nbsp;<br/> viewmyrestrictedaddresses
5879
+
5880
+ &nbsp;<br> &nbsp;<br/>
5881
+ ## viewmyrestrictedaddresses
5882
+ &nbsp;<br/> viewmyrestrictedaddresses
5182
5883
 
5183
5884
  THIS COMMAND IS NOT YET ACTIVE!
5184
5885
  https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
@@ -5194,12 +5895,12 @@ Result:
5194
5895
  }...
5195
5896
 
5196
5897
  Examples:
5197
- > neurai-cli viewmyrestrictedaddresses
5898
+ > neurai-cli viewmyrestrictedaddresses
5198
5899
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "viewmyrestrictedaddresses", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5199
-
5200
- &nbsp;<br> &nbsp;<br/>
5201
- ## viewmytaggedaddresses
5202
- &nbsp;<br/> viewmytaggedaddresses
5900
+
5901
+ &nbsp;<br> &nbsp;<br/>
5902
+ ## viewmytaggedaddresses
5903
+ &nbsp;<br/> viewmytaggedaddresses
5203
5904
 
5204
5905
  THIS COMMAND IS NOT YET ACTIVE!
5205
5906
  https://github.com/NeuraiProject/rips/blob/master/rip-0005.mediawiki
@@ -5215,6 +5916,5 @@ Result:
5215
5916
  }...
5216
5917
 
5217
5918
  Examples:
5218
- > neurai-cli viewmytaggedaddresses
5919
+ > neurai-cli viewmytaggedaddresses
5219
5920
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "viewmytaggedaddresses", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:19001/
5220
-