feat: register as external ID attester (#120)

* feat: register as external ID attestor

* chore: rename tag -> provider_name

crates/username_registry_coordinator/src/external_id_attestation.rs

@@ -1,3 +1,4 @@
+use core::str;
 use hdk::prelude::*;
 use holoom_types::{
  ConfirmExternalIdRequestPayload, ExternalIdAttestation, GetAttestationForExternalIdPayload,
@@ -226,3 +227,39 @@ pub fn delete_external_id_attestation(
 ) -> ExternResult<ActionHash> {
  delete_entry(original_attestation_hash)
 }
+
+/// Add your agent to the global external ID attestors list. The `provider_name` is used to 
+/// indicate the identity provider for which you attest identities.
+#[hdk_extern]
+pub fn register_as_external_id_attestor(provider_name: String) -> ExternResult<ActionHash> {
+ create_link(
+ hash_identifier("all_external_id_attestors".into())?,
+ agent_info()?.agent_initial_pubkey,
+ LinkTypes::ExternalIdAttestor,
+ provider_name,
+ )
+}
+
+/// Gets a list of `(agent, provider_name)` pairs representing all globally listed external ID
+/// attestors.
+///
+/// The `agent` is the attestor, and the `provider_name` is a `String` that names the identity
+/// provider for which they are attesting identities.
+#[hdk_extern]
+pub fn get_all_external_id_attestors(_: ()) -> ExternResult<Vec<(AgentPubKey, String)>> {
+ let pairs = get_links(
+ GetLinksInputBuilder::try_new(
+ hash_identifier("all_external_id_attestors".into())?,
+ LinkTypes::ExternalIdAttestor,
+ )?
+ .build(),
+ )?
+ .into_iter()
+ .filter_map(|link| {
+ let agent = AgentPubKey::try_from(link.target).ok()?;
+ let provider_name = str::from_utf8(&link.tag.into_inner()).ok()?.to_string();
+ Some((agent, provider_name))
+ })
+ .collect();
+ Ok(pairs)
+}

crates/username_registry_integrity/src/link_types.rs

@@ -8,6 +8,7 @@ pub enum LinkTypes {
  AgentMetadata,
  AgentToWalletAttestations,
  AgentToExternalIdAttestation,
+ ExternalIdAttestor,
  ExternalIdToAttestation,
  Publisher,
  NameToOracleDocument,
@@ -36,6 +37,7 @@ impl LinkTypes {
  LinkTypes::AgentToExternalIdAttestation => {
  validate_create_link_agent_to_external_id_attestations
  }
+ LinkTypes::ExternalIdAttestor => validate_create_link_external_id_attestor,
  LinkTypes::ExternalIdToAttestation => validate_create_link_external_id_to_attestation,
  LinkTypes::Publisher => validate_create_link_publisher,
  LinkTypes::NameToOracleDocument => validate_create_link_name_to_oracle_document,
@@ -65,6 +67,7 @@ impl LinkTypes {
  LinkTypes::AgentToWalletAttestations => {
  validate_delete_link_agent_to_wallet_attestations
  }
+ LinkTypes::ExternalIdAttestor => validate_delete_link_external_id_attestor,
  LinkTypes::AgentToExternalIdAttestation => {
  validate_delete_link_agent_to_external_id_attestations
  }

crates/username_registry_validation/src/external_id_attestor.rs

@@ -0,0 +1,35 @@
+use core::str;
+
+use hdi::prelude::*;
+
+pub fn validate_create_link_external_id_attestor(
+ action: CreateLink,
+ _base_address: AnyLinkableHash,
+ target_address: AnyLinkableHash,
+ tag: LinkTag,
+) -> ExternResult<ValidateCallbackResult> {
+ if AnyLinkableHash::from(action.author) != target_address {
+ return Ok(ValidateCallbackResult::Invalid(
+ "Target of attestor link must author".to_string(),
+ ));
+ }
+
+ if str::from_utf8(&tag.into_inner()).is_err() {
+ return Ok(ValidateCallbackResult::Invalid(
+ "Tag must be a valid utf-8 string".to_string(),
+ ));
+ }
+
+ Ok(ValidateCallbackResult::Valid)
+}
+pub fn validate_delete_link_external_id_attestor(
+ _action: DeleteLink,
+ _original_action: CreateLink,
+ _base: AnyLinkableHash,
+ _target: AnyLinkableHash,
+ _tag: LinkTag,
+) -> ExternResult<ValidateCallbackResult> {
+ Ok(ValidateCallbackResult::Invalid(String::from(
+ "Attestor links cannot be deleted",
+ )))
+}

crates/username_registry_validation/src/lib.rs

@@ -34,3 +34,5 @@ pub mod evm_address_to_signing_offer;
 pub use evm_address_to_signing_offer::*;
 pub mod publisher;
 pub use publisher::*;
+pub mod external_id_attestor;
+pub use external_id_attestor::*;

packages/tryorama/src/external_attestation/agents_can_list_as_external_id_attestors.test.ts

@@ -0,0 +1,24 @@
+import { expect, test } from "vitest";
+import { dhtSync, runScenario } from "@holochain/tryorama";
+
+import { setupPlayer } from "../utils/setup-happ.js";
+
+test("Agents can list as external id attestors", async () => {
+ await runScenario(async (scenario) => {
+ const [alice, aliceCoordinators] = await setupPlayer(scenario);
+ const [bob, bobCoordinators] = await setupPlayer(scenario);
+ await scenario.shareAllAgents();
+
+ await expect(
+ aliceCoordinators.usernameRegistry.registerAsExternalIdAttestor(
+ "some-identity-provider"
+ )
+ ).resolves.not.toThrow();
+
+ await dhtSync([alice, bob], alice.cells[0].cell_id[0]);
+
+ await expect(
+ bobCoordinators.usernameRegistry.getAllExternalIdAttestors()
+ ).resolves.toEqual([[alice.agentPubKey, "some-identity-provider"]]);
+ });
+});

packages/tryorama/src/oracle/agents_can_list_as_publishers.test.ts

@@ -9,14 +9,12 @@ test("Agents can list as publishers", async () => {
  const [bob, bobCoordinators] = await setupPlayer(scenario);
  await scenario.shareAllAgents();
 
- // Authority creates a external_id Attestation
  await expect(
  aliceCoordinators.usernameRegistry.registerAsPublisher("some-topic")
  ).resolves.not.toThrow();
 
  await dhtSync([alice, bob], alice.cells[0].cell_id[0]);
 
- // Authority gets the external_id Attestation
  await expect(
  bobCoordinators.usernameRegistry.getAllPublishers()
  ).resolves.toEqual([[alice.agentPubKey, "some-topic"]]);

packages/types/src/index.ts

@@ -1,3 +1,4 @@
 export * from "./types";
 export * from "./zome-functions";
 export * from "./utils";
+export * from "./integrity-enums";

packages/types/src/integrity-enums/UsernameRegistryIntegrity.ts

@@ -17,11 +17,12 @@ export enum UsernameRegistryIntegrityLinkTypeIndex {
  AgentMetadata = 1,
  AgentToWalletAttestations = 2,
  AgentToExternalIdAttestation = 3,
- ExternalIdToAttestation = 4,
- Publisher = 5,
- NameToOracleDocument = 6,
- RelateOracleDocumentName = 7,
- NameToRecipe = 8,
- NameToSigningOffer = 9,
- EvmAddressToSigningOffer = 10,
+ ExternalIdAttestor = 4,
+ ExternalIdToAttestation = 5,
+ Publisher = 6,
+ NameToOracleDocument = 7,
+ RelateOracleDocumentName = 8,
+ NameToRecipe = 9,
+ NameToSigningOffer = 10,
+ EvmAddressToSigningOffer = 11,
 }

packages/types/src/zome-functions/UsernameRegistryCoordinator.ts

@@ -136,6 +136,10 @@ export class UsernameRegistryCoordinator {
  return this.callZomeFn("get_all_authored_username_attestations");
  }
 
+ async getAllExternalIdAttestors(): Promise<[AgentPubKey, string][]> {
+ return this.callZomeFn("get_all_external_id_attestors");
+ }
+
  async getAllPublishers(): Promise<[AgentPubKey, string][]> {
  return this.callZomeFn("get_all_publishers");
  }
@@ -245,6 +249,10 @@ export class UsernameRegistryCoordinator {
  return this.callZomeFn("ingest_signed_username", signedUsername);
  }
 
+ async registerAsExternalIdAttestor(tag: string): Promise<ActionHash> {
+ return this.callZomeFn("register_as_external_id_attestor", tag);
+ }
+
  async registerAsPublisher(tag: string): Promise<ActionHash> {
  return this.callZomeFn("register_as_publisher", tag);
  }