Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

mach-cctt

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

mach-cctt

Test automated trades on the Mach exchange.

  • 0.0.125
  • PyPI
  • Socket score

Maintainers
1

Cross Chain Trade Test (CCTT)

Test automated trades between multiple chains on Mach.

PyPI

Test PyPI

Overview

Test automated trades on Mach. Specify a start chain and symbol, and a policy determining how the destination token will be chosen (randomize chain and symbol, randomize chain and fix symbol). In each trade, the test wallet's entire balance of the source token will be sold for the destination token, and then the destination token because the new source token for the next trade. This continues until the script is killed by the user.

Usage

  1. Install

    python -m pip install mach-cctt
    
  2. Usage

    cctt --help
    
  3. Example

    # The script will create log files and an account data file. Make a working directory for it.
    mkdir cctt/ && cd cctt/
    
    # Set password to avoid being prompted
    # export CCTT_PASSWORD="abc"
    
    # Backend defaults to production, change if necessary
    # export MACH_BACKEND_URL="https://cache-half-full-staging.fly.dev"
    
    cctt import # Import account
    cctt decrypt # Show public/private key
    cctt balances # Show account balances
    
    # Trade USDC on random chains, starting from optimism-USDC
    cctt run --source optimism-USDC --destination-policy fixed:USDC
    
    # Trade USDC on only arbitrum and optimism, starting from polygon-USDC
    cctt run --source polygon-USDC --destination-policy cheap:USDC
    
    # Trade between random tokens on random chains, starting from arbitrum-USDT
    cctt run --source arbitrum-USDT --destination-policy random
    
    # If the --source is empty, then an appropriate source with a non-zero balance is chosen for you.
    cctt run --source --destination-policy random
    

    Notes:

    • You need to have a gas on every chain, or a gas of exactly 0 on chains that you do not wish the testing script to trade on, which will cause those chains to be disabled.
    • The --source token should be one that you hold a non-zero balance of in your wallet. If you set it to empty, it will be automatically chosen as any token with a non-zero balance in the wallet.
    • There is a known issue with trades filling for a single tick less than the order was placed at. As a preventative measure, any token balance of 1 tick in the wallet is treated as an empty balance.

Log Files

There are 4 log files created by the application:

  • app.log - everything
  • delayed_transactions.log - the source funds where not withdrawn in time
  • stuck_transactions.log - the source funds were withdrawn but the destination funds were not received in time
  • improper_fill.log - the trade filled on the source chain for 1 tick less than the order was placed for. This has been observed to happen primarily to USDM (on multiple chains)

Account File

A plaintext JSON file storing your account encrypted with your password will be created once you first generate or import a wallet. By default this file is called account.json but you can give a path to your own file via the --file PATH flag. This file is required to be present for any operation other than importing or generating a new wallet.

Development

Requirements

You need the just command runner and either Python 3.12.5+ with virtualenv, or pyenv.

Setup

  1. Clone the repository

    git clone https://github.com/tristeroresearch/cross-chain-trade-test.git
    cd cross-chain-trade-test
    
  2. Create and activate a virtual environment

    Using venv:

    python -m venv .venv
    source .venv/bin/activate
    

    Or using pyenv:

    pyenv virtualenv 3.12.5 cctt
    pyenv activate
    
  3. Install dependencies

    just init
    
  4. View available recipes

    just -l
    

    Note that there are recipes that allow you to run the application in-source without needed to build and package to PyPI first:

    just account_file=account.json import <private key> # Import a new account
    just decrypt # Show public and private key
    just balances # List balances of account
    just source=arbitrum-USDC policy=random run # Run the trade tester, starting from arbitrum-USDC and trading to random tokens
    just wallet=<public key> withdraw # Withdraw funds from the stored account to the given wallet
    
  5. Building

    just build
    
Packaging

Make sure to bump the version number in pyproject.toml.

To upload to the test PyPI:

just upload-test

To upload to the main PyPI:

just upload

Keywords

FAQs


Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc