Enable Discovery

1. 1

   Metadata is public at registration

   When you register a did:bio, its metadata record, DID document, and Solana registry anchor are created together, and the record resolves publicly from then on. A registered paper is also indexed into the BioAgents knowledge base, and a DOI lets its record be enriched from the knowledge graph.

2. 2

   BioAgents answers questions over it

   BioAgents plans searches against the graph, combines the results with the knowledge base of registered papers, and writes a synthesis that cites the papers it found. Registering a paper with a DOI also fills empty fields of its record from the graph.

3. 3

   Query it from the Console or the API

   Once a record is in the graph, both interfaces reach it. A registered paper links its DOI to a did:bio, and the did:bio to its sealed file on IPFS. Querying guide

# Resolve any did:bio. Public, no account or token required.
curl https://api.ekayana.io/api/did/resolve/did:bio:devnet:2T6zLFvMx7NJ...

# Returns the DID document: verification methods, service endpoints,
# and the metadata record behind the identifier.

// Ask the knowledge graph a question in plain English
const res = await fetch('https://api.ekayana.io/api/bioagents/query', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    query:
      'Which datasets link coral bleaching to ocean temperature anomalies?',
  }),
});

const answer = await res.json();
// Each result carries the did:bio and the source record it came from.

Semantic search

Search the Ekayana Console across the records held in the graph rather than one repository at a time.

Relationship queries

Typed routes find papers by concept, by author narrowed by concept, or by DOI. The plugin builds each SPARQL query from those inputs; the API does not expose a raw SPARQL endpoint.

Natural language queries

POST /api/bioagents/query takes a question as JSON and returns an answer with the DOIs it cited. POST /api/bioagents/kg/ask returns the synthesis, the papers, and the search plan. Both require a session token.

Public resolution

GET /api/did/resolve/{id} returns the DID document and metadata record for any did:bio. No account, no token, no fee.

Citation and usage reports (members)

Members see how their identifiers resolve and how their outputs are reused, including datasets that keep their DOIs through the Dataverse bridge.

Datasets bridged from Dataverse keep their DOIs, and the did:bio record carries the DOI so discovery works from either identifier. See Integrate Workflows and the Dataverse integration docs.