CLI Commands

Queue Management

# Initialize a new queue
ironq init --mint <PUBKEY> --arbiter <PUBKEY> \
  --min-stake 5000000 --timeout 600 \
  --slash-rate 1000 --crank-reward 2000

# Show queue configuration
ironq config

# Show queue status summary
ironq status

# Pause / unpause
ironq pause
ironq unpause

Worker Operations

# Register as a worker (stake tokens)
ironq worker register --stake 10000000

# View worker info
ironq worker info

# Deregister (returns full stake, requires 0 active jobs)
ironq worker deregister

Job Lifecycle

# Create a job (escrow reward)
ironq job create --reward 5000000 \
  --data <64-hex-chars> --priority high --max-retries 1

# Or hash a file automatically
ironq job create --reward 5000000 \
  --data-file ./task-spec.json --priority medium

# List jobs
ironq job list                 # All jobs
ironq job list --status open   # Filter by status

# Job details
ironq job info <JOB_ID>

# Claim, submit, approve
ironq job claim <JOB_ID>
ironq job submit <JOB_ID> --result <64-hex-chars>
ironq job approve <JOB_ID>

# Dispute
ironq job dispute <JOB_ID>

# Cancel (only if unclaimed)
ironq job cancel <JOB_ID>

Dispute Resolution (Arbiter)

ironq dispute resolve <JOB_ID> --worker-wins
ironq dispute resolve <JOB_ID> --worker-loses

Permissionless Cranks

# Expire an overdue job (earn crank reward)
ironq crank expired <JOB_ID>

# Close a terminal job (reclaim rent)
ironq crank close <JOB_ID>

Example Output

$ ironq status
Queue: 9Xpz...kQ7w
  Authority:         DKfv...3nYp
  Reward Mint:       EPjF...wkNS
  Arbiter:           7Yxc...pR4m
  Total Jobs:        42
  Active Workers:    5
  Paused:            No

$ ironq worker info
Worker: Hk4P...qR2n
  Queue:             9Xpz...kQ7w
  Stake:             10,000,000 (10.00 tokens)
  Active Jobs:       1 / 3
  Completed:         15
  Failed:            2
  Total Earned:      75,000,000 (75.00 tokens)

$ ironq job info 7
Job #7
  Status:            Submitted
  Creator:           DKfv...3nYp
  Worker:            Hk4P...qR2n
  Reward:            5,000,000 (5.00 tokens)
  Priority:          High
  Data Hash:         a1b2c3...
  Deadline:          2024-03-15 14:30:00 UTC
  Retries:           0 / 1