{"id":19123124,"url":"https://github.com/digitalbazaar/vc-demo","last_synced_at":"2026-06-05T11:30:16.410Z","repository":{"id":66015299,"uuid":"199327537","full_name":"digitalbazaar/vc-demo","owner":"digitalbazaar","description":"A demonstration of issuing and verifying Verifiable Credentials.","archived":false,"fork":false,"pushed_at":"2019-08-08T02:02:11.000Z","size":8,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-09T05:29:52.970Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/digitalbazaar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-07-28T19:16:15.000Z","updated_at":"2024-10-22T04:40:47.000Z","dependencies_parsed_at":"2023-03-03T19:45:21.073Z","dependency_job_id":null,"html_url":"https://github.com/digitalbazaar/vc-demo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalbazaar%2Fvc-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalbazaar%2Fvc-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalbazaar%2Fvc-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalbazaar%2Fvc-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digitalbazaar","download_url":"https://codeload.github.com/digitalbazaar/vc-demo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232313957,"owners_count":18504017,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T05:24:28.533Z","updated_at":"2026-06-05T11:30:16.345Z","avatar_url":"https://github.com/digitalbazaar.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Verifiable Credentials Demo\n\nDemonstrates how to issue and verify Verifiable Credentials.\n\nWARNING: No part of this demo should be used in production systems.\n         Generated private keys are not encrypted by default.\n\n## System Requirements\n\n- A 64-bit system\n- git \u003e= v2.x\n- docker \u003e= 18.x\n\n## Getting Started\n\nRunning this demo consists of:\n\n1. Cloning the repository.\n2. Getting a GitHub Personal Access Token.\n3. Generating a public/private keypair.\n4. Issuing a Verifiable Credential.\n5. Verifying the Verifiable Credential.\n\n### Cloning the Repository\n\n```\ngit clone https://github.com/digitalbazaar/vc-demo.git\ncd vc-demo\n```\n\n### Create an Alias\nThe rest of this demo assumes that you have created the following command\nline alias:\n```\nalias vc='docker run -i -v $(pwd):/home/node/app/key-file digitalbazaar/vc-js-cli'\n```\n\n### Getting a GitHub Personal Access Token\n\nThis demo will publish newly generated key and controller documents as a gists\nunder your GitHub account. This requires a\n[GitHub Personal Access Token](https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line)\nwith *only* the `gist` scope enabled.\n\n### Generate a keypair\n\nYou will need to generate a public-private keypair to run this demo.\nOnce the keypair is created, the public key will be published to\na gist under your GitHub account using the GitHub Personal Access\nToken you created in the previous step. The private key information\nas well as where the public key was published will be saved locally\nas `my-key.json`.\n\n#### Generate an Ed25519 keypair\n```\nvc keygen --key-type ed25519 --git-hub-token YOUR_GITHUB_TOKEN \u003e my-key.json\n```\n#### Generate a Secp256k1 keypair\n```\nvc keygen --key-type secp256k1 --git-hub-token YOUR_GITHUB_TOKEN \u003e my-key.json\n```\n\n### Issue a Verifiable Credential\n\nOnce your keypair has been generated and the public information\nhas been published, you can use it to issue Verifiable Credentials.\n\nThe `credentials` directory stores a number of template credentials\nthat can be used with the `issue` command. To issue a\nVerifiable Credential, you can execute the following command:\n\n```\nvc issue --key my-key.json \u003c credentials/alumni.jsonld \u003e alumni-signed.jsonld\n```\n\nThe command above will create a file called `alumni-signed.jsonld`,\nconsisting of the issued Verifiable Credential.\n\n### Verify a Verifiable Credential\n\nTo verify a Verifiable Credential, the following command can be used:\n\n```\nvc verify \u003c alumni-signed.jsonld\n```\n\nThe verification result will be printed to the screen.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalbazaar%2Fvc-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalbazaar%2Fvc-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalbazaar%2Fvc-demo/lists"}