crypto-treasury-ops

Use this skill when an OpenClaw agent needs to inspect or operate a treasury wallet on Ethereum, Polygon, Arbitrum, or Base with explicit safety controls, or use Solana as a read path and bridge source chain.

What this skill does

• - Checks native and configured stablecoin balances
• Checks Solana native SOL and configured SPL token balances
• Transfers native assets or ERC-20 tokens on one chain
• Bridges tokens across chains through a pluggable provider layer, including Solana -> EVM routes
• Deposits USDC to Hyperliquid with guarded Arbitrum direct flow plus Polygon/Base routing
• Reads Hyperliquid perpetual market state and account state
• Places, protects, and cancels guarded Hyperliquid perpetual orders
• Evaluates treasury safety policy before execution
• Returns structured JSON for reliable downstream agent use

Runtime contract

Execution tools require environment configuration before build or runtime.

Required variables:

CODEBLOCK0

Recommended workflow:

CODEBLOCK1

Important:

• - TREASURY_PRIVATE_KEY is required for EVM execution tools and as the default destination wallet for Solana -> EVM bridges
• INLINECODE1 is required for executing Solana bridge transactions
• INLINECODE2 can be used for read-only Solana quote context when no Solana signer is present
• INLINECODE3 is required for swap_token and swap quotes
• INLINECODE5 is optional but recommended for Solana bridge quote / execution rate limits
• INLINECODE6 variables can further constrain market allowlists, order notional, leverage, and confirmation thresholds
• The skill ships with built-in fallback RPC URL lists for Ethereum, Polygon, Arbitrum, Base, and Solana
• RPC env vars such as ETHEREUM_RPC_URL and SOLANA_RPC_URL are optional overrides; comma-separated lists are supported
• INLINECODE9, get_hyperliquid_market_state, get_hyperliquid_account_state, safety_check, and some quote flows can run without a signer
• Do not pass private keys in tool input JSON; this skill reads them from the environment only
• Prefer a vault, KMS, HSM, or delegated signer in production instead of a raw hot-wallet private key in INLINECODE13
• For state-changing treasury operations, run quote_operation or dryRun=true immediately before execution so the route and balances are fresh

Invoke tools through the CLI:

CODEBLOCK2

Tools

get_balances

Inputs:

• - INLINECODE17
• INLINECODE18
• INLINECODE19 optional when INLINECODE20

Returns:

• - Native balance
• Configured stablecoin balances for that chain
• Symbols, decimals, raw amounts, and human-readable amounts

Notes:

• - chain=solana is supported for read-only balance queries
• Solana execution is limited to bridge source flows only

transfer_token

Inputs:

• - INLINECODE23
• INLINECODE24
• INLINECODE25
• INLINECODE26
• INLINECODE27 optional
• INLINECODE28 optional

Behavior:

• - Validates recipient format
• Resolves token by symbol or address
• Checks wallet balance before sending
• Estimates gas
• Runs safety policy
• Rejects unsafe or underfunded transfers
• Returns transfer summary and transaction hash

swap_token

Inputs:

• - INLINECODE30
• INLINECODE31
• INLINECODE32
• INLINECODE33
• INLINECODE34 optional
• INLINECODE35 optional
• INLINECODE36 optional
• INLINECODE37 optional

Behavior:

• - Uses the configured swap provider abstraction
• First implementation uses the 0x Swap API
• Supports EVM ERC-20 swaps only
• Rejects native gas token swaps such as raw ETH or POL; use wrapped tokens such as INLINECODE40
• Quotes route, minimum received, gas, allowance target, and tx data
• Checks treasury policy and gas reserve before execution
• Executes only when approval and policy conditions pass

bridge_token

Inputs:

• - INLINECODE42
• INLINECODE43
• INLINECODE44
• INLINECODE45
• INLINECODE46 optional
• INLINECODE47 optional

Behavior:

• - Uses the configured bridge provider abstraction
• Supports solana -> ethereum/arbitrum/base/polygon through Mayan
• Quotes route, fees, minimum received, and tx data
• Checks treasury policy, fee threshold, and gas reserve
• Executes only when approval and policy conditions pass
• Returns route summary, tx status, and explorer links when available
• The first Solana bridge implementation supports SOL -> native destination gas token and same-symbol stablecoin routes such as INLINECODE50
• Solana bridge execution currently returns a submitted / pending status after the signed Solana transaction is broadcast; completion should be re-checked from the destination balance or explorer link

deposit_to_hyperliquid

Inputs:

• - INLINECODE52
• INLINECODE53
• INLINECODE54
• INLINECODE55
• INLINECODE56 optional
• INLINECODE57 optional

Behavior:

• - Supports USDC only
• Supports arbitrum direct deposits and INLINECODE60
• If Arbitrum gas is insufficient for the final deposit, can reserve source USDC and bridge enough Arbitrum ETH first
• This is a multi-stage flow: optional gas top-up, bridge to Arbitrum, then Arbitrum USDC deposit into Hyperliquid
• The tool now attempts balance-based recovery if a bridge status API is unreliable but funds have already arrived onchain
• Rejects deposits to a different Hyperliquid wallet than the treasury signer
• Does not support Solana-origin deposits or INLINECODE61
• Hyperliquid may support separate Solana deposits through Unit-managed flows, but those are outside this skill
• Rejects if minimum deposit or gas reserve requirements are not met
• Returns the bridge leg, deposit leg, and final execution summary

Recommended agent workflow:

• - Call quote_operation first
• If the quote is acceptable, call deposit_to_hyperliquid with INLINECODE64
• Only then call deposit_to_hyperliquid with INLINECODE66
• If execution returns an error after a partial bridge or top-up, do not blindly retry the original amount
• Re-check base/polygon and arbitrum balances, then re-run quote_operation with the remaining source balance if a retry is needed

get_hyperliquid_market_state

Inputs:

• - market optional

Behavior:

• - Returns live Hyperliquid perpetual metadata and context
• If market is omitted, returns the full supported perpetual market list
• If market is provided, also returns best bid / ask from the live L2 snapshot
• Supports HIP-3 / builder dex markets in dex:COIN format such as INLINECODE75

get_hyperliquid_account_state

Inputs:

• - user optional
• INLINECODE78 optional

Behavior:

• - Returns Hyperliquid perpetual account summary
• Returns positions and open orders
• If user is omitted, the skill uses the treasury signer address
• If dex is provided, the tool queries that specific HIP-3 builder dex
• Also returns abstractionState and INLINECODE82

place_hyperliquid_order

Inputs:

• - accountAddress optional for read-only dry-run / quote context
• INLINECODE85
• INLINECODE86
• INLINECODE87
• INLINECODE88
• INLINECODE89 required for limit orders
• INLINECODE90 optional for market orders
• INLINECODE91 optional
• INLINECODE92 optional
• INLINECODE93 optional
• INLINECODE94 optional for limit orders
• INLINECODE95 optional
• INLINECODE96 optional
• INLINECODE97 optional

Behavior:

• - Supports Hyperliquid perpetuals only
• Supports builder dex perps in dex:COIN format such as INLINECODE99
• Supports market and limit orders in the first version
• Market orders are translated into protected IOC orders with a configurable price cap
• Optionally updates leverage before placing the order
• Enforces market allowlist, max single order notional, max daily order notional, max leverage, and confirmation threshold
• INLINECODE102 supports this tool
• If accountAddress is provided, dry-run and quote can use it for read-only account context
• Real execution only proceeds when the signer matches the target Hyperliquid account
• HIP-3 builder-dex execution requires Hyperliquid INLINECODE104
• The skill does not silently switch abstraction mode
• For HIP-3 orders, pass enableDexAbstraction=true if you want execution to switch the account into dexAbstraction first

Recommended agent workflow:

• - Call quote_operation first with INLINECODE108
• Review the returned safety block and INLINECODE110
• Call place_hyperliquid_order with INLINECODE112
• Only then call place_hyperliquid_order with INLINECODE114

protect_hyperliquid_position

Inputs:

• - accountAddress optional for read-only dry-run / quote context
• INLINECODE117
• INLINECODE118 optional, default INLINECODE119
• INLINECODE120 optional, default INLINECODE121
• INLINECODE122 optional
• INLINECODE123 optional, default INLINECODE124
• INLINECODE125 optional
• INLINECODE126 optional
• INLINECODE127 optional

Behavior:

• - Reads the live Hyperliquid position for the requested market
• Derives a full-size reduce-only take-profit trigger and a full-size reduce-only stop-loss trigger
• Uses ROE-style rules relative to entry and leverage:

• - If the requested stop-loss would be beyond liquidation, the tool tightens it in front of liquidation using liquidationBufferBps and returns a warning
• Uses native Hyperliquid trigger orders with reduce-only semantics
• INLINECODE131 supports this tool
• Real execution only proceeds when the signer matches the target Hyperliquid account
• For HIP-3 builder-dex positions, pass enableDexAbstraction=true if the account must first switch into INLINECODE133

Recommended agent workflow:

• - Call quote_operation first with INLINECODE135
• Review any liquidation-adjustment warning before execution
• Call protect_hyperliquid_position with INLINECODE137
• Only then call protect_hyperliquid_position with INLINECODE139

cancel_hyperliquid_order

Inputs:

• - INLINECODE141
• INLINECODE142
• INLINECODE143 optional

Behavior:

• - Looks up the matching open order first
• Rejects if the order is not currently open
• Supports dry-run preview before cancellation

safety_check

Inputs:

• - INLINECODE145
• INLINECODE146
• INLINECODE147
• INLINECODE148
• INLINECODE149 optional
• INLINECODE150 optional
• INLINECODE151 optional
• INLINECODE152 optional

Behavior:

• - Enforces allowlists
• Enforces max single transfer size
• Enforces max daily transfer amount
• Requires approval above the configured threshold
• Rejects bridge and deposit flows with insufficient gas reserve
• Rejects excessive estimated fees or slippage

quote_operation

Inputs:

• - INLINECODE154
• operation-specific fields

Behavior:

• - Estimates balance impact, gas, route fees, and minimum received
• Estimates Hyperliquid order notional, submission price, simulated fill price, and safety outcome for INLINECODE155
• Estimates derived TP/SL trigger prices and safety outcome for INLINECODE156
• Returns a structured quote without execution

Examples

CODEBLOCK3

CODEBLOCK4

CODEBLOCK5

CODEBLOCK6

CODEBLOCK7

CODEBLOCK8

CODEBLOCK9

CODEBLOCK10

CODEBLOCK11

CODEBLOCK12

CODEBLOCK13

CODEBLOCK14

CODEBLOCK15

CODEBLOCK16

CODEBLOCK17

CODEBLOCK18

CODEBLOCK19

CODEBLOCK20

Safety defaults

• - Do not bypass safety_check reasoning. Execution tools perform the check again internally.
• Treat rejected outputs as hard stops.
• Prefer dryRun=true first for all new destinations or larger transfers.
• Prefer quote_operation plus dryRun=true before any new Hyperliquid order.
• Prefer protect_hyperliquid_position over ad hoc manual TP/SL math when protecting an existing Hyperliquid position.
• Require explicit approval=true for amounts above the configured threshold.
• Never assume a non-allowlisted destination is safe.
• For multi-stage flows such as Hyperliquid deposits, never reuse a stale quoted amount after a partial execution. Re-quote from current balances first.