@edge-protocol/sdk 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -0,0 +1,110 @@
+# Changelog
+
+All notable changes to `@edge-protocol/sdk` are documented here.
+
+---
+
+## [0.8.0] — 2026-06-20
+
+### Added
+
+- **`sdk.simulate(pass, requests[])`** — predict outcomes for a sequence of transactions without executing. Zero network calls. Returns `SimulationResult` with approved, blocked, and escalated decisions plus projected budget state after each step. Use to show agents their plan before touching the chain.
+
+- **`sdk.budgetStatus(pass)`** — returns a complete `BudgetStatus` snapshot: spent, remaining, utilization percentage, `isNearLimit`, `isExhausted`.
+
+- **`sdk.utilizationPct(pass)`** — budget utilization as 0-100 number. Use for progress bars and budget warnings.
+
+- **`sdk.isNearLimit(pass, threshold?)`** — returns true if utilization exceeds threshold (default 80%). Use to warn agents before they exhaust budget.
+
+- **`sdk.timeRemaining(pass)`** — milliseconds until pass expires. Returns 0 if expired.
+
+- **`sdk.isExpiringSoon(pass, withinMs?)`** — returns true if pass expires within the given window (default 1 hour).
+
+- **`EdgePass.withPolicy(pass, signer, sdk, fn)`** — higher-order function that wraps any async tool call with EdgePass policy enforcement. The wrapped function only executes if the transaction is approved. Perfect for Vercel AI SDK / Mastra tool definitions.
+
+- **New types exported:** `SimulatedDecision`, `SimulationResult`, `BudgetStatus`
+
+### Changed
+
+- `PolicyEngine.simulate()` is now a static method on `PolicyEngine` and also exposed as `sdk.simulate()` on the `EdgePass` class for convenience.
+- All budget and time helpers are now available both as static `PolicyEngine` methods and instance `sdk` methods.
+
+---
+
+## [0.7.1] — 2026-06-19
+
+### Fixed
+
+- Reverted `tx.objectRef()` optimization from v0.7.0. While theoretically faster, storing object version at fetch time caused version conflicts when Enoki gas sponsorship updated the object between fetch and execution. `tx.object(pass.id)` resolves version at signing time which is the correct and safe pattern.
+
+---
+
+## [0.7.0] — 2026-06-19 — YANKED
+
+Version yanked due to object version conflict regression. Use 0.7.1 instead.
+
+---
+
+## [0.6.6] — 2026-06-18
+
+### Changed
+
+- Updated README with mainnet contract address and live transaction digests
+- Stronger competitive positioning and security model documentation
+
+---
+
+## [0.6.0] — 2026-06-17
+
+### Added
+
+- **Error status as a distinct fourth outcome** — infrastructure failures (`status: 'error'`) are now clearly distinguished from policy rejections (`status: 'blocked'`). A network failure no longer pretends to be a policy decision.
+- **`classifyError()`** — internal error classifier that maps RPC/network/signing errors to typed `EdgeErrorCode` values for programmatic handling.
+- **`fetchPass()` validation** — validates objectId format before hitting the RPC. Throws with a clear message for malformed IDs rather than a cryptic RPC error.
+- **Config validation on `create()`** — prevents impossible EdgePass configurations (e.g. autoThreshold >= escalateThreshold) at creation time rather than at execution time.
+
+---
+
+## [0.5.0] — 2026-06-16
+
+### Added
+
+- **Events system** — `sdk.on('approved')`, `sdk.on('escalated')`, `sdk.on('blocked')`. React to transaction outcomes without polling. Chain-able.
+- `sdk.off()` and `sdk.removeAllListeners()` for cleanup.
+- 34 comprehensive tests — PolicyEngine, fromTemplate, constants, events system.
+
+### Changed
+
+- Events fire for policy outcomes only (`approved`, `escalated`, `blocked`). Infrastructure errors (`status: 'error'`) do not fire events — check `outcome.status === 'error'` explicitly.
+
+---
+
+## [0.4.7] — 2026-06-15
+
+### Added
+
+- Comprehensive `DOCS.md` — full API reference, examples, types, architecture.
+- `maxPerTransaction` field on `EdgePassConfig` — optional per-transaction cap independent of escalation threshold.
+
+---
+
+## [0.4.6] — 2026-06-14
+
+### Added
+
+- 27 comprehensive tests — PolicyEngine validation, `fromTemplate()`, constants.
+- `EDGE_TEMPLATES` constants for festival, gaming, subscription, defi, enterprise.
+- `EdgePass.fromTemplate()` static helper.
+
+---
+
+## [0.4.0] — 2026-06-13
+
+### Added
+
+- Initial public release.
+- `EdgePass` class with `create()`, `execute()`, `validate()`, `fetch()`, `revoke()`.
+- `PolicyEngine` with 7-rule validation chain.
+- `ExecutionEngine` with on-chain PTB construction.
+- Mainnet + testnet support.
+- zkLogin compatible signer interface.

package/dist/core/EdgePass.d.ts

@@ -1,5 +1,5 @@
 import { Transaction } from "@mysten/sui/transactions";
-import { EdgePassConfig, EdgePassObject, TransactionRequest, TransactionOutcome, EdgeSDKConfig } from "../utils/types";
+import { EdgePassConfig, EdgePassObject, TransactionRequest, TransactionOutcome, EdgeSDKConfig, SimulationResult, BudgetStatus } from "../utils/types";
 import { EdgePassTemplate } from "../utils/constants";
 export type EdgePassEventType = 'approved' | 'escalated' | 'blocked';
 export type EdgePassEventPayload = {
@@ -35,14 +35,13 @@ export declare class EdgePass {
     constructor(config: EdgeSDKConfig);
     /**
      * Subscribe to transaction outcomes.
-     * Note: 'error' status (network/signing failures) does NOT fire events.
-     * Check outcome.status === 'error' in your execute() handler instead.
      *
      * @example
      * sdk.on('approved', ({ outcome, pass }) => {
+     *   updateBudgetUI(pass);
      *   console.log('executed:', outcome.digest);
      * });
-     * sdk.on('escalated', ({ outcome, request }) => {
+     * sdk.on('escalated', ({ request }) => {
      *   notifyUser(`Approve $${request.amount} at ${request.merchant}?`);
      * });
      * sdk.on('blocked', ({ outcome }) => {
@@ -50,13 +49,7 @@ export declare class EdgePass {
      * });
      */
     on<T extends EdgePassEventType>(event: T, listener: EventListener<T>): this;
-    /**
-     * Unsubscribe a specific listener.
-     */
     off<T extends EdgePassEventType>(event: T, listener: EventListener<T>): this;
-    /**
-     * Remove all listeners for an event (or all events if none specified).
-     */
     removeAllListeners(event?: EdgePassEventType): this;
     private emit;
     /**
@@ -71,6 +64,30 @@ export declare class EdgePass {
     static fromTemplate(template: EdgePassTemplate, overrides: Partial<EdgePassConfig> & {
         owner: string;
     }): EdgePassConfig;
+    /**
+     * Higher-order function — wraps any async function with EdgePass policy enforcement.
+     * The wrapped function only executes if the transaction is approved.
+     * Returns blocked/escalated outcomes without calling the wrapped function.
+     *
+     * Perfect for wrapping AI tool calls.
+     *
+     * @example
+     * const safePurchase = EdgePass.withPolicy(pass, signer, sdk, async (request) => {
+     *   return await purchaseItem(request.merchant, request.amount);
+     * });
+     *
+     * // Now safePurchase enforces EdgePass policy automatically
+     * const result = await safePurchase({ merchant: 'Hydra Bar', amount: 32n * MIST_PER_SUI });
+     * // result.outcome === 'approved' | 'blocked' | 'escalated'
+     */
+    static withPolicy<T>(pass: EdgePassObject, signer: {
+        signAndExecute: (tx: Transaction) => Promise<{
+            digest: string;
+        }>;
+    }, sdk: EdgePass, fn: (request: TransactionRequest) => Promise<T>): (request: TransactionRequest) => Promise<{
+        outcome: TransactionOutcome;
+        result?: T;
+    }>;
     /**
      * Mint a new EdgePass on Sui.
      */
@@ -88,14 +105,6 @@ export declare class EdgePass {
      * - 'escalated' — exceeds threshold, needs human approval
      * - 'blocked'   — policy rejected the transaction
      * - 'error'     — network/signing failure, transaction NOT submitted
-     *
-     * Events fire for approved/escalated/blocked only.
-     * Check outcome.status === 'error' separately for infrastructure failures.
-     *
-     * @example
-     * sdk.on('approved', ({ outcome }) => console.log('tx:', outcome.digest));
-     * const outcome = await sdk.execute(pass, { merchant, amount }, signer);
-     * if (outcome.status === 'error') handleInfrastructureFailure(outcome.reason);
      */
     execute(pass: EdgePassObject, request: TransactionRequest, signer: {
         signAndExecute: (tx: Transaction) => Promise<{
@@ -103,13 +112,72 @@ export declare class EdgePass {
         }>;
     }): Promise<TransactionOutcome>;
     /**
-     * Preview outcome without executing. Zero network calls.
+     * Simulate a sequence of transactions against an EdgePass.
+     * Zero network calls. Sub-millisecond. Returns predicted outcomes for
+     * all decisions including projected budget state after each step.
+     *
+     * Use this to show an agent its plan before executing, or to build
+     * approval UIs that show what will happen before touching the chain.
+     *
+     * @example
+     * const plan = sdk.simulate(pass, [
+     *   { merchant: 'Hydra Bar',      amount: 32n * MIST_PER_SUI },
+     *   { merchant: 'ShadyTokens.xyz', amount: 1n },
+     *   { merchant: 'Stage Access VIP', amount: 220n * MIST_PER_SUI },
+     * ]);
+     *
+     * console.log(plan.summary);
+     * // { approvedCount: 1, blockedCount: 1, escalatedCount: 1, totalDecisions: 3 }
+     *
+     * // Show plan, then execute approved decisions
+     * for (const decision of plan.approved) {
+     *   await sdk.execute(pass, decision.request, signer);
+     * }
+     */
+    simulate(pass: EdgePassObject, requests: TransactionRequest[]): SimulationResult;
+    /**
+     * Preview a single transaction outcome without executing.
+     * Zero network calls. Sub-millisecond.
      */
     validate(pass: EdgePassObject, request: TransactionRequest): import("../utils/types").PolicyValidation;
+    /**
+     * Returns a complete budget status snapshot.
+     *
+     * @example
+     * const status = sdk.budgetStatus(pass);
+     * if (status.isExhausted) stopAgent();
+     * if (status.isNearLimit) warnUser(`${status.utilizationPct.toFixed(1)}% of budget used`);
+     */
+    budgetStatus(pass: EdgePassObject, nearLimitThreshold?: number): BudgetStatus;
+    /**
+     * Returns budget utilization as a percentage (0-100).
+     */
+    utilizationPct(pass: EdgePassObject): number;
+    /**
+     * Returns true if budget utilization exceeds the given threshold.
+     * Default threshold is 80%.
+     */
+    isNearLimit(pass: EdgePassObject, threshold?: number): boolean;
+    /**
+     * Returns the remaining budget in MIST.
+     */
+    remainingBudget(pass: EdgePassObject): bigint;
+    /**
+     * Returns time remaining on the pass in milliseconds. 0 if expired.
+     */
+    timeRemaining(pass: EdgePassObject): number;
+    /**
+     * Returns true if the pass will expire within the given window.
+     * Default window is 1 hour.
+     */
+    isExpiringSoon(pass: EdgePassObject, withinMs?: number): boolean;
+    /**
+     * Returns true if the pass is active and not expired.
+     */
+    isValid(pass: EdgePassObject): boolean;
     /**
      * Fetch a live EdgePass from Sui.
      * Returns null if not found.
-     * Throws if objectId is invalid or a network error occurs.
      */
     fetch(objectId: string): Promise<EdgePassObject | null>;
     /**
@@ -122,14 +190,6 @@ export declare class EdgePass {
     }): Promise<{
         digest: string;
     }>;
-    /**
-     * Returns remaining budget in MIST.
-     */
-    remainingBudget(pass: EdgePassObject): bigint;
-    /**
-     * Returns true if the pass is active and not expired.
-     */
-    isValid(pass: EdgePassObject): boolean;
 }
 export {};
 //# sourceMappingURL=EdgePass.d.ts.map

package/dist/core/EdgePass.d.ts.map

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

package/dist/core/EdgePass.js

@@ -7,7 +7,6 @@ const utils_1 = require("@mysten/sui/utils");
 const PolicyEngine_1 = require("./PolicyEngine");
 const ExecutionEngine_1 = require("./ExecutionEngine");
 const constants_1 = require("../utils/constants");
-// Sui Clock object ID — shared object, always the same address
 const SUI_CLOCK_OBJECT_ID = '0x0000000000000000000000000000000000000000000000000000000000000006';
 // ── EdgePass class ────────────────────────────────────────────────────────────
 class EdgePass {
@@ -17,17 +16,16 @@ class EdgePass {
         this.client = new client_1.SuiClient({ url: constants_1.NETWORK_URLS[config.network] });
         this.engine = new ExecutionEngine_1.ExecutionEngine(config.network);
     }
-    // ── Event system ────────────────────────────────────────────────────────────
+    // ── Event system ─────────────────────────────────────────────────────────────
     /**
      * Subscribe to transaction outcomes.
-     * Note: 'error' status (network/signing failures) does NOT fire events.
-     * Check outcome.status === 'error' in your execute() handler instead.
      *
      * @example
      * sdk.on('approved', ({ outcome, pass }) => {
+     *   updateBudgetUI(pass);
      *   console.log('executed:', outcome.digest);
      * });
-     * sdk.on('escalated', ({ outcome, request }) => {
+     * sdk.on('escalated', ({ request }) => {
      *   notifyUser(`Approve $${request.amount} at ${request.merchant}?`);
      * });
      * sdk.on('blocked', ({ outcome }) => {
@@ -35,29 +33,20 @@ class EdgePass {
      * });
      */
     on(event, listener) {
-        if (!this.listeners.has(event)) {
+        if (!this.listeners.has(event))
             this.listeners.set(event, new Set());
-        }
         this.listeners.get(event).add(listener);
         return this;
     }
-    /**
-     * Unsubscribe a specific listener.
-     */
     off(event, listener) {
         this.listeners.get(event)?.delete(listener);
         return this;
     }
-    /**
-     * Remove all listeners for an event (or all events if none specified).
-     */
     removeAllListeners(event) {
-        if (event) {
+        if (event)
             this.listeners.delete(event);
-        }
-        else {
+        else
             this.listeners.clear();
-        }
         return this;
     }
     emit(payload) {
@@ -73,7 +62,7 @@ class EdgePass {
             }
         }
     }
-    // ── Static helpers ──────────────────────────────────────────────────────────
+    // ── Static helpers ────────────────────────────────────────────────────────────
     /**
      * Creates an EdgePassConfig from a template with optional overrides.
      *
@@ -91,39 +80,57 @@ class EdgePass {
             approvedMerchants: overrides.approvedMerchants ?? base.approvedMerchants,
         };
     }
-    // ── Core API ────────────────────────────────────────────────────────────────
+    /**
+     * Higher-order function — wraps any async function with EdgePass policy enforcement.
+     * The wrapped function only executes if the transaction is approved.
+     * Returns blocked/escalated outcomes without calling the wrapped function.
+     *
+     * Perfect for wrapping AI tool calls.
+     *
+     * @example
+     * const safePurchase = EdgePass.withPolicy(pass, signer, sdk, async (request) => {
+     *   return await purchaseItem(request.merchant, request.amount);
+     * });
+     *
+     * // Now safePurchase enforces EdgePass policy automatically
+     * const result = await safePurchase({ merchant: 'Hydra Bar', amount: 32n * MIST_PER_SUI });
+     * // result.outcome === 'approved' | 'blocked' | 'escalated'
+     */
+    static withPolicy(pass, signer, sdk, fn) {
+        return async (request) => {
+            const outcome = await sdk.execute(pass, request, signer);
+            if (outcome.status === 'blocked' || outcome.status === 'escalated' || outcome.status === 'error') {
+                return { outcome };
+            }
+            const result = await fn(request);
+            return { outcome, result };
+        };
+    }
+    // ── Core API ──────────────────────────────────────────────────────────────────
     /**
      * Mint a new EdgePass on Sui.
      */
     async create(passConfig, signer) {
-        // ── Config validation ─────────────────────────────────────────────────
         if (passConfig.autoThreshold >= passConfig.escalateThreshold) {
             throw new Error(`EdgePass.create: autoThreshold (${passConfig.autoThreshold}) must be less than escalateThreshold (${passConfig.escalateThreshold})`);
         }
         if (passConfig.escalateThreshold > passConfig.budget) {
             throw new Error(`EdgePass.create: escalateThreshold (${passConfig.escalateThreshold}) must be less than budget (${passConfig.budget})`);
         }
-        if (passConfig.maxPerTransaction !== undefined &&
-            passConfig.maxPerTransaction < passConfig.escalateThreshold) {
+        if (passConfig.maxPerTransaction !== undefined && passConfig.maxPerTransaction < passConfig.escalateThreshold) {
             throw new Error(`EdgePass.create: maxPerTransaction (${passConfig.maxPerTransaction}) should be >= escalateThreshold (${passConfig.escalateThreshold}) to avoid unexpected blocking`);
         }
-        if (passConfig.approvedMerchants.length === 0) {
+        if (passConfig.approvedMerchants.length === 0)
             throw new Error('EdgePass.create: approvedMerchants cannot be empty');
-        }
-        if (passConfig.expiryMs <= 0) {
+        if (passConfig.expiryMs <= 0)
             throw new Error('EdgePass.create: expiryMs must be greater than 0');
-        }
-        if (passConfig.budget <= BigInt(0)) {
+        if (passConfig.budget <= BigInt(0))
             throw new Error('EdgePass.create: budget must be greater than 0');
-        }
-        // ─────────────────────────────────────────────────────────────────────
         const tx = new transactions_1.Transaction();
         tx.setGasBudget(constants_1.DEFAULT_GAS_BUDGET);
         const packageId = constants_1.EDGE_PACKAGE_ID[this.config.network];
-        if (!packageId) {
-            throw new Error(`EdgePass.create: no package ID configured for network "${this.config.network}". ` +
-                `Update EDGE_PACKAGE_ID in constants.ts after deploying the Move contract.`);
-        }
+        if (!packageId)
+            throw new Error(`EdgePass.create: no package ID configured for network "${this.config.network}".`);
         tx.moveCall({
             target: `${packageId}::edge_pass::create_pass`,
             arguments: [
@@ -159,39 +166,99 @@ class EdgePass {
      * - 'escalated' — exceeds threshold, needs human approval
      * - 'blocked'   — policy rejected the transaction
      * - 'error'     — network/signing failure, transaction NOT submitted
-     *
-     * Events fire for approved/escalated/blocked only.
-     * Check outcome.status === 'error' separately for infrastructure failures.
-     *
-     * @example
-     * sdk.on('approved', ({ outcome }) => console.log('tx:', outcome.digest));
-     * const outcome = await sdk.execute(pass, { merchant, amount }, signer);
-     * if (outcome.status === 'error') handleInfrastructureFailure(outcome.reason);
      */
     async execute(pass, request, signer) {
         const outcome = await this.engine.execute(pass, request, signer);
-        // Fire events for policy outcomes only
-        // 'error' status = infrastructure failure, not a policy decision
         if (outcome.status !== 'error') {
-            this.emit({
-                type: outcome.status,
-                outcome: outcome,
-                pass,
-                request,
-            });
+            this.emit({ type: outcome.status, outcome: outcome, pass, request });
         }
         return outcome;
     }
     /**
-     * Preview outcome without executing. Zero network calls.
+     * Simulate a sequence of transactions against an EdgePass.
+     * Zero network calls. Sub-millisecond. Returns predicted outcomes for
+     * all decisions including projected budget state after each step.
+     *
+     * Use this to show an agent its plan before executing, or to build
+     * approval UIs that show what will happen before touching the chain.
+     *
+     * @example
+     * const plan = sdk.simulate(pass, [
+     *   { merchant: 'Hydra Bar',      amount: 32n * MIST_PER_SUI },
+     *   { merchant: 'ShadyTokens.xyz', amount: 1n },
+     *   { merchant: 'Stage Access VIP', amount: 220n * MIST_PER_SUI },
+     * ]);
+     *
+     * console.log(plan.summary);
+     * // { approvedCount: 1, blockedCount: 1, escalatedCount: 1, totalDecisions: 3 }
+     *
+     * // Show plan, then execute approved decisions
+     * for (const decision of plan.approved) {
+     *   await sdk.execute(pass, decision.request, signer);
+     * }
+     */
+    simulate(pass, requests) {
+        return PolicyEngine_1.PolicyEngine.simulate(pass, requests);
+    }
+    /**
+     * Preview a single transaction outcome without executing.
+     * Zero network calls. Sub-millisecond.
      */
     validate(pass, request) {
         return PolicyEngine_1.PolicyEngine.validate(pass, request);
     }
+    /**
+     * Returns a complete budget status snapshot.
+     *
+     * @example
+     * const status = sdk.budgetStatus(pass);
+     * if (status.isExhausted) stopAgent();
+     * if (status.isNearLimit) warnUser(`${status.utilizationPct.toFixed(1)}% of budget used`);
+     */
+    budgetStatus(pass, nearLimitThreshold = 0.8) {
+        return PolicyEngine_1.PolicyEngine.budgetStatus(pass, nearLimitThreshold);
+    }
+    /**
+     * Returns budget utilization as a percentage (0-100).
+     */
+    utilizationPct(pass) {
+        return PolicyEngine_1.PolicyEngine.utilizationPct(pass);
+    }
+    /**
+     * Returns true if budget utilization exceeds the given threshold.
+     * Default threshold is 80%.
+     */
+    isNearLimit(pass, threshold = 0.8) {
+        return PolicyEngine_1.PolicyEngine.isNearLimit(pass, threshold);
+    }
+    /**
+     * Returns the remaining budget in MIST.
+     */
+    remainingBudget(pass) {
+        return PolicyEngine_1.PolicyEngine.remainingBudget(pass);
+    }
+    /**
+     * Returns time remaining on the pass in milliseconds. 0 if expired.
+     */
+    timeRemaining(pass) {
+        return PolicyEngine_1.PolicyEngine.timeRemaining(pass);
+    }
+    /**
+     * Returns true if the pass will expire within the given window.
+     * Default window is 1 hour.
+     */
+    isExpiringSoon(pass, withinMs = 60 * 60 * 1000) {
+        return PolicyEngine_1.PolicyEngine.isExpiringSoon(pass, withinMs);
+    }
+    /**
+     * Returns true if the pass is active and not expired.
+     */
+    isValid(pass) {
+        return PolicyEngine_1.PolicyEngine.isValid(pass);
+    }
     /**
      * Fetch a live EdgePass from Sui.
      * Returns null if not found.
-     * Throws if objectId is invalid or a network error occurs.
      */
     async fetch(objectId) {
         return this.engine.fetchPass(objectId);
@@ -209,18 +276,6 @@ class EdgePass {
         });
         return signer.signAndExecute(tx);
     }
-    /**
-     * Returns remaining budget in MIST.
-     */
-    remainingBudget(pass) {
-        return PolicyEngine_1.PolicyEngine.remainingBudget(pass);
-    }
-    /**
-     * Returns true if the pass is active and not expired.
-     */
-    isValid(pass) {
-        return PolicyEngine_1.PolicyEngine.isValid(pass);
-    }
 }
 exports.EdgePass = EdgePass;
 //# sourceMappingURL=EdgePass.js.map

package/dist/core/EdgePass.js.map

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

package/dist/core/ExecutionEngine.d.ts

@@ -6,7 +6,6 @@ export declare const EDGE_ERROR_CODES: {
     readonly INVALID_OBJECT_ID: "INVALID_OBJECT_ID";
     readonly OBJECT_NOT_FOUND: "OBJECT_NOT_FOUND";
     readonly INVALID_PASS_STATE: "INVALID_PASS_STATE";
-    readonly VERSION_CONFLICT: "VERSION_CONFLICT";
     readonly UNKNOWN: "UNKNOWN";
 };
 export type EdgeErrorCode = typeof EDGE_ERROR_CODES[keyof typeof EDGE_ERROR_CODES];
@@ -22,9 +21,10 @@ export declare class ExecutionEngine {
     private buildPTB;
     /**
      * Fetch a live EdgePass from Sui.
-     * Populates objectRef for optimized PTB construction on subsequent execute() calls.
-     * Returns null if not found.
-     * Throws if objectId is invalid or a network error occurs.
+     *
+     * Returns null if the object doesn't exist.
+     * Throws EdgePassError if the objectId is invalid or a network error occurs —
+     * so callers can distinguish "not found" from "broken".
      */
     fetchPass(objectId: string): Promise<EdgePassObject | null>;
 }

package/dist/core/ExecutionEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionEngine.d.ts","sourceRoot":"","sources":["../../src/core/ExecutionEngine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACR,MAAM,gBAAgB,CAAC;AAKxB,eAAO,MAAM,gBAAgB;;;;;;;;CAQnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAuDnF,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,EAAE,OAAO;IAKtB,OAAO,CACX,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;QAAE,cAAc,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAC3E,OAAO,CAAC,kBAAkB,CAAC;IAiC9B,OAAO,CAAC,QAAQ;IAmChB;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAgFlE"}
+{"version":3,"file":"ExecutionEngine.d.ts","sourceRoot":"","sources":["../../src/core/ExecutionEngine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACR,MAAM,gBAAgB,CAAC;AAKxB,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AA2CnF,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,EAAE,OAAO;IAKtB,OAAO,CACX,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;QAAE,cAAc,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAC3E,OAAO,CAAC,kBAAkB,CAAC;IA2B9B,OAAO,CAAC,QAAQ;IA4BhB;;;;;;OAMG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CA6ElE"}