Quick Start

Set up Metamask#

Testnet#

Visit Torus Testnet | Chainlist and press "Connect Wallet" or download Metamask here and configure a new network with the following details.

Mainnet#

Visit Torus Mainnet | Chainlist and press "Connect Wallet" or download Metamask here and configure a new network with the following details.

Deploy Timelock Smart Contract to Testnet#

Get testnet funds#

There are currently no available faucets. Please request testnet funds from the Torus team.

Write, Deploy and Interact with a contract#

Visit Remix IDE and prepare the smart contract.

Create a new Solitidy file in the Remix editor and write your contract. In this example, a timelock contract was implemented.

// SPDX-License-Identifier: GPL-3.0

pragma solidity 0.8.28;

contract Timelock {
    address public immutable owner;
    uint public immutable unlockTimestamp;

    constructor(uint _unlockDays) payable {
        owner = msg.sender;
        unlockTimestamp = block.timestamp + (_unlockDays * 1 days);
    }

    function withdraw() public {
        require(msg.sender == owner, "not the owner");
        require(block.timestamp > unlockTimestamp, "too early");

        uint256 contractBalance = address(this).balance;
        payable (owner).transfer(contractBalance);
    }
}

Navigate to Solidity Compiler pane, make sure your compiler is configured with EVM version set to London under Advanced Configuration and click Compile Timelock.sol.

Navigate to Deploy & run transactions pane, switch Remix to Injected Provider - MetaMask under Environment and switch MetaMask to Torus Testnet. Set the value you would like to send to the constructor, as well as the constructor arguments and click deploy. A MetaMask window will pop up asking you to sign the transaction, you will need to do that in order to deploy your contract. In this example, the constructor receives 10 TQF and is called with the argument 7. This locks 10 TQF for a duration of 7 days.

You can now copy the contract address or interact with the contract using the functions available under "Deployed Contracts". For this example you can read the owner, read the unlock timestamp and trigger the withdraw transaction.

Faucet Usage Guide#

Introduction to Faucets#

A faucet is a service that provides free testnet tokens to developers and testers working on blockchain applications. Since real tokens have economic value, testnets use separate, valueless tokens to facilitate development without financial risk. The Torus Coin Testnet Faucet allows users to request testnet funds to interact with smart contracts, test transactions, and simulate network activity.

How to Request Testnet Funds#

To receive Torus Coin on the testnet, users must authenticate through our Discord server and interact with the faucet bot. The process is straightforward but includes verification steps to prevent abuse and ensure fair distribution.

Join the Discord Server

Access our official Discord server at https://discord.com/invite/XkBHYSwsc. Ensure you have a verified account to interact with the bot.

Request Funds Using the Faucet Command

In a designated faucet channel, send the command:

/faucet drip <your-testnet-address>

Replace <your-testnet-address> with the address where you want to receive the testnet Torus Coins.

Solve the Captcha Challenge#

The bot will respond with a captcha challenge to verify that the request is legitimate.

You have 5 minutes to solve the challenge using the command:

/faucet solve <challenge-solution>

Replace <challenge-solution> with the correct answer to the captcha provided by the bot.

Users are allowed a maximum of 3 retries for solving the captcha.

Receive Testnet Funds#

Once the captcha is solved correctly, the faucet will send 0.1 TTQF testnet Torus Coins to the specified address.

Usage Limitations#

To prevent spam and ensure fair distribution, the faucet enforces the following restrictions:

• Cooldown Period: Users must wait 1 day before requesting additional funds.

• Max Retries for Captcha: Users have a limited number of 3 attempts to solve the captcha correctly. Exceeding this limit may result in a temporary restriction.

• Per Address and Per Discord Account: Each Discord account and wallet address can request funds only within the allowed limits to ensure fair access for all users.

If you encounter issues or need assistance, refer to the Discord community for support.