docs: add resign and withdraw utility scripts for liquidity management

Author: Hakob23

Makefile

@@ -10,6 +10,8 @@ define utils_build
   	CGO_ENABLED=0 go build -v -o ./utils/register_pegin ./cmd/utils/register_pegin/register_pegin.go
   	CGO_ENABLED=0 go build -v -o ./utils/refund_user_pegout ./cmd/utils/refund_user_pegout/refund_user_pegout.go
   	CGO_ENABLED=0 go build -v -o ./utils/key_conversion ./cmd/utils/key_conversion/key_conversion.go
+ 	CGO_ENABLED=0 go build -v -o ./utils/resign_utils ./cmd/utils/resign_utils/resign_utils.go
+ 	CGO_ENABLED=0 go build -v -o ./utils/withdraw ./cmd/utils/withdraw/withdraw.go
 endef
 
 tools: download

README.md

@@ -165,6 +165,10 @@ The LPS provides several utility scripts that can be helpful for liquidity provi
 - **register_pegin**: Register a PegIn transaction within the Liquidity Bridge Contract. Most times, this script is only required to execute refunds on special cases. This script requires an input file whose structure can be found in the [input-example.json](https://github.com/rsksmart/liquidity-provider-server/blob/master/cmd/utils/register_pegin/input-example.json) file.
 - **refund_user_pegout**: Executes a refund for a user's peg-out operation through the Liquidity Bridge Contract. This is used when a peg-out operation needs to be refunded back to the user's RSK address. The script requires the quote hash of the operation to refund.
 - **key_conversion**: Shows the corresponding BTC and RSK address for a given private key and encrypts it into a keystore, accepts the key either in WIF or hex format. The key can be provided through the terminal, a file or an existing keystore.
+- **resign_utils**: Resigns a liquidity provider and withdraws collateral from the Collateral Management contract.
+- **withdraw**: Withdraws liquidity locked in the PegIn contract (full balance or specific amount).
+
+For migration-specific examples, see [docs/LP-Migration-Utils.md](./docs/LP-Migration-Utils.md).
 
 ## Monitoring Service
 

docs/LP-Migration-Utils.md

@@ -0,0 +1,91 @@
+---
+title: LP Migration Utilities
+---
+
+# LP Migration Utilities
+
+This document describes the utility scripts that help Liquidity Providers migrate liquidity to the new contract set.
+
+## Prerequisites
+
+- Access to the Rootstock RPC endpoint for the target network.
+- Wallet secrets configured via the same mechanisms used by the LPS (`--secret-src env|aws`).
+
+## Build the utilities
+
+```bash
+make utils
+```
+
+The binaries will be placed in the `./utils` directory.
+
+## Common options
+
+Both scripts reuse the base input flags from `cmd/utils/scripts`:
+
+- `--network` (required): `regtest`, `testnet`, or `mainnet`
+- `--rsk-endpoint` (required): RPC URL (e.g. `http://localhost:4444`)
+- `--secret-src` (required): `env` or `aws`
+- `--keystore-file`: required when `--secret-src=env`
+- `--keystore-secret` and `--password-secret`: required when `--secret-src=aws`
+- `--custom-pegin-address`, `--custom-collateral-address`, `--custom-pegout-address`, `--custom-discovery-address`: optional overrides
+
+### Default regtest env file
+
+If you want to run the utilities with minimal flags (for example `./utils/resign_utils --resign`), you can provide defaults via an env file:
+
+- Set `LPS_UTILS_ENV_FILE` to a file containing `LPS_STAGE`, `RSK_ENDPOINT`, `SECRET_SRC`, `AWS_LOCAL_ENDPOINT`, and wallet keys such as `WALLET_FILE`, `WALLET_SECRET`, and `PASSWORD_SECRET`.
+- If `LPS_UTILS_ENV_FILE` is not set, the utilities will try `docker-compose/local/.env.regtest`, then `regtest.env` at the repo root.
+- A minimal `regtest.env` is included for local regtest defaults; adjust it to match your environment.
+
+## Resign utility
+
+### Resign
+
+```bash
+./utils/resign_utils \
+  --network testnet \
+  --rsk-endpoint http://localhost:4444 \
+  --secret-src env \
+  --keystore-file /path/to/keystore.json \
+  --resign
+```
+
+### Withdraw collateral
+
+```bash
+./utils/resign_utils \
+  --network testnet \
+  --rsk-endpoint http://localhost:4444 \
+  --secret-src env \
+  --keystore-file /path/to/keystore.json \
+  --withdraw-collateral
+```
+
+Note: `--withdraw-collateral` requires the resignation delay to have elapsed after calling `--resign`.
+
+## Withdraw utility
+
+### Withdraw full balance
+
+```bash
+./utils/withdraw \
+  --network testnet \
+  --rsk-endpoint http://localhost:4444 \
+  --secret-src env \
+  --keystore-file /path/to/keystore.json \
+  --all
+```
+
+### Withdraw a specific amount
+
+```bash
+./utils/withdraw \
+  --network testnet \
+  --rsk-endpoint http://localhost:4444 \
+  --secret-src env \
+  --keystore-file /path/to/keystore.json \
+  --amount 1000000000000000000
+```
+
+The `--amount` value is expressed in wei.