Tychi Sui (@tychilabs/tyi-sui) — Sui Agent Wallet

    Operator (human or AI agent)
           │
           ├──────────────────────┬──────────────────────┐
           ▼                      ▼                      │
    ┌─────────────┐        ┌─────────────┐              │
    │  tyi-sui REPL│        │ tyi-sui-mcp │  stdio       │
    │  (CLI)      │        │  9 tools    │              │
    └──────┬──────┘        └──────┬──────┘              │
           │                       │                     │
           └───────────┬───────────┘                     │
                       ▼                                 │
    ╔══════════════════════════════════════════════╗     │
    ║  OPERATOR DEVICE · ~/.tyi                    ║     │
    ║   keystore ──▶ executor ──▶ Sui mainnet      ║     │
    ║   policy.json      build · sign · broadcast  ║     │
    ╚═══════════════════════▲══════════════════════╝     │
                            │ Action[] (no keys)         │
                            ▼                            │
                   ┌─────────────────┐                   │
                   │  Tychi brain    │                   │
                   │  policy · tools │                   │
                   └─────────────────┘                   │
                            ▲                            │
                            └────────────────────────────┘
                              natural-language intent

Self-custody agentic wallet on Sui mainnet.

Release: 1.0.0-beta.1

Capabilities

Portfolio management — Agent-operated holdings command center: unified SUI + USDC exposure, position visibility, and capital deployment — all under policy, all locally custodied.

Transfers — three-phase pipeline: gas estimate, operator confirmation, local broadcast. Applies to native SUI and USDC.

Policy — spending caps (per transaction and session), blocked recipients, and custom rules. Configured at onboarding; stored in ~/.tyi/config/policy.json and enforced by the brain policy kernel before any sign action.

History — transaction receipts persisted locally and synced to brain; queryable via agent tools.

Multi-wallet — create, import (BIP39 mnemonic or Sui private key), and switch active wallets from a single encrypted keystore.

Interfaces

| Surface | Command | |---------|---------| | Interactive CLI | npx @tychilabs/[email protected] | | Agent MCP (stdio) | npx @tychilabs/[email protected] |

Custody

| Layer | Has | Never has | |-------|-----|-----------| | Your machine | Keystore, signatures, policy | — | | Brain (hosted) | Intent, policy kernel, chat | Mnemonic, privkey, password |

Quick start (local stack)

1. Start brain (from repo SUI/):

docker compose up -d --build

2. Run wallet:

cd SUI/packages/client
npm install && npm run bundle
export TYCHI_BRAIN_URL=http://localhost:8788
npm run cli

3. Chat examples:

what's in my portfolio?
send 0.5 usdc to 0x...

Non-interactive:

export TYI_PASSWORD=your-keystore-password
npm run cli

Agent hosts

Use @tychilabs/tyi-sui-mcp — full 9-tool agent surface.

{
  "mcpServers": {
    "tychi-sui": {
      "command": "npx",
      "args": ["@tychilabs/[email protected]"],
      "env": {
        "TYI_PASSWORD": "<password>",
        "TYCHI_BRAIN_URL": "http://hosted_sui_brain.tychilabs.com"
      }
    }
  }
}

SDK

import { createTyiClient } from "@tychilabs/tyi-sui";

const tyi = createTyiClient();
await tyi.unlock(process.env.TYI_PASSWORD);
const reply = await tyi.chat("show my portfolio on sui");

Environment

| Variable | MCP | Default | |----------|-----|---------| | TYI_PASSWORD | required | — | | TYCHI_BRAIN_URL | recommended | http://hosted_sui_brain.tychilabs.com (hosted) · http://localhost:8788 (local) | | KEYSTORE_PASSWORD | alias | same as TYI_PASSWORD |

Data dir: ~/.tyi/ — keystore, policy, history.

Roadmap

Policy-capped agent wallet on Sui: natural-language intent → guardian → operator confirm → local sign. Agents propose; policy constrains; humans confirm risk; this client signs. We are building infrastructure for agents that transact inside policy — not chat glued to RPC. Public release July 2026 after internal custody audit.

Why Sui

Local custody + programmable transaction blocks — The client builds and signs transfers on mainnet today. Portfolio visibility and policy-governed capital deployment run through a three-phase pipeline (estimate → confirm → execute). Next: composable PTBs for multi-step portfolio actions under one policy gate.

Move objects — Phase 2 moves enforcement on-chain: spending cap objects that reject over-limit txs at the chain, recipient allowlists, time-bound agent authority, and owner revoke to freeze an agent instantly.

Agent surfaces (MCP) — @tychilabs/tyi-sui-mcp exposes onboard, route, lifecycle, and chat tools over stdio. Agent hosts orchestrate wallet operations; they never receive mnemonics, private keys, or signatures.

zkLogin / on-chain identity — Bind each agent to a verifiable Sui identity so policy, history, and authority trace back to a real principal — not an anonymous API key.

DeepBook — Agent-quoted spot flow on Sui’s native order book: quote, operator confirm, local sign. Same custody model as sends; trading becomes a policy-governed portfolio action.

Walrus + Seal — Encrypted agent memory off-chain with ownership anchored to Sui objects. Agents retain context across sessions without leaking secrets to the brain or the host.

Phase 1 — shipped (1.0.0-beta.1)

Live on Sui mainnet today:

• Agent portfolio management — unified holdings, exposure, and multi-asset visibility across SUI and USDC
• Policy-governed capital deployment — three-phase send with per-tx and session caps, blocked addresses, custom rules
• Audit-grade transaction history — local receipts synced to brain; queryable via agent tools
• Multi-wallet orchestration — create, import (BIP39 or Sui private key), switch active wallet
• MCP agent surface — routing, onboard, lifecycle tools, and tyi_chat for portfolio command

Phase 2 — on-chain agent core

Move from “policy in config” to policy enforced on Sui:

• Move spending cap object — chain rejects over-limit before sign
• Owner revoke — freeze agent authority without rotating keys
• On-chain activity log linked to agent wallet and tx history
• zkLogin or on-chain agent identity

Phase 3 — agent commerce & memory (July)

Extend the same agent loop into adjacent Sui stacks:

• DeepBook — quote, confirm, sign trades locally under policy
• Automation — recurring and triggered flows with hard spending limits
• MCP expansion — trading and automation tool surfaces for agent hosts
• Walrus + Seal — encrypted agent memory with Sui object references
• Internal audits — custody and signing path review before public release

Direction

Tychi is an agentic wallet product on Sui: autonomy where policy allows, confirmation where risk demands it, custody always local. Phase 1 is live in beta; Phase 2–3 deepen Sui-native enforcement and ecosystem composability.

Links

• tychilabs.com
• npm @tychilabs/tyi-sui
• npm @tychilabs/tyi-sui-mcp

Apache-2.0 · © Tychi Labs