Add Proof of Human (PoH) credential documentation#121
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
| Use the PoH Credential when you need a strong guarantee that you are interacting with a unique, live human. It is the right choice for: | ||
|
|
||
| - **Sybil resistance**: enforcing one account per human for airdrops, voting, rewards, or rate limiting. | ||
| - **High-assurance authentication**: gating sensitive actions where document-level uniqueness (NFC) is not enough. |
There was a problem hiding this comment.
superior uniqueness isn't the right argument for high-assurance authentication. I think the right argumenet is something about being really confident (thanks to biometrics) that you're interacting with the correct human.
There was a problem hiding this comment.
alright, how about "gating sensitive actions where you need biometric confidence that you're interacting with the correct, unique human."?
| <td className="whitespace-nowrap"> | ||
| <code>expires_at</code> | ||
| </td> | ||
| <td>Unix timestamp three years after the most recent issuance.</td> |
There was a problem hiding this comment.
The definition of "expires_at" isn't really three years - that could change or be flexible. it's something like "When the credential expires. This currently is three years after the most recent issuance"
There was a problem hiding this comment.
alright, will update to "Unix timestamp when the credential expires. This is currently three years after the most recent issuance"
|
|
||
| ## Credential Renewal | ||
|
|
||
| Users can renew their PoH credential to extend its validity as long as the Orb capture is deemed fresh by the issuer. Each renewal produces a credential with `expires_at = now + 3 years` while `genesis_issued_at` remains constant. |
There was a problem hiding this comment.
Does renewal produce a credential? This implies kinda there is now two credentials. In my mind it updates the existing credential.
There was a problem hiding this comment.
yeap, that'd be better. will update to "Each renewal updates the credential with ..."
2 participants
Change
Visuals