Car park skills
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.
Preparation instructions
Dependencies
Follow the Preliminaries and Installation sections from the AEA quick start.
Demo instructions
Create car detector AEA
First, fetch the car detector AEA:
aea fetch fetchai/car_detector:0.23.0
cd car_detector
aea install
aea build
Alternatively, create from scratch.
The following steps create the car detector from scratch:
aea create car_detector
cd car_detector
aea add connection fetchai/p2p_libp2p:0.17.0
aea add connection fetchai/soef:0.18.0
aea add connection fetchai/ledger:0.14.0
aea add skill fetchai/carpark_detection:0.20.0
aea config set --type dict agent.dependencies \
'{
"aea-ledger-fetchai": {"version": "<0.2.0,>=0.1.0"}
}'
aea config set agent.default_connection fetchai/p2p_libp2p:0.17.0
aea config set --type dict agent.default_routing \
'{
"fetchai/ledger_api:0.11.0": "fetchai/ledger:0.14.0",
"fetchai/oef_search:0.14.0": "fetchai/soef:0.18.0"
}'
aea install
aea build
Create car data buyer AEA
Then, fetch the car data client AEA:
aea fetch fetchai/car_data_buyer:0.24.0
cd car_data_buyer
aea install
aea build
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/p2p_libp2p:0.17.0
aea add connection fetchai/soef:0.18.0
aea add connection fetchai/ledger:0.14.0
aea add skill fetchai/carpark_client:0.21.0
aea config set --type dict agent.dependencies \
'{
"aea-ledger-fetchai": {"version": "<0.2.0,>=0.1.0"}
}'
aea config set agent.default_connection fetchai/p2p_libp2p:0.17.0
aea config set --type dict agent.default_routing \
'{
"fetchai/ledger_api:0.11.0": "fetchai/ledger:0.14.0",
"fetchai/oef_search:0.14.0": "fetchai/soef:0.18.0"
}'
aea install
aea build
Add keys for the car data seller AEA
First, create the private key for the car data seller AEA based on the network you want to transact. To generate and add a private-public key pair for Fetch.ai AgentLand
use:
aea generate-key fetchai
aea add-key fetchai fetchai_private_key.txt
Next, create a private key used to secure the AEA's communications:
aea generate-key fetchai fetchai_connection_private_key.txt
aea add-key fetchai fetchai_connection_private_key.txt --connection
Finally, certify the key for use by the connections that request that:
aea issue-certificates
Add keys and generate wealth for the car data buyer AEA
The buyer needs to have some wealth to purchase the service from the seller.
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 AgentLand
use:
aea generate-key fetchai
aea add-key fetchai fetchai_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 AgentLand
network:
aea generate-wealth fetchai
Next, create a private key used to secure the AEA's communications:
aea generate-key fetchai fetchai_connection_private_key.txt
aea add-key fetchai fetchai_connection_private_key.txt --connection
Finally, certify the key for use by the connections that request that:
aea issue-certificates
Run the AEAs
Run both AEAs from their respective terminals.
First, run the car data seller AEA:
aea run
Once you see a message of the form To join its network use multiaddr 'SOME_ADDRESS'
take note of the address. (Alternatively, use aea get-multiaddress fetchai -c -i fetchai/p2p_libp2p:0.17.0 -u public_uri
to retrieve the address.)
This is the entry peer address for the local agent communication network created by the car data seller.
Then, in the car data buyer, run this command (replace SOME_ADDRESS
with the correct value as described above):
aea config set --type dict vendor.fetchai.connections.p2p_libp2p.config \
'{
"delegate_uri": "127.0.0.1:11001",
"entry_peers": ["SOME_ADDRESS"],
"local_uri": "127.0.0.1:9001",
"log_file": "libp2p_node.log",
"public_uri": "127.0.0.1:9001"
}'
Then run the buyer AEA:
aea run
You will see that the AEAs negotiate and then transact using the Fetch.ai testnet.
Cleaning up
When you're finished, delete your AEAs:
cd ..
aea delete car_detector
aea delete car_data_buyer