Massive sender bot & contract

[PolyProgrammist]

Summary

Bot that sends toncoins to several addresses using smart contract

Context

The bot and smart contract is needed to simplify massive sending. Usages are:

• Rewards for ton competitions
• Payments for investors

Goals

The bot should accept json file that contains a dictionary from address to number of toncoins to send to this address

JSON example

{
    "EQDk0rRqwtKw34r0fecUO6YotwKfMPU9XIxwrfjOfX9BIUx_": "52",
    "EQBnk2PqeZZjIya2zvPlH2pnSQYYPjNReMntiOyWYt9au_fc": "34",
    "EQCafuKP6EVcOo_ZifdIBfE1EwM1QPFj_-ryaT0IY6CNRVtV": "100"
}

CSV example:

"EQDk0rRqwtKw34r0fecUO6YotwKfMPU9XIxwrfjOfX9BIUx_",52
"EQBnk2PqeZZjIya2zvPlH2pnSQYYPjNReMntiOyWYt9au_fc",34
"EQCafuKP6EVcOo_ZifdIBfE1EwM1QPFj_-ryaT0IY6CNRVtV",100

TG message example:

EQDk0rRqwtKw34r0fecUO6YotwKfMPU9XIxwrfjOfX9BIUx_: 52
EQBnk2PqeZZjIya2zvPlH2pnSQYYPjNReMntiOyWYt9au_fc: 34
EQCafuKP6EVcOo_ZifdIBfE1EwM1QPFj_-ryaT0IY6CNRVtV: 100

User needs to connect to the bot via ton connect 2.0 with tonkeeper. Then they need to provide the file with description of addresses and number of tons to send for each address. After that they should approve transaction to send toncoins from their wallet to smart contract. Smart contract will send the coins to addresses from file.

Other details:

• Smart contract should recursively send all messages in chunks of length 254 if there are too many of them
• Smart contract should be deployed with addresses and amounts in data
• 0.1 ton will be added for each address for gas. The remaining amount will be returned to sender

Smart contract language: Func Tests will be on: blueprint & sandbox

Deliverables

• Telegram bot
• Smart contract with tests

Definition of Done

• [x] Smart contract & tests
• [x] Telegram bot

Reward

• Standard TON Footstep NFT
• 1000 USD equivalent in TON

• Total: $1000

[Gusarich]

Isn't it just a highload wallet with telegram bot linking?

[Naltox]

Isn't it just a highload wallet with telegram bot linking?

Not quite, main goal is to create bullet-proof solution. In case of using highload wallet bot backend should track each message to highload wallet and check if transaction is complete. It's quite a problem if server goes down or there is a bug in backed code.

@PolyProgrammist suggest's solution that will take only one transaction from user wallet that will initiate recursive process of sending coins which will not depend on any backend or offchain infrastructure.

@PolyProgrammist btw: i think coin's amount in JSON should be string since we can face some problems with float's in JS.

Smart contract should be deployed with addresses in data cell. Initial cell should contain three addresses along with a link to next cell

I guess you should just have Address -> coins map in contract data, you just delete ones that are send per each transaction

[Gusarich]

Why do we even need external messages for this contract? Deployment will be done through ton connect 2.0 via internal message. And then contract will start the payment process immediately with the data from stateinit.

[Gusarich]

In general this footstep looks useful. Are you sure about using Tact language for this contract?

[Naltox]

Why do we even need external messages for this contract? Deployment will be done through ton connect 2.0 via internal message. And then contract will start the payment process immediately with the data from stateinit.

we dont

[Naltox]

In general this footstep looks useful. Are you sure about using Tact language for this contract?

Yeah, this will be one of first production ready product's done using Tact

[Gusarich]

@PolyProgrammist Were you going to take up this footstep, or did you just come up with an idea?

[PolyProgrammist]

@PolyProgrammist Were you going to take up this footstep, or did you just come up with an idea?

I can do it most likely. Discussing it with @Naltox Naltox

[PolyProgrammist]

@Naltox @Gusarich could you please approve or comment? Ready to do this

[PolyProgrammist]

@PolyProgrammist Were you going to take up this footstep, or did you just come up with an idea?

Smart contract language changed to func. What do you think?

[Naltox]

Update: after some discussion with @PolyProgrammist we came up that it would be better to write this contract on FunC, since gas usage is important and Tact has some overhead

[Gusarich]

@PolyProgrammist told us that he won't complete this Footstep.

[Gusarich]

I'd like to complete this Footstep.

[PolyProgrammist]

Hi guys! Sorry, I can't take this footstep. Please feel free to take it

[Gusarich]

Completed the smart contract & script & tests in repository:

• https://github.com/Gusarich/ton-mass-sender

I'll implement the Telegram bot soon.

[Gusarich]

I've also edited the description of this Footstep a little bit.

[Gusarich]

Telegram bot is done.

[Gusarich]

@Naltox can you please review it?

• https://github.com/Gusarich/ton-mass-sender

[Gusarich]

There were many adjustments, improvements and fixes to the bot and the contract. It's currently on the final stage of the review. 👀

[Naltox]

LGTM!

[delovoyhomie]

Thank you for the contribution!

A reform of the TON Footsteps collection mint is currently underway, which may result in increased SBT receipt times. Please accept our apologies.

However, the cash equivalent reward has already been received by the performer.

[delovoyhomie]

TON Footstep SBT was minted!

[delovoyhomie]

Feel free to utilize the @ton_mass_payments_bot.

[mbaneshi]

Thank you all. 💯

[delovoyhomie]

@Gusarich, I've encountered an issue where I can't re-link my wallet. Let's add the option to connect a new wallet.