dm-cli

CLI client for apostol-dm - command line interface for access to BitDeals deal module.

Description

dm-cli provides command line for work with deal module (apostol-dm) of BitDeals payment processing service. The application supports all deal module main functions via convenient command line interface.

Building

cd dm-cli/dm-cli
make

mv dm-cli /usr/local/bin/

Usage

Main syntax

Usage: dm-cli [global] <group> [<args>]

Global options:
  --bitdeals           BitDeals server address
  --debug              print debug information, input and output API requests
  --address <ip:port>  address of the bitdeals dm, default: 127.0.0.1:4999
  --help               print condensed help for all subcommands
  --version            print version string

    dm-cli account status <bitcoin_address>
        Show account data details
    dm-cli account update [options]
        Update your account data

    dm-cli deal create
        Create a new deal
    dm-cli deal status
        Show deal data details
    dm-cli deal complete
        Complete deal
    dm-cli deal cancel
        Cancel deal
    dm-cli deal negative
        Leave negative feedback

Debug mode

In debug mode curl POST and GET requests to apostol-dm API are displayed.

dm-cli --debug account status 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

Localization

The application define a language via the LANG variable:

# Русский язык
export LANG=ru_RU.UTF-8
dm-cli --help

# English languge (default)
export LANG=en_US.UTF-8
dm-cli --help

Usage examples

Create deal

dm-cli deal create \
    --at "https://testnet-dm.bitdeals.org" \
    --seller miuwWQrUc6EFWiUBTi2rMyiEaJSeacn2zo \
    --customer mraXx7JrmAmuKypdJ1vseQBXySsdRZE5AC \
    --type prepayment \
    --sum 0.0052 \
    --pay 2025-09-20 \
    --leave-before 2025-10-03

Check deal status

dm-cli deal status 6e90c7d6ef823e41257cbcc16cd2e318fd578970

Check deal payment

dm-cli deal status --is-paid 6e90c7d6ef823e41257cbcc16cd2e318fd578970
echo $?  # 0 if paid, 1 if no

2.2 KiB Raw Permalink Blame History