Governance

Search…
Governance
What is Cover Incident?
The term cover incident refers to a state in which all cover rules and exclusions have been met.
In the Neptune Mutual Protocol, a cover incident must go through a governance process to reach a resolution. Once an incident is reported, the resolution can be either Incident Occurred or False Reporting. The protocol is designed to punish users who try to cheat the governance system by confiscating all their stakes. To incentivize participation, the users who report in the governance system may earn some extra NPM rewards in a very short span of time (usually one week).
When a cover incident occurs, anyone can report it and earn a 5% commission on the protocol's fee earnings. Before submitting any incident, make sure you understand the following:
For the event to qualify as a cover incident,  all terms and rules of the cover must be met.
The users who agree with the incident can add more votes/stakes or add attestations to the report.
The users who disagree with the incident reporting can dispute or refute. Disputing allows anyone to mark the reported incident as False Reporting once. After that, the users who believe the incident reporting is a mistake can add more NPM votes/stakes by refuting.
There is a 7-day reporting period for users to participate in the governance process. The end of the reporting period is called Resolution Date.
The outcome of the cover incident will be achieved on the resolution date. The users who vote against the majority will lose all their stake to the majority.
Get Minimum Stake
Returns the minimum number of NPM tokens you need to stake to report an incident. Note that this number does not apply afterwards once a report has be submitted.
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { getProvider } from './provider.js'
3
import { weiAsNep } from './bn.js'
4
​
5
const getMinStake = async () => {
6
  const provider = getProvider()
7
​
8
  const response = await governance.getMinStake(ChainId.Mumbai, provider)
9
  console.info('Minimum Reporting Stake: %s', weiAsNep(response.result))
10
}
11
​
12
getMinStake()
13
​
14
/*****************************************************************************
15
Minimum Reporting Stake: 250.00 NPM
16
*****************************************************************************/
Copied!
Report an Incident (Incident Happened)
The first user who reports a cover incident becomes the Cover Reporter. You will need to stake at least 250 NPM tokens to report an incident.
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { info } from './info.js'
3
import { getProvider } from './provider.js'
4
import { ether } from './bn.js'
5
​
6
const payload = {
7
  title: 'Test Exploit',
8
  observed: new Date(),
9
  proofOfIncident: 'https://etherscan.io/tokenholdings?a=0xA9AD3537C819ae0530623aFb458Fee8456C47d33',
10
  description: 'DeFi protocol Learn Finance has reported that its vault was exploited by a hacker to the tune of $11 million on Dec 25.',
11
  stake: ether(250)
12
}
13
​
14
const report = async () => {
15
  const { key } = info
16
  const provider = getProvider()
17
​
18
  await governance.approveStake(ChainId.Mumbai, {}, provider)
19
​
20
  const response = await governance.report(ChainId.Mumbai, key, payload, provider)
21
  console.info(response)
22
}
23
​
24
report()
25
​
26
/*****************************************************************************
27
[info] {
28
  status: 'Success',
29
  result: {
30
    storage: {
31
      hashBytes32: '0xb09e406e9d065bca48b280b4c670c47d4e1b9107770a6280e3272a48773e24fe',
32
      hash: 'QmaE6RV25JCwMB1ycYD7YRMdeCXmA58h1KC7v4NphqTs3s',
33
      permalink: 'https://ipfs.infura.io/ipfs/QmaE6RV25JCwMB1ycYD7YRMdeCXmA58h1KC7v4NphqTs3s'
34
    },
35
    tx: {
36
      nonce: 1,
37
      gasPrice: [BigNumber],
38
      gasLimit: [BigNumber],
39
      to: '0x9A95A975a8f705806B5eF5D13B40a597bf8ab94f',
40
      value: [BigNumber],
41
      data: '0xeefd2cf770726f746f3a636f6e7472616374733a636f7665723a6366633a303100000002b09e406e9d065bca48b280b4c670c47d4e1b9107770a6280e3272a48773e24fe00000000000000000000000000000000000000000000000d8d726b7177a80000',
42
      chainId: 80001,
43
      v: 160038,
44
      r: '0x67072717959337fbffae14f7eba3770c0250e7ac456087c6791fa16adf968dad',
45
      s: '0x1bee01b72904e62c696bbc3c8378e90d22edc2cc2ce72a4f38e13e3ddf332355',
46
      from: '0x076F91C0A411197e6Fce476F37c6385CCeacd26D',
47
      hash: '0x0363d3abdf746ed66651a40bc8f53509d66c8f428ff527fddbbed51ac9d6ca3c',
48
      type: null,
49
      wait: [Function (anonymous)]
50
    }
51
  }
52
}
53
*****************************************************************************/
Copied!
Dispute an Incident (False Reporting)
The first user who submits their NPM stake to disagree with a reported cover incident becomes the Candidate Cover Reporter. You will need to stake at least 250 NPM tokens to dispute a reported incident.
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { info } from './info.js'
3
import { getProvider } from './provider.js'
4
import { ether } from './bn.js'
5
​
6
const dispute = async () => {
7
  const { key } = info
8
  const provider = getProvider(true)
9
​
10
  const stake = ether(250)
11
​
12
  await governance.approveStake(ChainId.Mumbai, {}, provider)
13
  const response = await governance.dispute(ChainId.Mumbai, key, stake, provider)
14
​
15
  console.info(response)
16
}
17
​
18
dispute()
19
​
20
/*****************************************************************************
21
[info] {
22
  status: 'Success',
23
  result: {
24
    nonce: 1,
25
    gasPrice: BigNumber { _hex: '0x06fc23ac00', _isBigNumber: true },
26
    gasLimit: BigNumber { _hex: '0x040341', _isBigNumber: true },
27
    to: '0x9A95A975a8f705806B5eF5D13B40a597bf8ab94f',
28
    value: BigNumber { _hex: '0x00', _isBigNumber: true },
29
    data: '0x1386012570726f746f3a636f6e7472616374733a636f7665723a6366633a3031000000020000000000000000000000000000000000000000000000000000000060f6c262000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000d8d726b7177a80000',
30
    chainId: 80001,
31
    v: 160038,
32
    r: '0xd38c21cacfb4fa35e7b7293037fb71690c999547db178571b2a804966c904c1f',
33
    s: '0x7f122b5ee3b88cccfbae388a5abfb23fb88231475e6d90fb46b248e9e1adc42b',
34
    from: '0xA3dEE71417e31C0A09F33690cA55052018041a94',
35
    hash: '0xe9c510d5c78df270ab0b1c9ba29b14397710008597d28d24a129ff642579433b',
36
    type: null,
37
    wait: [Function (anonymous)]
38
  }
39
}
40
*****************************************************************************/
Copied!
Add an Attestation (Incident Occurred)
Adding an attestation means that you believe and support the reported incident. You can stake any number of NPM tokens and vote for the support of the Incident Occurred side.
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { info } from './info.js'
3
import { getProvider } from './provider.js'
4
import { ether, weiAsNep } from './bn.js'
5
​
6
const attest = async () => {
7
  const { key, coverName } = info
8
  const provider = getProvider()
9
​
10
  const stake = ether(100)
11
  const incidentDate = (await governance.getIncidentDate(ChainId.Mumbai, key, provider)).result
12
​
13
  let response = await governance.getStakes(ChainId.Mumbai, key, incidentDate, provider)
14
  console.info('[%s Reporting Stake: Yes] Before: %s', coverName, weiAsNep(response.result.yes))
15
​
16
  await governance.approveStake(ChainId.Mumbai, {}, provider)
17
  response = await governance.attest(ChainId.Mumbai, key, stake, provider)
18
  console.info(response)
19
​
20
  await response.result.wait()
21
​
22
  response = await governance.getStakes(ChainId.Mumbai, key, incidentDate, provider)
23
  console.info('[%s Reporting Stake: Yes] After: %s', coverName, weiAsNep(response.result.yes))
24
}
25
​
26
attest()
27
​
28
/*****************************************************************************
29
[info] [Compound Finance Cover Reporting Stake: Yes] Before: 250.00 NPM
30
[info] {
31
  status: 'Success',
32
  result: {
33
    nonce: 1,
34
    gasPrice: BigNumber { _hex: '0x06fc23ac00', _isBigNumber: true },
35
    gasLimit: BigNumber { _hex: '0x02d10b', _isBigNumber: true },
36
    to: '0x9A95A975a8f705806B5eF5D13B40a597bf8ab94f',
37
    value: BigNumber { _hex: '0x00', _isBigNumber: true },
38
    data: '0x789c846770726f746f3a636f6e7472616374733a636f7665723a6366633a3031000000020000000000000000000000000000000000000000000000000000000060f6c2620000000000000000000000000000000000000000000000056bc75e2d63100000',
39
    chainId: 80001,
40
    v: 160037,
41
    r: '0xbfd3235a892e061456aa89afc52c6c73d3fd16a5ceac4c02e931c464869d3b16',
42
    s: '0x4988dece2b1202ae7394d6e1b380e5dca6f44ac3278f4d80e5cb61d1db6927fb',
43
    from: '0x076F91C0A411197e6Fce476F37c6385CCeacd26D',
44
    hash: '0xbaf310d9a9ea1a39fae97ebe6c98f30e005aede879b7750a3abdabbae4d0e6c0',
45
    type: null,
46
    wait: [Function (anonymous)]
47
  }
48
}
49
[info] [Compound Finance Cover Reporting Stake: Yes] After: 350.00 NPM
50
*****************************************************************************/
Copied!
Add a Refutation
By refuting, you prove your support for the side who disagree with the reported incident. You can stake any number of NPM tokens and vote to support the False Reporting side.
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { info } from './info.js'
3
import { getProvider } from './provider.js'
4
import { ether, weiAsNep } from './bn.js'
5
​
6
const refute = async () => {
7
  const { key, coverName } = info
8
  const provider = getProvider()
9
​
10
  const stake = ether(100)
11
  const incidentDate = (await governance.getIncidentDate(ChainId.Mumbai, key, provider)).result
12
​
13
  let response = await governance.getStakes(ChainId.Mumbai, key, incidentDate, provider)
14
  console.info('[%s Reporting Stake: No] Before: %s', coverName, weiAsNep(response.result.no))
15
​
16
  await governance.approveStake(ChainId.Mumbai, {}, provider)
17
  response = await governance.refute(ChainId.Mumbai, key, stake, provider)
18
  console.info(response)
19
​
20
  await response.result.wait()
21
​
22
  response = await governance.getStakes(ChainId.Mumbai, key, incidentDate, provider)
23
  console.info('[%s Reporting Stake: No] After: %s', coverName, weiAsNep(response.result.no))
24
}
25
​
26
refute()
27
​
28
/*****************************************************************************
29
[info] [Compound Finance Cover Reporting Stake: No] Before: 250.00 NPM
30
[info] {
31
  status: 'Success',
32
  result: {
33
    nonce: 1,
34
    gasPrice: BigNumber { _hex: '0x06fc23ac00', _isBigNumber: true },
35
    gasLimit: BigNumber { _hex: '0x0313c0', _isBigNumber: true },
36
    to: '0x9A95A975a8f705806B5eF5D13B40a597bf8ab94f',
37
    value: BigNumber { _hex: '0x00', _isBigNumber: true },
38
    data: '0xf1a4115070726f746f3a636f6e7472616374733a636f7665723a6366633a3031000000020000000000000000000000000000000000000000000000000000000060f6c2620000000000000000000000000000000000000000000000056bc75e2d63100000',
39
    chainId: 80001,
40
    v: 160038,
41
    r: '0x07d9aaa8a4479d472563fbe07eb328ebdf3ea8e7c19e2816457a4f1ce12d8da6',
42
    s: '0x258d5210785bdbd3c80c3c9afe10df28131320e4ca191e58a6fb9f67f4494e8e',
43
    from: '0x076F91C0A411197e6Fce476F37c6385CCeacd26D',
44
    hash: '0x8e1c0ae87be7b4bbc758759ce10113b6e1f46399b2690b1298ea9e06d2d5965a',
45
    type: null,
46
    wait: [Function (anonymous)]
47
  }
48
}
49
[info] [Compound Finance Cover Reporting Stake: No] After: 350.00 NPM
50
*****************************************************************************/
Copied!
Get Status
Gets the status of a given cover.
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { info } from './info.js'
3
import { getProvider } from './provider.js'
4
​
5
const getStatus = async () => {
6
  const { key, coverName } = info
7
  const provider = getProvider()
8
​
9
  const response = await governance.getStatus(ChainId.Mumbai, key, provider)
10
  console.info('[%s] Status: %s', coverName, response.result)
11
}
12
​
13
getStatus()
14
​
15
/*****************************************************************************
16
[info] [Compound Finance Cover] Status: { key: 'IncidentHappened', value: 2 }
17
*****************************************************************************/
Copied!
Get Incident Date
Gets the incident date by the given cover key.
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { info } from './info.js'
3
import { getProvider } from './provider.js'
4
import { toDate } from './bn.js'
5
​
6
const getIncidentDate = async () => {
7
  const { key, coverName } = info
8
  const provider = getProvider()
9
​
10
  const response = await governance.getIncidentDate(ChainId.Mumbai, key, provider)
11
  console.info('[%s] Incident Date: %s', coverName, toDate(response.result).toUTCString())
12
}
13
​
14
getIncidentDate()
15
​
16
/*****************************************************************************
17
[info] [Compound Finance Cover] Incident Date: Tue, 20 Jul 2021 12:32:34 GMT
18
*****************************************************************************/
Copied!
Get Reporter
Gets the reporter of the given cover (if any).
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { info } from './info.js'
3
import { getProvider } from './provider.js'
4
​
5
const getReporter = async () => {
6
  const { key, coverName } = info
7
  const provider = getProvider()
8
​
9
  const incidentDate = (await governance.getIncidentDate(ChainId.Mumbai, key, provider)).result
10
​
11
  const response = await governance.getReporter(ChainId.Mumbai, key, incidentDate, provider)
12
  console.info('[%s] Reporter: %s', coverName, response.result)
13
}
14
​
15
getReporter()
16
​
17
/*****************************************************************************
18
[info] [Compound Finance Cover] Reporter: 0x076F91C0A411197e6Fce476F37c6385CCeacd26D
19
*****************************************************************************/
Copied!
Based on the stakes of each side, the returned value is either the original cover reporter or the candidate cover reporter.
Get Stakes
Returns the stakes submitted by the users on each side.
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { info } from './info.js'
3
import { getProvider } from './provider.js'
4
import { weiAsNep } from './bn.js'
5
​
6
const getStakes = async () => {
7
  const { key, coverName } = info
8
  const provider = getProvider()
9
​
10
  const incidentDate = (await governance.getIncidentDate(ChainId.Mumbai, key, provider)).result
11
  const response = await governance.getStakes(ChainId.Mumbai, key, incidentDate, provider)
12
  const { yes, no } = response.result
13
​
14
  console.info('[%s Stakes] Yes: %s. No: %s', coverName, weiAsNep(yes), weiAsNep(no))
15
}
16
​
17
getStakes()
18
​
19
/*****************************************************************************
20
[info] [Compound Finance Cover Stakes] Yes: 350.00 NPM. No: 350.00 NPM
21
*****************************************************************************/
Copied!
Get Stakes of an Account
Returns the stakes submitted by the given account on each side.
1
import { ChainId, governance } from '@neptunemutual/sdk'
2
import { info } from './info.js'
3
import { getProvider } from './provider.js'
4
import { weiAsNep } from './bn.js'
5
​
6
const getStakesOf = async () => {
7
  const { key, coverName } = info
8
  const provider = getProvider()
9
​
10
  const account = provider.address
11
  const incidentDate = (await governance.getIncidentDate(ChainId.Mumbai, key, provider)).result
12
  const response = await governance.getStakesOf(ChainId.Mumbai, key, incidentDate, account, provider)
13
  const { yes, no } = response.result
14
​
15
  console.info('[%s Stakes Of %s] Yes: %s. No: %s', coverName, account, weiAsNep(yes), weiAsNep(no))
16
}
17
​
18
getStakesOf()
19
​
20
/*****************************************************************************
21
[info] [Compound Finance Cover Stakes Of 0x076F91C0A411197e6Fce476F37c6385CCeacd26D]
22
Yes: 350.00 NPM. No: 100.00 NPM
23
*****************************************************************************/
Copied!
Finalize the Reporting
A report can be finalized after the claim expiry period. Once finalized, policies for the cover in question can be purchased again.
1
await governance.finalize(<ChainId>, <key>, <incidentDate>, <provider>)
Copied!
This feature is only accessible to the governance system or the protocol admins.
Always refer to the Protocol Fee document for the latest information since the fees are configurable and can change.
Neptune Mutual SDK - Previous
Purchase a Policy
Next - Neptune Mutual SDK
Claims & Payouts
Last modified 8d ago
Copy link
Contents
What is Cover Incident?
Get Minimum Stake
Report an Incident (Incident Happened)
Dispute an Incident (False Reporting)
Add an Attestation (Incident Occurred)
Get Stakes of an Account
Finalize the Reporting