Contract Interactor TG Bot Guide

Important Note: Make sure to use burner wallets and transfer funds to new wallets that
you have not imported into my bot because all wallets you import here will be saved on my

🙏
server. I will NOT be responsible for any funds loss so please use burners and transfer
funds as soon as your work is done .

As I'm running this bot on my server so In case if someone hacks my server he can
access all our wallets even I encrypted the wallets but idk how secure it will be so
please never hold big funds in my bot .

Or if you don't feel comfortable you can simply not use my bot.

Guide Overview
This guide will walk you through using the Contract Interactor Telegram bot to interact with
contracts by writing functions, minting NFTs, dispersing funds, and more. Follow the
instructions carefully to utilize all available features.

To Get Access For My Bot

●​ Get Your Telegram User ID here by sending hi here : https://t.me/userinfobot
●​ Open the bot link below : (/start) will not work:​
https://t.me/auth_user_telegram_bot and send this command :

/add userId

Example : /add 123456789

●​ Start the main bot : https://t.me/contract_interactor_bot

●​ Done ! You are whitelisted.

Features
1. Chain

✅
Click this button to show a list of available chains. You can select the chain you want by
clicking on its name. After selection, a will appear next to the chain name.

2. Funding Wallet
You need to import a funding wallet by providing its private key. Ensure you add "0x" at the
beginning if it is not already included.
What it does: This wallet is used to fund all the minting wallets when you press "Disperse
ETH."

3. Minting Wallet
These are the wallets that will mint NFTs (or write contracts). You can use a maximum of
100 wallets at a time.

4. Generate Minting Wallet

Clicking this button will display a "Quantity" button. Clicking "Quantity" will prompt you to
enter the number of wallets you want to generate (maximum 100). After setting the
quantity, click "Generate."

If you already have minting wallets, this action will check the balances (not NFTs ) of your
wallets (selected wallets) for the current selected chain. If the balance is almost 0, it will
delete your previous wallets and generate new wallets.

So if you want to delete the current wallets , make sure you not have funds /nft on that
wallet , then click generate wallets it will first check if you have any eth , if there is it will
consolidate that to your consolidation address and then deletes the old wallet and generates
the new one

5. Wallet to Use
Wallet To Use is like Selected Wallets for performing tasks

This is for like let's say you have 100 minting wallets generated but you want to use only
first 10 wallets , so you can edit the default value All to your preference

This is like you can say Selected Wallets For Performing Tasks

Only Selected Wallets Will Be Used For Minting / Consolidating ETH or NFTs From /
Disperse To .

So it's like :

Mint with {Selected Wallets}

Consolidate ETH/NFTs from {Selected Wallets}

Disperse ETH to {Selected Wallets}

6. Disperse ETH
Required Values: "Disperse Gwei / Cons Gwei" and "Disperse Amount in ETH."

Disperses the set amount in "Disperse Amount" to each Selected Wallet

7. Consolidate ETH
Required Values: "Disperse/Cons Gwei" and "Consolidation Address."
Consolidates all your funds from Selected Wallets to the Consolidation Address .

Note : By default the consolidation address will be your funding wallet address

8. Consolidate Tokens
Required Values: Contract Address, Disperse/Cons Gwei, and Consolidation Address.

Consolidates all tokens from Selected Wallets to the Consolidation Address

9. Consolidate NFTs
Required Values: Contract Address, Disperse/Cons Gwei, Consolidation Address, and Block
Range.

Block range = Just put the block number of your mint transaction.

Consolidates all NFTs from Selected Wallets to Consolidation Address.

10. Consolidate Address

This is by default your Funding Wallet Address , you can edit this with your secured wallet
address i.e the wallet which is not imported on bot

11. Contract Address

You know what Contract Address means, just put the contract address of your project and
its done

12. Function
Enter the function with arguments (e.g., mint(2)) that the bot will write this function. for the
contract address.

Like if function is like mint(amount,address)

You will have to write for example :

mint(1,0xE34c19Adafa7Ff9faEBF96672961AC1dCdD8F486)

Note : This is just an example the actual function will be according to contract

13. Minting Gwei

Set the Gwei price you want to use for minting or writing contracts.

14. Disperse/Cons Gwei

Set the Gwei price for dispersing ETH or consolidating funds/nfts.

15. Payable Amount

Enter the amount in ETH for paid mints.(This is not for gas fees ) This is just for (mint Price
* quantity).
16. Disperse Amount
Enter the amount in ETH that the "Disperse ETH" button will disperse to each Selected
Wallet

17. Estimate Transaction

Estimate the transaction details to ensure everything is ready to go. You can also estimate
gas to check for execution errors.

Note : This will only work if minting is already opened else it will not estimate the gas fees !

18. Custom Gas

Applicable only to trigger types Function and Timestamp

Enter the custom gas value to be used when a specific trigger type is selected.

19. Auto Trigger

Clicking "Auto Trigger" toggles its state:

✅Means Enabled
❌Means Disabled
●​
●​

What it does: This feature is helpful for hyped mints. Enable auto trigger and select a trigger
type to automatically send transaction(s) when Minting Starts.

20. Trigger Type

Used only when Auto Trigger is enabled.

After selecting a trigger type, click "Start" to add the task.

●​ Specific Function: Scans mempool for the specified function (e.g., enableMint). When
the function transaction is detected, it uses custom gas set by the user and a Gwei price
slightly less than the detected transaction to ensure your transaction is confirmed after
it.
●​ Estimate Trigger: Estimates the contract until minting is enabled and sends the
transaction as soon as minting is available.
●​ Timestamp: For mints available at a specific timestamp, this option sends the
transaction automatically at the specified time using custom gas.

Note : It will be ignored when Auto Trigger is disabled

21. Spam TX
Applicable only to Trigger Type: Timestamp.

Set how many times you want to spam transactions for each selected wallet, as
timestamp-based minting may not always be precise for blockchains with variable block
times.
22. Start
If Auto Trigger is disabled, this button attempts to mint (or write the contract) instantly for
selected wallets with the Contract Address provided by the user and its function with
minting gwei.

If Auto Trigger is enabled, it creates a task and sends the transaction when the trigger
condition is met for trigger type :

●​ Timestamp: Sends the transaction when the specified time is reached.

●​ Estimate: Sends the transaction when there are no execution errors.
●​ Function: Sends the transaction when the specified function transaction is detected in
the mempool.

Note : You will see all users txs result in this telegram group :

https://t.me/result_sender

Guide For Opensea Mints

●​ Select the Correct Chain

●​ Paste and send the “<CA>space<quantity>” directly in the bot to mint <quantity>
NFTs. (or just paste the ca only to maxMint)​
Example:
Send “0x00005EA00Ac477B1030CE78506496e8C2dE24bf5 5” to mint 5 NFTS
of this contract.
●​ It will auto fill settings we need .

●​ By default the setting will set trigger type as timestamp

When to use timestamp trigger?

When the drop is too hyped and few supply is left to mint then use timestamp
trigger .

Otherwise change it to Estimate Trigger - The Best One

Note : Trigger type will be ignored if auto trigger is disabled .

●​ Set the Minting Gwei

Note : For Arbitrum mints use only like 1 Gwei as arbitrum is based on FIFO (First
In First Out) So It will not prioritize the high fees payers (even putting high fees will
 not pay high fees) so there will be never be Gas War but the one who sends tx first
will win.

●​ Enable the auto trigger only if mint is not started and about to start

Else just mint it without enabling auto trigger by clicking Start .

Custom Functions
Method:

custom(launchpad,*args)

Where launchpad is Launchpad Name and args is required arguments for that
launchpad

Custom Functions For Specific Launchpad:

1.Mavis Launchpad Public Phase (RONIN):

Target Contract : 0xa8e9fdf57bbd991c3f494273198606632769db99 (for now)

⚠️Warning- Please Check the latest target contract before proceeding.

●​ Launchpad Name: mavis
●​ Required arguments in same order :

1.NFT Contract Address​

2.Quantity

Example :

For this mint : https://marketplace.skymavis.com/launchpads/mints/cybercitizens

NFT contract address is : 0xfc5e0d385f97c8068acd7c4a3b2cd1f5bdea45f2​

Quantity : (According to you)
​
So final function for this example will be : ​
​

“custom(mavis,0xfc5e0d385f97c8068acd7c4a3b2cd1f5bdea45f2,1)” (for 1
NFT)

Payable amount = according to price​

Contract address =Target Contract
(0xa8e9fdf57bbd991c3f494273198606632769db99 )​
​