The AEA car-park skills demonstrate an interaction between two AEAs.

  • The carpark_detection AEA provides information on the number of car parking spaces available in a given vicinity.
  • The carpark_client AEA is interested in purchasing information on available car parking spaces in the same vicinity.

Discussion

The full Fetch.ai car park AEA demo is documented in its own repo here. This demo allows you to test the AEA functionality of the car park AEA demo without the detection logic.

It demonstrates how the AEAs trade car park information.

Communication

This diagram shows the communication between the various entities as data is successfully sold by the car park AEA to the client.

sequenceDiagram participant Search participant Car_Data_Buyer_AEA participant Car_Park_AEA participant Blockchain activate Car_Data_Buyer_AEA activate Search activate Car_Park_AEA activate Blockchain Car_Park_AEA->>Search: register_service Car_Data_Buyer_AEA->>Search: search Search-->>Car_Data_Buyer_AEA: list_of_agents Car_Data_Buyer_AEA->>Car_Park_AEA: call_for_proposal Car_Park_AEA->>Car_Data_Buyer_AEA: propose Car_Data_Buyer_AEA->>Car_Park_AEA: accept Car_Park_AEA->>Car_Data_Buyer_AEA: match_accept Car_Data_Buyer_AEA->>Blockchain: transfer_funds Car_Data_Buyer_AEA->>Car_Park_AEA: send_transaction_hash Car_Park_AEA->>Blockchain: check_transaction_status Car_Park_AEA->>Car_Data_Buyer_AEA: send_data deactivate Client_AEA deactivate Search deactivate Car_Park_AEA deactivate Blockchain

Preparation instructions

Dependencies

Follow the Preliminaries and Installation sections from the AEA quick start.

Launch the OEF search and communication node

In a separate terminal, launch a local OEF search and communication node.

python scripts/oef/launch.py -c ./scripts/oef/launch_config.json

Keep it running for all the following.

Demo instructions

Create car detector AEA

First, fetch the car detector AEA:

aea fetch fetchai/car_detector:0.6.0
cd car_detector
aea install
Alternatively, create from scratch.

The following steps create the car detector from scratch: 

aea create car_detector
cd car_detector
aea add connection fetchai/oef:0.5.0
aea add connection fetchai/ledger:0.1.0
aea add skill fetchai/carpark_detection:0.5.0
aea install
aea config set agent.default_connection fetchai/oef:0.5.0
In `car_detector/aea-config.yaml` replace `ledger_apis: {}` with the following based on the network you want to connect. To connect to Fetchai: 
ledger_apis:
  fetchai:
    network: testnet
and add 
default_routing:
  fetchai/ledger_api:0.1.0: fetchai/ledger:0.1.0

Create car data buyer AEA

Then, fetch the car data client AEA:

aea fetch fetchai/car_data_buyer:0.6.0
cd car_data_buyer
aea install
Alternatively, create from scratch.

The following steps create the car data client from scratch: 

aea create car_data_buyer
cd car_data_buyer
aea add connection fetchai/oef:0.5.0
aea add connection fetchai/ledger:0.1.0
aea add skill fetchai/carpark_client:0.5.0
aea install
aea config set agent.default_connection fetchai/oef:0.5.0
In `car_data_buyer/aea-config.yaml` replace `ledger_apis: {}` with the following based on the network you want to connect. To connect to Fetchai: 
ledger_apis:
  fetchai:
    network: testnet
and add 
default_routing:
  fetchai/ledger_api:0.1.0: fetchai/ledger:0.1.0

Generate wealth for the car data buyer AEA

The car data buyer needs to have some wealth to purchase the car park information.

First, create the private key for the car data buyer AEA based on the network you want to transact. To generate and add a private-public key pair for Fetch.ai use:

aea generate-key fetchai
aea add-key fetchai fet_private_key.txt

Then, create some wealth for your car data buyer based on the network you want to transact with. On the Fetch.ai testnet network:

aea generate-wealth fetchai
Alternatively, create wealth for other test networks.

Ledger Config:
In `car_data_buyer/aea-config.yaml` and `car_detector/aea-config.yaml` replace `ledger_apis: {}` with the following based on the network you want to connect. To connect to Ethereum: 

ledger_apis:
  ethereum:
    address: https://ropsten.infura.io/v3/f00f7b3ba0e848ddbdc8941c527447fe
    chain_id: 3
    gas_price: 50
Alternatively, to connect to Cosmos: 
ledger_apis:
  cosmos:
    address: https://rest-agent-land.prod.fetch-ai.com:443
Wealth:
To generate and add a private-public key pair for Ethereum use: 
aea generate-key ethereum
aea add-key ethereum eth_private_key.txt
On the Ethereum `ropsten` network. 
aea generate-wealth ethereum
Alternatively, to generate and add a private-public key pair for Cosmos use: 
aea generate-key cosmos
aea add-key cosmos cosmos_private_key.txt
On the Cosmos `testnet` network. 
aea generate-wealth cosmos

Update the skill configs

The default skill configs assume that the transaction is settled against the fetchai ledger.

Alternatively, configure skills for other test networks.

Car detector:
Ensure you are in the car detector project directory. For ethereum, update the skill config of the car detector via the `aea config get/set` command like so: 

aea config set vendor.fetchai.skills.carpark_detection.models.strategy.args.currency_id ETH
aea config set vendor.fetchai.skills.carpark_detection.models.strategy.args.ledger_id ethereum
Or for cosmos, like so: 
aea config set vendor.fetchai.skills.carpark_detection.models.strategy.args.currency_id ATOM
aea config set vendor.fetchai.skills.carpark_detection.models.strategy.args.ledger_id cosmos
This updates the carpark detection skill config (`car_detector/vendor/fetchai/skills/carpark_detection/skill.yaml`). Car data buyer:
Ensure you are in the car data buyer project directory. For ethereum, update the skill config of the car detector via the `aea config get/set` command like so: 
aea config set vendor.fetchai.skills.carpark_client.models.strategy.args.max_buyer_tx_fee 6000 --type int
aea config set vendor.fetchai.skills.carpark_client.models.strategy.args.currency_id ETH
aea config set vendor.fetchai.skills.carpark_client.models.strategy.args.ledger_id ethereum
Or for cosmos, like so: 
aea config set vendor.fetchai.skills.carpark_client.models.strategy.args.max_buyer_tx_fee 6000 --type int
aea config set vendor.fetchai.skills.carpark_client.models.strategy.args.currency_id ATOM
aea config set vendor.fetchai.skills.carpark_client.models.strategy.args.ledger_id cosmos
This updates the car data buyer skill config (`car_data_buyer/vendor/fetchai/skills/carpark_client/skill.yaml`).

Run both AEAs

Finally, run both AEAs from their respective directories:

aea run

You can see that the AEAs find each other, negotiate and eventually trade.

Cleaning up

When you're finished, delete your AEAs:

cd ..
aea delete car_detector
aea delete car_data_buyer


Previous:
Aries Cloud Agents Demo Next:
Gym Example