xaut-trade

Execute

USDT -> XAUT

buy and

XAUT -> USDT

sell flows via Uniswap V3 + Foundry

cast

When to Use

Use when the user wants to buy or sell XAUT (Tether Gold):

Buy: USDT → XAUT
Sell: XAUT → USDT

External Communications

This skill connects to external services (Ethereum RPC, UniswapX API, and optionally xaue.com rankings). On first setup, it may install Foundry via

curl | bash

. Inform the user before executing any external communication for the first time. See the README for a full list.

Environment Readiness Check (run first on every session)

Before handling any user intent (except knowledge queries), run these checks:

Is
```
cast
```
available:
```
cast --version
```
Fail (command not found) → Foundry is not installed; run the setup script before anything else
Does
```
~/.aurehub/.env
```
exist:
```
ls ~/.aurehub/.env
```

Does keystore account

aurehub-wallet

exist:

cast wallet list

output contains

aurehub-wallet

Does

~/.aurehub/.wallet.password

exist:

ls ~/.aurehub/.wallet.password

If all pass: source

~/.aurehub/.env

, then proceed to intent detection.

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.

If any fail: do not continue with the original intent — run the setup script first:

bash

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

git rev-parse

fails, fall back to references/onboarding.md for manual steps. After setup completes, re-run the original intent.

Proceed to intent detection.

Extra checks for limit orders (only when the intent is limit buy / sell / query / cancel):

Is Node.js >= 18 available:
```
node --version
```
Fail → go to the "Extra Dependencies for Limit Orders" section in references/onboarding.md, install, then continue

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)

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

Config & Local Files

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

Interaction & Execution Principles (semi-automated)

Run pre-flight checks first, then quote.
Show a complete command preview before any
```
cast send
```
.
Only execute on-chain write operations after receiving explicit confirmation in the current session (e.g. "confirm execute").
Large trades and high-slippage trades require a second confirmation.

Mandatory Safety Gates

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"

RPC Fallback

After sourcing

~/.aurehub/.env

, parse

ETH_RPC_URL_FALLBACK

as a comma-separated list of fallback RPC URLs.

If any

cast call

cast send

command fails and its output contains any of the following:

timeout

connection refused

rate limit

Too Many Requests

Then:

Try the same command with each fallback URL in order (replace
```
--rpc-url "$ETH_RPC_URL"
```
with the fallback URL)
First success → set that URL as the active RPC for all remaining commands this session; do not retry the primary
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

Do NOT trigger fallback for non-network errors: insufficient balance, contract revert, invalid parameters, nonce mismatch. Report these directly to the user.

Session stickiness: Once a fallback is selected, use it for every subsequent

--rpc-url

in this session. Never switch back to the primary or try other fallbacks unless the current one also fails.

Intent Detection

Determine the operation from the user's message:

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

Buy Flow (USDT → XAUT)

Step 1: Pre-flight Checks

Follow references/balance.md:

```
cast --version
```

cast block-number --rpc-url $ETH_RPC_URL

ETH and stablecoin balance checks

Step 2: Quote & Risk Warnings

Follow references/quote.md:

Call QuoterV2 for
```
amountOut
```
Calculate
```
minAmountOut
```
Display estimated fill, slippage protection, gas risk

Step 3: Buy Execution

Follow references/buy.md:

allowance check
approve if needed (USDT requires
```
approve(0)
```
then
```
approve(amount)
```
)
Execute swap after second confirmation
Return tx hash and post-trade balance

Sell Flow (XAUT → USDT)

Step 1: Pre-flight Checks

Follow references/balance.md:

```
cast --version
```

cast block-number --rpc-url $ETH_RPC_URL

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

Step 2: Quote & Risk Warnings

Follow references/sell.md:

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

Step 3: Sell Execution

Follow references/sell.md:

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

Post-Trade Registration

After any on-chain trade completes successfully (buy swap, sell swap, or limit order placed):

```
source ~/.aurehub/.env
```
If
```
RANKINGS_OPT_IN
```
!=
```
"true"
```
→ silent skip, do not prompt

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

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

If
```
"$REGISTERED"
```
starts with
```
"$WALLET_ADDRESS:"
```
→ already registered, silent skip

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

Never ask the user for a nickname during the trade flow. The nickname is set during onboarding only.

Limit Buy Flow (USDT → XAUT via UniswapX)

Follow references/limit-order-buy-place.md.

Limit Sell Flow (XAUT → USDT via UniswapX)

Follow references/limit-order-sell-place.md.

Limit Order Query Flow

Follow references/limit-order-status.md.

Limit Order Cancel Flow

Follow references/limit-order-cancel.md.

Output Format

Output must include:

```
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)

Error Handling

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)

XAUT Knowledge Base

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

Answer knowledge queries directly using the data above — no

cast

commands needed.

First-Turn Contract (for testing)

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

About

This skill is developed by Duncan.Aure (Duncan), an AI Agent created by Aurelion, the world's first NASDAQ-listed Tether Gold (XAU₮) treasury company. Duncan executes on-chain financial actions through modular AI Agent Skills. Enables automated XAU₮ trading, cross-protocol DeFi execution, and programmable digital gold allocation.

Stay Connected

For updates, new skills, and ecosystem developments:

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

xaut-trade

NPX Install

Tags

SKILL.md Content

xaut-trade

When to Use

External Communications

Environment Readiness Check (run first on every session)

Config & Local Files

Interaction & Execution Principles (semi-automated)

Mandatory Safety Gates

RPC Fallback

Intent Detection

Buy Flow (USDT → XAUT)

Step 1: Pre-flight Checks

Step 2: Quote & Risk Warnings

Step 3: Buy Execution

Sell Flow (XAUT → USDT)

Step 1: Pre-flight Checks

Step 2: Quote & Risk Warnings

Step 3: Sell Execution

Post-Trade Registration

Limit Buy Flow (USDT → XAUT via UniswapX)

Limit Sell Flow (XAUT → USDT via UniswapX)

Limit Order Query Flow

Limit Order Cancel Flow

Output Format

Error Handling

XAUT Knowledge Base

First-Turn Contract (for testing)

About

Stay Connected