Lockers
Use locker
command to perform various locker management operations.
USAGE:
metalo locker command [command options] [arguments...]
COMMANDS:
new create new locker definition
import import locker from file
ls list all account lockers
help, h Shows a list of commands or help for one command
Create New Locker
Use the new
command to generate a new locker.
Options
--us value Our DID
--them value Their DID
--our-verkey value Our VerKey
--their-verkey value Their VerKey
--name value Locker name
--ttl value Number of months until the locker expires (default: 12)
--add If present, add the generated locker to the user's account (default: false)
--help, -h show help (default: false)
Examples
# create new locker
METAPASS=<password> metalo --user <email> locker new \
--us <our-did> --them <their-did> \
--our-verkey <our-verkey> --their-verkey <their-verkey> \
--name "Sample Locker" --ttl 120
# create new locker and save it in the account
METAPASS=<password> metalo --user <email> locker new \
--us <our-did> --them <their-did> \
--our-verkey <our-verkey> --their-verkey <their-verkey> \
--name "Sample Locker" --ttl 120 --add
If successful, new
command returns a new locker definition in JSON format.
Import Locker From File
Use the import
command to import an existing locker definition from file.
Options
--file value Identity file
Example
METAPASS=<password> metalo --user <email> locker import --file <path-to-file>
List Lockers
Use the ls
command to list all lockers in the given account.
METAPASS=<password> metalo --user <email> locker ls
Sample Output
| ID | NAME | IDENTITY1 | IDENTITY2 | CREATED | EXPIRES |
|----------------------------------------------|---------------------|------------------------------------|-----------|---------------------------|---------------------------|
| 9MDSvpG83ZBucQgw7kWhQxEnAze6ZZJ1F171uxn8sW13 | John Doe | did:piprate:QSzWti3D4qQgXXXoKz2JmY | Self | 2022-11-21 01:12:42+00:00 | 2032-11-21 01:12:42+00:00 |
| BKUSCuQ9sGPtMhT3Wbov6eoheMaZh37pzDdxw9uxrZL7 | Root Managed Locker | did:piprate:3f4enT91RVexWMVnneoWaJ | Self | 2022-11-21 01:12:42+00:00 | |
| G9Ac88w7zRaLzybnjLRztsQcXxfvCfJAcTzq2ueR26rz | Root Hosted Locker | did:piprate:3f4enT91RVexWMVnneoWaJ | Self | 2022-11-21 01:12:42+00:00 | |