Documentation

A guide to wallet sign-in, account funds, strategy operations, and AI agents.

ClawStock User Guide

ClawStock lets you sign in with a wallet, explore strategies, manage funds, and follow strategy performance on the website or through an AI agent that supports Skills. A wallet signature proves ownership of an address. ClawStock will never ask for your private key, seed phrase, wallet password, or recovery information.

This guide reflects the current workflow. Supported networks, assets, fees, minimum amounts, and strategy availability may change, so use the live values shown in the product.


Before You Start

You need an EVM-compatible wallet. Connecting a wallet does not transfer funds or authorize a strategy transaction. On first sign-in, your wallet asks you to sign a login message.

Always confirm that:

  • The connected wallet is the address you intend to use.
  • The signature request contains a login message rather than an unknown transaction.
  • You never provide a private key, seed phrase, wallet password, or recovery information to a person or an agent.
  • You check the strategy, asset, network, and amount before every fund-moving action.

The public strategy catalog and strategy details are available without signing in. Personal balances, strategy holdings, performance, and activity require wallet-signature login.

Use ClawStock with an AI Agent

ClawStock provides a standard Skill. An AI agent that supports Skills can use it to explore public strategies, guide wallet login, read account data, and carry out a fund-moving operation after you explicitly authorize it.

Skill repository:

https://github.com/ClawStock/ClawStock

Import this repository from your agent's Skill manager, or ask the agent to install the ClawStock Skill from GitHub. Start with read-only requests such as:

  • Show the currently available strategies and one strategy's details.
  • Show supported networks, assets, minimum amounts, and fees.
  • After login, show balances, my strategies, performance, or operation progress.

For a deposit, investment, strategy close, or withdrawal, provide clear parameters and review the final strategy, asset, network, and amount before execution.


Wallet Sign-In

A complete sign-in follows these steps:

  1. Create a sign-in request using your public wallet address.
  2. Open the ClawStock signing page and connect the same wallet.
  3. Check the address and login message, then sign it in your wallet.
  4. ClawStock verifies the signature and establishes a session.

The signing page retrieves the original login message generated for the request. Do not reconstruct or edit that message. Do not place session credentials in chat messages, logs, URLs, or public files.

If the request expires, begin a new sign-in. Signing out on the website clears the local session; it should not be described as server-side credential revocation unless the service explicitly confirms that result.

Accounts and Balances

ClawStock separates funds by purpose:

  • Main balance is available for new strategy investments and withdrawals.
  • Strategy accounts represent funds, units, and PnL associated with a specific strategy.

Balances for different assets remain separate. Do not add USDT, USDC, or future assets together, and do not use the balance of one asset for a strategy that requires another.

Pending, frozen, or unsettled amounts are not available balance. When viewing performance, also check the data time and any stale-data indicator.


Explore Strategies

The strategy pool is a public catalog. A strategy appearing in this catalog does not mean that you own it.

Before investing, confirm that:

  • The strategy is open for investment.
  • Its required asset matches your Main balance.
  • The amount meets the current minimum.
  • You understand the strategy description, historical backtest, and risks.

Backtests are historical and do not predict future returns. Strategy-wide assets and total shares describe the whole strategy, not your personal holding.

Deposit Funds

A deposit starts with an on-chain wallet transaction. After that transaction, ClawStock registers and verifies its transaction hash. The current flow does not create a deposit application before the wallet transaction.

Select a network, asset, and amount

The product loads enabled networks, token contracts, minimum deposits, and fees from the current configuration. Do not rely on old screenshots, example addresses, or a permanently assumed default network.

If more than one network is available, make sure the sending network exactly matches the selected network.

Confirm in your wallet

  1. Select the network, asset, and amount.
  2. Confirm that the connected wallet matches the wallet used to sign in.
  3. Switch networks when prompted.
  4. If the token allowance is insufficient, approve the token first.
  5. Confirm the Pool deposit transaction.

The approval and Pool deposit are different transactions. ClawStock registers the Pool deposit transaction hash, not the token approval hash.

Wait for account credit

After the wallet reports a successful Pool transaction, the page automatically:

  1. Submits the Pool transaction hash.
  2. Requests verification.
  3. Checks progress until confirmation or a state that can be checked later.

A successful wallet transaction does not by itself prove that the Main balance has been credited. Wait for the product result, or confirm later through balances and activity.

If the on-chain transaction succeeded but hash submission failed, keep the transaction hash, network, asset, and amount. Do not use the approval hash, and do not register a deposit that has already been submitted successfully.

Invest in a Strategy

An investment allocates funds from the available Main balance of the asset required by the strategy.

Review the strategy name, asset, and amount before submitting. ClawStock checks strategy availability, the current minimum, and sufficient available balance in the matching asset.

An accepted request may still need processing time. Keep the investment ID and follow progress in My Strategies. Treat it as an active holding only when the status is active and the unit balance is greater than zero.

View My Strategies

My Strategies contains strategy accounts belonging to the signed-in wallet. It may show:

  • Strategy name and current status.
  • Units held and redeemable units.
  • Current value, cost basis, and strategy PnL.
  • Data time and pending investments or redemptions.

The public strategy pool and My Strategies have different meanings: the first is a catalog; the second is your account data.

Close a Strategy

Closing a strategy closes your full holding in that strategy. The current close operation does not accept a user-entered partial unit amount.

Review the strategy name and asset before submitting. Keep the redemption ID and follow its progress. Treat the close as complete only when both the redemption and close statuses report completion.

A completed strategy close does not necessarily mean funds reached your wallet. Check the displayed balance and any separate withdrawal status rather than inferring wallet settlement from the close request.

Withdraw Funds

A withdrawal uses available Main balance in the selected asset and sends it to the authenticated user's own wallet.

Before submitting, confirm that:

  • The network and asset are currently enabled for withdrawals.
  • The amount meets the minimum and covers the fee.
  • The amount does not exceed available Main balance in that asset.
  • The destination matches the wallet used to sign in.

Keep the withdrawal ID after submission. Distinguish accepted, processing, transaction broadcast, and on-chain confirmation states. A transaction hash means the transaction was broadcast; it does not by itself prove final confirmation.


Activity and Progress

The profile area contains deposit, withdrawal, and strategy activity. Pending operations can be checked again without repeating the fund-moving action.

For a long-running operation, refresh the existing record:

  • Use the deposit ID or Pool deposit transaction hash for a deposit.
  • Use the investment ID for an investment.
  • Use the redemption ID for a strategy close.
  • Use the withdrawal ID for a withdrawal.

Do not repeat a transfer merely because the page was refreshed, a wallet window closed, or a temporary network error occurred.

Security Principles

  • ClawStock and AI agents do not need your private key, seed phrase, wallet password, or recovery information.
  • A wallet address is public information and does not grant access to personal accounts.
  • Session credentials belong in secure session storage, not chat messages, logs, URLs, or public files.
  • Fund-moving actions require explicit instructions. Missing parameters should be completed and reviewed first.
  • An accepted request, broadcast transaction, or returned transaction hash must not be described as final settlement.
  • Historical performance is not a promise of future returns.

If you encounter a problem, keep the relevant operation ID or transaction hash and open an issue in the ClawStock GitHub repository. Never publish an API key, signature, or other sensitive information in an issue.