Skip to content

Releases: paytaca/paytaca-cli

v0.3.0

29 Mar 15:58
@joemarct joemarct
v0.3.0
019361c

Choose a tag to compare

View all tags
v0.3.0 Latest
Latest

What's New

AI Agent Integration

  • Add x402 payment support for BCH (HTTP 402 payment protocol)
  • Add AI-friendly features: dry-run, JSON output, and check command
  • Add user approval requirement before BCH payment
  • Update to x402-bch v2.2 specification

Opencode and Claude Code Integration

  • Add paytaca opencode command to install x402 skill
  • Add claude subcommand to install paytaca skill for Claude Code
  • Add opencode GitHub workflow
  • Fix opencode install command for cross-platform compatibility

Testing

  • Add Vitest test framework and x402 parsing tests

Documentation

  • Update README with x402 payments and AI agent integration docs

Improvements

  • Add user confirmation prompt and refactor skill management
  • Fix x402 payment URL handling and add configurable payer option
  • Fix x402 payment flow and server verification
Assets 2
Loading

v0.2.0

09 Mar 16:10
@joemarct joemarct
v0.2.0
366b707

Choose a tag to compare

View all tags
v0.2.0

The first release of Paytaca CLI — a command-line interface for the Paytaca Bitcoin Cash wallet. Built with the same core logic as the Paytaca mobile app, using watchtower-cash-js for transaction operations and libauth for HD key derivation.

Designed to be AI agent-friendly and useful for automation by power users.

Core Wallet

  • wallet create — Generate a new 12-word seed phrase and register with Watchtower
  • wallet import — Import an existing seed phrase
  • wallet info — Show wallet hash, address, and balance
  • wallet export — Display the stored seed phrase
  • Seed phrases stored in OS-native keychain (macOS Keychain, GNOME Keyring, Windows Credential Manager) via @napi-rs/keyring

BCH Operations

  • balance — Display BCH balance in BCH and satoshis
  • balance --sats — Satoshi-only display
  • send <address> <amount> — Send BCH (supports --unit sats)
  • history — Paginated transaction history with filtering (--type incoming|outgoing, --page)
  • receive — Display receiving address with terminal QR code
  • receive --amount <bch> — BIP21 payment URI (bitcoincash:<addr>?amount=<bch>)

Address Derivation

  • address derive [index] — Derive receiving and change addresses at a given index
  • address list [-n count] — List multiple derived addresses
  • HD path: m/44'/145'/0' with receiving at 0/{index} and change at 1/{index}

CashTokens Support

Token Commands

  • token list — List fungible CashTokens with balances
  • token info <category> — Token metadata, balance, and NFT listing
  • token send <address> <amount> --token <category> — Send fungible tokens
  • token send-nft <address> --token <category> --commitment <hex> — Send NFTs (auto-detects UTXO)

Token-Aware Addresses

  • address derive --token / address list --token — Derive z-prefix (token-aware) addresses
  • receive --token — Show z-prefix address for receiving CashTokens
  • receive --token <category> — Generate PayPro payment URI with QR code
  • receive --token <category> --amount <amount> — PayPro URI with token amount (bitcoincash:<z-addr>?c=<cat>&f=<base_units>)

Token Balance & History

  • balance --token <category> — Display balance for a specific CashToken
  • history --token <category> — Filter transaction history by token category

Network

All commands default to mainnet. Pass --chipnet for testnet.

Install

npm install -g paytaca-cli

Commits

  • 4d78920 Initial commit: Paytaca CLI
  • 5fbbb28 Add README with installation, usage, and architecture docs
  • 6621de2 Add Paytaca license and fix repository links in README
  • 4e26af7 Prepare package for npm publishing
  • 7a429d0 Add CashTokens support: token commands, token-aware addresses, and PayPro URIs
  • 16ef0a2 Add --amount to receive and --token to balance
  • 9f06a9e Update README with CashTokens commands and usage examples
  • 366b707 Add npm install command to README
Loading