CLI Reference

xcon-db-time serve|createdb|useradd

Every command accepts -h. Common flags (shared by all commands):

Flag	Default	Meaning
`-root`	`./xcon-db-time-data`	Data root directory (holds `dbs/` and `users.json`)
`-group-commit`	`50ms`	WAL fsync window; `0` = fsync every write
`-merge-every`	`30s`	Merge time trigger
`-merge-bytes`	`8388608`	Merge size trigger (delta bytes)
`-merge-throttle`	`0`	Merge write budget in bytes/s; `0` = unlimited

serve

Runs the node.

Flag	Default	Meaning
`-pg`	`:5432`	pg-wire listen address
`-http`	(off)	HTTP API listen address
`-ilp`	(off)	ILP TCP listen address
`-ilp-db`	—	Database the ILP listener is bound to (required with `-ilp`)
`-tls-cert`, `-tls-key`	—	Enable TLS on pg-wire

xcon-db-time serve -root /var/lib/xcon-db-time -pg :5432 -http :9000 -ilp :9009 -ilp-db firm1

createdb

xcon-db-time createdb -root /var/lib/xcon-db-time <name>

Creates an empty database directory. Names: [a-z0-9][a-z0-9_-]{0,63}.

useradd

xcon-db-time useradd -root /var/lib/xcon-db-time <user> <password> <db>

Creates or overwrites a user bound to exactly one database. The password is stored as a SCRAM-SHA-256 verifier — never in cleartext. Re-run to reset a password.