Skip to content

Commit 42da81d

Browse files
bump v0.5.2: Phase 5.2 compliance integration
Add 5 new tools to README (ln_agent_attest, ln_agent_verify, ln_auth_session, ln_auth_lookup, ln_compliance_report), add compliance-report gateway endpoint to endpoint table, add Phase 5.2 roadmap entry, bump version to 0.5.2. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 70bcbff commit 42da81d

3 files changed

Lines changed: 59 additions & 2 deletions

File tree

README.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -200,6 +200,61 @@ ln_trust_attest(vendor="bitrefill.com")
200200

201201
Score is auto-calculated from local reputation if not provided. Other agents pull these attestations via `memory_sync` to build community trust scores.
202202

203+
### `ln_agent_attest`
204+
205+
Store a KYA (Know Your Agent) attestation for an agent's identity.
206+
207+
```
208+
ln_agent_attest(
209+
agent_pubkey="abcd1234...",
210+
owner_id="jason@e1.ai",
211+
jurisdiction="US",
212+
compliance_level="self_declared",
213+
source="manual"
214+
)
215+
# → {status: "stored", compliance_level: "self_declared"}
216+
```
217+
218+
**Compliance levels:** `unknown`, `self_declared`, `kyc_verified`, `regulated_entity`
219+
220+
### `ln_agent_verify`
221+
222+
Look up a KYA attestation for an agent by public key.
223+
224+
```
225+
ln_agent_verify(agent_pubkey="abcd1234...")
226+
# → {status: "verified", compliance_level: "kyc_verified", jurisdiction: "EU"}
227+
```
228+
229+
### `ln_auth_session`
230+
231+
Store or update an LNURL-auth session record for a vendor.
232+
233+
```
234+
ln_auth_session(vendor="bitrefill.com", linking_key="02abc123...")
235+
# → {status: "stored", session_state: "active"}
236+
```
237+
238+
**Session states:** `active`, `expired`, `revoked`
239+
240+
### `ln_auth_lookup`
241+
242+
Look up an existing LNURL-auth session for a vendor.
243+
244+
```
245+
ln_auth_lookup(vendor="bitrefill.com")
246+
# → {has_session: true, linking_key: "02abc123...", session_state: "active"}
247+
```
248+
249+
### `ln_compliance_report`
250+
251+
Generate a structured compliance report for audit/export.
252+
253+
```
254+
ln_compliance_report(since="30d")
255+
# → {report: {agent_identity: {...}, transactions: [...], budget_rules: [...], vendor_kyc: [...], ...}}
256+
```
257+
203258
### `memory_sync`
204259

205260
Sync memories with Nostr relays (push and/or pull). Also pulls NIP-85 trust assertions for vendors in local transaction history.
@@ -277,6 +332,7 @@ Agent Gateway Phoenixd
277332
| `/ln/preflight` | POST | 3 sats | Pre-flight payment gate |
278333
| `/ln/trust/{name}` | GET | 2 sats | Vendor trust profile |
279334
| `/ln/budget` | GET | 1 sat | Budget rules and spending |
335+
| `/ln/compliance-report` | GET | 10 sats | Compliance report export |
280336

281337
### Phoenixd Setup
282338

@@ -368,6 +424,7 @@ All data is stored locally:
368424
- [x] Phase 4: L402 payment gateway (macaroons, Phoenixd, Starlette HTTP gateway)
369425
- [x] Phase 5: Compliance & trust layer (budget enforcement, vendor KYC, community reputation, payment pre-flight gate)
370426
- [x] Phase 5.1: Community reputation — live NIP-85 trust attestation sync
427+
- [x] Phase 5.2: Compliance integration — KYA attestations, LNURL-auth sessions, compliance reports
371428

372429
## Star History
373430

lightning_memory/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
"""Lightning Memory: Decentralized agent memory for the Lightning economy."""
22

3-
__version__ = "0.5.1"
3+
__version__ = "0.5.2"

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
44

55
[project]
66
name = "lightning-memory"
7-
version = "0.5.1"
7+
version = "0.5.2"
88
description = "Decentralized agent memory for the Lightning economy. Nostr identity, L402 payments, semantic search."
99
readme = "README.md"
1010
license = "MIT"

0 commit comments

Comments
 (0)