Overview
FIO Attestations is a FIO Improvement Proposal (FIP) candidate, which would enable 3rd parties to attest to truths about data associated with a FIO Handle, such as public address ownership.
Attester
An Attester can be the FIO Handle owner (self attestation) or any other 3rd-party.
Attestation
Attestation can be any statement following a common standard, which would be published in a FIP akin to token/chain code standard in FIP-15. This will allow for easy expansion of types of attestations without having to modify the FIO Chain.
Example
type | Description | data |
---|---|---|
pub_address_ownership | Public address ownership was verified with a signature or token send. | JSON including:
|
Sample Flow
Public address ownership attestation
In this example a Virtual Asset Service Provider (VASP) is required to verify that a user is in control of a public address which will be used as withdrawal address, before withdrawal is completed. They will act as an Attester.
VASP validates FIO Handle ownership, using Private key signature, FIO Request, or FIO Token Send
VASP attaches the validated FIO Handle to the user profile for future use
VASP validates a withdrawal public address using private key signature or token send
VASP records attestation on FIO Chain
Any party which trusts this Attester can now confirm that the public address is owned by the FIO Handle owner without having to ask for verification.
Proposed actions and getters
attest
Records attestation on FIO Chain.
Request
{ "attestee_fio_address": "bob@crypto", "attester_fio_address": "vasp@crypto", "type": "pub_address_ownership", "data": { "pub_address_hash": "492b5a30f6a353ce49d479ef1032cefe0797d13b2737e80023b47fceee9577e2" }, "max_fee": 1000000000, "actor": "aftyershcu22" }
get_attestations
Fetches specific attestation from FIO Chain.
Request
{ "attestee_fio_address": "bob@crypto", "attester_fio_addresses": [ "vasp@crypto", "attester@crypto" ], "type": "pub_address_ownership", "data": { "pub_address_hash": "492b5a30f6a353ce49d479ef1032cefe0797d13b2737e80023b47fceee9577e2" }, "limit": 1000, "offset": 0 }
Response
{ "attestations": [ { "type": "pub_address_ownership", "data": { "pub_address_hash": "492b5a30f6a353ce49d479ef1032cefe0797d13b2737e80023b47fceee9577e2" }, "attester_fio_address": "vasp@crypto", "time_stamp": "2020-09-11T18:30:56" } ], "more": 0 }
Add Comment