feat: update the transfer commands with new input process

[RishabhS7]

🎯 Overview

Refactored title escrow transfer commands to use a streamlined document-based input process, improving user experience and code maintainability.

✨ Key Changes

Unified Document Input Flow

• Replaced individual prompts for token registry, token ID, and network with a single document-based input
• Added extractDocumentInfo() utility to parse document metadata
• Implemented promptAndReadDocument() for consistent document handling across commands

Network Configuration Refactor

• Centralized network configuration using @trustvc/trustvc package's SUPPORTED_CHAINS
• Eliminated hardcoded network definitions in favor of dynamic configuration
• Added RPC URL mapping and provider factory pattern for cleaner network setup

Enhanced CLI Options

• Added promptAddress() utility for consistent address input validation
• Introduced performDryRunWithConfirmation() for better dry-run workflow
• Improved promptRemark() to replace promptRemarkAndEncryptionKey()

Commands Updated

• change-holder.ts - Transfer holder command
• endorse-change-of-owner.ts - Endorse beneficiary change
• endorse-transfer-of-owner.ts - Endorse full transfer
• nominate-change-of-owner.ts - Nominate new beneficiary

✅ Testing

• Updated all title escrow test suites (Astron, Astron Testnet, and standard networks)
• Enhanced test coverage for nominate/endorse beneficiary flows
• Updated transfer holder and transfer owners test cases

Summary by CodeRabbit

• New Features

  • Document-driven input flow for title-escrow commands that auto-extracts token, network and document metadata.
  • Automatic dry-run confirmation with populate/estimate transaction support for networks that can estimate gas.

• Bug Fixes

  • Consistent transaction receipt handling and unified "Transaction receipt not found" error messaging.

• Refactor

  • Public command interfaces updated: removed manual dryRun field and now surface documentId (used for encryption).
  • Consolidated prompting into shared utilities for addresses, remarks, documents, and wallet selection.

• Tests

  • Test suites migrated to the document-driven flow and new dry-run confirmation paths; mocks and expectations updated.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

📝 Walkthrough

Walkthrough

Commands moved to a document-driven input flow (documentId used as encryption key), removed dryRun from public command shapes, centralized dry-run/gas-estimation via performDryRunWithConfirmation, added dynamic network/provider utilities, and updated tests to mock the new utilities and transaction population flow.

Changes

Cohort / File(s)	Summary
Title-Escrow Commands src/commands/title-escrow/change-holder.ts, src/commands/title-escrow/endorse-change-of-owner.ts, src/commands/title-escrow/endorse-transfer-of-owner.ts, src/commands/title-escrow/nominate-change-of-owner.ts	Replace per-field prompts with promptAndReadDocument() + extractDocumentInfo(); use promptAddress/promptRemark; derive encryptionKey from documentId; remove dryRun from public signatures; gate execution with performDryRunWithConfirmation() and use populateTransaction for gas estimation; unify receipt/error handling.
Utilities: CLI & Networks src/utils/cli-options.ts, src/utils/networks.ts	Remove GasOption.dryRun; re-export SUPPORTED_CHAINS/CHAIN_ID; add rpcUrls, createProvider, buildSupportedNetwork, and getSupportedNetworkNameFromId() for dynamic provider/network construction; minor CLI prompt messaging tweak for v5 remark encryption info.
Types src/types.ts	Remove GasOption import/usage; replace with GasPriceScale in affected exported command type intersections.
Tests — Title-Escrow Command Suites tests/commands/title-escrow/* (many files, e.g., endorseNominatedBeneficiary-*.test.ts, nominateBeneficiary-*.test.ts, transfer*.test.ts, transferOwners*.test.ts)	Convert tests from inquirer prompts to mocks of new utilities (promptAndReadDocument, extractDocumentInfo, promptAddress, promptWalletSelection, promptRemark, performDryRunWithConfirmation); update expectations to use documentId as encryptionKey; add populateTransaction mocks and adjust wallet signer/getAddress behavior.
Tests — Networks & Token Registry tests/commands/token-registry/mint.test.ts, tests/utils/networks.test.ts	Expand mocked SUPPORTED_CHAINS and CHAIN_ID with richer network metadata; update provider expectations to JsonRpcProvider where applicable.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant CLI
    participant DocUtil as Document Utilities
    participant DryRun as Dry-Run Handler
    participant TitleEscrow
    participant Signer
    participant Chain

    User->>CLI: Invoke command
    CLI->>DocUtil: promptAndReadDocument()
    DocUtil-->>CLI: document
    CLI->>DocUtil: extractDocumentInfo(document)
    DocUtil-->>CLI: tokenRegistry, tokenId, network, documentId, registryVersion
    CLI->>DocUtil: promptAddress()/promptRemark()
    DocUtil-->>CLI: address, remark
    CLI->>DryRun: performDryRunWithConfirmation(getTransactionCallback)
    DryRun->>TitleEscrow: invoke getTransactionCallback -> populateTransaction (with from)
    TitleEscrow-->>DryRun: populated transaction
    DryRun->>Chain: estimate gas (if supported)
    Chain-->>DryRun: gas estimate
    DryRun->>User: show estimate & confirm
    alt User confirms
        DryRun-->>CLI: proceed
        CLI->>Signer: sign & send transaction
        Signer-->>Chain: submit tx
        Chain-->>CLI: receipt
    else User declines
        DryRun-->>CLI: abort
    end

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~75 minutes

Poem

I nibble bytes and hop with cheer, 🐇
Documents guide the prompts now here,
Dry-runs ask for gas, then choose to go,
Networks spin providers fast or slow,
Tests clap paws — the flow's set clear.

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[tradetrustimda]

🎉 This PR is included in version 1.0.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀