This page provides some tips on how to upgrade agent services between different versions of the Open Autonomy framework. For full release notes check the Open-Autonomy repo.
Below we describe the additional manual steps required to upgrade between different versions:
Open Autonomy
v0.7.0
to v0.8.0
- Support for
--rpc
and--sca
flags has been deprecated onautonomy deploy from-token
command. Refer to the CLI documentation to understand how to use customRPC
. - The transaction payload classes needs to be defined using the data classes and needs to be immutable
Transaction
is a data class- IPFS connection and protocol need to be added to your
aea-config.yaml
, if they utilizevalory/abstract_round_abci
skill. - IPFS dialogues and handler need to be specified.
send_to_ipfs
andget_from_ipfs
are now moved toBaseBehaviour
and are generators.- E2E tests now utilize a local deployment of the IPFS, as such you will need to import the
ipfs_daemon
andipfs_domain
fixtures fromaea_test_autonomy.fixture_helpers
.
v0.6.0
to v0.7.0
Breaking changes
- The new
AbstractRound
andBaseBehaviour
meta classes enforce checks on the class attributes. For concrete classes inheriting fromAbstractRound
the developer must setsynchronized_data_class
,allowed_tx_type
andpayload_attribute
. For concrete classes inheriting fromBaseBehaviour
the developer must setmatching_round
. These assumptions were present before but not enforced at the class definition level by the framework. - The set of
all_participants
is now retrieved from the safe instance referenced bysafe_contract_address
and assumed to be present on the target chain. - The usage of
safe_deployment_abci
has been deprecated and support for the package has been dropped. From now on, use the development tools for running a local development image with pre-configured safe to test your applications.
v0.5.0.post2
to v0.6.0
Breaking changes
- Optional: The developer can update to use the auto-generated behaviour and round ids. In this case, the
behaviour_id
andround_id
need no longer be set on the class. When accessing the auto generated ids on the class useauto_behaviour_id()
andauto_round_id()
class methods. On the instancebehaviour_id
andround_id
properties resolve the auto id class methods, so no change is required. - Required: The pre- (
db_pre_conditions
) and post- (db_post_conditions
) conditions on the synchronized data need to be defined for each initial and final state in anAbciApp
. Seetransaction_settlement_abci
for an example.
v0.5.0.post1
to v0.5.0.post2
No backwards incompatible changes
v0.5.0
to v0.5.0.post1
No backwards incompatible changes
v0.4.0
to v0.5.0
One backwards incompatible change
Service component
- This release introduces a new format for defining multiple overrides for an agent on a service configuration. Please follow this guide to update your service configurations accordingly.
v0.3.5
to v0.4.0
Multiple backwards incompatible changes
Autonomy CLI module
-
autonomy analyse abci
command group has been deprecated -
autonomy analyse abci check-app-specs
andautonomy analyse generate-app-specs
has been merged intoautonomy analyse fsm-specs
- The usage of
--infile
flag has been deprecated and replaced with the usage of the--package
flag - Input format for
--app-class
has been changed frompackages.author.skills.skill_name.rounds.SomeAbciApp
toSomeAbciApp
-
Users will have to manually switch to the newer version, i.e., remove the path prefix in all their FSM specifications. For example an FSM specification with a
label: packages.author.skills.my_abci.rounds.MyAbciApp
now becomeslabel: MyAbciApp
-
autonomy analyse abci check-handlers
has been moved toautonomy analyse handlers
--packages-dr
flag has been deprecated, use--registry-path
at top level instead-
Input format for common handlers and skip skills options has been updated
- Old format -
--common abci,http,contract_api,ledger_api,signing --skip abstract_abci,counter,counter_client,hello_world_abci
- New format
-h abci -h http -h contract_api -h ledger_api -h signing -i abstract_abci -i counter -i counter_client -i hello_world_abci
- Old format -
-
autonomy analyse abci docstrings
has been moved toautonomy analyse docstrings
--check
flag has been deprecated and the command will perform the check by default-
--update
flag has been introduced to update the docstring if necessary -
autonomy analyse abci logs
has been moved toautonomy analyse logs
Autonomy test plugin
tag
property has been renamed toimage
onaea_test_autonomy.docker.base.DockerImage
class
Core packages
_HarHatHelperIntegration
has been renamed toHardHatHelperIntegration
inpackages/valory/skills/abstract_round_abci/test_tools/integration.py
ResetPauseABCIApp
has been renamed toResetPauseAbciApp
inpackages/valory/skills/reset_pause_abci/rounds.py
ApiSpecs
now usedataclasses
in order to encapsulate data, which means thatresponse_key
, andresponse_type
can be accessed via theresponse_info
instance attribute. Moreover, this attribute now includes the newresponse_index
anderror_key
,error_index
,error_type
,error_data
. Theretries_info
instance attribute gives access to theretries_attempted
andretries
which are now public and also includes the newbackoff_factor
.
Test tools
- The
packages.valory.skills.abstract_round_abci.test_tools.apis
module which contained theDummyMessage
has been removed.MagicMock
can be used instead. For example,DummyMessage(my_test_body)
can be converted toMagicMock(body=my_test_body)
.
v0.3.4
to v0.3.5
No backwards incompatible changes
Upgrade guide
This release introduces a new format for packages.json
file, the older version is still supported but will be deprecated on v1.0.0
so make sure to update your projects to use the new format.
v0.3.3
to v0.3.4
No backwards incompatible changes
v0.3.2
to v0.3.3
No backwards incompatible changes
v0.3.1
to v0.3.2
No backwards incompatible changes
v0.3.0
to v0.3.1
No backwards incompatible changes
v0.2.2
to v0.3.0
No backwards incompatible changes except:
- Deprecated the usage of
hashes.csv
and replaces it withpackages.json
, which is maintained byautonomy packages lock
--check
flag is deprecated fromautonomy hash all
, from now package consistencies can be verified byautonomy packages lock --check
- Various test fixtures have moved and been renamed.
v0.2.1.post1
to v0.2.2
No backwards incompatible changes except:
All imports from autonomy.test_tools.*
are now found at aea_test_autonomy.*
, after installing open-aea-test-autonomy
.
v0.2.1
to v0.2.1.post1
No backwards incompatible changes
v0.2.0
to v0.2.1
build-images
command has been renamed tobuild-image
- Build support for dependency has been removed from the
build-image
command autonomy deploy build deployment
has been renamed toautonomy deploy build
Refer to quick start docs for more information on the updated deployment flow.
v0.1.6
to v0.2.0
Multiple backwards incompatible changes:
- The service config no longer accepts the
network
key on the first YAML page. The network can now be defined via the package overrides. - Dependency specifications are now checked against imports for all packages, this means initially packages might need modifying to reference/unreference missing/irrelevant dependencies.
- The global configuration file for the
aea
/autonomy
CLI has a breaking change. Please remove~/.aea/cli_config.yaml
and rerunautonomy init --remote
.
v0.1.5
to v0.1.6
No backwards incompatible changes
v0.1.4
to v0.1.5
No backwards incompatible changes
v0.1.3
to v0.1.4
This release changes the build process for docker images and service deployments. Refer to documentation for more information.
v0.1.2
to v0.1.3
This release introduces the usage of CID v1 hashes.
v0.1.1
to v0.1.2
No backwards incompatible changes
v0.1.0
to v0.1.1
No backwards incompatible changes