Utilia solana preflight

Utilia Solana Preflight

Use the published [email protected] client. It signs exact x402 payments locally and refuses any payment outside Solana mainnet USDC, Utilia's verified receiver, or the hard $0.01 per-call ceiling.

Fastest wallet-managed call

Agents that already use AgentCash can make the lowest-cost live call without handling a private key directly:

npx -y agentcash@latest balance
npx -y agentcash@latest fetch https://api.utilia.ink/v1/fees/priority --yes

AgentCash creates and manages its own wallet on first use. The wallet must have USDC before the paid call; balance reports the available funds and funding accounts. The fetch command negotiates the x402 challenge and pays exactly $0.002 for the response. Utilia never receives or controls the payer's key.

Prepare

Require one of:

export SOLANA_KEYPAIR_PATH=/absolute/path/to/low-balance-agent-wallet.json

Alternatively, provide SOLANA_PRIVATE_KEY through the agent's environment or secret manager. Its value must be a base58-encoded 64-byte private key. Do not place the value directly in a command, prompt, source file, or skill document.

Never print, log, paste, or transmit the private key. Prefer a dedicated automation wallet with only a small USDC balance and enough SOL for fees. If neither variable is set, ask the user to configure one; do not invent or search for credentials.

Verify the wallet and live service before the first paid call:

npx -y [email protected] doctor

Data handling

Treat every requested signature, mint, transaction, account address, public PDF, and public audio file as data sent to Utilia for processing. Do not submit private documents, private recordings, or data the user is not authorized to share. The client sends payment only after validating the receiver, network, asset, and per-call price ceiling.

Before a media call, confirm that the user approved sending the public URL or bytes to Utilia. The service processes PDF and audio content in memory and does not persist request or response bodies to disk. Standard access and settlement logs retain route, request, network, payer, and transaction metadata but not media bodies.

Call the right tool

• Estimate priority fees before broadcast ($0.002):

  npx -y [email protected] fees [account1,account2]
  

• Maintain a budget-capped JSONL fee feed at five calls per hour:

  npx -y [email protected] watch-fees --every 12m --max-calls 25
  

• Explain a confirmed or failed transaction ($0.004):

  npx -y [email protected] transaction <signature>
  

• Inspect an SPL mint for authorities, Token-2022 controls, and concentration ($0.006):

  npx -y [email protected] token <mint>
  

• Simulate an unsigned serialized transaction before signing ($0.008):

  npx -y [email protected] simulate <serialized-transaction> [base64|base58]
  

• Convert a public HTTPS PDF to page-delimited Markdown ($0.0025):

  npx -y [email protected] pdf <public-https-pdf-url> [max-pages]
  

• Normalize a public HTTPS audio file into a bounded MP3 ($0.01):

  npx -y [email protected] audio-normalize <public-https-audio-url> \
    --output normalized.mp3
  

Use the returned structured evidence in the answer. State the settled price and transaction receipt reported by the client. Do not claim that simulation guarantees future execution; block state and account balances can change.

MCP integration

When persistent tool access is more useful than a one-off command, configure:

{
  "mcpServers": {
    "utilia": {
      "command": "npx",
      "args": ["-y", "[email protected]", "mcp"],
      "env": {
        "SOLANA_KEYPAIR_PATH": "/absolute/path/to/low-balance-agent-wallet.json"
      }
    }
  }
}

The bridge exposes solana_priority_fees, solana_transaction_analysis, solana_token_analysis, solana_transaction_simulate, pdf_to_markdown, and normalize_audio.