@unconfirmed/sui-effect 0.1.0

package/dist/domain/errors.js

@@ -0,0 +1,476 @@
+/**
+ * The closed error taxonomy. Every failure sui-effect can produce is one of the
+ * classes in this file, every one is a `Schema.TaggedError` so it serializes,
+ * and the tags are flat: there is no error inheritance to match on.
+ *
+ * @since 0.1.0
+ */
+import { Result, Schema } from "effect";
+import { Digest, ExecutionReason, NotAppliedEvidence, ObjectId, SignedTransaction, TransactionEffects, Version } from "./schemas.js";
+export { CleverError, ExecutionReason, MoveLocation } from "./schemas.js";
+/**
+ * A request did not reach a usable answer. `retryable` is true for the statuses
+ * a read may be retried on: gRPC `UNAVAILABLE`, `DEADLINE_EXCEEDED`,
+ * `RESOURCE_EXHAUSTED`, `INTERNAL` and `UNKNOWN`, HTTP 5xx and 429, and
+ * timeouts. `INTERNAL` and `UNKNOWN` are in the set because the grpc-web
+ * transport reports a refused connection or a DNS failure as `INTERNAL` and an
+ * HTTP 500 as `UNKNOWN`, so without them a node that is merely down is never
+ * retried.
+ */
+export class TransportError extends Schema.TaggedError()("TransportError", {
+    method: Schema.String,
+    retryable: Schema.Boolean,
+    status: Schema.optional(Schema.String),
+    cause: Schema.Defect()
+}) {
+    /**
+     * Builds a `TransportError` out of whatever a call threw, classifying the
+     * status and the retryability the way `SuiCore` does for the SDK's own
+     * failures.
+     *
+     * This is for an extension that makes its own network calls — an operator
+     * HTTP API, a GraphQL endpoint, a sidecar — and wants its failures to sit on
+     * the same axis as the library's: `retryable` read off a gRPC status name, an
+     * HTTP status number (5xx and 429), or an abort or timeout, and `status`
+     * recorded as the node or the transport spelled it. Hand-building the three
+     * fields per call site is how they drift.
+     *
+     * `retryable` may be forced when the caller knows better than the shape of
+     * the cause — an idempotent read that is always safe to repeat, a write that
+     * never is. Left out, it is inferred, and inferred conservatively: an
+     * unrecognisable cause is **not** retryable.
+     *
+     * Never fails.
+     *
+     * @example
+     * ```ts
+     * import { TransportError } from "@unconfirmed/sui-effect"
+     * import { Effect } from "effect"
+     *
+     * const status = Effect.tryPromise({
+     *   try: (signal) => fetch("https://operator.example/status", { signal }),
+     *   catch: (cause) => TransportError.fromUnknown("operator.status", cause)
+     * })
+     * ```
+     */
+    static fromUnknown = (method, cause, retryable) => {
+        const classified = classifyTransportCause(cause);
+        return new TransportError({
+            method,
+            retryable: retryable ?? classified.retryable,
+            ...(classified.status === undefined ? {} : { status: classified.status }),
+            cause
+        });
+    };
+}
+/**
+ * gRPC status names a read may be retried on, plus HTTP 5xx and 429. Timeouts
+ * map to `DEADLINE_EXCEEDED` with `retryable: true`.
+ *
+ * `INTERNAL` and `UNKNOWN` are transport-level failures, not answers from the
+ * node: `@protobuf-ts/grpcweb-transport` turns a rejected `fetch` (connection
+ * refused, DNS failure) into an `RpcError` with code `INTERNAL`, and its
+ * grpc-web format maps HTTP 500 to `UNKNOWN` (503 to `UNAVAILABLE`, 504 to
+ * `DEADLINE_EXCEEDED`, 429 to `RESOURCE_EXHAUSTED`). Without them a read
+ * against a node that is merely down or restarting is never retried.
+ */
+export const RETRYABLE_GRPC_STATUSES = new Set([
+    "UNAVAILABLE",
+    "DEADLINE_EXCEEDED",
+    "RESOURCE_EXHAUSTED",
+    "INTERNAL",
+    "UNKNOWN"
+]);
+const isRetryableHttpStatus = (status) => status === 429 || status >= 500;
+/**
+ * The `status` and `retryable` of a thrown value: a timeout or an abort, an
+ * HTTP status number, a gRPC status name, or nothing recognisable. Never fails.
+ */
+export const classifyTransportCause = (cause) => {
+    if (typeof cause !== "object" || cause === null)
+        return { retryable: false };
+    const record = cause;
+    const tag = record["_tag"];
+    const name = record["name"];
+    if (tag === "TimeoutError" || name === "TimeoutError" || name === "AbortError") {
+        return { status: "DEADLINE_EXCEEDED", retryable: true };
+    }
+    const httpStatus = record["status"];
+    if (typeof httpStatus === "number") {
+        return { status: String(httpStatus), retryable: isRetryableHttpStatus(httpStatus) };
+    }
+    const code = record["code"];
+    if (typeof code === "string") {
+        return { status: code, retryable: RETRYABLE_GRPC_STATUSES.has(code) };
+    }
+    if (typeof code === "number")
+        return { status: String(code), retryable: false };
+    return { retryable: false };
+};
+/** The object does not exist, or has never existed. */
+export class ObjectNotFound extends Schema.TaggedError()("ObjectNotFound", {
+    objectId: ObjectId,
+    version: Schema.optional(Version)
+}) {
+}
+/** The object existed and has been deleted or wrapped. */
+export class ObjectDeleted extends Schema.TaggedError()("ObjectDeleted", {
+    objectId: ObjectId,
+    version: Schema.optional(Version)
+}) {
+}
+/** The node could not say what happened to the object (`ObjectError.reason: "unknown"`). */
+export class ObjectUnavailable extends Schema.TaggedError()("ObjectUnavailable", { objectId: ObjectId, version: Schema.optional(Version) }) {
+}
+/** No transaction with this digest is known to the node. */
+export class TransactionNotFound extends Schema.TaggedError()("TransactionNotFound", { digest: Digest }) {
+}
+/** The chain identifier the node reported is not the one the layer was built for. */
+export class NetworkMismatch extends Schema.TaggedError()("NetworkMismatch", {
+    expected: Schema.String,
+    actual: Schema.String
+}) {
+}
+/** BCS content or a schema boundary did not decode. */
+export class DecodeError extends Schema.TaggedError()("DecodeError", {
+    objectId: Schema.optional(ObjectId),
+    expectedType: Schema.optional(Schema.String),
+    issue: Schema.String
+}) {
+}
+/** Simulation reported an execution failure. No gas was charged. */
+export class SimulationFailed extends Schema.TaggedError()("SimulationFailed", {
+    reason: ExecutionReason,
+    message: Schema.String
+}) {
+}
+/** The transaction was applied on chain and failed. Gas was charged. */
+export class ExecutionFailed extends Schema.TaggedError()("ExecutionFailed", {
+    digest: Digest,
+    reason: ExecutionReason,
+    command: Schema.optional(Schema.Number),
+    effects: TransactionEffects
+}) {
+}
+/**
+ * Bytes may have reached the network and the outcome is unknown. Carries the
+ * signed transaction so an operator or a later process can reconcile it.
+ */
+export class SubmissionUnknown extends Schema.TaggedError()("SubmissionUnknown", { digest: Digest, signed: Schema.optional(SignedTransaction), cause: Schema.Defect() }) {
+}
+/**
+ * The transaction provably cannot have been applied, and never will be.
+ *
+ * `evidence` is why. `"inputConsumed"` is only ever produced when a
+ * **different** transaction's own effects report that it took a pinned object
+ * at exactly the version these bytes pinned. An owned input that merely moved
+ * on, one whose consumer took a later version, and one whose last mutation the
+ * node will not name are all `SubmissionUnknown`, not this.
+ */
+export class NotApplied extends Schema.TaggedError()("NotApplied", {
+    digest: Digest,
+    evidence: NotAppliedEvidence
+}) {
+}
+/** A signer refused or failed to produce a signature. */
+export class SigningError extends Schema.TaggedError()("SigningError", {
+    cause: Schema.Defect()
+}) {
+}
+/** The transaction could not be built into bytes. */
+export class BuildError extends Schema.TaggedError()("BuildError", {
+    message: Schema.String,
+    cause: Schema.Defect()
+}) {
+}
+/** A preflight policy refused the transaction before it was signed. */
+export class PolicyDenied extends Schema.TaggedError()("PolicyDenied", {
+    rule: Schema.String,
+    message: Schema.String
+}) {
+}
+/** The submission journal could not be read or written. */
+export class JournalError extends Schema.TaggedError()("JournalError", {
+    cause: Schema.Defect()
+}) {
+}
+/**
+ * The effects of an applied transaction did not contain what the caller
+ * expected.
+ *
+ * Outcome `applied`, and exit 5: this error can only come from an `Executed`,
+ * which means the transaction reached the chain and gas was charged. What is
+ * missing is a receipt, not the transaction. Classifying it `not_applied`
+ * would tell the documented retry idiom to send the caller's intent a second
+ * time for a transaction that already ran.
+ */
+export class UnexpectedEffects extends Schema.TaggedError()("UnexpectedEffects", { digest: Digest, expected: Schema.String, found: Schema.Array(ObjectId) }) {
+}
+/**
+ * The GraphQL endpoint an extension needs is not usable: none was configured,
+ * or the one that was could not be reached.
+ *
+ * sui-effect does not wrap the GraphQL API — it owns the {@link SuiGraphQL}
+ * *tag*, so two extensions that both read GraphQL share one client rather than
+ * opening two. This is the failure the tag's `layerUnavailable` produces, which
+ * is what an application provides when it has no endpoint: every call rejects
+ * with this instead of the extension discovering a missing dependency at
+ * construction. An extension maps it into its own union, or lets it through.
+ *
+ * Outcome `not_applied`: a read that did not happen changed nothing.
+ */
+export class GraphQLUnavailable extends Schema.TaggedError()("GraphQLUnavailable", { method: Schema.String, reason: Schema.String }) {
+}
+/**
+ * A synchronous member of a Promise-faced extension was called before its
+ * runtime existed.
+ *
+ * `SuiExtension.fromService` builds its `ManagedRuntime` on first use, so until
+ * something has been awaited there is no service object and no synchronous
+ * member to read. Rather than hand back a Promise where the type says a value,
+ * the face throws this. Two cures, both in the extension's own hands:
+ * `await client.<name>.$ready()` once after registering, or register with
+ * `warm`, which builds the runtime inside `register` and makes every member
+ * real immediately.
+ *
+ * Outcome `not_applied`: nothing was sent.
+ */
+export class ExtensionNotReady extends Schema.TaggedError()("ExtensionNotReady", { extension: Schema.String, member: Schema.String }) {
+}
+/** The schema of the whole taxonomy, used for serialization. */
+export const SuiErrorSchema = Schema.Union([
+    TransportError,
+    ObjectNotFound,
+    ObjectDeleted,
+    ObjectUnavailable,
+    TransactionNotFound,
+    NetworkMismatch,
+    DecodeError,
+    SimulationFailed,
+    ExecutionFailed,
+    SubmissionUnknown,
+    NotApplied,
+    SigningError,
+    BuildError,
+    PolicyDenied,
+    JournalError,
+    UnexpectedEffects,
+    GraphQLUnavailable,
+    ExtensionNotReady
+]);
+const OutcomeSchema = Schema.Literals(["applied", "not_applied", "unknown"]);
+const isHasOutcome = Schema.is(Schema.Struct({ outcome: OutcomeSchema }));
+const hasOutcome = (error) => isHasOutcome(error);
+const isRetryable = (error) => error._tag === "TransportError" ? error.retryable : false;
+/** Every tag the taxonomy owns, so a foreign tag can be told from one of ours. */
+const TAXONOMY_TAGS = new Set([
+    "TransportError",
+    "ObjectNotFound",
+    "ObjectDeleted",
+    "ObjectUnavailable",
+    "TransactionNotFound",
+    "NetworkMismatch",
+    "DecodeError",
+    "SimulationFailed",
+    "ExecutionFailed",
+    "SubmissionUnknown",
+    "NotApplied",
+    "SigningError",
+    "BuildError",
+    "PolicyDenied",
+    "JournalError",
+    "UnexpectedEffects",
+    "GraphQLUnavailable",
+    "ExtensionNotReady"
+]);
+/**
+ * What a failure says about the transaction it came from.
+ *
+ * An error that declares its own `outcome` is honoured first, which is how an
+ * extension puts its failures on the same axis. Otherwise a tag the taxonomy
+ * owns gets the taxonomy's answer, and **anything else is `"unknown"`**: a tag
+ * this library has never heard of says nothing about whether a transaction
+ * applied, and answering `"not_applied"` for it would tell a retry idiom to
+ * send again on no evidence at all. `Script.exitCode` agrees by exiting 1 for
+ * an unclassified error rather than 3.
+ */
+const outcome = (error) => {
+    if (hasOutcome(error))
+        return error.outcome;
+    const tag = error._tag;
+    if (typeof tag !== "string" || !TAXONOMY_TAGS.has(tag))
+        return "unknown";
+    switch (tag) {
+        case "ExecutionFailed":
+        // An `UnexpectedEffects` is built from an `Executed`: the transaction
+        // applied and gas was charged, and only the receipt is missing.
+        case "UnexpectedEffects":
+            return "applied";
+        case "SubmissionUnknown":
+            return "unknown";
+        default:
+            return "not_applied";
+    }
+};
+const formatTarget = (reason) => {
+    if (reason.$kind !== "MoveAbort")
+        return "";
+    const location = reason.MoveAbort.location;
+    if (location === undefined)
+        return "";
+    const parts = [location.package, location.module, location.functionName].filter((part) => part !== undefined);
+    return parts.length === 0 ? "" : ` ${parts.join("::")}`;
+};
+const describeReason = (reason) => ExecutionReason.match(reason, {
+    MoveAbort: (value) => {
+        const clever = value.MoveAbort.cleverError?.constantName;
+        const suffix = clever === undefined ? "" : ` (${clever})`;
+        return `MoveAbort${formatTarget(value)} code ${value.MoveAbort.abortCode}${suffix}`;
+    },
+    SizeError: (value) => `SizeError ${value.SizeError.name} ${value.SizeError.size} of ${value.SizeError.maxSize}`,
+    CommandArgumentError: (value) => `CommandArgumentError ${value.CommandArgumentError.name} at argument ${value.CommandArgumentError.argument}`,
+    TypeArgumentError: (value) => `TypeArgumentError ${value.TypeArgumentError.name} at type argument ${value.TypeArgumentError.typeArgument}`,
+    PackageUpgradeError: (value) => `PackageUpgradeError ${value.PackageUpgradeError.name}`,
+    IndexError: (value) => `IndexError index ${value.IndexError.index ?? "?"}`,
+    CoinDenyListError: (value) => `CoinDenyListError ${value.CoinDenyListError.name} for ${value.CoinDenyListError.coinType}`,
+    CongestedObjects: (value) => `CongestedObjects ${value.CongestedObjects.objects.join(", ")}`,
+    ObjectIdError: (value) => `ObjectIdError ${value.ObjectIdError.name ?? ""} ${value.ObjectIdError.objectId}`.trim(),
+    Unknown: () => "Unknown"
+});
+/**
+ * The one line of a `cause` worth printing next to a tag: an `Error`'s message,
+ * a tagged error's own `describe` line, a string as itself. `undefined` when
+ * there is nothing readable, so `describe` prints nothing rather than
+ * `[object Object]`.
+ */
+const causeLine = (cause) => {
+    if (cause === undefined || cause === null)
+        return undefined;
+    if (typeof cause === "string")
+        return cause.length === 0 ? undefined : cause;
+    if (typeof cause !== "object")
+        return undefined;
+    const message = cause.message;
+    if (typeof message === "string" && message.length > 0)
+        return message;
+    const tag = cause._tag;
+    if (typeof tag === "string")
+        return tag;
+    if (cause instanceof Error && cause.name.length > 0)
+        return cause.name;
+    return undefined;
+};
+const describe = (error) => {
+    switch (error._tag) {
+        case "TransportError": {
+            const cause = causeLine(error.cause);
+            return `TransportError ${error.method}${error.status === undefined ? "" : ` ${error.status}`}${error.retryable ? " (retryable)" : ""}${cause === undefined ? "" : `: ${cause}`}`;
+        }
+        case "ObjectNotFound":
+        case "ObjectDeleted":
+        case "ObjectUnavailable":
+            return `${error._tag} ${error.objectId}`;
+        case "TransactionNotFound":
+            return `TransactionNotFound ${error.digest}`;
+        case "NetworkMismatch":
+            return `NetworkMismatch expected ${error.expected} but the node reported ${error.actual}`;
+        case "DecodeError":
+            return `DecodeError ${error.expectedType ?? ""} ${error.objectId ?? ""} ${error.issue}`
+                .replace(/\s+/g, " ")
+                .trim();
+        case "SimulationFailed":
+            return `SimulationFailed ${describeReason(error.reason)}`;
+        case "ExecutionFailed":
+            return `ExecutionFailed ${describeReason(error.reason)}${error.command === undefined ? "" : ` in command ${error.command}`}`;
+        case "SubmissionUnknown": {
+            const cause = causeLine(error.cause);
+            return `SubmissionUnknown ${error.digest}${cause === undefined ? "" : `: ${cause}`}`;
+        }
+        case "NotApplied":
+            return `NotApplied ${error.digest} (${error.evidence})`;
+        case "SigningError":
+            return "SigningError";
+        case "BuildError":
+            return `BuildError ${error.message}`;
+        case "PolicyDenied":
+            return `PolicyDenied ${error.rule}: ${error.message}`;
+        case "JournalError":
+            return "JournalError";
+        case "UnexpectedEffects":
+            return `UnexpectedEffects ${error.digest} expected ${error.expected} but found ${error.found.length}`;
+        case "GraphQLUnavailable":
+            return `GraphQLUnavailable ${error.method}: ${error.reason}`;
+        case "ExtensionNotReady":
+            return `ExtensionNotReady ${error.extension}.${error.member} was called before the runtime existed: await client.${error.extension}.$ready() first, or register with warm`;
+    }
+};
+const encode = Schema.encodeUnknownResult(SuiErrorSchema);
+/**
+ * One error encoded through **its own** schema.
+ *
+ * Every `Schema.TaggedError` class is itself a schema, and an instance's
+ * `constructor` is that class, so an error the closed taxonomy has never heard
+ * of — an extension's `EscrowSettlementUnknown { escrowId, outcome }` — still
+ * serializes with its fields instead of collapsing to a tag and a sentence.
+ * `undefined` when the value is not a schema-backed error, or when its own
+ * schema refuses it. Never fails.
+ */
+const encodeThroughOwnSchema = (error) => {
+    const schema = error?.constructor;
+    if (!Schema.isSchema(schema))
+        return undefined;
+    const encoded = Schema.encodeUnknownResult(schema)(error);
+    if (!Result.isSuccess(encoded))
+        return undefined;
+    const value = encoded.success;
+    return typeof value === "object" && value !== null
+        ? value
+        : undefined;
+};
+/**
+ * The JSON an operator or a log line gets for a failure.
+ *
+ * A tag in the taxonomy encodes through {@link SuiErrorSchema}. **Anything
+ * else that is a `Schema.TaggedError` encodes through its own schema**, which
+ * is how an extension's errors serialize with their fields — including the
+ * `outcome` a wrapper script reads — rather than arriving as a bare
+ * `{ _tag, message }`. Only a value that is neither falls back to that.
+ *
+ * Never fails.
+ */
+const toJson = (error) => {
+    const encoded = encode(error);
+    if (Result.isSuccess(encoded))
+        return encoded.success;
+    const own = encodeThroughOwnSchema(error);
+    if (own !== undefined)
+        return own;
+    const message = TAXONOMY_TAGS.has(error._tag)
+        ? describe(error)
+        : causeLine(error) ?? error._tag;
+    return { _tag: error._tag, message };
+};
+/**
+ * The four helpers every repo hand-rolls: is this worth retrying, did the
+ * transaction land, what does an operator need to read, and what goes in a log.
+ */
+export const SuiError = {
+    isRetryable,
+    outcome,
+    describe,
+    toJson
+};
+/** The digest of the transaction a failure refers to, when it has one. */
+export const digestOf = (error) => {
+    switch (error._tag) {
+        case "TransactionNotFound":
+        case "ExecutionFailed":
+        case "SubmissionUnknown":
+        case "NotApplied":
+        case "UnexpectedEffects":
+            return error.digest;
+        default:
+            return undefined;
+    }
+};
+//# sourceMappingURL=errors.js.map

package/dist/domain/errors.js.map

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