Core components - Part 2
The AEA framework consists of several core components, some required to run an AEA and others optional.
In Core Components - Part 1 we described the common components each AEA uses. In this page, we will look at more advanced components.
Required components used by AEAs¶
DecisionMaker can be thought of as a
Wallet manager plus "economic brain" of the AEA. It is responsible for the AEA's crypto-economic security and goal management, and it contains the preference and ownership representation of the AEA. The decision maker is the only component with access to the
Wallet's private keys.
You can learn more about the decision maker here. In its simplest form, the decision maker acts like a
Handler to react to messages it receives from the skills.
Wallet contains the private-public key pairs used by the AEA. Skills do not have access to the wallet, only the decision maker does.
The agent has two sets of private keys, as configured in the
private_key_paths: This is a dictionary mapping identifiers to the file paths of private keys used in the AEA. For each identifier, e.g.
fetchai, the AEA can have one private key. The private keys listed here are available in the
Decision Makerand the associated public keys and addresses are available in all skills. The AEA uses these keys to sign transactions and messages. These keys usually hold the AEAs funds.
connection_private_key_paths: This is a dictionary mapping identifiers to the file paths of private keys used in connections. For each identifier, e.g.
Multiplexercan have one private key. The private keys listed here are available in the connections. The connections use these keys to secure message transport, for instance.
It is the responsibility of the AEA's user to safe-guard the keys used and ensure that keys are only used in a single AEA. Using the same key across different AEAs will lead to various failure modes.
Private keys can be encrypted at rest. The CLI commands used for interacting with the wallet allow specifying a password for encryption/decryption.
Identity is an abstraction that represents the identity of an AEA in the Open Economic Framework, backed by public-key cryptography. It contains the AEA's addresses as well as its name.
The identity can be accessed in a
Skill via the
Optional components used by AEAs¶
Contracts wrap smart contracts for third-party decentralized ledgers. In particular, they provide wrappers around the API or ABI of a smart contract. They expose an API to abstract implementation specifics of the ABI from the
Contracts usually contain the logic to create contract transactions and make contract calls.
Contracts can be added as packages. For more details on
Contracts also read the
Contract guide here.
Putting it together¶
Taken together, the core components from this section and the first part provide the following simplified illustration of an AEA:
We recommend you continue with the next step in the 'Getting Started' series:
Understanding the decision maker is vital to developing a goal oriented and crypto-economically safe AEA. You can learn more about the
DecisionMaker in the following section:
Contracts is important when developing AEAs that make commitments or use smart contracts for other purposes. You can learn more about the
Contracts agents use in the following section: