Table of Contents

1. Overview

2. Important Note for Users of the Public Beta

3. Accessing Mettalex Public Beta

   • Visit the Platform

   • Acquire Test Tokens

     • Fetch Testnet Tokens - Connect with ASI Wallet

     • Polygon Testnet Tokens - Connect with MetaMask Wallet

   • Platform Overview

     • OrderBook

     • Trade

     • Orders

     • Refresh 🔄

     • Agent TopUp

     • Faucets

     • Balances

     • Network

     • Profile

4. Cross-Chain Trading

   • Placing a Trade from Dorado Testnet (Fetch) to Amoy Testnet (Polygon)

     • Video Walkthrough

   • Placing a Trade from Amoy Testnet (Polygon) to Dorado Testnet (Fetch)

     • Creating a New Agent

     • Linking Your Existing Agent

     • Video Walkthrough

5. Troubleshooting

6. Feedback and Support

7. Share your experience

8. ASI and MetaMask wallets Setup

   • Installing ASI Wallet

     • Setting Up Your Wallet

     • Switching to the Dorado Testnet network

   • Installing MetaMask Wallet

     • Setting Up Your Wallet

     • Switching to Polygon Amoy Testnet network

1. Overview

The cross-chain trading feature on Mettalex Public Beta allows users to trade assets between two distinct blockchain ecosystems: the Dorado testnet (Fetch) and Amoy testnet (Polygon). This feature uses AI agents and smart contracts to autonomously execute trades on your behalf across different blockchain ecosystems.

This guide provides a step-by-step walkthrough of how to connect your wallet, acquire test tokens, and place cross-chain trades.

For single-chain trades, please refer to our Mettalex User Guide: Public Beta for a detailed walkthrough.

Requirements:

1. ASI wallet installed

   • TESTFET testnet tokens

2. MetaMask wallet installed

   • Amoy testnet tokens

For ASI and MetaMask wallet installations, refer to section 8.

2. Important Note for Users of the Public Beta

This is a beta version and is still in development. The Mettalex Public Beta uses only testnet tokens and connects to the Dorado testnet on the Fetch Chain and the Amoy testnet on the Polygon Chain. We appreciate your participation and encourage you to share your feedback and report bugs here.

3. Accessing Mettalex Public Beta

Visit the Platform

Visit beta.mettalex.ai to access the Mettalex Public Beta platform, or you can also reach it by visiting the homepage mettalex.ai and clicking on Mettalex Beta.

Wallet Connection

To use Mettalex, you need to connect either an ASI or MetaMask wallet to the platform, depending on which chain you want to trade your tokens.

For example, if you want to trade tokens from the Fetch Chain, connect your ASI wallet to the Mettalex platform.

You can only be connected with one of the wallets at a time—either the ASI wallet or your MetaMask wallet.

Acquire Test Tokens

Fetch Testnet Tokens

Connect with ASI Wallet

Use the Faucets feature on the platform to receive testnet tokens:

• Claim TESTFET tokens for gas transactions.

• After receiving TESTFET, claim USDT (CW20) and FET (CW20) tokens for trading. These tokens are testnet tokens and are only usable on the Fetch Chain testnet, not on the mainnet.

• The FET and USDT testnet tokens will be used for trading on the Mettalex platform.

Please note: You can claim faucet tokens only once every 24 hours.

Polygon Testnet Tokens Connect with MetaMask Wallet

To connect with the MetaMask wallet, log out of Mettalex if previously connected to the ASI wallet.

Use the Faucets feature and click AMOY POL to join the official Polygon Discord server and request faucet tokens under the “pol-faucet” channel to receive AMOY POL.

Once POL is received, you can claim USDC (ERC20) and USDT (ERC20) testnet tokens on the platform. These tokens can then be traded on Mettalex.

Platform Overview

User Interface

OrderBook

This section displays the list of all buy and sell orders for each trading pair. It displays the market depth, highlighting the range of prices at which traders are willing to buy (bids) and sell (asks).

Trade

The Trade section is where you execute trades.

Here, you will see the assets for trading and their current balances based on which wallet is connected to the Mettalex platform. In addition, the Agent Balance indicates the funds available for gas transactions needed for agents to perform the trades.

For single-chain trading, proceed to fill out the From and To fields and click the Trade button.

For cross-chain trading, you must add the wallet address of the destination chain in the field “Wallet to Receive Funds” to receive your funds. If the ASI wallet is connected to Mettalex, enter the Polygon wallet address into the Wallet to Receive Funds field, and vice versa.

Orders

This section shows open and completed orders.

In the Open Orders tab, users can find orders that are open, as well as orders that are partially completed.

Top Bar Menu

Refresh 🔄

The Refresh button can be used to update the Mettalex platform with the latest information, ensuring the platform reflects real-time changes.

Agent TopUp

The Agent TopUp button adds 0.5 TESTFET (on the Dorado testnet) or 0.5 POL (Polygon testnet), depending on which wallet is connected to Mettalex, to your agent’s wallet to cover gas fees for the agent’s interactions (including interacting with escrow contracts, matching agents’ trades, etc.).

Ensure your agent is topped up before placing trades to avoid transaction failures.

Faucets

The Faucets button allows users to acquire testnet tokens to trade on the Mettalex platform.

Balance

The Balance button displays the amount of testnet gas tokens in the user's wallet. These tokens are used for the user's interactions (creating trades, sending funds to the agent’s wallet, etc.).

When connected with the ASI wallet, TESTFET is your balance for the Fetch Chain.

When connected with the MetaMask wallet, POL is displayed for the Polygon Chain.

Network

The Network button informs the user of the current network the Mettalex platform is connected to: the Dorado-1 testnet for the Fetch Chain or the Polygon Amoy testnet for the Polygon Chain.

Profile

The Profile tab displays the connected wallet address, Agent Address, Agent Wallet Address, and a Log Out button.

4. Cross-Chain Trading

Placing a Trade from Dorado Testnet (Fetch) to Amoy Testnet (Polygon)

Step 1: Connect the ASI Wallet

Step 2: Get Testnet Tokens

Step 3: Place the trade

• Navigate to the Trade Section and select From token as FET (Dorado) To token as USDC (Polygon Amoy).

  

  • Enter the amount of FET you want to trade for the USDC you wish to receive. The asset's price is automatically calculated (e.g., 1 FET —> 1 USDC, Price = 1)

    

  • Enter the Polygon wallet address where you want to receive USDC on the Amoy network.

  • Click Trade.

Step 4: Create or Link an Agent

A popup will appear asking whether you want to Create new agent or Link an existing agent.

If this is your first time using the Mettalex platform, select Create new agent.

The system will automatically initiate a series of transactions. Please approve all the five transactions displayed in the popup, which include:

• Creating your trading agent.

• Transferring 0.5 TESTFET to the agent for transaction fees.

• Creating an escrow contract and mapping it to your account.

Once all transactions are signed on-chain, you will receive a message stating, "Order created successfully." This confirms that your trade has been successfully placed and is live on the platform.

Step 5: Completing the Order

Once all the transactions are signed and completed, and the order is placed, it will appear in the Open Orders section. When a matching trade occurs in the order book, your agent will autonomously interact with the other agents to complete the trade.

Placing a Trade from Dorado Testnet (Fetch) to Amoy Testnet (Polygon)Video Walkthrough

Placing a Trade from Amoy Testnet (Polygon) to Dorado Testnet (Fetch)

Now that you have placed the first part of the cross-chain trade (FET to USDC), let's place another trade on the Polygon Chain from USDC (Polygon Amoy) to FET (Dorado).

Step 1: Connect the MetaMask Wallet

Step 2: Get Testnet Tokens

Step 3: Place the trade

• From the Trade section, select From token as USDC (Polygon Amoy) and To token as FET (Dorado) for your trade.

• Click Trade, and a pop-up will ask you whether to Create new agent or Link an existing agent.

  

  Creating a New Agent

  When you click "Create new agent," Mettalex will create a new agent by initiating a series of transactions. Approve all five transactions displayed in the pop-up, which include :

  • Creating your trading agent.

  • Transferring 0.5 POL to the agent for transaction fees.

  • Creating an escrow contract and mapping it to your account.

  Once all the transactions are signed on-chain, you will see a message stating, "Order created successfully." This confirms that your trade has been successfully placed and is live on the platform.

  Please note, if you've already connected your ASI wallet to the Mettalex Public Beta platform and created an agent already but you have chosen to create a new wallet on the Polygon Amoy testnet, you will be treated as a new system user. This way, you can place both a matching and an opposing trade for your trades on the Dorado testnet (Fetch Chain).

  
  

  Linking Your Existing Agent

  If you click to link an existing agent, you will be asked to connect your wallet where the agent is initally created. If you're connected to the Polygon Amoy Chain and linking an existing agent, you should connect to the ASI Wallet, and vice versa.

  By linking an existing agent, you will be considered a single user executing trades on both Polygon and Fetch Chain. However, you cannot place compatible trades across different chains.

  You can also link your agent to multiple networks. Clicking "Link Existing Agent" will register the agent to the connected chain, transferring 0.5 POL or 0.5 TESTFET, depending on the connected wallet, to the agent wallet.

  
  

  

  • To understand the mechanism of cross-chain trading, refer to Mettalex Cross-Chain Architecture.

Video Walkthrough

5. Troubleshooting

• Refresh the page or log out and log back in to resolve issues like unconfirmed transactions or pending trades.

• For invalid address errors, double-check the wallet address you entered. Ensure it corresponds to the correct network and agent.

• If the transaction is declined on the Polygon Amoy Chain, wait for a few minutes and try again. This may be due to an RPC error on the Polygon Chain. Try updating the RPC link for a smoother transaction flow. You can find the updated link on Chainlist.

• If your MetaMask wallet does not connect, ensure you're on the Polygon Amoy network and try again.

• Having trouble getting your Polygon Amoy faucet?

  Join our Mettalex Telegram and we will support you.

6. Feedback and Support

• Feedback Form: If you encounter any issues or have suggestions for improvement, please use the feedback form. Your feedback is valued and much appreciated.

• Support: For any additional support or queries, feel free to reach out through the following channels:

  • Discord: Connect with us in our dedicated Mettalex Discord channel under "Public-Beta."

  • Telegram: Join our official Telegram group at https://t.me/mettalex_official.

  • Email: Contact us at info@mettalex.com with the subject line "Mettalex Public Beta."

7. Share your experience:

Show us your love and support. Share your thoughts on X, Telegram and Discord to let others know! Click the Share on the X button at the bottom right of the platform. Your feedback inspires us and helps spread the word!

Thank you for participating in the Mettalex Public Beta.

8. ASI & MetaMask wallets Setup

Installing ASI Wallet

Mettalex supports ASI wallet and Keplr wallet for this Mettalex Public Beta. For the purpose of this user guide, we will use ASI wallet as the primary wallet throughout the instructions.

To get started, download and install the ASI wallet Extension from https://fetch.ai/get-asi-wallet. Click the "Download Chrome Extension" button and follow the installation instructions. After installation, check that the ASI wallet icon appears in your browser's extension toolbar, and pin it there for easy access. (Download the extension as per your device, This userguide is based on Google Chrome)

Setting Up Your Wallet:

After installing the ASI wallet extension, set up your wallet by following the on-screen instructions. You can either create a new wallet or restore an existing one using your seed phrase. Ensure you securely store your seed phrase, as it’s essential for accessing your wallet in the future.

Switch to Dorado Testnet:

After setting up your wallet, configure it to connect to the Dorado network, as this Public Beta operates on this testnet. To do this, select Fetchhub, enable the Show Testnet option, and click on Manage Network. From the list, select Dorado to establish the connection.

You’re all set!

Installing MetaMask Wallet

You can skip this step if you already have the Polygon Amoy network on your MetaMask.

To start using Mettalex's Public Beta cross chain trading feature, you must install MetaMask and configure it to work with Polygon Amoy.

Follow these steps:

• Visit the MetaMask Extension page and click Add to Chrome.

  
  

  

Setting Up Your Wallet:

After installing the MetaMask wallet extension, set up your wallet by following the on-screen instructions. You can either create a new wallet or Import an existing one using your seed phrase.

Once installed, pin the extension to your browser.

Switching to Polygon Amoy Testnet network

Make sure you are connected to the Polygon Amoy network. Suppose it's not automatically added while connecting the wallet to the Mettalex platform. In that case, you can manually add it by visiting Chainlist and adding the Polygon Amoy network by clicking "Add to MetaMask."