@decentrys/dri-sdk 0.1.0

package/dist/model.d.ts

@@ -0,0 +1,354 @@
+/**
+ * Digital Recovery Intelligence: the model.
+ *
+ * DRI answers three questions in order — where did the value go, who is at
+ * that destination, and is there anyone with the standing and the ability to
+ * do something about it. This package makes those answers available to the
+ * organisation whose value it was.
+ *
+ * Four constraints shape every type here. They are product and legal
+ * positions, not preferences, and the types are built so that code consuming
+ * them cannot quietly drop any of them:
+ *
+ *  1. **Decentrys never takes custody, and never freezes, seizes or returns
+ *     anything.** Nothing in this package can be called to move value, and
+ *     nothing it returns says value was moved by Decentrys. Every timeline
+ *     entry names the party that acted, which is why `actorParty` is required
+ *     rather than optional.
+ *
+ *  2. **Decentrys is not a law firm, a law-enforcement agency or a licensed
+ *     recovery agent.** Nothing returned here is legal advice, and the
+ *     statement travels in the payload — see `notes` on every response.
+ *
+ *  3. **The Recovery Index is an analytical estimate, never a prediction.**
+ *     `RecoveryIndex` requires both `disclaimer` and `analyticalOnly`, and
+ *     `assertAnalyticalDisclosure` refuses a payload missing either. A score
+ *     handed onward without its caveat gets read back later as a promised
+ *     recovery rate.
+ *
+ *  4. **Attribution beyond a mixer is inference.** `observedPath` is on every
+ *     intervention point for that reason: false means the link to this case
+ *     passes through mixing or privacy infrastructure, and the entry is an
+ *     observation about a counterparty rather than a finding about anyone.
+ *
+ * DRI is offered to organisations — protocols, exchanges, funds, custodians
+ * and their counsel. It is not a consumer service.
+ */
+/**
+ * What kind of thing sits at an address.
+ *
+ * Two of these carry the operational weight. `EXCHANGE` and `CUSTODIAN` mean a
+ * party holds the value and can be approached; `MIXER` means provable
+ * attribution stops. Anything unlabelled stays `UNKNOWN` rather than being
+ * guessed into a category — a wrong guess here names an innocent business.
+ */
+export type FlowNodeType = 'WALLET' | 'ENTITY' | 'EXCHANGE' | 'CUSTODIAN' | 'DEX' | 'BRIDGE' | 'MIXER' | 'CONTRACT' | 'PROTOCOL' | 'UNKNOWN';
+export interface FlowNode {
+    id: string;
+    chain: string;
+    address: string;
+    type: FlowNodeType;
+    /** The attribution recorded for this address, when there is one. */
+    label: string | null;
+    entityName: string | null;
+    riskLevel: string | null;
+    /** Graph distance from the seed. 0 is the address the case started from. */
+    hop: number;
+    isSeed: boolean;
+    /** False means nobody has looked past this address yet. */
+    expanded: boolean;
+    /**
+     * Confidence of the signal that put this address on the graph. Kept with the
+     * node so a four-hop inference is never rendered like a directly-labelled
+     * counterparty.
+     */
+    confidence: number | null;
+    explanation: string | null;
+    discoveredAt: string;
+}
+export interface FlowEdge {
+    id: string;
+    from: string;
+    to: string;
+    type: string;
+    chain: string;
+    txHash: string | null;
+    asset: string | null;
+    amountUsd: number | null;
+    txCount: number;
+    discoveredVia: string | null;
+}
+export interface FlowGraph {
+    investigationId: string;
+    caseRef: string;
+    title: string;
+    status: string;
+    chain: string;
+    seedAddress: string;
+    incidentId: string | null;
+    /**
+     * The recovery case behind this investigation, when the incident it belongs
+     * to has one. `getRecoveryIndex` and `generateEvidencePackage` need it, and
+     * `null` here is how a caller learns there is no tranche ledger to compute
+     * an outlook from — rather than by getting a 404 from those methods.
+     */
+    recoveryCaseId: string | null;
+    maxHops: number;
+    createdAt: string;
+    nodes: FlowNode[];
+    edges: FlowEdge[];
+    /** Caveats that ship with the result and cannot be suppressed. */
+    notes: string[];
+}
+export interface InvestigationSummary {
+    investigationId: string;
+    caseRef: string;
+    title: string;
+    status: string;
+    chain: string;
+    seedAddress: string;
+    incidentId: string | null;
+    maxHops: number;
+    addressCount: number;
+    transferCount: number;
+    createdAt: string;
+}
+export interface TraceCoverage {
+    addressesVisited?: number;
+    hopsCompleted?: number;
+    truncated?: boolean;
+    truncationReason?: string | null;
+}
+export interface TraceResult {
+    /** The address that was expanded. */
+    fromNodeId: string;
+    addressesDiscovered: number;
+    transfersRecorded: number;
+    /** Null when the trace reported nothing about its own completeness. */
+    coverage: TraceCoverage | null;
+    graph: FlowGraph;
+    notes: string[];
+}
+/**
+ * `CUSTODIAL` means a party holds the value now. `CROSS_CHAIN` means a bridge
+ * operator holds records of value that has already moved on. They are separate
+ * because treating the second as the first sends a client's legal budget after
+ * a paper trail rather than a pot of money.
+ */
+export type InterventionKind = 'CUSTODIAL' | 'CROSS_CHAIN';
+export interface InterventionPoint {
+    nodeId: string;
+    chain: string;
+    address: string;
+    nodeType: FlowNodeType;
+    kind: InterventionKind;
+    label: string | null;
+    entityName: string | null;
+    hop: number;
+    /**
+     * True when at least one path from the seed reaches this address without
+     * passing through mixing or privacy infrastructure.
+     *
+     * **False means inference.** The address is connected to this case by a
+     * chain of reasoning rather than by an observed transfer, and presenting it
+     * otherwise turns an observation into an allegation about a business that,
+     * so far as the record shows, has done nothing.
+     */
+    observedPath: boolean;
+    expanded: boolean;
+    /** Why this address is on the list, in the terms it is allowed to be stated. */
+    basis: string;
+}
+export interface AttributionLimit {
+    nodeId: string;
+    chain: string;
+    address: string;
+    nodeType: FlowNodeType;
+    hop: number;
+    reason: string;
+}
+export interface UnexploredAddress {
+    nodeId: string;
+    chain: string;
+    address: string;
+    nodeType: FlowNodeType;
+    hop: number;
+}
+export interface InterventionAnalysis {
+    investigationId: string;
+    caseRef: string;
+    interventionPoints: InterventionPoint[];
+    /** Where provable attribution stops. Mixing and privacy infrastructure. */
+    attributionLimits: AttributionLimit[];
+    /** Frontier addresses nobody has looked past yet. */
+    unexplored: UnexploredAddress[];
+    notes: string[];
+}
+export declare const RECOVERY_BANDS: readonly ["HIGH", "MODERATE", "LOW", "VERY_LOW"];
+export type RecoveryBand = (typeof RECOVERY_BANDS)[number];
+export interface RecoveryFunnel {
+    totalLossUsd: number;
+    byState: Record<string, number>;
+    locatedUsd: number;
+    atInterventionPointUsd: number;
+    freezeRequestedUsd: number;
+    frozenUsd: number;
+    recoveredUsd: number;
+    obfuscatedUsd: number;
+    lostUsd: number;
+    untracedUsd: number;
+    /** Value whose attribution rests on inference rather than a direct link. */
+    probabilisticUsd: number;
+    accountedUsd: number;
+    unaccountedUsd: number;
+    reconciles: boolean;
+}
+export interface RecoveryFactor {
+    factor: string;
+    contribution: number;
+    note: string;
+}
+/**
+ * The Recovery Index — the Recovery Outlook, as the case file names it.
+ *
+ * An analytical estimate of the current evidentiary and custodial position,
+ * produced by a versioned model from the evidence recorded in the case. It is
+ * **not a probability, not a forecast, and not a representation that any value
+ * will be recovered.**
+ *
+ * `disclaimer` and `analyticalOnly` are required fields rather than optional
+ * ones, so a consumer destructuring the score cannot end up with a type that
+ * says the caveat might not be there. `assertAnalyticalDisclosure` enforces
+ * the same thing at runtime, because a wire payload is not bound by a type.
+ */
+export interface RecoveryIndex {
+    recoveryCaseId: string;
+    caseRef: string;
+    incidentRef: string;
+    /** 0-100. Higher means the record currently supports a stronger position. */
+    score: number;
+    band: RecoveryBand;
+    /** What the band means, stated as a situation rather than a likelihood. */
+    bandMeaning: string;
+    /** Every factor and what it contributed, so the number can be explained. */
+    factors: RecoveryFactor[];
+    /** Together these make any figure ever shown to a client reproducible. */
+    modelVersion: string;
+    inputsHash: string;
+    computedAt: string;
+    funnel: RecoveryFunnel;
+    /** Machine-readable form of `disclaimer`. Never false. */
+    analyticalOnly: true;
+    disclaimer: string;
+    notes: string[];
+}
+/**
+ * Thrown when a Recovery Index arrives without its analytical-only disclosure.
+ *
+ * Its own class, because it is not a transport failure and a caller that
+ * blanket-catches network errors must not swallow it.
+ */
+export declare class MissingDisclosureError extends Error {
+    constructor(message: string);
+}
+/**
+ * Refuse a Recovery Index that is not marked analytical-only.
+ *
+ * This runs on the client, on a payload the server has already checked, and
+ * that duplication is the point. The score's whole legal safety rests on the
+ * caveat travelling with it: an integrator's dashboard renders whatever
+ * arrives, and a bare "58 — MODERATE" on a screen beside the word "recovery"
+ * is read as a rate. If the caveat ever stops arriving — a proxy stripping
+ * fields, an older deployment, a hand-rolled response — the correct outcome is
+ * a loud failure at the boundary rather than a number the caller cannot tell
+ * is unlabelled.
+ *
+ * Returns the value, so it can wrap a call site.
+ */
+export declare function assertAnalyticalDisclosure(index: RecoveryIndex): RecoveryIndex;
+/**
+ * Points where a party actually holds the value.
+ *
+ * Offered as a helper because it is the filter every caller reaches for, and
+ * writing it by hand is where a bridge quietly gets treated as a custodian.
+ */
+export declare function custodialPoints(analysis: InterventionAnalysis): InterventionPoint[];
+/**
+ * Intervention points whose connection to the case is inference.
+ *
+ * Separated so a caller has to decide what to do with them rather than
+ * discovering later that a list they forwarded to counsel mixed observed
+ * destinations with inferred ones.
+ */
+export declare function inferredPoints(analysis: InterventionAnalysis): InterventionPoint[];
+export type EvidenceRecipientType = 'EXCHANGE' | 'ISSUER' | 'LAW_ENFORCEMENT' | 'COUNSEL';
+/**
+ * A prepared evidence package.
+ *
+ * **Prepared, not sent.** Decentrys does not contact counterparties on your
+ * behalf unless instructed, and `transmitted` is always false on a package
+ * this SDK created — transmission is recorded separately, with the party who
+ * sent it named, and that is deliberately not something a customer credential
+ * can write.
+ *
+ * The document is frozen and hashed at generation. A later version is issued
+ * as a new document rather than as a revision of this one, so a reader months
+ * afterwards can confirm they hold what was produced.
+ */
+export interface EvidencePackage {
+    packageId: string;
+    recoveryCaseId: string;
+    caseRef: string;
+    version: number;
+    title: string;
+    recipientType: EvidenceRecipientType;
+    recipientName: string;
+    /** The document itself, as plain text. */
+    content: string;
+    /** SHA-256 of `content`. Quote it back to verify what you hold. */
+    contentHash: string;
+    /** The standing non-authority statement carried on the face of the document. */
+    authorityNotice: string;
+    preparedAt: string;
+    transmitted: false;
+    transmittedAt: null;
+    notes: string[];
+}
+export interface TimelineEntry {
+    at: string;
+    type: string;
+    /**
+     * Who performed this. Required, never optional: an entry saying value
+     * "became frozen" with no actor is an implied claim of standing that
+     * Decentrys does not have.
+     */
+    actorParty: string;
+    actorName: string | null;
+    title: string;
+    detail: string | null;
+    amountUsd: number | null;
+    /** The legal basis a third party cited, where one was given. */
+    authority: string | null;
+}
+export interface InvestigationTimeline {
+    investigationId: string;
+    caseRef: string;
+    recoveryCaseId: string | null;
+    entries: TimelineEntry[];
+    notes: string[];
+}
+export interface RecoveryCaseSummary {
+    recoveryCaseId: string;
+    caseRef: string;
+    status: string;
+    totalLossUsd: number;
+    openedAt: string;
+    watchActive: boolean;
+    incident: {
+        incidentId: string;
+        incidentRef: string;
+        title: string;
+        severity: string;
+    };
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

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

package/dist/model.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Digital Recovery Intelligence: the model.
+ *
+ * DRI answers three questions in order — where did the value go, who is at
+ * that destination, and is there anyone with the standing and the ability to
+ * do something about it. This package makes those answers available to the
+ * organisation whose value it was.
+ *
+ * Four constraints shape every type here. They are product and legal
+ * positions, not preferences, and the types are built so that code consuming
+ * them cannot quietly drop any of them:
+ *
+ *  1. **Decentrys never takes custody, and never freezes, seizes or returns
+ *     anything.** Nothing in this package can be called to move value, and
+ *     nothing it returns says value was moved by Decentrys. Every timeline
+ *     entry names the party that acted, which is why `actorParty` is required
+ *     rather than optional.
+ *
+ *  2. **Decentrys is not a law firm, a law-enforcement agency or a licensed
+ *     recovery agent.** Nothing returned here is legal advice, and the
+ *     statement travels in the payload — see `notes` on every response.
+ *
+ *  3. **The Recovery Index is an analytical estimate, never a prediction.**
+ *     `RecoveryIndex` requires both `disclaimer` and `analyticalOnly`, and
+ *     `assertAnalyticalDisclosure` refuses a payload missing either. A score
+ *     handed onward without its caveat gets read back later as a promised
+ *     recovery rate.
+ *
+ *  4. **Attribution beyond a mixer is inference.** `observedPath` is on every
+ *     intervention point for that reason: false means the link to this case
+ *     passes through mixing or privacy infrastructure, and the entry is an
+ *     observation about a counterparty rather than a finding about anyone.
+ *
+ * DRI is offered to organisations — protocols, exchanges, funds, custodians
+ * and their counsel. It is not a consumer service.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingDisclosureError = exports.RECOVERY_BANDS = void 0;
+exports.assertAnalyticalDisclosure = assertAnalyticalDisclosure;
+exports.custodialPoints = custodialPoints;
+exports.inferredPoints = inferredPoints;
+// ---------------------------------------------------------------------------
+// Recovery Index
+// ---------------------------------------------------------------------------
+exports.RECOVERY_BANDS = ['HIGH', 'MODERATE', 'LOW', 'VERY_LOW'];
+/**
+ * Thrown when a Recovery Index arrives without its analytical-only disclosure.
+ *
+ * Its own class, because it is not a transport failure and a caller that
+ * blanket-catches network errors must not swallow it.
+ */
+class MissingDisclosureError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MissingDisclosureError';
+    }
+}
+exports.MissingDisclosureError = MissingDisclosureError;
+/**
+ * Refuse a Recovery Index that is not marked analytical-only.
+ *
+ * This runs on the client, on a payload the server has already checked, and
+ * that duplication is the point. The score's whole legal safety rests on the
+ * caveat travelling with it: an integrator's dashboard renders whatever
+ * arrives, and a bare "58 — MODERATE" on a screen beside the word "recovery"
+ * is read as a rate. If the caveat ever stops arriving — a proxy stripping
+ * fields, an older deployment, a hand-rolled response — the correct outcome is
+ * a loud failure at the boundary rather than a number the caller cannot tell
+ * is unlabelled.
+ *
+ * Returns the value, so it can wrap a call site.
+ */
+function assertAnalyticalDisclosure(index) {
+    if (index.analyticalOnly !== true) {
+        throw new MissingDisclosureError('This Recovery Index is not marked analytical-only. The Recovery Index is an analytical estimate and '
+            + 'never a predicted recovery rate; refusing to hand back a score that does not say so.');
+    }
+    if (typeof index.disclaimer !== 'string' || index.disclaimer.trim().length === 0) {
+        throw new MissingDisclosureError('This Recovery Index arrived without its disclaimer. The disclaimer travels with the score by design, '
+            + 'because a score shown without it is read as a promise of recovery.');
+    }
+    return index;
+}
+/**
+ * Points where a party actually holds the value.
+ *
+ * Offered as a helper because it is the filter every caller reaches for, and
+ * writing it by hand is where a bridge quietly gets treated as a custodian.
+ */
+function custodialPoints(analysis) {
+    return analysis.interventionPoints.filter((point) => point.kind === 'CUSTODIAL');
+}
+/**
+ * Intervention points whose connection to the case is inference.
+ *
+ * Separated so a caller has to decide what to do with them rather than
+ * discovering later that a list they forwarded to counsel mixed observed
+ * destinations with inferred ones.
+ */
+function inferredPoints(analysis) {
+    return analysis.interventionPoints.filter((point) => !point.observedPath);
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;;;AA+QH,gEAcC;AAQD,0CAEC;AASD,wCAEC;AApID,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAEjE,QAAA,cAAc,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAU,CAAC;AAkE/E;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AALD,wDAKC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,0BAA0B,CAAC,KAAoB;IAC7D,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,sBAAsB,CAC9B,sGAAsG;cACpG,sFAAsF,CACzF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,sBAAsB,CAC9B,uGAAuG;cACrG,oEAAoE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,QAA8B;IAC5D,OAAO,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,QAA8B;IAC3D,OAAO,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAC5E,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@decentrys/dri-sdk",
+  "version": "0.1.0",
+  "description": "Digital Recovery Intelligence: fund tracing, attribution, intervention points and evidence packages. Analytical only — Decentrys never takes custody of assets.",
+  "license": "MIT",
+  "author": "Decentrys Labs",
+  "homepage": "https://decentrys.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/teamdecentrys-byte/Decentrys.git",
+    "directory": "sdk/dri"
+  },
+  "bugs": {
+    "url": "https://github.com/teamdecentrys-byte/Decentrys/issues"
+  },
+  "keywords": [
+    "decentrys",
+    "blockchain",
+    "web3",
+    "security",
+    "crypto",
+    "forensics",
+    "fund-tracing",
+    "investigation",
+    "incident-response"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/browser/decentrys-dri.mjs",
+      "default": "./dist/index.js"
+    },
+    "./browser": "./dist/browser/decentrys-dri.mjs"
+  },
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo*",
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "vitest": "^3.2.7"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && npm run build:browser",
+    "build:browser": "../../node_modules/.bin/esbuild src/index.ts --bundle --format=esm --target=es2022 --outfile=dist/browser/decentrys-dri.mjs && ../../node_modules/.bin/esbuild src/index.ts --bundle --format=iife --global-name=DecentrysDri --target=es2022 --outfile=dist/browser/decentrys-dri.js",
+    "typecheck": "tsc -p tsconfig.spec.json",
+    "test": "vitest run"
+  }
+}