bitshares / bitshares/bitshares-ui

Faucet configuration checks

Open
#1,773 3 comments 0 reactions 0 assignees View on GitHub
[1b] User Story [3] Enhancement [4a] Low Priority
Dominant language
JavaScript
Stars
520
Forks
575
Avg merge
12h 7m
Merged PRs (30d)
5

Description

**Is your feature request related to a problem? Please describe.**
When connecting to a private testnet, the client will attempt to use the default configured public/prod faucet without warning. The user may think that they're connected to their private testnet, but they're attempting to create user accounts on the public testnet.

When you configure an alternative faucet, no checks are performed against the configured faucet, errors which occur during registration could potentially have been detected during faucet configuration (eg ping/port checks, available balance, chain id comparison between faucet and connected nodes).

No details are provided about the configured faucet, such as who the registrar will be, how much referral fee % do they take, their remaining faucet balance.

Faucet repos & the private testnet guides are outdated. I attempted to deploy two seperate faucets using docker - bitshares/faucet and GrapheneLab/tapin, without luck. I failed to get 'faucet' working due to mysql unix sockets not being created (mysql not running?) where as tapin got to a fully built state but any user registrations would just hang without any error/debug messages appearing in the UI (nor tapin terminal).

**Describe the solution you'd like**
Perform checks against configured faucet, accounting for chain id of connected network.

Display info about configured faucet, if possible.

Provide more debug messages during stalled user registration scenario.

**Describe alternatives you've considered**
Rather than use a private testnet, just use the public testnet. Obviously inadvisable for security research..

Continue trying to configure bitshares/facuet - it's the repo referred to in the bitshares docs, so it'll probably work once past the glitch.

Debug tapin, investigating why the user registration process hangs without any warnings.

**Additional context**
We aught to ensure that security researchers are able to quickly and easily produce their own private bitshares testnet, so as to reduce the risk of accidental public disclosure of their security research.

Contributor guide

Open the contributing guide

Research direction

The issue names no files, tests, or entry points. Start by tracing faucet configuration and the user-registration flow in the client, then determine which faucet checks and status details are feasible. Done should include defined checks for the connected chain and configured faucet, useful faucet information, and diagnostics for stalled registration.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
blockchain, frontend, security
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.