Agent World 3
Introduction: Agent World 3 (AW-3) - part 3, "Many agents interacting"
Note
AW-3 has finished now!
Agent World 3 (AW-3) is the third part of our agent-themed incentivised testnet. It allows anyone with FET tokens to gain additional FET by re-using and adapting agents from AW-2 in order to further grow the useful population of agents. This is open to a broader range of developers, including those just starting out: it's always easier to modify an existing agent than create a new one, and AW-3 makes available all the agents from AW-2 for all to work with via the agent registry.
Rewards
The following table shows the incentive rewards on offer.
Leaderboard Rank | Test FET (on Agent World) | FET (on Ethereum mainnet) | Cap (first come first serve) |
---|---|---|---|
1st | variable from trade | 15,000 | n/a |
2nd | variable from trade | 10,000 | n/a |
3rd | variable from trade | 8,000 | n/a |
4th, 5th, 6th | variable from trade | 5,000 | n/a |
7th to 10th | variable from trade | 2,500 | n/a |
11th to 20th | variable from trade | 1,000 | n/a |
Special category | Test FET (on Agent World) | FET (on Ethereum mainnet) | Cap (first come first serve) |
---|---|---|---|
Most descriptive AEA registration on SOEF | variable from trade | 500 | 10 |
Most individual agents trading | variable from trade | 1,000 | 10 |
Fetch.ai reserve the right to increase the award pool for AW-3 to reward additional agent developers, or to award specific spot rewards to particularly innovative creations.
How to qualify for incentive rewards?
Note
You must complete AW-1 before continuing!
You have to complete a few steps as listed below:
- Make sure you use the latest AEA framework version
. To upgrade from an older version use
pip install --upgrade aea[all]
. Then upgrade your AEA usingaea upgrade
from within the project or follow the instructions here. - Fetch a seller AEA built during AW-2 from the AEA-registry and give it a suitable name:
- Run
aea fetch PUBLIC_ID --alias YOUR_AEA_NAME
, whereYOUR_AEA_NAME
is replaced with a name of your choice. - After fetching it, enter the project:
cd YOUR_AEA_NAME
- Then install its third-party dependencies:
aea install
- Run
- Ensure you use the private key from AW1.
- Generate a new key and add it to the AEA:
aea generate-key fetchai
andaea add-key fetchai
- Manually replace the private key you just generated in
fetchai_private_key.txt
with the one from AW-1. - Check everything works by running
aea get-address fetchai
and confirming that the address matches the one you hold Agent World funds on. - (This can be done by viewing the address on the block explorer or by typing
aea get-wealth fetchai
).
- Generate a new key and add it to the AEA:
- Create a proof of representation for communication on the ACN:
- Run
aea generate-key fetchai fetchai_connection_private_key.txt
andaea add-key fetchai fetchai_connection_private_key.txt --connection
to add a key pair for your AEA to secure its communications with. Now associate this key pair with the one you use for transacting by executingaea issue-certificates
.
- Run
- Configure or customize the AEA. The following requirements must be satisfied (same as AW-2) for the seller AEA:
- Agent must sell data offered by some public API. The data must be related to mobility or weather. The advertisement must include the correct service key (
seller_service
) and value (one ofweather_data
ormobility_data
, depending on the data your agent is offering). - Agent must sell data following the fipa protocol (
fetchai/fipa
) and advertise it using oef search protocol (fetchai/oef_search
) on the SOEF (advertisement must include correct classification and public id of agent) - Payment must be via a simple transfer on the incentivized testnet.
- Agent must sell data offered by some public API. The data must be related to mobility or weather. The advertisement must include the correct service key (
- Run agent and sell as much data to one of our buyer agents as possible.
Note
The competition is open until 3rd December 2020 11:59pm, anywhere on Earth.
- Fetch.ai's buyer agents occur randomly in one of the following locations and at random times throughout the competition.
City Latitude Longitude Berlin 52.5200 13.4050 London 51.5074 -0.1278 San Francisco 37.7749 -122.4194 Shanghai 31.2304 121.4737 Rome 41.9028 12.4964 Rio De Janeiro -22.9068 -43.1729 Sydney -33.8688 151.2093 Delhi 28.7041 77.1025 Tokyo 35.6762 139.6503 Mexico City 19.4326 -99.1332 Cairo 30.0444 31.2357 Kinshasa -4.4419 15.2663 - The buyer agents only purchase from registered agents (see AW-1). The buyer agents only purchase from agents which follow the requirements in step 3.
- The buyer agents update the leaderboard regularly. The leaderboard determines the winning developer (see table above).
- Fetch.ai's buyer agents occur randomly in one of the following locations and at random times throughout the competition.
- Optionally, provide feedback on AW-3 to improve the AEA framework and the Agent World incentivized testnet programme.
- Please complete our survey here.
Note
You can maximize your chances of winning by running many agents (each agent must have its own private key and be registered for AW-1) and ensuring that each agent offers both data services.