goal account

goal account

Create and manage Algorand accounts

Synopsis

Collection of commands to support the creation and management of accounts / wallets tied to a specific Algorand node instance

goal account [flags]

Options

  -f, --default string   Set the account with this name to be the default account
  -h, --help             help for account
  -w, --wallet string    Set the wallet to be used for the selected operation

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd

Commands

goal account addpartkey

Generate a participation key for the specified account

Synopsis

Generate a participation key for the specified account

goal account addpartkey [flags]

Options

  -a, --address string         Account to associate with the generated partkey
  -h, --help                   help for addpartkey
      --keyDilution uint       Key dilution for two-level participation keys
  -o, --outdir string          Save participation key file to specified output directory to (for offline creation)
      --roundFirstValid uint   The first round for which the generated partkey will be valid
      --roundLastValid uint    The last round for which the generated partkey will be valid

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account balance

Retrieve the balance for the specified account

Synopsis

Retrieve the balance for the specified account

goal account balance [flags]

Options

  -a, --address string   Account address to retrieve balance (required)
  -h, --help             help for balance

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account changeonlinestatus

Change online status for the specified account

Synopsis

Change online status for the specified account. Set online should be 1 to set online, 0 to set offline. Make sure to use the -o=1 syntax. The broadcast transaction will be valid for a limited number of rounds. goal will provide the TXID of the transaction if successful. Going online requires that the given account have a valid participation key. Additionally when this transaction is submitted there is a 320 round delay before the account will actually go online or offline. The status of the account may show the status change immediately.

goal account changeonlinestatus [flags]

Options

  -a, --address string     Account address to change (required)
  -f, --fee uint           The Fee to set on the status change transaction (defaults to suggested fee)
      --firstRound uint    FirstValid for the status change transaction (0 for current)
  -h, --help               help for changeonlinestatus
  -N, --no-wait            Don't wait for transaction to commit
  -o, --online             Set this account to online or offline (default true, set using -o=(1|0/true|false))
  -t, --txfile string      Write status change transaction to this file
  -v, --validRounds uint   The validity period for the status change transaction

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account delete

Delete an account

Synopsis

Delete an account

goal account delete [flags]

Options

  -a, --addr string   Address of account to delete
  -h, --help          help for delete

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account export

Export an account

Synopsis

Export an account mnemonic seed, for use with account import. This exports the seed for a single account and should not be confused with the wallet mnemonic.

goal account export [flags]

Options

  -a, --addr string   Address of account to export
  -h, --help          help for delete

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account import

Import an account key from a mnemonic generated by the export command, SDKs or by algokey (NOT a mnemonic from the goal wallet command). The imported account will be listed alongside your wallet-generated accounts, but will not be tied to your wallet. It is important to note that if you import a key into a wallet, it can not be recovered using the wallet mnemonic, like accounts created using the wallet (ie goal account new -w mywallet). Be sure to keep your account mnemonic in case you have to recover the account.

Synopsis

Import an account key from mnemonic

goal account import [flags]

Options

  -f, --default           Set this account as the default one
  -h, --help              help for import
  -m, --mnemonic string   Mnemonic to import (will prompt otherwise)

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account importrootkey

Import .rootkey files from the data directory into a kmd wallet. This is analogous to using the import command with an account seed mnemonic: the imported account will be displayed alongside your wallet-derived accounts, but will not be tied to your wallet mnemonic. It is important to note that if you import a key into a wallet, it can not be recovered using the wallet mnemonic, like accounts created using the wallet (ie goal account new -w mywallet). Be sure to keep your account mnemonic in case you have to recover the account.

Synopsis

Import a .rootkey file into the default wallet

goal account importrootkey [flags]

Options

  -h, --help                 help for importrootkey
  -u, --unencrypted-wallet   Import into the default unencrypted wallet, potentially creating it

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account list

Show the list of Algorand accounts on this machine.

Synopsis

Show the list of Algorand accounts on this machine. Also indicates whether the account is [offline] or [online], and if the account is the default account for goal.

goal account list [flags]

Options

  -h, --help   help for list

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account listpartkeys

List participation keys

Synopsis

List participations keys

goal account listpartkeys [flags]

Options

  -h, --help   help for listpartkeys

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account multisig

Control and manage multisig accounts

Synopsis

Control and manage multisig accounts

  goal account multisig [flags]
  goal account multisig [command]

Options

  -h, --help   help for multisig

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

Commands

goal account multisig delete

Delete a multisig account

Synopsis

Delete a multisig account

goal account multisig delete [flags]

Options

  -a, --addr string   Address of multisig account to delete
  -h, --help          help for delete

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account multisig info

Print information about a multisig account

Synopsis

Print information about a multisig account

goal account multisig info [flags]

Options

  -a, --addr string   Address of multisig account to look up
  -h, --help          help for info

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account multisig new

Create a new multisig account from a list of existing non-multisig addresses

Synopsis

Create a new multisig account from a list of existing non-multisig addresses

goal account multisig new [addr1 addr2 ...] [flags]

Options

  -h, --help              help for new
  -T, --threshold uint8   Number of signatures required to spend from this address (default 1)

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account new

Create a new account

Synopsis

Coordinates the creation of a new account with KMD. The name specified here is stored in a local configuration file and is only used by goal when working against that specific node instance

goal account new [flags]

Options

  -f, --default   Set this account as the default one
  -h, --help      help for new

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account partkeyinfo

Output details about all available part keys

Synopsis

Output details about all available participation keys

goal account partkeyinfo [flags]

Options

  -h, --help                  help for partkeyinfo

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account rename

Change the human-friendly name of an account

Synopsis

Change the human-friendly name of an account

goal account rename [old name] [new name] [flags]

Options

  -h, --help   help for rename

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account renewallpartkeys

Renew all existing participation keys

Synopsis

Generate new participation keys for all existing accounts with participation keys and register them

goal account renewallpartkeys [flags]

Options

  -f, --fee uint              The Fee to set on the status change transactions (defaults to suggested fee)
  -h, --help                  help for renewallpartkeys
      --keyDilution uint      Key dilution for two-level participation keys
  -N, --no-wait               Don't wait for transaction to commit
      --roundLastValid uint   The last round for which the generated partkeys will be valid

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account renewpartkey

Renew an account's participation key

Synopsis

Renew an account's participation key

goal account renewpartkey [flags]

Options

  -a, --address string        Account address to update (required)
  -f, --fee uint              The Fee to set on the status change transaction (defaults to suggested fee)
  -h, --help                  help for renewpartkey
      --keyDilution uint      Key dilution for two-level participation keys
  -N, --no-wait               Don't wait for transaction to commit
      --roundLastValid uint   The last round for which the generated partkey will be valid

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation

goal account rewards

Retrieve the rewards for the specified account

Synopsis

Retrieve the rewards for the specified account

goal account rewards [flags]

Options

  -a, --address string   Account address to retrieve rewards (required)
  -h, --help             help for rewards

Options inherited from parent commands

  -d, --datadir stringArray   Data directory for the node
  -k, --kmddir string         Data directory for kmd
  -w, --wallet string         Set the wallet to be used for the selected operation