How to Use the New Bitcoin Web CLI Wallet (Beginner’s Guide)

The New Bitcoin CLI wallet is a simple and secure way to manage your crypto: it runs entirely in your web browser and keeps you in full control of your funds. In this guide, we’ll walk you through setting up and using this browser-based, non-custodial wallet step by step.

What Is the New Bitcoin CLI Wallet?

The New Bitcoin CLI wallet is a command-line interface wallet that operates right in your web browser. This means there’s no software to install – you simply open the wallet’s web page and interact with it by typing text commands. Despite running on the web, the wallet is non-custodial, meaning you hold your private keys at all times. Your keys are generated and used locally in your browser and never sent to any server. This gives you the security of a self-custody wallet (only you can access your funds) combined with the convenience of a web app.

When you launch the web CLI wallet, it will display some basic info like the network it’s connected to and the current software version for transparency. It also shows a security notice reminding you that your keys stay on your device and that you’re responsible for keeping backups. In other words, if you lose your private key or wallet password, there is no “reset my password” – so it’s important to save your credentials in a safe place (more on that later).

Don’t be intimidated by the term CLI. You don’t need to be a programmer to use the New Bitcoin CLI wallet. The commands are simple words, and this guide will explain each of them. Using the CLI wallet is a bit like texting with your bank account – you type short instructions (like “balance” to check funds) and the wallet responds with the information or action result. Let’s dive into getting your wallet set up!

Getting Started: Creating or Restoring a Wallet

When you first open the New Bitcoin web CLI wallet, it will prompt you to open an existing wallet or create a new one. You’ll see a message like: “Open existing wallet or create a new one. Enter wallet name MyWalletMy WalletMyWallet:”. Here’s what to do:

• Choose a Wallet Name: This can be any nickname for your wallet (e.g. “My Wallet” or “Savings”). If you’re creating a new wallet, enter a new name. If you’re returning to a wallet you created earlier on the same device, enter that name to open it. (The wallet stores data in your browser indexed by this name.)

  
  

• New Wallet vs. Restore: After you enter a name, the CLI checks if a wallet with that name exists. If not, it will say “Wallet not found.” and give you options to create a new one or restore from a private key. To create a new wallet, simply press Enter without typing anything else. To restore an existing wallet from backup, paste your private key and hit Enter.

  
  

• Set a Strong Password: If you’re creating a new wallet (or restoring one), the wallet will ask you to create a password for encryption. You’ll be prompted to enter a password and then repeat it to confirm. Choose a strong password that you won’t forget – this password will be required to open your wallet each time. Tip: Write this password down and keep it in a secure place, because if you forget it, you cannot access your wallet.

  
  

• Wallet Creation/Restoration: Once you set a password, the CLI will generate a new private key behind the scenes if it’s a new wallet, or will use the key you provided if restoring. It will then create your wallet file in the browser’s storage. You’ll see a confirmation like “Wallet created.” for new wallets or “Wallet restored.” if you entered an existing private key.

  
  

• Opening the Wallet: Next, the CLI will open your wallet file. You’ll be asked to enter the password you just set in order to unlock the wallet for use. (If you just created the wallet, it’s the same password you set moments ago.) After entering the correct password, you should see “Wallet opened.”.

  
  

• Automatic Sync: Once the wallet is opened, it will automatically sync with the New Bitcoin network to update your balance and transaction history. You’ll see messages about syncing (e.g. “Syncing wallet with network...”) and then “Wallet is synced.” once up to date. If your wallet has no prior transactions, it may also note “No transactions found.” – that just means this is a brand new account with no activity yet.

  
  

At this point, your new or restored wallet is ready to use! The CLI will present you with a prompt that includes your wallet name, for example:

My Wallet> 

This is where you will type commands to interact with your wallet. If you ever forget what commands are available, just type help at the prompt.

Basic Wallet Commands

The New Bitcoin CLI wallet supports a variety of simple commands to manage your account. You can always type help to see a list of all commands and a short description of each. Below, we’ll cover the most commonly used commands one by one. (Commands are not case-sensitive, and you can often use just the first letter of the command as a shortcut – those shortcuts are noted in parentheses.)

• balance (or b for short) – Check Your Balances. This command shows all the token balances in your wallet. After syncing, it will list each asset and the amount you hold. For example, it might show your amount of New Bitcoin tokens (the network’s native coin) and any other tokens you own. Using the balance command will print something like:

My Wallet> balance 100.00000000 NEWBTC

Each line shows the amount and the token ticker symbol. In a new wallet, you’ll likely just see 0 or no balances until you receive funds. (The CLI formats the output neatly with each token on its own line.)

• address (or a) – Show Your Wallet Address. This displays your wallet’s public account ID, which is the address others can use to send you New Bitcoin. When you type address, the wallet will output a long string of characters – that’s your public address. You can copy this and share it with anyone who wants to send you funds. (The command id is an alias that refers to the same thing in some contexts, but use address to be clear.)

  
  

• history (or h) – View Transaction History. This command lets you review your past transactions. When you type history, the wallet will ask: “Please enter starting index or press Enter to show last transactions:”. If you just hit Enter, it will show you the most recent transactions (up to the last 50). You’ll see a list with details for each transaction: an index number, date/time, type of transaction (send/receive), amounts, fees, etc., in a formatted table. If you have a long history and want to view from a specific entry, you can enter an index number (the index is basically the transaction count order) to see 50 transactions starting from that point. For a new wallet with no transactions, history will simply report “No transactions found.”

  
  

• send (or s) – Send Funds to Another Address. This is how you transfer New Bitcoin (or other tokens) to someone else. When you type send, the CLI will interactively prompt you for the details of the transfer. It will ask: “Please enter destination account id:” – here you paste or type the recipient’s address (the long string that they gave you). Next it asks “Please enter amount:” – you input the number of coins or tokens you want to send. If you have more than one type of token in your wallet, the wallet will then ask which token you want to send (you can press Enter to choose the default, which is usually the main New Bitcoin coin). After you provide the necessary info, the wallet will attempt the transfer.

  • If the send is successful, you’ll see a confirmation message indicating that the transfer block was authorized successfully, meaning the transaction was accepted by the network. It will also show your updated balance after sending, so you can immediately see the deduction.

  • If something went wrong (for example, if you entered an invalid address or an amount greater than your balance), the wallet will output an error message explaining the issue. In that case, no funds have left your wallet, and you can try the send command again after resolving the error (check that the address is correct, you have enough balance, etc.).

    
    

  Security tip: Double-check the destination address before confirming a send. Once a transaction is authorized and confirmed, it cannot be reversed, since New Bitcoin is a blockchain. The CLI wallet will not ask “Are you sure?” – it assumes that by typing the command and entering details, you intend to send.

  
  

• status (or st) – Show Wallet Status Summary. This command gives you a quick summary of your wallet and network status. It will print out information like the network name (e.g., testnet or mainnet), the current network block height (how many blocks have been processed in the network), the current transfer fee, your wallet’s address, how many transactions (blocks) are in your account, and your total balance. It’s a handy overview to ensure you’re connected to the right network and to see your balance at a glance along with some network stats.

  
  

• key (or k) – Show Your Private Key. This outputs your wallet’s private key (the secret key controlling your funds). When you run key, the CLI will display a long alphanumeric string – that is your private key. Keep this secret! Anyone with your private key can control your funds. This command is provided so that you can make a backup of your key. It’s wise to copy this key and store it in a very secure place (for example, write it down and lock it away, or use an encrypted password manager). You shouldn’t need to use key often – just once to back up your wallet – because day-to-day operations do not require exposing your private key.

  
  

• count – Show Number of Transactions. This outputs the total count of transaction blocks in your wallet’s history. In simpler terms, it’s how many transactions (send/receive events) have occurred in your account. This can be useful for curiosity or advanced troubleshooting, but it’s not a command you’ll use frequently as a new user. (The history command is usually more informative.)

  
  

• help (or ?) – List All Commands. We mentioned this earlier, but it’s worth reiterating: if you ever need a reminder of available commands or want to discover more, type help. The wallet will list every command it supports, along with a brief description of each. This is a great way to discover advanced features once you’re comfortable with the basics.

  
  

• quit / exit / stop (or q) – Exit the Wallet. When you’re done using the CLI wallet, you can type quit, exit, or stop to cleanly exit the application. Since this wallet runs in a browser tab, you can also simply close the tab or window, but using the command ensures the wallet shuts down its processes gracefully. The next time you navigate back to the CLI wallet page, you’ll be able to open your wallet again by entering your name and password. (If you just refresh the page without quitting, you may need to re-enter your password to resume.)

  
  

Advanced Features and Commands (Optional)

The New Bitcoin CLI wallet also includes some advanced commands for users who are participating in the network’s operations or other special features. If you’re a first-time user and not particularly crypto-savvy, you may not need these right away – but we’ll briefly mention them for completeness:

• Voting for Nodes (votefor) – The New Bitcoin network may allow coin holders to vote for an authorizer node (similar to staking or delegation in other networks). Using the votefor command lets you set which node (by its account ID) you want to support with your vote. If you decide to change your vote or stop voting, you can run votefor and just press Enter when prompted to clear it. This is an advanced feature relevant if you’re involved in New Bitcoin’s consensus or governance, but it’s there when you need it.

  
  

• Staking (staking) – Participate in DPoS staking using a simple menu.

  New Bitcoin uses a Delegated Proof‑of‑Stake (DPoS) model, where regular users can “stake” their coins to support validator nodes and, in return, may earn a share of network rewards. In plain terms: you lock some of your New Bitcoin behind a node you trust, help secure the network, and can earn passive income for doing so.

  When you type staking, the wallet opens a small interactive menu that walks you through common staking tasks. The exact wording may vary slightly between versions, but you can expect options along these lines:

  
  

  1. Create a new staking position

     Use this when you’re staking for the first time. The wallet will typically ask you to:

     • Pick which node / profiting account you want to stake to (by its account ID).

     • Enter the amount of NEWBTC you’d like to stake.

     • Choose a lock period (for example, a minimum number of days you agree to keep your stake in place).

     • Confirm whether you want compound staking (letting any rewards automatically grow your stake).

     After you confirm, the wallet creates a staking record on the blockchain and shows a confirmation. Your staked amount will then show up as locked in that staking position rather than in your spendable balance.

     
     

  2. Add funds to an existing stake

     If you already have a staking position and want to increase it, pick this option. The wallet will:

     • Show you your existing staking positions (if there are several) so you can pick one.

     • Ask how much additional NEWBTC you want to add.

     • Confirm and submit the transaction to top up that stake.

     This is handy if you buy more New Bitcoin later and want to boost your staking without creating a separate position.

     
     

  3. Withdraw or “unstake” funds

     This lets you take your coins back from staking. When you choose this option:

     • You select which staking position you want to withdraw from.

     • The wallet shows you how much is currently staked and whether your lock period is over.

     • If you’re still inside the lock period, it may warn you that an early‑withdrawal penalty applies (a small percentage of your stake is lost as a fee).

     • Once you confirm, the wallet sends a transaction to unlock those coins. After it’s confirmed, your NEWBTC will move back into your normal wallet balance, and that portion will stop earning rewards.

       
       

  4. View details of a staking position

     This option is “read‑only” and safe to explore. It typically shows you:

     • Which node / profiting account you’re staked to

     • The amount of NEWBTC currently staked

     • Any accumulated rewards (if reported by the node)

     • How long remains in your lock period

     It’s a convenient way to check on your staking without logging into any external dashboard.

     
     

  5. Exit the staking menu

     This just closes the staking submenu and returns you to the main wallet prompt (My Wallet>). Your staking positions remain on‑chain; you can come back at any time with the staking command.

     
     

  As a new user, you can safely start with a small amount of NEWBTC and a short lock period to get a feel for how staking works. Remember: staking is optional. You can use the wallet perfectly well for sending and receiving without ever touching the staking command.

  
  

• Operational Accounts (operation) – This command is intended for users who run nodes on the network. It allows creation of an operational profiting account – an account type that can share rewards with others. When you type operation, the wallet will guide you through creating a special account, asking for details like account name, reward sharing percentage, etc. This is quite advanced and only useful if you know you need it (for example, if you’re setting up a node and want to accept stakes). Regular users can ignore this until they’re more involved in the ecosystem.

  
  

• User‑defined tokens (token) – Create your own custom token on top of the New Bitcoin network. This is an advanced feature that lets you issue a personal or project token that can be sent and received much like the native NEWBTC (on‑chain ticker BTCNW). When you type token, the wallet walks you through a series of prompts:

  • Token name – A short symbol for your token (e.g. USD).

  • Domain name – A longer “namespace” for your token (e.g. FirstBank). Together, the domain and symbol form the token’s full ID, shown as domain/symbol (for example FirstBank/USD).

  • Description (optional) – A brief text description of what the token is for.

  • Total supply – How many units of the token will exist in total (up to 90,000,000,000).

  • Precision (0–8) – How many decimal places the token supports (similar to how NEWBTC can be split into smaller units - Bits).

  • Final supply? – If you confirm this as final, the total supply cannot be increased later (the token becomes fixed‑supply).

  • Owner name / address / tag (optional) – Extra metadata about who owns or issues the token, and any tag or label you want to attach.

  After you confirm, the wallet creates the token and adds the full amount to your balance, shown like:

    100,000.00 FirstBank/USD
    99.99 NEWBTC

You can now send this token with the usual send command. When the wallet asks “Please select token to send, or press Enter for NEWBTC”, you must type the full token identifier exactly as shown in your balance (for example FirstBank/USD, not just USD). The recipient will see the token appear in their own wallet once they receive and sync.

As a new user, you don’t need to master the advanced commands right away. The basic ones – creating a wallet, checking your address/balance, sending funds, and viewing history – will cover 99% of day-to-day usage. As you grow more comfortable and if you get involved in things like staking or running a node, you can always refer back to the help output or documentation for guidance on these advanced features.

Tips for Safe Usage

Because the New Bitcoin CLI wallet is non-custodial and gives you full control, it’s important to follow some best practices to keep your funds safe:

• Back Up Your Private Key: When you create a new wallet, immediately use the key command to display your private key and back it up. Copy that string and store it somewhere secure and offline (for example, write it on paper and keep it in a safe, or use an encrypted digital vault). This private key is the ultimate key to your account – if you ever lose access to the web wallet (say you clear your browser storage or switch devices) or forget your password, you can restore your wallet with this key. But if you lose the key and your password, no one can recover your funds – not even the New Bitcoin developers – because the keys are never shared.

  
  

• Remember Your Password: The wallet password you set is required to open the wallet file in your browser. Make sure it’s something memorable (yet strong) or keep a secure reminder. If you forget the password but still have the private key, you can restore the wallet on another device or session by creating a new wallet from that private key (you’d have to start fresh and set a new password). It’s easier, though, to just remember the password from the start.

  
  

• Use the Wallet in a Secure Environment: Since it runs in your browser, try to use it on a trusted device and network. Avoid using the wallet on public computers. The security of the wallet depends on the security of your device – malware or keyloggers on your machine could theoretically capture what you type (including commands and passwords). The wallet itself does its best to secure your keys (storing them encrypted in the browser), but always practice good digital hygiene: keep your browser and OS up to date and use antivirus or anti-malware tools as needed.

  
  

• No Installation Needed – but Bookmark the Page: Make sure you’re accessing the official New Bitcoin CLI wallet page when you use it. Since there’s no installable app, you’ll likely reach it via the official New Bitcoin website or a dedicated URL. Consider bookmarking that page to avoid phishing sites. The genuine wallet will show the correct network info and the security notice about being non-custodial when it starts up.

  
  

• Stay Synced: The wallet usually syncs automatically when opened, but if you suspect it’s out of date (for instance, you expected to receive funds that aren’t showing yet), you can use the sync (or s) command to manually synchronize with the network. This will fetch any new transactions for your account. Generally, the CLI wallet will also sync after you send or receive something, but the sync command is a good trick if you just want to refresh the state.

  
  

• Explore with Caution: Feel free to explore commands like history, status, etc., to get comfortable. These are read-only and won’t affect your funds. Commands that change something (like send, votefor, operation, staking, etc.) will ask for input and perform actions – use those only when you intend to. If you’re ever unsure, you can always type help to recall what a command does before using it.

  
  

Conclusion

The New Bitcoin web CLI wallet offers a powerful yet accessible way to manage your crypto without installing anything. It might look a bit old-school with its text-based interface, but it’s designed to be straightforward for everyday users. You get the convenience of a web app and the security of knowing you control your keys.

By following this guide, you should be able to create a wallet, secure your keys, check your balance, send transactions, review your history, and even explore staking with confidence. As you gain experience, the CLI wallet has additional features ready for you to explore – all at your own pace.

Remember, with great power (over your keys) comes great responsibility: keep your credentials safe, double-check addresses when sending funds, and happy transacting! The New Bitcoin CLI wallet puts you in the driver’s seat of your crypto finances – enjoy the ride! 🚀