AI Registry Mech

Introduction

This repository contains the Mech Marketplace set of contracts registering mechs and performing their interactions for requests delivery via the means of the Marketplace. Read docs for a detailed Mech Marketplace description.

Development

Prerequisites

• This repository follows the standard Hardhat development process.
• The code is written on Solidity 0.8.28.
• The standard versions of Node.js along with Yarn are required to proceed further (confirmed to work with Yarn 1.22.19 and npx/npm 10.8.2 and node v20.18.1).

Install the dependencies

The project has submodules to get the dependencies. Make sure you run git clone --recursive or init the submodules yourself. The dependency list is managed by the package.json file, and the setup parameters are stored in the hardhat.config.js file. Simply run the following command to install the project:

yarn install

Core components

The contracts, deployment scripts and tests are located in the following folders respectively:

contracts
scripts
test

Compile the code and run

Compile the code:

npx hardhat compile

Run the tests:

npx hardhat test

Linters

• ESLint is used for JS code.
• solhint is used for Solidity linting.

Github Workflows

The PR process is managed by github workflows, where the code undergoes several steps in order to be verified. Those include:

• code installation
• running linters
• running tests

Deployment and redeployment

The deployment of contracts to the test- and main-net is split into step-by-step series of scripts for more control and checkpoint convenience. The description of deployment procedure can be found here: deployment.

The finalized contract ABIs for deployment and their number of optimization passes are located here: ABIs. Each folder there contains contracts compiled with the solidity version before their deployment.

The list of contract addresses for different chains and their full contract configuration can be found here.

Audits

• The audit is provided as development matures. The latest audit report can be found here: audits.

Deployment addresses

The list of contract addresses for different chains and their full contract configuration can be found here.

Previous versions, to be deprecated soon

Network	AI Agent Registry	AgentFactory	AgentFactorySubscription	MechMarketplace
Gnosis	https://gnosisscan.io/address/0xE49CB081e8d96920C38aA7AB90cb0294ab4Bc8EA	https://gnosisscan.io/address/0x6D8CbEbCAD7397c63347D44448147Db05E7d17B0	n/a	https://gnosisscan.io/address/0x4554fE75c1f5576c1d7F765B2A036c199Adae329
Gnosis	https://gnosisscan.io/address/0xaed729d4f4b895d8ca84ba022675bb0c44d2cd52	n/a	https://gnosisscan.io/address/0x910Ca843Cad6C050Faf3f84387879b2928D40370	n/a
Arbitrum	tbd	https://arbiscan.io/address/0x4a46537dd58e524d4df68275946b022ea6623f71	n/a	n/a
Arbitrum	https://arbiscan.io/address/0xa4799b083e0068732456ef45ff9fe5c683658327	n/a	https://arbiscan.io/address/0xd8bcc126ff31d2582018715d5291a508530587b0	n/a
Polygon	tbd	https://polygonscan.com/address/0xd421f433e36465b3e558b1121f584ac09fc33df8	n/a	n/a
Polygon	https://polygonscan.com/address/0x984cf72fde8b5aa910e9e508ac5e007ae5bdcc9c	n/a	https://polygonscan.com/address/0x6e7f594f680f7abad18b7a63de50f0fee47dfd06	n/a
Base	tbd	https://basescan.org/address/0x75d529fae220bc8db714f0202193726b46881b76	n/a	n/a
Base	https://basescan.org/address/0x88de734655184a09b70700ae4f72364d1ad23728	n/a	https://basescan.org/address/0x87c511c8ae3faf0063b3f3cf9c6ab96c4aa5c60c	n/a
Celo	tbd	https://celoscan.io/address/0x87c511c8aE3fAF0063b3F3CF9C6ab96c4AA5C60c	n/a	n/a
Celo	https://celoscan.io/address/0xE49CB081e8d96920C38aA7AB90cb0294ab4Bc8EA	n/a	https://celoscan.io/address/0x88DE734655184a09B70700aE4F72364d1ad23728	n/a
Optimism	tbd	https://optimistic.etherscan.io/address/0x47135D1Cf850d7Df7f7f563F300cc7022F7978a4	n/a	n/a
Optimism	https://optimistic.etherscan.io/address/0x75D529FAe220bC8db714F0202193726b46881B76	n/a	https://optimistic.etherscan.io/address/0x1BD1505B711Fb58C54ca3712e6BEf47A133892d9	n/a

Architecture

flowchart LR
    DAO -- changeMarketplaceParams --> MechMarketplace
    DAO -- setMechFactoryStatuses --> MechMarketplace
    DAO -- setPaymentTypeBalanceTrackers --> MechMarketplace
    DAO -- setMechMarketplaceStatuses --> Karma
    Account -- create --> MechMarketplace
    Account -- request --> MechMarketplace
    Account -- requestBatch --> MechMarketplace
    MechMarketplace -- create --> MechFactory
    MechFactory -- new --> Mech
    MechMarketplace -- requestFromMarketplace --> Mech
    MechMarketplace -- changeRequesterMechKarma --> Karma
    MechMarketplace -- changeMechKarma --> Karma
    MechService -- deliverToMarketplace (priority or delivery mech) --> Mech
    MechService -- deliverMarketplaceWithSignatures --> Mech
    Mech -- deliverMarketplace --> MechMarketplace
    Mech -- deliverMarketplaceWithSignatures --> MechMarketplace
    MechMarketplace -- checkAndRecordDeliveryRates --> BalanceTracker
    MechMarketplace -- finalizeDeliveryRates --> BalanceTracker
    MechMarketplace -- adjustMechRequesterBalances --> BalanceTracker

Loading

The core workflow of the Mech Marketplace, including the roles and interactions of key participants, as well as an overview of the smart contracts, can be found here.

Acknowledgements

The registry mech contracts were inspired and based on the following sources:

• Rari-Capital Solmate.
• Autonolas Registries.
• Gnosis Mech.
• Safe Ecosystem Safe Contracts.
• OpenZeppelin Contracts.