This guide will teach you how to create an on-chain fund for Spacecoin or tokens to be passed to an heir.

The heir module is available with Spacecoind or Spacecoin-QT.

Table of Contents

Please Note

The Heir module requires you to be using a pubkey. For more information see Pubkey Information.

With Spacecoin-QT the commands will need to be entered in the console. This is accessible at Help -> Debug Window -> Console.

Background Information

An heir fund allows an heir to gain spending access after a predetermined amount of inactivity.

Activity occurs when the owner adds more coins/tokens to the fund, and when coins/tokens are claimed (spent) from the fund.

You will need to fill in:

  • amount - the number of coins or tokens to put in the fund.

  • name - the name of the heir fund.

  • heirpubkey - the public key of the heir.

  • inactivity - the time in seconds until the fund becomes available to the heir.

  • memo - a store for arbitrary data; for example, this can hold a digital copy of a physical will or other relevant documents.

  • Optional - tokenid - the id of the token


  1. Navigate to spacecoin-cli or Console depending on your wallet.

  2. Enter the command: heirfund amount name heirpubkey inactivitytime memo (tokenid)

    Example: heirfund 3000 SonFunds 0347da1a89a90b0b62178abcb2f4d8c64b1ec3fee28c9350aa9ab48804e8455df5 473040000 'Spacecoin Funds for my son'

    This will return a hex-encoded transaction that needs to be broadcast to the network with sendrawtransaction.

  3. Enter the command sendrawtransaction hexFromHeirFund

    Example: sendrawtransaction 0400008085202f89018cc8564e8eab3c702731b319ca93863225b5f8feb3106a5ab5854791b589ae48010000006b483045022100aa4c5f97fdfa05402e26db6951bd9b7611a7022d1f0b555d4ed8ed75c465f5d00220217ce6dcbea90366845326453e242f4b95bea5f0184d32af8a3f43f385ae36d4012103f6f64dff7bc20d882b369f7bfbd63d423a09f8e908f441bef4f5b425727832e1ffffffff02005ed0b200000000302ea22c8020e029c511da55523565835887e412e5a0c9b920801b007000df45e545f25028248103120c008203000401ccf0c1a43500000000232103f6f64dff7bc20d882b369f7bfbd63d423a09f8e908f441bef4f5b425727832e1ac000000006e7301000000000000000000000000

    This returns a Transaction ID (txid). You can view this transaction on the explorer.