Claims Management

Walkthrough of managing claims through the CLI tool

Execution Details

network: preview

cardano-node: 10.1.2

kupo: 2.9.0

ogmios: 6.7.0

fida-cli: 0.0.3

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)

Video Walkthrough

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

PreviousPolicy ManagementNextPolicy Contract

Last updated