GitHub Verification
How keytrace verifies GitHub identity claims
Claim URI Format
https://gist.github.com/alice/abc123def456 Pattern: ^https:\/\/gist\.github\.com\/([^/]+)\/([a-f0-9]+)\/?$
Create Your Proof
- 1Go to gist.github.com and create a new gist
- 2Name the file
keytrace.json(orkeytrace.mdorproof.md) - 3Paste the verification content below into the file
- 4Make sure the gist is public, then save it
- 5Copy the gist URL and paste it below
Proof Text
You need to include this text in your GitHub proof location:
Verifying my identity on keytrace: did:plc:example123456789012345678Where to put it: Create a public gist with a file named keytrace.json, keytrace.md, or proof.md containing the proof text
Verification Steps
- 1
Fetch proof data
Using the
httpfetcherhttps://api.github.com/gists/abc123def456 - 2
Search for DID in response
The runner checks the following locations for your DID:
files.keytrace.json.contentcontainsCheck if files → keytrace.json → content contains the DID
files.proof.md.contentcontainsCheck if files → proof.md → content contains the DID
files.keytrace.md.contentcontainsCheck if files → keytrace.md → content contains the DID
files.openpgp.md.contentcontainsCheck if files → openpgp.md → content contains the DID
descriptioncontainsCheck if description contains the DID
- 3
Attestation
If the DID is found, keytrace signs an attestation linking your identity to your ATProto DID and stores it in your repo.
Try Verification
Test verification with your own claim URI and DID: