# Keytool Instructions Keytool is an auxiliary tool used for signing and sending transactions, as well as performing Miner-related operations such as change-beneficiary. It is a command-line lightweight wallet. Due to the continuous iteration of Filecoin, the versions of Keytool will also continue to iterate. Please follow the official website to get the latest updates of Keytool. Keytool download link: {% embed url="" %} **Before using Keytool, please read the following bullet point contents very carefully:** * *The use of Keytool requires users to have basic computer skills and knowledge, including but not limited to file paths, command line operations, vim operations, VPN, and certain English reading abilities.* * *The configuration environment of this article is the Calibration testnet. Calibration has a faucet (faucet) that can receive test coins TFIL. Test users can receive test coins for their own addresses after creating wallet addresses and miners. * * *Access to this faucet website may require a VPN in global mode.* * *This faucet can receive 100 TFIL at once, and each address can receive it twice every 24 hours.* * *Keytool uses the platform to recommend Mac or Linux systems.* * *Before starting, please confirm that your input method has been switched to the English input method.* * *When entering commands, pay attention to the spaces between words.* Here are the instructions for using Keytool for common operations: #### **I. Configure environment** 1. Download and extract Keytool 2. Taking the MacOS system as an example, click "Launchpad".
Enter "terminal" in the upper input box and click "endpoint."
3. Enter the following at the endpoint to extract the path of the Keytool folder and press Enter, as shown in the figure. `cd [space]`
4. If Vim is not installed, please install Vim. To confirm whether Vim is installed, enter the following at the endpoint and press Enter to observe the output. `Vim --version`
5. Enter the following at the endpoint and press Enter. You can see the current network configuration. We need to modify this configuration next. `./keytool config show`
6. Enter the following at the endpoint and press Enter. `vim./.keytool/config.toml`
7. In the new interface, we can modify the configuration file.keytool/config.toml. The modification method is: first, click the i key on the keyboard to enter the editing mode
The keyboard arrow keys can adjust the cursor position. Move the cursor to the bottom line of the text and delete all content line by line. Copy the following content to the end point. Taking Mac as an example, the shortcut to copy is Command key + C, and the shortcut to paste is Command key + V. `Version = 3` `Path = "./.keytool"` `Author = "https://api.calibration.node.glif.io/rpc/v1"` `NodeAPIs = ["https://api.calibration.node.glif.io/rpc/v1"]` `Messenger = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBbGxvdyI6WyJyZWFkIiwid3JpdGUiLCJzaWduIiwiYWRtaW4iXX0.CAr-tnT5Z-J3fRzpvVdNH74SNAzf9QWA9dqP8sSipqE;https://api.calibration.node.glif.io/rpc/v1" DustValue = "1000000000"` `[DbCfg] Conn = "./keytool_calibration.sqlite" Dbg = false` 8. Click the Esc key on the keyboard to exit editing mode
9. Press and hold the Shift key while clicking the colon key.
10. Enter wq and press Enter to save the configuration file.
11. Enter./keytool config show to observe whether the modification result takes effect.
#### **II. Create a wallet address** Enter `./keytool wallet new --type bls` and press Enter. Follow the prompts to enter the wallet name, password, and confirmation password. **Remember this password** and use it frequently later.
Enter the./keytool wallet list command to view the newly generated wallet address.
#### **III. Apply for test coins for the wallet address** The configuration environment of this article is the Calibration testnet. Calibration has a faucet that can receive test coins TFIL. Test users can receive test coins for their own addresses after creating wallet addresses and miners. Visiting this faucet website may require a VPN's global mode. This faucet can claim 100TFIL at once, and each address can claim it twice every 24 hours. After entering the page, enter the wallet address generated in the previous step and click Send Funds. The address can be viewed through the./keytool wallet list command.
Please wait one or two minutes until the transaction is on the chain. You can view the balance of the wallet address, the number of messages, and other information through the browser. The browser address is: After entering the browser, enter the wallet address in the search box in the upper right corner and press Enter.
You can see that the wallet address generated just now has a balance of 100 TFIL.
#### **IV. Set Address Nonce** Each transaction in Filecoin has a nonce. This nonce starts from 0 and increases by 1 for each transaction. Before creating a transaction, we need to synchronize the address of the transaction sent in the local keytool with the corresponding nonce on the chain to ensure that the transaction can be sequentially uploaded to the chain. Enter `./keytool wallet balance -a [wallet address]` at the endpoint and remember to replace the items in square brackets. You can see the current nonce on the chain.
Enter `./keytool wallet set-nonce -a [wallet address] -n [new nonce]` at the endpoint, remember to replace the items in square brackets, as shown in the figure.
**Before signing or sending a transaction, you need to manually synchronize the nonce.** #### **V. Create Miners** To create a miner, you need to send a transaction on the chain. Before performing the following steps, you need to synchronize the nonce. For detailed methods, please refer to Section 4 to set the address of the nonce. Please note that if the following steps exit and restart midway, you need to resynchronize the nonce. After synchronizing the nonce, enter at the endpoint: `./keytool message build --from = [wallet address] --to = f04 --method = 2 --args = '{"Owner": "[wallet address]", "Worker": "[wallet address]", "WindowPoStProofType": 13, "Peer": null, "Multiaddrs": null}'` Remember to replace the items in square brackets, as shown in the figure.
Pay attention to the file path in the red box, which is the message we just constructed. We need to sign this message now. Enter at the end point: `./keytool message sign -f [file path in red box]` Enter the wallet password as prompted, as shown in the figure.
Pay attention to the file path in the red box, which is the signature file we just obtained. We need to send this message to the chain now. Enter at the end point: `./Keytool message push -f [file path in red box]` As shown in the figure.
Search for the wallet address in the browser, scroll down the page, and you can see that the message we just sent is waiting to be uploaded. Please wait patiently for one or two minutes.
Refresh the page, and you will find that the wallet address has a new Miner, as shown in the figure.
**VI. Signature** Synchronize the nonce before performing the following steps. For detailed methods, please refer to Section 4 for setting the address nonce. Enter `./keytool wallet sign [wallet address] [message to be signed]` at the endpoint, as shown in the figure.
This way we get the result of the signature. You can use this method to perform the signature operation in the steps that need to be signed in Filliquid dApp. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.filliquid.io/ko/testnet-user-manual/borrowing-usdfil/keytool-instructions.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.