Atomicals Local Wallet Deployment & Private Node Setup Guide

Introduction to Atomicals Protocol

Atomicals is a simple yet flexible protocol designed for minting, transferring, and updating digital objects (traditionally called NFTs) on UTXO blockchains like Bitcoin. An "Atomic" organizes digital ownership through defined rules—creating a chain of custody for digital assets.

Part 1: Atomicals-JS Wallet Setup

Prerequisites

Install these essential tools:

Node.js (Download)
Git (Download)
VS Code (Optional, Download)

👉 Need help with installations?

Clone the Repository

Open VS Code and clone the project:

git clone https://github.com/atomicals/atomicals-js.git

Navigate to the project directory in the terminal.

Build the Project

Run these commands sequentially:

npm install -g yarn
yarn install
yarn build

Initialize Wallet

Create a wallet by executing:

yarn cli wallet-init

This generates a wallet.json file containing your mnemonic phrase and private key.

Part 2: Key Commands

Command	Description
`yarn cli mint-dft ...`	Mint fungible tokens (FT)
`yarn cli mint-realm ...`	Mint Realm NFTs
`yarn cli mint-nft ...`	Mint image NFTs
`yarn cli balances`	Check wallet balances

👉 Command reference cheat sheet

Part 3: Private Node Setup

Bitcoin Core Configuration

Edit bitcoin.conf with:

txindex=1
server=1
rpcuser=electrumx
rpcpassword=electrumx

Restart Bitcoin Core.

Docker Installation

Download Docker for your OS:

Launch Atomicals Node

Clone the proxy repository:

git clone https://github.com/Next-DAO/atomicals-electrumx-proxy-docker

Update docker-compose.yml:

DAEMON_URL=electrumx:[email protected]:8332

Start services:
```
docker-compose up -d
```

Part 4: Connect Wallet to Local Node

Modify .env in your Atomicals-JS project:

ELECTRUMX_PROXY_BASE_URL=http://localhost:8080/proxy

FAQ

Q1: How to check if the node is running?
Run docker-compose ps. A "healthy" status indicates proper operation.

Q2: Where to find logs?
Access logs via Docker Desktop or terminal with docker-compose logs.

Q3: Getting "Unauthorized" errors?
Verify RPC credentials in bitcoin.conf and docker-compose.yml.

Q4: How long does synchronization take?
Initial sync may take hours depending on hardware and network speed.

Q5: Can I use a remote node?
Yes, but local nodes provide better privacy and control.

Keywords

Atomicals protocol
Bitcoin NFTs
Private node setup
Wallet deployment
Docker configuration
ElectrumX proxy
UTXO blockchain