From 049596eb293d32c7b9d733bebf43c4d14c9af6a4 Mon Sep 17 00:00:00 2001
From: wayne sun <ewanesun@gmail.com>
Date: Fri, 13 Mar 2026 09:27:33 +0900
Subject: [PATCH] feat: add Soulink agent identity memory example

Shows how to persist verified on-chain agent identities into the
Hyperspell memory graph. Agents remember who they've interacted with
and their trust levels, grounded in Soulink's on-chain credit scores.

- Resolve .agent names via Soulink API
- Store self identity in memory on startup
- Remember other agents after interactions
- Search memory for previously seen agents

Soulink: https://soulink.dev
---
 examples/soulink-identity.ts | 96 ++++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 examples/soulink-identity.ts

diff --git a/examples/soulink-identity.ts b/examples/soulink-identity.ts
new file mode 100644
index 00000000..db9c5bed
--- /dev/null
+++ b/examples/soulink-identity.ts
@@ -0,0 +1,96 @@
+/**
+ * Soulink Agent Identity + Hyperspell Memory
+ *
+ * Persists verified on-chain agent identities into the memory graph.
+ * Agents remember who they've interacted with and their trust levels,
+ * grounded in Soulink's on-chain credit scores (not hallucinated context).
+ *
+ * Soulink: https://soulink.dev
+ */
+import Hyperspell from 'hyperspell'
+
+const SOULINK_API = 'https://soulink.dev/api/v1'
+
+const client = new Hyperspell({
+  apiKey: process.env['HYPERSPELL_API_KEY'],
+})
+
+interface SoulinkIdentity {
+  name: string
+  owner: string
+  expires_at: string
+}
+
+interface SoulinkCredit {
+  name: string
+  score: number
+  total_reports: number
+}
+
+async function resolveAgent(name: string): Promise<SoulinkIdentity> {
+  const res = await fetch(`${SOULINK_API}/resolve/${encodeURIComponent(name)}`)
+  if (!res.ok) throw new Error(`Failed to resolve ${name}: ${res.status}`)
+  return res.json() as Promise<SoulinkIdentity>
+}
+
+async function getCredit(name: string): Promise<SoulinkCredit> {
+  const res = await fetch(`${SOULINK_API}/credit/${encodeURIComponent(name)}`)
+  if (!res.ok) throw new Error(`Failed to get credit for ${name}: ${res.status}`)
+  return res.json() as Promise<SoulinkCredit>
+}
+
+// Store your own agent's identity in memory on startup
+async function persistSelfIdentity(agentName: string) {
+  const identity = await resolveAgent(agentName)
+  const credit = await getCredit(agentName)
+
+  await client.memories.add({
+    text: [
+      `I am ${identity.name}.agent.`,
+      `My wallet is ${identity.owner}.`,
+      `My credit score is ${credit.score}/100 based on ${credit.total_reports} reports.`,
+    ].join(' '),
+  })
+
+  console.log(`Persisted self identity: ${identity.name} (score: ${credit.score})`)
+}
+
+// Remember another agent after interacting with them
+async function rememberAgent(agentName: string) {
+  const identity = await resolveAgent(agentName)
+  const credit = await getCredit(agentName)
+
+  await client.memories.add({
+    text: [
+      `Agent ${identity.name}.agent has a credit score of ${credit.score}/100`,
+      `based on ${credit.total_reports} reports.`,
+      `Their wallet is ${identity.owner}.`,
+      `Last seen: ${new Date().toISOString()}.`,
+    ].join(' '),
+  })
+
+  console.log(`Remembered agent: ${identity.name} (score: ${credit.score})`)
+}
+
+// Search memory for agents you've interacted with
+async function recallAgents(query: string) {
+  const results = await client.memories.search({ text: query })
+  console.log(`Found ${results.length} matching memories:`)
+  for (const result of results) {
+    console.log(`  - ${result.resource_id}`)
+  }
+  return results
+}
+
+async function main() {
+  // On startup, persist your own identity
+  await persistSelfIdentity('my-agent')
+
+  // After interacting with another agent, remember them
+  await rememberAgent('helper-bot')
+
+  // Later, recall trusted agents from memory
+  await recallAgents('credit score agent')
+}
+
+main().catch(console.error)