Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Challenges following the tutorial

Open
#143 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
25/100
Issue type
Documentation
Clarity
Needs clarification
Activity status
Stale
Tech stack
shell, ubuntu
Domain
cli, documentation

Research direction

Start with the Elements code tutorial's blockchain page and the linked basic-operations tutorial, then reproduce the wallet and initial-free-coins commands shown in the report. Determine how the tutorial expects users to access the startup funds, and update the relevant tutorial guidance so wallet creation and a successful balance check are explicit.

Written by the indexing model from the issue text.

Description

I'm attempting to set this up in a virtual machine following the tutorial. My VM is allocated ample storage and memory and running Ubuntu 20.04.2 LTS as the underlying operating system. The PPA repository for installing Bitcoin no longer seems to work, so I went ahead and installed Bitcoin from https://bitcoincore.org/bin/bitcoin-core-0.21.1/bitcoin-0.21.1-x86_64-linux-gnu.tar.gz, checking sha256 and signatures.

After installing Elements and setting up work environment, the following commands fail as there is no wallet, as one is not created by default.

Give them a few seconds to start up and then check they are running:

e1-cli getwalletinfo
e2-cli getwalletinfo

To get past this, I simply create wallets for both

e1-cli createwallet ""
e2-cli createwallet ""

And also for bitcoin

b-cli createwallet ""

Advancing forward in the tutorial to the next page, Using Elements to perform basic operations. From the tutorial the expectation is for the wallets to show 21 million bitcoin due to anyone can spend. But the balance is 0. With no balance on regtest, I can't proceed with sending to addresses generated by elements due to Insufficient funds.

So then since this is regtest, I do this to get 5000 coins available, and more in the immature balance

b-cli -generate 200

This doesn't help get access to initialfreecoins but may be viable to use for pegin

Simplify. Attempting just the standalone

The same is true if I take bitcoin out of the equation. Using just the standalone blockchain guidance found here: https://elementsproject.org/elements-code-tutorial/blockchain

# Args
STANDALONEARGS=("-validatepegin=0" "-defaultpeggedassetname=newasset" "-initialfreecoins=100000000000000" "-initialreissuancetokens=200000000")

# Startup 
e1-dae ${STANDALONEARGS[@]}

# Have to create wallet before viewing it
e1-cli createwallet ""

# Has zero balance, but shows asset name as `newasset` as anticipated
e1-cli getwalletinfo

# Look at transaction in first block from startup initialfreecoins
tx1=`e1-cli getblock $(e1-cli getblockhash 0) | jq -r .tx[1]`
e1-cli decoderawtransaction `e1-cli getrawtransaction $tx1`

I can see the 1,000,000 newasset created in vout, as well as the 2 for reissuance.

How can I claim the coins to the wallet to test with?

Dominant language
HTML
Stars
35
Forks
24
Avg merge
7h 45m
Merged PRs (30d)
1

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from ElementsProject/elementsproject.github.io

All issues in ElementsProject/elementsproject.github.io

Similar issues

More CLI issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.