Ctrl+K

Fan Out Unspents

Overview

You can fan out unspents by taking a single unspent and splitting it into multiple smaller unspents. This is useful for creating unspents for multiple smaller transactions, especially if you have a high volume of transactions at once. Fanning out unspents can also help protect privacy, since it makes it more difficult for external observers to link the different transactions together, as occurs with dusting attacks. The opposite of fanning out unspents is to Consolidate Unspents.

Fanning-out transactions follow the normal transaction flow, requiring signatures, approvals, and sending, as outlined in Wallets Overview.

Prerequisites

Steps

  • SDK
  • Express
1
2
3
4
5
6
7
8
9
10
11
12
13
let params = {
  maxNumInputsToUse: 20,
  numUnspentsToMake: 200,
  minValue: 100000,
  maxValue: 47000000,
  minHeight: 1,
  minConfirms: 2,
  walletPassphrase: 'secretpassphrase1a5df8380e0e30',
};
wallet.fanoutUnspents(params).then(function (transactionInfo) {
  // print transaction info
  console.dir(transactionInfo);
});

Step Result

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
  "transfer": {
    "coin": "btc",
    "id": "59cd72485007a239fb00282ed480da1f",
    "wallet": "59cd72485007a239fb00282ed480da1f",
    "enterprise": "59cd72485007a239fb00282ed480da1f",
    "txid": "b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26",
    "height": 0,
    "heightId": "string",
    "date": "2019-08-24T14:15:22Z",
    "type": "send",
    "value": 0,
    "valueString": "string",
    "baseValue": 0,
    "baseValueString": "string",
    "feeString": "string",
    "payGoFee": 0,
    "payGoFeeString": "string",
    "usd": 0,
    "usdRate": 0,
    "state": "confirmed",
    "tags": [
      "59cd72485007a239fb00282ed480da1f"
    ],
    "history": [
      {
        "date": "2019-08-24T14:15:22Z",
        "user": "59cd72485007a239fb00282ed480da1f",
        "action": "created",
        "comment": "string"
      }
    ],
    "comment": "string",
    "vSize": 0,
    "nSegwitInputs": 0,
    "coinSpecific": {},
    "sequenceId": "string",
    "entries": [
      {
        "address": "2NAUwNgXaoFj2VVnSEvNLGuez8CfdU2UCMZ",
        "wallet": "string",
        "value": 0
      }
    ],
    "usersNotified": true
  },
  "txid": "string",
  "tx": "string",
  "status": "signed"
}

Next Steps

Sign Transactions

See Also

API Reference: Fan Out Unspents