@thirdfy/agent-cli 0.2.57 → 0.2.59

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `@thirdfy/agent-cli` are documented here. The format is b
 
 ## [Unreleased]
 
+## [0.2.59] - 2026-09-05
+
+### Added
+
+- `avantis` and `avantis-vault` provider hints, venue tooling (`venue readiness|setup|fund avantis`), and [`docs/providers/avantis.md`](./docs/providers/avantis.md). `get_avantis_*` actions classify as read-only. Place-order examples use Avantis `side` (`long`/`short`), not Hyperliquid `isBuy`. `agent_wallet` fills missing `traderAddress` on setup and status reads. Thirdfy mints the encrypted `avantis_delegate` credential. Do not paste a venue private key. Pairs with `thirdfy-mcp` **0.0.107** and Thirdfy API **3.14.21**.
+
+## [0.2.58] - 2026-09-05
+
+### Fixed
+
+- `basedbid_buy` managed-wallet preflight no longer treats listing `tokenAddress` as an ERC-20 `tokenIn`. Buy spends native ETH, so a zero listing-token balance no longer blocks a funded wallet. `basedbid_sell` and earn deposits still fund from `tokenAddress`. Pairs with `thirdfy-mcp` **0.0.106**.
+
 ## [0.2.57] - 2026-09-04
 
 ### Added

package/README.md

@@ -40,9 +40,11 @@ Run without global install:
 npx @thirdfy/agent-cli --help
 ```
 
-## What's new in v0.2.57
+## What's new in v0.2.59
 
-- `basedbid` provider hints and [`docs/providers/basedbid.md`](./docs/providers/basedbid.md). `basedbid_get_tokens` is read-only. LBP and flash create are writes on Base, Ethereum, and Robinhood Chain. Buy and sell are writes on Base. Board, fee claim, and hook writes stay fail-closed.
+- Avantis Base perps: discover markets, complete onboarding on `agent_wallet`, then place or close with `side` `long` or `short`.
+- Thirdfy mints and stores the `avantis_delegate` credential. Do not paste a venue private key.
+- Venue tooling: `venue readiness`, `venue setup`, and `venue fund` for `avantis`.
 - See [CHANGELOG.md](./CHANGELOG.md) and GitHub Releases for older versions.
 
 ## Quick start
@@ -322,6 +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`)
 - 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.57",
+  "version": "0.2.59",
   "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)',
+    description: 'Normalized venue readiness (polymarket, hyperliquid, lighter, avantis)',
     args: { query: true },
     tier: 'online',
   },

package/src/commands/avantis.mjs

@@ -0,0 +1,53 @@
+export function createAvantisHelpers(deps) {
+  const { getPreparedParams, resolveManagedExecutionPreflight } = deps;
+
+  function avantisDefaultAddressParamForAction(action) {
+    const canonical = String(action || '')
+      .trim()
+      .toLowerCase()
+      .replace(/_/g, '-');
+    if (
+      canonical === 'get-avantis-open-orders' ||
+      canonical === 'get-avantis-positions' ||
+      canonical === 'get-avantis-allowance' ||
+      canonical === 'get-avantis-delegation-status' ||
+      canonical === 'get-avantis-setup-status' ||
+      canonical === 'get-avantis-funding-status' ||
+      canonical === 'get-avantis-onboarding-plan' ||
+      canonical === 'get-avantis-builder-fee-status' ||
+      canonical === 'get-avantis-referral-status' ||
+      canonical === 'get-avantis-referral-stats' ||
+      canonical === 'prepare-avantis-onboarding' ||
+      canonical === 'complete-avantis-onboarding'
+    ) {
+      return 'traderAddress';
+    }
+    return null;
+  }
+
+  async function applyAvantisAgentWalletAddressDefault(ctx, flags, resolved, runMode) {
+    if (runMode !== 'agent_wallet') return null;
+    const paramName = avantisDefaultAddressParamForAction(resolved?.resolvedAction);
+    if (!paramName) return null;
+    const params = getPreparedParams(flags);
+    if (String(params?.[paramName] || '').trim()) return null;
+    if (String(params?.mainWalletAddress || params?.walletAddress || params?.userAddress || '').trim()) {
+      return null;
+    }
+    const preflight = await resolveManagedExecutionPreflight(ctx, flags, resolved, {
+      runMode: 'agent_wallet',
+      requireFundingCheck: false,
+    });
+    if (!preflight.success || !preflight.executionWalletAddress) return preflight;
+    flags.__preparedParams = {
+      ...(params || {}),
+      [paramName]: preflight.executionWalletAddress,
+    };
+    return preflight;
+  }
+
+  return {
+    avantisDefaultAddressParamForAction,
+    applyAvantisAgentWalletAddressDefault,
+  };
+}

package/src/commands/execute.mjs

@@ -21,6 +21,7 @@ export function createExecuteCommands(deps) {
     enforceChainCompatibility,
     applyHyperliquidAgentWalletAddressDefault,
     applyLighterAgentWalletAddressDefault,
+    applyAvantisAgentWalletAddressDefault,
     runPreflightByMode,
     runExecutionByMode,
     applyExecutionFallbackHints,
@@ -43,7 +44,8 @@ async function commandPreflight(ctx, flags, capabilities) {
   enforceChainCompatibility(capabilities, flags, runMode);
   const managedPreflight =
     (await applyHyperliquidAgentWalletAddressDefault(ctx, flags, resolved, runMode))
-    || (await applyLighterAgentWalletAddressDefault(ctx, flags, resolved, runMode));
+    || (await applyLighterAgentWalletAddressDefault(ctx, flags, resolved, runMode))
+    || (await applyAvantisAgentWalletAddressDefault(ctx, flags, resolved, runMode));
   const backendResult = await runPreflightByMode(runMode, ctx, flags, resolved, { hybridWalletMode, managedPreflight });
   const normalized = applyExecutionFallbackHints(backendResult.normalized, {
     flags,
@@ -96,7 +98,8 @@ async function commandRun(ctx, flags, capabilities) {
   enforceChainCompatibility(capabilities, flags, runMode);
   const managedPreflight =
     (await applyHyperliquidAgentWalletAddressDefault(ctx, flags, resolved, runMode))
-    || (await applyLighterAgentWalletAddressDefault(ctx, flags, resolved, runMode));
+    || (await applyLighterAgentWalletAddressDefault(ctx, flags, resolved, runMode))
+    || (await applyAvantisAgentWalletAddressDefault(ctx, flags, resolved, runMode));
   const skipPreflight = Boolean(flags.skipPreflight);
   const backendResult = await runExecutionByMode(runMode, ctx, flags, resolved, {
     skipPreflight,

package/src/commands/index.mjs

@@ -1,6 +1,7 @@
 export { createPolymarketCommands, resolveConfigAgentKey } from './polymarket.mjs';
 export { createHyperliquidHelpers } from './hyperliquid.mjs';
 export { createLighterHelpers } from './lighter.mjs';
+export { createAvantisHelpers } from './avantis.mjs';
 export { createHummingbotCommands } from './hummingbot.mjs';
 export { createCondorCommands } from './condor.mjs';
 export { createExecuteCommands } from './execute.mjs';

package/src/commands/venue.mjs

@@ -1,13 +1,13 @@
 import { apiGet, apiPost } from '../core/http.mjs';
 import { loadProfileConfig } from '../core/context.mjs';
 
-const VENUES = new Set(['polymarket', 'hyperliquid', 'lighter']);
+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();
   if (!VENUES.has(venue)) {
-    throw new Error(`Unsupported venue "${venue}". Use polymarket, hyperliquid, or lighter.`);
+    throw new Error(`Unsupported venue "${venue}". Use polymarket, hyperliquid, lighter, or avantis.`);
   }
   return venue;
 }

package/src/commands/wallet.mjs

@@ -11,6 +11,7 @@ export function createWalletCommands(deps) {
     enforceChainCompatibility,
     applyHyperliquidAgentWalletAddressDefault,
     applyLighterAgentWalletAddressDefault,
+    applyAvantisAgentWalletAddressDefault,
     executeManagedWalletRun,
     executeSelfRun,
     submitSignedTx,
@@ -26,7 +27,8 @@ async function commandWalletExecute(ctx, flags, capabilities) {
   enforceChainCompatibility(capabilities, normalizedFlags, 'agent_wallet');
   const managedPreflight =
     (await applyHyperliquidAgentWalletAddressDefault(ctx, normalizedFlags, resolved, 'agent_wallet'))
-    || (await applyLighterAgentWalletAddressDefault(ctx, normalizedFlags, resolved, 'agent_wallet'));
+    || (await applyLighterAgentWalletAddressDefault(ctx, normalizedFlags, resolved, 'agent_wallet'))
+    || (await applyAvantisAgentWalletAddressDefault(ctx, normalizedFlags, resolved, 'agent_wallet'));
   const skipPreflight = Boolean(normalizedFlags.skipPreflight);
   const result = await executeManagedWalletRun(ctx, normalizedFlags, resolved, { skipPreflight, managedPreflight });
   printEnvelope({

package/src/core/actionTimeouts.mjs

@@ -1,6 +1,7 @@
 import { DEFAULT_TIMEOUT_MS } from './constants.mjs';
 
 const LONG_RUNNING_ACTIONS = new Set([
+  'complete_avantis_onboarding',
   'complete_lighter_onboarding',
   'setup_lighter_api_key',
   'register_lighter_api_key',

package/src/core/fundingTokenIn.mjs

@@ -0,0 +1,22 @@
+import { normalizeActionKey } from './readOnlyActions.mjs';
+
+/**
+ * Native-ETH spends pass `tokenAddress` as the listing or output, not the funding ERC-20.
+ * Sending that address as execution-wallet `tokenIn` checks the wrong balance and blocks buys.
+ */
+const NATIVE_ETH_SPEND_ACTIONS = new Set([
+  'basedbid_buy',
+  'basedbid_create_lbp',
+  'basedbid_create_flash',
+  'basedbid_create_board',
+]);
+
+export function resolveTokenInForFunding(params, action) {
+  if (!params || typeof params !== 'object') return '';
+  const explicit = String(params.tokenIn || '').trim();
+  if (explicit) return explicit;
+  const actionId = normalizeActionKey(action);
+  if (NATIVE_ETH_SPEND_ACTIONS.has(actionId)) return '';
+  if (params.amountEth != null && String(params.amountEth).trim() !== '') return '';
+  return String(params.tokenAddress || params.token || '').trim();
+}

package/src/runtime/actions/selection.mjs

@@ -182,6 +182,8 @@ function inferActionProvider(action) {
   if (knownMap[key]) return knownMap[key];
   if (key.includes('hyperliquid')) return 'hyperliquid';
   if (key.includes('lighter')) return 'lighter';
+  if (key.includes('avantis') && key.includes('vault')) return 'avantis-vault';
+  if (key.includes('avantis')) return 'avantis';
   if (key.includes('bitfinex')) return 'bitfinex';
   if (key.includes('polymarket') || key.includes('prediction')) return 'polymarket';
   if (key.includes('vaults-fyi')) return 'vaults-fyi';
@@ -257,6 +259,9 @@ function actionMatchesProvider(action, requestedProvider, allActions) {
   // Here resolved metadata already disagrees with the filter; fall back to action-key shape only.
   if (requestedProvider === 'hyperliquid') return isProviderActionKey(action, 'hyperliquid');
   if (requestedProvider === 'lighter') return isProviderActionKey(action, 'lighter');
+  if (requestedProvider === 'avantis') {
+    return isProviderActionKey(action, 'avantis') && !actionKey.includes('vault');
+  }
   if (requestedProvider === 'polymarket') return isProviderActionKey(action, 'polymarket');
   if (requestedProvider === 'bridge') {
     // Hyperliquid Bridge2 and Lighter CCTP setup actions are owned by their perps providers, not cross-chain bridge.

package/src/runtime/certification/venueActionSchemas.mjs

@@ -182,6 +182,74 @@ export const VENUE_WRITE_ACTION_FIXTURES = [
     },
     validSample: { orderId: '0xabc' },
   },
+  {
+    action: 'place_avantis_perps_order',
+    aliases: ['place-avantis-perps-order'],
+    provider: 'avantis',
+    authorityInputs: ['agentApiKey', 'estimatedAmountUsd'],
+    paramsSchema: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['pairIndex', 'side', 'collateralUsdc', 'leverage'],
+      properties: {
+        pairIndex: { type: 'integer', minimum: 0 },
+        pair: { type: 'string', minLength: 1 },
+        side: { type: 'string', enum: ['long', 'short'] },
+        orderType: { type: 'string', enum: ['market', 'limit'] },
+        collateralUsdc: { type: 'number', minimum: 0 },
+        leverage: { type: 'number', minimum: 0 },
+        limitPrice: { type: 'number', minimum: 0 },
+        slippagePercent: { type: 'number', minimum: 0, maximum: 100 },
+        executionMode: { type: 'string', enum: ['relayer', 'direct'] },
+        confirmWrites: { type: 'boolean' },
+      },
+    },
+    validSample: {
+      pairIndex: 0,
+      side: 'long',
+      collateralUsdc: 10,
+      leverage: 10,
+      orderType: 'market',
+    },
+  },
+  {
+    action: 'cancel_avantis_perps_order',
+    aliases: ['cancel-avantis-perps-order'],
+    provider: 'avantis',
+    authorityInputs: ['agentApiKey'],
+    paramsSchema: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['pairIndex', 'orderIndex'],
+      properties: {
+        pairIndex: { type: 'integer', minimum: 0 },
+        orderIndex: { type: 'integer', minimum: 0 },
+        executionMode: { type: 'string', enum: ['relayer', 'direct'] },
+        confirmWrites: { type: 'boolean' },
+      },
+    },
+    validSample: { pairIndex: 0, orderIndex: 1 },
+  },
+  {
+    action: 'close_avantis_position',
+    aliases: ['close-avantis-position'],
+    provider: 'avantis',
+    authorityInputs: ['agentApiKey', 'estimatedAmountUsd'],
+    paramsSchema: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['pairIndex', 'tradeIndex'],
+      properties: {
+        pairIndex: { type: 'integer', minimum: 0 },
+        tradeIndex: { type: 'integer', minimum: 0 },
+        collateralToCloseUsdc: { type: 'number', minimum: 0 },
+        slippagePercent: { type: 'number', minimum: 0, maximum: 100 },
+        executionMode: { type: 'string', enum: ['relayer', 'direct'] },
+        confirmWrites: { type: 'boolean' },
+      },
+    },
+    validSample: { pairIndex: 0, tradeIndex: 0 },
+  },
 ];
 
 export function fixtureCatalogActions() {

package/src/runtime/execution/lanes.mjs

@@ -27,13 +27,39 @@ const OFFCHAIN_VENUE_ORDER_ACTIONS = new Set([
   'condor-executor-create',
   'condor_executor_stop',
   'condor-executor-stop',
+  'place_avantis_perps_order',
+  'place-avantis-perps-order',
+  'cancel_avantis_perps_order',
+  'cancel-avantis-perps-order',
+  'close_avantis_position',
+  'close-avantis-position',
+  'update_avantis_tp_sl',
+  'update-avantis-tp-sl',
+  'cancel_avantis_tp_sl',
+  'cancel-avantis-tp-sl',
+  'place_avantis_twap_order',
+  'place-avantis-twap-order',
+  'close_avantis_twap_order',
+  'close-avantis-twap-order',
+  'cancel_avantis_twap_order',
+  'cancel-avantis-twap-order',
+  'place_avantis_coin_perps_order',
+  'place-avantis-coin-perps-order',
+  'increase_avantis_coin_position',
+  'increase-avantis-coin-position',
+  'close_avantis_coin_position',
+  'close-avantis-coin-position',
+  'place_avantis_mm_order',
+  'place-avantis-mm-order',
+  'cancel_avantis_mm_order',
+  'cancel-avantis-mm-order',
 ]);
 function enforceOffchainVenueLaneCompatibility(action, runMode) {
   const normalizedAction = String(action || '').trim().toLowerCase();
   if (runMode !== 'self' || !OFFCHAIN_VENUE_ORDER_ACTIONS.has(normalizedAction)) return;
   throw createCliError(
     'OFFCHAIN_VENUE_ORDER_SELF_UNSUPPORTED',
-    'Polymarket CLOB, Hyperliquid perps, Lighter 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, 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.',
     {
       recommendedRunModes: ['thirdfy', 'hybrid', 'agent_wallet'],
       setupOnlyRunMode: 'self',

package/src/runtime/execution/payloads.mjs

@@ -4,6 +4,7 @@ import { loadProfileConfig } from '../../core/context.mjs';
 import { createCliError } from '../../core/envelope.mjs';
 import { normalizeRunMode, normalizeManagedRunMode, normalizeHybridWalletMode } from '../../core/runMode.mjs';
 import { assertEarnclawPolymarketWriteIdempotency } from './earnclawRuntimeWriteGate.mjs';
+import { resolveTokenInForFunding } from '../../core/fundingTokenIn.mjs';
 export function createExecutionPayloads({ getPreparedParams, rawUnitsToDecimalString }) {
 function buildBuildTxPayload(flags, resolvedAction) {
   const runMode = String(flags.runMode || '').trim().toLowerCase() || 'self';
@@ -134,12 +135,6 @@ function buildManagedExecutePayload(flags, options) {
   return payload;
 }
 
-function resolveTokenInForFunding(params) {
-  if (!params || typeof params !== 'object') return '';
-  const tokenIn = String(params.tokenIn || params.tokenAddress || params.token || '').trim();
-  return tokenIn;
-}
-
 function buildIntentPayload(flags, options) {
   const runMode = String(options.runMode || flags.runMode || '').trim().toLowerCase() || 'thirdfy';
   const payload = {

package/src/runtime/execution/runners.mjs

@@ -650,7 +650,10 @@ async function resolveManagedExecutionPreflight(ctx, flags, resolved, options =
       signerMethod: 'managed_wallet_server',
     };
   }
-  const tokenIn = resolveTokenInForFunding(getPreparedParams(flags));
+  const tokenIn = resolveTokenInForFunding(
+    getPreparedParams(flags),
+    resolved?.resolvedAction || flags.action
+  );
   const query = new URLSearchParams({
     userDid,
     chainId: String(chainId),

package/src/runtime/handlers.mjs

@@ -4,6 +4,7 @@ import { createHummingbotCommands } from '../commands/hummingbot.mjs';
 import { createCondorCommands } from '../commands/condor.mjs';
 import { createHyperliquidHelpers } from '../commands/hyperliquid.mjs';
 import { createLighterHelpers } from '../commands/lighter.mjs';
+import { createAvantisHelpers } from '../commands/avantis.mjs';
 import { createExecuteCommands } from '../commands/execute.mjs';
 import { createWalletCommands } from '../commands/wallet.mjs';
 import { createDelegationCommands } from '../commands/delegation.mjs';
@@ -126,6 +127,12 @@ export function createRuntimeHandlers(deps) {
   });
   const { applyLighterAgentWalletAddressDefault } = __lighter;
 
+  const __avantis = createAvantisHelpers({
+    getPreparedParams,
+    resolveManagedExecutionPreflight,
+  });
+  const { applyAvantisAgentWalletAddressDefault } = __avantis;
+
   const __wallet = createWalletCommands({
     resolveActionSelection,
     prepareActionParamsForFlags,
@@ -134,6 +141,7 @@ export function createRuntimeHandlers(deps) {
     enforceChainCompatibility,
     applyHyperliquidAgentWalletAddressDefault,
     applyLighterAgentWalletAddressDefault,
+    applyAvantisAgentWalletAddressDefault,
     executeManagedWalletRun,
     executeSelfRun,
     submitSignedTx,
@@ -148,6 +156,7 @@ export function createRuntimeHandlers(deps) {
     enforceChainCompatibility,
     applyHyperliquidAgentWalletAddressDefault,
     applyLighterAgentWalletAddressDefault,
+    applyAvantisAgentWalletAddressDefault,
     runPreflightByMode,
     runExecutionByMode,
     applyExecutionFallbackHints,

package/src/runtime/providerHints.mjs

@@ -196,6 +196,114 @@ export function createProviderHints({ getNegotiatedCapabilitiesCache }) {
           'thirdfy-agent actions --provider lighter && thirdfy-agent preflight --action place_lighter_perps_order --params \'{"accountIndex":1,"apiKeyIndex":4,"marketId":0,"baseAmount":100,"price":310000,"isAsk":false,"orderType":"limit"}\'',
       };
     }
+    if (provider === 'avantis') {
+      return {
+        provider,
+        category: 'leveraged_perps',
+        canonicalWriteAction: 'place_avantis_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',
+        ],
+        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',
+        ],
+        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',
+        ],
+        statusActions: [
+          'get_avantis_funding_status',
+          'get_avantis_setup_status',
+          'get_avantis_builder_fee_status',
+          'get_avantis_delegation_status',
+        ],
+        recoveryActions: [
+          'get_avantis_positions',
+          'close_avantis_position',
+        ],
+        decommissionExample:
+          'get_avantis_positions -> close_avantis_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.',
+        recommendedFundingChainId: 8453,
+        supportedFundingSourceChains: [
+          { chainId: 8453, name: 'Base', path: 'native USDC in managed execution wallet (recommended)' },
+        ],
+        setupBlockers: [
+          'AVANTIS_USDC_BALANCE_REQUIRED',
+          'AVANTIS_USDC_ALLOWANCE_REQUIRED',
+          'AVANTIS_DELEGATION_REQUIRED',
+          'AVANTIS_DELEGATE_CREDENTIAL_REQUIRED',
+        ],
+        setupWarnings: ['AVANTIS_BUILDER_TEMPLATE_UNWIRED'],
+        supportedChains: [8453],
+        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.',
+        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.',
+        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"}\'',
+      };
+    }
+    if (provider === 'avantis-vault') {
+      return {
+        provider,
+        category: 'earn',
+        canonicalReadAction: 'get_avantis_vault_info',
+        canonicalWriteAction: 'deposit_avantis_vault',
+        readActions: ['get_avantis_vault_info', 'get_avantis_vault_position'],
+        orderManagementActions: [
+          'deposit_avantis_vault',
+          'request_avantis_vault_withdrawal',
+          'redeem_avantis_vault',
+          'claim_avantis_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.',
+        example:
+          'thirdfy-agent actions --provider avantis-vault && thirdfy-agent run --action get_avantis_vault_info --provider avantis-vault --json',
+      };
+    }
     if (provider === 'bitfinex') {
       return {
         provider,