v1.0.2

sun-cli v1.0.2

What's Changed

Agent Wallet Integration Update

• Migrated wallet environment variables from TRON_PRIVATE_KEY / TRON_MNEMONIC / TRON_MNEMONIC_ACCOUNT_INDEX to AGENT_WALLET_PRIVATE_KEY / AGENT_WALLET_MNEMONIC / AGENT_WALLET_MNEMONIC_ACCOUNT_INDEX for consistency with @bankofai/agent-wallet
• Simplified initWallet() to delegate fully to resolveWalletProvider() instead of manually mapping env vars
• Improved wallet init error handling — gracefully returns null on failure instead of throwing

Bug Fixes

• Fixed BigInt serialization in JSON output — bigint values are now stringified correctly instead of throwing TypeError
• Fixed version string — CLI version is now read dynamically from package.json instead of being hardcoded
• Removed unused printKeyValue import in liquidity commands

CI / Tooling

• Added audit-pr.yml GitHub Actions workflow for automated PR auditing
• Unified ESLint and lint configuration

Documentation

• Rewrote README with updated wallet configuration and usage instructions

Tests

• Added new tokens.test.ts test suite
• Updated existing test suites for compatibility with wallet changes

v1.0.0

sun-cli v1.0.0

Initial Release

This is the first public release of sun-cli, a terminal-first CLI for SUN.IO / SUNSWAP workflows on TRON.

sun-cli is designed for both human operators and AI agents, with support for interactive execution, machine-readable output, and wallet-aware transaction flows.

Included in v1.0.0

Core CLI Commands

This release includes command groups for:

• wallet access and balances
• token pricing and token discovery
• pool discovery and analytics
• swap quoting and swap execution
• liquidity management across V2, V3, and V4
• protocol metrics and history
• farm queries
• position and pair inspection
• transaction scanning
• generic contract read and send

Wallet Support

sun-cli uses a unified agent-wallet based flow and supports:

• TRON_PRIVATE_KEY
• TRON_MNEMONIC
• TRON_MNEMONIC_ACCOUNT_INDEX
• AGENT_WALLET_PASSWORD
• AGENT_WALLET_DIR

Root-level wallet flags are also supported for per-invocation overrides:

• -k, --private-key <key>
• -m, --mnemonic <phrase>
• -i, --mnemonic-account-index <index>
• -p, --agent-wallet-password <password>
• -d, --agent-wallet-dir <dir>

Output Modes

This release supports:

• table output for interactive terminal use
• compact JSON output for agents and scripts
• TSV output for shell pipelines
• field filtering with --fields
• --dry-run for write-flow previews
• --yes for non-interactive execution

Broadcast Result Enhancements

Successful write operations return transaction results with:

• txid
• route information when available
• tronscanUrl derived from the selected network

Supported explorer formats:

• mainnet → https://tronscan.org/#/transaction/<txid>
• nile → https://nile.tronscan.org/#/transaction/<txid>
• shasta → https://shasta.tronscan.org/#/transaction/<txid>

Tooling and Project Setup

This initial release also includes:

• Jest-based test coverage
• ESLint and Prettier configuration
• separate TypeScript configs for build and lint
• deterministic CI installs through dependency overrides
• rewritten product-style README with real command output examples

Notes

Wallet Behavior

Only one wallet source should be configured at a time.

Invocation-time wallet configuration follows this priority:

• root flags
• environment variables

Command Surface

The wallet command group in this initial release focuses on active wallet usage:

• wallet address
• wallet balances

Wallet management commands such as wallet listing and wallet switching are not part of sun-cli v1.0.0.

v1.0.0-beta

sun-cli v1.0.0

Initial Release

This is the first public release of sun-cli, a terminal-first CLI for SUN.IO / SUNSWAP workflows on TRON.

sun-cli is designed for both human operators and AI agents, with support for interactive execution, machine-readable output, and wallet-aware transaction flows.

Included in v1.0.0

Core CLI Commands

This release includes command groups for:

• wallet access and balances
• token pricing and token discovery
• pool discovery and analytics
• swap quoting and swap execution
• liquidity management across V2, V3, and V4
• protocol metrics and history
• farm queries
• position and pair inspection
• transaction scanning
• generic contract read and send

Wallet Support

sun-cli uses a unified agent-wallet based flow and supports:

• TRON_PRIVATE_KEY
• TRON_MNEMONIC
• TRON_MNEMONIC_ACCOUNT_INDEX
• AGENT_WALLET_PASSWORD
• AGENT_WALLET_DIR

Root-level wallet flags are also supported for per-invocation overrides:

• -k, --private-key <key>
• -m, --mnemonic <phrase>
• -i, --mnemonic-account-index <index>
• -p, --agent-wallet-password <password>
• -d, --agent-wallet-dir <dir>

Output Modes

This release supports:

• table output for interactive terminal use
• compact JSON output for agents and scripts
• TSV output for shell pipelines
• field filtering with --fields
• --dry-run for write-flow previews
• --yes for non-interactive execution

Broadcast Result Enhancements

Successful write operations return transaction results with:

• txid
• route information when available
• tronscanUrl derived from the selected network

Supported explorer formats:

• mainnet → https://tronscan.org/#/transaction/<txid>
• nile → https://nile.tronscan.org/#/transaction/<txid>
• shasta → https://shasta.tronscan.org/#/transaction/<txid>

Tooling and Project Setup

This initial release also includes:

• Jest-based test coverage
• ESLint and Prettier configuration
• separate TypeScript configs for build and lint
• deterministic CI installs through dependency overrides
• rewritten product-style README with real command output examples

Notes

Wallet Behavior

Only one wallet source should be configured at a time.

Invocation-time wallet configuration follows this priority:

• root flags
• environment variables

Command Surface

The wallet command group in this initial release focuses on active wallet usage:

• wallet address
• wallet balances

Wallet management commands such as wallet listing and wallet switching are not part of sun-cli v1.0.0.