laconicd/lockup.md
Prathamesh Musale 59236e5ce6 Add a custom lockup account to hold locked tokens (#72)
Part of https://www.notion.so/Lockup-LPS-tokens-into-a-module-account-1f2a6b22d472802cbb35e8ce052d22ca

- Added a command to create the custom lockup account in genesis:
  ```bash
  laconicd genesis add-genesis-lockup-account <account_name> <distribution-json-file> <coin>[,<coin>...]
  ```

Reviewed-on: cerc-io/laconicd#72
Co-authored-by: Prathamesh Musale <prathamesh.musale0@gmail.com>
Co-committed-by: Prathamesh Musale <prathamesh.musale0@gmail.com>
2025-05-16 09:26:10 +00:00

1.1 KiB

Lockup Account Usage

  • Add a genesis lockup account:

    laconicd genesis add-genesis-lockup-account <account_name> <distribution-json-file> <coin>[,<coin>...]
    
    # Example
    # laconicd genesis add-genesis-lockup-account lps_lockup distribution.json 1000alps
    
    • This adds a LockupAccount with given name and balance in the genesis file

    • The lockup account can be queried as shown below once the chain starts

  • Query a lockup account:

    laconicd query auth module-account <account_name>
    
    # Example
    # laconicd query auth module-account lps_lockup
    # account:
    # type: laconic/LockupAccount
    # value:
    #   base_account:
    #     account_number: "1"
    #     address: laconic1mprsxp9jqe0d0lp88fxuccthwgy7tqgt5x9y65
    #   distribution: |-
    #     {
    # ...
    
  • Query a lockup account's balance:

    laconicd query bank balances <address>
    
    # Example
    lockup_account_address=$(laconicd query auth module-account lps_lockup -o json | jq -r '.account.value.base_account.address')
    laconicd query bank balances $lockup_account_address
    balances:
    - amount: "1000"
      denom: alps
    pagination:
      total: "1"