31:T75c,md`# PMF Endpoints (repo-based experiment) ## ecosystem dashboard data sources (as of 15 feb 2021) ### Repos and their activity that is currently tracked PMF value is calculated based on the number of ["events"](https://docs.github.com/en/developers/webhooks-and-events/github-event-types) that any repository that is related to the "PL Web 3 stack" has generated during a week. All event types (commits, pull requests, comments etc) are currently weighted evenly except star events (named "WatchEvent" in the GitHub API) which are ignored. Repositories are considered to be "related" to the "PL Web 3 stack" if they match one or more of the following: - they belong to one of the PL github orgs (ipfs, ipld, libp2p etc) - they have a direct or indirect dependency on one or more of the packages that have been published from a PL github org (ipfs, ipld, libp2p etc) - they have shown up in github search results for "PL web 3 stack" keywords (currently "ipfs", "libp2p" or "filecoin") - they belong to a known collaborator of the "PL web 3 stack" (textile, 3box, pinata etc) Filecoin and filecoin-shipyard are currently tracked and scored seperately but users may show up in PMF metrics for both IPFS and filecoin Package manager support is currently limited to npm, go and cargo (rust) ### Optional URL parameters - \`end_date\` - ISO 8601 format YYYY-MM-DD (i.e. 2021-02-20), defaults to 3 days ago - \`start_date\` - ISO 8601 format YYYY-MM-DD (i.e. 2020-12-01), defaults to 4 weeks before the \`end_date\` - \`threshold\` - score threshold for things to be considered high value, defaults to \`5\` - \`window\` - length of period, either \`week\` or \`month\`, also can accept a positive integer for number of days, defaults to \`14\`; - \`dependency_threshold\` - minimum number of dependencys on PL packages to be considered valid activity, defaults to \`1\` `32:T784,md` ## transitions.json https://ipfs.ecosystem-dashboard.com/pmf/repo/transitions.json

[
  {
    "date": "2021-01-11T00:00:00.000Z",
    "transitions": {
      "First Time": 4028,
      "Bounced": 0,
      "New Low-Value": 0,
      "New High-Value": 0,
      "Reactivated Low-Value": 66,
      "Low to High-Value": 184,
      "High to Low-Value": 153,
      "Lapsed Low-Value": 3600,
      "Reactivated High-Value": 17,
      "Lapsed High-Value": 186,
      "High-Value": 692,
      "Low-Value": 463,
      "Inactive": 1012
    }
  },
  {
    "date": "2021-01-18T00:00:00.000Z",
    "transitions": {
      "First Time": 4124,
      "Bounced": 3417,
      "New Low-Value": 434,
      "New High-Value": 177,
      "Reactivated Low-Value": 285,
      "Low to High-Value": 113,
      "High to Low-Value": 138,
      "Lapsed Low-Value": 389,
      "Reactivated High-Value": 43,
      "Lapsed High-Value": 92,
      "High-Value": 663,
      "Low-Value": 180,
      "Inactive": 4470
    }
  },
  {
    "date": "2021-01-25T00:00:00.000Z",
    "transitions": {
      "First Time": 5663,
      "Bounced": 3675,
      "New Low-Value": 370,
      "New High-Value": 79,
      "Reactivated Low-Value": 526,
      "Low to High-Value": 149,
      "High to Low-Value": 147,
      "Lapsed Low-Value": 586,
      "Reactivated High-Value": 108,
      "Lapsed High-Value": 93,
      "High-Value": 756,
      "Low-Value": 302,
      "Inactive": 7734
    }
  },
  {
    "date": "2021-02-01T00:00:00.000Z",
    "transitions": {
      "First Time": 4689,
      "Bounced": 5251,
      "New Low-Value": 357,
      "New High-Value": 55,
      "Reactivated Low-Value": 632,
      "Low to High-Value": 147,
      "High to Low-Value": 162,
      "Lapsed Low-Value": 848,
      "Reactivated High-Value": 102,
      "Lapsed High-Value": 147,
      "High-Value": 783,
      "Low-Value": 350,
      "Inactive": 11354
    }
  }
]

`33:T468,dependency = md `## Dependency Events You can fetch dependency event information for repositories that have included a PL dependency at some point in their git history. This data is browsable in html here: - https://ipfs.ecosystem-dashboard.com/dependency_events - https://filecoin.ecosystem-dashboard.com/dependency_events There is a json api also available: - https://ipfs.ecosystem-dashboard.com/dependency_events.json - https://filecoin.ecosystem-dashboard.com/dependency_events.json The follow parameters are available for filtering results: - \`action\` - can be either \`added\`, \`modified\` or \`removed\` - \`platform\` - can be either \`go\`, \`npm\` or \`cargo\` (rust) - \`package\` - the name of the package being added, modified or removed as a dependency (recommended to be used alongside \`platform\` as some package names exist in multiple platforms) - \`manifest_kind\` - can be either \`manifest\` (package.json, go.mod etc) or \`lockfile\` (package-lock.json, go.sum etc) - \`repository\` - the full name (case sensitive) of a repository that has had dependency events, for example \`Coinic/platform\` `34:[] 2f:{"title":"PMF Endpoints (repo-based experiment)","cells":[{"id":0,"value":"$31","pinned":false,"hidden":false,"mode":"ojs"},{"id":34,"value":"ipfsGetStatesUrl = 'https://ipfs.ecosystem-dashboard.com/pmf/repo/states.json'","pinned":false,"hidden":false,"mode":"ojs"},{"id":41,"value":"filecoinGetStatesUrl = \"https://filecoin.ecosystem-dashboard.com/pmf/repo/states.json\" ","pinned":false,"hidden":false,"mode":"ojs"},{"id":28,"value":"md`\n\n## states.json\n\nhttps://ipfs.ecosystem-dashboard.com/pmf/repo/states.json\n\n

\n[\n  {\n    \"date\": \"2021-01-11T00:00:00.000Z\",\n    \"states\": {\n      \"first\": 4028,\n      \"high\": 893,\n      \"low\": 682,\n      \"inactive\": 4798\n    }\n  },\n  {\n    \"date\": \"2021-01-18T00:00:00.000Z\",\n    \"states\": {\n      \"high\": 996,\n      \"low\": 1037,\n      \"first\": 4124,\n      \"inactive\": 8368\n    }\n  },\n  {\n    \"date\": \"2021-01-25T00:00:00.000Z\",\n    \"states\": {\n      \"high\": 1092,\n      \"first\": 5663,\n      \"low\": 1345,\n      \"inactive\": 12088\n    }\n  },\n  {\n    \"date\": \"2021-02-01T00:00:00.000Z\",\n    \"states\": {\n      \"low\": 1501,\n      \"high\": 1087,\n      \"first\": 4689,\n      \"inactive\": 17600\n    }\n  }\n]\n

\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":55,"value":"ipfsGetTransitionsUrl = 'https://ipfs.ecosystem-dashboard.com/pmf/repo/transitions.json'\n","pinned":false,"hidden":false,"mode":"ojs"},{"id":58,"value":"filecoinGetTransitionsUrl = \"https://filecoin.ecosystem-dashboard.com/pmf/repo/transitions.json\"\n","pinned":false,"hidden":false,"mode":"ojs"},{"id":20,"value":"$32","pinned":false,"hidden":false,"mode":"ojs"},{"id":25,"value":"md`\n### Params\n\nhttps://ipfs.ecosystem-dashboard.com/pmf/repo/transition.json?transition_name=First%20Time\n\n

\n[\n  {\n    \"date\": \"2020-05-04T00:00:00.000Z\",\n    \"transitions\": {\n      \"First Time\": 2094\n    }\n  },\n  {\n    \"date\": \"2020-05-11T00:00:00.000Z\",\n    \"transitions\": {\n      \"First Time\": 1603\n    }\n  },\n  {\n    \"date\": \"2020-05-18T00:00:00.000Z\",\n    \"transitions\": {\n      \"First Time\": 1022\n    }\n  },\n  {\n    \"date\": \"2020-05-25T00:00:00.000Z\",\n    \"transitions\": {\n      \"First Time\": 1122\n    }\n  }\n]\n

\n\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":81,"value":"combinedTransitionsUrl = 'https://ipfs.ecosystem-dashboard.com/pmf/repo/combined/transitions.json'","pinned":true,"hidden":false,"mode":"ojs"},{"id":82,"value":"combinedStatesUrl = 'https://ipfs.ecosystem-dashboard.com/pmf/repo/combined/states.json'","pinned":true,"hidden":false,"mode":"ojs"},{"id":74,"value":"md`\n## Combined Endpoints\nDue to the crossover of repositories that can depend on both IPFS and Filecoin packages, simply combining the totals between the two instances will produce incorrect results. \n\nInstead we have a seperate set of endpoints on the IPFS ecosystem dashboard that will return deduped, combined data from both IPFS and Filecoin. \n\nAll parameters and defaults are the same as the regular endpoints.\n\n- https://ipfs.ecosystem-dashboard.com/pmf/repo/combined/states.json\n- https://ipfs.ecosystem-dashboard.com/pmf/repo/combined/transitions.json\n- https://ipfs.ecosystem-dashboard.com/pmf/repo/combined/state.json?state_name=high\n- https://ipfs.ecosystem-dashboard.com/pmf/repo/combined/transition.json?state_name=Bounced\n- https://ipfs.ecosystem-dashboard.com/repositories/combined/states.json\n- https://ipfs.ecosystem-dashboard.com/repositories/combined/transitions.json\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":92,"value":"$33","pinned":false,"hidden":false,"mode":"ojs"},{"id":88,"value":"md `## Batch Repository Info\n\nYou can use this endpoint to load richer information about any number of repositories in the ecosystem dashboards, simply pass a comma seperated list of repository full names, \\`ipfs/go-ipfs,matrix-org/scoreboard\\` for example. \n\nNames are case sensitive and repositories are returned ordered by name alphabetically.\n\nhttps://ipfs.ecosystem-dashboard.com/pmf/repositories?names=ipfs/go-ipfs,matrix-org/scoreboard\nhttps://filecoin.ecosystem-dashboard.com/pmf/repositories?names=filecoin-project/venus,ChainSafe/forest\n`","pinned":false,"hidden":false,"mode":"ojs"}],"files":"$W34","stdlib":"1","titling":"auto"}