@tristeroresearch/mach-sdk v0.1.1

Mach SDK

NOTE

Some API endpoints are stale. They will soon be updated. For now, you can use the following code to manually set gas fee and priority fee:

const sdk = await config;
sdk.setGasRecommendationOverride(true);
// Set gas fee higher than the current base fee (588802000)
sdk.setGasFee(BigInt('700000000')); // 700 million wei (0.7 Gwei)
sdk.setPriorityFee(BigInt('10000000')); // 10 million wei (0.01 Gwei)
sdk.setGasLimit(BigInt('500000')); // Reduced gas limit to save on total cost

Prerequisites

• Node.js 20+

Installation

npm install @tristeroresearch/mach-sdk@latest

Documentation

• Documentation for the SDK can be found here.

Roadmap

• EVM ERC20 swaps for common tokens
• EVM WETH swaps
• Websocket listening for order events
• Full support for generic ERC20 swaps
• Solana swaps
• Tron swaps

Project Structure

@types

Defines common types used by the SDK, such as:

• Balance
• Chain
• Network
• Order Response
• Order
• Token

api

API helper functions for interacting with the Mach API, e.g.:

• Fetching the dynamic configuration object in src/api/config.api.ts
• Getting recommended gas fees in src/api/getMachGasRecommendation.api.ts
• Getting a wallet's transaction history in src/api/transactionHistory.api.ts

chains

Contains Solana configurations that will be used in a future release.

configs

Defines the chains and tokens that are supported by the SDK.

constants

Holds constant values used by the SDK and for convenience in applications, such as:

• The Mach platform's contract addresses across different chains in src/constants/contractAddresses.ts
• Asset addresses across different chains in src/constants/assetAddresses.ts
• Network configurations like chain IDs, LayerZero IDs, abbreviations, etc. in src/constants/networkConfigs.ts

contract

Includes ABI (Application Binary Interface) definitions for smart contracts, allowing interaction with the Mach platform's contracts, as well as the erc20 and wrappedEth contracts.

helpers

Contains utility functions for blockchain operations, such as:

• Creating wallet clients for interacting with the blockchain (via createWalletClients.helper.ts)
• Building order data for submitting orders to the blockchain (via encodeOrderData.helper.ts)
• Interacting with the Mach market maker to complete swaps after submission to the blockchain (via makeOrder.helper.ts)
• Transaction signing (via signTransaction.helper.ts)
• Generating block explorer URLs (via getBlockExplorerUrl.helper.ts)

utils

Contains utility functions for the SDK, such as:

• Getting gas values for transactions (via getGasForTransaction.util.ts)