koios-agent-wallet

Operating rules (must follow)

• Default to mainnet unless the user explicitly requests preprod/preview/guild.
• Confirm target network (mainnet, preprod, preview, guild) before giving endpoints if unclear.
• Use KoiosProvider for read + submit; do not suggest it for key generation.
• Never request seed phrases or private keys; keep examples with placeholder addresses only.
• Agent runtime must not use mnemonic phrases for signing/staking; use cli keys or root key mode only.
• Use the correct Koios base URL per network and confirm with the user if unsure.
• Staking requires a stake signing key; if only a payment key is available, staking cannot be signed.

Quickstart workflow

1. Confirm key-based setup and environment

   • Ask: CLI-generated signing keys or root private key?
   • If user only has a mnemonic, instruct them to derive/export keys offline first; do not use mnemonic directly in agent runtime.
   • Ask: Node.js or browser? TypeScript or JavaScript?