ton_referral
# SignalHash Referral Smart Contract
Open-source smart contract powering referral cashback for SignalHash on the TON blockchain.
[Website](https://signalhash.io) · [Documentation](https://signalhash.io/tutorials/ton-referrals) · [Referral Guide](https://signalhash.io/tutorials/referrals-current-guide) · [Tonviewer](https://tonviewer.com/EQChGen86Iv7Vw2Cp5I9Q2Rkeac6l9MaW0SDzShUNeOilU-y)
Overview
The SignalHash referral contract transparently distributes qualifying TON payments between the SignalHash merchant wallet and a referrer’s wallet.
The contract:
- accepts referral promotion payments of at least
0.2 TON; - protects a configurable minimum balance for storage and fees;
- pays the requested referral share, capped at
10%(1,000basis points); - forwards the remaining distributable balance to the configured merchant;
- attaches human-readable comments to outgoing transactions;
- allows only the contract owner to update the minimum reserve.
Referral eligibility and the applicable cashback rate are determined by the SignalHash application. See the current referral guide for the latest player-facing rules.
Mainnet Contract
| Network | TON Mainnet |
| Address | EQChGen86Iv7Vw2Cp5I9Q2Rkeac6l9MaW0SDzShUNeOilU-y |
| Explorer | View contract and transactions on Tonviewer |
| Metadata | View contract metadata |
On-chain activity is published for contract-level transparency. It should not be treated as a directory attributing payments to individual SignalHash players.
Development
The contract is written in Tact and tested with the TON Sandbox and Jest.
Install
npm install
Build
npm run build
Test
npm test
Format and lint
npm run fmt
npm run lint
Project Structure
sources/
├── referral.tact # Smart contract
├── referral.spec.ts # Sandbox test suite
├── referral.deploy.ts # Deployment helper
└── referral.live.ts # Mainnet interaction helper
public/
├── signalhash-ref.json # Public contract metadata
└── logo_v2.jpg # SignalHash logo
Official Links
- 🌐 SignalHash website
- 📚 TON referrals launch documentation
- 💰 Current referral guide
- 🔍 Verify contract transactions
- 🎮 Open SignalHash in Telegram
- 💬 SignalHash community
- 𝕏 SignalHash on X
License
This project is open source and licensed under the GNU Affero General Public License v3.0.