> For the complete documentation index, see [llms.txt](https://docs.fida.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fida.finance/usage/command-line-interface/claims-management.md).

# Claims Management

Walkthrough of managing claims through the CLI tool

<details>

<summary>Execution Details</summary>

network: preview

cardano-node: 10.1.2

kupo: 2.9.0

ogmios: 6.7.0

fida-cli: 0.0.3

</details>

## Confirming Fida cli initial setup

```
bash-5.2$ node ./dist/cli-index.js --help

Version: v0.0.3

Usage: cli-index.js COMMAND

Available options:
  -h,--help                Show this help text

Available commands:
  make-new-policy          Create new Fida Policy
  get-policy               Get policy by id
  buy-fida-cards           Buy Fida cards
  pay-for-a-policy         Pay for a insurance policy with a given wallet
  sell-fida-cards          Sell Fida cards
  complete-funding         Complete funding (going OnRisk)
  issue-claim              Issue Fida insurance policy claim
  accept-claim             Accept active claim (broker)
  close-claim              Close claim (policy holder)
  fail-claim               Fail claim (policy authority)
  claim-premium            Claim premium (investor)
  pay-for-claim            Pay for claim optionally using own funds
                           (investor/everyone after deadline)
  unlock-collateral        Unlock investor collateral (investor)
  expire-policy            Expire policy (everyone)

Fida https://fida.finance
```

### Wallets

```
~/git/fida/dev-tools/cli-toolbox ./wallet.sh -l

Id                                      Name            Desc
==============================================================
19f589a1-091d-44a4-b4d2-c82fb4e4c9ab    broker-1
9557307d-8930-423c-a2c3-750dd058435f    investor-1
e06ec2bf-2da8-4157-8825-34f547180941    policy-holder
```

#### broker-1

```
cardano-cli latest address key-hash --payment-verification-key-file /home/ssledz/etc/.cardano-wallets/preview/19f589a1-091d-44a4-b4d2-c82fb4e4c9ab/payment.vkey

81e5819399c73eeef29db727fe36a2a0a2d4555955af7f3f51fc9a05
```

#### policy-holder

```
cardano-cli latest address key-hash --payment-verification-key-file /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/payment.vkey

fac649cff91290b8222b0594c121daf1f7d8d1ae3f8026f8dc15626f
```

## Insurance policies examples

### Claim Accepted (policy-1)

```
node dist/cli-index.js get-policy --insurance-id 16d097c673e7dc956baa45be6f8778e79a0bef4df1d44cbd98da7f93

Insurance Id : 16d097c673e7dc956baa45be6f8778e79a0bef4df1d44cbd98da7f93
Address      : addr_test1wzkwkselegljkwgayeh9xk0t6ml6tdg9jzsy8yln0eqqqrqu7k6vh
Payment      : Paid
Insurance    :
    - Collateral:                   100000000
    - Fida card value:              50000000
    - Fida card quantity:           2
    - Premium amount:               20000000
    - Installments:
          - interval: 1 minutes  | amount: 2500000
          - interval: 5 minutes  | amount: 2500000
          - interval: 10 minutes | amount: 2500000
          - interval: end        | amount: 2500000
    - Insurance period:             4 hours
    - Policy holder:                (PubKeyHash (Ed25519KeyHash (unsafePartial $ fromJust $ fromBytes (hexToByteArrayUnsafe "fac649cff91290b8222b0594c121daf1f7d8d1ae3f8026f8dc15626f"))))
    - Policy authority:             (SingleSign (PubKeyHash (Ed25519KeyHash (unsafePartial $ fromJust $ fromBytes (hexToByteArrayUnsafe "81e5819399c73eeef29db727fe36a2a0a2d4555955af7f3f51fc9a05")))))
    - State:                        OnRisk
    - Funding deadline:             11-13-2024 12:00
    - Claim accepted amount:        0
    - Claim time to live:           7 days
    - Claim time to pay:            5 days
    - Start date:                   11-11-2024 08:30
    - Current claim:
         - id:       (UUID a5f4ca66-d5a4-4425-a337-9105854484f1)
         - created:  11-11-2024 08:30
         - amount:   10000000
         - reason:   I need money !
         - accepted: true
Piggy banks  :
     - (1)     addr_test1wrnf4f349ptqyh2a20dt0xx67x4de0hmlmgtuxeel92eepcql9ahp | collateral: 51180940 / 50000000 | premium: 10000000 / 10000000 r: 0 | claims: []
     - (2)     addr_test1wpck3xvmfdw6vj8068adgm9arxaqlqpvukxwz7te2zcqa5slugyea | collateral: 51180940 / 50000000 | premium: 10000000 / 10000000 r: 0 | claims: []
```

#### Create, pay for policy, buy fida cards, complete funding & issue a claim

```
node dist/cli-index.js make-new-policy \
   --input-utxo '4b5425dd6fccc608015c86eb0d986d39da5d64f164655b4a4c16248d1bc4e1ef#1' \
   --collateral-amount=100000000 \
   --insurance-price 20000000 \
   --insurance-period "4 hours" \
   --funding-deadline 2024-11-13 \
   --policy-holder-pkh 'fac649cff91290b8222b0594c121daf1f7d8d1ae3f8026f8dc15626f' \
   --fida-card-quantity 2 \
   --single-sign-governance-authority '81e5819399c73eeef29db727fe36a2a0a2d4555955af7f3f51fc9a05' \
   --installment-intervals '1 minutes,5 minutes,10 minutes'

node dist/cli-index.js pay-for-a-policy \
  --insurance-id 16d097c673e7dc956baa45be6f8778e79a0bef4df1d44cbd98da7f93 \
  -k /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/stake.skey

node dist/cli-index.js buy-fida-cards \
  --insurance-id 16d097c673e7dc956baa45be6f8778e79a0bef4df1d44cbd98da7f93 \
  -k /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/stake.skey \
  --fida-cards 1,2

node dist/cli-index.js complete-funding \
  --insurance-id 16d097c673e7dc956baa45be6f8778e79a0bef4df1d44cbd98da7f93 \
  -k /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/stake.skey

node dist/cli-index.js issue-claim \
  --insurance-id 16d097c673e7dc956baa45be6f8778e79a0bef4df1d44cbd98da7f93 \
  --claim-amount 10000000 \
  --claim-reason 'I need money !' \
  -k /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/stake.skey

node dist/cli-index.js accept-claim \
  --insurance-id 16d097c673e7dc956baa45be6f8778e79a0bef4df1d44cbd98da7f93
```

### Claim Issued (policy-2)

```
node dist/cli-index.js get-policy --insurance-id 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb

Insurance Id : 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb
Address      : addr_test1wpmck4ph3dkngvu5u9nna68a70u0sdhv6avp8es6rqugcjqtmhkqt
Payment      : Paid
Insurance    :
    - Collateral:                   100000000
    - Fida card value:              50000000
    - Fida card quantity:           2
    - Premium amount:               20000000
    - Installments:
          - interval: 1 minutes  | amount: 2500000
          - interval: 5 minutes  | amount: 2500000
          - interval: 10 minutes | amount: 2500000
          - interval: end        | amount: 2500000
    - Insurance period:             4 hours
    - Policy holder:                (PubKeyHash (Ed25519KeyHash (unsafePartial $ fromJust $ fromBytes (hexToByteArrayUnsafe "fac649cff91290b8222b0594c121daf1f7d8d1ae3f8026f8dc15626f"))))
    - Policy authority:             (SingleSign (PubKeyHash (Ed25519KeyHash (unsafePartial $ fromJust $ fromBytes (hexToByteArrayUnsafe "81e5819399c73eeef29db727fe36a2a0a2d4555955af7f3f51fc9a05")))))
    - State:                        OnRisk
    - Funding deadline:             11-13-2024 12:00
    - Claim accepted amount:        0
    - Claim time to live:           7 days
    - Claim time to pay:            5 days
    - Start date:                   11-11-2024 08:39
    - Current claim:
         - id:       (UUID 004189b8-856a-4e50-b311-ff59dfe9720f)
         - created:  11-11-2024 08:41
         - amount:   10000000
         - reason:   I need money !
         - accepted: false
Piggy banks  :
     - (1)     addr_test1wqju8awhepp3apu6kjjvfupf050y30sf5wmnyqprz7w7ktghf2g33 | collateral: 51180940 / 50000000 | premium: 10000000 / 10000000 r: 0 | claims: []
     - (2)     addr_test1wrfyqwrslg6g4m5quxvqsat9ql9j9zsc0et7rfne9wsfj5qtnp2v0 | collateral: 51180940 / 50000000 | premium: 10000000 / 10000000 r: 0 | claims: []
```

#### Create, pay for policy, buy fida cards, complete funding & issue a claim

```
node dist/cli-index.js make-new-policy \
   --input-utxo '2e84cd86194ee4331e8581541fcfeb8c47b7a347d406a2dbf576ff212a10ca93#1' \
   --collateral-amount=100000000 \
   --insurance-price 20000000 \
   --insurance-period "4 hours" \
   --funding-deadline 2024-11-13 \
   --policy-holder-pkh 'fac649cff91290b8222b0594c121daf1f7d8d1ae3f8026f8dc15626f' \
   --fida-card-quantity 2 \
   --single-sign-governance-authority '81e5819399c73eeef29db727fe36a2a0a2d4555955af7f3f51fc9a05' \
   --installment-intervals '1 minutes,5 minutes,10 minutes'

node dist/cli-index.js pay-for-a-policy \
  --insurance-id 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb \
  -k /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/stake.skey

node dist/cli-index.js buy-fida-cards \
  --insurance-id 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb \
  -k /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/stake.skey \
  --fida-cards 1,2

node dist/cli-index.js complete-funding \
  --insurance-id 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb \
  -k /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/stake.skey

node dist/cli-index.js issue-claim \
  --insurance-id 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb \
  --claim-amount 10000000 \
  --claim-reason 'I need money !' \
  -k /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/stake.skey
```

### Short Lived (policy-3)

```
node dist/cli-index.js get-policy --insurance-id 945af5bec28946abf49b1fe646135a7bcad6c83e5b699ca78b0a630f

Insurance Id : 945af5bec28946abf49b1fe646135a7bcad6c83e5b699ca78b0a630f
Address      : addr_test1wzgukz4qrve4fvt7epp62lzwaepareynmfffn55kvvhk46suyfhx7
Payment      : Paid
Insurance    :
    - Collateral:                   100000000
    - Fida card value:              50000000
    - Fida card quantity:           2
    - Premium amount:               20000000
    - Installments:
          - interval: 90 days    | amount: 2500000
          - interval: 90 days    | amount: 2500000
          - interval: 90 days    | amount: 2500000
          - interval: end        | amount: 2500000
    - Insurance period:             15 minutes
    - Policy holder:                (PubKeyHash (Ed25519KeyHash (unsafePartial $ fromJust $ fromBytes (hexToByteArrayUnsafe "fac649cff91290b8222b0594c121daf1f7d8d1ae3f8026f8dc15626f"))))
    - Policy authority:             (SingleSign (PubKeyHash (Ed25519KeyHash (unsafePartial $ fromJust $ fromBytes (hexToByteArrayUnsafe "81e5819399c73eeef29db727fe36a2a0a2d4555955af7f3f51fc9a05")))))
    - State:                        OnRisk
    - Funding deadline:             11-12-2024 12:00
    - Claim accepted amount:        0
    - Claim time to live:           7 days
    - Claim time to pay:            5 days
    - Start date:                   11-11-2024 08:22
    - Current claim:                No claim
Piggy banks  :
     - (1)     addr_test1wrleu372t320vcpe2x65x52c0nyv3l7cyl564her9rayg0c8kvsr9 | collateral: 51180940 / 50000000 | premium: 10000000 / 10000000 r: 0 | claims: []
     - (2)     addr_test1wpazhc7gtmglgh00ygh23jk54wrrr0n5ezy7dd68t3f2l7cfak7cw | collateral: 51180940 / 50000000 | premium: 10000000 / 10000000 r: 0 | claims: []
```

#### Create, pay for policy, buy fida cards, complete funding & issue a claim

```
node dist/cli-index.js make-new-policy \
   --input-utxo '9612a86dd61b68dc5097e22216b2cee6c6cddeb274ad9ccc7cf33e0e101d824e#1' \
   --collateral-amount=100000000 \
   --insurance-price 20000000 \
   --insurance-period "15 minutes" \
   --funding-deadline 2024-11-12 \
   --policy-holder-pkh 'fac649cff91290b8222b0594c121daf1f7d8d1ae3f8026f8dc15626f' \
   --fida-card-quantity 2 \
   --single-sign-governance-authority '81e5819399c73eeef29db727fe36a2a0a2d4555955af7f3f51fc9a05'

node dist/cli-index.js pay-for-a-policy \
  --insurance-id 945af5bec28946abf49b1fe646135a7bcad6c83e5b699ca78b0a630f \
  -k /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/stake.skey

node dist/cli-index.js buy-fida-cards \
  --insurance-id 945af5bec28946abf49b1fe646135a7bcad6c83e5b699ca78b0a630f \
  -k /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/stake.skey \
  --fida-cards 1,2

node dist/cli-index.js complete-funding \
  --insurance-id 945af5bec28946abf49b1fe646135a7bcad6c83e5b699ca78b0a630f \
  -k /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/e06ec2bf-2da8-4157-8825-34f547180941/stake.skey
```

## New Functionalities in version 0.0.3

### Fail claim (fail-claim, called by policy authority)

```
node dist/cli-index.js fail-claim \
  --insurance-id 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb

node dist/cli-index.js get-policy --insurance-id 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb
```

### Claim premium (claim-premium, called by investor)

```
node dist/cli-index.js claim-premium \
  --insurance-id 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb \
  -k /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/stake.skey \
  --fida-cards 1,2 \
  --premium-amount 2500000

node dist/cli-index.js get-policy --insurance-id 6e7694000d40f34634ed8a31353adf4c6206d64a9167f9a6cb5f3ceb
```

### Pay for claim optionally using own funds (pay-for-claim, called by investor)

```
node dist/cli-index.js pay-for-claim \
  --insurance-id 16d097c673e7dc956baa45be6f8778e79a0bef4df1d44cbd98da7f93 \
  -k /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/stake.skey \
  --fida-cards 1,2 \
  --own-funds-amount 1000000

node dist/cli-index.js get-policy --insurance-id 16d097c673e7dc956baa45be6f8778e79a0bef4df1d44cbd98da7f93
```

### Expire policy (expire-policy, called by anyone)

```
node dist/cli-index.js expire-policy \
  --insurance-id 945af5bec28946abf49b1fe646135a7bcad6c83e5b699ca78b0a630f \
  -k /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/stake.skey

node dist/cli-index.js get-policy --insurance-id 945af5bec28946abf49b1fe646135a7bcad6c83e5b699ca78b0a630f
```

### Unlock investor collateral (unlock-collateral, called by investor)

```
node dist/cli-index.js unlock-collateral \
  --insurance-id 945af5bec28946abf49b1fe646135a7bcad6c83e5b699ca78b0a630f \
  -k /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/payment.skey \
  -K /home/ssledz/etc/.cardano-wallets/preview/9557307d-8930-423c-a2c3-750dd058435f/stake.skey \
  --fida-cards 1,2

node dist/cli-index.js get-policy --insurance-id 945af5bec28946abf49b1fe646135a7bcad6c83e5b699ca78b0a630f
```

## On Chain evidence (transactions hashes)

| Action            | Transaction                                                                                                                |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------- |
| fail-claim        | [9612a86dd61](https://preview.cardanoscan.io/transaction/9612a86dd61b68dc5097e22216b2cee6c6cddeb274ad9ccc7cf33e0e101d824e) |
| claim-premium     | [bc537db8d4d](https://preview.cardanoscan.io/transaction/bc537db8d4d3c4bd831ba1f8b0317b3f9dfcb716133073032263d8a96042f5c1) |
| "                 | [9ed730db98a](https://preview.cardanoscan.io/transaction/9ed730db98a90361d26674db6c3f5d626b37f802c4eebf20f42ce12baa3fb5d9) |
| pay-for-claim     | [0aea116de2f](https://preview.cardanoscan.io/transaction/0aea116de2fbfad161fd4350e622e48f427121a1d6b3f127a20251d03c4eb2b3) |
| "                 | [127a5af1dfc](https://preview.cardanoscan.io/transaction/127a5af1dfc09615da2721a72a7bdaee4a7aa385e5e9a874502042aeaa659336) |
| expire-policy     | [7680acc7b8f](https://preview.cardanoscan.io/transaction/7680acc7b8fa3e7169dc8d3363d2678c1f7c4110cb3e03c0c950252dce7e1b2e) |
| unlock-collateral | [3ebc5bf6929](https://preview.cardanoscan.io/transaction/3ebc5bf692973ad1a56bc5c9fc6576979a1c9f34ac47d4f6370ad784d0cebca6) |
| "                 | [3c48434a3ad](https://preview.cardanoscan.io/transaction/3c48434a3ad858141ed50a39d7f28a0acb274927f67d0ccd66eb9a4944b832ab) |

## Video Walkthrough

Here's a step by step video walkthrough of all the relevant operations introduced for claims management in version 0.0.3:

{% embed url="<https://drive.google.com/file/d/1-5X0Kx88IMN3sJ5veg8LbPxAhtjfKKhN/view?usp=drive_link>" %}
Video Walkthrough
{% endembed %}