@telaro/sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to `@telaro/sdk` will be documented in this file.
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the
+project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] — 2026-05-06
+
+### Added
+- High-level `TelaroClient` — wraps register/record/claim/resolve/withdraw flows.
+- `TelaroApi` typed HTTP client for the public REST API.
+- `build*Ix` composable instruction builders (10 ixs).
+- `buildRegisterAndBondIxs` two-ix helper for atomic register-and-bond.
+- Deterministic Anchor instruction / event / account discriminators (sha256-derived).
+- Borsh event decoder + typed payloads for all 8 program events.
+- Reference scoring policy (`computeScore`) including `bond_ratio` component.
+- PDA helpers (`findAgentPda`, `findClaimPda`, `findBondVaultPda`, …).
+- Format helpers (`formatUsdc`, `formatPercent`, `formatRelativeTime`, `shortenPubkey`).
+- Subpath exports: `./score`, `./pda`, `./api`.
+- Isomorphic SHA-256 via `@noble/hashes` (works in Node, browsers, edge runtimes).
+- Quick-start docs for three audiences: DApp consumer, framework integrator, end user.
+
+### Notes
+- Program ID (devnet): `BondedAg3nts1111111111111111111111111111111`.
+- Mainnet program ID reserved; deployment paused pending audit.

package/QUICKSTART.md

@@ -0,0 +1,216 @@
+# Quickstart — `@telaro/sdk`
+
+Three audiences, three patterns. Pick the one that matches what you're building.
+
+```bash
+npm install @telaro/sdk @solana/web3.js @solana/spl-token
+```
+
+Add this `overrides` block to your `package.json` first (needed on Node 20 — see [README](./README.md#-required-pin-rpc-websockets)):
+
+```jsonc
+{ "overrides": { "rpc-websockets": "9.1.1" } }
+```
+
+---
+
+## 1. DApp consumer (just want to *read* trust data)
+
+You're building a DApp that lists agents, gates capital delegation, or shows
+trust badges. **No wallet, no Anchor, no Solana SDK needed** — just fetch.
+
+```ts
+import { TelaroApi, tierOf } from "@telaro/sdk";
+
+const api = new TelaroApi("https://telaro.xyz");
+
+// Find safe agents for our pool
+const candidates = await api.listAgents({ minScore: 700, minBond: "1000000000" });
+console.log(`${candidates.length} agents qualify for our LP delegation`);
+
+// Drill into one
+const agent = await api.agent("AgentSenda1JupiterLPv3...");
+if (agent && !agent.agent.frozen) {
+  console.log(`✓ score=${agent.agent.score} bond=$${agent.agent.bond_human}`);
+}
+
+// Embed Trust Card on your site
+const cardUrl = api.cardUrl("AgentSenda1JupiterLPv3...");
+// → https://telaro.xyz/api/card/AgentSenda1JupiterLPv3....png
+```
+
+For **on-chain enforcement** in your own Anchor program, invoke `view_bond` via CPI:
+
+```rust
+use telaro::cpi::{view_bond, accounts::ViewBond};
+
+view_bond(
+    CpiContext::new(telaro_program, ViewBond { agent: agent_account }),
+    1_000_000_000u64,  // min_bond = 1000 USDC
+    700u16,            // min_score
+)?;
+// reaches here only if agent meets policy → safe to delegate
+```
+
+---
+
+## 2. Framework integrator (you build agent runtimes)
+
+You're integrating Telaro into Sendai / Eliza / GOAT / your own framework
+so every agent your users spin up gets bonded automatically.
+
+```ts
+import {
+  TelaroClient,
+  ActionKind,
+  ActionOutcome,
+  hashAction,
+} from "@telaro/sdk";
+import { Connection, Keypair, PublicKey } from "@solana/web3.js";
+
+const connection = new Connection("https://api.devnet.solana.com");
+const controller = Keypair.fromSecretKey(/* … */);
+const rep = new TelaroClient(connection, controller);
+
+// 1. One-time: register agent + post bond (single tx, two-ix)
+await rep.registerAgent({
+  framework: "sendai",
+  metadataUri: "https://my-agent.example/metadata.json",
+  scorer: new PublicKey("ScorerPubkeyOfTheIndexer..."),
+  bondMint: new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"), // mainnet USDC
+  bondAmount: 100_000_000n,  // 100 USDC
+});
+
+// 2. Every action: call recordAction. Add this hook to your framework's
+//    "after-tx" handler so it fires automatically.
+await rep.recordAction({
+  payload: { type: "swap", inMint: "SOL", outMint: "USDC", amount: 1.0 },
+  kind: ActionKind.Swap,
+  outcome: ActionOutcome.Success,
+  valueAtomic: 50_000_000n,  // ≈ $50 value-at-risk
+});
+
+// 3. (Optional) preview a CPI policy check before delegating
+const ok = await rep.previewViewBond(rep.agentPda(), 1_000_000_000n, 700);
+```
+
+Want **browser/wallet-adapter** instead of node Keypair? Use the lower-level builders:
+
+```ts
+import { buildRecordActionIx, ActionKind, ActionOutcome, hashAction } from "@telaro/sdk";
+import { useConnection, useWallet } from "@solana/wallet-adapter-react";
+import { Transaction } from "@solana/web3.js";
+
+function useRecord() {
+  const { connection } = useConnection();
+  const { publicKey, signTransaction } = useWallet();
+
+  return async (payload: unknown) => {
+    if (!publicKey || !signTransaction) throw new Error("connect wallet");
+    const ix = buildRecordActionIx(publicKey, {
+      actionHash: hashAction(payload),
+      kind: ActionKind.Swap,
+      outcome: ActionOutcome.Success,
+      valueAtomic: 50_000_000n,
+    });
+    const tx = new Transaction().add(ix);
+    tx.feePayer = publicKey;
+    tx.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
+    const signed = await signTransaction(tx);
+    return connection.sendRawTransaction(signed.serialize());
+  };
+}
+```
+
+---
+
+## 3. End user (you got rugged and want your bond payout)
+
+You used a bonded agent. It misbehaved. You want compensation.
+
+```ts
+import { TelaroClient, hashAction } from "@telaro/sdk";
+import { Connection, Keypair, PublicKey } from "@solana/web3.js";
+
+const rep = new TelaroClient(connection, userKeypair);
+
+// 1. File a claim with 5% deposit
+await rep.submitClaim(
+  {
+    agent: new PublicKey("AgentRug2hiscustomframework..."),
+    actionHash: hashAction({ tx: "OffendingTxSignature...", ts: Date.now() }),
+    claimedAmount: 1_000_000_000n,  // claim 1000 USDC
+    evidenceUri: "ipfs://bafy...",   // public proof
+  },
+  USDC_MINT
+);
+// Now wait 7 days. If builder is silent, your bond payout auto-triggers.
+
+// 2. After deadline, anyone (incl. you) can call AutoTimeout to release the payout
+import { ResolveAction } from "@telaro/sdk";
+
+await rep.resolveClaim({
+  agent: new PublicKey("AgentRug2hiscustomframework..."),
+  actionHash,
+  claimer: userKeypair.publicKey,
+  bondMint: USDC_MINT,
+  action: ResolveAction.AutoTimeout,
+});
+// USDC moves from agent's bond vault → your wallet. Score collapses.
+```
+
+The web app at `telaro.xyz/agent/{pubkey}` exposes a no-code modal for this same flow.
+
+---
+
+## Common helpers
+
+```ts
+import {
+  computeScore,
+  tierOf,
+  formatUsdc,
+  formatPercent,
+  shortenPubkey,
+} from "@telaro/sdk";
+
+const out = computeScore({
+  actionCount: 412n,
+  successCount: 401n,
+  disputedCount: 1n,
+  currentBond: 5_247_000_000n,
+  valueHandled30d: 21_400_000_000n,
+});
+// { score: 870, bondRatioBps: 2451, components: {...} }
+
+tierOf(870);            // "high"
+formatUsdc(5_247_000_000n);  // "$5,247"
+formatPercent(0.992, 1);     // "99.2%"
+shortenPubkey("AgentSenda1JupiterLPv31111111111111111111111");
+// "Agen…1111"
+```
+
+## Subpath imports (smaller bundles)
+
+```ts
+import { computeScore } from "@telaro/sdk/score";
+import { findAgentPda } from "@telaro/sdk/pda";
+import { TelaroApi } from "@telaro/sdk/api";
+```
+
+## All exports
+
+| Module | Exports |
+|---|---|
+| `client` | `TelaroClient`, `TelaroClientOptions` |
+| `api` | `TelaroApi`, `TelaroApiError`, full types |
+| `instructions` | `build*Ix` for every program ix + `buildRegisterAndBondIxs` helper |
+| `pda` | `findAgentPda`, `findClaimPda`, `findBondVaultPda`, … |
+| `score` | `computeScore`, `tierOf`, `ScoreInputs`, `ScoreOutput` |
+| `events` | `decodeEvent`, `decodeEventsFromLogs`, all event types |
+| `types` | `AgentAccount`, `ActionKind`, `ActionOutcome`, `ClaimStatus`, … |
+| `format` | `formatUsdc`, `formatPercent`, `formatRelativeTime`, … |
+| `constants` | `PROGRAM_ID`, `MIN_BOND_USDC`, `CLAIM_*`, … |
+| `discriminators` | `INSTRUCTION_DISC`, `EVENT_DISC`, `ACCOUNT_DISC` |
+| `hash` | `hashAction(payload)` deterministic action_hash |
+| `borsh` | `BorshReader` (for custom Borsh decoding) |

package/README.md

@@ -0,0 +1,129 @@
+# `@telaro/sdk`
+
+> TypeScript SDK for the **Telaro** protocol on Solana — skin-in-the-game reputation primitive for AI agents.
+
+## Install
+
+```bash
+npm install @telaro/sdk @solana/web3.js @solana/spl-token
+```
+
+> Other package managers also work: `yarn add`, `pnpm add`, `bun add`.
+
+### ⚠️ Required: pin `rpc-websockets`
+
+`@solana/web3.js@1.x` pulls a `rpc-websockets` build whose transitive `uuid@14` (ESM-only) breaks a CJS shim — you'll hit `ERR_REQUIRE_ESM` at the first import. Add this to your `package.json` before running `npm install`:
+
+```jsonc
+{
+  "overrides": {
+    "rpc-websockets": "9.1.1"
+  }
+}
+```
+
+`pnpm` and `yarn` users: use `"pnpm": { "overrides": ... }` / `"resolutions": { ... }` in the same shape. Node ≥22 fixes this natively, so you can skip the override if you're on Node 22+. This is a Solana ecosystem-wide issue, not specific to Telaro.
+
+### Requirements
+
+- **Node ≥ 20** (recommended: **≥ 22** to skip the override above)
+- **ESM project** (`"type": "module"` in `package.json` or `.mts` files)
+- **Compatible runtimes**: Next.js 15+, Vite, Bun, Deno, Anchor 0.30+ TS templates, modern Node
+- **Not compatible**: legacy CommonJS-only environments. Use a dynamic `await import("@telaro/sdk")` if you must call from CJS.
+
+## Quick start — agent-side (framework integrator)
+
+```ts
+import { TelaroClient, ActionKind, ActionOutcome } from "@telaro/sdk";
+import { Connection, Keypair, PublicKey } from "@solana/web3.js";
+
+const conn = new Connection("https://api.devnet.solana.com", "confirmed");
+const controller = Keypair.fromSecretKey(/* ... */);
+const rep = new TelaroClient(conn, controller);
+
+// 1. Register the agent + post bond.
+await rep.registerAgent({
+  framework: "sendai",
+  metadataUri: "https://my-agent.example/metadata.json",
+  scorer: new PublicKey("ScorerPubkeyOfTheIndexer..."),
+  bondMint: new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"), // USDC
+  bondAmount: 100_000_000n, // 100 USDC
+});
+
+// 2. Record actions as the agent acts.
+await rep.recordAction({
+  payload: { type: "swap", in: "SOL", out: "USDC", amount: 1.0 },
+  kind: ActionKind.Swap,
+  outcome: ActionOutcome.Success,
+  valueAtomic: 50_000_000n, // ≈ $50 value-at-risk
+});
+```
+
+## Quick start — DApp-side (consumer)
+
+```ts
+import { findAgentPda, computeScore, tierOf } from "@telaro/sdk";
+
+// Read agent state from chain (use Anchor account decoder or direct fetch).
+// Then locally compute / verify the score:
+const { score, components } = computeScore({
+  actionCount: 412n,
+  successCount: 401n,
+  disputedCount: 1n,
+  currentBond: 5_247_000_000n,    // $5,247
+  valueHandled30d: 21_000_000_000n,
+});
+
+if (tierOf(score) === "high" && score >= 700) {
+  // OK to delegate.
+}
+```
+
+## Quick start — DApp on-chain enforcement (Anchor CPI)
+
+In your own Anchor program, before delegating capital to an agent, invoke
+`view_bond` on the Telaro program. Reverts if the agent doesn't meet
+your policy:
+
+```rust
+use telaro::cpi::{view_bond, accounts::ViewBond};
+
+view_bond(
+    CpiContext::new(telaro_program, ViewBond { agent: agent_account.into() }),
+    1_000_000_000u64,  // min_bond = 1000 USDC
+    700u16,            // min_score
+)?;
+// If we reach here, the agent meets the policy. Delegate safely.
+```
+
+## API surface
+
+| Module | Exports |
+|---|---|
+| `client` | `TelaroClient`, `TelaroClientOptions` |
+| `instructions` | `build*Ix` for each instruction (composable) |
+| `pda` | `findAgentPda`, `findClaimPda`, `findBondVaultPda`, … |
+| `score` | `computeScore`, `tierOf`, `ScoreInputs`, `ScoreOutput` |
+| `types` | `AgentAccount`, `ActionKind`, `ActionOutcome`, `ClaimStatus`, … |
+| `format` | `formatUsdc`, `formatPercent`, `formatRelativeTime`, … |
+| `constants` | `PROGRAM_ID`, `MIN_BOND_USDC`, `CLAIM_*`, … |
+| `hash` | `hashAction(payload)` deterministic action_hash |
+
+## Scoring policy (default, v1)
+
+```
+score = 500
+       + 50  × tanh(log10(action_count))                  // tenure
+       + 200 × (success / action)                          // success rate
+       - 300 × (disputed / action)                         // disputes
+       + 100 × min(1.0, bond / value_handled_30d)         // skin in the game
+       - 100 if recent_high_value_failure_in_7d           // hot incident decay
+clamp(0, 1000)
+```
+
+The `bondRatioBps` returned alongside the score is what the on-chain
+`update_score` instruction emits, allowing consumers to verify the policy.
+
+## License
+
+MIT — see [LICENSE](../LICENSE).

package/dist/accounts.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Hand-rolled Borsh decoders for the on-chain account types.
+ *
+ * Why hand-rolled (vs `BorshAccountsCoder` from `@coral-xyz/anchor`):
+ *   - Avoids depending on the IDL JSON, which our toolchain currently
+ *     can't generate cleanly (anchor-syn ↔ proc-macro2 drift).
+ *   - The struct shapes are stable; layout is documented in
+ *     `programs/bonded_agents/src/state.rs`.
+ *
+ * Used by the indexer's startup backfill and by client-side account
+ * lookups (`getAgent(pubkey)`).
+ */
+import { PublicKey } from "@solana/web3.js";
+import type { AgentAccount, ClaimAccount } from "./types.js";
+export interface LpPositionAccount {
+    bump: number;
+    agent: PublicKey;
+    lpKind: number;
+    yieldRouter: PublicKey;
+    marginfiAccount: PublicKey;
+    marginfiBank: PublicKey;
+    totalDeposited: bigint;
+    totalWithdrawn: bigint;
+    totalHarvested: bigint;
+    lastRouteAt: number;
+    lastHarvestAt: number;
+    createdAt: number;
+}
+/**
+ * Decode the raw bytes of an `LpPosition` account. Returns null if the
+ * discriminator doesn't match. Layout mirrors
+ * `programs/telaro/src/state.rs::LpPosition`.
+ */
+export interface ScoreFeedAccount {
+    bump: number;
+    agent: PublicKey;
+    scorer: PublicKey;
+    score: number;
+    updatedAt: number;
+    publishCount: bigint;
+}
+export declare function decodeScoreFeedAccount(data: Buffer): ScoreFeedAccount | null;
+export declare function decodeLpPositionAccount(data: Buffer): LpPositionAccount | null;
+/**
+ * Decode the raw bytes of an `Agent` account (with its 8-byte
+ * Anchor discriminator at the front). Returns null if the
+ * discriminator does not match.
+ */
+export declare function decodeAgentAccount(data: Buffer): AgentAccount | null;
+export declare function decodeClaimAccount(data: Buffer): ClaimAccount | null;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../src/accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAe,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,SAAS,CAAC;IACvB,eAAe,EAAE,SAAS,CAAC;IAC3B,YAAY,EAAE,SAAS,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAY5E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CA+B9E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAoEpE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAsCpE"}

package/dist/accounts.js

@@ -0,0 +1,169 @@
+import { ACCOUNT_DISC } from "./discriminators.js";
+import { BorshReader } from "./borsh.js";
+export function decodeScoreFeedAccount(data) {
+    if (data.length < 8)
+        return null;
+    if (!data.subarray(0, 8).equals(ACCOUNT_DISC.ScoreFeed))
+        return null;
+    const r = new BorshReader(data.subarray(8));
+    const bump = r.u8();
+    r.fixedBytes(5); // _pad0
+    const agent = r.pubkey();
+    const scorer = r.pubkey();
+    const score = r.u16();
+    const updatedAt = Number(r.i64());
+    const publishCount = r.u64();
+    return { bump, agent, scorer, score, updatedAt, publishCount };
+}
+export function decodeLpPositionAccount(data) {
+    if (data.length < 8)
+        return null;
+    if (!data.subarray(0, 8).equals(ACCOUNT_DISC.LpPosition))
+        return null;
+    const r = new BorshReader(data.subarray(8));
+    const bump = r.u8();
+    const agent = r.pubkey();
+    const lpKind = r.u8();
+    r.fixedBytes(6); // _pad0
+    const yieldRouter = r.pubkey();
+    const marginfiAccount = r.pubkey();
+    const marginfiBank = r.pubkey();
+    const totalDeposited = r.u64();
+    const totalWithdrawn = r.u64();
+    const totalHarvested = r.u64();
+    const lastRouteAt = Number(r.i64());
+    const lastHarvestAt = Number(r.i64());
+    const createdAt = Number(r.i64());
+    return {
+        bump,
+        agent,
+        lpKind,
+        yieldRouter,
+        marginfiAccount,
+        marginfiBank,
+        totalDeposited,
+        totalWithdrawn,
+        totalHarvested,
+        lastRouteAt,
+        lastHarvestAt,
+        createdAt,
+    };
+}
+/**
+ * Decode the raw bytes of an `Agent` account (with its 8-byte
+ * Anchor discriminator at the front). Returns null if the
+ * discriminator does not match.
+ */
+export function decodeAgentAccount(data) {
+    if (data.length < 8)
+        return null;
+    if (!data.subarray(0, 8).equals(ACCOUNT_DISC.Agent))
+        return null;
+    const r = new BorshReader(data.subarray(8));
+    const controller = r.pubkey();
+    const bondMint = r.pubkey();
+    const bondVault = r.pubkey();
+    const scorer = r.pubkey();
+    const framework = r.string();
+    const metadataUri = r.string();
+    const createdAt = Number(r.i64());
+    const lastActionAt = Number(r.i64());
+    const actionCount = r.u64();
+    const successCount = r.u64();
+    const failedCount = r.u64();
+    const disputedCount = r.u64();
+    const currentBond = r.u64();
+    const reservedForClaims = r.u64();
+    const valueHandled30d = r.u64();
+    const currentScore = r.u16();
+    const openClaims = r.u32();
+    const frozen = r.bool();
+    // bump + vault_bump are implementation detail; skip them — they'd cost
+    // 2 reads but the consumer doesn't need them.
+    r.u8();
+    r.u8();
+    // Yield routing (added v0)
+    // total_yield_accrued / builder_yield_unclaimed / treasury_yield_unclaimed / last_yield_at
+    // These are decoded best-effort; if older accounts predate them, the
+    // remaining buffer is shorter and we return zeros.
+    let totalYieldAccrued = 0n;
+    let builderYieldUnclaimed = 0n;
+    let treasuryYieldUnclaimed = 0n;
+    let lastYieldAt = 0;
+    if (r.remaining >= 8 + 8 + 8 + 8) {
+        totalYieldAccrued = r.u64();
+        builderYieldUnclaimed = r.u64();
+        treasuryYieldUnclaimed = r.u64();
+        lastYieldAt = Number(r.i64());
+    }
+    return {
+        controller,
+        bondMint,
+        bondVault,
+        scorer,
+        framework,
+        metadataUri,
+        createdAt,
+        lastActionAt,
+        actionCount,
+        successCount,
+        failedCount,
+        disputedCount,
+        currentBond,
+        reservedForClaims,
+        valueHandled30d,
+        currentScore,
+        openClaims,
+        frozen,
+        // The yield fields aren't part of the public AgentAccount type yet,
+        // so we attach them as optional properties on the returned object.
+        ...{
+            totalYieldAccrued,
+            builderYieldUnclaimed,
+            treasuryYieldUnclaimed,
+            lastYieldAt,
+        },
+    };
+}
+export function decodeClaimAccount(data) {
+    if (data.length < 8)
+        return null;
+    if (!data.subarray(0, 8).equals(ACCOUNT_DISC.Claim))
+        return null;
+    const r = new BorshReader(data.subarray(8));
+    const agent = r.pubkey();
+    const claimer = r.pubkey();
+    const actionHash = r.fixedBytes(32);
+    const claimedAmount = r.u64();
+    const depositAmount = r.u64();
+    const evidenceUri = r.string();
+    const deadline = Number(r.i64());
+    const createdAt = Number(r.i64());
+    const status = r.u8();
+    const resolvedAt = Number(r.i64());
+    // bump
+    r.u8();
+    // v0.3 fields — best-effort, fall back to zero if older account predates them
+    let escalationDeposit = 0n;
+    let escalatedAt = 0;
+    let resolvedBy = 0;
+    if (r.remaining >= 8 + 8 + 1) {
+        escalationDeposit = r.u64();
+        escalatedAt = Number(r.i64());
+        resolvedBy = r.u8();
+    }
+    return {
+        agent,
+        claimer,
+        actionHash,
+        claimedAmount,
+        depositAmount,
+        evidenceUri,
+        createdAt,
+        deadline,
+        status,
+        resolvedAt,
+        ...{ escalationDeposit, escalatedAt, resolvedBy },
+    };
+}
+//# sourceMappingURL=accounts.js.map

package/dist/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../src/accounts.ts"],"names":[],"mappings":"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"}