We put our best effort into covering all topics related to Dimecoin. Each section will cover a different category. Not all documentation may be 100% accurate, if you spot an error, please report it or submit a PR request on GitHub.
REMINDER: This documentation is always evolving. If you have not been here for a while, perhaps check again. Things may have been added or updated since your last visit!
Simple Raw Transaction#
The raw transaction RPCs allow users to create custom transactions and delay broadcasting those transactions. However, mistakes made in raw transactions may not be detected by Dimecoin Core, and a number of raw transaction users have permanently lost large numbers of dimecoins, so please be careful using raw transactions on mainnet.
This subsection covers one of the simplest possible raw transactions.
Note
The following steps pick up where the Simple Spending Tutorial left off
1. List Unspent Outputs#
Re-rerun listunspent. We now have three UTXOs: the two transactions we created before plus the coinbase transaction from block #2. We save the TXID and output index number (vout) of that coinbase UTXO to shell variables.
DIME-cli -regtest listunspent
[
{
"txid": "2f1d5b0cacf3f530a425ffc4975e7422b24fb99384a9abf833c6468ea6375da9",
"vout": 0,
"address": "771nebQZnFDpk9zGktco7rqHRMxk8oFW6p",
"account": "",
"scriptPubKey": "76a9142b42a1f37842936a91633fc5747a86a0c37e49fc88ac",
"amount": 10.00000,
"confirmations": 1,
"ps_rounds": -2,
"spendable": true,
"solvable": true
},
{
"txid": "000000000005e2fe586372c983130f28d91b43e0af3244b12c4f5b7a9825bbeb",
"vout": 1,
"address": "79XNvF3vfEQm7GXficY4Nu4obyLGeZDDyD",
"scriptPubKey": "76a914a0411dbed3eab4341d5c41496d61b4fa1b22037e88ac",
"amount": 490.00000,
"confirmations": 1,
"ps_rounds": -2,
"spendable": true,
"solvable": true
},
{
"txid": "9036265a8f577421e556cd4f729752d73469953deea759de11efa9ba354936a8",
"vout": 0,
"address": "7KEfCcJ2cMkSb25xpJP8bVUXd8xffoWWb2",
"scriptPubKey": "21023fff9c9dc9088c0aeba90d75413705091111311d761054de23ac\
dd217450869aac",
"amount": 500.00000,
"confirmations": 101,
"ps_rounds": -2,
"spendable": true,
"solvable": true
}
]
> UTXO_TXID=9036265a8f577421e556cd4f729752d73469953deea759de11ef[...]
> UTXO_VOUT=0
2. Get New Address#
DIME-cli -regtest getnewaddress
7KEfCcJ2cMkSb25xpJP8bVUXd8xffoWWb2
> NEW_ADDRESS=7KEfCcJ2cMkSb25xpJP8bVUXd8xffoWWb2
3. Create Raw Transaction#
Using two arguments to the createrawtransaction RPC, we create a new raw format transaction. The first argument (a JSON array) references the txid of the coinbase transaction from block #2 and the index number (0) of the output from that transaction we want to spend. The second argument (a JSON object) creates the output with the address ( public key hash) and number of DIME we want to transfer. We save the resulting raw format transaction to a shell variable.
Warning
createrawtransaction does not automatically create change outputs, so you can easily accidentally pay a large transaction fee.
In this example, our input had 500.00000 DIME and our output ($NEW_ADDRESS) is being paid 499.9999 DIME, so the transaction will include a fee of 0.0001 DIME. If we had paid $NEW_ADDRESS only 100 DIME with no other changes to this transaction, the transaction fee would be a whopping 400 DIME. See the Complex Raw Transaction subsection below for how to create a transaction with multiple outputs so you can send the change back to yourself.
### Outputs - inputs = transaction fee, so always double-check your math!
DIME-cli -regtest createrawtransaction ''' \
[ \
{ \
"txid": "'$UTXO_TXID'", \
"vout": '$UTXO_VOUT' \
} \
] \
''' ''' \
{ \
"'$NEW_ADDRESS'": 499.9999 \
}'''
0100000001a8364935baa9ef11de59a7ee3d956934d75297724fcd56e5217457\
8f5a2636900000000000ffffffff01f04c3ba40b0000001976a914d240140859\
744755d73e5967081c3bedceffc5db88ac00000000
> RAW_TX=0100000001a8364935baa9ef11de59a7ee3d956934d75297724fcd5[...]
4. Decode Raw Transaction#
Use the decoderawtransaction RPC to see exactly what the transaction we just created does.
DIME-cli -regtest decoderawtransaction $RAW_TX
{
"txid": "7cbd2245ee5d824c00fc08b3bf2f694ad9a215d38d897fcf2df64a43c59bb97b",
"size": 85,
"version": 1,
"locktime": 0,
"vin": [
{
"txid": "9036265a8f577421e556cd4f729752d73469953deea759de11efa9ba354936a8",
"vout": 0,
"scriptSig": {
"asm": "",
"hex": ""
},
"sequence": 4294967295
}
],
"vout": [
{
"value": 499.99990000,
"valueSat": 49999990000,
"n": 0,
"scriptPubKey": {
"asm": "OP_DUP OP_HASH160 d240140859744755d73e5967081c3bedceffc5db\
OP_EQUALVERIFY OP_CHECKSIG",
"hex": "76a914d240140859744755d73e5967081c3bedceffc5db88ac",
"reqSigs": 1,
"type": "pubkeyhash",
"addresses": [
"7KEfCcJ2cMkSb25xpJP8bVUXd8xffoWWb2"
]
}
}
]
}
5. Sign Transaction#
Use the signrawtransactionwithwallet RPC to sign the transaction created by createrawtransaction and save the returned “hex” raw format signed transaction to a shell variable.
DIME-cli -regtest signrawtransactionwithwallet $RAW_TX
{
"hex": "0100000001a8364935baa9ef11de59a7ee3d956934d75297724fcd\
56e52174578f5a2636900000000049483045022100b4e5e9224afa\
de8686bb22a957d1ec1587a66ee84943761b2d9061d5f751cd7602\
203c88d4064641a413ce3d0824264d6d87908960487afe9a3a133e\
7d67a22fd05101ffffffff01f04c3ba40b0000001976a914d24014\
0859744755d73e5967081c3bedceffc5db88ac00000000",
"complete": true
}
> SIGNED_RAW_TX=0100000001a8364935baa9ef11de59a7ee3d956934d75297[...]
Even though the transaction is now complete, the Dimecoin Core node we’re connected to doesn’t know anything about the transaction, nor does any other part of the network. We’ve created a spend, but we haven’t actually spent anything because we could simply unset the $SIGNED_RAW_TX variable to eliminate the transaction.
6. Send raw transaction#
Send the signed transaction to the connected node using the sendrawtransaction RPC. After accepting the transaction, the node would usually then broadcast it to other peers, but we’re not currently connected to other peers because we started in regression test mode.
DIME-cli -regtest sendrawtransaction $SIGNED_RAW_TX
fa0f4105b0a2b2706d65581c5e6411d3970253c7f231944fa2f978b4a3d9010d
7. Mine a Block#
Generate a block to confirm the transaction and then clear our shell variables.
DIME-cli -regtest generate 1
unset UTXO_TXID UTXO_VOUT NEW_ADDRESS RAW_TX SIGNED_RAW_TX