feat: token registry command

[RishabhS7]

Token Registry Deploy Command

Summary

Implemented the token-registry deploy command with comprehensive test coverage to enable deployment of token registry contracts across supported blockchain networks.

Changes

New Files

• src/commands/token-registry/deploy.ts - Token registry deployment command implementation
• tests/commands/token-registry/deploy.test.ts - Comprehensive test suite (17 tests)

Modified Files

• Updated document-store test files to fix vitest hoisting issues
• Refactored test mocks to inline constants and avoid circular dependencies

Features

• ✅ Deploy token registry contracts to multiple networks (Ethereum, Polygon, XDC, Stability, Astron)
• ✅ Support for encrypted wallet, private key file, and direct private key authentication
• ✅ Interactive prompts for network, wallet, and contract configuration
• ✅ Dry-run functionality with gas estimation
• ✅ Transaction confirmation and explorer link display
• ✅ Comprehensive error handling

Test Coverage

• Input prompts (encrypted wallet, key file, direct key)
• Contract deployment success scenarios
• Error handling (deployment failures, gas estimation errors)
• Handler integration
• Edge cases and validation

Technical Details

• Follows existing CLI patterns and architecture
• Uses @trustvc/trustvc SDK for contract deployment
• Implements proper TypeScript typing
• Includes transaction receipt validation
• Supports all configured blockchain networks

Testing

npm test -- token-registry/deploy.test

Summary by CodeRabbit

• New Features

  • Added a document-store (token registry) deploy command with interactive prompts, dry-run estimation, standalone and factory modes, and automatic address resolution.

• Improvements

  • Improved contract connection compatibility across versions and unified connection helpers.
  • Made address prompts optionally skippable for more flexible input flows.

• Tests

  • Added comprehensive tests covering deploy flows, prompts, dry-runs, and error paths.

• Documentation

  • Updated README to document the new deploy command.

• Chores

  • Updated @trustvc/trustvc dependency to ^2.9.1.

[coderabbitai]

ℹ️ Recent review info

Configuration used: defaults

Review profile: CHILL

Plan: Free

📥 Commits

Reviewing files that changed from the base of the PR and between 66e55aa and 3c6aa79.

📒 Files selected for processing (1)

• README.md

---

📝 Walkthrough

Walkthrough

Bumps @trustvc/trustvc; adds ethers-based contract connection helpers including TDocDeployer; introduces token-registry deploy CLI command with interactive prompts and standalone/factory deploy flows; makes promptAddress optional; adds tests and README updates.

Changes

Cohort / File(s)	Summary
Dependency Updates package.json	Bumps @trustvc/trustvc from ^2.8.0 to ^2.9.1.
Contract Connection Helpers src/commands/helpers.ts	Adds connectToTDocDeployerContract and connectToTradeTrustTokenFactory; switches several contract connections to generic ethers.Contract wrappers for cross-version compatibility; adds ConnectToTDocDeployerContractArgs.
Title Escrow Commands src/commands/title-escrow/accept-return-to-issuer.ts, src/commands/title-escrow/reject-return-to-issuer.ts	Replaces direct TradeTrustToken__factory.connect usage with connectToTokenRegistry helper and updates imports.
Token Registry Deployment src/commands/token-registry/deploy.ts	Adds new CLI command (command, describe, handler) with promptForInputs and deployTokenRegistryContract implementing interactive prompts, address resolution, standalone vs factory deployment flows, dry-run estimation, transaction handling, and logging.
CLI Utilities src/utils/cli-options.ts	Updates promptAddress signature to accept an optional flag and return `Promise<string
Tests tests/commands/token-registry/deploy.test.ts	Adds extensive tests for prompt behavior, standalone and factory deployment flows, dry-run and confirmation paths, error cases, and handler end-to-end flows.
Documentation README.md	Adds token-registry deploy entry and updates project tree/command docs to include the new deploy command.

Sequence Diagram(s)

sequenceDiagram
    participant User as User/CLI
    participant Handler as Handler
    participant Prompt as promptForInputs
    participant Wallet as Wallet Utils
    participant Factory as TradeTrustTokenFactory
    participant Deployer as TDocDeployer
    participant Blockchain as Blockchain

    User->>Handler: start token-registry deploy
    Handler->>Prompt: gather network, names, mode, addresses, wallet
    Prompt-->>Handler: DeployTokenRegistryCommand
    Handler->>Wallet: load/unlock wallet
    Wallet-->>Handler: wallet instance

    alt Standalone
        Handler->>Factory: build deploy transaction (populate)
        Factory-->>Handler: populatedTx
    else Factory
        Handler->>Deployer: initialize with encoded params (populate)
        Deployer-->>Handler: populatedTx
    end

    Handler->>Blockchain: perform dry-run estimate
    Blockchain-->>Handler: gas estimate & price
    Handler->>User: show cost, request confirm
    User->>Handler: confirm/cancel

    alt Confirm
        Handler->>Blockchain: send transaction
        Blockchain-->>Handler: receipt
        Handler->>User: success with contract address & link
    else Cancel
        Handler-->>User: exit without deploying
    end

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Poem

🐰 I nudge the deployer with a hop and a grin,
Prompts light the path where contracts begin,
Helpers hum softly, wallets unlock,
Tests keep the journey steady as rock,
A carrot for CI—another deploy win!

---

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 📦🚀