@thirdfy/agent-cli 0.2.77 → 0.2.78

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to `@thirdfy/agent-cli` are documented here. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.78] - 2026-09-24
+
+### Changed
+
+- **Avantis is now Veranta.** The Base perps venue rebranded (ticker AVNT unchanged). Help, errors, provider hints and docs say Veranta. Provider hints for `avantis` / `avantis-vault` list Veranta action names (`place_veranta_perps_order`, `deposit_veranta_vault`, ...) and carry `displayName: "Veranta"` and `providerAliases`.
+
+### Added
+
+- **Veranta names work against every API deployment.** A Veranta action name (`*_veranta_*`) resolves to the catalog row the API in hand has: the Veranta row on an API with Veranta names, the Avantis row on one without. Avantis names keep working, including against a catalog that lists them only as aliases of Veranta rows. With no catalog to check, a Veranta name is sent in the Avantis spelling, which every deployment accepts. `pricing quote` does the same.
+- **`veranta` / `veranta-vault` provider aliases.** `--provider veranta` lists the same actions as `--provider avantis` (and `veranta-vault` as `avantis-vault`). `venue readiness|setup|fund veranta` calls the API with the `avantis` venue id. `avantis` is still accepted everywhere.
+- **Hardcoded venue lists recognise both spellings:** the offchain-venue lane guard (`OFFCHAIN_VENUE_ORDER_SELF_UNSUPPORTED`), the 180s long timeout for onboarding and market open/close, the `agent_wallet` `traderAddress` default, the `complete_*_onboarding` `estimatedAmountUsd` default, and `certify` venue fixtures (a live Veranta row replaces the Avantis fixture; the schema digest is spelling-independent).
+- Error codes and internal identifiers are unchanged (`avantis_delegate`, `AVANTIS_*` setup blockers, provider ids `avantis` / `avantis-vault`). Pin: `test/veranta-rebrand.test.cjs`.
+
 ## [0.2.77] - 2026-09-24
 
 ### Changed

package/README.md

@@ -40,13 +40,11 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.77
+## What's new in v0.2.78
 
-- The agent API key is sent in the `x-agent-api-key` header, never in a URL.
-- A write the API answers from an earlier identical one is marked `idempotentReplay: true`. Send a new `--idempotency-key` to place another.
-- `agent_wallet` reads make one API call (no separate wallet preflight when the read does not need it).
-- `deposit_earn_position` accepts `amountHuman` / `amountInHuman` as `amount`. Unknown actions report `blockedReason: UNKNOWN_ACTION` with `suggestions`.
-- Built on commander 14 and ethers 6.17; Node 20+ is still supported.
+- Avantis, the Base perps venue, is now **Veranta**. Use `--provider veranta` / `veranta-vault` and Veranta action names such as `place_veranta_perps_order` and `get_veranta_positions`.
+- Avantis names (`--provider avantis`, `place_avantis_perps_order`, `venue readiness avantis`) keep working. A Veranta name finds the matching action whether the Thirdfy API catalog lists Veranta or Avantis names.
+- `venue readiness|setup|fund veranta` works; `avantis` is still accepted.
 - See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
 
 ## Quick start
@@ -326,7 +324,7 @@ Provider and venue guides are kept outside `README` so this page stays stable as
 - Discovery: `catalogs list`, `actions` (optional `--provider`, `--chain-id`; see [`docs/command-reference.md`](./docs/command-reference.md) for trading vs earn vs prediction providers and case-insensitive matching)
 - Execution: `preflight`, `run`, `intent-status`, `jeff preflight`, `jeff trade`, `jeff status`
 - Polymarket: `polymarket status`, `polymarket setup`, `polymarket dry-run`
-- Venue tooling: `venue readiness`, `venue setup`, `venue fund` (`polymarket`, `hyperliquid`, `lighter`, `avantis`)
+- Venue tooling: `venue readiness`, `venue setup`, `venue fund` (`polymarket`, `hyperliquid`, `lighter`, `veranta`)
 - Hummingbot: `hummingbot status`, `connectors`, `executor-schema`, `executor-create`, `executor-stop`, `gateway-networks`, `gateway-connectors`
 - Condor Pattern A: `condor policy-status`, `condor preflight`
 - Managed signer execution: `wallet execute`, `wallet sign`, `wallet submit`, `agent run`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thirdfy/agent-cli",
-  "version": "0.2.77",
+  "version": "0.2.78",
   "description": "Thirdfy Agent CLI for onboarding, governance preflight, execute-intent, and status polling.",
   "type": "module",
   "bin": {

package/src/cli/manifest.mjs

@@ -103,7 +103,7 @@ export const CLI_MANIFEST = [
     path: ['venue', 'readiness'],
     handler: 'commandVenueReadiness',
     options: ['auth', 'venue'],
-    description: 'Normalized venue readiness (polymarket, hyperliquid, lighter, avantis)',
+    description: 'Normalized venue readiness (polymarket, hyperliquid, lighter, veranta)',
     args: { query: '<venue>' },
     tier: 'online',
   },

package/src/commands/avantis.mjs

@@ -1,11 +1,14 @@
+import { toLegacyVenueActionKey } from '../core/venueBrand.mjs';
+
+/**
+ * Veranta (formerly Avantis) helpers. Names keep the Avantis spelling (internal identifiers); every
+ * check accepts both the `*_avantis_*` and `*_veranta_*` action spellings.
+ */
 export function createAvantisHelpers(deps) {
   const { getPreparedParams, resolveManagedExecutionPreflight } = deps;
 
   function avantisDefaultAddressParamForAction(action) {
-    const canonical = String(action || '')
-      .trim()
-      .toLowerCase()
-      .replace(/_/g, '-');
+    const canonical = toLegacyVenueActionKey(action).replace(/_/g, '-');
     if (
       canonical === 'get-avantis-open-orders' ||
       canonical === 'get-avantis-positions' ||

package/src/commands/credits.mjs

@@ -1,5 +1,6 @@
 import { requireFlag } from '../core/args.mjs';
 import { apiGet, apiPost } from '../core/http.mjs';
+import { toAvantisSpelling } from '../core/venueBrand.mjs';
 import {
   formatCreditsEstimateSummary,
   formatCreditsModelsSummary,
@@ -117,7 +118,8 @@ export function createCreditsCommands({ printEnvelope, getAuthToken }) {
       ctx,
       '/api/v1/credits/pricing/quote',
       {
-        actionKey: action,
+        // Veranta names price as their Avantis spelling, which every API deployment knows.
+        actionKey: toAvantisSpelling(action),
         chainId: Number(flags.chainId || 8453),
       },
       { Authorization: `Bearer ${authToken}` },

package/src/commands/telemetry.mjs

@@ -1,5 +1,6 @@
 import { requireFlag, parseJsonFlag } from '../core/args.mjs';
 import { apiGet, apiPost } from '../core/http.mjs';
+import { hasVerantaToken, normalizeVenueProviderId } from '../core/venueBrand.mjs';
 export function createTelemetryCommands({ printEnvelope, resolveAgentApiKey }) {
 function applySharedPortfolioListingFiltersToQuery(query, flags) {
   if (flags.chainId) query.set('chainId', String(flags.chainId));
@@ -110,7 +111,10 @@ async function commandTrackAction(ctx, flags, capabilities) {
   if (flags.idempotencyKey) payload.idempotencyKey = String(flags.idempotencyKey);
   if (flags.category) payload.category = String(flags.category);
   if (flags.source) payload.source = String(flags.source);
-  if (flags.provider) payload.provider = String(flags.provider);
+  if (flags.provider) {
+    // `veranta` / `veranta-vault` report under the internal `avantis` / `avantis-vault` ids.
+    payload.provider = hasVerantaToken(flags.provider) ? normalizeVenueProviderId(flags.provider) : String(flags.provider);
+  }
   if (flags.protocol) payload.protocol = String(flags.protocol);
   if (flags.namespace) payload.namespace = String(flags.namespace);
   if (flags.actionType) payload.actionType = String(flags.actionType);

package/src/commands/venue.mjs

@@ -1,13 +1,16 @@
 import { apiGet, apiPost } from '../core/http.mjs';
 import { loadProfileConfig } from '../core/context.mjs';
+import { normalizeVenueProviderId } from '../core/venueBrand.mjs';
 
+// `avantis` is the internal venue id the API expects; `veranta` (the venue's new name) maps onto it.
 const VENUES = new Set(['polymarket', 'hyperliquid', 'lighter', 'avantis']);
 
 function resolveVenue(flags) {
   const fromQuery = Array.isArray(flags.query) ? flags.query[0] : flags.query;
-  const venue = String(flags.venue || fromQuery || '').trim().toLowerCase();
+  const requested = String(flags.venue || fromQuery || '').trim().toLowerCase();
+  const venue = normalizeVenueProviderId(requested);
   if (!VENUES.has(venue)) {
-    throw new Error(`Unsupported venue "${venue}". Use polymarket, hyperliquid, lighter, or avantis.`);
+    throw new Error(`Unsupported venue "${requested}". Use polymarket, hyperliquid, lighter, or veranta.`);
   }
   return venue;
 }

package/src/core/actionTimeouts.mjs

@@ -1,5 +1,6 @@
 import { DEFAULT_TIMEOUT_MS } from './constants.mjs';
 import { isReadOnlyActionName, isReadOnlyResolvedAction } from './readOnlyActions.mjs';
+import { toLegacyVenueActionKey } from './venueBrand.mjs';
 
 /**
  * Default HTTP timeout for managed writes. A perps order or TP/SL update signs, broadcasts, and waits
@@ -8,6 +9,7 @@ import { isReadOnlyActionName, isReadOnlyResolvedAction } from './readOnlyAction
  */
 const DEFAULT_WRITE_TIMEOUT_MS = 90_000;
 
+// Keyed by the Avantis spelling; `normalizeActionId` maps Veranta names onto it.
 const LONG_RUNNING_ACTIONS = new Set([
   'complete_avantis_onboarding',
   'get_avantis_setup_status',
@@ -29,17 +31,14 @@ const LONG_RUNNING_ACTIONS = new Set([
   'swap',
   'execute_optimal_swap',
   'deposit_hyperliquid_cctp',
-  // Avantis market open/close: the API streams the batched order for up to 90s, then polls its
+  // Veranta (formerly Avantis) market open/close: the API streams the batched order for up to 90s, then polls its
   // tracking status for up to 90s more before it answers.
   'place_avantis_perps_order',
   'close_avantis_position',
 ]);
 
 function normalizeActionId(action) {
-  return String(action || '')
-    .trim()
-    .replace(/-/g, '_')
-    .toLowerCase();
+  return toLegacyVenueActionKey(action).replace(/-/g, '_');
 }
 
 function positiveEnvMs(...names) {

package/src/core/venueBrand.mjs

@@ -0,0 +1,76 @@
+/**
+ * Veranta (formerly Avantis) naming.
+ *
+ * Avantis, the Base perps venue, rebranded to Veranta. The Thirdfy API is moving its action names
+ * from `*_avantis_*` to `*_veranta_*` (Veranta canonical, Avantis kept as aliases). Until every API
+ * deployment has the Veranta rows, the CLI has to work against both catalogs:
+ *
+ * - A Veranta action name resolves to whatever the catalog in hand has (the Avantis row on an older API).
+ * - An Avantis action name keeps working unchanged.
+ * - Hardcoded CLI lists (lanes, timeouts, address defaults) are keyed by the Avantis spelling, so they
+ *   compare through `toLegacyVenueActionKey`.
+ *
+ * Provider ids `avantis` / `avantis-vault` stay the internal identifiers. `veranta` / `veranta-vault`
+ * are accepted wherever the CLI reads a provider id.
+ */
+
+const LEGACY_TOKEN = 'avantis';
+const BRAND_TOKEN = 'veranta';
+
+// The token only counts as a whole word inside an action or provider id (`_`/`-` separated).
+const BRAND_TOKEN_RE = /(^|[_-])veranta(?=[_-]|$)/gi;
+const LEGACY_TOKEN_RE = /(^|[_-])avantis(?=[_-]|$)/gi;
+
+/** Human-facing venue name. */
+export const VERANTA_DISPLAY_NAME = 'Veranta';
+
+/** True when the id carries the Veranta token (`place_veranta_perps_order`, `veranta-vault`). */
+export function hasVerantaToken(value) {
+  BRAND_TOKEN_RE.lastIndex = 0;
+  return BRAND_TOKEN_RE.test(String(value || ''));
+}
+
+/** True when the id carries the Avantis token (`place_avantis_perps_order`, `avantis-vault`). */
+export function hasAvantisToken(value) {
+  LEGACY_TOKEN_RE.lastIndex = 0;
+  return LEGACY_TOKEN_RE.test(String(value || ''));
+}
+
+/** `place_veranta_perps_order` -> `place_avantis_perps_order`. Other names pass through unchanged. */
+export function toAvantisSpelling(value) {
+  return String(value ?? '').replace(BRAND_TOKEN_RE, `$1${LEGACY_TOKEN}`);
+}
+
+/** `place_avantis_perps_order` -> `place_veranta_perps_order`. Other names pass through unchanged. */
+export function toVerantaSpelling(value) {
+  return String(value ?? '').replace(LEGACY_TOKEN_RE, `$1${BRAND_TOKEN}`);
+}
+
+/**
+ * The other spelling of a venue action name, or null when the name has no Avantis/Veranta token.
+ * Used to retry catalog resolution with the spelling the API in hand still uses.
+ */
+export function alternateVenueActionSpelling(value) {
+  const text = String(value ?? '');
+  if (hasVerantaToken(text)) return toAvantisSpelling(text);
+  if (hasAvantisToken(text)) return toVerantaSpelling(text);
+  return null;
+}
+
+/**
+ * Brand-insensitive action key for hardcoded CLI lists: trimmed, lowercased, Veranta mapped to the
+ * Avantis spelling. Separators are preserved; callers still pick `_` or `-`.
+ */
+export function toLegacyVenueActionKey(value) {
+  return toAvantisSpelling(String(value ?? '').trim().toLowerCase());
+}
+
+/**
+ * Normalize a provider or venue id the CLI reads from flags: trimmed, lowercased, and
+ * `veranta` / `veranta-vault` mapped to the internal `avantis` / `avantis-vault`.
+ */
+export function normalizeVenueProviderId(value) {
+  const id = String(value ?? '').trim().toLowerCase();
+  if (!id) return id;
+  return toAvantisSpelling(id);
+}

package/src/runtime/actions/selection.mjs

@@ -1,6 +1,12 @@
 import { requireFlag } from '../../core/args.mjs';
 import { getCachedActionsCatalog } from '../../core/context.mjs';
 import { suggestCatalogActions } from '../validation/actionParamsGate.mjs';
+import {
+  alternateVenueActionSpelling,
+  normalizeVenueProviderId,
+  toAvantisSpelling,
+  toLegacyVenueActionKey,
+} from '../../core/venueBrand.mjs';
 export function createActionSelection({ getTradingProviderHint, formatProviderAmbiguousActionHint, formatProviderUnknownActionHint }) {
 function getActionKey(action) {
   return String(action?.action || action?.id || action?.key || action?.name || '')
@@ -21,7 +27,8 @@ function formatActionList(items) {
 }
 
 function normalizeProviderId(value) {
-  return String(value || '').trim().toLowerCase();
+  // Lowercased id; `veranta` / `veranta-vault` map to the internal `avantis` / `avantis-vault`.
+  return normalizeVenueProviderId(value || '');
 }
 
 function rowActionKey(action) {
@@ -46,7 +53,8 @@ function canonicalizeCatalogActionKey(value) {
 function inferActionProvider(action) {
   // API catalog metadata (`providerId`, `domain`, `category`) is the source of truth.
   // This fallback only keeps older catalog rows / older API deployments discoverable.
-  const key = canonicalActionKey(action);
+  // Veranta action names infer like their Avantis spelling (`avantis` / `avantis-vault`).
+  const key = toLegacyVenueActionKey(canonicalActionKey(action));
   const knownMap = {
     swap: 'trading',
     'execute-optimal-swap': 'trading',
@@ -263,7 +271,8 @@ function isSpotTradingCatalogAction(action) {
 }
 
 function isProviderActionKey(action, provider) {
-  const actionKey = rowActionKey(action);
+  // Brand-insensitive: `place_veranta_perps_order` matches provider `avantis`.
+  const actionKey = toLegacyVenueActionKey(rowActionKey(action));
   const normalizedProvider = normalizeProviderId(provider).replace(/-/g, '_');
   if (!actionKey || !normalizedProvider) return false;
   return (
@@ -283,6 +292,7 @@ function actionMatchesProvider(action, requestedProvider, allActions) {
   if (requestedProvider === 'hyperliquid') return isProviderActionKey(action, 'hyperliquid');
   if (requestedProvider === 'lighter') return isProviderActionKey(action, 'lighter');
   if (requestedProvider === 'avantis') {
+    // Veranta (formerly Avantis) perps; `--provider veranta` normalizes to `avantis` before this runs.
     return isProviderActionKey(action, 'avantis') && !actionKey.includes('vault');
   }
   if (requestedProvider === 'polymarket') return isProviderActionKey(action, 'polymarket');
@@ -351,20 +361,12 @@ async function resolveActionSelection(ctx, flags) {
   return resolveActionFromRows(requestedAction, actions, flags);
 }
 
-function resolveActionFromRows(requestedAction, actions, flags = {}) {
+/**
+ * Exact catalog match for one spelling: canonical overrides, action id, `_`/`-` canonical id, then
+ * alias. Returns null when nothing matches; throws on ambiguity.
+ */
+function matchCatalogEntry(requestedAction, keyed, flags = {}) {
   const requestedLower = String(requestedAction || '').toLowerCase();
-  const keyed = actions
-    .map((action) => ({
-      key: getActionKey(action),
-      aliases: getActionAliases(action),
-      action,
-    }))
-    .filter((entry) => entry.key);
-
-  if (!keyed.length) {
-    return { requestedAction, resolvedAction: requestedAction, resolvedActionMeta: null, suggestions: [] };
-  }
-
   const canonicalAliasOverrides = {
     get_vaults_fyi_vaults: 'get-vaults-fyi-vaults',
     get_vaults_fyi_opportunities: 'get-vaults-fyi-vaults',
@@ -446,11 +448,47 @@ function resolveActionFromRows(requestedAction, actions, flags = {}) {
       )}.${formatProviderAmbiguousActionHint(providerHint)}`
     );
   }
+  return null;
+}
+
+function resolveActionFromRows(requestedAction, actions, flags = {}) {
+  const requestedLower = String(requestedAction || '').toLowerCase();
+  const keyed = actions
+    .map((action) => ({
+      key: getActionKey(action),
+      aliases: getActionAliases(action),
+      action,
+    }))
+    .filter((entry) => entry.key);
+
+  if (!keyed.length) {
+    // No catalog to check against: send the Avantis spelling of a Veranta name, which every API
+    // deployment accepts (older ones only know `*_avantis_*`; newer ones keep it as an alias).
+    return {
+      requestedAction,
+      resolvedAction: alternateVenueActionSpelling(requestedAction) ? toAvantisSpelling(requestedAction) : requestedAction,
+      resolvedActionMeta: null,
+      suggestions: [],
+    };
+  }
+
+  const direct = matchCatalogEntry(requestedAction, keyed, flags);
+  if (direct) return direct;
+
+  // Veranta (formerly Avantis): retry with the other spelling so `place_veranta_perps_order` finds the
+  // `place_avantis_perps_order` row on an API that has not shipped Veranta names, and the reverse.
+  const alternate = alternateVenueActionSpelling(requestedAction);
+  if (alternate) {
+    const viaAlternate = matchCatalogEntry(alternate, keyed, flags);
+    if (viaAlternate) return { ...viaAlternate, requestedAction };
+  }
+  const alternateLower = alternate ? alternate.toLowerCase() : null;
 
+  const fuzzyNeedles = alternateLower ? [requestedLower, alternateLower] : [requestedLower];
   const fuzzy = keyed.filter(
     (entry) =>
-      entry.key.toLowerCase().includes(requestedLower) ||
-      entry.aliases.some((a) => a.toLowerCase().includes(requestedLower))
+      fuzzyNeedles.some((needle) => entry.key.toLowerCase().includes(needle)) ||
+      entry.aliases.some((a) => fuzzyNeedles.some((needle) => a.toLowerCase().includes(needle)))
   );
   if (fuzzy.length === 1) {
     return { requestedAction, resolvedAction: fuzzy[0].key, resolvedActionMeta: fuzzy[0].action || null };

package/src/runtime/certification/executionCertify.mjs

@@ -3,6 +3,7 @@ import { createHash } from 'node:crypto';
 import { CLI_MANIFEST } from '../../cli/manifest.mjs';
 import { validateParamsSchema, sanitizeParamsForSchemaValidation } from '../validation/paramsSchema.mjs';
 import { VENUE_WRITE_ACTION_FIXTURES } from './venueActionSchemas.mjs';
+import { toLegacyVenueActionKey } from '../../core/venueBrand.mjs';
 
 const require = createRequire(import.meta.url);
 
@@ -23,7 +24,8 @@ const AUTHORITY_INPUT_CHECKS = [
 ];
 
 function normalizeActionKey(action) {
-  return String(action || '').trim().replace(/_/g, '-').toLowerCase();
+  // Brand-insensitive: a live `place_veranta_perps_order` row replaces the `place_avantis_perps_order` fixture.
+  return toLegacyVenueActionKey(action).replace(/_/g, '-');
 }
 
 function isWriteAction(action) {

package/src/runtime/certification/venueActionSchemas.mjs

@@ -218,8 +218,10 @@ export const VENUE_WRITE_ACTION_FIXTURES = [
     validSample: { orderId: '0xabc' },
   },
   {
+    // Veranta (formerly Avantis). Fixture ids keep the Avantis spelling so the default schema digest
+    // is unchanged; the Veranta names are aliases.
     action: 'place_avantis_perps_order',
-    aliases: ['place-avantis-perps-order'],
+    aliases: ['place-avantis-perps-order', 'place_veranta_perps_order', 'place-veranta-perps-order'],
     provider: 'avantis',
     authorityInputs: ['agentApiKey', 'estimatedAmountUsd'],
     paramsSchema: {
@@ -249,7 +251,7 @@ export const VENUE_WRITE_ACTION_FIXTURES = [
   },
   {
     action: 'cancel_avantis_perps_order',
-    aliases: ['cancel-avantis-perps-order'],
+    aliases: ['cancel-avantis-perps-order', 'cancel_veranta_perps_order', 'cancel-veranta-perps-order'],
     provider: 'avantis',
     authorityInputs: ['agentApiKey'],
     paramsSchema: {
@@ -267,7 +269,7 @@ export const VENUE_WRITE_ACTION_FIXTURES = [
   },
   {
     action: 'close_avantis_position',
-    aliases: ['close-avantis-position'],
+    aliases: ['close-avantis-position', 'close_veranta_position', 'close-veranta-position'],
     provider: 'avantis',
     authorityInputs: ['agentApiKey', 'estimatedAmountUsd'],
     paramsSchema: {

package/src/runtime/execution/lanes.mjs

@@ -1,4 +1,5 @@
 import { createCliError } from '../../core/envelope.mjs';
+import { toLegacyVenueActionKey } from '../../core/venueBrand.mjs';
 export function createExecutionLanes() {
 const OFFCHAIN_VENUE_ORDER_ACTIONS = new Set([
   'place_hyperliquid_perps_order',
@@ -29,6 +30,7 @@ const OFFCHAIN_VENUE_ORDER_ACTIONS = new Set([
   'condor-executor-create',
   'condor_executor_stop',
   'condor-executor-stop',
+  // Veranta (formerly Avantis): keyed by the Avantis spelling; Veranta names map onto it below.
   'place_avantis_perps_order',
   'place-avantis-perps-order',
   'cancel_avantis_perps_order',
@@ -57,11 +59,11 @@ const OFFCHAIN_VENUE_ORDER_ACTIONS = new Set([
   'cancel-avantis-mm-order',
 ]);
 function enforceOffchainVenueLaneCompatibility(action, runMode) {
-  const normalizedAction = String(action || '').trim().toLowerCase();
+  const normalizedAction = toLegacyVenueActionKey(action);
   if (runMode !== 'self' || !OFFCHAIN_VENUE_ORDER_ACTIONS.has(normalizedAction)) return;
   throw createCliError(
     'OFFCHAIN_VENUE_ORDER_SELF_UNSUPPORTED',
-    'Polymarket CLOB, Hyperliquid perps, Lighter perps, Avantis perps, Hummingbot executor, and Condor executor actions are offchain signed API actions, not EVM build-tx actions. Use self for setup/funding signatures, then run venue orders with --run-mode thirdfy, --run-mode hybrid, or --run-mode agent_wallet.',
+    'Polymarket CLOB, Hyperliquid perps, Lighter perps, Veranta perps, Hummingbot executor, and Condor executor actions are offchain signed API actions, not EVM build-tx actions. Use self for setup/funding signatures, then run venue orders with --run-mode thirdfy, --run-mode hybrid, or --run-mode agent_wallet.',
     {
       recommendedRunModes: ['thirdfy', 'hybrid', 'agent_wallet'],
       setupOnlyRunMode: 'self',

package/src/runtime/execution/payloads.mjs

@@ -4,6 +4,7 @@ import { resolveExecutionContextFromEnv } from '../../core/executionContext.mjs'
 import { requireFlag, parseJsonFlag } from '../../core/args.mjs';
 import { loadProfileConfig } from '../../core/context.mjs';
 import { createCliError } from '../../core/envelope.mjs';
+import { toLegacyVenueActionKey } from '../../core/venueBrand.mjs';
 import { normalizeRunMode, normalizeManagedRunMode, normalizeHybridWalletMode } from '../../core/runMode.mjs';
 import { assertHostedRuntimePolymarketWriteIdempotency } from './hostedRuntimeWriteGate.mjs';
 import { resolveTokenInForFunding } from '../../core/fundingTokenIn.mjs';
@@ -29,10 +30,8 @@ export function mergeConfirmWritesIntoParams(params, flags) {
 export function resolveExecuteEstimatedAmountUsd(action, flags) {
   const fromFlags = Number(flags?.estimatedAmountUsd);
   if (Number.isFinite(fromFlags) && fromFlags > 0) return fromFlags;
-  const key = String(action || '')
-    .trim()
-    .toLowerCase()
-    .replace(/-/g, '_');
+  const key = toLegacyVenueActionKey(action).replace(/-/g, '_');
+  // Veranta onboarding (either spelling).
   if (key === 'complete_avantis_onboarding') return 1;
   return undefined;
 }

package/src/runtime/execution/runners.mjs

@@ -527,7 +527,7 @@ async function executeManagedWalletRun(ctx, flags, resolved, options) {
   // (often as a JSON string under data.result). Reads skip funding gates; routing still fails closed.
   const isRead = isReadOnlyAction(resolved);
   const skipPreflight = Boolean(options?.skipPreflight);
-  // A seeded preflight (Hyperliquid/Lighter/Avantis address defaults) already ran; reuse it.
+  // A seeded preflight (Hyperliquid/Lighter/Veranta address defaults) already ran; reuse it.
   const readFastPath =
     !skipPreflight && !options?.managedPreflight && shouldUseManagedReadFastPath(flags, resolved, options);
   let preflight = readFastPath ? READ_FAST_PATH_PREFLIGHT : null;

package/src/runtime/providerHints.mjs

@@ -1,9 +1,27 @@
+import { normalizeVenueProviderId } from '../core/venueBrand.mjs';
+
+/**
+ * Veranta (formerly Avantis) naming for the `avantis` / `avantis-vault` hints, static or from the
+ * capabilities manifest. Empty for every other provider.
+ */
+function verantaNamingFields(provider) {
+  if (provider !== 'avantis' && provider !== 'avantis-vault') return {};
+  const alias = provider === 'avantis' ? 'veranta' : 'veranta-vault';
+  return {
+    displayName: 'Veranta',
+    formerName: 'Avantis',
+    providerAliases: [alias],
+    actionNaming: `Veranta (formerly Avantis). Veranta action names (*_veranta_*) are canonical; Avantis names (*_avantis_*) still resolve. Provider id stays ${provider}; --provider ${alias} is an alias.`,
+  };
+}
+
 /**
  * Static and capabilities-backed provider discovery hints for CLI actions filtering.
  */
 export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
   function getTradingProviderHint(providerId) {
-    const provider = String(providerId || '').trim().toLowerCase();
+    // `veranta` / `veranta-vault` resolve to the internal `avantis` / `avantis-vault` hints.
+    const provider = normalizeVenueProviderId(providerId || '');
     const manifestHint = getCachedProviderHintFromCapabilities(provider);
     const setupHints =
       manifestHint?.setupHints && typeof manifestHint.setupHints === 'object' ? manifestHint.setupHints : {};
@@ -206,68 +224,69 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
     if (provider === 'avantis') {
       return {
         provider,
+        ...verantaNamingFields(provider),
         category: 'leveraged_perps',
-        canonicalWriteAction: 'place_avantis_perps_order',
+        canonicalWriteAction: 'place_veranta_perps_order',
         readActions: [
-          'get_avantis_markets',
-          'get_avantis_pair',
-          'get_avantis_price',
-          'get_avantis_spread',
-          'get_avantis_positions',
-          'get_avantis_open_orders',
-          'get_avantis_allowance',
-          'get_avantis_delegation_status',
-          'get_avantis_funding_status',
-          'get_avantis_setup_status',
-          'get_avantis_onboarding_plan',
-          'get_avantis_builder_fee_status',
-          'get_avantis_referral_status',
-          'get_avantis_referral_stats',
+          'get_veranta_markets',
+          'get_veranta_pair',
+          'get_veranta_price',
+          'get_veranta_spread',
+          'get_veranta_positions',
+          'get_veranta_open_orders',
+          'get_veranta_allowance',
+          'get_veranta_delegation_status',
+          'get_veranta_funding_status',
+          'get_veranta_setup_status',
+          'get_veranta_onboarding_plan',
+          'get_veranta_builder_fee_status',
+          'get_veranta_referral_status',
+          'get_veranta_referral_stats',
         ],
         orderManagementActions: [
-          'place_avantis_perps_order',
-          'cancel_avantis_perps_order',
-          'close_avantis_position',
-          'update_avantis_tp_sl',
-          'cancel_avantis_tp_sl',
-          'place_avantis_twap_order',
-          'close_avantis_twap_order',
-          'cancel_avantis_twap_order',
-          'place_avantis_coin_perps_order',
-          'increase_avantis_coin_position',
-          'close_avantis_coin_position',
-          'place_avantis_mm_order',
-          'cancel_avantis_mm_order',
-          'get_avantis_open_orders',
-          'get_avantis_positions',
+          'place_veranta_perps_order',
+          'cancel_veranta_perps_order',
+          'close_veranta_position',
+          'update_veranta_tp_sl',
+          'cancel_veranta_tp_sl',
+          'place_veranta_twap_order',
+          'close_veranta_twap_order',
+          'cancel_veranta_twap_order',
+          'place_veranta_coin_perps_order',
+          'increase_veranta_coin_position',
+          'close_veranta_coin_position',
+          'place_veranta_mm_order',
+          'cancel_veranta_mm_order',
+          'get_veranta_open_orders',
+          'get_veranta_positions',
         ],
         setupActions: [
-          'get_avantis_funding_status',
-          'get_avantis_setup_status',
-          'get_avantis_onboarding_plan',
-          'prepare_avantis_onboarding',
-          'complete_avantis_onboarding',
-          'approve_avantis_builder_fee',
-          'revoke_avantis_builder_fee',
-          'set_avantis_referral_code',
-          'register_avantis_referral_code',
-          'claim_avantis_referral_rebate',
+          'get_veranta_funding_status',
+          'get_veranta_setup_status',
+          'get_veranta_onboarding_plan',
+          'prepare_veranta_onboarding',
+          'complete_veranta_onboarding',
+          'approve_veranta_builder_fee',
+          'revoke_veranta_builder_fee',
+          'set_veranta_referral_code',
+          'register_veranta_referral_code',
+          'claim_veranta_referral_rebate',
         ],
         statusActions: [
-          'get_avantis_funding_status',
-          'get_avantis_setup_status',
-          'get_avantis_builder_fee_status',
-          'get_avantis_delegation_status',
+          'get_veranta_funding_status',
+          'get_veranta_setup_status',
+          'get_veranta_builder_fee_status',
+          'get_veranta_delegation_status',
         ],
         recoveryActions: [
-          'get_avantis_positions',
-          'close_avantis_position',
+          'get_veranta_positions',
+          'close_veranta_position',
         ],
         decommissionExample:
-          'get_avantis_positions -> close_avantis_position -> withdraw-to-user on execution wallet (Base USDC)',
+          'get_veranta_positions -> close_veranta_position -> withdraw-to-user on execution wallet (Base USDC)',
         credentialType: 'avantis_delegate',
         credentialUx:
-          'Thirdfy mints and stores the encrypted Avantis delegate. CLI callers use Thirdfy auth only. Do not paste a private key.',
+          'Thirdfy mints and stores the encrypted Veranta delegate. CLI callers use Thirdfy auth only. Do not paste a private key.',
         recommendedFundingChainId: 8453,
         supportedFundingSourceChains: [
           { chainId: 8453, name: 'Base', path: 'native USDC in managed execution wallet (recommended)' },
@@ -283,32 +302,33 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
         funding:
           'Fund the managed execution wallet on Base (8453) with native USDC. Minimum collateral follows the live catalog notional floor.',
         laneCompatibility:
-          'Use agent_wallet for solo managed-wallet onboarding and perps writes after avantis_delegate credential is stored. Use thirdfy or hybrid for delegated capital. Thirdfy builds EIP-712 intents; the delegate credential signs batched-market submissions. Relayer is default. Builder-fee collection stays unwired until Avantis supplies a fee-enabled template.',
+          'Use agent_wallet for solo managed-wallet onboarding and perps writes after avantis_delegate credential is stored. Use thirdfy or hybrid for delegated capital. Thirdfy builds EIP-712 intents; the delegate credential signs batched-market submissions. Relayer is default. Builder-fee collection stays unwired until Veranta supplies a fee-enabled template.',
         setupExample:
-          'actions --provider avantis -> get_avantis_funding_status -> complete_avantis_onboarding (agent_wallet on Base 8453) -> get_avantis_setup_status before place_avantis_perps_order. Do not call approve_avantis_builder_fee until setup status shows a wired template.',
+          'actions --provider veranta -> get_veranta_funding_status -> complete_veranta_onboarding (agent_wallet on Base 8453) -> get_veranta_setup_status before place_veranta_perps_order. Do not call approve_veranta_builder_fee until setup status shows a wired template.',
         example:
-          'thirdfy-agent actions --provider avantis && thirdfy-agent preflight --action place_avantis_perps_order --params \'{"pairIndex":0,"side":"long","collateralUsdc":10,"leverage":10,"orderType":"market"}\'',
+          'thirdfy-agent actions --provider veranta && thirdfy-agent preflight --action place_veranta_perps_order --params \'{"pairIndex":0,"side":"long","collateralUsdc":10,"leverage":10,"orderType":"market"}\'',
       };
     }
     if (provider === 'avantis-vault') {
       return {
         provider,
+        ...verantaNamingFields(provider),
         category: 'earn',
-        canonicalReadAction: 'get_avantis_vault_info',
-        canonicalWriteAction: 'deposit_avantis_vault',
-        readActions: ['get_avantis_vault_info', 'get_avantis_vault_position'],
+        canonicalReadAction: 'get_veranta_vault_info',
+        canonicalWriteAction: 'deposit_veranta_vault',
+        readActions: ['get_veranta_vault_info', 'get_veranta_vault_position'],
         orderManagementActions: [
-          'deposit_avantis_vault',
-          'request_avantis_vault_withdrawal',
-          'redeem_avantis_vault',
-          'claim_avantis_vault',
+          'deposit_veranta_vault',
+          'request_veranta_vault_withdrawal',
+          'redeem_veranta_vault',
+          'claim_veranta_vault',
         ],
         recommendedFundingChainId: 8453,
         supportedChains: [8453],
         funding: 'Fund the managed execution wallet on Base with native USDC before vault deposit.',
-        laneCompatibility: 'Avantis LP vault on Base. Use agent_wallet, thirdfy, or hybrid. Relayer is default.',
+        laneCompatibility: 'Veranta (formerly Avantis) LP vault on Base. Use agent_wallet, thirdfy, or hybrid. Relayer is default.',
         example:
-          'thirdfy-agent actions --provider avantis-vault && thirdfy-agent run --action get_avantis_vault_info --provider avantis-vault --json',
+          'thirdfy-agent actions --provider veranta-vault && thirdfy-agent run --action get_veranta_vault_info --provider veranta-vault --json',
       };
     }
     if (provider === 'bitfinex') {
@@ -901,12 +921,12 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
   }
 
   function getCachedProviderHintFromCapabilities(provider) {
-    const normalizedProvider = String(provider || '').trim().toLowerCase();
+    const normalizedProvider = normalizeVenueProviderId(provider || '');
     if (!normalizedProvider) return null;
     const manifests = Array.isArray(getNegotiatedCapabilitiesCache()?.providers?.manifests)
       ? getNegotiatedCapabilitiesCache().providers.manifests
       : [];
-    const match = manifests.find((entry) => String(entry?.providerId || '').trim().toLowerCase() === normalizedProvider);
+    const match = manifests.find((entry) => normalizeVenueProviderId(entry?.providerId || '') === normalizedProvider);
     if (!match) return null;
     const canonicalWriteActions = {
       trading: 'swap',
@@ -958,13 +978,20 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
       custodyMode: match.custodyMode || null,
       description: match.description || null,
       source: 'cli_capabilities_manifest',
+      ...verantaNamingFields(normalizedProvider),
       ...(match.setupHints && typeof match.setupHints === 'object' ? { setupHints: match.setupHints } : {}),
     };
   }
 
+  // Veranta hints carry `providerAliases`; show the public name in messages (`--provider veranta`).
+  function providerLabelForHint(providerHint) {
+    const alias = Array.isArray(providerHint?.providerAliases) ? providerHint.providerAliases[0] : null;
+    return alias || providerHint.provider;
+  }
+
   function formatProviderAmbiguousActionHint(providerHint) {
     if (!providerHint) return '';
-    const p = providerHint.provider;
+    const p = providerLabelForHint(providerHint);
     const w = providerHint.canonicalWriteAction;
     if (w) return ` Provider ${p} expects ${w}.`;
     return ` Provider ${p} did not declare a canonical write action in capabilities; run actions --provider ${p} first.`;
@@ -972,7 +999,7 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
 
   function formatProviderUnknownActionHint(providerHint) {
     if (!providerHint) return '';
-    const p = providerHint.provider;
+    const p = providerLabelForHint(providerHint);
     const w = providerHint.canonicalWriteAction;
     if (w) return ` Provider ${p} expects ${w}; run actions --provider ${p} first.`;
     return ` Provider ${p} did not declare a canonical write action in capabilities; run actions --provider ${p} first.`;