tuyo-signer. Tuyo never sees the key.
The AI needs a client that can run code and keep a key safe, such as Claude Code or Codex. Without one, the AI uses proposals instead.
Become a manager
1
Set up the signer
The AI calls
get_manager_signer. It returns
the steps to install tuyo-signer and create a key. The tool calls no API
and changes nothing.2
Request management
The AI finds the pod with
list_pods and calls
propose_pod_management. You approve the
request in the Tuyo app.3
Wait for your decision
The AI calls
get_pod_management_proposal. Each
call can wait up to 25 seconds. The AI stops waiting five minutes after the
request.list_managed_pods shows the pods that the AI can manage now. An old approved request does not prove that access is still active.
Act on the pod
Sends, conversions and vault moves use an execution:- The AI calls a prepare tool:
prepare_send,prepare_convert,prepare_vault_depositorprepare_vault_withdrawal. - The AI signs the returned
signingobject withtuyo-signer sign-execution. It does not change the object. - The AI calls
submit_executionwith theexecutionId. Tuyo checks the permission again, cosigns and broadcasts it. - The AI follows the execution with
get_executionuntil it issucceeded,failed,expiredorrefunded.
prepare_purchase. It does not sign an execution. See Purchases.
What a manager can do
- Send from the pod to a Tuyo username, an address, or a bank account. For a bank account,
list_external_bank_accountsmust showmanagerExecutionEligibility.eligible: true. - Convert tokens inside the pod.
- Move the pod’s money into or out of an investment vault.
- Pay for a purchase with a card from the pod.
When a response is lost
The AI must not prepare or request again at once:- For an execution, it calls
list_executions, thenget_execution. - For a management request, it calls
list_pod_management_proposals.
executionId again cannot move money twice.
Stop managing a pod
Ask the AI to callrevoke_pod_management. To manage the pod again, the AI needs a new request and your approval.