lotus/documentation/en/cli-lotus.md

2789 lines
65 KiB
Markdown
Raw Normal View History

2021-04-29 17:45:01 +00:00
# lotus
```
NAME:
lotus - Filecoin decentralized storage network client
USAGE:
lotus [global options] command [command options] [arguments...]
VERSION:
2021-04-30 09:18:15 +00:00
1.11.0-dev
2021-04-29 17:45:01 +00:00
COMMANDS:
daemon Start a lotus daemon process
backup Create node metadata backup
version Print version
help, h Shows a list of commands or help for one command
BASIC:
2021-04-28 23:24:09 +00:00
send Send funds between accounts
wallet Manage wallet
client Make deals, store data, retrieve data
msig Interact with a multisig wallet
verifreg Interact with the verified registry actor
paych Manage payment channels
2021-04-29 17:45:01 +00:00
DEVELOPER:
auth Manage RPC permissions
mpool Manage message pool
state Interact with and query filecoin chain state
chain Interact with filecoin blockchain
log Manage logging
wait-api Wait for lotus api to come online
fetch-params Fetch proving parameters
NETWORK:
net Manage P2P Network
sync Inspect or interact with the chain syncer
STATUS:
status Check node status
2021-04-29 17:45:01 +00:00
GLOBAL OPTIONS:
--interactive setting to false will disable interactive functionality of commands (default: false)
--force-send if true, will ignore pre-send checks (default: false)
2021-04-29 17:45:01 +00:00
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
## lotus daemon
```
NAME:
lotus daemon - Start a lotus daemon process
USAGE:
lotus daemon command [command options] [arguments...]
COMMANDS:
stop Stop a running lotus daemon
help, h Shows a list of commands or help for one command
OPTIONS:
--api value (default: "1234")
--genesis value genesis file to use for first node run
--bootstrap (default: true)
--import-chain value on first run, load chain from given file or url and validate
--import-snapshot value import chain state from a given chain export file or url
--halt-after-import halt the process after importing chain from file (default: false)
--pprof value specify name of file for writing cpu profile to
--profile value specify type of node
--manage-fdlimit manage open file limit (default: true)
--config value specify path of config file to use
--api-max-req-size value maximum API request size accepted by the JSON RPC server (default: 0)
--restore value restore from backup file
--restore-config value config file to use when restoring from backup
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus daemon stop
```
NAME:
lotus daemon stop - Stop a running lotus daemon
USAGE:
lotus daemon stop [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
## lotus backup
```
NAME:
lotus backup - Create node metadata backup
USAGE:
lotus backup [command options] [backup file path]
DESCRIPTION:
The backup command writes a copy of node metadata under the specified path
Online backups:
For security reasons, the daemon must be have LOTUS_BACKUP_BASE_PATH env var set
to a path where backup files are supposed to be saved, and the path specified in
this command must be within this base path
OPTIONS:
--offline create backup without the node running (default: false)
--help, -h show help (default: false)
```
## lotus version
```
NAME:
lotus version - Print version
USAGE:
lotus version [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
## lotus send
```
NAME:
lotus send - Send funds between accounts
USAGE:
lotus send [command options] [targetAddress] [amount]
CATEGORY:
BASIC
OPTIONS:
--from value optionally specify the account to send funds from
--gas-premium value specify gas price to use in AttoFIL (default: "0")
--gas-feecap value specify gas fee cap to use in AttoFIL (default: "0")
--gas-limit value specify gas limit (default: 0)
--nonce value specify the nonce to use (default: 0)
--method value specify method to invoke (default: 0)
--params-json value specify invocation parameters in json
--params-hex value specify invocation parameters in hex
--force Deprecated: use global 'force-send' (default: false)
2021-04-29 17:45:01 +00:00
--help, -h show help (default: false)
```
## lotus wallet
```
NAME:
lotus wallet - Manage wallet
USAGE:
lotus wallet command [command options] [arguments...]
COMMANDS:
new Generate a new key of the given type
list List wallet address
balance Get account balance
export export keys
import import keys
default Get default wallet address
set-default Set default wallet address
sign sign a message
verify verify the signature of a message
delete Delete an account from the wallet
market Interact with market balances
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus wallet new
```
NAME:
lotus wallet new - Generate a new key of the given type
USAGE:
lotus wallet new [command options] [bls|secp256k1 (default secp256k1)]
OPTIONS:
--help, -h show help (default: false)
```
### lotus wallet list
```
NAME:
lotus wallet list - List wallet address
USAGE:
lotus wallet list [command options] [arguments...]
OPTIONS:
--addr-only, -a Only print addresses (default: false)
--id, -i Output ID addresses (default: false)
--market, -m Output market balances (default: false)
--help, -h show help (default: false)
```
### lotus wallet balance
```
NAME:
lotus wallet balance - Get account balance
USAGE:
lotus wallet balance [command options] [address]
OPTIONS:
--help, -h show help (default: false)
```
### lotus wallet export
```
NAME:
lotus wallet export - export keys
USAGE:
lotus wallet export [command options] [address]
OPTIONS:
--help, -h show help (default: false)
```
### lotus wallet import
```
NAME:
lotus wallet import - import keys
USAGE:
lotus wallet import [command options] [<path> (optional, will read from stdin if omitted)]
OPTIONS:
--format value specify input format for key (default: "hex-lotus")
--as-default import the given key as your new default key (default: false)
--help, -h show help (default: false)
```
### lotus wallet default
```
NAME:
lotus wallet default - Get default wallet address
USAGE:
lotus wallet default [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus wallet set-default
```
NAME:
lotus wallet set-default - Set default wallet address
USAGE:
lotus wallet set-default [command options] [address]
OPTIONS:
--help, -h show help (default: false)
```
### lotus wallet sign
```
NAME:
lotus wallet sign - sign a message
USAGE:
lotus wallet sign [command options] <signing address> <hexMessage>
OPTIONS:
--help, -h show help (default: false)
```
### lotus wallet verify
```
NAME:
lotus wallet verify - verify the signature of a message
USAGE:
lotus wallet verify [command options] <signing address> <hexMessage> <signature>
OPTIONS:
--help, -h show help (default: false)
```
### lotus wallet delete
```
NAME:
lotus wallet delete - Delete an account from the wallet
USAGE:
lotus wallet delete [command options] <address>
OPTIONS:
--help, -h show help (default: false)
```
### lotus wallet market
```
NAME:
lotus wallet market - Interact with market balances
USAGE:
lotus wallet market command [command options] [arguments...]
COMMANDS:
withdraw Withdraw funds from the Storage Market Actor
add Add funds to the Storage Market Actor
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
#### lotus wallet market withdraw
```
NAME:
lotus wallet market withdraw - Withdraw funds from the Storage Market Actor
USAGE:
lotus wallet market withdraw [command options] [amount (FIL) optional, otherwise will withdraw max available]
OPTIONS:
--wallet value, -w value Specify address to withdraw funds to, otherwise it will use the default wallet address
--address value, -a value Market address to withdraw from (account or miner actor address, defaults to --wallet address)
--help, -h show help (default: false)
```
#### lotus wallet market add
```
NAME:
lotus wallet market add - Add funds to the Storage Market Actor
USAGE:
lotus wallet market add [command options] <amount>
OPTIONS:
--from value, -f value Specify address to move funds from, otherwise it will use the default wallet address
--address value, -a value Market address to move funds to (account or miner actor address, defaults to --from address)
--help, -h show help (default: false)
```
## lotus client
```
NAME:
lotus client - Make deals, store data, retrieve data
USAGE:
lotus client command [command options] [arguments...]
COMMANDS:
help, h Shows a list of commands or help for one command
DATA:
import Import data
drop Remove import
local List locally imported data
stat Print information about a locally stored file (piece size, etc)
RETRIEVAL:
find Find data in the network
retrieve Retrieve data from network
cancel-retrieval Cancel a retrieval deal by deal ID; this also cancels the associated transfer
STORAGE:
deal Initialize storage deal with a miner
query-ask Find a miners ask
list-deals List storage market deals
get-deal Print detailed deal information
list-asks List asks for top miners
deal-stats Print statistics about local storage deals
inspect-deal Inspect detailed information about deal's lifecycle and the various stages it goes through
UTIL:
commP Calculate the piece-cid (commP) of a CAR file
generate-car Generate a car file from input
balances Print storage market client balances
list-transfers List ongoing data transfers for deals
restart-transfer Force restart a stalled data transfer
cancel-transfer Force cancel a data transfer
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus client import
```
NAME:
lotus client import - Import data
USAGE:
lotus client import [command options] [inputPath]
CATEGORY:
DATA
OPTIONS:
--car import from a car file instead of a regular file (default: false)
--quiet, -q Output root CID only (default: false)
--help, -h show help (default: false)
```
### lotus client drop
```
NAME:
lotus client drop - Remove import
USAGE:
lotus client drop [command options] [import ID...]
CATEGORY:
DATA
OPTIONS:
--help, -h show help (default: false)
```
### lotus client local
```
NAME:
lotus client local - List locally imported data
USAGE:
lotus client local [command options] [arguments...]
CATEGORY:
DATA
OPTIONS:
--help, -h show help (default: false)
```
### lotus client stat
```
NAME:
lotus client stat - Print information about a locally stored file (piece size, etc)
USAGE:
lotus client stat [command options] <cid>
CATEGORY:
DATA
OPTIONS:
--help, -h show help (default: false)
```
### lotus client find
```
NAME:
lotus client find - Find data in the network
USAGE:
lotus client find [command options] [dataCid]
CATEGORY:
RETRIEVAL
OPTIONS:
--pieceCid value require data to be retrieved from a specific Piece CID
--help, -h show help (default: false)
```
### lotus client retrieve
```
NAME:
lotus client retrieve - Retrieve data from network
USAGE:
lotus client retrieve [command options] [dataCid outputPath]
CATEGORY:
RETRIEVAL
OPTIONS:
--from value address to send transactions from
--car export to a car file instead of a regular file (default: false)
--miner value miner address for retrieval, if not present it'll use local discovery
--maxPrice value maximum price the client is willing to consider (default: 0.01 FIL)
--pieceCid value require data to be retrieved from a specific Piece CID
--allow-local (default: false)
--help, -h show help (default: false)
```
### lotus client cancel-retrieval
```
NAME:
lotus client cancel-retrieval - Cancel a retrieval deal by deal ID; this also cancels the associated transfer
USAGE:
lotus client cancel-retrieval [command options] [arguments...]
CATEGORY:
RETRIEVAL
OPTIONS:
--deal-id value specify retrieval deal by deal ID (default: 0)
--help, -h show help (default: false)
```
### lotus client deal
```
NAME:
lotus client deal - Initialize storage deal with a miner
USAGE:
lotus client deal [command options] [dataCid miner price duration]
CATEGORY:
STORAGE
DESCRIPTION:
Make a deal with a miner.
dataCid comes from running 'lotus client import'.
miner is the address of the miner you wish to make a deal with.
price is measured in FIL/GB/Epoch. Miners usually don't accept a bid
lower than their advertised ask. You can check a miners listed price
with 'lotus client query-ask <miner address>'.
duration is how long the miner should store the data for, in blocks.
The minimum value is 518400 (6 months).
OPTIONS:
--manual-piece-cid value manually specify piece commitment for data (dataCid must be to a car file)
--manual-piece-size value if manually specifying piece cid, used to specify size (dataCid must be to a car file) (default: 0)
--manual-stateless-deal instructs the node to send an offline deal without registering it with the deallist/fsm (default: false)
2021-04-29 17:45:01 +00:00
--from value specify address to fund the deal with
--start-epoch value specify the epoch that the deal should start at (default: -1)
--fast-retrieval indicates that data should be available for fast retrieval (default: true)
--verified-deal indicate that the deal counts towards verified client total (default: true if client is verified, false otherwise)
--provider-collateral value specify the requested provider collateral the miner should put up
--help, -h show help (default: false)
```
### lotus client query-ask
```
NAME:
lotus client query-ask - Find a miners ask
USAGE:
lotus client query-ask [command options] [minerAddress]
CATEGORY:
STORAGE
OPTIONS:
--peerid value specify peer ID of node to make query against
--size value data size in bytes (default: 0)
--duration value deal duration (default: 0)
--help, -h show help (default: false)
```
### lotus client list-deals
```
NAME:
lotus client list-deals - List storage market deals
USAGE:
lotus client list-deals [command options] [arguments...]
CATEGORY:
STORAGE
OPTIONS:
--verbose, -v print verbose deal details (default: false)
--color use color in display output (default: true)
--show-failed show failed/failing deals (default: false)
--watch watch deal updates in real-time, rather than a one time list (default: false)
--help, -h show help (default: false)
```
### lotus client get-deal
```
NAME:
lotus client get-deal - Print detailed deal information
USAGE:
lotus client get-deal [command options] [arguments...]
CATEGORY:
STORAGE
OPTIONS:
--help, -h show help (default: false)
```
### lotus client list-asks
```
NAME:
lotus client list-asks - List asks for top miners
USAGE:
lotus client list-asks [command options] [arguments...]
CATEGORY:
STORAGE
OPTIONS:
2021-04-30 15:59:01 +00:00
--by-ping sort by ping (default: false)
2021-04-29 17:45:01 +00:00
--output-format value Either 'text' or 'csv' (default: "text")
--help, -h show help (default: false)
```
### lotus client deal-stats
```
NAME:
lotus client deal-stats - Print statistics about local storage deals
USAGE:
lotus client deal-stats [command options] [arguments...]
CATEGORY:
STORAGE
OPTIONS:
--newer-than value (default: 0s)
--help, -h show help (default: false)
```
### lotus client inspect-deal
```
NAME:
lotus client inspect-deal - Inspect detailed information about deal's lifecycle and the various stages it goes through
USAGE:
lotus client inspect-deal [command options] [arguments...]
CATEGORY:
STORAGE
OPTIONS:
--deal-id value (default: 0)
--proposal-cid value
--help, -h show help (default: false)
```
### lotus client commP
```
NAME:
lotus client commP - Calculate the piece-cid (commP) of a CAR file
USAGE:
lotus client commP [command options] [inputFile]
CATEGORY:
UTIL
OPTIONS:
--help, -h show help (default: false)
```
### lotus client generate-car
```
NAME:
lotus client generate-car - Generate a car file from input
USAGE:
lotus client generate-car [command options] [inputPath outputPath]
CATEGORY:
UTIL
OPTIONS:
--help, -h show help (default: false)
```
### lotus client balances
```
NAME:
lotus client balances - Print storage market client balances
USAGE:
lotus client balances [command options] [arguments...]
CATEGORY:
UTIL
OPTIONS:
--client value specify storage client address
--help, -h show help (default: false)
```
### lotus client list-transfers
```
NAME:
lotus client list-transfers - List ongoing data transfers for deals
USAGE:
lotus client list-transfers [command options] [arguments...]
CATEGORY:
UTIL
OPTIONS:
--verbose, -v print verbose transfer details (default: false)
--color use color in display output (default: true)
--completed show completed data transfers (default: false)
--watch watch deal updates in real-time, rather than a one time list (default: false)
--show-failed show failed/cancelled transfers (default: false)
--help, -h show help (default: false)
```
### lotus client restart-transfer
```
NAME:
lotus client restart-transfer - Force restart a stalled data transfer
USAGE:
lotus client restart-transfer [command options] [arguments...]
CATEGORY:
UTIL
OPTIONS:
--peerid value narrow to transfer with specific peer
--initiator specify only transfers where peer is/is not initiator (default: true)
--help, -h show help (default: false)
```
### lotus client cancel-transfer
```
NAME:
lotus client cancel-transfer - Force cancel a data transfer
USAGE:
lotus client cancel-transfer [command options] [arguments...]
CATEGORY:
UTIL
OPTIONS:
--peerid value narrow to transfer with specific peer
--initiator specify only transfers where peer is/is not initiator (default: true)
--cancel-timeout value time to wait for cancel to be sent to storage provider (default: 5s)
--help, -h show help (default: false)
```
## lotus msig
```
NAME:
lotus msig - Interact with a multisig wallet
USAGE:
lotus msig command [command options] [arguments...]
COMMANDS:
create Create a new multisig wallet
inspect Inspect a multisig wallet
propose Propose a multisig transaction
propose-remove Propose to remove a signer
approve Approve a multisig message
add-propose Propose to add a signer
add-approve Approve a message to add a signer
add-cancel Cancel a message to add a signer
swap-propose Propose to swap signers
swap-approve Approve a message to swap signers
swap-cancel Cancel a message to swap signers
lock-propose Propose to lock up some balance
lock-approve Approve a message to lock up some balance
lock-cancel Cancel a message to lock up some balance
vested Gets the amount vested in an msig between two epochs
propose-threshold Propose setting a different signing threshold on the account
help, h Shows a list of commands or help for one command
OPTIONS:
--confidence value number of block confirmations to wait for (default: 5)
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus msig create
```
NAME:
lotus msig create - Create a new multisig wallet
USAGE:
lotus msig create [command options] [address1 address2 ...]
OPTIONS:
--required value number of required approvals (uses number of signers provided if omitted) (default: 0)
--value value initial funds to give to multisig (default: "0")
--duration value length of the period over which funds unlock (default: "0")
--from value account to send the create message from
--help, -h show help (default: false)
```
### lotus msig inspect
```
NAME:
lotus msig inspect - Inspect a multisig wallet
USAGE:
lotus msig inspect [command options] [address]
OPTIONS:
--vesting Include vesting details (default: false)
--decode-params Decode parameters of transaction proposals (default: false)
--help, -h show help (default: false)
```
### lotus msig propose
```
NAME:
lotus msig propose - Propose a multisig transaction
USAGE:
lotus msig propose [command options] [multisigAddress destinationAddress value <methodId methodParams> (optional)]
OPTIONS:
--from value account to send the propose message from
--help, -h show help (default: false)
```
### lotus msig propose-remove
```
NAME:
lotus msig propose-remove - Propose to remove a signer
USAGE:
lotus msig propose-remove [command options] [multisigAddress signer]
OPTIONS:
--decrease-threshold whether the number of required signers should be decreased (default: false)
--from value account to send the propose message from
--help, -h show help (default: false)
```
### lotus msig approve
```
NAME:
lotus msig approve - Approve a multisig message
USAGE:
lotus msig approve [command options] <multisigAddress messageId> [proposerAddress destination value [methodId methodParams]]
OPTIONS:
--from value account to send the approve message from
--help, -h show help (default: false)
```
### lotus msig add-propose
```
NAME:
lotus msig add-propose - Propose to add a signer
USAGE:
lotus msig add-propose [command options] [multisigAddress signer]
OPTIONS:
--increase-threshold whether the number of required signers should be increased (default: false)
--from value account to send the propose message from
--help, -h show help (default: false)
```
### lotus msig add-approve
```
NAME:
lotus msig add-approve - Approve a message to add a signer
USAGE:
lotus msig add-approve [command options] [multisigAddress proposerAddress txId newAddress increaseThreshold]
OPTIONS:
--from value account to send the approve message from
--help, -h show help (default: false)
```
### lotus msig add-cancel
```
NAME:
lotus msig add-cancel - Cancel a message to add a signer
USAGE:
lotus msig add-cancel [command options] [multisigAddress txId newAddress increaseThreshold]
OPTIONS:
--from value account to send the approve message from
--help, -h show help (default: false)
```
### lotus msig swap-propose
```
NAME:
lotus msig swap-propose - Propose to swap signers
USAGE:
lotus msig swap-propose [command options] [multisigAddress oldAddress newAddress]
OPTIONS:
--from value account to send the approve message from
--help, -h show help (default: false)
```
### lotus msig swap-approve
```
NAME:
lotus msig swap-approve - Approve a message to swap signers
USAGE:
lotus msig swap-approve [command options] [multisigAddress proposerAddress txId oldAddress newAddress]
OPTIONS:
--from value account to send the approve message from
--help, -h show help (default: false)
```
### lotus msig swap-cancel
```
NAME:
lotus msig swap-cancel - Cancel a message to swap signers
USAGE:
lotus msig swap-cancel [command options] [multisigAddress txId oldAddress newAddress]
OPTIONS:
--from value account to send the approve message from
--help, -h show help (default: false)
```
### lotus msig lock-propose
```
NAME:
lotus msig lock-propose - Propose to lock up some balance
USAGE:
lotus msig lock-propose [command options] [multisigAddress startEpoch unlockDuration amount]
OPTIONS:
--from value account to send the propose message from
--help, -h show help (default: false)
```
### lotus msig lock-approve
```
NAME:
lotus msig lock-approve - Approve a message to lock up some balance
USAGE:
lotus msig lock-approve [command options] [multisigAddress proposerAddress txId startEpoch unlockDuration amount]
OPTIONS:
--from value account to send the approve message from
--help, -h show help (default: false)
```
### lotus msig lock-cancel
```
NAME:
lotus msig lock-cancel - Cancel a message to lock up some balance
USAGE:
lotus msig lock-cancel [command options] [multisigAddress txId startEpoch unlockDuration amount]
OPTIONS:
--from value account to send the cancel message from
--help, -h show help (default: false)
```
### lotus msig vested
```
NAME:
lotus msig vested - Gets the amount vested in an msig between two epochs
USAGE:
lotus msig vested [command options] [multisigAddress]
OPTIONS:
--start-epoch value start epoch to measure vesting from (default: 0)
--end-epoch value end epoch to stop measure vesting at (default: -1)
--help, -h show help (default: false)
```
### lotus msig propose-threshold
```
NAME:
lotus msig propose-threshold - Propose setting a different signing threshold on the account
USAGE:
lotus msig propose-threshold [command options] <multisigAddress newM>
OPTIONS:
--from value account to send the proposal from
--help, -h show help (default: false)
```
2021-04-28 23:24:09 +00:00
## lotus verifreg
```
NAME:
lotus verifreg - Interact with the verified registry actor
USAGE:
lotus verifreg command [command options] [arguments...]
COMMANDS:
verify-client give allowance to the specified verified client address
list-verifiers list all verifiers
list-clients list all verified clients
check-client check verified client remaining bytes
check-verifier check verifiers remaining bytes
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus verifreg verify-client
```
NAME:
lotus verifreg verify-client - give allowance to the specified verified client address
USAGE:
lotus verifreg verify-client [command options] [arguments...]
OPTIONS:
--from value specify your verifier address to send the message from
--help, -h show help (default: false)
```
### lotus verifreg list-verifiers
```
NAME:
lotus verifreg list-verifiers - list all verifiers
USAGE:
lotus verifreg list-verifiers [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus verifreg list-clients
```
NAME:
lotus verifreg list-clients - list all verified clients
USAGE:
lotus verifreg list-clients [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus verifreg check-client
```
NAME:
lotus verifreg check-client - check verified client remaining bytes
USAGE:
lotus verifreg check-client [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus verifreg check-verifier
```
NAME:
lotus verifreg check-verifier - check verifiers remaining bytes
USAGE:
lotus verifreg check-verifier [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
2021-04-29 17:45:01 +00:00
## lotus paych
```
NAME:
lotus paych - Manage payment channels
USAGE:
lotus paych command [command options] [arguments...]
COMMANDS:
add-funds Add funds to the payment channel between fromAddress and toAddress. Creates the payment channel if it doesn't already exist.
list List all locally registered payment channels
voucher Interact with payment channel vouchers
settle Settle a payment channel
status Show the status of an outbound payment channel
status-by-from-to Show the status of an active outbound payment channel by from/to addresses
collect Collect funds for a payment channel
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus paych add-funds
```
NAME:
lotus paych add-funds - Add funds to the payment channel between fromAddress and toAddress. Creates the payment channel if it doesn't already exist.
USAGE:
lotus paych add-funds [command options] [fromAddress toAddress amount]
OPTIONS:
--restart-retrievals restart stalled retrieval deals on this payment channel (default: true)
--help, -h show help (default: false)
```
### lotus paych list
```
NAME:
lotus paych list - List all locally registered payment channels
USAGE:
lotus paych list [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus paych voucher
```
NAME:
lotus paych voucher - Interact with payment channel vouchers
USAGE:
lotus paych voucher command [command options] [arguments...]
COMMANDS:
create Create a signed payment channel voucher
check Check validity of payment channel voucher
add Add payment channel voucher to local datastore
list List stored vouchers for a given payment channel
best-spendable Print vouchers with highest value that is currently spendable for each lane
submit Submit voucher to chain to update payment channel state
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
#### lotus paych voucher create
```
NAME:
lotus paych voucher create - Create a signed payment channel voucher
USAGE:
lotus paych voucher create [command options] [channelAddress amount]
OPTIONS:
--lane value specify payment channel lane to use (default: 0)
--help, -h show help (default: false)
```
#### lotus paych voucher check
```
NAME:
lotus paych voucher check - Check validity of payment channel voucher
USAGE:
lotus paych voucher check [command options] [channelAddress voucher]
OPTIONS:
--help, -h show help (default: false)
```
#### lotus paych voucher add
```
NAME:
lotus paych voucher add - Add payment channel voucher to local datastore
USAGE:
lotus paych voucher add [command options] [channelAddress voucher]
OPTIONS:
--help, -h show help (default: false)
```
#### lotus paych voucher list
```
NAME:
lotus paych voucher list - List stored vouchers for a given payment channel
USAGE:
lotus paych voucher list [command options] [channelAddress]
OPTIONS:
--export Print voucher as serialized string (default: false)
--help, -h show help (default: false)
```
#### lotus paych voucher best-spendable
```
NAME:
lotus paych voucher best-spendable - Print vouchers with highest value that is currently spendable for each lane
USAGE:
lotus paych voucher best-spendable [command options] [channelAddress]
OPTIONS:
--export Print voucher as serialized string (default: false)
--help, -h show help (default: false)
```
#### lotus paych voucher submit
```
NAME:
lotus paych voucher submit - Submit voucher to chain to update payment channel state
USAGE:
lotus paych voucher submit [command options] [channelAddress voucher]
OPTIONS:
--help, -h show help (default: false)
```
### lotus paych settle
```
NAME:
lotus paych settle - Settle a payment channel
USAGE:
lotus paych settle [command options] [channelAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus paych status
```
NAME:
lotus paych status - Show the status of an outbound payment channel
USAGE:
lotus paych status [command options] [channelAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus paych status-by-from-to
```
NAME:
lotus paych status-by-from-to - Show the status of an active outbound payment channel by from/to addresses
USAGE:
lotus paych status-by-from-to [command options] [fromAddress toAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus paych collect
```
NAME:
lotus paych collect - Collect funds for a payment channel
USAGE:
lotus paych collect [command options] [channelAddress]
OPTIONS:
--help, -h show help (default: false)
```
## lotus auth
```
NAME:
lotus auth - Manage RPC permissions
USAGE:
lotus auth command [command options] [arguments...]
COMMANDS:
create-token Create token
api-info Get token with API info required to connect to this node
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus auth create-token
```
NAME:
lotus auth create-token - Create token
USAGE:
lotus auth create-token [command options] [arguments...]
OPTIONS:
--perm value permission to assign to the token, one of: read, write, sign, admin
--help, -h show help (default: false)
```
### lotus auth api-info
```
NAME:
lotus auth api-info - Get token with API info required to connect to this node
USAGE:
lotus auth api-info [command options] [arguments...]
OPTIONS:
--perm value permission to assign to the token, one of: read, write, sign, admin
--help, -h show help (default: false)
```
## lotus mpool
```
NAME:
lotus mpool - Manage message pool
USAGE:
lotus mpool command [command options] [arguments...]
COMMANDS:
pending Get pending messages
sub Subscribe to mpool changes
stat print mempool stats
replace replace a message in the mempool
find find a message in the mempool
config get or set current mpool configuration
gas-perf Check gas performance of messages in mempool
manage
2021-04-29 17:45:01 +00:00
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus mpool pending
```
NAME:
lotus mpool pending - Get pending messages
USAGE:
lotus mpool pending [command options] [arguments...]
OPTIONS:
--local print pending messages for addresses in local wallet only (default: false)
--cids only print cids of messages in output (default: false)
--to value return messages to a given address
--from value return messages from a given address
--help, -h show help (default: false)
```
### lotus mpool sub
```
NAME:
lotus mpool sub - Subscribe to mpool changes
USAGE:
lotus mpool sub [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus mpool stat
```
NAME:
lotus mpool stat - print mempool stats
USAGE:
lotus mpool stat [command options] [arguments...]
OPTIONS:
--local print stats for addresses in local wallet only (default: false)
--basefee-lookback value number of blocks to look back for minimum basefee (default: 60)
--help, -h show help (default: false)
```
### lotus mpool replace
```
NAME:
lotus mpool replace - replace a message in the mempool
USAGE:
lotus mpool replace [command options] <from nonce> | <message-cid>
OPTIONS:
--gas-feecap value gas feecap for new message (burn and pay to miner, attoFIL/GasUnit)
--gas-premium value gas price for new message (pay to miner, attoFIL/GasUnit)
--gas-limit value gas limit for new message (GasUnit) (default: 0)
--auto automatically reprice the specified message (default: false)
--max-fee value Spend up to X attoFIL for this message (applicable for auto mode)
--help, -h show help (default: false)
```
### lotus mpool find
```
NAME:
lotus mpool find - find a message in the mempool
USAGE:
lotus mpool find [command options] [arguments...]
OPTIONS:
--from value search for messages with given 'from' address
--to value search for messages with given 'to' address
--method value search for messages with given method (default: 0)
--help, -h show help (default: false)
```
### lotus mpool config
```
NAME:
lotus mpool config - get or set current mpool configuration
USAGE:
lotus mpool config [command options] [new-config]
OPTIONS:
--help, -h show help (default: false)
```
### lotus mpool gas-perf
```
NAME:
lotus mpool gas-perf - Check gas performance of messages in mempool
USAGE:
lotus mpool gas-perf [command options] [arguments...]
OPTIONS:
--all print gas performance for all mempool messages (default only prints for local) (default: false)
--help, -h show help (default: false)
```
# nage
```
```
2021-04-29 17:45:01 +00:00
## lotus state
```
NAME:
lotus state - Interact with and query filecoin chain state
USAGE:
lotus state command [command options] [arguments...]
COMMANDS:
2021-04-30 15:59:01 +00:00
power Query network or miner power
sectors Query the sector set of a miner
active-sectors Query the active sector set of a miner
list-actors list all actors in the network
list-miners list all miners in the network
circulating-supply Get the exact current circulating supply of Filecoin
sector Get miner sector info
get-actor Print actor information
lookup Find corresponding ID address
replay Replay a particular message
sector-size Look up miners sector size
read-state View a json representation of an actors state
list-messages list messages on chain matching given criteria
compute-state Perform state computations
call Invoke a method on an actor locally
get-deal View on-chain deal info
wait-msg Wait for a message to appear on chain
search-msg Search to see whether a message has appeared on chain
miner-info Retrieve miner information
market Inspect the storage market actor
exec-trace Get the execution trace of a given message
network-version Returns the network version
miner-proving-deadline Retrieve information about a given miner's proving deadline
help, h Shows a list of commands or help for one command
2021-04-29 17:45:01 +00:00
OPTIONS:
--tipset value specify tipset to call method on (pass comma separated array of cids)
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus state power
```
NAME:
lotus state power - Query network or miner power
USAGE:
lotus state power [command options] [<minerAddress> (optional)]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state sectors
```
NAME:
lotus state sectors - Query the sector set of a miner
USAGE:
lotus state sectors [command options] [minerAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state active-sectors
```
NAME:
lotus state active-sectors - Query the active sector set of a miner
USAGE:
lotus state active-sectors [command options] [minerAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state list-actors
```
NAME:
lotus state list-actors - list all actors in the network
USAGE:
lotus state list-actors [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state list-miners
```
NAME:
lotus state list-miners - list all miners in the network
USAGE:
lotus state list-miners [command options] [arguments...]
OPTIONS:
--sort-by value criteria to sort miners by (none, num-deals)
--help, -h show help (default: false)
```
### lotus state circulating-supply
```
NAME:
lotus state circulating-supply - Get the exact current circulating supply of Filecoin
USAGE:
lotus state circulating-supply [command options] [arguments...]
OPTIONS:
--vm-supply calculates the approximation of the circulating supply used internally by the VM (instead of the exact amount) (default: false)
--help, -h show help (default: false)
```
### lotus state sector
```
NAME:
lotus state sector - Get miner sector info
USAGE:
lotus state sector [command options] [minerAddress] [sectorNumber]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state get-actor
```
NAME:
lotus state get-actor - Print actor information
USAGE:
lotus state get-actor [command options] [actorrAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state lookup
```
NAME:
lotus state lookup - Find corresponding ID address
USAGE:
lotus state lookup [command options] [address]
OPTIONS:
--reverse, -r Perform reverse lookup (default: false)
--help, -h show help (default: false)
```
### lotus state replay
```
NAME:
lotus state replay - Replay a particular message
USAGE:
lotus state replay [command options] <messageCid>
OPTIONS:
--show-trace print out full execution trace for given message (default: false)
--detailed-gas print out detailed gas costs for given message (default: false)
--help, -h show help (default: false)
```
### lotus state sector-size
```
NAME:
lotus state sector-size - Look up miners sector size
USAGE:
lotus state sector-size [command options] [minerAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state read-state
```
NAME:
lotus state read-state - View a json representation of an actors state
USAGE:
lotus state read-state [command options] [actorAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state list-messages
```
NAME:
lotus state list-messages - list messages on chain matching given criteria
USAGE:
lotus state list-messages [command options] [arguments...]
OPTIONS:
--to value return messages to a given address
--from value return messages from a given address
--toheight value don't look before given block height (default: 0)
--cids print message CIDs instead of messages (default: false)
--help, -h show help (default: false)
```
### lotus state compute-state
```
NAME:
lotus state compute-state - Perform state computations
USAGE:
lotus state compute-state [command options] [arguments...]
OPTIONS:
--vm-height value set the height that the vm will see (default: 0)
--apply-mpool-messages apply messages from the mempool to the computed state (default: false)
--show-trace print out full execution trace for given tipset (default: false)
--html generate html report (default: false)
--json generate json output (default: false)
--compute-state-output value a json file containing pre-existing compute-state output, to generate html reports without rerunning state changes
--no-timing don't show timing information in html traces (default: false)
--help, -h show help (default: false)
```
### lotus state call
```
NAME:
lotus state call - Invoke a method on an actor locally
USAGE:
lotus state call [command options] [toAddress methodId <param1 param2 ...> (optional)]
OPTIONS:
--from value (default: "f00")
--value value specify value field for invocation (default: "0")
--ret value specify how to parse output (auto, raw, addr, big) (default: "auto")
--help, -h show help (default: false)
```
### lotus state get-deal
```
NAME:
lotus state get-deal - View on-chain deal info
USAGE:
lotus state get-deal [command options] [dealId]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state wait-msg
```
NAME:
lotus state wait-msg - Wait for a message to appear on chain
USAGE:
lotus state wait-msg [command options] [messageCid]
OPTIONS:
--timeout value (default: "10m")
--help, -h show help (default: false)
```
### lotus state search-msg
```
NAME:
lotus state search-msg - Search to see whether a message has appeared on chain
USAGE:
lotus state search-msg [command options] [messageCid]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state miner-info
```
NAME:
lotus state miner-info - Retrieve miner information
USAGE:
lotus state miner-info [command options] [minerAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state market
```
NAME:
lotus state market - Inspect the storage market actor
USAGE:
lotus state market command [command options] [arguments...]
COMMANDS:
balance Get the market balance (locked and escrowed) for a given account
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
#### lotus state market balance
```
NAME:
lotus state market balance - Get the market balance (locked and escrowed) for a given account
USAGE:
lotus state market balance [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus state exec-trace
```
NAME:
lotus state exec-trace - Get the execution trace of a given message
USAGE:
lotus state exec-trace [command options] <messageCid>
OPTIONS:
--help, -h show help (default: false)
```
### lotus state network-version
```
NAME:
lotus state network-version - Returns the network version
USAGE:
lotus state network-version [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
2021-04-30 15:59:01 +00:00
### lotus state miner-proving-deadline
```
NAME:
lotus state miner-proving-deadline - Retrieve information about a given miner's proving deadline
USAGE:
lotus state miner-proving-deadline [command options] [minerAddress]
OPTIONS:
--help, -h show help (default: false)
```
2021-04-29 17:45:01 +00:00
## lotus chain
```
NAME:
lotus chain - Interact with filecoin blockchain
USAGE:
lotus chain command [command options] [arguments...]
COMMANDS:
head Print chain head
getblock Get a block and print its details
read-obj Read the raw bytes of an object
delete-obj Delete an object from the chain blockstore
stat-obj Collect size and ipld link counts for objs
getmessage Get and print a message by its cid
sethead manually set the local nodes head tipset (Caution: normally only used for recovery)
list, love View a segment of the chain
get Get chain DAG node by path
bisect bisect chain for an event
export export chain to a car file
slash-consensus Report consensus fault
gas-price Estimate gas prices
inspect-usage Inspect block space usage of a given tipset
decode decode various types
encode encode various types
disputer interact with the window post disputer
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus chain head
```
NAME:
lotus chain head - Print chain head
USAGE:
lotus chain head [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus chain getblock
```
NAME:
lotus chain getblock - Get a block and print its details
USAGE:
lotus chain getblock [command options] [blockCid]
OPTIONS:
--raw print just the raw block header (default: false)
--help, -h show help (default: false)
```
### lotus chain read-obj
```
NAME:
lotus chain read-obj - Read the raw bytes of an object
USAGE:
lotus chain read-obj [command options] [objectCid]
OPTIONS:
--help, -h show help (default: false)
```
### lotus chain delete-obj
```
NAME:
lotus chain delete-obj - Delete an object from the chain blockstore
USAGE:
lotus chain delete-obj [command options] [objectCid]
DESCRIPTION:
WARNING: Removing wrong objects from the chain blockstore may lead to sync issues
OPTIONS:
--really-do-it (default: false)
--help, -h show help (default: false)
```
### lotus chain stat-obj
```
NAME:
lotus chain stat-obj - Collect size and ipld link counts for objs
USAGE:
lotus chain stat-obj [command options] [cid]
DESCRIPTION:
Collect object size and ipld link count for an object.
When a base is provided it will be walked first, and all links visisted
will be ignored when the passed in object is walked.
OPTIONS:
--base value ignore links found in this obj
--help, -h show help (default: false)
```
### lotus chain getmessage
```
NAME:
lotus chain getmessage - Get and print a message by its cid
USAGE:
lotus chain getmessage [command options] [messageCid]
OPTIONS:
--help, -h show help (default: false)
```
### lotus chain sethead
```
NAME:
lotus chain sethead - manually set the local nodes head tipset (Caution: normally only used for recovery)
USAGE:
lotus chain sethead [command options] [tipsetkey]
OPTIONS:
--genesis reset head to genesis (default: false)
--epoch value reset head to given epoch (default: 0)
--help, -h show help (default: false)
```
#### lotus chain list, love
```
```
### lotus chain get
```
NAME:
lotus chain get - Get chain DAG node by path
USAGE:
lotus chain get [command options] [path]
DESCRIPTION:
Get ipld node under a specified path:
lotus chain get /ipfs/[cid]/some/path
Path prefixes:
- /ipfs/[cid], /ipld/[cid] - traverse IPLD path
- /pstate - traverse from head.ParentStateRoot
Note:
You can use special path elements to traverse through some data structures:
- /ipfs/[cid]/@H:elem - get 'elem' from hamt
- /ipfs/[cid]/@Hi:123 - get varint elem 123 from hamt
- /ipfs/[cid]/@Hu:123 - get uvarint elem 123 from hamt
- /ipfs/[cid]/@Ha:t01 - get element under Addr(t01).Bytes
- /ipfs/[cid]/@A:10 - get 10th amt element
- .../@Ha:t01/@state - get pretty map-based actor state
List of --as-type types:
- raw
- block
- message
- smessage, signedmessage
- actor
- amt
- hamt-epoch
- hamt-address
- cronevent
- account-state
OPTIONS:
--as-type value specify type to interpret output as
--verbose (default: false)
--tipset value specify tipset for /pstate (pass comma separated array of cids)
--help, -h show help (default: false)
```
### lotus chain bisect
```
NAME:
lotus chain bisect - bisect chain for an event
USAGE:
lotus chain bisect [command options] [minHeight maxHeight path shellCommand <shellCommandArgs (if any)>]
DESCRIPTION:
Bisect the chain state tree:
lotus chain bisect [min height] [max height] '1/2/3/state/path' 'shell command' 'args'
Returns the first tipset in which condition is true
v
[start] FFFFFFFTTT [end]
Example: find height at which deal ID 100 000 appeared
- lotus chain bisect 1 32000 '@Ha:t03/1' jq -e '.[2] > 100000'
For special path elements see 'chain get' help
OPTIONS:
--help, -h show help (default: false)
```
### lotus chain export
```
NAME:
lotus chain export - export chain to a car file
USAGE:
lotus chain export [command options] [outputPath]
OPTIONS:
--tipset value
--recent-stateroots value specify the number of recent state roots to include in the export (default: 0)
--skip-old-msgs (default: false)
--help, -h show help (default: false)
```
### lotus chain slash-consensus
```
NAME:
lotus chain slash-consensus - Report consensus fault
USAGE:
lotus chain slash-consensus [command options] [blockCid1 blockCid2]
OPTIONS:
--from value optionally specify the account to report consensus from
--extra value Extra block cid
--help, -h show help (default: false)
```
### lotus chain gas-price
```
NAME:
lotus chain gas-price - Estimate gas prices
USAGE:
lotus chain gas-price [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus chain inspect-usage
```
NAME:
lotus chain inspect-usage - Inspect block space usage of a given tipset
USAGE:
lotus chain inspect-usage [command options] [arguments...]
OPTIONS:
--tipset value specify tipset to view block space usage of (default: "@head")
--length value length of chain to inspect block space usage for (default: 1)
--num-results value number of results to print per category (default: 10)
--help, -h show help (default: false)
```
### lotus chain decode
```
NAME:
lotus chain decode - decode various types
USAGE:
lotus chain decode command [command options] [arguments...]
COMMANDS:
params Decode message params
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
#### lotus chain decode params
```
NAME:
lotus chain decode params - Decode message params
USAGE:
lotus chain decode params [command options] [toAddr method params]
OPTIONS:
--tipset value
--encoding value specify input encoding to parse (default: "base64")
--help, -h show help (default: false)
```
### lotus chain encode
```
NAME:
lotus chain encode - encode various types
USAGE:
lotus chain encode command [command options] [arguments...]
COMMANDS:
params Encodes the given JSON params
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
#### lotus chain encode params
```
NAME:
lotus chain encode params - Encodes the given JSON params
USAGE:
lotus chain encode params [command options] [toAddr method params]
OPTIONS:
--tipset value
--encoding value specify input encoding to parse (default: "base64")
--help, -h show help (default: false)
```
### lotus chain disputer
```
NAME:
lotus chain disputer - interact with the window post disputer
USAGE:
lotus chain disputer command [command options] [arguments...]
COMMANDS:
start Start the window post disputer
dispute Send a specific DisputeWindowedPoSt message
help, h Shows a list of commands or help for one command
OPTIONS:
--max-fee value Spend up to X FIL per DisputeWindowedPoSt message
--from value optionally specify the account to send messages from
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
#### lotus chain disputer start
```
NAME:
lotus chain disputer start - Start the window post disputer
USAGE:
lotus chain disputer start [command options] [minerAddress]
OPTIONS:
--start-epoch value only start disputing PoSts after this epoch (default: 0)
--help, -h show help (default: false)
```
#### lotus chain disputer dispute
```
NAME:
lotus chain disputer dispute - Send a specific DisputeWindowedPoSt message
USAGE:
lotus chain disputer dispute [command options] [minerAddress index postIndex]
OPTIONS:
--help, -h show help (default: false)
```
## lotus log
```
NAME:
lotus log - Manage logging
USAGE:
lotus log command [command options] [arguments...]
COMMANDS:
list List log systems
set-level Set log level
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus log list
```
NAME:
lotus log list - List log systems
USAGE:
lotus log list [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus log set-level
```
NAME:
lotus log set-level - Set log level
USAGE:
lotus log set-level [command options] [level]
DESCRIPTION:
Set the log level for logging systems:
The system flag can be specified multiple times.
eg) log set-level --system chain --system chainxchg debug
Available Levels:
debug
info
warn
error
Environment Variables:
GOLOG_LOG_LEVEL - Default log level for all log systems
GOLOG_LOG_FMT - Change output log format (json, nocolor)
GOLOG_FILE - Write logs to file
GOLOG_OUTPUT - Specify whether to output to file, stderr, stdout or a combination, i.e. file+stderr
OPTIONS:
--system value limit to log system
--help, -h show help (default: false)
```
## lotus wait-api
```
NAME:
lotus wait-api - Wait for lotus api to come online
USAGE:
lotus wait-api [command options] [arguments...]
CATEGORY:
DEVELOPER
OPTIONS:
--help, -h show help (default: false)
```
## lotus fetch-params
```
NAME:
lotus fetch-params - Fetch proving parameters
USAGE:
lotus fetch-params [command options] [sectorSize]
CATEGORY:
DEVELOPER
OPTIONS:
--help, -h show help (default: false)
```
## lotus net
```
NAME:
lotus net - Manage P2P Network
USAGE:
lotus net command [command options] [arguments...]
COMMANDS:
peers Print peers
connect Connect to a peer
listen List listen addresses
id Get node identity
findpeer Find the addresses of a given peerID
scores Print peers' pubsub scores
reachability Print information about reachability from the internet
bandwidth Print bandwidth usage information
block Manage network connection gating rules
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus net peers
```
NAME:
lotus net peers - Print peers
USAGE:
lotus net peers [command options] [arguments...]
OPTIONS:
--agent, -a Print agent name (default: false)
--extended, -x Print extended peer information in json (default: false)
--help, -h show help (default: false)
```
### lotus net connect
```
NAME:
lotus net connect - Connect to a peer
USAGE:
lotus net connect [command options] [peerMultiaddr|minerActorAddress]
OPTIONS:
--help, -h show help (default: false)
```
### lotus net listen
```
NAME:
lotus net listen - List listen addresses
USAGE:
lotus net listen [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus net id
```
NAME:
lotus net id - Get node identity
USAGE:
lotus net id [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus net findpeer
```
NAME:
lotus net findpeer - Find the addresses of a given peerID
USAGE:
lotus net findpeer [command options] [peerId]
OPTIONS:
--help, -h show help (default: false)
```
### lotus net scores
```
NAME:
lotus net scores - Print peers' pubsub scores
USAGE:
lotus net scores [command options] [arguments...]
OPTIONS:
--extended, -x print extended peer scores in json (default: false)
--help, -h show help (default: false)
```
### lotus net reachability
```
NAME:
lotus net reachability - Print information about reachability from the internet
USAGE:
lotus net reachability [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus net bandwidth
```
NAME:
lotus net bandwidth - Print bandwidth usage information
USAGE:
lotus net bandwidth [command options] [arguments...]
OPTIONS:
--by-peer list bandwidth usage by peer (default: false)
--by-protocol list bandwidth usage by protocol (default: false)
--help, -h show help (default: false)
```
### lotus net block
```
NAME:
lotus net block - Manage network connection gating rules
USAGE:
lotus net block command [command options] [arguments...]
COMMANDS:
add Add connection gating rules
remove Remove connection gating rules
list list connection gating rules
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
#### lotus net block add
```
NAME:
lotus net block add - Add connection gating rules
USAGE:
lotus net block add command [command options] [arguments...]
COMMANDS:
peer Block a peer
ip Block an IP address
subnet Block an IP subnet
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
##### lotus net block add peer
```
NAME:
lotus net block add peer - Block a peer
USAGE:
lotus net block add peer [command options] <Peer> ...
OPTIONS:
--help, -h show help (default: false)
```
##### lotus net block add ip
```
NAME:
lotus net block add ip - Block an IP address
USAGE:
lotus net block add ip [command options] <IP> ...
OPTIONS:
--help, -h show help (default: false)
```
##### lotus net block add subnet
```
NAME:
lotus net block add subnet - Block an IP subnet
USAGE:
lotus net block add subnet [command options] <CIDR> ...
OPTIONS:
--help, -h show help (default: false)
```
#### lotus net block remove
```
NAME:
lotus net block remove - Remove connection gating rules
USAGE:
lotus net block remove command [command options] [arguments...]
COMMANDS:
peer Unblock a peer
ip Unblock an IP address
subnet Unblock an IP subnet
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
##### lotus net block remove peer
```
NAME:
lotus net block remove peer - Unblock a peer
USAGE:
lotus net block remove peer [command options] <Peer> ...
OPTIONS:
--help, -h show help (default: false)
```
##### lotus net block remove ip
```
NAME:
lotus net block remove ip - Unblock an IP address
USAGE:
lotus net block remove ip [command options] <IP> ...
OPTIONS:
--help, -h show help (default: false)
```
##### lotus net block remove subnet
```
NAME:
lotus net block remove subnet - Unblock an IP subnet
USAGE:
lotus net block remove subnet [command options] <CIDR> ...
OPTIONS:
--help, -h show help (default: false)
```
#### lotus net block list
```
NAME:
lotus net block list - list connection gating rules
USAGE:
lotus net block list [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
## lotus sync
```
NAME:
lotus sync - Inspect or interact with the chain syncer
USAGE:
lotus sync command [command options] [arguments...]
COMMANDS:
status check sync status
wait Wait for sync to be complete
mark-bad Mark the given block as bad, will prevent syncing to a chain that contains it
unmark-bad Unmark the given block as bad, makes it possible to sync to a chain containing it
check-bad check if the given block was marked bad, and for what reason
checkpoint mark a certain tipset as checkpointed; the node will never fork away from this tipset
help, h Shows a list of commands or help for one command
OPTIONS:
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
### lotus sync status
```
NAME:
lotus sync status - check sync status
USAGE:
lotus sync status [command options] [arguments...]
OPTIONS:
--help, -h show help (default: false)
```
### lotus sync wait
```
NAME:
lotus sync wait - Wait for sync to be complete
USAGE:
lotus sync wait [command options] [arguments...]
OPTIONS:
--watch don't exit after node is synced (default: false)
--help, -h show help (default: false)
```
### lotus sync mark-bad
```
NAME:
lotus sync mark-bad - Mark the given block as bad, will prevent syncing to a chain that contains it
USAGE:
lotus sync mark-bad [command options] [blockCid]
OPTIONS:
--help, -h show help (default: false)
```
### lotus sync unmark-bad
```
NAME:
lotus sync unmark-bad - Unmark the given block as bad, makes it possible to sync to a chain containing it
USAGE:
lotus sync unmark-bad [command options] [blockCid]
OPTIONS:
--all drop the entire bad block cache (default: false)
--help, -h show help (default: false)
```
### lotus sync check-bad
```
NAME:
lotus sync check-bad - check if the given block was marked bad, and for what reason
USAGE:
lotus sync check-bad [command options] [blockCid]
OPTIONS:
--help, -h show help (default: false)
```
### lotus sync checkpoint
```
NAME:
lotus sync checkpoint - mark a certain tipset as checkpointed; the node will never fork away from this tipset
USAGE:
lotus sync checkpoint [command options] [tipsetKey]
OPTIONS:
--epoch value checkpoint the tipset at the given epoch (default: 0)
--help, -h show help (default: false)
```
## lotus status
```
NAME:
lotus status - Check node status
USAGE:
lotus status [command options] [arguments...]
CATEGORY:
STATUS
OPTIONS:
--chain include chain health status (default: false)
--help, -h show help (default: false)
```