Skip to main content

Find a command by its ID

dpm trace submit generates a command ID for you, but you can set your own with --command-id. --command-id asks the participant's completions, so it finds commands that were accepted and commands rejected after sequencing. A command rejected before sequencing has no completion to find. Submit these two commands with your own command IDs:

# a command rejected before sequencing, because an Asset with quantity 0 breaks the template precondition
dpm trace submit --submitter "$LEDGER" --act-as "$ISSUER" \
  --command-id zero-asset \
  --template '#asset-tests:Asset:Asset' \
  --arg issuer="$ISSUER" --arg owner="$ALICE" --arg name=GOLD --arg quantity=0

# a command that succeeds
dpm trace submit --submitter "$LEDGER" --act-as "$ISSUER" \
  --command-id create-gold-asset \
  --template '#asset-tests:Asset:Asset' \
  --arg issuer="$ISSUER" --arg owner="$ALICE" --arg name=GOLD --arg quantity=100

Look up the one that failed:

dpm trace --command-id zero-asset --submitter "$LEDGER" --act-as "$ISSUER"

Output:

error: no completion for command 'zero-asset'.
A command rejected during interpretation never reaches the ledger, so it has no completion to look up; capture the rejection with `submit --export <file>` and read it with --completion-file <file>.
If the command was sequenced, it may be outside the queried window: widen it with --begin-exclusive or --completion-limit

zero-asset was rejected before sequencing, so there is no completion to find. Capture it with --export instead, as in Trace a failed submission.

Now look up the one that succeeded:

dpm trace --command-id create-gold-asset --submitter "$LEDGER" --act-as "$ISSUER"

Output:

DPM trace completion
  result:     completion committed
  command id: create-gold-asset
  submission: fedc7511-f7e9-4213-b9de-8f322fa60e77
  update id:  1220c50a6b3684daeebd6d05e4248bf2241f8d0e13b53448ce34d51b2a1eb9aab9fb
  offset:     116
  status:     0
  message:    -
  parties:    Issuer::1220e92d...89b47e
  source:     ledger-json-api

The completion is committed, and it gives the update ID of the command.