Deploy unfinished version of Dandelion pages via Markdown

Author: workshop-maybe

components/Layouts/DandelionLayout.js

@@ -0,0 +1,7 @@
+export default function CskCard({ children }) {
+    return (       
+        <div className='box-border shadow-xl h-auto w-1/2 mx-auto my-4 p-4 border-4 bg-purple-200 bg-opacity-50'>
+            {children}
+        </div>    
+    )
+}

data/dandelion-pages/cardano-node-socket.md

@@ -0,0 +1,31 @@
+---
+title: 'cardano-node-socket'
+date: '05-02-2021'
+version: 1
+---      
+
+# cardano-node-socket
+## [coming-soon] cardano-node-socket-over-https
+
+You can use this REST API to setup a local socket file and use cardano-cli against it
+
+cardano-cli is the first class citizen supporting every new blockchain feature, and this endpoint helps to transport a cardano-node's socket to you using a secure HTTPS tunnel.\n Currently access to this API is enabled on demand. Authorization and secure channel is setup with https://github.com/jpillora/chisel and TCP-to-socket termination can be done by using `socat`
+
+![](/showcase-comingsoon.jpg)
+
+- [View on IOHK GitHub](https://github.com/input-output-hk/cardano-node#cardano-cli)
+- [Official Documentation](https://github.com/input-output-hk/cardano-node/blob/master/cardano-cli/README.md)
+
+
+- "mainnet": { "version": "1.25.1" }
+- "testnet": { "version": "1.25.1" }
+
+- [testnet](https://cardano-node-socket.testnet.`+process.env.REACT_APP_API_DOMAIN+`)
+- [mainnet](https://cardano-node-socket.mainnet.`+process.env.REACT_APP_API_DOMAIN+`)
+
+
+```
+~~~bash
+# TODO
+~~~
+```

data/dandelion-pages/explorer-api.md

@@ -0,0 +1,28 @@
+---
+title: 'explorer-api'
+date: '05-02-2021'
+version: 1
+---
+
+# cardano-rest/explorer-api
+## You can use this REST API to gather basic info from the blockchain
+
+This is the currently officially supported API to explore Cardano transactions. In future it may be augmented or replaced by cardano-graphql, but cardano-explorer-api will be supported for some time, even once alternatives become available.
+
+![](/showcase-explorer-api.png)
+
+- [View on IOHK GitHub](https://github.com/input-output-hk/cardano-rest#overview)
+- [Official Documentation](https://input-output-hk.github.io/cardano-rest/explorer-api)
+- mainnet: `"version": "3.1.1"`
+- testnet: `"version": "3.1.1"`
+- [testnet](https://explorer-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`)
+- [mainnet](https://explorer-api.mainnet.`+process.env.REACT_APP_API_DOMAIN+`)
+
+```
+    - [graphql](https://github.com/input-output-hk/cardano-graphql/tree/master/packages/api-cardano-db-hasura/src/example_queries)
+    - bash:
+    ~~~bash
+    curl -s \\
+    https://explorer-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`/api/txs/last
+    ~~~
+```

data/dandelion-pages/graphql-api.md

@@ -0,0 +1,43 @@
+---
+title: 'graphql-api'
+date: '05-02-2021'
+version: 1
+---    
+
+# graphql-api
+## hasura/graphql-api
+
+You can use this GraphQL API to gather composed info from the blockchain
+
+GraphQL is a query language and execution environment with server and client implementations across many programming languages. The language can be serialized for network transmission, schema implementations hashed for assurance, and is suited for describing most domains.\nCardano project is implementing a GraphQL API, to make exploring blockchain data a breeze.
+
+![](showcase-graphql-api.png)
+
+- [View on IOHK GitHub](https://github.com/input-output-hk/cardano-graphql#overview)
+- [Official Documentation](https://input-output-hk.github.io/cardano-graphql/)
+
+- "mainnet": { "version": "3.2.0" }
+- "testnet": { "version": "3.2.0" }
+
+- [testnet](https://graphql-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`)
+- [mainnet](https://graphql-api.mainnet.`+process.env.REACT_APP_API_DOMAIN+`)
+
+
+```
+    - bash:    
+    ~~~bash
+    # query db sync status
+    curl -H 'Content-Type: application/json' \\
+        -H 'Accept: application/json' \\
+        --data-binary \\
+    '{"query": \
+        "query cardanoDbSyncProgress {\\n\
+        cardanoDbMeta {\\n\
+            initialized\\n\
+            syncPercentage\\n\
+        }\\n\
+    }\\n\
+    "}' \\
+        https://graphql-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`
+    ~~~
+```

data/dandelion-pages/ogmios-api.md

@@ -0,0 +1,34 @@
+---
+title: 'ogmios-api'
+date: '05-02-2021'
+version: 1
+---    
+
+# ogmios-api
+## headerTitle: "KtorZ's cardano-node ogmios-api
+
+You can use this JSON-WSP (websocket) API to gather live blockchain info directly from a cardano-node instance
+
+Ogmios is a translation service written in Haskell running on top of cardano-node. It offers a JSON-WSP interface through WebSockets and enables clients to speak Ouroboros' mini-protocols via remote procedure calls over JSON.
+
+![](/showcase-ogmios-api.png)
+- [View on IOHK GitHub](https://github.com/KtorZ/cardano-ogmios)
+- [Official Documentation](https://ktorz.github.io/cardano-ogmios/)
+
+
+- "mainnet": { "version": "2.0.0-beta" },
+- "testnet": { "version": "2.0.0-beta" },
+
+- [testnet (wss)](https://ogmios-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`)
+- [mainnet (wss)](https://ogmios-api.mainnet.`+process.env.REACT_APP_API_DOMAIN+`)
+
+```
+    - bash (using [websocat](https://github.com/vi/websocat)):
+    ~~~bash
+    echo '{ "type": "jsonwsp/request", "version": "1.0", "servicename": "ogmios", "methodname": "RequestNext", "args": {} }' \\
+    | websocat --text -1 - wss://ogmios-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`
+    
+    echo '{ "type": "jsonwsp/request", "version": "1.0", "servicename": "ogmios", "methodname": "FindIntersect", "args": { "points": [ "origin" ] } }' \\
+    | websocat --text -1 - wss://ogmios-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`
+    ~~~
+```

data/dandelion-pages/postgrest-api.md

@@ -0,0 +1,54 @@
+---
+title: 'postgrest-api'
+date: '05-02-2021'
+version: 1
+---    
+
+# postgrest-api
+## cardano-db-sync/postgrest-api
+
+You can use this REST API to perform SQL queries to gather info from the blockchain.
+
+Cardano DB Sync is to follow the Cardano chain and take information from the chain and an internally maintained copy of ledger state. Data is then extracted from the chain and inserted into a PostgreSQL database that can be accessed through a read-only REST API exposed by an instance of the postgREST project.
+
+![](/showcase-postgrest-api.png)
+
+- [View on IOHK GitHub](https://github.com/input-output-hk/cardano-db-sync)
+- [Official Documentation](https://github.com/input-output-hk/cardano-db-sync/blob/master/doc/interesting-queries.md)
+
+
+- "mainnet": { "version": "cardano-db-sync-8.0.0" }
+- "testnet": { "version": "cardano-db-sync-8.0.0" }
+
+
+- [testnet](https://postgrest-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`)
+- [mainnet](https://postgrest-api.mainnet.`+process.env.REACT_APP_API_DOMAIN+`)
+
+```
+- bash:    
+~~~bash
+# query available metadatums
+curl -s "https://postgrest-api.mainnet.dandelion.link/rpc/get_metadatum"
+# query metadatum 20201210
+curl -d metadatum=20201210 -s "https://postgrest-api.mainnet.dandelion.link/rpc/get_metadata" | jq .
+# query metadatum 42 for epoch 234-235 and limit results to 1
+curl -s -d metadatum=42 -d epochs={234,235} "https://postgrest-api.mainnet.dandelion.link/rpc/get_metadata?limit=1"
+# query metadata entry number 15
+curl -s "https://postgrest-api.mainnet.dandelion.link/tx_metadata?id=eq.15"
+# query pool metadata whose URL contains "repsistance" 
+curl -s "https://postgrest-api.mainnet.dandelion.link/pool_meta_data?url=like.*repsistance*"
+# query metadata entries for SPOCRA proposalId "80064c28-1b03-4f1c-abf0-ca8c5a98d5b9"
+curl -s "https://postgrest-api.mainnet.dandelion.link/tx_metadata?json->>ProposalId=eq.80064c28-1b03-4f1c-abf0-ca8c5a98d5b9"
+# query metadata entries for the whole SPOCRA network
+curl -s "https://postgrest-api.mainnet.dandelion.link/tx_metadata?json->>NetworkId=eq.SPOCRA"
+# query transactions history for addresses array
+curl -X POST -H "Content-Type: application/json" -d '{ "data": { "addresses" : ["addr_test1vzep2se0nr849acwfnlpm2sa3sz726g6v78ej4sy9ewjprqmcl720","addr_test1qptw3z77j2vjhd45vdqhct46uvwucese43twz9afv0lt9h83lgv8qkdvg9akyn2yyrtp75sd6ejwl3m0f4qtve43ydnsckuvc4"] } }' -s "https://postgrest-api.testnet.dandelion.link/rpc/get_tx_history_for_addresses" | jq .
+# query delegation history for stake addresses array
+curl -X POST -H "Content-Type: application/json" -d '{ "data": { "addresses" : ["stake_test1uz605p766mvsyrufagjw5fepqfp8x9ff2ty2hzdrjuvuj8g5efx4w","stake_test1uq3zf47elmdxp92wgmcx4lrkjrlts5fffs36c7dz02d7faqye6l9j"] } }' -s "https://postgrest-api.testnet.dandelion.link/rpc/get_delegation_history_for_stake_address" | jq .
+# query addresses balance at the end of a given epoch
+curl -X POST -H "Content-Type: application/json" -d '{ "data": { "epoch": "105", "addresses" : ["addr_test1vzep2se0nr849acwfnlpm2sa3sz726g6v78ej4sy9ewjprqmcl720","addr_test1qptw3z77j2vjhd45vdqhct46uvwucese43twz9afv0lt9h83lgv8qkdvg9akyn2yyrtp75sd6ejwl3m0f4qtve43ydnsckuvc4"] } }' -s "https://postgrest-api.testnet.dandelion.link/rpc/get_eoe_balance_for_addresses" | jq .
+~~~
+
+[Postgrest documentation](http://postgrest.org/en/latest/api.html) will be handy to explore the whole Cardano network throuh this API.
+
+```

data/dandelion-pages/rosetta-api.md

@@ -0,0 +1,31 @@
+---
+title: 'rosetta-api'
+date: '05-02-2021'
+version: 1
+---        
+
+
+# rosetta-api
+## rosetta-api
+
+Rosetta is an open-source specification and set of tools that makes integrating with blockchains simpler, faster, and more reliable.
+
+![](/showcase-rosetta-api.png)
+
+- [View on IOHK GitHub](https://github.com/input-output-hk/cardano-rosetta)
+- [Official Documentation](https://github.com/input-output-hk/cardano-rosetta#documentation)
+
+
+- "mainnet": { "version": "1.1.0" },
+- "testnet": { "version": "1.1.0-testnet" },
+
+
+- [testnet](https://rosetta-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`)
+- [mainnet](https://rosetta-api.mainnet.`+process.env.REACT_APP_API_DOMAIN+`)
+
+```
+    - bash:
+    ~~~bash
+    curl -X POST -H 'Content-Type: application/json' --data '{"network_identifier":{"blockchain":"cardano","network":"testnet"},"block_identifier":{"index":100}}' https://rosetta-api.testnet.dandelion.link/block
+    ~~~
+```

data/dandelion-pages/submit-api.md

@@ -0,0 +1,34 @@
+---
+title: 'submit-api'
+date: '05-02-2021'
+version: 1 
+---    
+
+# submit-api
+## cardano-rest/submit-api
+
+You can use this REST API to send signed-transactions to the blockchain
+
+This is the currently officially supported API to submit signed Cardano transactions to the blockchain.
+
+![](showcase-submit-api.png)
+- [View on IOHK GitHub](https://github.com/input-output-hk/cardano-rest#overview)
+- [Official Documentation](https://input-output-hk.github.io/cardano-rest/submit-api/)
+
+- "mainnet": { "version": "3.1.1" },
+- "testnet": { "version": "3.1.1" },
+
+- [testnet](https://submit-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`)
+- [mainnet](https://submit-api.mainnet.`+process.env.REACT_APP_API_DOMAIN+`)
+  
+```
+    - bash:
+    ~~~bash
+    # '/tmp/cbor-tx' should be a file containing 
+    # a valid 'application/cbor' signed transaction (in e.g., from cardano-cli)
+    curl -X POST \\
+        --header "Content-Type: application/cbor" \\
+        --data-binary @/tmp/cbor-tx \\
+        https://submit-api.testnet.`+process.env.REACT_APP_API_DOMAIN+`/api/submit/tx
+    ~~~
+```

lib/dandelions.js

@@ -0,0 +1,91 @@
+import fs from 'fs'
+import path from 'path'
+import matter from 'gray-matter'
+import remark from 'remark'
+import html from 'remark-html'
+
+const dapisDirectory = path.join(process.cwd(), 'data/dandelion-pages')
+
+export function getSortedDapisData() {
+  // Get file names under /posts
+  const fileNames = fs.readdirSync(dapisDirectory)
+  const dapisData = fileNames.map(fileName => {
+    // Remove ".md" from file name to get id
+    const id = fileName.replace(/\.md$/, '')
+
+    // Read markdown file as string
+    const fullPath = path.join(dapisDirectory, fileName)
+    const fileContents = fs.readFileSync(fullPath, 'utf8')
+
+    // Use gray-matter to parse the post metadata section
+    const matterResult = matter(fileContents)
+
+    // Combine the data with the id
+    return {
+      id,
+      ...matterResult.data
+    }
+  })
+  // Sort posts by date
+  return dapisData.sort((a, b) => {
+    if (a.date < b.date) {
+      return 1
+    } else {
+      return -1
+    }
+  })
+}
+
+export async function getAllDapiData(id) {
+    const fullPath = path.join(dapisDirectory, `${id}.md`)
+    const fileContents = fs.readFileSync(fullPath, 'utf8')
+  
+    // Use gray-matter to parse the post metadata section
+    const matterResult = matter(fileContents)
+  
+    // Use remark to convert markdown into HTML string
+    const processedContent = await remark()
+      .use(html)
+      .process(matterResult.content)
+    const contentHtml = processedContent.toString()
+  
+    // Combine the data with the id and contentHtml
+    return {
+      id,
+      contentHtml,
+      ...matterResult.data
+    }
+  }
+
+  export function getAllDapiIds() {
+    const fileNames = fs.readdirSync(dapisDirectory)
+
+    return fileNames.map(fileName => {
+      return {
+        params: {
+          id: fileName.replace(/\.md$/, '')
+        }
+      }
+    })
+  }
+
+  export async function getDapiData(id) {
+    const fullPath = path.join(dapisDirectory, `${id}.md`)
+    const fileContents = fs.readFileSync(fullPath, 'utf8')
+  
+    // Use gray-matter to parse the dapi metadata section
+    const matterResult = matter(fileContents)
+
+    // Use remark to convert markdown into HTML string
+    const processedContent = await remark()
+        .use(html)
+        .process(matterResult.content)
+    const contentHtml = processedContent.toString()
+  
+    // Combine the data with the id
+    return {
+      id,
+      contentHtml,
+      ...matterResult.data
+    }
+  }

next.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+    webpack: (config, { isServer }) => {
+      // Fixes npm packages that depend on `fs` module
+      if (!isServer) {
+        config.node = {
+          fs: 'empty'
+        }
+      }
+  
+      return config
+    }
+  }