# Multichain Commands

Placeholder convention: Examples in this reference use yourapp as an example token/currency name, i... to mark a placeholder i-address (substitute the real one from getcurrency), and <block-height> for a placeholder block number. Commands shown were tested on VRSCTEST — only these project-specific values have been genericized.

Category: Multichain | Version: v1.2.x+

⚠️ DOCUMENTED FROM HELP — Adds a fully prepared block and its header to the current merge mining queue.

Syntax

addmergedblock "hexdata" ( "jsonparametersobject" )

Parameters

Parameters 2–5 are passed as a JSON object. Default action when adding would exceed available space is to replace the choice with the least ROI if the new block provides more.

Result

Examples

verus addmergedblock "hexdata" '{"currencyid":"hexstring","rpchost":"127.0.0.1","rpcport":portnum}'

curl --user myusername --data-binary '{"jsonrpc":"1.0","id":"curltest","method":"addmergedblock","params":["hexdata",{"currencyid":"hexstring","rpchost":"127.0.0.1","rpcport":portnum,"estimatedroi":0.5}]}' -H 'content-type:text/plain;' http://127.0.0.1:27486/

Common Errors

Related Commands

• getblocktemplate — Get block template for mining
• submitblock — Submit a mined block

Notes

• Used for merge mining operations where multiple chains share proof-of-work.
• The daemon manages merge mining slots and automatically compares ROI to decide which blocks to keep.
• nTime and nSolution fields in the provided block data are replaced by the daemon.

Tested On

• VRSCTEST v1.2.14-2, block height 926990
• ⚠️ Not directly tested — requires active merge mining setup

Category: Multichain | Version: v1.2.x+

Clears the mempool of all transactions or specific cache types on this node.

Syntax

clearrawmempool '["cachetype1","cachetype2",...]'

Parameters

Valid cache types

Result

No output on success.

Examples

Clear all mempool caches

verus -testnet clearrawmempool

(No output on success)

Clear only specific cache types

verus -testnet clearrawmempool '["offermap","evidence"]'

Clear only offer-related cache

verus -testnet clearrawmempool '["offermap"]'

Common Errors

Related Commands

• getrawmempool — View current mempool contents
• getmempoolinfo — Get mempool statistics

Notes

• Use with caution — clearing the mempool removes unconfirmed transactions from this node's view.
• Selective clearing using cache type filters is safer than clearing everything.
• Useful for troubleshooting stuck transactions or clearing stale cross-chain data.
• Only affects the local node's mempool; does not affect other nodes on the network.
• Transactions will be re-received from peers if they are still valid.

Tested On

• VRSCTEST v1.2.14-2, block height 926990

Category: Multichain | Version: v1.2.x+

Defines a new blockchain currency, either as an independent PBaaS blockchain or as a token on this blockchain.

Syntax

verus definecurrency '{"name":"coinortokenname",...}' ('{"name":"fractionalgatewayname",...}') ...

Parameters The primary argument is a JSON object with the currency definition:

Result

{
  "txid": "transactionid",
  "tx": "json",
  "hex": "data"
}

Examples

Simple Token Definition (reference: yourapp) The yourapp token on VRSCTEST was defined with these characteristics:

## Example definition (DO NOT run — creates real currency):
./verus -testnet definecurrency '{
  "name": "yourapp",
  "options": 32,
  "proofprotocol": 2,
  "idregistrationfees": 0.01,
  "idreferrallevels": 0,
  "preallocations": [{"myid@": 200}]
}'

## Result: yourapp token created at block <block-height>
## currencyid: i...
## proofprotocol 2 = centralized (ID holder can mint/burn)
## options 32 (0x20) = TOKEN

Fractional Basket Currency (reference: VRSC-USD)

## Example fractional currency with two reserves:
./verus -testnet definecurrency '{
  "name": "VRSC-USD",
  "options": 33,
  "currencies": ["VRSCTEST", "USD"],
  "weights": [0.5, 0.5],
  "initialsupply": 2000000,
  "initialcontributions": [200000, 1000000],
  "idregistrationfees": 5,
  "idreferrallevels": 3
}'
## options 33 = FRACTIONAL (1) + TOKEN (32)

PBaaS Chain Definition

./verus -testnet definecurrency '{
  "name": "mypbaas",
  "options": 264,
  "idregistrationfees": 100,
  "idreferrallevels": 3,
  "notarizationreward": 0.0001,
  "eras": [{"reward": 600000000, "halving": 1051924, "eraend": 0}],
  "nodes": [{"networkaddress": "1.2.3.4:12345", "nodeidentity": "mynode@"}],
  "blocktime": 60
}'
## options 264 = IS_PBAAS_CHAIN (256) + IDREFERRALS (8)

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"definecurrency","params":[{"name":"tokenname","options":32,"proofprotocol":2,"idregistrationfees":0.01,"idreferrallevels":0}]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Create a simple token with options: 32 (TOKEN) and proofprotocol: 2 (centralized)
• Create a fractional basket with options: 33 (FRACTIONAL+TOKEN), reserve currencies, and weights
• Launch a PBaaS chain with options: 264 (IS_PBAAS_CHAIN+IDREFERRALS), eras, and nodes
• Create a gateway converter for cross-chain bridges using gatewayconvertername

Related Commands

• getcurrency — verify the currency after creation
• listcurrencies — list all currencies
• sendcurrency — send/convert with the new currency
• getlaunchinfo — get launch details

Notes

• The identity named after the currency must exist and have no active currency
• All launch funds must be available from the identity with the same name
• Once activated, the symbol cannot be reused (even if identity is transferred/revoked) unless endblock is set and reached
• Currency registration fee on VRSCTEST: 200 VRSCTEST; PBaaS chain: 10,000 VRSCTEST
• Options are additive bitfields: combine with OR (e.g., FRACTIONAL + TOKEN = 0x1 + 0x20 = 0x21 = 33)

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Estimates conversion from one currency to another, accounting for pending conversions, fees, and slippage.

Syntax

verus estimateconversion '{"currency":"name","convertto":"name","amount":n}'
verus estimateconversion '[array of conversions]'

Multiple conversions can be passed as an array for batch estimation through one basket.

Result

{
  "inputcurrencyid": "i-address",
  "netinputamount": 99.95,
  "outputcurrencyid": "i-address",
  "estimatedcurrencyout": 568.27,
  "estimatedcurrencystate": { ... }
}

Examples

Convert VRSCTEST → VRSC-USD (reserve → fractional)

./verus -testnet estimateconversion '{"currency":"VRSCTEST","convertto":"VRSC-USD","amount":10}'
## Actual Output (tested on VRSCTEST)
{
  "inputcurrencyid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
  "netinputamount": 9.99750000,
  "outputcurrencyid": "i4QdaEnkSxkAK4FRhRJcq7V7WgRN2XhzMD",
  "estimatedcurrencyout": 53.30897428,
  "estimatedcurrencystate": {
    "flags": 49,
    "currencyid": "i4QdaEnkSxkAK4FRhRJcq7V7WgRN2XhzMD",
    "reservecurrencies": [
      {
        "currencyid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
        "weight": 0.50000000,
        "reserves": 189111.88850281,
        "priceinreserve": 0.18754127
      },
      {
        "currencyid": "iFawzbS99RqGs7J2TNxME1TmmayBGuRkA2",
        "weight": 0.50000000,
        "reserves": 1075715.34495600,
        "priceinreserve": 1.06678128
      }
    ],
    "supply": 2016749.56340113
  }
}

Convert Between Reserves via Basket (VRSCTEST → USD via VRSC-USD)

./verus -testnet estimateconversion '{"currency":"VRSCTEST","convertto":"USD","via":"VRSC-USD","amount":100}'
## Actual Output (tested on VRSCTEST)
{
  "inputcurrencyid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
  "netinputamount": 99.95000000,
  "outputcurrencyid": "iFawzbS99RqGs7J2TNxME1TmmayBGuRkA2",
  "estimatedcurrencyout": 568.27012650
}
## 100 VRSCTEST ≈ 568.27 USD (via VRSC-USD basket)

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"estimateconversion","params":[{"currency":"VRSCTEST","convertto":"VRSC-USD","amount":10}]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Price quotes before executing sendcurrency with conversion
• Slippage estimation — compare netinputamount vs amount to see fees
• Cross-reserve pricing — use via to estimate reserve-to-reserve swaps
• Batch estimation — pass array to estimate multiple conversions simultaneously

Related Commands

• sendcurrency — execute the conversion
• getcurrencyconverters — find available conversion pairs
• getcurrencystate — check current reserve ratios

Notes

• Fees are ~0.025% conversion fee + 0.02% network fee (visible in netinputamount vs amount)
• The estimatedcurrencystate shows the projected state AFTER the conversion
• For reserve↔reserve swaps, you MUST use via to specify the fractional basket
• Direct conversion only works: reserve→fractional or fractional→reserve
• Results are estimates; actual output depends on other pending conversions in the same block

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Determines and returns the index of the best (most recent, valid, qualified) proof root from a list of proof roots.

Syntax

getbestproofroot '{"proofroots":[...],"lastconfirmed":n}'

Parameters

Result

Examples

Query with empty proof roots

verus -testnet getbestproofroot '{"proofroots":[],"lastconfirmed":0}'

Result:

{
  "latestproofroot": {
    "version": 1,
    "type": 1,
    "systemid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
    "height": 926990,
    "stateroot": "b55b3de4f19296085120a0b167f04bd1e2483bc65208ac0545b872fd449521e2",
    "blockhash": "000000018e6991fb0d5b595b7b7b8e4cb7f04a0b8b6704ecd0f063221d534bb1",
    "power": "000000000000007cdf67b5b86988e351000000000000000000070a048434c248"
  },
  "laststableproofroot": {
    "version": 1,
    "type": 1,
    "systemid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
    "height": 926970,
    "stateroot": "f2ad072f1f36c4ae2aa00b99e3b813465c2a753aa5db7bcb74f4fee61185d3f6",
    "blockhash": "000000025a722d4b3383c75413efe07e8f29c5990e7b53fee65794a41adbece2",
    "power": "000000000000007cdecdbd910883658e000000000000000000070a000e8a52fb"
  }
}

Common Errors

Related Commands

• getnotarizationdata — Get notarization data for a currency
• getnotarizationproofs — Get notarization proofs
• submitacceptednotarization — Submit a notarization

Notes

• Core part of the Verus cross-chain notarization protocol.
• The laststableproofroot is typically at tip - BLOCK_MATURITY (20 blocks) behind the latest.
• Proof roots contain the Merkle state root, block hash, and cumulative chain power for validation.

Tested On

• VRSCTEST v1.2.14-2, block height 926990

Category: Multichain | Version: v1.2.x+

Returns the complete definition for any given currency or chain registered on the blockchain.

Syntax

verus getcurrency "currencyname"

Result Returns a JSON object containing the full currency definition including version, options, parent chain, system ID, launch parameters, eras, nodes, and the last confirmed currency state.

Key fields:

• currencyid — the i-address identifier
• options — bitfield (0x20=TOKEN, 0x1=FRACTIONAL, 0x100=IS_PBAAS_CHAIN, etc.)
• systemid — system this currency runs on
• startblock / endblock — lifecycle boundaries
• bestcurrencystate / lastconfirmedcurrencystate — current supply, emissions, fees

Examples

Basic Usage — Token

./verus -testnet getcurrency yourapp
## Actual Output (tested on VRSCTEST)
{
  "version": 1,
  "options": 32,
  "name": "yourapp",
  "currencyid": "i...",
  "parent": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
  "systemid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
  "notarizationprotocol": 1,
  "proofprotocol": 2,
  "launchsystemid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
  "startblock": <block-height>,
  "endblock": 0,
  "idregistrationfees": 0.01000000,
  "idreferrallevels": 0,
  "idimportfees": 0.02000000,
  "fullyqualifiedname": "yourapp",
  "bestcurrencystate": {
    "flags": 48,
    "version": 1,
    "currencyid": "i...",
    "initialsupply": 0.00000000,
    "emitted": 10.00000000,
    "supply": 210.00000000
  }
}

Basic Usage — Native Chain

./verus -testnet getcurrency VRSCTEST
## Returns full VRSCTEST chain definition including:
## - eras with reward/halving schedule
## - node list for network connectivity
## - registration fee structure
## - preallocations

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getcurrency","params":["yourapp"]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Check if a currency exists before interacting with it
• Get the i-address (currencyid) for a currency by name
• Inspect supply via bestcurrencystate.supply
• Check launch status via startblock and currency state flags
• Find reserve currencies in fractional baskets via currencies and weights arrays

Related Commands

• listcurrencies — list all registered currencies
• getcurrencystate — get current state at specific height
• definecurrency — define a new currency
• getlaunchinfo — get launch details

Notes

• options: 32 (0x20) = TOKEN, options: 33 (0x21) = FRACTIONAL TOKEN
• proofprotocol: 2 means centralized (ID controller can mint/burn)
• The bestcurrencystate shows the latest state; lastconfirmedcurrencystate shows last notarized state

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Retrieves all fractional currencies that have the specified currencies as reserves, enabling conversion between them.

Syntax

verus getcurrencyconverters "currency1" "currency2" ...
verus getcurrencyconverters '{"convertto":"name","fromcurrency":"name","amount":n,"slippage":0.01}'

Parameters

Result Array of currency objects with their current state and last conversion amounts.

Examples

Find Converters for VRSCTEST

./verus -testnet getcurrencyconverters VRSCTEST
## Actual Output (tested on VRSCTEST, truncated)
[
  {
    "i4QdaEnkSxkAK4FRhRJcq7V7WgRN2XhzMD": {
      "version": 1,
      "options": 33,
      "name": "VRSC-USD",
      "currencyid": "i4QdaEnkSxkAK4FRhRJcq7V7WgRN2XhzMD",
      "currencies": [
        "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
        "iFawzbS99RqGs7J2TNxME1TmmayBGuRkA2"
      ],
      "weights": [0.50000000, 0.50000000],
      "initialsupply": 2000000.00000000,
      "initialcontributions": [200000.00000000, 1000000.00000000]
    },
    "fullyqualifiedname": "VRSC-USD",
    "height": 924671,
    ...
  },
  ...
]

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getcurrencyconverters","params":["VRSCTEST"]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Discover trading pairs — find all fractional baskets that hold a given currency
• Build a DEX UI — enumerate available conversion paths
• Price discovery — find converters with best rates for a target amount with slippage control

Related Commands

• estimateconversion — estimate a specific conversion
• sendcurrency — execute a conversion
• getcurrency — get details on a specific converter

Notes

• Only returns fractional currencies (baskets with reserves)
• Simple tokens like yourapp won't appear (they have no reserves)
• The advanced JSON form with slippage filters converters that can satisfy the trade within tolerance

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Returns the currency state(s) on the blockchain for any specified currency at a given height or range, optionally with market/volume data.

Syntax

verus getcurrencystate "currencynameorid" ("n") ("conversiondatacurrency")

Result Array of objects, each containing height, blocktime, currencystate, and optionally conversiondata with OHLCV-style volume pairs.

Examples

Basic Usage

./verus -testnet getcurrencystate yourapp
## Actual Output (tested on VRSCTEST)
[
  {
    "height": 926963,
    "blocktime": 1770448221,
    "currencystate": {
      "flags": 48,
      "version": 1,
      "currencyid": "i...",
      "launchcurrencies": [],
      "initialsupply": 0.00000000,
      "emitted": 10.00000000,
      "supply": 210.00000000,
      "primarycurrencyfees": 0.00000000,
      "primarycurrencyconversionfees": 0.00000000,
      "primarycurrencyout": 10.00000000,
      "preconvertedout": 0.00000000
    }
  }
]

At Specific Height

./verus -testnet getcurrencystate yourapp <block-height>
## replace <block-height> with an actual block number

Range with Step (for charting)

./verus -testnet getcurrencystate "VRSC-USD" "926900,926963,10"
## Returns state every 10 blocks from 926900 to 926963

With Market Data

./verus -testnet getcurrencystate "VRSC-USD" "" "VRSCTEST"
## Returns conversion volume data denominated in VRSCTEST

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getcurrencystate","params":["yourapp"]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Track supply over time with height ranges
• Build price charts using conversiondata with OHLCV volume pairs
• Monitor reserve ratios for fractional currencies
• Check fees collected via primarycurrencyfees and primarycurrencyconversionfees

Related Commands

• getcurrency — full currency definition
• getinitialcurrencystate — state at launch
• estimateconversion — estimate conversion with current state

Notes

• For fractional currencies, the state includes reservecurrencies with weights, reserves, and prices
• The flags field indicates currency state: launched, prelaunch, refunding, etc.
• Using a range with step is efficient for building historical charts

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Returns trust ratings for currencies in the wallet, controlling which currencies are synced/displayed.

Syntax

verus getcurrencytrust '["currencyid",...]'

Result

{
  "setratings": { "currencyid": JSONRatingObject, ... },
  "currencytrustmode": n
}

Trust modes:

• 0 = No restriction on sync (default)
• 1 = Only sync currencies rated as approved
• 2 = Sync all except those on block list

Examples

Get All Trust Ratings

./verus -testnet getcurrencytrust
## Actual Output (tested on VRSCTEST — no ratings set):
## (empty response — no trust ratings configured)

Query Specific Currency

./verus -testnet getcurrencytrust '["i..."]'
## Replace i... with the actual currencyid from getcurrency

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getcurrencytrust","params":[]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Check wallet filtering — see which currencies are approved/blocked
• Audit trust settings before changing them with setcurrencytrust

Related Commands

• setcurrencytrust — modify trust ratings
• listcurrencies — list all currencies

Notes

• Trust ratings are wallet-local settings, not on-chain
• Default mode 0 means all currencies are visible and spendable
• Useful for wallets that want to filter spam tokens

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Returns export transfers to the specified currency/chain within an optional block height range.

Syntax

verus getexports "chainname" (heightstart) (heightend)

Result Array of export objects containing height, txid, export info (source/destination systems, amounts, fees), partial transaction proof, and transfer details.

Examples

Get Exports for yourapp

./verus -testnet getexports yourapp
## Actual Output (tested on VRSCTEST, truncated)
[
  {
    "height": <block-height>,
    "txid": "62b74cbb9d2ed4050c1d59d09f69bda23cc0ca8de67343b8c1e6b17c961cd657",
    "txoutnum": 4,
    "exportinfo": {
      "version": 1,
      "flags": 65,
      "sourceheightstart": 0,
      "sourceheightend": <block-height>,
      "sourcesystemid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
      "destinationsystemid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
      "destinationcurrencyid": "i...",
      "totalamounts": {
        "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq": 100.00000000
      },
      "totalfees": {
        "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq": 100.00000000
      }
    },
    "transfers": []
  },
  ...
]

Get Exports in Height Range

./verus -testnet getexports VRSCTEST 926950 926963
## Returns exports to VRSCTEST within that block range

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getexports","params":["yourapp"]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Track cross-chain transfers leaving this chain
• Monitor bridge activity for specific currencies
• Verify export completion by checking transfer details
• Audit currency launch exports (initial funding)

Related Commands

• getimports — get incoming imports
• getpendingtransfers — pending (not yet exported) transfers
• sendcurrency — create exports with exportto

Notes

• The first export for a currency is typically the launch/definition transaction
• totalamounts and totalfees show aggregate values for all transfers in that export batch
• Exports are batched — multiple transfers may be aggregated into a single export

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Returns all imports into a specific currency/chain, optionally filtered by block height range.

Syntax

verus getimports "chainname" (startheight) (endheight)

Result Array of import objects containing import height, txid, import details (source system, amounts, token values), and the import notarization.

Examples

Get All Imports for VRSCTEST

./verus -testnet getimports VRSCTEST
## Actual Output (tested on VRSCTEST, first entry)
[
  {
    "importheight": 238,
    "importtxid": "0672a49165fd34fa387a4c497a93c7a3ccbfa093e136e136585695557f83a261",
    "importvout": 2,
    "import": {
      "version": 1,
      "flags": 15,
      "sourcesystemid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
      "sourceheight": 1,
      "importcurrencyid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
      "numoutputs": 0
    },
    "importnotarization": {
      "version": 2,
      "isdefinition": true,
      "launchcleared": true,
      "launchconfirmed": true,
      "launchcomplete": true,
      ...
    }
  },
  ...
]

Get Recent Imports

./verus -testnet getimports VRSCTEST 926900 926963

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getimports","params":["VRSCTEST"]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Track incoming cross-chain transfers
• Verify bridge imports from external systems
• Monitor currency launch imports (initial conversions)
• Debug cross-chain issues by checking import notarizations

Related Commands

• getexports — get outgoing exports
• getpendingtransfers — transfers awaiting export
• sendcurrency — send cross-chain (creates exports that become imports)

Notes

• The first import for VRSCTEST (height 238) is the chain's genesis/definition import
• Import notarizations contain launch state flags (launchcleared, launchconfirmed, launchcomplete)
• Can return very large result sets without height filtering on long-running chains

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Returns the total amount of preconversions confirmed on the blockchain for a specified currency at launch time.

Syntax

verus getinitialcurrencystate "name"

Result

{
  "flags": n,
  "version": 1,
  "currencyid": "i-address",
  "launchcurrencies": [],
  "initialsupply": 0.0,
  "emitted": 0.0,
  "supply": 0.0,
  "primarycurrencyfees": 0.0,
  "primarycurrencyconversionfees": 0.0,
  "primarycurrencyout": 0.0,
  "preconvertedout": 0.0
}

Examples

Get Initial State for yourapp

./verus -testnet getinitialcurrencystate yourapp
## Actual Output (tested on VRSCTEST)
{
  "flags": 26,
  "version": 1,
  "currencyid": "i...",
  "launchcurrencies": [],
  "initialsupply": 0.00000000,
  "emitted": 0.00000000,
  "supply": 0.00000000,
  "primarycurrencyfees": 0.00000000,
  "primarycurrencyconversionfees": 0.00000000,
  "primarycurrencyout": 0.00000000,
  "preconvertedout": 0.00000000
}
## flags 26 = prelaunch state flags
## supply 0 = no pre-conversions (tokens were pre-allocated, not pre-converted)

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getinitialcurrencystate","params":["yourapp"]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Verify launch conditions — check how much was pre-converted before launch
• Audit initial supply — confirm the starting supply matched expectations
• Compare initial vs current — use with getcurrencystate to see growth

Related Commands

• getcurrencystate — current state (compare with initial)
• getlaunchinfo — full launch details with proofs
• getcurrency — currency definition

Notes

• For simple tokens without pre-conversion, all values will be 0 (supply comes from preallocations)
• For fractional currencies, launchcurrencies will show reserve contributions
• The flags field encodes the launch state at the time of the snapshot
• Compare with current getcurrencystate to see how the currency has evolved since launch

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Returns the last import from a specific originating system.

Syntax

getlastimportfrom "systemname"

Parameters

Result

Examples

Query for a bridged system

verus -testnet getlastimportfrom "VRSC"

Result (when no bridge exists):

error code: -8
error message: Invalid chain name or chain ID

This error occurs because VRSC is not a bridged system on the VRSCTEST testnet. On mainnet with active bridges, this would return import and notarization data.

Common Errors

Related Commands

• getnotarizationdata — Get notarization data for a currency
• submitimports — Submit imports from another system
• getimports — Get imports for a currency

Notes

• Only works for systems that have an active bridge to the current chain.
• Returns both the last import transaction and the last confirmed notarization from that system.
• Useful for monitoring cross-chain import status and debugging bridge operations.

Tested On

• VRSCTEST v1.2.14-2, block height 926990

Category: Multichain | Version: v1.2.x+

Returns the launch notarization data and partial transaction proof for a currency's launch.

Syntax

verus getlaunchinfo "currencyid"

Result

{
  "currencydefinition": {},
  "txid": "hexstr",
  "voutnum": n,
  "transactionproof": {},
  "launchnotarization": {},
  "notarynotarization": {}
}

Examples

Get Launch Info for yourapp

./verus -testnet getlaunchinfo yourapp
## Actual Output (tested on VRSCTEST):
## Error: "No valid export found"
## This is expected for simple tokens that launched without pre-conversion exports

Get Launch Info for a PBaaS Chain or Fractional Currency

./verus -testnet getlaunchinfo VRSC-USD
## Would return the full launch notarization for the VRSC-USD fractional basket

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getlaunchinfo","params":["VRSC-USD"]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Verify currency launch — get proof that a currency was properly launched
• Cross-chain launch verification — use the transaction proof for external validation
• Audit launch parameters — confirm the original currency definition at launch

Related Commands

• getinitialcurrencystate — initial state at launch
• getcurrency — current currency definition
• definecurrency — how the currency was defined

Notes

• Simple tokens (like yourapp) that launch without pre-conversions may return "No valid export found"
• This command is primarily useful for PBaaS chains and fractional currencies with launch phases
• The transactionproof can be used for cross-chain verification of the launch

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Returns the latest PBaaS notarization data for a specified currency.

Syntax

getnotarizationdata "currencynameorid" (getevidence) (separatecounterevidence)

Parameters

Result

Examples

Get notarization data for VRSCTEST

verus -testnet getnotarizationdata "VRSCTEST"

Result:

{
  "version": 1,
  "notarizations": [
    {
      "index": 0,
      "txid": "0000000000000000000000000000000000000000000000000000000000000000",
      "vout": -1,
      "notarization": {
        "version": 2,
        "launchconfirmed": true,
        "proposer": {
          "address": "i3UXS5QPRQGNRDDqVnyWTnmFCTHDbzmsYk",
          "type": 4
        },
        "currencyid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
        "notarizationheight": 926990,
        "currencystate": {
          "flags": 16,
          "version": 1,
          "currencyid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
          "initialsupply": 0.00000000,
          "emitted": 0.00000000,
          "supply": 0.00000000
        },
        "proofroots": [
          {
            "version": 1,
            "type": 1,
            "systemid": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
            "height": 926990,
            "stateroot": "b55b3de4f19296085120a0b167f04bd1e2483bc65208ac0545b872fd449521e2",
            "blockhash": "000000018e6991fb0d5b595b7b7b8e4cb7f04a0b8b6704ecd0f063221d534bb1",
            "power": "000000000000007cdf67b5b86988e351000000000000000000070a048434c248"
          }
        ]
      }
    }
  ],
  "forks": [[0]],
  "lastconfirmedheight": 926990,
  "lastconfirmed": 0,
  "bestchain": 0
}

Common Errors

Related Commands

• getbestproofroot — Get best proof root
• getnotarizationproofs — Get notarization proofs
• submitacceptednotarization — Submit a notarization

Notes

• For the native chain (VRSCTEST on testnet), this returns the current chain state as a self-notarization.
• For cross-chain currencies, this returns pending and confirmed notarizations from bridged systems.
• The getevidence flag adds cryptographic evidence supporting each notarization.

Tested On

• VRSCTEST v1.2.14-2, block height 926990

Category: Multichain | Version: v1.2.x+

⚠️ DOCUMENTED FROM HELP — Returns proofs for requested challenges to unconfirmed cross-chain notarizations.

Syntax

getnotarizationproofs '[challengerequests, ...]'

Parameters

Takes an array of challenge request objects. Two types are supported:

Skip Challenge

Primary Proof

Result

Examples

verus -testnet getnotarizationproofs '[{"type":"iCwxpRL6h3YeCRtGjgQSsqoKdZCuM4Dxaf","evidence":{},"proveheight":100,"atheight":200}]'

Common Errors

Related Commands

• getnotarizationdata — Get notarization data
• submitchallenges — Submit evidence challenges
• getbestproofroot — Get best proof root

Notes

• Part of the Verus cross-chain consensus challenge/response protocol.
• Proofs can independently or in combination invalidate or force competing chains to provide more proofs.
• Skip challenges prove that blocks exist at certain heights; primary proofs provide full state proofs.

Tested On

• VRSCTEST v1.2.14-2, block height 926990
• ⚠️ Not directly tested — requires active cross-chain notarization disputes

Category: Multichain | Version: v1.2.x+

Returns all pending transfers for a particular chain that have not yet been aggregated into an export.

Syntax

verus getpendingtransfers "chainname"

Result Array of pending transfer objects, or empty if no transfers are pending.

Examples

Check Pending Transfers for VRSCTEST

./verus -testnet getpendingtransfers VRSCTEST
## Actual Output (tested on VRSCTEST):
## (empty — no pending transfers at time of test)

Check Pending Transfers for yourapp

./verus -testnet getpendingtransfers yourapp
## (empty — no pending transfers)

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getpendingtransfers","params":["VRSCTEST"]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Monitor cross-chain queue — see transfers waiting to be exported
• Debug stuck transfers — check if a sendcurrency with exportto is queued
• Pre-conversion monitoring — track pending pre-launch conversions

Related Commands

• getexports — see completed exports
• getimports — see completed imports
• sendcurrency — create transfers

Notes

• Pending transfers are temporary — they get batched into exports at the next block
• An empty result is normal when no cross-chain activity is in progress
• Transfers appear here briefly between sendcurrency and the next block that processes them

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Returns all reserve deposits under control of the specified currency or chain, showing the backing reserves.

Syntax

verus getreservedeposits "currencyname" (returnutxos)

Result

{
  "utxos": [...],
  "currency1_iaddress": value,
  "currency2_iaddress": value
}

Examples

Get Reserve Deposits for VRSC-USD Basket

./verus -testnet getreservedeposits VRSC-USD
## Actual Output (tested on VRSCTEST)
{
  "iFawzbS99RqGs7J2TNxME1TmmayBGuRkA2": 1075715.34495600,
  "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq": 189101.88975281
}
## Shows ~1.07M USD and ~189K VRSCTEST backing the VRSC-USD basket

Get Deposits for VRSCTEST (no reserves)

./verus -testnet getreservedeposits VRSCTEST
## Actual Output:
{}
## Empty — VRSCTEST is a native chain, not a fractional currency

With UTXO Details

./verus -testnet getreservedeposits VRSC-USD true
## Returns individual UTXOs that hold the reserve deposits

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"getreservedeposits","params":["VRSC-USD"]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Verify basket backing — confirm fractional currencies are fully backed by reserves
• Audit reserve health — compare reserves to supply for solvency checks
• Track reserve changes over time
• UTXO analysis — use returnutxos: true for detailed deposit accounting

Related Commands

• getcurrencystate — includes reserve amounts in currency state
• getcurrency — see currency definition with reserve currencies and weights
• getcurrencyconverters — find currencies with reserves

Notes

• Only fractional currencies (baskets) have reserve deposits
• Simple tokens (like yourapp) and native chains return empty {}
• Reserve deposits are held in special on-chain outputs controlled by the currency protocol
• The i-addresses in the result map to the reserve currency IDs (use getcurrency to resolve names)

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Returns the entries for a light wallet Sapling tree state at a specified height or range.

Syntax

getsaplingtree "n"

Parameters

Result

Array of objects:

Examples

Get Sapling tree at specific height

verus -testnet getsaplingtree "926990"

Result:

[
  {
    "network": "iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq",
    "height": 926990,
    "hash": "000000018e6991fb0d5b595b7b7b8e4cb7f04a0b8b6704ecd0f063221d534bb1",
    "time": 1770449419,
    "tree": "0125e011918cd61ca18258b0bb583c7819db8b1baa9526dac97f0150224165d71b000901c9708ac265b695f0fb23c0fbf45d67231c7997e1c4f196b9f57e6ddad704b30a01a3b3a2f9f7e5138d69dbd99622ebb113f456d918e939d373abde9143a8c73f3501affbd0b08eab4485c9ff5700471153e8ca3dd729f2a2e764ee2f9df7a69cdf4f0000019423f71049e07cc2f720456034a962ff85b85c82e6251beb3aa4583daace38020001b891214ff69d3a6004d52ecbcb145a968d375d79834061d3586baaaf76faaf4a01d8b8e6065b6356e94a872598f8c7fed4cbf0dba06c0ee5943836b827a63f0139"
  }
]

Get Sapling tree for a range with step

verus -testnet getsaplingtree "926980,926990,5"

Common Errors

Related Commands

• getblock — Get block data at a height
• getblockchaininfo — Get blockchain state info

Notes

• Essential for light wallet (SPV) synchronization of Sapling shielded transactions.
• The tree field contains the serialized Sapling note commitment tree, which light wallets need to validate and construct shielded transactions.
• Range queries with step are useful for building periodic checkpoints.

Tested On

• VRSCTEST v1.2.14-2, block height 926990

Category: Multichain | Version: v1.2.x+

Returns definitions for all currencies registered on the blockchain, with optional filtering by launch state, system type, or converter status.

Syntax

verus listcurrencies ({"query"}) (startblock) (endblock)

Result Array of currency objects, each containing currencydefinition, bestheight, besttxid, and bestcurrencystate.

Examples

List All Currencies

./verus -testnet listcurrencies
## Returns all currencies on VRSCTEST (can be very long)
## Example entry:
{
  "currencydefinition": {
    "name": "VRSC-USD",
    "currencyid": "i4QdaEnkSxkAK4FRhRJcq7V7WgRN2XhzMD",
    "options": 33,
    "currencies": ["iJhCezBExJHvtyH3fGhNnt2NhU4Ztkf2yq", "iFawzbS99RqGs7J2TNxME1TmmayBGuRkA2"],
    "weights": [0.50000000, 0.50000000],
    "initialsupply": 2000000.00000000,
    ...
  },
  "bestheight": 924671,
  "bestcurrencystate": { ... }
}

List Only Launched Currencies

./verus -testnet listcurrencies '{"launchstate":"launched"}'

List Converters for VRSCTEST

./verus -testnet listcurrencies '{"converter":["VRSCTEST"]}'
## Returns only fractional baskets that hold VRSCTEST as a reserve

List PBaaS Chains Only

./verus -testnet listcurrencies '{"systemtype":"pbaas"}'

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"listcurrencies","params":[]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Enumerate all tokens on the network
• Find active fractional baskets for trading with converter filter
• Monitor pre-launch currencies with launchstate: "prelaunch"
• Discover imported currencies from other chains

Related Commands

• getcurrency — get details for a specific currency
• getcurrencyconverters — find conversion pairs
• getcurrencytrust — check trust ratings

Notes

• Output can be very large on active networks; use filters to narrow results
• The bestcurrencystate in each result is equivalent to calling getcurrencystate for that currency
• systemtype: "local" returns currencies running on this chain; "imported" returns those from other systems

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Refunds any funds sent to a chain if they are eligible for refund after a failed currency launch.

Syntax

refundfailedlaunch "currencyid"

Parameters

Result

Returns transaction information for the refund on success. No specific result format documented.

Examples

Attempt refund on a non-failed currency

verus -testnet refundfailedlaunch "VRSCTEST"

Result:

error code: -8
error message: Cannot refund the specified chain

This error is expected — VRSCTEST launched successfully and is not eligible for refund.

Common Errors

Related Commands

• definecurrency — Define a new currency
• getcurrency — Get currency information
• getcurrencystate — Get current state of a currency

Notes

• Only works for currencies that failed to meet their minimum preconversion threshold before launch.
• Attempts to refund all transactions for all contributors, not just the caller.
• The wallet must have the ability to sign refund transactions for the relevant addresses.
• A currency launch fails when it doesn't reach its minimum required preconversions before the start block.

Tested On

• VRSCTEST v1.2.14-2, block height 926990

Category: Multichain | Version: v1.2.x+

The most versatile command in Verus — sends, converts, bridges, mints, and burns currency in a single operation.

Syntax

verus sendcurrency "fromaddress" '[{"address":"dest","amount":n,...},...]' (minconfs) (feeamount) (returntxtemplate)

Result

"operation-id"   (string) if returntxtemplate is false

Or if returntxtemplate is true:

{
  "outputtotals": { "currencyid": amount },
  "hextx": "hexstring"
}

Examples

Simple Send

./verus -testnet sendcurrency "*" '[{"address":"myid@","amount":1}]'
## Sends 1 VRSCTEST from any wallet address to myid@

Send a Token

./verus -testnet sendcurrency "*" '[{"address":"myid@","amount":5,"currency":"yourapp"}]'
## Sends 5 yourapp tokens to myid@

Convert VRSCTEST → VRSC-USD

./verus -testnet sendcurrency "*" '[{
  "address":"myid@",
  "amount":10,
  "currency":"VRSCTEST",
  "convertto":"VRSC-USD"
}]'
## Converts 10 VRSCTEST to VRSC-USD basket tokens, sent to myid@

Convert Between Reserves (VRSCTEST → USD via basket)

./verus -testnet sendcurrency "*" '[{
  "address":"myid@",
  "amount":100,
  "currency":"VRSCTEST",
  "convertto":"USD",
  "via":"VRSC-USD"
}]'
## Converts VRSCTEST → USD through the VRSC-USD fractional basket

Cross-Chain Export

./verus -testnet sendcurrency "*" '[{
  "address":"myid@",
  "amount":10,
  "currency":"VRSCTEST",
  "exportto":"vETH",
  "feecurrency":"veth"
}]'
## Exports 10 VRSCTEST to Ethereum via the bridge

Mint New Tokens (Centralized Currency)

./verus -testnet sendcurrency "yourapp@" '[{
  "address":"myid@",
  "amount":10,
  "currency":"yourapp",
  "mintnew":true
}]'
## Mints 10 new yourapp tokens (must send from controlling ID)

Burn Tokens

./verus -testnet sendcurrency "*" '[{
  "address":"myid@",
  "amount":5,
  "currency":"yourapp",
  "burn":true
}]'
## Burns 5 yourapp tokens, removing them from supply

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"sendcurrency","params":["*",[{"address":"myid@","amount":1}]]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Simple transfers — send native or token currency to any address/ID
• DEX swaps — convert between reserves and fractional currencies
• Cross-chain bridging — export currency to another chain via exportto
• Token minting — create new supply for centralized (proofprotocol:2) tokens
• Token burning — permanently destroy tokens
• Pre-conversion — participate in currency launches before startblock

Related Commands

• estimateconversion — preview conversion before sending
• getcurrencyconverters — find conversion pairs
• getcurrency — check currency details
• getexports / getimports — track cross-chain transfers

Notes

• Conversions are DeFi: all conversions in the same block get the same price (no front-running)
• The "*" wildcard for fromaddress sources funds from any wallet UTXO
• Cross-chain sends require the destination chain to be running and notarized
• mintnew only works with proofprotocol: 2 (centralized) currencies
• burn only works with tokens, not native chain currencies
• Use returntxtemplate: true for offline signing or fee estimation
• Operation IDs can be tracked with z_getoperationstatus

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

Sets trust ratings for currencies, controlling which currencies the wallet will sync, display, and allow spending.

Syntax

verus setcurrencytrust '{"clearall":bool,"setratings":[...],"removeratings":[...],"currencytrustmode":n}'

Result No return on success; error on failure.

Examples

Set Trust Mode to Allowlist

./verus -testnet setcurrencytrust '{"currencytrustmode":1}'
## Now only currencies explicitly rated as approved will be shown/spendable

Approve a Specific Currency

./verus -testnet setcurrencytrust '{"setratings":[{"i...":{"trustlevel":1}}]}'
## Approves yourapp token (replace i... with your currency's actual currencyid)

Remove a Rating

./verus -testnet setcurrencytrust '{"removeratings":["i..."]}'
## Removes the rating for that currency (replace i... with your currency's actual currencyid)

Reset All Trust Settings

./verus -testnet setcurrencytrust '{"clearall":true,"currencytrustmode":0}'
## Clears all ratings and sets mode to unrestricted

RPC (curl)

curl --user user1445741888:pass... --data-binary \
  '{"jsonrpc":"1.0","id":"curltest","method":"setcurrencytrust","params":[{"currencytrustmode":0}]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:18843/

Common Use Cases

• Filter spam tokens — set mode 2 and block unwanted currencies
• Curated wallet — set mode 1 and only approve known currencies
• Reset to defaults — clearall + mode 0

Related Commands

• getcurrencytrust — view current trust settings
• listcurrencies — see available currencies

Notes

• Trust settings are wallet-local only — they don't affect the blockchain
• Mode 1 (allowlist) is the most restrictive — only explicitly approved currencies work
• Mode 2 (blocklist) is moderate — everything works except explicitly blocked
• These settings affect listcurrencies output and spending ability

Tested On

• VRSCTEST block height: 926963
• Verus version: 1.2.14-2

Category: Multichain | Version: v1.2.x+

⚠️ DOCUMENTED FROM HELP — Finishes an almost complete notarization transaction based on the notary chain and current wallet.

Syntax

submitacceptednotarization "{earnednotarization}" "{notaryevidence}" sourceoffunds

Parameters

Result

Examples

verus -testnet submitacceptednotarization "{earnednotarization}" "{notaryevidence}" "sourceoffunds"

Common Errors

Related Commands

• getnotarizationdata — Get notarization data
• getnotarizationproofs — Get notarization proofs
• submitchallenges — Submit evidence challenges

Notes

• Used by notary nodes to submit cross-chain notarizations.
• The sourceoffunds parameter allows privacy by using a specific funding address when notarizing multiple chains.
• Submission is subject to consensus rules — invalid notarizations will be rejected.
• Typically called by automated bridge/notary software, not end users.

Tested On

• VRSCTEST v1.2.14-2, block height 926990
• ⚠️ Not directly tested — requires active notary node setup

Category: Multichain | Version: v1.2.x+

⚠️ DOCUMENTED FROM HELP — Submits cryptographic challenges to existing, unconfirmed notarizations, proving the existence of an alternate chain.

Syntax

submitchallenges '[challengeobjects, ...]'

Parameters

Array of challenge objects:

Result

Array of results:

Examples

verus -testnet submitchallenges '[{"notarizationref":{"txid":"hexvalue","voutnum":0},"challengeroot":{},"evidence":{}}]'

Common Errors

Related Commands

• getnotarizationproofs — Get proofs for challenges
• getnotarizationdata — Get notarization data
• submitacceptednotarization — Submit a notarization

Notes

• Part of Verus's decentralized cross-chain dispute resolution system.
• Does not require the alternate chain to have more power — only that it moved forward multiple blocks since the prior notarization.
• Requires the local wallet to have funds for transaction fees.
• Challenge types: skipchallenge (i-addr: iCwxpRL6h3YeCRtGjgQSsqoKdZCuM4Dxaf) and validitychallenge (i-addr: iCPb8ywQna7jYV2SHrGZ6vQMj7kuyWFxvb).

Tested On

• VRSCTEST v1.2.14-2, block height 926990
• ⚠️ Not directly tested — requires active cross-chain notarization disputes

Category: Multichain | Version: v1.2.x+

⚠️ DOCUMENTED FROM HELP — Accepts a set of exports from another system to post to the current network.

Syntax

submitimports '{"sourcesystemid":"systemid","notarizationtxid":"txid","notarizationtxoutnum":n,"exports":[...]}'

Parameters

Export object fields

Result

Array of objects:

Examples

verus -testnet submitimports '{"sourcesystemid":"systemid","notarizationtxid":"txid","notarizationtxoutnum":0,"exports":[{"height":100,"txid":"hexid","txoutnum":0,"partialtransactionproof":"hexstr","transfers":[]}]}'

Common Errors

Related Commands

• getlastimportfrom — Get last import from a system
• getnotarizationdata — Get notarization data
• submitacceptednotarization — Submit a notarization

Notes

• Used by bridge nodes to relay cross-chain transfers.
• Each export must include a valid partial transaction proof that can be verified against the referenced notarization.
• Typically called by automated bridge software, not end users.

Tested On

• VRSCTEST v1.2.14-2, block height 926990
• ⚠️ Not directly tested — requires active cross-chain bridge setup