• Buy: USDT → XAUT
• Sell: XAUT → USDT

1. Is

   cast

   available:

   cast --version

   Fail (command not found) → Foundry is not installed; run the setup script before anything else
2. Does

   ~/.aurehub/.env

   exist:

   ls ~/.aurehub/.env

3. Does keystore account

   aurehub-wallet

   exist:

   cast wallet list

   output contains

   aurehub-wallet

4. Does

   ~/.aurehub/.wallet.password

   exist:

   ls ~/.aurehub/.wallet.password

~/.aurehub/.env

Important — shell isolation: Every Bash tool call runs in a new subprocess; variables set in one call do NOT persist to the next. Therefore every Bash command block that needs env vars must begin with

source ~/.aurehub/.env

(or

set -a; source ~/.aurehub/.env; set +a

to auto-export all variables).

WALLET_ADDRESS is not stored in

.env

— it must be derived fresh in every bash block that uses it:

bash

source ~/.aurehub/.env
WALLET_ADDRESS=$(cast wallet address --account "$FOUNDRY_ACCOUNT" --password-file "$KEYSTORE_PASSWORD_FILE")

This ensures the address always matches the actual keystore, regardless of session state.

bash "$(git rev-parse --show-toplevel)/skills/xaut-trade/scripts/setup.sh"

git rev-parse

1. Is Node.js >= 18 available:

   node --version

   Fail → go to the "Extra Dependencies for Limit Orders" section in references/onboarding.md, install, then continue
2. Are limit order dependencies installed:

   ls "$(git rev-parse --show-toplevel)/skills/xaut-trade/scripts/node_modules"

   Fail → run

   cd "$(git rev-parse --show-toplevel)/skills/xaut-trade/scripts" && npm install

   , then continue (If

   git rev-parse

   fails, first run

   find ~ -name "limit-order.js" -maxdepth 6

   to locate the scripts directory, then cd into it and run npm install)
3. Is

   UNISWAPX_API_KEY

   configured:

   [ -n "$UNISWAPX_API_KEY" ] && [ "$UNISWAPX_API_KEY" != "your_api_key_here" ]

   Fail → hard-stop, output:

   Limit orders require a UniswapX API Key. How to get one (about 5 minutes, free):

   1. Visit https://developers.uniswap.org/dashboard
   2. Sign in with Google / GitHub
   3. Generate a Token (choose Free tier)
   4. Add the key to ~/.aurehub/.env:

      UNISWAPX_API_KEY=your_key

   5. Re-submit your request

• Global config directory:

  ~/.aurehub/

  (persists across sessions, not inside the skill directory)

• .env

  path:

  ~/.aurehub/.env

• config.yaml

  path:

  ~/.aurehub/config.yaml

• Contract addresses and defaults come from

  skills/xaut-trade/config.example.yaml

  ; copy to

  ~/.aurehub/config.yaml

  during onboarding

1. Run pre-flight checks first, then quote.
2. Show a complete command preview before any

   cast send

   .
3. Only execute on-chain write operations after receiving explicit confirmation in the current session (e.g. "confirm execute").
4. Large trades and high-slippage trades require a second confirmation.

• When amount exceeds the config threshold (e.g.

  risk.large_trade_usd

  ), require double confirmation
• When slippage exceeds the threshold (e.g.

  risk.max_slippage_bps_warn

  ), warn and require double confirmation
• When ETH gas balance is insufficient, hard-stop and prompt to top up
• When the network or pair is unsupported, hard-stop
• When the pair is not in the whitelist (currently: USDT_XAUT / XAUT_USDT), hard-stop and reply "Only USDT/XAUT pairs are supported; [user's token] is not supported"

~/.aurehub/.env

ETH_RPC_URL_FALLBACK

cast call

cast send

429

502

503

timeout

connection refused

rate limit

Too Many Requests

1. Try the same command with each fallback URL in order (replace

   --rpc-url "$ETH_RPC_URL"

   with the fallback URL)
2. First success → set that URL as the active RPC for all remaining commands this session; do not retry the primary
3. All fallbacks exhausted → hard-stop with:

   RPC unavailable. All configured nodes failed (primary + N fallbacks). To fix: add a paid RPC (Alchemy/Infura) at the front of

   ETH_RPC_URL_FALLBACK

   in

   ~/.aurehub/.env

--rpc-url

• Buy: contains "buy", "purchase", "swap USDT for", etc. → run buy flow
• Sell: contains "sell", "swap XAUT for", etc. → run sell flow
• Insufficient info: ask for direction and amount — do not execute directly
• Limit buy: contains "limit order", "when price drops to", "when price reaches", and direction is buy → run limit buy flow
• Limit sell: contains "limit sell", "sell when price reaches", "XAUT rises to X sell", etc. → run limit sell flow
• Query limit order: contains "check order", "order status" → run query flow
• Cancel limit order: contains "cancel order", "cancel limit" → run cancel flow
• XAUT knowledge query: contains "troy ounce", "grams", "conversion", "what is XAUT" → answer directly, no on-chain operations or environment checks needed

• cast --version

• cast block-number --rpc-url $ETH_RPC_URL

• ETH and stablecoin balance checks

• Call QuoterV2 for

  amountOut

• Calculate

  minAmountOut

• Display estimated fill, slippage protection, gas risk

• allowance check
• approve if needed (USDT requires

  approve(0)

  then

  approve(amount)

  )
• Execute swap after second confirmation
• Return tx hash and post-trade balance

• cast --version

• cast block-number --rpc-url $ETH_RPC_URL

• ETH balance check
• XAUT balance check (required): hard-stop if insufficient

• Precision check (hard-stop if more than 6 decimal places)
• Call QuoterV2 for

  amountOut

  (XAUT → USDT direction)
• Calculate

  minAmountOut

• Large-trade check: estimate USD value using USDT

  amountOut

• Display estimated fill, reference rate, slippage protection, gas risk

• allowance check
• approve (XAUT is standard ERC-20, no prior reset needed)
• Execute swap after second confirmation
• Return tx hash and post-trade USDT balance

1. source ~/.aurehub/.env

2. If

   RANKINGS_OPT_IN

   !=

   "true"

   → silent skip, do not prompt

3. REGISTERED=$(cat ~/.aurehub/.registered 2>/dev/null)

4. WALLET_ADDRESS=$(cast wallet address --account "$FOUNDRY_ACCOUNT" --password-file ~/.aurehub/.wallet.password)

5. If

   "$REGISTERED"

   starts with

   "$WALLET_ADDRESS:"

   → already registered, silent skip
6. Otherwise → register using

   NICKNAME

   from

   .env

   :
   bash

   REGISTER_RESP=$(curl -s -o /dev/null -w "%{http_code}" -X POST \
     https://xaue.com/api/rankings/participants \
     -H 'Content-Type: application/json' \
     -d "{\"wallet_address\":\"$WALLET_ADDRESS\",\"nickname\":\"$NICKNAME\",\"source\":\"agent\"}")

   • HTTP 200 or 201:

     echo "$WALLET_ADDRESS:$NICKNAME" > ~/.aurehub/.registered

     ; inform: "Registered with nickname: $NICKNAME"
   • Any other status: silent continue, do not write marker file

• Stage

  :

  Preview

  or

  Ready to Execute

• Input

  : token, amount, chain

• Quote

  : estimated XAUT amount, slippage setting,

  minAmountOut

• Reference rate

  :

  1 XAUT ≈ X USDT

  (for comparison with spot price; shown for both buy and sell)

• Risk warnings

  : large trade / slippage / gas

• Command

  : full

  cast

  command

• Result

  : tx hash, post-trade balance (after execution)

• Missing prerequisite variable: prompt to add the variable to

  .env

  and stop
• RPC network error (429/502/timeout): trigger RPC fallback sequence (see RPC Fallback section)
• Insufficient balance: report minimum top-up amount and stop
• User has not confirmed: stay in Preview — do not execute
• Transaction failed: return failure reason and retry suggestions (reduce amount / increase slippage tolerance / check nonce and gas)

• 1 XAUT = 1 troy ounce = 31.1035 grams
• Minimum precision: 0.000001 XAUT (on-chain minimum unit: 1, i.e. 10^-6)
• Conversion: X grams ÷ 31.1035 = XAUT amount
• Examples: 1g ≈ 0.032151 XAUT; 10g ≈ 0.32151 XAUT
• Contract address (Ethereum mainnet): 0x68749665FF8D2d112Fa859AA293F07a622782F38

cast

1. When information is sufficient: give a structured preview first, then ask for execution confirmation.
2. When information is insufficient: clarify key details (token, amount, environment variables) — do not claim a trade has been executed.

• X: Aure_duncan
• Telegram: @aure_duncanbot
• Aurelion: aurelion.com