๐ŸŒธ

waifu.ai

waifu banner v0.9
AGENT: V5 LLMs:
waifu
โ™ฅโ™ฅโ™ฅโ™ฅโ™ฅโ™ฅ

waifu.ai

Ask me anything about your trading bot, portfolio, chores, governance, or DAO.

โ“

FAQ & Help

Everything you need to know about waifu.ai

Getting Started โ–ผ
What is waifu.ai?
waifu.ai is an on-chain AI trading agent running on the Internet Computer. It manages a shared trading bot portfolio, executes trades across DEXes, and lets you interact via natural language chat. All actions happen on-chain with full transparency.
How do I log in?
Click the โ˜ฐ wallet button in the header, then click Login with Internet Identity. You'll be redirected to Internet Identity for authentication. Login is optional for read-only access but required for trading, governance, and personal bot features.
What are the main tabs?
Dashboard โ€” Portfolio overview, prices, chores, circuit breakers, and trade history for the shared bot.
Tokens โ€” Detailed token registry with balances and verification.
Logs โ€” System logs and circuit breaker event history.
Chat โ€” AI chat interface for querying data and executing actions.
My Bot โ€” Your personal trading bot dashboard (visible after minting).
FAQ โ€” This help page.
Keyboard shortcuts?
Ctrl/Cmd + D โ€” Switch to Dashboard
Ctrl/Cmd + K โ€” Switch to Chat
Ctrl/Cmd + / โ€” Switch to FAQ
Escape โ€” Close wallet sidebar or dialogs
Chat Guide โ–ผ
Which AI models are available?
Waifu โ€” Main AI agent with tool-calling. Handles complex queries, multi-step actions, and orchestrates all on-chain tools. Default choice.
Falcon-H1 (0.5B) โ€” Mamba2 hybrid model running fully on-chain via llama.cpp WASM. Fast inference with ~7B quality thanks to state-space architecture.
Easy Chat (SmolLM2-360M Q8_0) โ€” Lightweight on-chain model. Fast, simple responses.
Spicy (SmolLM2-360M Heretic Q8_0) โ€” Uncensored, abliterated on-chain model. No guardrails, raw responses.
Waifu.code (Qwen2.5-Coder 0.5B Q8_0) โ€” Code-specialized on-chain model. Use the tab directly or type @code in Waifu chat to delegate.
What is @code delegation?
While chatting with Waifu, type @code followed by your question to route it to the Waifu.code LLM. The response appears in the same chat with the Waifu.code avatar. Each @code call is independent โ€” without the prefix, your messages go back to Waifu as normal.
What can I ask the chat?
Example prompts:
show my portfolio โ€” View token balances
what are the current prices? โ€” See cached price data
show recent trades โ€” Trade history
start the rebalance chore โ€” Manage chores
submit a trade selling 1 ICP for TENDYS โ€” Execute trades
list governance proposals โ€” DAO interactions
check my neuron โ€” Neuron status
top up canister [id] with 1 ICP โ€” Convert ICP to cycles for any canister
How do tool calls work?
The AI uses on-chain tools to fetch data and execute actions. Read-only tools (portfolio, prices, logs) execute automatically. Write tools (trades, chores, governance votes) require your confirmation via a dialog popup. You can approve or cancel each action.
What is the confirmation dialog?
When the AI wants to perform a write action (trading, voting, chore management), it creates a pending action and shows you a confirmation dialog. You have 5 minutes to approve or cancel. This prevents unauthorized or accidental actions.
Neuron Gating & Permissions โ–ผ
What are stake tiers?
Tier 0 (No stake / <1 TENDYS) โ€” Read-only access. Can view dashboard, prices, and chat for information.
Tier 1 (<14,999 TENDYS staked) โ€” Can submit DAO proposals. Write actions are auto-converted to governance motions for community voting.
Tier 2 (โ‰ฅ14,999 TENDYS staked) โ€” Full direct access. Can execute trades, manage chores, and perform all actions directly without DAO approval.
VIP (โ‰ฅ15,000 TENDYS staked) โ€” All Tier 2 permissions plus: free Extended mode, and the ability to submit treasury transfer proposals (transfer ICP or SNS tokens from the DAO treasury).
How do I set up my neuron hotkey?
1. Open the wallet sidebar (โ˜ฐ button)
2. Find "Neuron Hotkey Setup" section
3. Copy the backend canister principal shown
4. Go to the NNS/SNS dapp and add this principal as a hotkey on your neuron with VOTE and SUBMIT_PROPOSAL permissions
5. Enter your neuron subaccount (64 hex chars) in the input field
6. Click Save, then Verify to confirm the setup
Where do I find my neuron subaccount?
Your neuron subaccount is a 64-character hex string. You can find it in the SNS governance dapp under your neuron details, or by using the list neurons chat command with your principal.
Extended Mode & Subscriptions โ–ผ
What is Extended mode?
On-chain LLMs (Falcon-H1, Spicy, Waifu.code) support two inference modes:
Standard โ€” Single-step inference. Free for all users. Faster but shorter responses.
Extended โ€” Multi-step timer-based inference. Generates longer, more detailed responses by running multiple inference rounds. Requires a subscription or VIP status.
How do I switch modes?
Click the Extended badge next to any on-chain LLM button in the header. A mode picker will appear. If you don't have an active subscription, you'll be prompted to purchase one.
What are the subscription tiers?
VIP (15,000+ TENDY staked) โ€” Free Extended mode access. No payment needed.
Staker (<15,000 TENDY with neuron) โ€” 3 ICP for 60 days of Extended mode.
Basic (no neuron) โ€” 5 ICP for 60 days of Extended mode.
All subscriptions include a 3-day grace period after expiry.
Where does the subscription payment go?
Half goes to the shared trading bot portfolio. The other half is accumulated in a cycle pool and automatically converted to cycles to keep all production canisters running.
How do I check my subscription?
Click any mode badge in the header โ€” the mode picker shows your current tier, remaining days, and pricing. Your tier is cached for 5 minutes.
Canister Top-Up โ–ผ
What is canister top-up?
Canisters on the Internet Computer need cycles to operate. The top-up feature lets you convert ICP to cycles and deposit them directly into any canister. This keeps canisters running โ€” including your personal bot.
How do I top up a canister?
Three ways:
1. Wallet sidebar โ€” Open the wallet (โ˜ฐ), scroll to "Top Up Canister", enter the canister ID and ICP amount, click "Top Up".
2. Top Up My Bot โ€” If you have a personal bot, click "Top Up My Bot" in the wallet sidebar to prefill your bot's canister ID.
3. Chat โ€” Ask Waifu: top up canister [id] with 1 ICP. An editable modal will appear to confirm.
How much does it cost?
Minimum 0.1 ICP, maximum 100 ICP per top-up. Plus standard ICP transfer fees (~0.0002 ICP). The conversion rate is set by the ICP Cycles Minting Canister (CMC) โ€” typically ~1.8T cycles per ICP.
How does it work technically?
1. You approve ICP spending via ICRC-2
2. The backend pulls ICP from your wallet
3. ICP is transferred to the CMC (Cycles Minting Canister) with the target canister's subaccount
4. CMC converts ICP to cycles and deposits them into the target canister
All steps happen automatically in one click.
Treasury Transfers โ–ผ
What are treasury transfer proposals?
Treasury transfer proposals let VIP members (15,000+ TENDY staked) submit governance proposals to transfer ICP or SNS tokens from the DAO treasury to a specified principal. The transfer only executes if the DAO votes to approve it.
Who can submit treasury transfers?
Only VIP tier users with 15,000 or more TENDY staked in their neuron. Lower-tier users will receive an error message explaining the requirement.
How do I submit one?
Ask Waifu in chat, for example: submit a treasury transfer of 100 ICP to [principal-id] for development funding. You'll need to provide:
1. The destination principal ID
2. The amount in e8s (or describe it in ICP and let Waifu convert)
3. Which treasury: ICP or SNS tokens
4. A title and summary explaining the reason
A confirmation dialog will appear before submission.
What happens after I submit?
The proposal is created in the SNS governance canister. All neuron holders can then vote YES or NO. If the proposal passes, the treasury transfer executes automatically on-chain. If rejected, nothing happens.
Which treasuries are available?
ICP Treasury โ€” Transfers ICP from the DAO's ICP holdings.
SNS Treasury โ€” Transfers the DAO's SNS governance tokens (TENDY).
Specify which treasury when making your request. Defaults to ICP if not specified.
Forum Posting โ–ผ
Can I post on the Sneed DAO forum through Waifu?
Yes! VIP users (15,000+ TENDY staked) can create threads and reply to posts on the Sneed DAO forum directly through chat. Just tell Waifu what you want to post and she'll handle it.
How does it work?
1. Ask Waifu to list forum topics: show forum topics
2. Browse threads in a topic: show threads in topic [id]
3. Create a new thread: post a new thread in topic [id] titled "My Title" about [your content]
4. Reply to a thread: reply to thread [id] saying [your message]
A confirmation dialog appears before posting.
Who is the post attributed to?
Posts are made by the Waifu backend canister but include an attribution line at the bottom showing your principal ID, so the community knows who authored the post.
Are there character limits?
Thread titles: max 200 characters. Post/thread body: max 10,000 characters.
Why is this VIP-only?
Forum posting through an agent requires trust and accountability. VIP status (15,000+ TENDY staked) ensures posters have meaningful skin in the game and are invested in the DAO community.
Chat Commands Reference โ–ผ
Portfolio & Analytics
show my portfolio โ€” View token balances
show capital flows โ€” Deposits/withdrawals per token
show portfolio snapshots โ€” Historical snapshots
show daily summary โ€” Daily OHLC portfolio data
what are the current prices? โ€” Cached price data
Trading
submit a trade selling 1 ICP for TENDYS โ€” Execute trade (requires confirmation)
show recent trades โ€” Trade history
show pending trades โ€” One-off trade queue
Bot Management
show chore statuses โ€” All chore states
start chore [id] / stop chore [id] / pause chore [id] / resume chore [id] โ€” Manage chores
show chore types โ€” Available chore types
show purse allocations โ€” Purse balances
Risk & Safety
show circuit breaker rules โ€” CB rules
show CB event log โ€” Recent CB triggers
enable circuit breaker / disable circuit breaker โ€” Toggle CB (requires confirmation)
System
show bot logs โ€” System logs
check alerts โ€” Unseen errors/warnings
show supported DEXes โ€” DEX list
check bot version / check permissions โ€” Bot info
Personal Bot (chat)
my bot portfolio / my bot trades / my bot chores / my bot prices / my bot logs / my bot version โ€” Query your personal bot via chat
Governance
list proposals / get proposal [id] / vote yes on proposal [id] / submit motion โ€” DAO actions
submit treasury transfer of [amount] ICP to [principal] โ€” Propose treasury transfer (VIP only)
list neurons / check ICRC-1 balance for [canister_id] โ€” Token/neuron queries
Forum (VIP only)
show forum topics โ€” List available topics
show threads in topic [id] โ€” Browse threads
post a new thread in topic [id] titled "..." about ... โ€” Create thread
reply to thread [id] saying ... โ€” Reply to thread
Minting & Setup
mint my personal bot โ€” Mint a new bot (25 ICP)
retry botkey โ€” Retry botkey if minting succeeded but botkey failed (free, no re-charge)
check my personal bot โ€” Check if you have a bot
Canister Top-Up
top up canister [canister-id] with [amount] ICP โ€” Convert ICP to cycles and deposit into any canister (requires confirmation via modal)
Personal Trading Bot โ–ผ
What is a personal trading bot?
A personal trading bot is your own dedicated canister on the Internet Computer, running the same trading bot software as the shared instance. You have full control over its configuration, chores, trades, and funds. It operates independently from the shared bot.
How do I mint one?
1. Make sure you're logged in and have 25 ICP in your wallet
2. Ask the chat: mint my personal bot
3. The AI will guide you through sending 25 ICP to the factory payment address
4. Once payment is confirmed, your bot canister is created and the "My Bot" tab appears
5. Your principal is automatically added as a botkey with full permissions
How do I manage my personal bot?
Use the My Bot tab to view portfolio, manage chores (start/stop/pause/resume), execute manual trades, and fund your bot with tokens. You can also manage it via chat using commands like my bot portfolio, my bot chores, etc.
How do I fund my bot?
Use the "Fund Bot" section in the My Bot tab. Select a token, enter an amount, and click Fund. This performs a direct ICRC-1 transfer from your wallet to your bot's canister principal. You can also send tokens manually via the wallet sidebar.
Bot minted but botkey failed
Type retry botkey in chat. This retries the botkey registration for free โ€” you will not be charged again. The bot canister already exists; only the permission setup needs to complete.
"Token not in registry" error
Go to My Bot → Settings → Import Token to register the token on your bot. Use the canister ID input or the Quick Add buttons for common tokens (ICP, ckUSDC, ckBTC, ckETH, TENDYS).
My Bot tab not showing
Log in with Internet Identity first. The My Bot tab only appears after you have minted a personal bot. Type check my personal bot in chat to verify.
Empty portfolio after funding
If you funded your bot but portfolio shows empty, the token may not be registered. Go to My Bot → Settings → Import Token and register the token first, then refresh the dashboard.
How do I withdraw funds?
Use the Withdraw from Bot section in the My Bot Overview tab. Select a token, enter the amount, and click Withdraw. Tokens are sent back to your connected wallet principal.
Wallet Features โ–ผ
How do I open the wallet?
Click the โ˜ฐ hamburger button in the top-right header. The wallet sidebar slides in from the right. Click the backdrop or the โœ• button to close it.
How do I send tokens?
In the wallet sidebar under "Send Tokens": select a token from the dropdown, enter the recipient's principal ID, enter the amount, and click Send. The transfer is signed with your Internet Identity and executed on-chain via ICRC-1.
How do I upload a custom avatar?
In the wallet sidebar under "Custom Avatar": click Choose Image to select a JPEG or PNG file, then click "Pay 1 ICP & Upload". The 1 ICP payment goes to the trading pool. Your avatar will appear in chat messages.
How do I top up a canister?
In the wallet sidebar under "Top Up Canister": paste a canister ID, enter an ICP amount (0.1โ€“100), and click Top Up. If you have a personal bot, use the "Top Up My Bot" shortcut button to prefill your bot's ID. ICP is converted to cycles via the CMC automatically.
Which tokens are supported?
The bot supports all tokens in its token registry, including ICP, TENDYS, and other ICRC-1 tokens on the Internet Computer. Check the Tokens tab for the full list with canister IDs and verification status.
Troubleshooting โ–ผ
"Not connected" error
The connection dot in the header shows red. This means the backend canister is unreachable. Check your internet connection, or try refreshing the page. The canister may be out of cycles โ€” check the cycles badge in the header.
"Not authorized" error
You need to log in via Internet Identity. Some actions also require a minimum TENDYS stake (see Neuron Gating section). Make sure you've set up your neuron hotkey and have sufficient stake.
"Rate limited" message
There's a 2-second cooldown between chat messages and actions. Wait a moment and try again. This protects the canister from excessive calls.
"Neuron not found" error
Your neuron subaccount may be incorrect, or the backend principal hasn't been added as a hotkey yet. Double-check the 64-character hex subaccount and verify the hotkey setup in the SNS governance dapp.
Low cycles warning
The cycles badge turns red when the canister has less than 1T cycles. The canister needs cycles to process requests. You can top up any canister yourself using the wallet sidebar "Top Up Canister" section, or ask Waifu in chat: top up canister [id] with 1 ICP.
"Trade error: input token not in registry"
Register the token on your bot: My Bot → Settings → Import Token. Enter the token's canister ID or use the Quick Add buttons for common tokens. The bot needs each token registered before it can trade with it.
"Purse not enabled" error
Enable the purse in My Bot → Automation tab before funding it. Each purse must be explicitly enabled before tokens can be allocated to it.
WARNING: IMPORTANT NOTICE - NO RESPONSIBILITY DISCLAIMER

BY USING THE WAIFU.AI PLATFORM, YOU EXPLICITLY ACKNOWLEDGE AND AGREE THAT YOU ARE USING THE PLATFORM ENTIRELY AT YOUR OWN RISK. WE ACCEPT ABSOLUTELY NO RESPONSIBILITY OR LIABILITY WHATSOEVER FOR ANY CONSEQUENCES RESULTING FROM YOUR USE OF THE PLATFORM. THIS INCLUDES, BUT IS NOT LIMITED TO: FINANCIAL LOSSES, TECHNICAL ISSUES, SECURITY BREACHES, SMART CONTRACT VULNERABILITIES, REGULATORY COMPLIANCE, OR ANY OTHER POTENTIAL RISKS OR DAMAGES.