\n\n# Flare P-chain Staking Tool\n\nThis repo contains a tool for staking assets.\n\nBecause Flare is a fork of [Avalanche](https://docs.avax.network/overview/getting-started/avalanche-platform), like Avalanche, it has three chains:\n\n- C-chain: contract chain, executes EVM smart contracts that manage assets (like ERC-20 tokens).\n- P-chain: platform chain, coordinates validators.\n- X-chain: exchange chain, handles assets.\n\nWhen validators require tokens to work (for example, as stake in proof-of-stake systems), these assets need to be moved from the C-chain to the P-chain.\nThis tool also supports moving assets between the C- and P-chains and back.\n\n## Installation\n\nThere are two ways to install the tool. Unless you plan to contribute to this repository, We recommend using `pnpm` and `node` with version >= 24.0.0.\n\n### Using npm\n\n```bash\nnpm install @flarenetwork/flare-stake-tool --global\n```\n\n### Manually building the repository\n\nFor developers, first clone the repo with\n\n```bash\ngit clone https://github.com/flare-foundation/flare-stake-tool.git\n```\n\nthen run `pnpm install` and `pnpm build` inside the cloned repo folder, and follow the rest of this guide from the repo folder using `bin/flare-stake-tool` instead of just `flare-stake-tool`.\n\n## Setting up your environment\n\nThere are three ways to use this app:\n\n1. With a connected ledger device,\n2. With an initialized public key (and a vault id for ForDefi wallet),\n3. With a private key logged inside your environment file.\n\nThe ledger device requires no setup, as the needed public key is always extracted from the connected ledger device.\n\nTo initialize this app with your secp256k1 curve public key (a 32-byte hexadecimal prefixed `0x02`/`0x03` or a 64-byte hexadecimal optionally prefixed `0x04`), run the following command:\n\n```bash\nflare-stake-tool init-ctx -p --network \n```\n\nThis allows the app to produce unsigned transaction hashes, which can be signed externally (using ECDSA), and then sent back to the app to finalize the transaction.\n\nTo use this app in a less-secure manner, you can set your private key as an environment variable. To do this, follow the below steps:\n\n1. Obtain the private key (32 bytes either in hexadecimal or [cb58](https://support.avax.network/en/articles/4587395-what-is-cb58) format).\n2. Create a file to hold your private key.\n3. Paste this code in as follows and enter the private key in either hex or cb58 format within the quotation marks:\n\n ```bash\n PRIVATE_KEY_CB58=\"private key\"\n PRIVATE_KEY_HEX=\"private key\"\n ```\n\n> **WARNING**\n> While easier (as signing is done within the app), we discourage the usage of this app with the private key exposed in the file. This is because the private key is exposed to 800+ dependencies, and there is no way to audit them all.\n\n## App usage with ledger\n\nBelow we describe the functionality offered by the app, when you have your ledger device connected to the computer, with Flare app running.\n\n### Address conversion\n\nThis describes how to view the P- and C-chain addresses. Those addresses are derived from your public key, which in turn can be derived from your private key.\n\n```bash\nflare-stake-tool addresses --ledger --network \n```\n\nSample response:\n\n```bash\nP-chain address: P-flare1pynhfl09rfrf20s83lf6ra5egqylmx757ahxn6\nC-chain address hex: 0xead9c93b79ae7c1591b1fb5323bd777e86e150d4\nsecp256k1 public key: 0x02efe41c5d213089cb7a9e808505e9084bb9eb2bf3aa8050ea92a5ae9e20e5a692\n```\n\nThe P-chain address is in the Bech32 format, while the C-chain uses the Ethereum format to comply with the Ethereum Virtual Machine. Lastly, the public key is in the standard compressed format.\n\n### Check balances\n\nThis describes how to view your P- and C-chain balances.\n\n```bash\nflare-stake-tool balance --ledger --network \n```\n\nWhere:\n\n````\nSample response:\n```bash\nC-chain 0x5a6a8c28a2fc040df3b7490440c50f00099c957a: 999.000000000000000000 FLR\nP-chain P-flare1mwy6yvuk8xjl87scxfvvl63xtex3ennvkkpasz: 1.000000000 FLR\n````\n\n### Export and import assets\n\n#### Move assets from the C-chain to the P-chain\n\nThis describes how to move assets from the C-chain to the P-chain.\n\nFunds typically reside on the C-chain account, so they have to be exported from it. Exported funds must then be imported to the corresponding P-chain account. This requires one transaction on each chain, so you need to issue two commands.\n\n```bash\nflare-stake-tool exportCP -a -f --ledger --network \nflare-stake-tool importCP --ledger --network \n```\n\nWhere:\n\n- `amount` is the amount to export, in FLR.\n- `fee` is optional. It specifies a gas fee for a transaction in FLR.\n- --network is optional. It specifies the network to use. The default is `flare`, but you can also use `costwo`, `songbird`, `coston`, or `localflare`.\n\n> **Note**\n> Methods affecting the P-chain (`importCP` and `exportPC`) always use a fixed gas fee of 0.001 FLR, while methods affecting the C-chain (`exportCP` and `importPC`) have variable gas fees and can thus be either set or calculated automatically.\n> If you get the `errInsufficientFunds` error, try specifying a higher gas fee when exporting funds.\n> The fee is not deducted from the exported amount, but from the C-chain account.\n> The final amount on the P-chain is therefore exactly the `amount` specified.\n\nSample response:\n\n```bash\nTransaction with hash 2Ch7Tp3mBxW4QZ57Lr26bddXf7QqNGrukRVbBgwSbrPWisuxYV sent to the node\n```\n\n#### Move assets from the P-chain back to the C-chain\n\n> **IMPORTANT**\n> These commands are similar to exporting and importing assets from the C-chain to the P-chain, but they are not the same.\n> Note the reversed P and C.\n\n```bash\nflare-stake-tool exportPC -a --ledger --network \nflare-stake-tool importPC -f --ledger --network \n```\n\nwhere `amount`, `fee` and `network` are optional. If amount after `exportPC` is not specified, all funds are exported.\n\n### Staking\n\nTo add a validator node to the flare network, run the following command:\n\n```bash\nflare-stake-tool stake -n -e -a --delegation-fee --pop-bls-public-key --pop-bls-signature --ledger\n```\n\nWhere:\n\n- `nodeId` is the ID of the node being deployed as a validator.\n- `end-time` is the unix time of the end of the staking process.\n- `amount` is the amount to lock and stake in FLR.\n- `delegation-fee` is the fee in percent that the validator charges for delegating to it. The minimum is 0 and the maximum is 100. If omitted, it defaults to 20.\n- `popBlsPublicKey` is the BLS public key of the validator node.\n- `popBlsSignature` is the BLS signature generated by the validator node.\n\nWhen the staking period ends, the nodes automatically stop acting as validators and the staked amount is returned to the P-chain account.\n\nTo check whether a validator has been added successfully, fetch lists of current validators with this command:\n\n```bash\nflare-stake-tool info validators --network --ledger\n```\n\n### Delegating\n\nTo delegate to a validator node, run the following command:\n\n```bash\nflare-stake-tool delegate -n -e -a --ledger --network \n```\n\nWhere:\n\n- `nodeId` is the ID of the deployed validator node, you wish to delegate to.\n- `end-time` is the unix time of the end of the delegation process.\n- `amount` is the amount to lock and delegate in FLR.\n\n## Operations with public key\n\nThe public key is needed to construct the unsigned transaction hashes, which can then be signed externally (e.g. through a hardware wallet or a custodial API) and sent back to the app to finalize the transaction.\n\nTransaction finalization thus requires three steps:\n\n1. generate the unsigned transaction inside a json file and obtain the produced hash / message,\n1. externally sign the hash and send the signature back to the app to finalize the export transaction,\n1. finalize the transaction with the signature and send it to a network node.\n\nThe app-generated unsigned transaction json file respects the below format:\n\n```json\n{\n \"transactionType\": \"\",\n \"serialization\": \"\",\n \"signatureRequests\": [\n {\n \"message\": \"\",\n \"signer\": \"\"\n }, ...\n ],\n \"unsignedTransactionBuffer\": \"\",\n}\n```\n\n> **Note**\n> The messages and signers inside `signatureRequests` should all be the same, so only one signature is required.\n\nThe signed transaction json file that you should generate via raw signing is the same as unsigned, but with appended raw `message` signature. So, it respects the below format:\n\n```json\n{\n \"transactionType\": \"\",\n \"serialization\": \"\",\n \"signatureRequests\": [\n {\n \"message\": \"\",\n \"signer\": \"\"\n }, ...\n ],\n \"unsignedTransactionBuffer\": \"\",\n \"signature\": \"\"\n}\n```\n\nAn example signature is of the `r|s|v` format, e.g. `98f8c0d13bf2b5a5b2216894e503a721a099a1944116b802f2d84c0bd83a1bef3378e1b56d7ccd06de321913b8db0e97f4775e1885c86f6bcc583330d37cf5be01` where the last byte `v` is the recovery ID and can be either `00`/`01` or `1b`/`1c`.\n\nUnsigned transaction files are always in the form of `${id}.unsignedTx.json` and signed transaction files are always in the form of `${id}.signedTx.json`. To send a signed transaction named `${id}.signedTx.json`, use the following command:\n\n```bash\nflare-stake-tool send -i \n```\n\n### Move assets from the C-chain to the P-chain\n\nCommands for obtaining unsigned transactions are the same as for the ledger in previous section, except that you omit the `--ledger` flag and additionally have to specify transaction id `-i `. For example:\n\n```bash\nflare-stake-tool exportCP -a -i --ctx-file \n```\n\nwhere --ctx-file is optional and specifies the path to the context file. If not specified, the default context file (`ctx.json`) is used.\n\n## Operations with private key\n\nTo use the app with the private key, you can copy the commands used with ledger and replace `--ledger` flag with `--get-hacked` and add an additional argument `--env-path `. For example:\n\n```bash\nflare-stake-tool exportCP -a -i --env-path --get-hacked --network \n```\n\n## Interactive CLI\n\nFor easier guidance through the process, you can also use an interactive CLI, with the following command:\n\n```bash\nflare-stake-tool interactive\n```\n\n## Validation and misc operations\n\n### Getting your node ID:\n\n```bash\ncurl -s -X POST --data '{ \"jsonrpc\":\"2.0\", \"id\" :1, \"method\" :\"info.getNodeID\" }' -H 'content-type:application/json;' RPC-URL:PORT/ext/info\n```\n\n### Check the current validators (To see if the stake or delegation was successful):\n\n```bash\ncurl -s --location --request POST 'RPC-URL:PORT/ext/bc/P' --header 'Content-Type: application/json' --data-raw '{ \"jsonrpc\": \"2.0\", \"method\": \"platform.getCurrentValidators\", \"params\": { \"subnetID\": null, \"nodeIDs\": [] }, \"id\": 1 }' | jq .\n```\n","readmeFilename":"README.md"}
![\"Flare](\"https://content.flare.network/Flare-2.svg\")
\n \n