@cascade-fyi/sati-sdk 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -5,6 +5,47 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.0] - 2026-02-12
+
+### Breaking Changes
+
+- **Feedback content fields renamed for ERC-8004 alignment**: `score` -> `value`, `tags` -> `tag1`/`tag2`, added `valueDecimals`
+  - `GiveFeedbackParams`: `score?` -> `value?`, `tags?` -> `tag1?`/`tag2?`, added `valueDecimals?`
+  - `ParsedFeedback`: `score?` -> `value?`, `tags` -> `tag1?`/`tag2?`, added `valueDecimals?`
+  - `FeedbackSearchOptions`: `minScore`/`maxScore` -> `minValue`/`maxValue`, `tags?` -> `tag1?`/`tag2?`
+  - `ReputationSummary`: `averageScore` -> `averageValue`
+  - `FeedbackContent`: `score?` -> `value?`, `tags?` -> `tag1?`/`tag2?`, added `valueDecimals?`
+- **`getReputationSummary` signature changed**: `(agentMint, tags?)` -> `(agentMint, tag1?, tag2?)`
+- **Registration file fields renamed**: `endpoints` -> `services`, `x402support` -> `x402Support`
+
+## [0.7.0] - 2026-02-12
+
+### Added
+
+- **Convenience methods on `Sati` class** - high-level API for feedback, search, and reputation without needing sati-agent0-sdk:
+  - `giveFeedback(params)` - submit feedback with a single call (schema auto-resolution, content building, signing)
+  - `prepareFeedback(params)` / `submitPreparedFeedback(params)` - browser wallet flow (user signs SIWS message, server submits)
+  - `revokeFeedback(params)` - close a compressed feedback attestation
+  - `searchFeedback(options?)` - query and filter feedbacks with parsed content, timestamps, and optional tx signatures
+  - `getReputationSummary(agentMint, tags?)` - aggregate feedback scores with optional tag filtering
+  - `searchAgents(options?)` - list agents with name/owner/active/endpoint filters and optional feedback stats
+  - `searchValidations(agentMint)` - query validation attestations with parsed timestamps
+  - `createAgentBuilder(name, description, image)` - factory for `SatiAgentBuilder`
+- **`SatiAgentBuilder` class** - fluent builder for agent registration using native Solana types:
+  - `setMCP(url, version?, meta?)` / `setA2A(url, version?, meta?)` - configure protocol endpoints with explicit capability metadata
+  - `setWallet(address)` / `setActive(active)` / `setX402Support(x402)` / `setSupportedTrust(trusts)`
+  - `register(opts)` / `registerWithUri(opts)` - on-chain registration with pluggable `MetadataUploader`
+  - `update(opts)` / `updateUri(opts)` - update existing agent metadata
+- **`FeedbackCache`** - TTL cache for feedback queries, reducing redundant RPC calls (moved from sati-agent0-sdk)
+- **Config accessors** on `Sati` class: `deployedConfig`, `feedbackPublicSchema`, `feedbackSchema`, `validationSchema`, `lookupTable`
+- **New types**: `GiveFeedbackParams`, `GiveFeedbackResult`, `PreparedFeedbackData`, `FeedbackSearchOptions`, `ParsedFeedback`, `ReputationSummary`, `AgentSearchOptions`, `AgentSearchResult`, `ParsedValidation`, `SatiWarning`
+- `signer` and `onWarning` options in `SATIClientOptions`
+- `buildRegistrationFile()` accepts optional `endpoints` parameter for pre-built endpoint arrays
+
+### Changed
+
+- sati-sdk is now the primary full-featured SDK (was low-level only); sati-agent0-sdk becomes a thin type-conversion wrapper
+
 ## [0.6.0] - 2026-02-12
 
 ### Added
@@ -116,6 +157,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Compressed attestation storage via Light Protocol
 - Basic querying via Photon RPC
 
+[0.8.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.7.0...@cascade-fyi/sati-sdk@0.8.0
+[0.7.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.6.0...@cascade-fyi/sati-sdk@0.7.0
 [0.6.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.5.0...@cascade-fyi/sati-sdk@0.6.0
 [0.5.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.4.2...@cascade-fyi/sati-sdk@0.5.0
 [0.4.2]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.4.1...@cascade-fyi/sati-sdk@0.4.2

package/README.md

@@ -1,6 +1,6 @@
 # @cascade-fyi/sati-sdk
 
-TypeScript SDK for SATI - Solana Agent Trust Infrastructure.
+Low-level TypeScript SDK for [SATI](https://github.com/cascade-protocol/sati) - the [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) agent identity standard on Solana. Raw attestations, custom schemas, compression, encryption.
 
 ## Installation
 
@@ -18,11 +18,8 @@ pnpm add @solana/kit @solana-program/token-2022 @coral-xyz/anchor
 ```typescript
 import { Sati, Outcome } from "@cascade-fyi/sati-sdk";
 
-// Initialize client
-const sati = new Sati({
-  network: "devnet",
-  photonRpcUrl: "https://devnet.helius-rpc.com?api-key=YOUR_KEY", // For compressed attestations
-});
+// Initialize client (uses hosted Photon proxy by default - no API keys needed)
+const sati = new Sati({ network: "devnet" });
 
 // Register an agent
 const { mint, memberNumber, signature } = await sati.registerAgent({
@@ -57,9 +54,13 @@ console.log(result.memberNumber); // Registry member number
 Upload a registration file to IPFS and register in one flow:
 
 ```typescript
-import { createPinataUploader } from "@cascade-fyi/sati-sdk";
+import { createSatiUploader, createPinataUploader } from "@cascade-fyi/sati-sdk";
+
+// Zero config (uses hosted uploader - no API keys needed)
+const uploader = createSatiUploader();
 
-const uploader = createPinataUploader(process.env.PINATA_JWT!);
+// Or bring your own Pinata account
+// const uploader = createPinataUploader(process.env.PINATA_JWT!);
 
 // Build + upload registration file, then register
 const uri = await sati.uploadRegistrationFile(
@@ -309,12 +310,13 @@ const result = await sati.closeReputationScore({
 
 ## Querying Attestations with Photon
 
-SATI uses Light Protocol's compressed accounts. Query via Helius Photon:
+SATI uses Light Protocol's compressed accounts. The `Sati` client handles Photon routing automatically (hosted proxy by default, or pass `photonRpcUrl` for your own endpoint). For direct Photon access:
 
 ```typescript
 import { createPhotonRpc } from "@cascade-fyi/compression-kit";
 import { SATI_PROGRAM_ADDRESS, FEEDBACK_OFFSETS } from "@cascade-fyi/sati-sdk";
 
+// Direct Photon access (for advanced use cases)
 const rpc = createPhotonRpc("https://devnet.helius-rpc.com?api-key=YOUR_KEY");
 
 // Query all feedbacks for an agent