@telaro/sdk 0.1.0

package/dist/score.d.ts

@@ -0,0 +1,51 @@
+export interface ScoreInputs {
+    actionCount: number | bigint;
+    successCount: number | bigint;
+    disputedCount: number | bigint;
+    /** Current bond in atomic units (e.g. USDC base units, 6dp). */
+    currentBond: number | bigint;
+    /** Sum of value_atomic over the last 30d (atomic units). */
+    valueHandled30d: number | bigint;
+    /** True if a high-value failure happened in the last 7d. */
+    recentHighValueFailure7d?: boolean;
+    /** v0.3: Number of successful actions recorded after the most recent
+     *  dispute. Used to compute the redemption factor — a builder who
+     *  has gotten back to consistent successful operation gradually
+     *  rebuilds reputation. Optional (defaults to 0 → no redemption). */
+    successCountSinceLastDispute?: number | bigint;
+}
+export interface ScoreOutput {
+    score: number;
+    bondRatioBps: number;
+    components: {
+        base: number;
+        tenure: number;
+        successRate: number;
+        disputeRate: number;
+        bondRatio: number;
+        decay: number;
+    };
+}
+/**
+ * Default v0.3 scoring policy.
+ * score = base
+ *       + 50  × tanh(log10(action_count))                  (tenure, max +50)
+ *       + 200 × (success / action)                          (max +200)
+ *       - 300 × (disputed / action) × (1 - redemption_factor × 0.5)
+ *                                                           (max -300, min -150 with full redemption)
+ *       + 100 × min(1.0, bond / value_handled_30d)         (max +100)
+ *       - 100 if recent_high_value_failure_in_7d
+ * clamped to [0, 1000]
+ *
+ * v0.3 redemption factor:
+ *   redemption_factor = min(1.0, success_count_since_last_dispute / 50)
+ *
+ * After 50 consecutive successful actions post-dispute, half the
+ * dispute weight is forgiven. Encourages builder rehabilitation
+ * rather than forcing keypair rotation. Note: dispute_count itself
+ * is permanent on chain — only the score impact decays.
+ */
+export declare function computeScore(input: ScoreInputs): ScoreOutput;
+export type ScoreTier = "high" | "medium" | "low";
+export declare function tierOf(score: number): ScoreTier;
+//# sourceMappingURL=score.d.ts.map

package/dist/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,gEAAgE;IAChE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,4DAA4D;IAC5D,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;yEAGqE;IACrE,4BAA4B,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CA2C5D;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAElD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAI/C"}

package/dist/score.js

@@ -0,0 +1,63 @@
+import { BASE_SCORE, MAX_SCORE } from "./constants.js";
+/**
+ * Default v0.3 scoring policy.
+ * score = base
+ *       + 50  × tanh(log10(action_count))                  (tenure, max +50)
+ *       + 200 × (success / action)                          (max +200)
+ *       - 300 × (disputed / action) × (1 - redemption_factor × 0.5)
+ *                                                           (max -300, min -150 with full redemption)
+ *       + 100 × min(1.0, bond / value_handled_30d)         (max +100)
+ *       - 100 if recent_high_value_failure_in_7d
+ * clamped to [0, 1000]
+ *
+ * v0.3 redemption factor:
+ *   redemption_factor = min(1.0, success_count_since_last_dispute / 50)
+ *
+ * After 50 consecutive successful actions post-dispute, half the
+ * dispute weight is forgiven. Encourages builder rehabilitation
+ * rather than forcing keypair rotation. Note: dispute_count itself
+ * is permanent on chain — only the score impact decays.
+ */
+export function computeScore(input) {
+    const actionCount = Number(input.actionCount);
+    const successCount = Number(input.successCount);
+    const disputedCount = Number(input.disputedCount);
+    const bond = Number(input.currentBond);
+    const valueHandled = Number(input.valueHandled30d);
+    const successSinceDispute = Number(input.successCountSinceLastDispute ?? 0);
+    const base = BASE_SCORE;
+    const tenure = actionCount === 0
+        ? 0
+        : 50 * Math.tanh(Math.log10(Math.max(1, actionCount)));
+    const successRate = actionCount === 0 ? 0 : 200 * (successCount / actionCount);
+    // v0.3 redemption: post-dispute successes forgive up to 50% of dispute weight
+    const redemptionFactor = Math.min(1.0, successSinceDispute / 50);
+    const disputeWeight = -300 * (1 - redemptionFactor * 0.5);
+    const disputeRate = actionCount === 0 ? 0 : disputeWeight * (disputedCount / actionCount);
+    const ratio = valueHandled === 0 ? 1 : Math.min(1, bond / valueHandled);
+    const bondRatio = 100 * ratio;
+    const decay = input.recentHighValueFailure7d ? -100 : 0;
+    const raw = base + tenure + successRate + disputeRate + bondRatio + decay;
+    const score = Math.max(0, Math.min(MAX_SCORE, Math.round(raw)));
+    const bondRatioBps = Math.round(ratio * 10_000);
+    return {
+        score,
+        bondRatioBps,
+        components: {
+            base,
+            tenure: Math.round(tenure),
+            successRate: Math.round(successRate),
+            disputeRate: Math.round(disputeRate),
+            bondRatio: Math.round(bondRatio),
+            decay,
+        },
+    };
+}
+export function tierOf(score) {
+    if (score >= 700)
+        return "high";
+    if (score >= 400)
+        return "medium";
+    return "low";
+}
+//# sourceMappingURL=score.js.map

package/dist/score.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,139 @@
+import type { PublicKey } from "@solana/web3.js";
+export declare enum ActionKind {
+    Swap = 0,
+    Lp = 1,
+    Vote = 2,
+    Message = 3,
+    Lend = 4,
+    Stake = 5,
+    Bridge = 6,
+    Custom = 99
+}
+export declare enum ActionOutcome {
+    Success = 0,
+    Failed = 1,
+    Disputed = 2
+}
+export declare enum ClaimStatus {
+    Open = 0,
+    AcceptedByBuilder = 1,
+    AutoAccepted = 2,
+    RejectedByBuilder = 3,
+    Withdrawn = 4,
+    /** v0.3: user escalated, awaiting arbiter ruling. */
+    Escalated = 5,
+    /** v0.3: arbiter ruled ForUser. 2x penalty paid out. */
+    ArbiterAcceptedForUser = 6,
+    /** v0.3: arbiter ruled ForBuilder. User loses both deposits. */
+    ArbiterAcceptedForBuilder = 7,
+    /** v0.3: arbiter window expired (7d). Defaults to user payout. */
+    ArbiterAutoForUser = 8
+}
+export declare enum ResolveAction {
+    BuilderAccept = 0,
+    BuilderReject = 1,
+    AutoTimeout = 2
+}
+/** Who decided the final outcome of a claim. */
+export declare enum ClaimResolvedBy {
+    /** Builder (accept or reject) or AutoTimeout (no signer required). */
+    BuilderOrAutoTimeout = 0,
+    AutoTimeout = 1,
+    /** Active arbiter ruling. */
+    Arbiter = 2,
+    /** Arbiter window expired, anyone cranked. */
+    ArbiterTimeout = 3
+}
+export interface AgentAccount {
+    controller: PublicKey;
+    bondMint: PublicKey;
+    bondVault: PublicKey;
+    scorer: PublicKey;
+    framework: string;
+    metadataUri: string;
+    createdAt: number;
+    lastActionAt: number;
+    actionCount: bigint;
+    successCount: bigint;
+    failedCount: bigint;
+    disputedCount: bigint;
+    currentBond: bigint;
+    /** Sum of `claimed_amount` across open claims, reserved against
+     *  current_bond. New claims are blocked if (current_bond −
+     *  reserved_for_claims) < amount. */
+    reservedForClaims: bigint;
+    valueHandled30d: bigint;
+    currentScore: number;
+    openClaims: number;
+    frozen: boolean;
+}
+export interface LogEntry {
+    actionHash: Uint8Array;
+    kind: number;
+    outcome: number;
+    valueAtomic: bigint;
+    slot: bigint;
+    ts: number;
+}
+export interface ClaimAccount {
+    agent: PublicKey;
+    claimer: PublicKey;
+    actionHash: Uint8Array;
+    claimedAmount: bigint;
+    depositAmount: bigint;
+    evidenceUri: string;
+    createdAt: number;
+    deadline: number;
+    status: ClaimStatus;
+    resolvedAt: number;
+    /** v0.3: 5% additional deposit posted on escalation. */
+    escalationDeposit?: bigint;
+    /** v0.3: timestamp escalate_claim was called. 0 if never escalated. */
+    escalatedAt?: number;
+    /** v0.3: who decided the final outcome (Builder/AutoTimeout/Arbiter/ArbiterTimeout). */
+    resolvedBy?: ClaimResolvedBy;
+}
+export interface RecordActionInput {
+    /** Optional explicit hash. If omitted, the SDK hashes the payload. */
+    actionHash?: Uint8Array;
+    /** Free-form payload hashed into the on-chain action_hash. */
+    payload?: unknown;
+    kind: ActionKind;
+    outcome: ActionOutcome;
+    /** Approx value-at-risk in token base units (USDC: 6dp). 0 if non-financial. */
+    valueAtomic: bigint;
+}
+export interface RegisterAgentInput {
+    framework: string;
+    metadataUri: string;
+    /** Pubkey allowed to call `update_score` (off-chain indexer). */
+    scorer: PublicKey;
+    /** Bond mint (USDC on mainnet, mock on devnet). */
+    bondMint: PublicKey;
+    /** Atomic bond amount (USDC: 10 = 10_000_000). */
+    bondAmount: bigint;
+}
+export interface SubmitClaimInput {
+    agent: PublicKey;
+    actionHash: Uint8Array;
+    /** Claimed damage in bond-mint atomic units. */
+    claimedAmount: bigint;
+    /** ipfs:// or arweave:// URI to evidence. */
+    evidenceUri: string;
+}
+export interface TrustCardData {
+    agent: PublicKey;
+    agentString: string;
+    framework: string;
+    controller: PublicKey;
+    score: number;
+    scoreTier: "high" | "medium" | "low";
+    bondAtomic: bigint;
+    bondHuman: string;
+    actionCount: bigint;
+    successRate: number;
+    disputed90d: number;
+    bondedSinceTs: number;
+    frozen: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,51 @@
+export var ActionKind;
+(function (ActionKind) {
+    ActionKind[ActionKind["Swap"] = 0] = "Swap";
+    ActionKind[ActionKind["Lp"] = 1] = "Lp";
+    ActionKind[ActionKind["Vote"] = 2] = "Vote";
+    ActionKind[ActionKind["Message"] = 3] = "Message";
+    ActionKind[ActionKind["Lend"] = 4] = "Lend";
+    ActionKind[ActionKind["Stake"] = 5] = "Stake";
+    ActionKind[ActionKind["Bridge"] = 6] = "Bridge";
+    ActionKind[ActionKind["Custom"] = 99] = "Custom";
+})(ActionKind || (ActionKind = {}));
+export var ActionOutcome;
+(function (ActionOutcome) {
+    ActionOutcome[ActionOutcome["Success"] = 0] = "Success";
+    ActionOutcome[ActionOutcome["Failed"] = 1] = "Failed";
+    ActionOutcome[ActionOutcome["Disputed"] = 2] = "Disputed";
+})(ActionOutcome || (ActionOutcome = {}));
+export var ClaimStatus;
+(function (ClaimStatus) {
+    ClaimStatus[ClaimStatus["Open"] = 0] = "Open";
+    ClaimStatus[ClaimStatus["AcceptedByBuilder"] = 1] = "AcceptedByBuilder";
+    ClaimStatus[ClaimStatus["AutoAccepted"] = 2] = "AutoAccepted";
+    ClaimStatus[ClaimStatus["RejectedByBuilder"] = 3] = "RejectedByBuilder";
+    ClaimStatus[ClaimStatus["Withdrawn"] = 4] = "Withdrawn";
+    /** v0.3: user escalated, awaiting arbiter ruling. */
+    ClaimStatus[ClaimStatus["Escalated"] = 5] = "Escalated";
+    /** v0.3: arbiter ruled ForUser. 2x penalty paid out. */
+    ClaimStatus[ClaimStatus["ArbiterAcceptedForUser"] = 6] = "ArbiterAcceptedForUser";
+    /** v0.3: arbiter ruled ForBuilder. User loses both deposits. */
+    ClaimStatus[ClaimStatus["ArbiterAcceptedForBuilder"] = 7] = "ArbiterAcceptedForBuilder";
+    /** v0.3: arbiter window expired (7d). Defaults to user payout. */
+    ClaimStatus[ClaimStatus["ArbiterAutoForUser"] = 8] = "ArbiterAutoForUser";
+})(ClaimStatus || (ClaimStatus = {}));
+export var ResolveAction;
+(function (ResolveAction) {
+    ResolveAction[ResolveAction["BuilderAccept"] = 0] = "BuilderAccept";
+    ResolveAction[ResolveAction["BuilderReject"] = 1] = "BuilderReject";
+    ResolveAction[ResolveAction["AutoTimeout"] = 2] = "AutoTimeout";
+})(ResolveAction || (ResolveAction = {}));
+/** Who decided the final outcome of a claim. */
+export var ClaimResolvedBy;
+(function (ClaimResolvedBy) {
+    /** Builder (accept or reject) or AutoTimeout (no signer required). */
+    ClaimResolvedBy[ClaimResolvedBy["BuilderOrAutoTimeout"] = 0] = "BuilderOrAutoTimeout";
+    ClaimResolvedBy[ClaimResolvedBy["AutoTimeout"] = 1] = "AutoTimeout";
+    /** Active arbiter ruling. */
+    ClaimResolvedBy[ClaimResolvedBy["Arbiter"] = 2] = "Arbiter";
+    /** Arbiter window expired, anyone cranked. */
+    ClaimResolvedBy[ClaimResolvedBy["ArbiterTimeout"] = 3] = "ArbiterTimeout";
+})(ClaimResolvedBy || (ClaimResolvedBy = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,UASX;AATD,WAAY,UAAU;IACpB,2CAAQ,CAAA;IACR,uCAAM,CAAA;IACN,2CAAQ,CAAA;IACR,iDAAW,CAAA;IACX,2CAAQ,CAAA;IACR,6CAAS,CAAA;IACT,+CAAU,CAAA;IACV,gDAAW,CAAA;AACb,CAAC,EATW,UAAU,KAAV,UAAU,QASrB;AAED,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,uDAAW,CAAA;IACX,qDAAU,CAAA;IACV,yDAAY,CAAA;AACd,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED,MAAM,CAAN,IAAY,WAcX;AAdD,WAAY,WAAW;IACrB,6CAAQ,CAAA;IACR,uEAAqB,CAAA;IACrB,6DAAgB,CAAA;IAChB,uEAAqB,CAAA;IACrB,uDAAa,CAAA;IACb,qDAAqD;IACrD,uDAAa,CAAA;IACb,wDAAwD;IACxD,iFAA0B,CAAA;IAC1B,gEAAgE;IAChE,uFAA6B,CAAA;IAC7B,kEAAkE;IAClE,yEAAsB,CAAA;AACxB,CAAC,EAdW,WAAW,KAAX,WAAW,QActB;AAED,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,mEAAiB,CAAA;IACjB,mEAAiB,CAAA;IACjB,+DAAe,CAAA;AACjB,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED,gDAAgD;AAChD,MAAM,CAAN,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,sEAAsE;IACtE,qFAAwB,CAAA;IACxB,mEAAe,CAAA;IACf,6BAA6B;IAC7B,2DAAW,CAAA;IACX,8CAA8C;IAC9C,yEAAkB,CAAA;AACpB,CAAC,EARW,eAAe,KAAf,eAAe,QAQ1B"}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@telaro/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Telaro protocol on Solana \u2014 skin-in-the-game reputation primitive",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./score": {
+      "types": "./dist/score.d.ts",
+      "import": "./dist/score.js"
+    },
+    "./pda": {
+      "types": "./dist/pda.d.ts",
+      "import": "./dist/pda.js"
+    },
+    "./api": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.js"
+    },
+    "./metaplex": {
+      "types": "./dist/metaplex.d.ts",
+      "import": "./dist/metaplex.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "QUICKSTART.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx/esm --test --test-concurrency=1 tests/*.test.ts",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm clean && pnpm build",
+    "publish:dry": "npm publish --dry-run"
+  },
+  "dependencies": {
+    "@coral-xyz/anchor": "^0.30.1",
+    "@metaplex-foundation/mpl-core": "^1.1.1",
+    "@metaplex-foundation/umi": "^0.9.2",
+    "@metaplex-foundation/umi-bundle-defaults": "^0.9.2",
+    "@metaplex-foundation/umi-signer-wallet-adapters": "^0.9.2",
+    "@metaplex-foundation/umi-web3js-adapters": "^0.9.2",
+    "@noble/hashes": "^1.5.0",
+    "@solana/spl-token": "^0.4.8",
+    "@solana/web3.js": "^1.95.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.5.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/telaro-protocol/telaro.git",
+    "directory": "sdk"
+  },
+  "homepage": "https://telaro.xyz",
+  "bugs": {
+    "url": "https://github.com/telaro-protocol/telaro/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "ai-agents",
+    "anchor",
+    "metaplex",
+    "reputation",
+    "sdk",
+    "solana",
+    "telaro"
+  ],
+  "type": "module",
+  "sideEffects": false
+}