@neuraiproject/neurai-rpc 0.4.6 → 0.4.7

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/dist/index.mjs CHANGED
@@ -164,10 +164,10 @@ Examples:
164
164
  **/ checkaddresstag: 'checkaddresstag',
165
165
  /** checkdepinvalidity "asset_name" "address"
166
166
 
167
- Check if a DEPIN asset is valid/active for a specific address
167
+ Check if a dedicated DePIN asset is valid/active for a specific address. Dedicated DePIN assets currently use the '&' prefix.
168
168
 
169
169
  Arguments:
170
- 1. "asset_name" (string, required) The DEPIN asset name
170
+ 1. "asset_name" (string, required) The DePIN asset name
171
171
  2. "address" (string, required) The address to check
172
172
 
173
173
  Result:
@@ -1033,14 +1033,14 @@ Examples:
1033
1033
  **/ freezeaddress: 'freezeaddress',
1034
1034
  /** freezedepin "asset_name" "address" ("change_address")
1035
1035
 
1036
- Freeze a DEPIN asset for a specific address (owner only)
1036
+ Freeze a dedicated DePIN asset for a specific address (owner only)
1037
1037
 
1038
1038
  The address will still hold the asset but it will be marked as invalid
1039
1039
 
1040
- Requires the owner token (ASSET!) in the wallet
1040
+ Requires the owner token for the DePIN asset (for example, '&FRANCE!' for '&FRANCE') in the wallet
1041
1041
 
1042
1042
  Arguments:
1043
- 1. "asset_name" (string, required) The DEPIN asset name
1043
+ 1. "asset_name" (string, required) The DePIN asset name
1044
1044
  2. "address" (string, required) The address to freeze
1045
1045
  3. "change_address" (string, optional) The change address for the owner token
1046
1046
 
@@ -2853,6 +2853,7 @@ Asset name must not conflict with any existing asset.
2853
2853
  Unit as the number of decimals precision for the asset (0 for whole units ("1"), 8 for max precision ("1.00000000")
2854
2854
  Reissuable is true/false for whether additional units can be issued by the original issuer.
2855
2855
  If issuing a unique asset these values are required (and will be defaulted to): qty=1, units=0, reissuable=false.
2856
+ Dedicated DePIN assets (name starts with '&') are documented here as enabled for mainnet and testnet, with qty > 0 and units=0.
2856
2857
 
2857
2858
  Arguments:
2858
2859
  1. "asset_name" (string, required) a unique name
@@ -3149,20 +3150,43 @@ Examples:
3149
3150
  > neurai-cli listbanned
3150
3151
  > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listbanned", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
3151
3152
  **/ listbanned: 'listbanned',
3153
+ /** listdepinaddresses "asset_name" (count) (start)
3154
+
3155
+ Returns a list of addresses that own the given asset and have a revealed public key on-chain.
3156
+ Useful for DePIN messaging recipient discovery. Requires -assetindex and -pubkeyindex.
3157
+
3158
+ Arguments:
3159
+ 1. "asset_name" (string, required) name of asset
3160
+ 2. "count" (integer, optional, default=50000, MAX=50000) truncates results to include only the first _count_ addresses found
3161
+ 3. "start" (integer, optional, default=0) results skip over the first _start_ addresses found (if negative it skips back from the end)
3162
+
3163
+ Result:
3164
+ [
3165
+ {
3166
+ "address": "address", (string) The address
3167
+ "pubkey": "pubkey_hex" (string) The revealed public key in hex
3168
+ },
3169
+ ...
3170
+ ]
3171
+
3172
+ Examples:
3173
+ > neurai-cli listdepinaddresses "&FRANCE"
3174
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listdepinaddresses", "params": ["&FRANCE"] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
3175
+ **/ listdepinaddresses: 'listdepinaddresses',
3152
3176
  /** listdepinholders "asset_name"
3153
3177
 
3154
- Returns all addresses holding a DEPIN asset with validity status
3178
+ Returns all addresses holding a dedicated DePIN asset with validity status
3155
3179
 
3156
- DEPIN assets are soulbound (non-transferable except by owner) and can be frozen/revoked
3180
+ Dedicated DePIN assets are soulbound and can be frozen/revoked. They currently use the '&' prefix.
3157
3181
 
3158
3182
  Arguments:
3159
- 1. "asset_name" (string, required) The DEPIN asset name
3183
+ 1. "asset_name" (string, required) The DePIN asset name
3160
3184
 
3161
3185
  Result:
3162
3186
  [
3163
3187
  {
3164
3188
  "address": "address", (string) The address
3165
- "amount": n, (numeric) The amount (always 1 for DEPIN)
3189
+ "amount": n, (numeric) The amount held
3166
3190
  "valid": 1|0 (numeric) 1 = active/valid, 0 = blocked/revoked
3167
3191
  },
3168
3192
  ...
@@ -3257,6 +3281,20 @@ Examples:
3257
3281
  > neurai-cli listmyassets "ASSET*" true 10 20
3258
3282
  > neurai-cli listmyassets "ASSET*" true 10 20 1
3259
3283
  **/ listmyassets: 'listmyassets',
3284
+ /** listpqaddresses
3285
+
3286
+ Returns post-quantum (ML-DSA-44) Bech32m addresses in the wallet.
3287
+
3288
+ Result:
3289
+ [
3290
+ "nq1...", (string) A post-quantum wallet address
3291
+ ...
3292
+ ]
3293
+
3294
+ Examples:
3295
+ > neurai-cli listpqaddresses
3296
+ > curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listpqaddresses", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:8766/
3297
+ **/ listpqaddresses: 'listpqaddresses',
3260
3298
  /** listreceivedbyaccount ( minconf include_empty include_watchonly)
3261
3299
 
3262
3300
  DEPRECATED. List balances by account.
@@ -3690,6 +3728,7 @@ Examples:
3690
3728
  Reissues a quantity of an asset to an owned address if you own the Owner Token
3691
3729
  Can change the reissuable flag during reissuance
3692
3730
  Can change the ipfs hash during reissuance
3731
+ For dedicated DePIN assets (name starts with '&'), qty must stay positive and units must remain 0.
3693
3732
  Arguments:
3694
3733
  1. "asset_name" (string, required) name of asset that is being reissued
3695
3734
  2. "qty" (numeric, required) number of assets to reissue
@@ -3809,14 +3848,14 @@ Examples:
3809
3848
  **/ savemempool: 'savemempool',
3810
3849
  /** selfrevokedepin "asset_name"
3811
3850
 
3812
- Self-revoke a DEPIN asset held in this wallet
3851
+ Self-revoke a dedicated DePIN asset held in this wallet
3813
3852
 
3814
3853
  The asset will be marked as invalid but will remain in the address
3815
3854
 
3816
3855
  This action can only be undone by the asset owner
3817
3856
 
3818
3857
  Arguments:
3819
- 1. "asset_name" (string, required) The DEPIN asset name
3858
+ 1. "asset_name" (string, required) The DePIN asset name
3820
3859
 
3821
3860
  Result:
3822
3861
  "txid" (string) The transaction id
@@ -4352,14 +4391,14 @@ Examples:
4352
4391
  **/ unfreezeaddress: 'unfreezeaddress',
4353
4392
  /** unfreezedepin "asset_name" "address" ("change_address")
4354
4393
 
4355
- Unfreeze a DEPIN asset for a specific address (owner only)
4394
+ Unfreeze a dedicated DePIN asset for a specific address (owner only)
4356
4395
 
4357
4396
  The asset will be marked as valid again
4358
4397
 
4359
- Requires the owner token (ASSET!) in the wallet
4398
+ Requires the owner token for the DePIN asset (for example, '&FRANCE!' for '&FRANCE') in the wallet
4360
4399
 
4361
4400
  Arguments:
4362
- 1. "asset_name" (string, required) The DEPIN asset name
4401
+ 1. "asset_name" (string, required) The DePIN asset name
4363
4402
  2. "address" (string, required) The address to unfreeze
4364
4403
  3. "change_address" (string, optional) The change address for the owner token
4365
4404