Usage Examples

This page provides common usage examples for the LearnCloud Network API, so you can quickly see how to

• Send and receive credentials, boosts, and presentations

• Create and claim credentials through peer-to-peer or QR flows

• Register and manage Signing Authorities

• Trigger and validate ConsentFlows

• Monitor health and fetch metadata (like DIDs or challenge keys)

• Run semantic search across skill frameworks

Each example is standalone and self-explanatory. Scroll, copy, and paste what you need.

✅ All examples assume:

• You have a valid LearnCloud JWT (via auth or delegation)

• You’re storing data on behalf of a user identified by a DID

• You’re using the endpoint: https://network.learncard.com/api

---

🔐 Authentication

All requests require:

• Authorization: Bearer <your-JWT>

• The JWT must resolve to a DID matching the stored object owner, unless delegated.

---

📤 Sending Credentials

The send Method (Recommended)

The simplest way to send credentials is using the send method, which handles credential issuance, signing, and delivery in a single call.

Using an Existing Boost Template

const result = await learnCard.invoke.send({
    type: 'boost',
    recipient: 'recipient-profile-id', // Profile ID or DID
    templateUri: 'urn:lc:boost:abc123',
});

// Returns: { type: 'boost', credentialUri: '...', uri: '...' }

Creating and Sending a New Boost

const result = await learnCard.invoke.send({
    type: 'boost',
    recipient: 'recipient-profile-id',
    template: {
        credential: unsignedVC,
        name: 'Course Completion Certificate',
        category: 'Achievement',
    },
});

With ConsentFlow Contract

const result = await learnCard.invoke.send({
    type: 'boost',
    recipient: 'recipient-profile-id',
    templateUri: 'urn:lc:boost:abc123',
    contractUri: 'urn:lc:contract:xyz789', // Routes via consent terms if applicable
});

Signing Behavior: The send method uses client-side signing when key material is available. Otherwise, it falls back to your registered signing authority.

---

🔎 Semantic Skill Search

Use semantic search when keyword matching is too strict and you want meaning-based results.

const results = await learnCard.invoke.semanticSearchSkills({
    text: 'hands-on robotics troubleshooting',
    frameworkId: 'framework-123', // optional
    limit: 50, // optional (default 50)
});

console.log(results.records[0]);
// {
//   id: 'skill-id',
//   statement: 'Diagnose wiring faults',
//   description: '...',
//   frameworkId: 'framework-123',
//   score: 0.88,
//   ...
// }

Semantic search requires skill embeddings to be present. In LearnCard Network, embeddings are generated for skill create/update/sync flows and can be backfilled when enabled by environment configuration.