cascrow-sdk 0.2.0 → 0.7.0

package/dist/v3.js

@@ -0,0 +1,105 @@
+/**
+ * MilestoneEscrowV3, remote half: what cascrow prepares and reads for a party.
+ *
+ * Nothing in this SDK signs, holds a key or talks to a chain — cascrow never
+ * signs, sends or relays a transaction for a party (rule I9), and the SDK's main
+ * entry stays free of any keystore or file access. Signing happens in the
+ * separate `cascrow-signer` package (pinned below), which checks every prepared
+ * transaction against its own pinned chain and contract before it signs.
+ */
+// What every cascrow client says about MilestoneEscrowV3 — a JSON copy of
+// V3_CLIENT_TEXT in src/lib/v3-client-text.ts (this package cannot import the
+// app). v3-client-text-parity.test.ts holds the copy equal to the owner.
+// BEGIN v3-client-text
+export const V3_CLIENT_TEXT = {
+    "signerPin": "cascrow-signer@0.1.0",
+    "remoteTools": [
+        "cascrow_v3_offer",
+        "cascrow_v3_acceptance_get",
+        "cascrow_v3_acceptance_submit",
+        "cascrow_v3_prepare",
+        "cascrow_v3_report_tx",
+        "cascrow_v3_attestation",
+        "cascrow_v3_claims"
+    ],
+    "codeHints": {
+        "V3_DISABLED": "MilestoneEscrowV3 is switched off for NEW money right now (offers, acceptances, funding). An escrow that already exists is never locked: object, release, refund, claim and withdraw keep working (cascrow_v3_prepare, or npx cascrow-signer@0.1.0 without cascrow at all).",
+        "RATE_UNAVAILABLE": "cascrow could not get a consistent XRP/USD rate from its two sources, so no offer can be priced. Nothing was created; retry in a minute.",
+        "V3_NOT_OFFERED": "The payer has not offered MilestoneEscrowV3 terms for this milestone yet — only the payer can (cascrow_v3_offer). The payer has been notified.",
+        "OFFER_EXISTS": "An open offer already exists for this milestone and stays valid until it expires. Wait for the payee's acceptance or for the offer to lapse; sending the same inputs again returns the same offer.",
+        "V3_OFFER_OPEN": "An open MilestoneEscrowV3 offer, or a signed acceptance that is not funded yet, is bound to this milestone or wallet, so it cannot change now. Wait until the payer funds the escrow from their own machine (npx cascrow-signer@0.1.0 fund --milestone <milestoneId>) or the offer or acceptance lapses.",
+        "ATTESTATION_PENDING": "The AI panel has not finished on this claim. Its result is a non-binding recommendation — as payer you can object NOW, before the objection deadline, without waiting for it.",
+        "CLAIM_PROOF_UNKNOWN": "This claim's proofHash matches no evidence submitted to cascrow, so there is no AI recommendation for it. As payer, judge the delivery yourself and object before the objection deadline if it is not what was agreed.",
+        "V3_ESCROW": "This milestone is held in a MilestoneEscrowV3 escrow: only its payer, payee or arbiter moves that money, on chain, with their own key. Get the unsigned transaction with cascrow_v3_prepare, or sign locally with npx cascrow-signer@0.1.0.",
+        "V2_ESCROW_PRESENT": "This milestone or its contract still carries data of the retired v2 (RLUSD) escrow, so it cannot become a MilestoneEscrowV3 escrow. Nothing was changed; contact support.",
+        "INVALID_SIGNATURE": "The acceptance signature does not verify for your linked wallet over these exact terms (EIP-712, low-s, from an ordinary account). Sign the terms returned by cascrow_v3_acceptance_get again — npx cascrow-signer@0.1.0 accept does it and checks them first.",
+        "V3_INDEX_STALE": "cascrow's index of the chain is behind. Read the escrow from the chain directly (npx cascrow-signer@0.1.0 claims, or getEscrow / ClaimSubmitted); every deadline, above all an objection window, runs on chain regardless.",
+        "ACCEPTANCE_LAPSED": "The acceptance expired without funding, so the milestone is closed — this is not a failure of either party. A new attempt is a new milestone.",
+        "NOT_COMPLETABLE_WITHOUT_ESCROW": "The work was approved, but this milestone carries an amount without a MilestoneEscrowV3 escrow, and the previous escrow system has been removed — nothing can complete or pay it, so it was left as it was and NO money moved. cascrow has opened a case for it; contact support@cascrow.com with the contract ID. Do not resubmit: your evidence is recorded.",
+        "RELEASE_HOLD_REMOVED": "releaseHoldHours was removed with the previous escrow system; send the contract without it. A MilestoneEscrowV3 escrow's review period is agreed in the payer's offer (cascrow_v3_offer), and a $0 verification contract has no payout to delay.",
+        "AMOUNT_VIA_MILESTONES": "This draft has milestones, and their amounts are the contract's amount — it cannot be set on the contract. Nothing was changed. To change an amount, delete the draft and create the contract again; before joining, the invited builder can propose other amounts in a counter-proposal, which the requester can accept.",
+        "DEADLINE_VIA_MILESTONES": "This draft has milestones, and their deadlines are the ones enforced — a contract-level deadline changes nothing, so it is refused. Nothing was changed. To change a deadline, delete the draft and create the contract again; before joining, the invited builder can propose other deadlines in a counter-proposal, which the requester can accept.",
+        "MIXED_AMOUNTS": "A contract is either verification-only (every milestone $0) or escrowed (every milestone above $0), never both. Nothing was created or changed. Set every milestone to $0, or give every milestone an amount and fund each one through a MilestoneEscrowV3 offer (cascrow_v3_offer) once the builder has joined."
+    },
+    "joined": {
+        "active": "Joined as Builder. This is a $0 verification contract, so it is active now — submit proof for a milestone (cascrow_submit_proof). No money is held or moved.",
+        "awaitingOffer": "Joined as Builder. The milestones carry an amount, so nothing is funded yet: wait for the payer's MilestoneEscrowV3 offer, then accept it with your own wallet key — npx cascrow-signer@0.1.0 accept --milestone <milestoneId>, or on the contract page. cascrow never signs for you. Submit proof once the payer has funded the milestone.",
+        "unknown": "Joined as Builder. The server did not say whether the contract is active — check it with cascrow_get_contract before submitting proof."
+    },
+    "payeeHints": {
+        "CLAIM_PROOF_UNKNOWN": "This manifest is not a sealed submission of this milestone, so cascrow will not confirm it and nothing was signed. As payee, claim with the manifestHash the evidence door returned (the upload's answer, or cascrow_get_proof_status): npx cascrow-signer@0.1.0 submit-claim --milestone <milestoneId> --proof-hash <manifestHash>."
+    },
+    "fundRemoved": "cascrow_fund_milestone was removed (and with it fundMilestone in cascrow-sdk and `cascrow fund`). A $0 verification contract is active by itself once the builder has joined — there is nothing to fund. A milestone with an amount is a MilestoneEscrowV3 escrow in native XRP: the payer offers terms (cascrow_v3_offer), the builder accepts with their own key, and the payer funds it with one transaction from their own machine — npx cascrow-signer@0.1.0 fund --milestone <milestoneId>. cascrow never signs or sends for you.",
+    "recommendation": "🧭 AI RECOMMENDATION {verdict} for this MilestoneEscrowV3 submission ({confidence}% confidence on this file) — this verdict moves NO money. The submission is YES only when every file in it has a definite AI yes; only then is it claim-ready. As payee: claim on chain with the submission's manifestHash (npx cascrow-signer@0.1.0 submit-claim --milestone <milestoneId> --proof-hash <manifestHash>). As payer: release, or object before the objection deadline.",
+    "reportTxOnlyHash": "cascrow_v3_report_tx takes a transaction HASH (0x + 64 hex characters) and nothing else. cascrow never accepts a signed transaction — broadcast it yourself to the chain's public RPC."
+};
+// END v3-client-text
+/** The version of the local signer this SDK's docs and hints point to. */
+export const CASCROW_SIGNER_PIN = V3_CLIENT_TEXT.signerPin;
+/**
+ * What a V3 refusal code means for the caller, or null for a code that is not a V3
+ * one. Role-aware (post-review H9): `CLAIM_PROOF_UNKNOWN` without `objectionDeadline`
+ * in the body comes from `prepare?action=submitClaim` and reaches the PAYEE; with it,
+ * the claim is live and the remedy is the payer's objection.
+ */
+export function v3HintFor(code, body) {
+    if (!code)
+        return null;
+    const b = body && typeof body === "object" ? body : null;
+    const liveClaim = !!b && typeof b.objectionDeadline === "string";
+    const payee = V3_CLIENT_TEXT.payeeHints[code];
+    if (payee && b && !liveClaim)
+        return payee;
+    return V3_CLIENT_TEXT.codeHints[code] ?? null;
+}
+/**
+ * The sentence for a `joinContract` answer: `activated: true` — a $0 contract, active
+ * now; `false` — a money contract waiting for the payer's MilestoneEscrowV3 offer, which
+ * the builder accepts with their own key; anything else — the server did not say.
+ */
+export function joinedLine(body) {
+    const activated = body && typeof body === "object" ? body.activated : undefined;
+    if (activated === true)
+        return V3_CLIENT_TEXT.joined.active;
+    if (activated === false)
+        return V3_CLIENT_TEXT.joined.awaitingOffer;
+    return V3_CLIENT_TEXT.joined.unknown;
+}
+/** The fields of a V3 refusal body its recipient acts on, as one line, or "" (post-review G5). */
+export function v3RefusalDetail(body) {
+    if (!body || typeof body !== "object")
+        return "";
+    const b = body;
+    const out = [];
+    if (typeof b.remedy === "string" && b.remedy)
+        out.push(b.remedy);
+    if (Array.isArray(b.allowed))
+        out.push(`Allowed now: ${b.allowed.length ? b.allowed.map(String).join(", ") : "nothing"}.`);
+    if (typeof b.objectionDeadline === "string" && b.objectionDeadline)
+        out.push(`Objection deadline: ${b.objectionDeadline}.`);
+    if (typeof b.offerExpiresAt === "string" && b.offerExpiresAt)
+        out.push(`Open offer expires: ${b.offerExpiresAt}.`);
+    return out.join(" ");
+}
+export const TX_HASH_RE = /^0x[0-9a-fA-F]{64}$/;
+//# sourceMappingURL=v3.js.map

package/dist/v3.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cascrow-sdk",
-  "version": "0.2.0",
-  "description": "TypeScript client for the Cascrow API — AI-verified milestone escrow on the XRP Ledger",
+  "version": "0.7.0",
+  "description": "TypeScript client for the Cascrow API — trust infrastructure for the agent economy: AI verification, on-chain reputation, and non-custodial milestone escrow (MilestoneEscrowV3, native XRP)",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,7 +13,8 @@
   },
   "files": [
     "dist",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "sideEffects": false,
   "engines": {
@@ -38,7 +39,10 @@
     "milestone",
     "agent",
     "agentic",
-    "sdk"
+    "sdk",
+    "reputation",
+    "trust",
+    "agent-economy"
   ],
   "author": "Cascrow <dev@cascrow.com>",
   "license": "MIT",