This is a workaround ONLY for the commit-success-but-reveal-failure transactions executed by the miratomicals-rac rust-engine. The failed transactions coming from atomicals-js are not supported at this time. Please be aware that this product/tool has been built in haste with very limited testing. Use it at your own discretion.
The product is provided 'AS IS', without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and non-infringement. In no event shall the creators, authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with The Product or the use or other dealings in The Product. The Product does not represent any investment, security, financial instrument, redemption, promise, bearer instrument or commitment of any kind. The Product is intended only for educational and experimentation purposes only and is not backed or supported by any individual or team. There are no future prospects or plans of any kind beyond the educational and experimentation usages of The Product. Any use or interaction with The Product is expressly prohibited unless your jurisdiction and circumstances explicitly permits the use and interaction with The Product. Any interaction with The Product constitutes acceptance of these terms and the user accepts all responsibility and all risks associated with the use and interaction with The Product.
Miraland miratomicals-rac Tool for Resuming after Commit Succeeded but Reveal Failed (based on miratomicals-rac).
Usage: miratomicals-rac [OPTIONS] --ticker <NAME> <--rust-engine <RUST_ENGINE>|--js-engine <PATH>> --commit-time <COMMIT_TIMESTAMP> --commit-nonce <COMMIT_NONCE> --commit-txid <COMMIT_TXID> --commit-scriptpk <COMMIT_SCRIPT_PUBKEY> --commit-spend <COMMIT_SPEND_SATS> --commit-refund <COMMIT_REFUND_SATS>
Options:
--rust-engine <RUST_ENGINE>
Use Rust native miner.
Need to provide a path to the atomicals-js repository's wallets directory.
--js-engine <PATH>
Use official atomicals-js miner.
Need to provide a path to the atomicals-js repository's directory.
--num-thread <NUM_THREADS>
Thread count.
This adjusts the number of threads utilized by the Rust engine miner.
[default: 16]
--network <NETWORK>
Network type
[default: mainnet]
[possible values: mainnet, testnet]
--fee-bound <MIN,MAX>
Set the fee rate range to sat/vB
--electrumx <URI>
Specify the URI of the electrumx.
Example:
- https://ep.atomicals.xyz/proxy
[default: https://ep.atomicals.xyz/proxy]
--ticker <NAME>
Ticker of the network to mine on
--commit-time <COMMIT_TIMESTAMP>
Previous commit payload unix timestamp
--commit-nonce <COMMIT_NONCE>
Previous commit payload nonce
--commit-txid <COMMIT_TXID>
Previous commit transaction id
--commit-scriptpk <COMMIT_SCRIPT_PUBKEY>
Previous commit tx first output script pubkey
--commit-spend <COMMIT_SPEND>
Previous commit output spend(in sats, 1 btc = 100,000,000 sats)
--commit-refund <COMMIT_REFUND>
Previous commit output refund(in sats, 1 btc = 100,000,000 sats)
--commit-bitworkc <COMMINT_BITWORKC>
Optional, previous commit bitworkc, used in perpetual/infinite mint mode.
-h, --help
Print help (see a summary with '-h')
-V, --version
Print version
Special consideration [1]: In fixed mint mode, once max mints has been reached, the reveal will not be possible, the mint amount will be refunded to your original funding wallet, with the exception of the transaction fee, which will be paid to the miners as scheduled.
Special consideration [2]: In perpetual or infinite mint mode, if you resume a failed transaction after mining has entered the next round, resuming may not work because mint_bitworkc_current and mint_bitworkc_next values have changed. In this situation, refund will be the next action.
--commit-time, --commit-nonce, please see console output, just looking for the line containing some pattern like payload time: (number) payload nonce: (number).
--commit-txid, please search and find commit txid or commit tx in console log.
--commit-scriptpk, --commit-spend, --commit-refund can be found by searching your txid at https://mempool.space, please see screenshots below
ATTENTION: --commit-spend, --commit-refund is in sats, so you need multiply the btc amount by 100,000,000
For --commit-scriptpk:
For --commit-spend and --commit-refund:
For --commit-bitworkc, please search and find payload bitworkc in console log if mint mode is perpetual or infinite
The Rust mining engine is not fully tested; use at your own risk.
RUST_LOG=miratomicals-rac=debug cargo r -r -- --rust-engine .maintain/atomicals-js/wallets --network testnet --electrumx https://eptestnet.atomicals.xyz/proxy --ticker miratomicalsir4yarn cli get 1809bfb8f69a1de200b5a5b2e96afef9f7417ee0772363c7a7cb6591eb1a9b8bi0
yarn run v1.22.21
$ node dist/cli.js get 1809bfb8f69a1de200b5a5b2e96afef9f7417ee0772363c7a7cb6591eb1a9b8bi0
walletPath ./wallets/wallet.json
{
"global": {
"coin": "BitcoinTestnet",
"network": "testnet",
"height": 2571723,
"block_tip": "000000000000000ac41f551432d9f4bbc9a0fe5bbff561a32731ab1dd4da898b",
"server_time": "2024-01-08T19:47:27.900342",
"atomicals_block_tip": "0d40515d97e5b5185d055da4a3c8cb79a16f4e42dafda39b63729cc6698245ea",
"atomical_count": 744,
"atomicals_block_hashes": {
"2571714": "b3b94255efd2d94ba70ec77cb298cb34e9b5a70a3e23ca04f12cabad142e0b71",
"2571715": "caac375454e2006bd771d32df1b3918031f43397d61846b46764a1bb474d4394",
"2571716": "48549f761486125b5be154b0f57bdf121e3c51f2703c8817188d6334fdac5a12",
"2571717": "e01485011c133fb0933c0943efa87e0d566cd2d45724657eced1c106d8c1f7da",
"2571718": "8e0fe1f6323f8b78bcdef48ca73733464412259876dfef0d32b409d4b02716f5",
"2571719": "281f004f508ac251aa383746c606bb99d666cb23891390eb0b7154ad88fe9ba5",
"2571720": "21920c557f6c5a30acee33f42b6d38b49cd9b1fc355388d21672bf73b67bb8a4",
"2571721": "4395aeda9c362ffc9624abb886bcd911f47ed76608643d012fd941c127ea3354",
"2571722": "c2d92352cf6e11d89c382fec2605351355d1e16a80f7b98f21af2ac6663d8b45",
"2571723": "0d40515d97e5b5185d055da4a3c8cb79a16f4e42dafda39b63729cc6698245ea"
}
},
"result": {
"atomical_id": "1809bfb8f69a1de200b5a5b2e96afef9f7417ee0772363c7a7cb6591eb1a9b8bi0",
"atomical_number": 743,
"atomical_ref": "304vze7pk8ey405nmpsejtqyz7vm2zq0ewhp7hx7sdjs3trtke5gi0",
"type": "FT",
"confirmed": true,
"mint_info": {
"commit_txid": "1809bfb8f69a1de200b5a5b2e96afef9f7417ee0772363c7a7cb6591eb1a9b8b",
"commit_index": 0,
"commit_location": "1809bfb8f69a1de200b5a5b2e96afef9f7417ee0772363c7a7cb6591eb1a9b8bi0",
"commit_tx_num": 68083224,
"commit_height": 2571712,
"reveal_location_txid": "8b40e05c14326ae372bf5f9f89e746446015376c25ab564d0b740468dd38af43",
"reveal_location_index": 0,
"reveal_location": "8b40e05c14326ae372bf5f9f89e746446015376c25ab564d0b740468dd38af43i0",
"reveal_location_tx_num": 68083235,
"reveal_location_height": 2571713,
"reveal_location_header": "000000202198b97559f21c7288e03792fbf8e680ffed5a76b381b5a41b00000000000000acc3d6e71f6b523152e1aba92d3e802af5318f4f71557e5b392bc2e82be7a035e53f9c65874b6e19473878fa",
"reveal_location_blockhash": "ba2dd3b0bb964ff88601e9367b8704ea9ba2fb54cc49e9253600000000000000",
"reveal_location_scripthash": "6e36ddc9ec7b7906c84eb9687f61d0d397d19488dce7830af4e673c697940893",
"reveal_location_script": "5120cef338caae67c64b2ec0865c7c997e74e0805f7c17fcad787b89acf5de28bbea",
"reveal_location_value": 546,
"args": {
"time": 1704738727,
"nonce": 6904474,
"bitworkc": "1809",
"max_mints": 499611,
"mint_amount": 777,
"mint_height": 0,
"mint_bitworkc": "aabbcc",
"request_ticker": "miratomicals-rac4"
},
"meta": {},
"ctx": {},
"$mint_bitworkc": "aabbcc",
"$request_ticker": "miratomicals-rac4",
"$bitwork": {
"bitworkc": "1809",
"bitworkr": null
},
"reveal_location_address": "tb1pemen3j4wvlryktkqsew8ext7wnsgqhmuzl7267rm3xk0th3gh04qr9wcec",
"blockheader_info": {
"version": 536870912,
"prevHash": "000000000000001ba4b581b3765aedff80e6f8fb9237e088721cf25975b99821",
"merkleRoot": "35a0e72be8c22b395b7e55714f8f31f52a803e2da9abe15231526b1fe7d6c3ac",
"timestamp": 1704738789,
"bits": 426658695,
"nonce": 4202182727
}
},
"subtype": "decentralized",
"$max_supply": 388197747,
"$mint_height": 0,
"$mint_amount": 777,
"$max_mints": 499611,
"$mint_bitworkc": "aabbcc",
"$bitwork": {
"bitworkc": "1809",
"bitworkr": null
},
"$ticker_candidates": [
{
"tx_num": 68083224,
"atomical_id": "1809bfb8f69a1de200b5a5b2e96afef9f7417ee0772363c7a7cb6591eb1a9b8bi0",
"txid": "1809bfb8f69a1de200b5a5b2e96afef9f7417ee0772363c7a7cb6591eb1a9b8b",
"commit_height": 2571712,
"reveal_location_height": 2571713
}
],
"$request_ticker_status": {
"status": "verified",
"verified_atomical_id": "1809bfb8f69a1de200b5a5b2e96afef9f7417ee0772363c7a7cb6591eb1a9b8bi0",
"note": "Successfully verified and claimed ticker for current Atomical"
},
"$request_ticker": "miratomicals-rac4",
"$ticker": "miratomicals-rac4",
"mint_data": {
"fields": {
"args": {
"time": 1704738727,
"nonce": 6904474,
"bitworkc": "1809",
"max_mints": 499611,
"mint_amount": 777,
"mint_height": 0,
"mint_bitworkc": "aabbcc",
"request_ticker": "miratomicals-rac4"
},
"name": "miratomicals-rac4",
"image": "atom:btc:dat:115b57d4c16cf28a05f5b637a9dc422d576e10fca5a69e47eb8024d7abd13c18i0/image.png",
"legal": {
"terms": "Free"
},
"links": {
"x": {
"v": "https://x.com/AurevoirXavier"
},
"website": {
"v": "https://github.com/hack-ink/miratomicals-rac"
}
}
}
}
}
}
yarn cli wallets --balances --noqr
yarn run v1.22.21
$ node dist/cli.js wallets --balances --noqr
walletPath ./wallets/wallet.json
walletInfo result {
success: true,
data: {
address: 'tb1pzvexmf6v30taky62fftyegejz8gtz3472e6rm4jmpswjjm0qq9hqe84j4h',
scripthash: 'c714c3997bce0afc410c50f2c8fd84347cc156f0072203f9ca1a40f98baafe0b',
atomicals_count: 1,
atomicals_utxos: [ [Object], [Object], [Object] ],
atomicals_balances: {
'1809bfb8f69a1de200b5a5b2e96afef9f7417ee0772363c7a7cb6591eb1a9b8bi0': [Object]
},
total_confirmed: 2331,
total_unconfirmed: 0,
atomicals_confirmed: 2331,
atomicals_unconfirmed: 0,
regular_confirmed: 0,
regular_unconfirmed: 0,
regular_utxos: [],
regular_utxo_count: 0,
history: undefined
}
}
To install from crates.io, use the following command:
cargo install miratomicals-racYou can download the pre-build binary from our GitHub release
To build from the source code, use the following commands:
git clone https://hack-ink/miratomicals-rac
cd miratomicals-rac
cargo build --release- Follow the installation steps for
miratomicals. - Run the following command:
miratomicals-rac --rust-engine <PATH to the atomicals-js's wallets folder> --fee-bound 50,150 --ticker quark
-
Where can I find the mining log?
You'll find the information in
stdout.logandstderr.log, which are located in the current working directory. -
How to setup multi-wallet?
To set up a multi-wallet, place the
*.jsonwallet files in theatomicals-js/walletsdirectory. -
How to use one stash address in multi-wallet mining?
Add a wallet with a
<NAME>under theimportedfield of youratomicals-js/wallets/x.jsonfile.Then, run the command
miratomicals-rac --stash <NAME> ...You
atomicals-js/wallets/x.jsonfile should looks like below:{ "phrase": "..", "primary": { "address": "..", "path": "m/86'/0'/0'/0/0", "WIF": ".." }, "funding": { "address": "..", "path": "m/86'/0'/0'/1/0", "WIF": ".." }, "imported": { "<NAME>": { "address": "..", "WIF": ".." } } } -
What are the differences of
average-firstandwallet-firstmining strategies?- The
average-firststrategy mines 12 times for each wallet in one loop. - The
wallet-firststrategy mines indefinitely, switching wallets until the current wallet has more than 12 unconfirmed transactions.
- The
- Update and rebuild
atomicals-jsautomatically. - Implement wallet balance detection.
- Implement a mining worker in pure Rust.