@telaro/sdk 0.1.0

package/dist/client.js

@@ -0,0 +1,164 @@
+import { Transaction, sendAndConfirmTransaction, } from "@solana/web3.js";
+import { getAssociatedTokenAddress } from "@solana/spl-token";
+import { PROGRAM_ID } from "./constants.js";
+import { hashAction } from "./hash.js";
+import { findAgentPda, findClaimPda } from "./pda.js";
+import { buildArbiterResolveIx, buildArbiterTimeoutIx, buildEscalateClaimIx, buildRecordActionIx, buildRegisterAndBondIxs, buildResolveClaimIx, buildSubmitClaimIx, buildTopUpIx, buildUpdateScoreIx, buildViewBondIx, buildWithdrawBondIx, } from "./instructions.js";
+import { ActionKind, ActionOutcome, ResolveAction, } from "./types.js";
+/**
+ * High-level client. Wraps the on-chain instructions for the agent-side flow
+ * (register / record_action / top_up / withdraw) and the user-side flow
+ * (submit_claim / resolve_claim).
+ */
+export class TelaroClient {
+    connection;
+    signer;
+    programId;
+    commitment;
+    constructor(connection, signer, opts = {}) {
+        this.connection = connection;
+        this.signer = signer;
+        this.programId = opts.programId ?? PROGRAM_ID;
+        this.commitment = opts.commitment ?? "confirmed";
+    }
+    get controller() {
+        return this.signer.publicKey;
+    }
+    agentPda(controller = this.controller) {
+        return findAgentPda(controller, this.programId)[0];
+    }
+    async registerAgent(input) {
+        const ata = await getAssociatedTokenAddress(input.bondMint, this.controller);
+        const [initIx, bondIx] = buildRegisterAndBondIxs({
+            controller: this.controller,
+            controllerBondAta: ata,
+            framework: input.framework,
+            metadataUri: input.metadataUri,
+            scorer: input.scorer,
+            bondMint: input.bondMint,
+            bondAmount: input.bondAmount,
+        }, this.programId);
+        return this.send(initIx, bondIx);
+    }
+    async recordAction(input) {
+        const hash = input.actionHash ?? hashAction(input.payload ?? {});
+        const ix = buildRecordActionIx(this.controller, {
+            actionHash: hash,
+            kind: input.kind,
+            outcome: input.outcome,
+            valueAtomic: input.valueAtomic,
+        }, this.programId);
+        return this.send(ix);
+    }
+    async topUpBond(args) {
+        const ata = await getAssociatedTokenAddress(args.bondMint, this.controller);
+        const ix = buildTopUpIx({
+            agent: args.agent,
+            bondMint: args.bondMint,
+            payer: this.controller,
+            payerBondAta: ata,
+        }, args.amount, this.programId);
+        return this.send(ix);
+    }
+    async submitClaim(input, bondMint) {
+        const ata = await getAssociatedTokenAddress(bondMint, this.controller);
+        const ix = buildSubmitClaimIx({
+            agent: input.agent,
+            bondMint,
+            claimer: this.controller,
+            claimerBondAta: ata,
+        }, {
+            actionHash: input.actionHash,
+            claimedAmount: input.claimedAmount,
+            evidenceUri: input.evidenceUri,
+        }, this.programId);
+        return this.send(ix);
+    }
+    async resolveClaim(args) {
+        const [claim] = findClaimPda(args.agent, args.actionHash, args.claimer, this.programId);
+        const claimerAta = await getAssociatedTokenAddress(args.bondMint, args.claimer);
+        const ix = buildResolveClaimIx({
+            agent: args.agent,
+            claim,
+            bondMint: args.bondMint,
+            claimerBondAta: claimerAta,
+            signer: this.controller,
+        }, args.action, this.programId);
+        return this.send(ix);
+    }
+    /** v0.3: User escalates a rejected claim within 24h. Posts an
+     *  additional 5% deposit. */
+    async escalateClaim(args) {
+        const [claim] = findClaimPda(args.agent, args.actionHash, this.controller, this.programId);
+        const ata = await getAssociatedTokenAddress(args.bondMint, this.controller);
+        const ix = buildEscalateClaimIx({
+            claim,
+            agent: args.agent,
+            bondMint: args.bondMint,
+            claimerBondAta: ata,
+            claimer: this.controller,
+        }, this.programId);
+        return this.send(ix);
+    }
+    /** v0.3: Protocol arbiter rules ForUser (0) or ForBuilder (1). Caller
+     *  must be the configured PROTOCOL_ARBITER pubkey. */
+    async arbiterResolve(args) {
+        const [claim] = findClaimPda(args.agent, args.actionHash, args.claimer, this.programId);
+        const claimerAta = await getAssociatedTokenAddress(args.bondMint, args.claimer);
+        const ix = buildArbiterResolveIx({
+            claim,
+            agent: args.agent,
+            bondMint: args.bondMint,
+            claimerBondAta: claimerAta,
+            arbiter: this.controller,
+        }, args.ruling, this.programId);
+        return this.send(ix);
+    }
+    /** v0.3: Anyone can crank after 7d arbiter window. Defaults ForUser. */
+    async arbiterTimeout(args) {
+        const [claim] = findClaimPda(args.agent, args.actionHash, args.claimer, this.programId);
+        const claimerAta = await getAssociatedTokenAddress(args.bondMint, args.claimer);
+        const ix = buildArbiterTimeoutIx({
+            claim,
+            agent: args.agent,
+            bondMint: args.bondMint,
+            claimerBondAta: claimerAta,
+            cranker: this.controller,
+        }, this.programId);
+        return this.send(ix);
+    }
+    async updateScore(agent, newScore, bondRatioBps) {
+        const ix = buildUpdateScoreIx(agent, this.controller, { newScore, bondRatioBps }, this.programId);
+        return this.send(ix);
+    }
+    async withdrawBond(args) {
+        const ata = await getAssociatedTokenAddress(args.bondMint, this.controller);
+        const ix = buildWithdrawBondIx({
+            agent: args.agent,
+            bondMint: args.bondMint,
+            controller: this.controller,
+            controllerBondAta: ata,
+        }, args.amount, this.programId);
+        return this.send(ix);
+    }
+    async previewViewBond(agent, minBond, minScore) {
+        const ix = buildViewBondIx(agent, { minBond, minScore }, this.programId);
+        try {
+            const tx = new Transaction().add(ix);
+            const { blockhash } = await this.connection.getLatestBlockhash();
+            tx.recentBlockhash = blockhash;
+            tx.feePayer = this.controller;
+            const sim = await this.connection.simulateTransaction(tx);
+            return sim.value.err === null;
+        }
+        catch {
+            return false;
+        }
+    }
+    async send(...ixs) {
+        const tx = new Transaction().add(...ixs);
+        return sendAndConfirmTransaction(this.connection, tx, [this.signer], { commitment: this.commitment });
+    }
+}
+export { ActionKind, ActionOutcome, ResolveAction };
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,46 @@
+import { PublicKey } from "@solana/web3.js";
+export declare const PROGRAM_ID: PublicKey;
+/** USDC has 6 decimals; bond floor = 1 USDC. */
+export declare const MIN_BOND_USDC = 1000000n;
+/** 5% of claimed amount, in basis points. */
+export declare const CLAIM_DEPOSIT_BPS = 500n;
+/** 1% — bond fraction moved to treasury when builder accepts a claim.
+ *  Drops the ROI of self-claim sock-puppet attacks. */
+export declare const ACCEPT_COST_BPS = 100n;
+/** 1% — bond fraction moved to treasury when builder rejects a claim.
+ *  Makes spam-rejecting expensive (50 rejects ≈ 50% of bond). */
+export declare const REJECTION_COST_BPS = 100n;
+/** Total bps denominator (10_000 = 100%). */
+export declare const TOTAL_BPS = 10000n;
+/** 24h escalation window after a claim is rejected. */
+export declare const ESCALATION_WINDOW_SECONDS: number;
+/** 7d arbiter window after a claim is escalated. */
+export declare const ARBITER_WINDOW_SECONDS: number;
+/** 5% additional deposit posted when escalating. Refunded if arbiter
+ *  rules ForUser, lost to treasury if ForBuilder. */
+export declare const ESCALATION_DEPOSIT_BPS = 500n;
+/** 100% — bond → user penalty (in addition to claimed_amount) when
+ *  arbiter rules ForUser. Capped at current_bond. */
+export declare const ARBITER_PENALTY_BPS = 10000n;
+/** 2% — arbiter fee (bond → treasury) on ForUser ruling. Halved if
+ *  ruling time exceeds ARBITER_SPEED_BONUS_SECONDS. */
+export declare const ARBITER_FEE_BPS = 200n;
+/** 24h — full arbiter fee window. Beyond this, the fee halves to
+ *  incentivize fast turnaround. */
+export declare const ARBITER_SPEED_BONUS_SECONDS: number;
+/** 5x — max ratio of value_handled_30d to current_bond enforced by
+ *  view_bond CPI. Prevents bond rotation attacks. */
+export declare const MAX_LEVERAGE_RATIO = 5n;
+/** Protocol arbiter pubkey for v0.3 (single-key). v1 → Squads multisig. */
+export declare const PROTOCOL_ARBITER: PublicKey;
+/** 7 days. */
+export declare const CLAIM_WINDOW_SECONDS: number;
+/** 30 days from last action before bond can be withdrawn. */
+export declare const WITHDRAWAL_COOLDOWN_SECONDS: number;
+export declare const MAX_SCORE = 1000;
+export declare const BASE_SCORE = 500;
+export declare const RING_CAPACITY = 128;
+/** 10% — liquid reserve floor enforced by `route_to_marginfi`. Matches
+ *  `programs/telaro/src/state.rs::RESERVE_BUFFER_BPS`. */
+export declare const RESERVE_BUFFER_BPS = 1000n;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,eAAO,MAAM,UAAU,WAEtB,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,aAAa,WAAa,CAAC;AAExC,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;uDACuD;AACvD,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;iEACiE;AACjE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,6CAA6C;AAC7C,eAAO,MAAM,SAAS,SAAU,CAAC;AAIjC,uDAAuD;AACvD,eAAO,MAAM,yBAAyB,QAAe,CAAC;AAEtD,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AAEvD;qDACqD;AACrD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;qDACqD;AACrD,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAE3C;uDACuD;AACvD,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;mCACmC;AACnC,eAAO,MAAM,2BAA2B,QAAe,CAAC;AAExD;qDACqD;AACrD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,WAE5B,CAAC;AAEF,cAAc;AACd,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAErD,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B,QAAoB,CAAC;AAE7D,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;0DAC0D;AAC1D,eAAO,MAAM,kBAAkB,QAAQ,CAAC"}

package/dist/constants.js

@@ -0,0 +1,47 @@
+import { PublicKey } from "@solana/web3.js";
+export const PROGRAM_ID = new PublicKey("3DUrvVWEziYLtEbiDtfxqh1ioXRFX6DNvV4iTsGed2rs");
+/** USDC has 6 decimals; bond floor = 1 USDC. */
+export const MIN_BOND_USDC = 1000000n;
+/** 5% of claimed amount, in basis points. */
+export const CLAIM_DEPOSIT_BPS = 500n;
+/** 1% — bond fraction moved to treasury when builder accepts a claim.
+ *  Drops the ROI of self-claim sock-puppet attacks. */
+export const ACCEPT_COST_BPS = 100n;
+/** 1% — bond fraction moved to treasury when builder rejects a claim.
+ *  Makes spam-rejecting expensive (50 rejects ≈ 50% of bond). */
+export const REJECTION_COST_BPS = 100n;
+/** Total bps denominator (10_000 = 100%). */
+export const TOTAL_BPS = 10000n;
+/* v0.3: arbiter escalation flow */
+/** 24h escalation window after a claim is rejected. */
+export const ESCALATION_WINDOW_SECONDS = 24 * 60 * 60;
+/** 7d arbiter window after a claim is escalated. */
+export const ARBITER_WINDOW_SECONDS = 7 * 24 * 60 * 60;
+/** 5% additional deposit posted when escalating. Refunded if arbiter
+ *  rules ForUser, lost to treasury if ForBuilder. */
+export const ESCALATION_DEPOSIT_BPS = 500n;
+/** 100% — bond → user penalty (in addition to claimed_amount) when
+ *  arbiter rules ForUser. Capped at current_bond. */
+export const ARBITER_PENALTY_BPS = 10000n;
+/** 2% — arbiter fee (bond → treasury) on ForUser ruling. Halved if
+ *  ruling time exceeds ARBITER_SPEED_BONUS_SECONDS. */
+export const ARBITER_FEE_BPS = 200n;
+/** 24h — full arbiter fee window. Beyond this, the fee halves to
+ *  incentivize fast turnaround. */
+export const ARBITER_SPEED_BONUS_SECONDS = 24 * 60 * 60;
+/** 5x — max ratio of value_handled_30d to current_bond enforced by
+ *  view_bond CPI. Prevents bond rotation attacks. */
+export const MAX_LEVERAGE_RATIO = 5n;
+/** Protocol arbiter pubkey for v0.3 (single-key). v1 → Squads multisig. */
+export const PROTOCOL_ARBITER = new PublicKey("CWz9b8g4h78ytQnd4gEU9qk4fP1wtQjfa7L838HtKNps");
+/** 7 days. */
+export const CLAIM_WINDOW_SECONDS = 7 * 24 * 60 * 60;
+/** 30 days from last action before bond can be withdrawn. */
+export const WITHDRAWAL_COOLDOWN_SECONDS = 30 * 24 * 60 * 60;
+export const MAX_SCORE = 1000;
+export const BASE_SCORE = 500;
+export const RING_CAPACITY = 128;
+/** 10% — liquid reserve floor enforced by `route_to_marginfi`. Matches
+ *  `programs/telaro/src/state.rs::RESERVE_BUFFER_BPS`. */
+export const RESERVE_BUFFER_BPS = 1000n;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,SAAS,CACrC,8CAA8C,CAC/C,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,QAAU,CAAC;AAExC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC;uDACuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC;iEACiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEvC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,MAAO,CAAC;AAEjC,mCAAmC;AAEnC,uDAAuD;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAEtD,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAEvD;qDACqD;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C;qDACqD;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAO,CAAC;AAE3C;uDACuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC;mCACmC;AACnC,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAExD;qDACqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,SAAS,CAC3C,8CAA8C,CAC/C,CAAC;AAEF,cAAc;AACd,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAErD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAE7D,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAC9B,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAE9B,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC;0DAC0D;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC"}

package/dist/credit.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Credit module — score → loan-to-value (LTV) and under-collateralization
+ * parameters for bonded agents.
+ *
+ * The Telaro trust score (0–1000) is more than reputation: it's a credit
+ * grade. Higher score = more trust = the agent can post less than 100%
+ * of their slashable bond and borrow the rest from the underwriter pool
+ * (Phase D credit market).
+ *
+ * Mechanic in plain English:
+ *   - Score ≤ 600  → must post 100% bond themselves (no credit line)
+ *   - Score 700    → only 80% required, 20% credit line from the pool
+ *   - Score 800    → 50% required, 50% credit
+ *   - Score 900    → 30% required, 70% credit
+ *   - Score 1000   → 10% required, 90% credit
+ *
+ * Interest rate: lower score → higher rate (risk pricing). Default tier
+ * (`baseRateBps`) is 800 bps (8% APY) at the floor (700) and falls to
+ * 300 bps (3%) at the ceiling (1000).
+ *
+ * No on-chain code yet — this module is the reference policy that the
+ * `request_credit` ix (planned) will mirror, just like `computeScore`
+ * mirrors what `update_score` will compute on-chain at v1.
+ */
+export interface CreditTerms {
+    /** Eligible for under-collateralized credit at all? */
+    eligible: boolean;
+    /** Required own-bond as a fraction of the slashable amount (0–1). */
+    requiredCollateralRatio: number;
+    /** Credit line as a fraction of the slashable amount (0–1). */
+    creditLineRatio: number;
+    /** Required own-bond in basis points (e.g. 5_000 = 50%). */
+    requiredCollateralBps: number;
+    /** Credit line ratio in basis points. */
+    creditLineBps: number;
+    /** Annual interest rate on the credit portion, in basis points (8% = 800). */
+    interestRateBps: number;
+    /** Human-readable tier label for UI. */
+    tier: CreditTier;
+    /** How many score points to the next tier (0 if maxed). */
+    pointsToNextTier: number;
+}
+export type CreditTier = "no-credit" | "starter" | "standard" | "premium" | "elite";
+/** Map a score (0–1000) to credit terms. */
+export declare function creditTermsForScore(score: number): CreditTerms;
+/**
+ * Convenience: given an agent's score and the slash-coverage they want
+ * to maintain, compute (a) own-bond they must post and (b) how much
+ * credit they'd draw from the pool. Pure math, no on-chain calls.
+ *
+ * @param totalCoverageAtomic Slashable amount the agent wants the pool
+ *   to vouch for, in atomic units (e.g. USDC 6dp).
+ */
+export declare function splitCoverage(score: number, totalCoverageAtomic: bigint): {
+    ownBondAtomic: bigint;
+    creditAtomic: bigint;
+    terms: CreditTerms;
+};
+/** Human-friendly label used by UI. */
+export declare function creditTierLabel(tier: CreditTier): string;
+//# sourceMappingURL=credit.d.ts.map

package/dist/credit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit.d.ts","sourceRoot":"","sources":["../src/credit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,uBAAuB,EAAE,MAAM,CAAC;IAChC,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,IAAI,EAAE,UAAU,CAAC;IACjB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,SAAS,GACT,UAAU,GACV,SAAS,GACT,OAAO,CAAC;AA+DZ,4CAA4C;AAC5C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAuC9D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,MAAM,GAC1B;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAMrE;AAED,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAQxD"}

package/dist/credit.js

@@ -0,0 +1,133 @@
+/**
+ * Credit module — score → loan-to-value (LTV) and under-collateralization
+ * parameters for bonded agents.
+ *
+ * The Telaro trust score (0–1000) is more than reputation: it's a credit
+ * grade. Higher score = more trust = the agent can post less than 100%
+ * of their slashable bond and borrow the rest from the underwriter pool
+ * (Phase D credit market).
+ *
+ * Mechanic in plain English:
+ *   - Score ≤ 600  → must post 100% bond themselves (no credit line)
+ *   - Score 700    → only 80% required, 20% credit line from the pool
+ *   - Score 800    → 50% required, 50% credit
+ *   - Score 900    → 30% required, 70% credit
+ *   - Score 1000   → 10% required, 90% credit
+ *
+ * Interest rate: lower score → higher rate (risk pricing). Default tier
+ * (`baseRateBps`) is 800 bps (8% APY) at the floor (700) and falls to
+ * 300 bps (3%) at the ceiling (1000).
+ *
+ * No on-chain code yet — this module is the reference policy that the
+ * `request_credit` ix (planned) will mirror, just like `computeScore`
+ * mirrors what `update_score` will compute on-chain at v1.
+ */
+const FULL_BPS = 10_000;
+const CREDIT_FLOOR_SCORE = 700;
+const CREDIT_CEILING_SCORE = 1000;
+/**
+ * Bracket table — required collateral % and interest rate are LINEARLY
+ * interpolated within each bracket so a score of 850 falls between 800
+ * (50%, 6%) and 900 (30%, 4%) at exactly 40%, 5%.
+ */
+const BRACKETS = [
+    {
+        tier: "no-credit",
+        minScore: 0,
+        requiredCollateralBps: FULL_BPS,
+        requiredCollateralBpsTop: FULL_BPS,
+        interestRateBps: 0,
+        interestRateBpsTop: 0,
+    },
+    {
+        tier: "starter",
+        minScore: 700,
+        requiredCollateralBps: 8_000, // 80%
+        requiredCollateralBpsTop: 7_000,
+        interestRateBps: 800, // 8% APY
+        interestRateBpsTop: 700,
+    },
+    {
+        tier: "standard",
+        minScore: 750,
+        requiredCollateralBps: 7_000,
+        requiredCollateralBpsTop: 5_500,
+        interestRateBps: 700,
+        interestRateBpsTop: 600,
+    },
+    {
+        tier: "premium",
+        minScore: 800,
+        requiredCollateralBps: 5_000, // 50%
+        requiredCollateralBpsTop: 3_000,
+        interestRateBps: 600,
+        interestRateBpsTop: 400,
+    },
+    {
+        tier: "elite",
+        minScore: 900,
+        requiredCollateralBps: 3_000, // 30%
+        requiredCollateralBpsTop: 1_000, // 10%
+        interestRateBps: 400,
+        interestRateBpsTop: 300,
+    },
+];
+/** Map a score (0–1000) to credit terms. */
+export function creditTermsForScore(score) {
+    const clamped = Math.max(0, Math.min(CREDIT_CEILING_SCORE, Math.round(score)));
+    // Find the bracket — the highest one whose minScore ≤ clamped.
+    let bracket = BRACKETS[0];
+    for (const b of BRACKETS) {
+        if (clamped >= b.minScore)
+            bracket = b;
+        else
+            break;
+    }
+    // Determine the upper edge of this bracket so we can interpolate.
+    const idx = BRACKETS.indexOf(bracket);
+    const next = BRACKETS[idx + 1];
+    const upperScore = next ? next.minScore : CREDIT_CEILING_SCORE;
+    const lowerScore = bracket.minScore;
+    const span = upperScore - lowerScore;
+    const t = span === 0 ? 0 : (clamped - lowerScore) / span;
+    const requiredCollateralBps = Math.round(bracket.requiredCollateralBps + (bracket.requiredCollateralBpsTop - bracket.requiredCollateralBps) * t);
+    const interestRateBps = Math.round(bracket.interestRateBps + (bracket.interestRateBpsTop - bracket.interestRateBps) * t);
+    const creditLineBps = FULL_BPS - requiredCollateralBps;
+    const eligible = clamped >= CREDIT_FLOOR_SCORE;
+    const pointsToNextTier = next ? Math.max(0, next.minScore - clamped) : 0;
+    return {
+        eligible,
+        requiredCollateralRatio: requiredCollateralBps / FULL_BPS,
+        creditLineRatio: creditLineBps / FULL_BPS,
+        requiredCollateralBps,
+        creditLineBps,
+        interestRateBps,
+        tier: bracket.tier,
+        pointsToNextTier,
+    };
+}
+/**
+ * Convenience: given an agent's score and the slash-coverage they want
+ * to maintain, compute (a) own-bond they must post and (b) how much
+ * credit they'd draw from the pool. Pure math, no on-chain calls.
+ *
+ * @param totalCoverageAtomic Slashable amount the agent wants the pool
+ *   to vouch for, in atomic units (e.g. USDC 6dp).
+ */
+export function splitCoverage(score, totalCoverageAtomic) {
+    const terms = creditTermsForScore(score);
+    const ownBondAtomic = (totalCoverageAtomic * BigInt(terms.requiredCollateralBps)) / BigInt(FULL_BPS);
+    const creditAtomic = totalCoverageAtomic - ownBondAtomic;
+    return { ownBondAtomic, creditAtomic, terms };
+}
+/** Human-friendly label used by UI. */
+export function creditTierLabel(tier) {
+    return {
+        "no-credit": "No credit",
+        starter: "Starter",
+        standard: "Standard",
+        premium: "Premium",
+        elite: "Elite",
+    }[tier];
+}
+//# sourceMappingURL=credit.js.map

package/dist/credit.js.map

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

package/dist/decimal.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Lossless decimal ↔ atomic conversion.
+ *
+ * USDC (and most SPL tokens we touch) are 6-decimal. Naive
+ * `Math.floor(human * 1_000_000)` rounds wrong on common values:
+ *
+ *   0.095129 * 1_000_000 = 95128.99999999999  →  floor = 95128 (off-by-one)
+ *
+ * These helpers parse / format via integer string ops so the round-trip
+ * is exact: `atomicFromDecimal("0.095129", 6) === 95129n`.
+ *
+ * If the input has more decimal places than `decimals`, extra digits
+ * are TRUNCATED (toward zero) — never rounded up. That matches the
+ * Math.floor behavior callers expect when computing transfer amounts.
+ */
+/**
+ * Parse a decimal string into atomic units (bigint), no float math.
+ *
+ * Accepts: `"0"`, `"0.123"`, `"-0.5"`, `"1_000"` (underscores stripped).
+ * Throws on garbage input ("abc", "1.2.3").
+ */
+export declare function atomicFromDecimal(value: string | number, decimals: number): bigint;
+/**
+ * Format a bigint atomic value as a decimal string. Trailing zeros
+ * removed unless `keepTrailingZeros: true`. Always uses `.` separator
+ * regardless of locale.
+ */
+export declare function decimalFromAtomic(atomic: bigint, decimals: number, opts?: {
+    keepTrailingZeros?: boolean;
+}): string;
+/** Sugar — USDC is 6 decimals. */
+export declare const usdcAtomic: (v: string | number) => bigint;
+export declare const usdcDecimal: (a: bigint, opts?: {
+    keepTrailingZeros?: boolean;
+}) => string;
+//# sourceMappingURL=decimal.d.ts.map

package/dist/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../src/decimal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2BlF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,MAAM,CAiBR;AAED,kCAAkC;AAClC,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,GAAG,MAAM,WAA4B,CAAC;AAC1E,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,EAAE,OAAO;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,WAC9C,CAAC"}

package/dist/decimal.js

@@ -0,0 +1,87 @@
+/**
+ * Lossless decimal ↔ atomic conversion.
+ *
+ * USDC (and most SPL tokens we touch) are 6-decimal. Naive
+ * `Math.floor(human * 1_000_000)` rounds wrong on common values:
+ *
+ *   0.095129 * 1_000_000 = 95128.99999999999  →  floor = 95128 (off-by-one)
+ *
+ * These helpers parse / format via integer string ops so the round-trip
+ * is exact: `atomicFromDecimal("0.095129", 6) === 95129n`.
+ *
+ * If the input has more decimal places than `decimals`, extra digits
+ * are TRUNCATED (toward zero) — never rounded up. That matches the
+ * Math.floor behavior callers expect when computing transfer amounts.
+ */
+/**
+ * Parse a decimal string into atomic units (bigint), no float math.
+ *
+ * Accepts: `"0"`, `"0.123"`, `"-0.5"`, `"1_000"` (underscores stripped).
+ * Throws on garbage input ("abc", "1.2.3").
+ */
+export function atomicFromDecimal(value, decimals) {
+    if (decimals < 0 || !Number.isInteger(decimals)) {
+        throw new RangeError(`decimals must be a non-negative integer; got ${decimals}`);
+    }
+    let s = typeof value === "number" ? toLosslessString(value) : String(value).trim();
+    s = s.replace(/_/g, "");
+    if (!s)
+        return 0n;
+    const negative = s.startsWith("-");
+    if (negative)
+        s = s.slice(1);
+    if (s.startsWith("+"))
+        s = s.slice(1);
+    if (!/^\d*(?:\.\d*)?$/.test(s)) {
+        throw new RangeError(`invalid decimal: ${value}`);
+    }
+    const dot = s.indexOf(".");
+    const whole = dot === -1 ? s : s.slice(0, dot);
+    const fracRaw = dot === -1 ? "" : s.slice(dot + 1);
+    // Truncate (don't round) excess fractional digits.
+    const frac = fracRaw.slice(0, decimals);
+    const padded = frac.padEnd(decimals, "0");
+    const combined = (whole === "" ? "0" : whole) + padded;
+    // Strip leading zeros to satisfy BigInt; "0" is fine.
+    const stripped = combined.replace(/^0+(?=\d)/, "");
+    const out = BigInt(stripped || "0");
+    return negative ? -out : out;
+}
+/**
+ * Format a bigint atomic value as a decimal string. Trailing zeros
+ * removed unless `keepTrailingZeros: true`. Always uses `.` separator
+ * regardless of locale.
+ */
+export function decimalFromAtomic(atomic, decimals, opts = {}) {
+    if (decimals < 0 || !Number.isInteger(decimals)) {
+        throw new RangeError(`decimals must be a non-negative integer; got ${decimals}`);
+    }
+    const negative = atomic < 0n;
+    const abs = negative ? -atomic : atomic;
+    let s = abs.toString();
+    if (decimals === 0)
+        return (negative ? "-" : "") + s;
+    s = s.padStart(decimals + 1, "0");
+    const cut = s.length - decimals;
+    let whole = s.slice(0, cut);
+    let frac = s.slice(cut);
+    if (!opts.keepTrailingZeros) {
+        frac = frac.replace(/0+$/, "");
+    }
+    whole = whole.replace(/^0+(?=\d)/, "") || "0";
+    return (negative ? "-" : "") + (frac ? `${whole}.${frac}` : whole);
+}
+/** Sugar — USDC is 6 decimals. */
+export const usdcAtomic = (v) => atomicFromDecimal(v, 6);
+export const usdcDecimal = (a, opts) => decimalFromAtomic(a, 6, opts);
+/**
+ * `Number.toString()` is mostly stable but does collapse to scientific
+ * notation past ±1e21. We only deal with USDC ≤ 1e9, so the simple
+ * conversion is sufficient. Still, guard against NaN / Infinity.
+ */
+function toLosslessString(n) {
+    if (!Number.isFinite(n))
+        throw new RangeError(`non-finite number: ${n}`);
+    return n.toString();
+}
+//# sourceMappingURL=decimal.js.map

package/dist/decimal.js.map

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