Testnet Tutorial

Testnet Tutorial

Welcome to the Surge Pre-Production Testnet! Surge is a non custodial market making platform built for the Cardano blockchain. Unlike traditional centralized market making solutions on other chains, Surge reflects Cardano’s values of decentralization and community coordination. It brings professional grade automated trading to anyone, anywhere, regardless of skill level, creating a level playing field in the DeFi landscape. This democratization of trading power is expected to drive growth in Cardano’s on chain liquidity and volume, which are both essential for adoption and represent one of Cardano’s greatest opportunities for improvement. The Surge testnet gives anyone the chance to experiment with Surge’s infrastructure in a safe environment, helping you learn how to create bots, fund wallets, and manage strategies before moving to mainnet. The Surge public testnet showcases core functionalities:

Wallet Management

  • Create and manage multiple Cardano wallets from a single Dapp wallet, with all keys stored locally and securely on your machine. Surge mainnet will support thousands of wallets per user.

  • Fund your account easily by sending ADA and MIN to a single wallet in your Surge account

  • Assets are automatically distributed across wallets and optimized for your active strategy

Strategies

  • Build strategies by defining four targets: • Total daily buy volume (ADA to MIN) • Total daily sell volume (MIN to ADA) • Minimum trade size in ADA • Maximum trade size in ADA

Note Some functions are unavailable on testnet, including concurrently running strategies and certain data visualizations. These will be fully supported at mainnet launch.

Testing Surge is currently running on the MIN/ADA pair on Minswap Pre-Production Testnet.

Setting up Testnet Wallet

  1. Set up a new or load up an existing Pre-Production Testnet wallet. We recommend Eternl.

  1. Request some PreProd Testnet ADA from the Cardano Testnet Faucet to your PreProd wallet.

  1. Once you have recieved 10,000 tADA to your PreProd wallet, visit the Minswap Pre Production Testnet website and connect your PreProd Cardano dapp wallet. Find the ADA/MIN pair and purchase 5,000 ADA worth of MIN.

⚠️ Note: Minswap PreProd has two MIN tokens (tMIN and MIN). Buy MIN, which has higher liquidity and a token image. The link above points to the correct MIN. Testnet MIN token ID: e16c2dc8ae937e8d3790c7fd7168d7b994621ba14ca11415f39fed72

You now hold PreProd ADA and MIN, which you can use on Surge. At mainnet launch, all Cardano assets with Minswap pools will be supported.

Connecting to Surge Testnet dApp

  1. Connect your PreProd wallet in the Surge dApp here: https://testnet.surgecardano.com/dashboard

  1. Click Grant Access so the dApp can read your wallet balances and allow you to interact with the dApp.

Your dashboard will load up with information pertaining to your Surge strategy execution:

All figures will initially be at 0. Let's change that.

Creating Wallets

At the top of the page, select the trading pair you would like to use. For this tutorial, choose ADA/MIN. Once a pair is selected, your dashboard, wallets, and trading strategies will all be tied to that pair.

In the future, users will be able to run strategies across multiple pairs, with each pair having its own dedicated strategies and wallets managed through the pair selector.

Next, navigate to the Wallets page.

The Wallets page shows all wallets linked to your account and selected pair. Since you are just starting, there will be none created.

Click Generate to begin creating wallets.

⚠️ Note: Ensure the ADA/MIN pair is selected in the top right of the app. Wallets are generated for the pair you select, with each pair having its own strategies and wallets managed through the pair selector. Wallets created under “All Pairs” cannot be used for ADA/MIN.

A popup will appear where you can generate up to 500 wallets. For testing purposes with 5,000 tADA, we recommend starting with 10 wallets. After selecting the number of wallets you want, press Generate x Wallets.

Surge will then create the number wallets you specified, and they will appear in your Wallets list.

💡 Tip: You can always generate more wallets later if you need additional capacity for new strategies.

Funding Your Account

To begin, click on one of the wallets in your wallets list.

You will be brought to the summary page for the wallet you selected. Now select Fund.

A receive address will appear. Copy this address.

From your Cardano Preprod wallet, manually send all 5,000 tADA and all of the MIN you purchased to the address you copied.

⚠️ Note: Because of the low price of MIN on the PreProd testnet, your purchase will equal approximately 500,000,000,000 MIN. Please send the full amount.

Note: You do not need to worry about funding specific wallets. The system will automatically distribute funds to different wallets when necessary.

Your Surge account is now funded.

Creating Strategies

Now that your have generated 10 wallets and funded your account PreProd ADA and MIN, you can start building strategies. Begin by selecting Strategies from the left navigation panel.

The Strategies page will be blank at first. To create a new strategy, click Create Strategy in the top right corner.

A popup will appear where you will configure your strategy.

Begin by setting your desired daily net buy and sell volumes of MIN, both denominated in ADA.

  • Daily Buy Volume: Amount of ADA used to purchase MIN each day (ADA → MIN).

  • Daily Sell Volume: Amount of MIN sold for ADA each day (MIN → ADA).

Your total daily volume is the sum of buys and sells. If buys exceed sells (or vice versa), your account will experience a net buy or net sell of MIN, which will shift the balance between tADA and MIN. This behavior can be used strategically depending on your goals.

For testnet, we recommend setting buys and sells evenly to maintain balanced holdings of both tADA and MIN. We recommend keeping buys and sells at 25,000 ADA each or less daily considering the 5,000 tADA that will be used by most participants.

Please note that tADA is limited to 10,000 tADA per day from the faucet. Be mindful of net-buy strategies, as the Surge team cannot provide additional tADA for testnet users.

The next variables to set are the minimum and maximum trade size in ADA. Surge will randomly select a value within this range for each trade. For testnet, keep trade sizes at the default of 20 ADA Minimum and 200 ADA Maximum.

  • Minimum Trade Size: Smallest trade size in ADA. Recommended 20 ADA.

  • Maximum Trade Size: Largest trade size in ADA. Recommended between 200 ADA.

Your average trade size is the midpoint between the two limits and determines the number of trades per day. Setting limits too low increases daily trades, leading to higher chain fees. Setting them too high increases slippage and risks failed transactions, since each account only holds 5,000 tADA in total. Keeping trade sizes proportionate to your balance helps ensure organic activity and smooth execution.

Keep trade sizes at the default of 20 ADA Minimum and 200 ADA Maximum.

Your strategy is now configured. Scheduling, duration, risk parameters, and other advanced features will be available at mainnet launch. Select Create Bot to save your strategy and prepare it for execution.

Your bot strategy has been created and is now listed on the Strategies page. It will begin running immediately with your PrerProd ADA, MIN, and the 10 wallets you generated. A countdown will display the time until the next trade. You can pause or delete bots at any time, and deleting a bot will not affect your funds. Editing stratgegies will be available at mainnet launch.

⚠️ Note: For the testnet phase, we recommend running only one strategy at a time to reduce complexity. The ability to run multiple strategies with different goals and trading pairs will be available on mainnet.

⚠️ Note: While your strategy is running, you may occasionally encounter failed transactions or 500 errors. In these cases, the bot will automatically reset and continue executing, so no action is required on your part.

⚠️ Note: All strategies and transactions are built and executed locally on your machine. For strategies to run, your computer must stay on, connected to the internet, and the Surge tab must remain open. If your computer shuts down, loses connection, or the tab is closed, the strategy will pause, but your funds and keys will remain fully secure.

Understanding Outputs

While configuring a strategy, and while a strategy is running, Surge will display several outputs:

  • Total Daily Volume: The combined amount of daily buys and sells.

  • Net Buys/Sells: The difference between total buys and total sells. Keeping this at zero results in no net market impact. Setting sells higher than buys produces a net sell, increasing ADA funds. Setting buys higher than sells produces a net buy, accumulating more of the token. This value is independent of total daily volume.

  • Net ADA Change: The result of Net Buys/Sells minus daily fees. Fees include Cardano chain fees, liquidity pool fees, and the Surge fee. Users may choose to offset fees by setting daily sells slightly higher than buys, keeping Net ADA Change at zero.

  • Average Trade Size: Surge randomly selects trade sizes between the user-defined minimum and maximum. A higher maximum is possible with deeper liquidity, while a smaller minimum increases the number of trades per day. More trades increase chain fees but reduce slippage.

  • Estimated Number of Daily Trades: Total daily volume divided by average trade size. Higher volume and lower average size result in more trades.

  • Estimated Time Between Trades: 1,440 minutes in a day divided by the estimated number of daily trades. This indicates the average spacing between trades.

  • Estimated Trades per Wallet: Estimated daily trades divided by the number of wallets. Fewer trades per wallet create more organic activity. Greater wallet counts and higher funding improve this effect.

  • Asset Balances: Surge is funded with equivalent values of ADA and the selected CNT. Strategies with imbalanced net buys or sells, along with token price changes and slippage, may cause uneven balances. Adding additional ADA or CNT to rebalance helps maintain optimal performance.

  • Funding Amount: Higher funding enables greater activity. On testnet, small amounts (such as 10k tADA and the equivalent value of the test token) can generate more than 1 million ADA in daily volume. For mainnet, a more conservative approach is recommended, and Surge will provide detailed liquidity guidelines at launch.

  • Health Score: ratio of wallet balance to strategy activity, green indicates safe and red indicates risky.

Tracking your Surge Activity

Visit the Dashboard to view your Surge market-making statistics, including total volume, net buys and sells, transaction count, and more. You can also track volume over time and review buys and sells by time period.

The Wallets page shows all wallets in your Surge account, including total balances of ADA and MIN, transaction counts, and active status. Each wallet preview displays asset balances, activity status, names, receive addresses, and more. As your strategy executes, you can track funds moving seamlessly between wallets in real time.

Selecting a wallet opens its detail page, displaying balances, activity, and complete transaction history. Each transaction hash can be accessed directly in the history and viewed on the CardanoScan PreProd website. Transactions may take a few minutes to display on CardanoScan.

View detailed information about your strategies by going to the Strategies page and selecting a strategy. The ability to edit strategies and view further insights will be rolled out with mainnet.

Visualizing Surge Running on Minswap Testnet

Surge testnet operates through the Minswap Pre-Production testnet. You can view the ADA/MIN pair on the Minswap PreProd website, where all buy and sell orders from Surge users will appear along with volume, price, and other data, just like on the Minswap mainnet application.

Tutorial complete!

Great job completing the Surge Public Testnet tutorial! You have learned how to set up your account, generate and fund wallets, and create strategies to start market making on Cardano. Share your feedback with us in our Discord and stay tuned for more Surge updates!

Last updated