Requesting Tokens
Follow these steps to request testnet DS Tokens from the faucet.
Step 1: Use Ethereum Sepolia
The faucet currently runs on Ethereum Sepolia. The page displays the live drip amount and token information for that deployment.
Step 2: Provide a wallet address
You have two options:
- Connect your wallet — Click the wallet connect button to use your connected address. This is recommended because the faucet can check your current balance and cooldown status.
- Enter an address manually — Type or paste any valid EVM address. The faucet validates the format before allowing submission.
Step 3: Submit the request
Click the request button. The faucet:
- Sends the request (address) to the BC Labs Gateway
- The gateway submits the
requestTokens()transaction on-chain - You receive a confirmation with a link to the transaction on the block explorer
What happens on first request
If your wallet address is not registered as an investor in the DS Protocol, the faucet contract automatically registers it. You will see a WalletAutoRegistered event in the transaction logs. This is required before you can sign EIP-712 permissions for vault registration.
Error states
| Error | Cause | Resolution |
|---|---|---|
| Cooldown active | You already requested tokens within 24 hours | Wait for the cooldown to expire |
| Invalid address | The entered address is not a valid EVM address | Check the address format |
| Faucet unavailable | The faucet contract is not configured correctly | Check the deployed Sepolia config and try again |