piratewallet-light-cli/QORTAL_SCHEMA_CHANGES.md

Qortal ARRR Lightwallet CLI Integration Notes

This fork tracks Pirate's current lightwalletd gRPC protocol (pirate.wallet.sdk.rpc) and drops the older cash.z.wallet.sdk.rpc namespace used by lightd.pirate.black.

Known Mainnet Lightwalletd Servers (new proto)

• https://lightd1.pirate.black:443
• https://piratelightd1.cryptoforge.cc:443
• https://piratelightd2.cryptoforge.cc:443

JSON Schema Changes (Core/JNI parsers)

syncstatus

Legacy key changes:

• Removed: syncing (replaced by in_progress)
• synced_blocks and total_blocks are still emitted, but only while syncing

New fields when syncing: sync_id, in_progress, last_error, start_block, end_block, synced_blocks, trial_decryptions_blocks, txn_scan_blocks, total_blocks, batch_num, batch_total

New fields when not syncing: sync_id, in_progress, last_error, scanned_height

list

• Always includes incoming_metadata and outgoing_metadata.
• Adds incoming_metadata_change and outgoing_metadata_change.
• Includes unconfirmed only for unconfirmed transactions (omitted for confirmed).
• Mempool entries are no longer appended to the list output; unconfirmed txs are tracked in wallet state instead.
• amount and fee now account for both shielded and transparent totals.

balance

Keys are unchanged, but with t-address support disabled by default:

• t_addresses is empty and tbalance is zero unless t-addresses are explicitly added.

P2SH HTLC Commands

• sendp2sh is restored and expects script to be Base58-encoded output script bytes (typically OP_RETURN + OP_PUSHDATA1 + redeem script). The script output is added once per recipient, matching prior Qortal behavior.
• redeemp2sh is restored and expects Base58-encoded raw bytes for script, txid, secret (empty for refund), and privkey (32-byte raw). It spends output index 0 without validating funding output value or script hash.
• send does not accept script; use sendp2sh for HTLC funding.