Shop configuration

Set up your own shop by deploying a trade controller and giving it a name and description. With an FTL relay in the same system, you'll appear on the galactic directory automatically.

Deploy the controller

Print an ami_trade_controller and deploy it to any location you want the shop to run from.

Galactic visibility

If the system has an active FTL relay, the controller broadcasts a directory entry over the network and any replicant can find you from the shop directory. No relay, no listing - your shop will still work for anyone who happens to be in-system, but nobody else will know it exists.

You might want to deliberately keep your shop a secret, sharing the location privately for friends or setting up specific trade deals with other players.

Setting the storefront

Configure the controller like any other AMI device. The trade directive takes a name, a description and a free-form announcement that will be announced on BobNet regularly.

POST /v1/devices/{code} 200 OK
$ curl -X POST https://api.replicant.space/v1/devices/TC4488AA \
    -H "Authorization: Bearer $API_KEY" \
    -d '{
      "command": "set_directive",
      "directive": "trade",
      "configuration": {
        "name": "Bob'\''s Bits and Bobs",
        "description": "A longer description for your shop!",
        "announcement": "Head to SOL-3-1 for mining equipment!"
      }
    }'

Update any of these fields by re-sending set_directive with a new configuration block. Stock and individual trades are managed separately - see managing trades.