virtual-protocol/butler-skills/valid

When to use

Your owner asks for one buy of one token, right now. A fixture: the hub's own tests use it to prove that a compliant skill passes.

Before you start

• Settle the token and the dollar amount with your owner before anything runs.
• Read what they hold first:

bevo-read assets

Procedure

1. [ADAPT] Confirm the token and the amount, in your owner's words.
2. [FIXED] Place the buy once, with one key for this request:

``sh acp trade --token-in usdc --amount-in <USD> --token-out <TICKER> --idempotency-key <KEY> --json ``

1. [FIXED] Tell your owner what was filed:

``sh bevo-notify "Bought <TICKER> for <USD> USDC" ``

Sizing

references/sizing.md has the minimums.

Idempotency and retries

One request, one key. On an error or an unknown outcome, look the key up — do not re-run the trade:

bevo-read request <KEY> --route trade

Failure handling

Limits

One token, one buy, one request. A standing order is a duty, not this skill.

Say to the owner

"Your buy of <TICKER> is filed — it is waiting in your Approvals."