@buildaureon/sdk 0.1.0 → 0.1.2

package/config/network.json

@@ -1,10 +1,10 @@
-{
-  "defaultBaseUrl": "https://api.aureonlabs.network",
-  "localBaseUrl": "http://127.0.0.1:8787",
-  "appUrl": "https://app.aureonlabs.network",
-  "product": "AUREON",
-  "chain": "Robinhood Chain Testnet",
-  "chainId": 46630,
-  "sdkPackage": "@buildaureon/sdk",
-  "sdkVersion": "0.1.0"
-}
+{
+  "defaultBaseUrl": "https://api.aureonlabs.network",
+  "localBaseUrl": "http://127.0.0.1:8787",
+  "appUrl": "https://app.aureonlabs.network",
+  "product": "AUREON",
+  "chain": "Robinhood Chain Testnet",
+  "chainId": 46630,
+  "sdkPackage": "@buildaureon/sdk",
+  "sdkVersion": "0.1.0"
+}

package/dist/index.d.ts

@@ -19,8 +19,10 @@ interface AureonClientOptions {
     baseUrl?: string;
     /**
      * Product API key sent as `X-Aureon-Api-Key` on every request.
-     * Required for SDK / CLI / code when keys are enforced and there is no
-     * wallet Bearer yet. The operator utility uses wallet Bearer only.
+     * Operator-issued keys (from the Developers console) also identify the
+     * bound wallet for control-plane calls — no Bearer required.
+     * Env bootstrap keys unlock product access only; they do not set identity.
+     * The operator utility uses wallet Bearer only.
      */
     apiKey?: string | null;
     /**
@@ -55,6 +57,55 @@ interface AureonClientOptions {
     retryDelayMs?: number;
 }
 
+/**
+ * @fileoverview Phase 2 ObjectiveRegistry types.
+ */
+type RegistryStatus = {
+    enabled: boolean;
+    chainId: number;
+    contractAddress: string | null;
+    explorerBase: string;
+    network: string;
+};
+type RegistryRef = {
+    objectiveKey: string;
+    contractAddress: string;
+};
+type ObjectiveRegistryRecord = {
+    objectiveId: string;
+    objectiveKey: string;
+    configHash: string;
+    owner: string;
+    status: "active" | "paused" | "cancelled";
+    chainId: number;
+    contractAddress: string;
+    transactionHash: string;
+    blockNumber: number | null;
+    registeredAt: string;
+    updatedAt: string;
+    explorerUrl: string;
+    verifiedOnChain: boolean;
+};
+type PrepareRegistryResult = {
+    chainId: number;
+    contractAddress: string;
+    explorerBase: string;
+    objectiveId: string;
+    objectiveKey: string;
+    configHash: string;
+    to: string;
+    data: string;
+    value: "0";
+    functionName: "registerObjective";
+};
+type ObjectiveRegistryLookup = {
+    registered: false;
+    objectiveId: string;
+} | {
+    registered: true;
+    record: ObjectiveRegistryRecord;
+};
+
 /**
  * @fileoverview Execution receipt + restore-plan types.
  *
@@ -62,6 +113,7 @@ interface AureonClientOptions {
  * as a staged capital-book update (`settlement: "staged"`) when the vault
  * path is unavailable. Wrap/unwrap ETH↔WETH is client-side via RestorePlan.
  */
+
 interface ExecutionReceipt {
     id: string;
     objectiveId: string;
@@ -77,6 +129,7 @@ interface ExecutionReceipt {
      * `"staged"`: capital-book restore only (honest non-finality label).
      */
     settlement?: "staged" | "vault";
+    registryRef?: RegistryRef;
 }
 /** Client-side restore action: wrap/unwrap ETH↔WETH or keeper vault swap. */
 type RestorePlanKind = "wrap_eth" | "unwrap_weth" | "vault_swap";
@@ -111,7 +164,7 @@ declare function pickWorstHealth(records: ObjectiveHealth[]): ObjectiveHealth |
 /**
  * @fileoverview Timeline event contracts for append-only operator narratives.
  */
-type TimelineEventType = "objective_created" | "objective_updated" | "objective_paused" | "objective_resumed" | "health_changed" | "violation_detected" | "evaluation_started" | "execution_started" | "execution_completed" | "market_event_applied" | "objective_restored" | "capital_provisioned" | "capital_cleared" | "capital_synced";
+type TimelineEventType = "objective_created" | "objective_updated" | "objective_paused" | "objective_resumed" | "health_changed" | "violation_detected" | "evaluation_started" | "execution_started" | "execution_completed" | "market_event_applied" | "objective_restored" | "capital_provisioned" | "capital_cleared" | "capital_synced" | "registry_anchored";
 interface TimelineEvent {
     id: string;
     objectiveId: string | null;
@@ -231,6 +284,8 @@ interface Objective {
     updatedAt: string;
     lastEvaluatedAt: string | null;
     lastExecutionId: string | null;
+    verifiedOnChain?: boolean;
+    configHash?: string;
 }
 /**
  * Input for creating a new objective.
@@ -262,7 +317,11 @@ interface UpdateObjectiveInput {
     tolerance?: number;
     maxRiskScore?: number;
     reinvestRatio?: number;
-    targetSymbol?: string | null;
+    /**
+     * @deprecated Rejected on update; target token is fixed at create.
+     * Recreate the objective to track a different holding.
+     */
+    targetSymbol?: never;
     /**
      * @deprecated Rejected on update; mode is fixed at create to avoid restore-flow issues.
      * Recreate the objective to switch Manual ↔ Automatic.
@@ -423,8 +482,10 @@ interface WatchdogRefreshResult {
 /**
  * @fileoverview AureonClient: primary entry point for @buildaureon/sdk.
  *
- * Typed HTTP client for the hosted AUREON API. Wallet Bearer sessions identify
- * the operator; `apiKey` (`X-Aureon-Api-Key`) unlocks product access.
+ * Typed HTTP client for the hosted AUREON API. Operator-issued API keys
+ * (`X-Aureon-Api-Key`) identify the bound wallet for control-plane calls;
+ * optional wallet Bearer sessions also work (Bearer wins when both are sent).
+ * Env bootstrap keys unlock product access only.
  *
  * Objectives default to Automatic automation mode. Vault deposit and withdraw
  * are prepare-calldata steps for wallet signing; not server-side broadcasts.
@@ -492,6 +553,7 @@ declare class AureonClient {
         address: string;
         message: string;
         signature: string;
+        inviteCode?: string;
     }): Promise<AuthSessionResponse>;
     /**
      * Local preview login without a wallet signature.
@@ -518,7 +580,7 @@ declare class AureonClient {
     getObjective(id: string): Promise<Objective>;
     /**
      * Applies a partial update to an objective policy or metadata.
-     * Does **not** accept `automationMode` (mode is locked at create).
+     * Does **not** accept `automationMode` or `targetSymbol` (both locked at create).
      * Auth required.
      */
     updateObjective(id: string, input: UpdateObjectiveInput): Promise<Objective>;
@@ -590,6 +652,22 @@ declare class AureonClient {
     restoreObjective(objectiveId: string): Promise<ExecutionReceipt>;
     /** Lists recent execution receipts. Auth required. */
     listExecutions(objectiveId?: string): Promise<ExecutionReceipt[]>;
+    /** Returns Phase 2 ObjectiveRegistry deployment status. Auth required. */
+    getRegistryStatus(): Promise<RegistryStatus>;
+    /** Returns on-chain registry record for an objective when registered. Auth required. */
+    getObjectiveRegistry(objectiveId: string): Promise<ObjectiveRegistryLookup>;
+    /**
+     * Prepares wallet-signed calldata to register an objective on ObjectiveRegistry.
+     * Auth required.
+     */
+    prepareObjectiveRegistry(objectiveId: string): Promise<PrepareRegistryResult>;
+    /**
+     * Confirms an on-chain registration after the wallet broadcast tx.
+     * Auth required.
+     */
+    confirmObjectiveRegistry(objectiveId: string, transactionHash: string): Promise<{
+        record: ObjectiveRegistryRecord;
+    }>;
     /** Returns the vault overview for the authenticated wallet. Auth required. */
     getVault(): Promise<VaultOverview>;
     /** Returns compact vault funding status before restore. Auth required. */
@@ -747,7 +825,7 @@ declare const DEFAULT_API_BASE_URL = "https://api.aureonlabs.network";
 /** Local monorepo preview only; not for public docs. */
 declare const LOCAL_API_BASE_URL = "http://127.0.0.1:8787";
 declare const DEFAULT_TIMEOUT_MS = 30000;
-declare const SDK_VERSION = "0.1.0";
+declare const SDK_VERSION = "0.1.2";
 declare const SDK_NAME = "@buildaureon/sdk";
 declare const PRODUCT_NAME = "AUREON";
 declare const PRODUCT_TAGLINE = "Financial Compass for Robinhood Chain";
@@ -781,6 +859,7 @@ declare const ENDPOINTS: {
     readonly authDevLogin: "/auth/dev-login";
     readonly authMe: "/auth/me";
     readonly developerApiKeys: "/developer/api-keys";
+    readonly registryStatus: "/registry/status";
 };
 
 /**
@@ -789,4 +868,4 @@ declare const ENDPOINTS: {
 type FetchLike = typeof fetch;
 declare function resolveFetch(custom?: FetchLike): FetchLike;
 
-export { API_KEY_HEADER, type ApplyMarketEventInput, AureonClient, type AureonClientOptions, AureonConflictError, AureonError, type AureonErrorCode, AureonNetworkError, AureonNotFoundError, AureonTimeoutError, AureonValidationError, type AuthMeResponse, type AuthNonceResponse, type AuthSessionResponse, type CreateObjectiveInput, type CreatedDeveloperApiKey, DEFAULT_API_BASE_URL, DEFAULT_TIMEOUT_MS, type DashboardOverview, type DeveloperApiKey, ENDPOINTS, type ExecutionReceipt, type HealthState, LOCAL_API_BASE_URL, type MarkQuote, type MarkQuoteSource, type MarketEvent, type MarketPreset, OBJECTIVE_KINDS, OBJECTIVE_PRIORITIES, type Objective, type ObjectiveAutomationMode, type ObjectiveHealth, type ObjectiveKind, type ObjectivePolicy, type ObjectivePriority, type ObjectiveStatus, PRODUCT_NAME, PRODUCT_TAGLINE, type PortfolioPosition, type PortfolioPositionInput, type PortfolioSnapshot, type RestorePlan, type RestorePlanKind, type RestoreSuggestion, type RestoreSuggestionAction, SDK_NAME, SDK_VERSION, type SessionTokenProvider, type SyncPortfolioResult, TIMELINE_EVENT_TYPES, type TimelineEvent, type TimelineEventType, type UpdateObjectiveInput, type VaultBalance, type VaultDepositSymbol, type VaultOverview, type VaultPrepareResult, type VaultPreparedStep, type VaultStatus, type VaultToken, type VaultWithdrawSymbol, type WatchdogAlertResult, type WatchdogRefreshResult, assertBaseUrl, buildPolicySummary, createAureonClient, createConsoleLogger, createLocalAureonClient, createSessionTokenProvider, errorFromHttpStatus, formatIsoTime, formatSignedPercent, formatUsd, formatWeight, healthTone, isAureonError, isHealthState, isObjectiveKind, isObjectivePriority, isTimelineEventType, isVaultSettlement, joinUrl, normalizeCreateObjectiveInput, normalizeUpdateObjectiveInput, pickWorstHealth, requestJson, resolveFetch, silentLogger, withQuery };
+export { API_KEY_HEADER, type ApplyMarketEventInput, AureonClient, type AureonClientOptions, AureonConflictError, AureonError, type AureonErrorCode, AureonNetworkError, AureonNotFoundError, AureonTimeoutError, AureonValidationError, type AuthMeResponse, type AuthNonceResponse, type AuthSessionResponse, type CreateObjectiveInput, type CreatedDeveloperApiKey, DEFAULT_API_BASE_URL, DEFAULT_TIMEOUT_MS, type DashboardOverview, type DeveloperApiKey, ENDPOINTS, type ExecutionReceipt, type HealthState, LOCAL_API_BASE_URL, type MarkQuote, type MarkQuoteSource, type MarketEvent, type MarketPreset, OBJECTIVE_KINDS, OBJECTIVE_PRIORITIES, type Objective, type ObjectiveAutomationMode, type ObjectiveHealth, type ObjectiveKind, type ObjectivePolicy, type ObjectivePriority, type ObjectiveRegistryLookup, type ObjectiveRegistryRecord, type ObjectiveStatus, PRODUCT_NAME, PRODUCT_TAGLINE, type PortfolioPosition, type PortfolioPositionInput, type PortfolioSnapshot, type PrepareRegistryResult, type RegistryRef, type RegistryStatus, type RestorePlan, type RestorePlanKind, type RestoreSuggestion, type RestoreSuggestionAction, SDK_NAME, SDK_VERSION, type SessionTokenProvider, type SyncPortfolioResult, TIMELINE_EVENT_TYPES, type TimelineEvent, type TimelineEventType, type UpdateObjectiveInput, type VaultBalance, type VaultDepositSymbol, type VaultOverview, type VaultPrepareResult, type VaultPreparedStep, type VaultStatus, type VaultToken, type VaultWithdrawSymbol, type WatchdogAlertResult, type WatchdogRefreshResult, assertBaseUrl, buildPolicySummary, createAureonClient, createConsoleLogger, createLocalAureonClient, createSessionTokenProvider, errorFromHttpStatus, formatIsoTime, formatSignedPercent, formatUsd, formatWeight, healthTone, isAureonError, isHealthState, isObjectiveKind, isObjectivePriority, isTimelineEventType, isVaultSettlement, joinUrl, normalizeCreateObjectiveInput, normalizeUpdateObjectiveInput, pickWorstHealth, requestJson, resolveFetch, silentLogger, withQuery };

package/dist/index.js

@@ -14,7 +14,7 @@ function userAgentHeader(version) {
 var DEFAULT_API_BASE_URL = "https://api.aureonlabs.network";
 var LOCAL_API_BASE_URL = "http://127.0.0.1:8787";
 var DEFAULT_TIMEOUT_MS = 3e4;
-var SDK_VERSION = "0.1.0";
+var SDK_VERSION = "0.1.2";
 var SDK_NAME = "@buildaureon/sdk";
 var PRODUCT_NAME = "AUREON";
 var PRODUCT_TAGLINE = "Financial Compass for Robinhood Chain";
@@ -44,7 +44,8 @@ var ENDPOINTS = {
   authLogout: "/auth/logout",
   authDevLogin: "/auth/dev-login",
   authMe: "/auth/me",
-  developerApiKeys: "/developer/api-keys"
+  developerApiKeys: "/developer/api-keys",
+  registryStatus: "/registry/status"
 };
 function objectivePath(id) {
   return `${ENDPOINTS.objectives}/${encodeURIComponent(id)}`;
@@ -64,6 +65,15 @@ function objectiveRestorePath(id) {
 function developerApiKeyPath(id) {
   return `${ENDPOINTS.developerApiKeys}/${encodeURIComponent(id)}`;
 }
+function registryObjectivePath(id) {
+  return `/registry/objectives/${encodeURIComponent(id)}`;
+}
+function registryPreparePath(id) {
+  return `${registryObjectivePath(id)}/prepare-register`;
+}
+function registryConfirmPath(id) {
+  return `${registryObjectivePath(id)}/confirm`;
+}
 
 // src/errors/codes.ts
 var RETRYABLE_CODES = [
@@ -508,6 +518,11 @@ function normalizeUpdateObjectiveInput(input) {
       "automationMode cannot be changed after create: recreate the objective instead"
     );
   }
+  if (input.targetSymbol !== void 0) {
+    throw new AureonValidationError(
+      "targetSymbol cannot be changed after create: recreate the objective instead"
+    );
+  }
   return next;
 }
 function assertId(value, label) {
@@ -570,6 +585,7 @@ var AureonClient = class {
     const address = input.address?.trim();
     const message = input.message?.trim();
     const signature = input.signature?.trim();
+    const inviteCode = input.inviteCode?.trim();
     if (!address || !message || !signature) {
       throw new AureonValidationError(
         "address, message, and signature are required"
@@ -577,7 +593,7 @@ var AureonClient = class {
     }
     return requestJson(this.transport, ENDPOINTS.authVerify, {
       method: "POST",
-      body: { address, message, signature }
+      body: { address, message, signature, inviteCode }
     });
   }
   /**
@@ -628,7 +644,7 @@ var AureonClient = class {
   }
   /**
    * Applies a partial update to an objective policy or metadata.
-   * Does **not** accept `automationMode` (mode is locked at create).
+   * Does **not** accept `automationMode` or `targetSymbol` (both locked at create).
    * Auth required.
    */
   async updateObjective(id, input) {
@@ -792,6 +808,40 @@ var AureonClient = class {
     );
     return result.executions;
   }
+  /** Returns Phase 2 ObjectiveRegistry deployment status. Auth required. */
+  async getRegistryStatus() {
+    return requestJson(this.transport, ENDPOINTS.registryStatus);
+  }
+  /** Returns on-chain registry record for an objective when registered. Auth required. */
+  async getObjectiveRegistry(objectiveId) {
+    assertId(objectiveId, "objective id");
+    return requestJson(this.transport, registryObjectivePath(objectiveId));
+  }
+  /**
+   * Prepares wallet-signed calldata to register an objective on ObjectiveRegistry.
+   * Auth required.
+   */
+  async prepareObjectiveRegistry(objectiveId) {
+    assertId(objectiveId, "objective id");
+    return requestJson(this.transport, registryPreparePath(objectiveId), {
+      method: "POST"
+    });
+  }
+  /**
+   * Confirms an on-chain registration after the wallet broadcast tx.
+   * Auth required.
+   */
+  async confirmObjectiveRegistry(objectiveId, transactionHash) {
+    assertId(objectiveId, "objective id");
+    const hash = transactionHash.trim();
+    if (!hash) {
+      throw new AureonValidationError("transactionHash is required");
+    }
+    return requestJson(this.transport, registryConfirmPath(objectiveId), {
+      method: "POST",
+      body: { transactionHash: hash }
+    });
+  }
   /** Returns the vault overview for the authenticated wallet. Auth required. */
   async getVault() {
     return requestJson(this.transport, ENDPOINTS.vault);
@@ -988,7 +1038,8 @@ var TIMELINE_EVENT_TYPES = [
   "objective_restored",
   "capital_provisioned",
   "capital_cleared",
-  "capital_synced"
+  "capital_synced",
+  "registry_anchored"
 ];
 function isTimelineEventType(value) {
   return TIMELINE_EVENT_TYPES.includes(value);