@candledottv/agent-sdk 0.5.0 → 0.6.1

package/dist/index.js

@@ -3,6 +3,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/client.ts
 import { keccak_256 as keccak_2562 } from "@noble/hashes/sha3";
+import { base58 as base582 } from "@scure/base";
 
 // src/authorization-signature.ts
 import canonicalize from "canonicalize";
@@ -78,6 +79,7 @@ async function buildPrivyAuthorizationSignature(params) {
 var BRIDGE_ERROR_CODES = ["BRIDGE_DESTINATION_MISSING", "RELAY_STEP_REFUSED", "BRIDGE_IN_FLIGHT"];
 
 class CandleApiError extends Error {
+  legs;
   code;
   status;
   retryable;
@@ -94,9 +96,12 @@ class CandleApiError extends Error {
   feeRaw;
   quoteAsset;
   treasury;
+  reason;
+  retryAfter;
   constructor(args) {
     super(args.message);
     this.name = "CandleApiError";
+    this.legs = args.legs;
     this.code = args.code;
     this.status = args.status;
     this.retryable = args.retryable;
@@ -121,6 +126,45 @@ class CandleApiError extends Error {
       this.quoteAsset = args.quoteAsset;
     if (args.treasury !== undefined)
       this.treasury = args.treasury;
+    if (args.reason !== undefined)
+      this.reason = args.reason;
+    if (args.retryAfter !== undefined)
+      this.retryAfter = args.retryAfter;
+  }
+}
+
+class TradeLegOutcomeError extends Error {
+  clientTradeId;
+  leg;
+  outcome;
+  txHash;
+  landedLegs;
+  cause;
+  constructor(args) {
+    super((args.cause instanceof Error ? args.cause.message + ". " : "") + "A Hood trade leg failed. Inspect txHash and landedLegs on chain; read getTradeJob(clientTradeId) or call trade with the same id and body for Candle's view. Never retry a retryable:false answer.", { cause: args.cause });
+    this.name = "TradeLegOutcomeError";
+    this.clientTradeId = args.clientTradeId;
+    this.leg = args.leg;
+    this.outcome = args.outcome;
+    this.txHash = args.txHash;
+    this.landedLegs = args.landedLegs;
+    this.cause = args.cause;
+  }
+}
+
+class TradeLandedUnconfirmedError extends Error {
+  clientTradeId;
+  tradeTxHash;
+  feeTxHash;
+  stage = "executed";
+  cause;
+  constructor(args) {
+    super("The trade is on chain and not booked. Read getTradeJob(clientTradeId) before calling confirmTrade again with these hashes. If the row is failed, this id cannot be recorded with /confirm; retain the hashes and do not retry or rebuild.", { cause: args.cause });
+    this.name = "TradeLandedUnconfirmedError";
+    this.clientTradeId = args.clientTradeId;
+    this.tradeTxHash = args.tradeTxHash;
+    this.feeTxHash = args.feeTxHash;
+    this.cause = args.cause;
   }
 }
 
@@ -142,6 +186,42 @@ class TradeLandedFeeLegError extends Error {
       this.feeTxHash = args.feeTxHash;
   }
 }
+function selfLaunchOutcomeMessage(args) {
+  const reason = args.cause instanceof Error ? args.cause.message : String(args.cause);
+  const feeTxHash = "feeTxHash" in args ? args.feeTxHash : undefined;
+  const head = `launch executed; ${args.step === "confirm" ? "confirmation" : "fee"} incomplete: the Hood curve is on chain ` + `(createCurveTxHash ${args.createCurveTxHash}, clientLaunchId ${args.clientLaunchId}), and a later step ` + `failed (${reason}). Do NOT call selfLaunch() or buildSelfLaunch() again for this attempt, under this id ` + `or a new one: a rebuild can create a second curve. Keep the id and every hash on this error.`;
+  const confirmWith = (fee) => `confirmSelfLaunch({ clientLaunchId, signature: createCurveTxHash${fee} }) for clientLaunchId ${args.clientLaunchId}`;
+  if (args.step === "confirm") {
+    const fee = args.feeOutcome === "landed" ? `The fee transfer landed (feeTxHash ${feeTxHash}).` : "This build had no fee transfer, so none is owed.";
+    return `${head} ${fee} The confirm call was refused or its answer was lost, so Candle may or may not have ` + `recorded the launch: read getLaunchJob(clientLaunchId). If the job is not confirmed and this error's ` + `cause allows it, call ${confirmWith(args.feeOutcome === "landed" ? ", feeTxHash" : "")} with these same ` + `hashes. Nothing needs signing or sending.`;
+  }
+  if (args.feeOutcome === "unknown") {
+    return `${head} The fee transfer MAY have paid: its outcome is unknown. Do NOT pay it again. ` + (feeTxHash ? `Check feeTxHash ${feeTxHash} and the payer wallet's history; a hash alone does not prove payment. ` : "Its hash is not known: reconcile the payer wallet's transactions before any payment decision. ") + `Once that exact fee is verified successful, call ${confirmWith(", feeTxHash")}.`;
+  }
+  const proof = args.feeOutcome === "reverted" ? `its receipt reverted${feeTxHash ? ` (feeTxHash ${feeTxHash})` : ""}` : `it was not broadcast${feeTxHash ? ` (feeTxHash ${feeTxHash} names the refused transaction, not a payment)` : ""}`;
+  return `${head} The fee transfer did NOT pay: ${proof}. The launch is not recorded without it. Pay only the ` + `missing fee, to the original build's treasury in its quote asset and raw amount, then call ` + `${confirmWith(", feeTxHash")} with the successful fee hash.`;
+}
+
+class SelfLaunchOutcomeError extends Error {
+  name = "SelfLaunchOutcomeError";
+  chain = "hood";
+  clientLaunchId;
+  createCurveTxHash;
+  stage = "executed";
+  step;
+  feeOutcome;
+  cause;
+  constructor(args) {
+    super(selfLaunchOutcomeMessage(args), { cause: args.cause });
+    this.clientLaunchId = args.clientLaunchId;
+    this.createCurveTxHash = args.createCurveTxHash;
+    this.step = args.step;
+    this.feeOutcome = args.feeOutcome;
+    if ("feeTxHash" in args && args.feeTxHash !== undefined)
+      this.feeTxHash = args.feeTxHash;
+    this.cause = args.cause;
+  }
+}
 function isSolanaRpcErrorData(data) {
   if (typeof data !== "object" || data === null)
     return false;
@@ -191,7 +271,7 @@ function definedIds(ids) {
   };
 }
 function operationIds(error) {
-  if (error instanceof CandleApiError || error instanceof JsonRpcError || error instanceof TradeLandedFeeLegError || error instanceof CandleOperationError) {
+  if (error instanceof CandleApiError || error instanceof JsonRpcError || error instanceof TradeLandedFeeLegError || error instanceof TradeLegOutcomeError || error instanceof TradeLandedUnconfirmedError || error instanceof SelfLaunchOutcomeError || error instanceof CandleOperationError) {
     return definedIds(error);
   }
   return {};
@@ -199,7 +279,7 @@ function operationIds(error) {
 function withOperationIds(error, ids, flow) {
   if (error instanceof CandleApiError || error instanceof JsonRpcError)
     return Object.assign(error, definedIds(ids));
-  if (error instanceof TradeLandedFeeLegError)
+  if (error instanceof TradeLandedFeeLegError || error instanceof TradeLegOutcomeError || error instanceof TradeLandedUnconfirmedError || error instanceof SelfLaunchOutcomeError)
     return error;
   if (error instanceof CandleOperationError) {
     return new CandleOperationError({ cause: error.cause, ids: { ...operationIds(error), ...definedIds(ids) }, flow });
@@ -227,13 +307,16 @@ function envelopeError(body) {
     message: error.message,
     ...typeof error.field === "string" ? { field: error.field } : {},
     ...typeof error.retryable === "boolean" ? { retryable: error.retryable } : {},
+    ...Array.isArray(error.legs) ? { legs: error.legs } : {},
     ...typeof error.stage === "string" ? { stage: error.stage } : {},
     ...typeof error.signature === "string" ? { signature: error.signature } : {},
     ...typeof error.mint === "string" ? { mint: error.mint } : {},
     ...typeof error.recorded === "boolean" ? { recorded: error.recorded } : {},
     ...typeof error.feeRaw === "string" ? { feeRaw: error.feeRaw } : {},
     ...typeof error.quoteAsset === "string" ? { quoteAsset: error.quoteAsset } : {},
-    ...typeof error.treasury === "string" ? { treasury: error.treasury } : {}
+    ...typeof error.treasury === "string" ? { treasury: error.treasury } : {},
+    ...typeof error.reason === "string" ? { reason: error.reason } : {},
+    ...typeof error.retryAfter === "number" ? { retryAfter: error.retryAfter } : {}
   };
 }
 function candleApiErrorFromResponse(status, bodyText) {
@@ -368,6 +451,10 @@ var HYPERLIQUID_EXCHANGE_URLS = {
   mainnet: "https://api.hyperliquid.xyz/exchange",
   testnet: "https://api.hyperliquid-testnet.xyz/exchange"
 };
+var HYPERLIQUID_INFO_URLS = {
+  mainnet: "https://api.hyperliquid.xyz/info",
+  testnet: "https://api.hyperliquid-testnet.xyz/info"
+};
 var CANDLE_HYPERLIQUID_BUILDER_ADDRESS = null;
 var HYPERLIQUID_MAX_BUILDER_FEE_TENTHS_BPS = 100;
 var HYPERLIQUID_MAX_BUILDER_FEE_RATE = "0.1%";
@@ -670,6 +757,67 @@ async function hyperliquidCloseOrder(fetcher, network, address, params) {
   const size = asked < held ? String(params.size) : String(szi).replace(/^-/, "");
   return { asset, isBuy: signed < 0n, size };
 }
+var HYPERLIQUID_DEFAULT_SLIPPAGE_BPS = 100;
+var HYPERLIQUID_MID_DRIFT_BPS = 100;
+async function hyperliquidOrderMarket(fetcher, network, address, method, params) {
+  const read = async (body) => {
+    const res = await fetcher(HYPERLIQUID_INFO_URLS[network], {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok)
+      throw new Error("Cannot read the market from Hyperliquid");
+    return JSON.parse(await res.text());
+  };
+  let coin = String(params.coin ?? "").toUpperCase();
+  let order;
+  if (method === "modify") {
+    const status = await read({ type: "orderStatus", user: address, oid: params.cloid });
+    const resting = status?.order?.order ?? null;
+    if (!resting || typeof resting.coin !== "string" || decimal(resting.limitPx) === null)
+      throw new Error("No resting order with this cloid on Hyperliquid");
+    coin = resting.coin.toUpperCase();
+    order = { isBuy: resting.side === "B", limitPx: String(resting.limitPx) };
+  }
+  const [meta, contexts] = await read({ type: "metaAndAssetCtxs" });
+  const asset = meta.universe.findIndex((m) => m.name.toUpperCase() === coin);
+  if (asset < 0 || asset >= 1e4)
+    throw new Error("No main-universe market for this coin on Hyperliquid");
+  const context = contexts[asset];
+  const midPx = context?.midPx ?? context?.markPx;
+  if ((decimal(midPx) ?? 0n) <= 0n)
+    throw new Error("No Hyperliquid price for this coin");
+  return { asset, midPx: String(midPx), ...order ? { order } : {} };
+}
+function checkOrderMarket(action, intent, market) {
+  const list = action.type === "modify" ? [action.order] : action.orders;
+  if (!Array.isArray(list) || list.length === 0)
+    return "missing requested order";
+  if (list.some((o) => !o || o.a !== market.asset))
+    return "order asset is not the requested coin's on Hyperliquid";
+  const first = list[0];
+  const p = intent.params;
+  if (intent.method === "open" && p.price == null) {
+    const requested = p.slippageBps;
+    const slippage = typeof requested === "number" && Number.isInteger(requested) && requested > 0 ? requested : HYPERLIQUID_DEFAULT_SLIPPAGE_BPS;
+    const bound = BigInt(slippage + HYPERLIQUID_MID_DRIFT_BPS);
+    const px = decimal(first.p) ?? 0n;
+    const mid = decimal(market.midPx) ?? 0n;
+    const within = first.b === true ? px * 10000n <= mid * (10000n + bound) : px * 10000n >= mid * (10000n - bound);
+    if (mid <= 0n || !within)
+      return "market order price is outside its slippage of Hyperliquid's mid";
+  }
+  if (intent.method === "modify") {
+    if (!market.order)
+      return "no resting order on Hyperliquid to check the modify against";
+    if (first.b !== market.order.isBuy)
+      return "modify changes the resting order's side";
+    if (p.price == null && decimal(first.p) !== decimal(market.order.limitPx))
+      return "modify changes the resting order's price";
+  }
+  return null;
+}
 function verifyPerpsBuild(build, opts) {
   try {
     const network = opts.network ?? "mainnet";
@@ -697,6 +845,13 @@ function verifyPerpsBuild(build, opts) {
       if (!order || order.a !== opts.closeOrder.asset || order.b !== opts.closeOrder.isBuy || decimal(order.s) !== decimal(opts.closeOrder.size) || order.r !== true)
         return { ok: false, reason: "close side, asset or size does not match the requested position" };
     }
+    if (opts.market) {
+      if (opts.intent?.method !== "open" && opts.intent?.method !== "modify")
+        return { ok: false, reason: "a market check needs an open or modify intent" };
+      const marketRefusal = checkOrderMarket(action, opts.intent, opts.market);
+      if (marketRefusal)
+        return { ok: false, reason: marketRefusal };
+    }
     if (typed.primary_type === "Agent") {
       const type = action.type;
       if (typeof type !== "string" || !HYPERLIQUID_ALLOWED_ACTION_TYPES.includes(type)) {
@@ -989,6 +1144,47 @@ function assertTransportSecurity(apiUrl, allowInsecureHttp) {
     return;
   throw new Error(`CandleClient: refusing to send credentials in the clear to ${parsed.origin}. Use https://.` + (isPrivateHost(parsed.hostname) ? " Pass allowInsecureHttp: true if this really is a trusted local endpoint." : " allowInsecureHttp does not apply here: it covers private networks only, and this is a" + " public address."));
 }
+var REDIRECT_STATUSES = new Set([301, 302, 303, 307, 308]);
+var MAX_REDIRECTS = 5;
+
+class CrossOriginRedirectError extends Error {
+  from;
+  to;
+  constructor(from, to) {
+    super(`The API at ${from} redirected to ${to}, another origin. Not followed, so the API key was not sent there.`);
+    this.from = from;
+    this.to = to;
+    this.name = "CrossOriginRedirectError";
+  }
+}
+function keyedRedirectGuard(doFetch) {
+  const guarded = async (input, init) => {
+    if (input instanceof Request || !init?.headers || !new Headers(init.headers).has("x-api-key")) {
+      return doFetch(input, init);
+    }
+    const url = input.toString();
+    let current = url;
+    let next = { ...init, redirect: "manual" };
+    for (let hops = 0;; hops++) {
+      const response = await doFetch(current, next);
+      const location = REDIRECT_STATUSES.has(response.status) ? response.headers?.get?.("location") : null;
+      if (!location)
+        return response;
+      const from = new URL(current);
+      const target = new URL(location, from);
+      if (target.origin !== from.origin)
+        throw new CrossOriginRedirectError(from.origin, target.origin);
+      if (hops >= MAX_REDIRECTS)
+        throw new Error(`More than ${MAX_REDIRECTS} redirects from ${url}`);
+      const method = (next.method ?? "GET").toUpperCase();
+      if (response.status === 303 && method !== "GET" && method !== "HEAD" || (response.status === 301 || response.status === 302) && method === "POST") {
+        next = { ...next, method: "GET", body: undefined };
+      }
+      current = target.href;
+    }
+  };
+  return guarded;
+}
 
 class CandleClient {
   apiUrl;
@@ -1060,7 +1256,7 @@ class CandleClient {
     this.apiUrl = opts.apiUrl.replace(/\/+$/, "");
     if (opts.apiKey !== undefined)
       this.apiKey = opts.apiKey;
-    this.fetchImpl = opts.fetch ?? fetch;
+    this.fetchImpl = keyedRedirectGuard(opts.fetch ?? fetch);
     if (opts.maxRetries !== undefined && (!Number.isInteger(opts.maxRetries) || opts.maxRetries < 0)) {
       throw new Error(`CandleClient: maxRetries must be a non-negative integer, got ${opts.maxRetries}`);
     }
@@ -1119,6 +1315,45 @@ class CandleClient {
   async verify(chain, mint) {
     return this.requestJson("GET", `/api/v1/verify/${chain}/${encodeURIComponent(mint)}`);
   }
+  async getOwnProfile() {
+    this.requireKey("getOwnProfile()");
+    return this.requestJson("GET", "/api/v1/agent/keys/self/public-profile");
+  }
+  async updateOwnProfile(patch) {
+    this.requireKey("updateOwnProfile()");
+    return this.requestJson("PATCH", "/api/v1/agent/keys/self/public-profile", patch);
+  }
+  async uploadProfileImage(kind, bytes, contentType) {
+    this.requireKey("uploadProfileImage()");
+    const form = new FormData;
+    form.set("kind", kind);
+    form.set("image", new Blob([bytes], { type: contentType }), "profile.image");
+    const headers = this.headers();
+    delete headers["Content-Type"];
+    const res = await this.fetchImpl(`${this.apiUrl}/api/v1/uploads/agent-profile-image`, {
+      method: "POST",
+      headers,
+      body: form
+    });
+    return this.parseResponse(res);
+  }
+  async createPost(req) {
+    this.requireKey("createPost()");
+    return this.requestJson("POST", "/api/v1/agent/posts", req);
+  }
+  async deletePost(postId) {
+    this.requireKey("deletePost()");
+    return this.requestJson("DELETE", `/api/v1/agent/posts/${encodeURIComponent(postId)}`);
+  }
+  async listAgentPosts(profileId, options = {}) {
+    const params = new URLSearchParams;
+    if (options.limit !== undefined)
+      params.set("limit", String(options.limit));
+    if (options.cursor !== undefined)
+      params.set("cursor", options.cursor);
+    const body = await this.requestJson("GET", `/api/v1/agent/records/${encodeURIComponent(profileId)}/posts${params.size ? `?${params}` : ""}`);
+    return { posts: body.posts, cursor: body.cursor ?? null };
+  }
   async getAgentProfile(idOrWallet) {
     const body = await this.requestJson("GET", `/api/v1/users/${encodeURIComponent(idOrWallet)}/agent`);
     return body.agent;
@@ -1456,6 +1691,7 @@ class CandleClient {
     if (built.artifacts.feeTransfer) {
       legs.push({ kind: "feeTransfer", ...built.artifacts.feeTransfer });
     }
+    const landedLegs = [];
     let tradeTxHash;
     let feeTxHash;
     for (let i = 0;i < legs.length; i++) {
@@ -1475,13 +1711,24 @@ class CandleClient {
           feeData,
           linkedWalletId,
           privyWalletId
-        }, { surfaceLegOutcome: leg.kind === "feeTransfer" });
+        }, { surfaceLegOutcome: true });
       } catch (err) {
         if (leg.kind === "feeTransfer" && tradeTxHash) {
           throw tradeLandedFeeLegError({ clientTradeId: built.clientTradeId, tradeTxHash, err });
         }
-        throw err;
+        if (err instanceof EvmLegOutcome && err.txHash !== undefined || landedLegs.length > 0) {
+          throw new TradeLegOutcomeError({
+            clientTradeId: built.clientTradeId,
+            leg: leg.kind,
+            outcome: err instanceof EvmLegOutcome ? err.kind : "not-broadcast",
+            txHash: err instanceof EvmLegOutcome ? err.txHash : undefined,
+            landedLegs: [...landedLegs],
+            cause: err instanceof EvmLegOutcome ? err.cause : err
+          });
+        }
+        throw err instanceof EvmLegOutcome ? err.cause : err;
       }
+      landedLegs.push({ leg: leg.kind, txHash });
       if (leg.kind === "trade")
         tradeTxHash = txHash;
       if (leg.kind === "feeTransfer")
@@ -1490,11 +1737,15 @@ class CandleClient {
     if (!tradeTxHash) {
       throw new Error("trade(): Hood leg sequence completed without a trade leg");
     }
-    return this.confirmTrade({
-      clientTradeId: built.clientTradeId,
-      tradeTxHash,
-      ...feeTxHash ? { feeTxHash } : {}
-    });
+    try {
+      return await this.confirmTrade({
+        clientTradeId: built.clientTradeId,
+        tradeTxHash,
+        ...feeTxHash ? { feeTxHash } : {}
+      });
+    } catch (cause) {
+      throw new TradeLandedUnconfirmedError({ clientTradeId: built.clientTradeId, tradeTxHash, feeTxHash, cause });
+    }
   }
   async selfLaunch(req) {
     const { privyWalletId, ...launchReq } = req;
@@ -1506,27 +1757,44 @@ class CandleClient {
     const built = await this.postSelfLaunchBuild(body, op);
     if (typeof built.transaction === "string") {
       let unsignedTransactionBase64 = built.transaction;
-      let clientLaunchId = built.clientLaunchId;
+      let clientLaunchId2 = built.clientLaunchId;
+      let signed;
       for (let attempt = 0;attempt <= MAX_BLOCKHASH_REBUILDS; attempt++) {
-        const signed = await this.signLinkedTransaction({
-          linkedWalletId: body.linkedWalletId,
-          privyWalletId,
-          chain: "solana",
-          unsignedTransactionBase64
-        });
+        if (signed?.forTransaction !== unsignedTransactionBase64) {
+          const result = await this.signLinkedTransaction({
+            linkedWalletId: body.linkedWalletId,
+            privyWalletId,
+            chain: "solana",
+            unsignedTransactionBase64
+          });
+          signed = { forTransaction: unsignedTransactionBase64, ...result };
+        }
         try {
           const signature = await this.broadcastSignedTransaction("solana", signed.signedTransaction, signed.encoding);
-          return this.confirmSelfLaunch({ clientLaunchId, signature });
+          return this.confirmSelfLaunch({ clientLaunchId: clientLaunchId2, signature });
         } catch (error) {
           if (!isBlockhashExpiry(error))
             throw error;
           if (attempt === MAX_BLOCKHASH_REBUILDS)
             throw withRpcLagHint(error);
-          const rebuilt = await this.postSelfLaunchBuild(body, op);
+          let rebuilt;
+          try {
+            rebuilt = await this.postSelfLaunchBuild(body, op);
+          } catch (buildError) {
+            const reason = buildError instanceof CandleApiError ? buildError.reason : undefined;
+            if (reason === "prior_attempt_in_flight")
+              continue;
+            if (reason === "prior_attempt_on_chain") {
+              const signature = solanaSignedTxSignature(signed.signedTransaction, signed.encoding);
+              if (signature)
+                return this.confirmSelfLaunch({ clientLaunchId: clientLaunchId2, signature });
+            }
+            throw buildError;
+          }
           if (typeof rebuilt.transaction !== "string")
             throw error;
           unsignedTransactionBase64 = rebuilt.transaction;
-          clientLaunchId = rebuilt.clientLaunchId;
+          clientLaunchId2 = rebuilt.clientLaunchId;
         }
       }
       throw new Error("selfLaunch(): blockhash-rebuild loop exited without returning or throwing");
@@ -1552,26 +1820,41 @@ class CandleClient {
       linkedWalletId: body.linkedWalletId,
       privyWalletId
     });
+    const clientLaunchId = built.clientLaunchId;
     let feeTxHash;
     if (hoodBuilt.feeTransfer) {
-      feeTxHash = await this.signBroadcastAndWaitEvmLeg({
-        rpc,
-        from,
-        to: hoodBuilt.feeTransfer.to,
-        data: hoodBuilt.feeTransfer.data,
-        valueDecimal: hoodBuilt.feeTransfer.value,
-        nonce: baseNonce + 1,
-        chainId,
-        feeData,
-        linkedWalletId: body.linkedWalletId,
-        privyWalletId
+      try {
+        feeTxHash = await this.signBroadcastAndWaitEvmLeg({
+          rpc,
+          from,
+          to: hoodBuilt.feeTransfer.to,
+          data: hoodBuilt.feeTransfer.data,
+          valueDecimal: hoodBuilt.feeTransfer.value,
+          nonce: baseNonce + 1,
+          chainId,
+          feeData,
+          linkedWalletId: body.linkedWalletId,
+          privyWalletId
+        }, { surfaceLegOutcome: true });
+      } catch (err) {
+        throw selfLaunchFeeLegError({ clientLaunchId, createCurveTxHash, err });
+      }
+    }
+    try {
+      return await this.confirmSelfLaunch({
+        clientLaunchId,
+        signature: createCurveTxHash,
+        ...feeTxHash ? { feeTxHash } : {}
+      });
+    } catch (cause) {
+      throw new SelfLaunchOutcomeError({
+        clientLaunchId,
+        createCurveTxHash,
+        step: "confirm",
+        ...feeTxHash ? { feeOutcome: "landed", feeTxHash } : { feeOutcome: "not-required" },
+        cause
       });
     }
-    return this.confirmSelfLaunch({
-      clientLaunchId: built.clientLaunchId,
-      signature: createCurveTxHash,
-      ...feeTxHash ? { feeTxHash } : {}
-    });
   }
   async buildAtomicLaunch(req) {
     this.requireKey("buildAtomicLaunch()");
@@ -1693,7 +1976,7 @@ class CandleClient {
       if (!isDefiniteBroadcastRejection(err)) {
         throw new EvmLegOutcome({ kind: "unknown", txHash: predicted, cause: err });
       }
-      throw err;
+      throw new EvmLegOutcome({ kind: "not-broadcast", txHash: predicted, cause: err });
     }
     try {
       await waitForReceipt(params.rpc, txHash, evmReceiptWaitForTest ?? {});
@@ -1891,6 +2174,17 @@ class CandleClient {
       if (!closeCheck.ok)
         throw new Error(`perps: refused to sign this build: ${closeCheck.reason}`);
     }
+    if (method === "open" || method === "modify") {
+      const market = await hyperliquidOrderMarket(this.fetchImpl, this.hyperliquidNetwork, build.address, method, ref);
+      const marketCheck = verifyPerpsBuild(build, {
+        builder: await this.perpsBuilder(),
+        network: this.hyperliquidNetwork,
+        intent: { method, params: ref },
+        market
+      });
+      if (!marketCheck.ok)
+        throw new Error(`perps: refused to sign this build: ${marketCheck.reason}`);
+    }
     if (ref.submit === false)
       return { build, signature: null, submitted: false, exchange: null };
     const signature = await this.signLinkedTypedData({
@@ -2050,7 +2344,7 @@ function tradeLandedFeeLegError(args) {
       tradeTxHash: args.tradeTxHash,
       cause: args.err.cause,
       feeOutcome: args.err.kind,
-      ...args.err.txHash !== undefined ? { feeTxHash: args.err.txHash } : {}
+      ...args.err.kind !== "not-broadcast" && args.err.txHash !== undefined ? { feeTxHash: args.err.txHash } : {}
     });
   }
   return new TradeLandedFeeLegError({
@@ -2060,6 +2354,38 @@ function tradeLandedFeeLegError(args) {
     feeOutcome: "not-broadcast"
   });
 }
+function selfLaunchFeeLegError(args) {
+  const outcome = args.err instanceof EvmLegOutcome ? args.err : undefined;
+  return new SelfLaunchOutcomeError({
+    clientLaunchId: args.clientLaunchId,
+    createCurveTxHash: args.createCurveTxHash,
+    step: "feeTransfer",
+    feeOutcome: outcome?.kind ?? "not-broadcast",
+    ...outcome?.txHash !== undefined ? { feeTxHash: outcome.txHash } : {},
+    cause: outcome ? outcome.cause : args.err
+  });
+}
+function solanaSignedTxSignature(signedTransaction, encoding) {
+  const enc = encoding.toLowerCase();
+  let bytes;
+  try {
+    if (enc === "base64")
+      bytes = fromBase64(signedTransaction);
+    else if (enc === "base58")
+      bytes = base582.decode(signedTransaction);
+    else
+      return;
+  } catch {
+    return;
+  }
+  const count = bytes[0];
+  if (count === undefined || count === 0 || count >= 128 || bytes.length < 1 + count * 64)
+    return;
+  const first = bytes.subarray(1, 65);
+  if (first.every((byte) => byte === 0))
+    return;
+  return base582.encode(first);
+}
 function evmSignedTxHash(signedTransaction, encoding) {
   const enc = encoding.toLowerCase();
   let bytes;
@@ -2098,7 +2424,7 @@ function generateClientLaunchId() {
 function generateClientTradeId() {
   return generateSdkId();
 }
-var SDK_VERSION = "0.5.0";
+var SDK_VERSION = "0.6.1";
 var sdkUpdateWarned = false;
 function noteLatestSdkVersion(value) {
   if (sdkUpdateWarned || !value || !/^\d+\.\d+\.\d+$/.test(value))
@@ -2237,7 +2563,7 @@ var PLAN_CAPABILITY_LABELS = {
   createLinkedWallets: "Create linked wallets",
   importLinkedWallets: "Import linked wallets",
   limitOrders: "Limit orders",
-  quant: "Quant on Telegram"
+  quant: "Quant deep analyses (Max)"
 };
 var PLAN_LABELS = { free: "Free", believer: "Believer", pro: "Pro", max: "Max" };
 function planLabel(plan) {
@@ -2464,11 +2790,15 @@ export {
   perpsDepositProblem,
   operationIds,
   isSolanaRpcErrorData,
+  hyperliquidOrderMarket,
   hyperliquidActionHash,
   generateSignerKeypair,
   formatPlanBps,
   encryptWalletKeyForImport,
+  TradeLegOutcomeError,
+  TradeLandedUnconfirmedError,
   TradeLandedFeeLegError,
+  SelfLaunchOutcomeError,
   PLAN_CAPABILITY_NOTE,
   PLAN_CAPABILITY_LABELS,
   KeychainSecretStore,
@@ -2477,6 +2807,7 @@ export {
   HYPERLIQUID_EXCHANGE_URLS,
   HYPERLIQUID_ALLOWED_ACTION_TYPES,
   EncryptedFileSecretStore,
+  CrossOriginRedirectError,
   CandleOperationError,
   CandleClient,
   CandleApiError,

package/dist/plans.d.ts

@@ -46,7 +46,7 @@ export interface PlanCapabilities {
     /** Plan eligibility only: whether perps are open on the deployment is its own switch, and trading needs the wallet and scopes. */
     hyperliquidPerps: boolean;
     limitOrders: boolean;
-    /** The quant bot on Telegram. */
+    /** Max-level Quant: the deep `run_analysis` studies. Pro also has Quant, on Telegram and in Candle, but by its plan name, not this flag. */
     quant: boolean;
     /** Base-pair swaps and base-asset bridges between the key's own wallets carry no Candle fee. A bridge also needs its own deployment switch. */
     freeBaseTransfers: boolean;

package/dist/plans.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAA;AAE1D,yFAAyF;AACzF,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,qGAAqG;AACrG,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,iBAAiB,EAAE,OAAO,CAAA;IAC1B,sFAAsF;IACtF,kBAAkB,EAAE,OAAO,CAAA;IAC3B,eAAe,EAAE,OAAO,CAAA;IACxB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,kIAAkI;IAClI,gBAAgB,EAAE,OAAO,CAAA;IACzB,WAAW,EAAE,OAAO,CAAA;IACpB,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAA;IACd,+IAA+I;IAC/I,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAA;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,UAAU,CAAA;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,OAAO,EAAE,IAAI,CAAA;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,ibAC+Y,CAAA;AAEhb,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,gBAAgB,EAAE,MAAM,CAazE,CAAA;AAID,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAWD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CA+BvF;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAIjE;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAI1D"}
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAA;AAE1D,yFAAyF;AACzF,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,qGAAqG;AACrG,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,iBAAiB,EAAE,OAAO,CAAA;IAC1B,sFAAsF;IACtF,kBAAkB,EAAE,OAAO,CAAA;IAC3B,eAAe,EAAE,OAAO,CAAA;IACxB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,kIAAkI;IAClI,gBAAgB,EAAE,OAAO,CAAA;IACzB,WAAW,EAAE,OAAO,CAAA;IACpB,4IAA4I;IAC5I,KAAK,EAAE,OAAO,CAAA;IACd,+IAA+I;IAC/I,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAA;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,UAAU,CAAA;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,OAAO,EAAE,IAAI,CAAA;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,ibAC+Y,CAAA;AAEhb,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,gBAAgB,EAAE,MAAM,CAazE,CAAA;AAID,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAWD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CA+BvF;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAIjE;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAI1D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@candledottv/agent-sdk",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification",
   "type": "module",
   "main": "./dist/index.js",