Faucet

Event Re-added v133 → v133, v134 → v135, v136 → v141, v142 → v148, v149 → v165, v195 → v219, v233 → v247, v252 → v265, v273 → v277, v290 → v315, v320 → v326, v334 → current #54

Emitted when testnet faucet dispenses tokens.

View events on chain

Useful for: developersvalidatorsminerswallets

The Big Picture

The faucet is a testnet-only feature that dispenses free tokens for development and testing. It lets developers experiment without spending real TAO. This event confirms you received testnet tokens from the faucet. Not available on mainnet.

Why This Matters

For testnet development, you need tokens to test staking, registration, and other operations. The faucet gives you free testnet TAO so you can experiment. This event confirms your faucet request succeeded.

Example Scenario

You're developing a new validator on testnet and need tokens. You call the faucet. Faucet fires with your address and the amount dispensed. Now you have testnet TAO to register, stake, and test your validator software.

Common Questions

Can I use the faucet on mainnet?: No, the faucet only exists on testnet. Mainnet TAO has real value and must be acquired through legitimate means.
Are there limits on faucet usage?: Usually yes - per account, per time period, or both. Check testnet documentation for current limits. Faucets prevent one person from hoarding all testnet tokens.
Why isn't my faucet request working?: Common issues: rate limited (requested too recently), wrong network (on mainnet), or faucet is empty/disabled. Check testnet status and wait before retrying.

Use Cases

Get free testnet tokens for development
Fund accounts for testing
Track testnet faucet usage
Build testnet development workflows

How to Use This Event

→ Track faucet requests for your development accounts
→ Monitor faucet usage on testnet
→ Build development environment setup tools

From Chain Metadata

the faucet it called on the test net.

Triggers

Emitted by

faucet

Preconditions

Faucet is enabled (testnet only)
Caller meets faucet requirements

Effects

Postconditions

Caller receives test tokens

Side Effects

Only available on testnet

Event Data

#	Name	Type	Description
0	arg0	AccountId	Event field #0 (AccountId) (hex -> SS58)
1	arg1	u64	Event field #1 (u64)

Code Examples

import { ApiPromise, WsProvider } from "@polkadot/api";
import { stringCamelCase } from "@polkadot/util";

const provider = new WsProvider("wss://entrypoint-finney.opentensor.ai:443");
const api = await ApiPromise.create({ provider });

// Subscribe to Faucet events
api.query.system.events((events) => {
  events
    .filter(({ event }) =>
      event.section === stringCamelCase("SubtensorModule") &&
      event.method === "Faucet"
    )
    .forEach(({ event }) => {
      console.log("Faucet:", event.data.toHuman());
    });
});

Version History

Version:

v133 block 1,404,224 2 args

v134 block 1,455,498 2 args

v136 block 1,756,781 2 args

v142 block 2,543,779 2 args

v149 block 3,014,339 2 args

v195 block 3,791,350 2 args

v233 block 4,920,350 2 args

v252 block 5,163,656 2 args

v273 block 5,659,032 2 args

v290 block 5,947,548 2 args

v320 block 6,523,566 2 args

v334 block 6,811,690 2 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 54
First Version: v133
Current Version: v393

Back to SubtensorModule Events