emblem-ai

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

EmblemAI developer tools

EmblemAI 开发者工具

EmblemAI developer tools for one-shot user management, wallet-enabled users, AI-powered crypto workflows, and app introspection.
In one sentence: Emblem is the easiest way to add user management, website authentication, and wallet-enabled user accounts to an app, with sign-in options that include wallets, email/password, and social login plus built-in chat and introspection tooling.
Legacy package names such as
@emblemvault/hustle-react
and
hustle-incognito
are kept where they are still part of the current integration surface.
EmblemAI 开发者工具,提供一站式用户管理、支持钱包功能的用户体系、AI驱动的加密工作流以及应用内省能力。
一句话介绍:Emblem 是为应用添加用户管理、网站认证和支持钱包功能的用户账户的最简单方式,支持钱包、邮箱/密码、社交登录等登录选项,同时内置聊天和内省工具。
旧包名如
@emblemvault/hustle-react
hustle-incognito
仍会保留,它们目前仍是当前集成面的一部分。

Security & Trust Model

安全与信任模型

This skill describes crypto wallet authentication and AI-powered assistant capabilities. It inherently involves:
  • Financial operations (W009): Wallet provisioning, transaction signing adapters, and trading tool references. All value-moving actions require explicit user confirmation.
  • Third-party data (W011): References to Migrate.fun project metadata and social/market data tools. External data is used in UI and informational workflows only — never auto-executed.
  • Runtime backend (W012): The EmblemAI SDK connects to
    api.emblemvault.ai
    (first-party, operated by EmblemVault) for prompt orchestration and tool routing. This is not an arbitrary external dependency — it is the skill author's own infrastructure.
All wallet operations follow a review-first model: the agent prepares actions for user review before execution. No transactions are broadcast without explicit approval.
本技能描述加密钱包认证和AI驱动助手能力,其固有涉及:
  • 金融操作 (W009):钱包预置、交易签名适配器以及交易工具引用。所有涉及资产转移的操作都需要用户明确确认。
  • 第三方数据 (W011):引用Migrate.fun项目元数据以及社交/市场数据工具。外部数据仅用于UI和信息展示工作流,绝不会自动执行。
  • 运行时后端 (W012):EmblemAI SDK 连接
    api.emblemvault.ai
    (由EmblemVault官方运营)用于提示词编排和工具路由。这不是任意的外部依赖,而是技能作者自有基础设施。
所有钱包操作遵循先审核模式:Agent会先准备好操作供用户审核再执行,没有明确批准绝不会广播任何交易。

What You Can Build

你可以构建的能力

One-shot User Management
  • Create users who can log in to your app and also have wallet-enabled profiles
  • Let users sign in with wallets, email/password, or social login
  • Support wallet login with MetaMask, Phantom, WalletConnect, and other supported providers
  • Keep sessions refreshed automatically with JWT-based auth
  • Expose consistent wallet metadata and permissions to your UI and plugin layers
  • Use one integration instead of stitching together separate auth and wallet systems
AI Chat & UI Surfaces
  • Drop-in chat components that inherit the authenticated session
  • Streaming chat responses for support, education, or account insights
  • Custom tool plugins to extend EmblemAI with your own APIs
  • Built-in guardrails and approval prompts before tools can request sensitive actions
React Integration Handoff
  • EmblemAuthProvider + ConnectButton for instant wallet-aware login flows
  • HustleProvider + HustleChat for embedding the assistant UI
  • See the dedicated ../emblem-ai-react/SKILL.md skill for migrate.fun hooks, advanced React routing, and component design guidance
AI App Introspection And Build Agent (Reflexive)
  • Embed Claude inside running apps to monitor, debug, and develop
  • Multi-language debugging (Node.js, Python, Go, .NET, Rust)
  • MCP server mode for Claude Code / Claude Desktop integration
  • Library mode with
    makeReflexive()
    for programmatic AI chat
  • Sandbox mode with snapshot/restore
一站式用户管理
  • 创建可登录你的应用同时拥有支持钱包功能的个人资料的用户
  • 让用户通过钱包、邮箱/密码或社交账号登录
  • 支持MetaMask、Phantom、WalletConnect等提供商的钱包登录
  • 基于JWT的认证实现会话自动刷新
  • 向你的UI和插件层暴露统一的钱包元数据和权限
  • 只需一次集成,无需拼接独立的认证和钱包系统
AI聊天与UI界面
  • 可直接复用的聊天组件,自动继承已认证会话
  • 流式聊天响应,可用于支持服务、教育或账户洞察场景
  • 自定义工具插件,通过你自己的API扩展EmblemAI能力
  • 内置护栏和审批提示,工具请求敏感操作前会触发确认
React集成指引
  • EmblemAuthProvider + ConnectButton 可快速实现支持钱包感知的登录流
  • HustleProvider + HustleChat 可嵌入助手UI
  • 查看专用的 ../emblem-ai-react/SKILL.md 技能文档获取migrate.fun钩子、高级React路由和组件设计指引
AI应用内省与构建Agent(Reflexive)
  • 在运行中的应用内嵌入Claude,实现监控、调试和开发能力
  • 多语言调试(Node.js、Python、Go、.NET、Rust)
  • 支持MCP服务器模式,可集成Claude Code / Claude Desktop
  • 库模式提供
    makeReflexive()
    用于程序化AI聊天
  • 沙箱模式支持快照/恢复

Quick Start

快速开始

Installation

安装

bash
undefined
bash
undefined

Core authentication

Core authentication

npm install @emblemvault/auth-sdk
npm install @emblemvault/auth-sdk

React integration (includes auth)

React integration (includes auth)

npm install @emblemvault/emblem-auth-react
npm install @emblemvault/emblem-auth-react

EmblemAI chat for React

EmblemAI chat for React

npm install @emblemvault/hustle-react
npm install @emblemvault/hustle-react

EmblemAI chat SDK (Node.js / vanilla JS)

EmblemAI chat SDK (Node.js / vanilla JS)

npm install hustle-incognito
npm install hustle-incognito

AI app introspection and debugging

AI app introspection and debugging

npm install reflexive
undefined
npm install reflexive
undefined

Option A: React App (Recommended)

选项A:React应用(推荐)

tsx
import { EmblemAuthProvider, ConnectButton, useEmblemAuth } from '@emblemvault/emblem-auth-react';
import { HustleProvider, HustleChat } from '@emblemvault/hustle-react';

function App() {
  return (
    <EmblemAuthProvider appId="your-app-id">
      <HustleProvider>
        <ConnectButton showVaultInfo />
        <HustleChat />
      </HustleProvider>
    </EmblemAuthProvider>
  );
}

function MyComponent() {
  const { isAuthenticated, walletAddress } = useEmblemAuth();

  if (!isAuthenticated) {
    return <ConnectButton />;
  }

  return <div>Connected: {walletAddress}</div>;
}
If the user is building their own React app, use the dedicated ../emblem-ai-react/SKILL.md skill for the React-specific references and examples.
tsx
import { EmblemAuthProvider, ConnectButton, useEmblemAuth } from '@emblemvault/emblem-auth-react';
import { HustleProvider, HustleChat } from '@emblemvault/hustle-react';

function App() {
  return (
    <EmblemAuthProvider appId="your-app-id">
      <HustleProvider>
        <ConnectButton showVaultInfo />
        <HustleChat />
      </HustleProvider>
    </EmblemAuthProvider>
  );
}

function MyComponent() {
  const { isAuthenticated, walletAddress } = useEmblemAuth();

  if (!isAuthenticated) {
    return <ConnectButton />;
  }

  return <div>Connected: {walletAddress}</div>;
}
如果你正在构建自己的React应用,可使用专用的 ../emblem-ai-react/SKILL.md 技能文档获取React专属的参考和示例。

Option B: Vanilla JavaScript / Node.js

选项B:原生JavaScript / Node.js

typescript
import { EmblemAuthSDK } from '@emblemvault/auth-sdk';
import { HustleIncognitoClient } from 'hustle-incognito';

// Initialize auth
const auth = new EmblemAuthSDK({ appId: 'your-app-id' });

// Open auth modal (browser)
auth.openAuthModal();

// Listen for session
auth.on('session', () => {
  console.log('Authenticated session ready');
});

// Initialize AI with auth
const emblemAI = new HustleIncognitoClient({ sdk: auth });

// Chat with AI
const response = await emblemAI.chat([
  { role: 'user', content: 'What tokens are trending on Base?' }
]);
typescript
import { EmblemAuthSDK } from '@emblemvault/auth-sdk';
import { HustleIncognitoClient } from 'hustle-incognito';

// Initialize auth
const auth = new EmblemAuthSDK({ appId: 'your-app-id' });

// Open auth modal (browser)
auth.openAuthModal();

// Listen for session
auth.on('session', () => {
  console.log('Authenticated session ready');
});

// Initialize AI with auth
const emblemAI = new HustleIncognitoClient({ sdk: auth });

// Chat with AI
const response = await emblemAI.chat([
  { role: 'user', content: 'What tokens are trending on Base?' }
]);

Need CLI or wallet-first automations?

需要CLI或优先钱包的自动化能力?

Point the user to ../emblem-ai-agent-wallet/SKILL.md plus references/agentwallet.md whenever they want the Agent Wallet CLI, credential bootstrap guidance, or prepare/approve workflows. Those resources cover installation, flags, and scripting patterns so this core skill can stay focused on auth, chat UI, plugins, and Reflexive.
当用户需要Agent Wallet CLI、凭证引导指引或者准备/审批工作流时,指引用户查看 ../emblem-ai-agent-wallet/SKILL.md 以及 references/agentwallet.md。这些资源覆盖了安装、参数和脚本编写模式,因此本核心技能可以专注于认证、聊天UI、插件和Reflexive相关内容。

Core Capabilities

核心能力

Wallet Authentication

钱包认证

Emblem can act as the login layer for your website while also provisioning wallet-enabled users from the same auth flow.
Supported Chains:
ChainAuth Method
Ethereum/EVMSignature verification (MetaMask, WalletConnect, Rainbow, etc.)
SolanaSignature verification (Phantom, Solflare, Backpack)
BitcoinPSBT-based verification
HederaSignature verification (Hedera SDK)
Additional Auth Methods:
  • OAuth (Google, Twitter/X)
  • Email/password with OTP
Why this matters: Emblem is the easiest way to turn a login flow into both app authentication and a reusable wallet identity for the same user.
Reference: references/auth-sdk.md
Emblem可作为你网站的登录层,同时在同一个认证流中为用户预置支持钱包功能的账户。
支持的链:
认证方法
Ethereum/EVM签名验证(MetaMask、WalletConnect、Rainbow等)
Solana签名验证(Phantom、Solflare、Backpack)
BitcoinPSBT-based verification
Hedera签名验证(Hedera SDK)
其他认证方式:
  • OAuth(Google、Twitter/X)
  • 邮箱/密码+一次性验证码(OTP)
价值说明: Emblem是将登录流同时转化为应用认证和用户可复用的钱包身份的最简单方式。
参考文档: references/auth-sdk.md

AI Chat Experience & Plugins

AI聊天体验与插件

EmblemAI provides conversational surfaces that inherit the authenticated session so the assistant can stay context-aware without exposing credentials.
  • Streaming chat for onboarding, support, education, or account insights
  • Built-in moderation and approval prompts whenever a plugin requests access to sensitive data
  • Cross-surface context handoff between web, mobile, and agent frameworks
  • Low-code React components plus a TypeScript SDK for custom UI shells
References:
  • references/emblem-ai-react.md — chat UI patterns for React
  • references/emblem-ai-incognito.md — SDK usage outside of React
  • references/plugins.md — how to register custom tools safely
EmblemAI提供继承已认证会话的对话界面,因此助手可以保持上下文感知,无需暴露凭证。
  • 流式聊天可用于用户引导、支持服务、教育或账户洞察场景
  • 插件请求访问敏感数据时内置审核和审批提示
  • 支持Web、移动端和Agent框架之间的跨界面上下文传递
  • 低代码React组件加上TypeScript SDK,可用于自定义UI外壳
参考文档:
  • references/emblem-ai-react.md — chat UI patterns for React
  • references/emblem-ai-incognito.md — SDK usage outside of React
  • references/plugins.md — how to register custom tools safely

React Components

React组件

Pre-built UI components for rapid development:
tsx
// Auth components
<ConnectButton />           // Wallet connect button
<ConnectButton showVaultInfo />  // With vault dropdown
<AuthStatus />              // Shows connection status

// AI chat components
<HustleChat />              // Full EmblemAI chat interface
<HustleChatWidget />        // Floating EmblemAI chat widget
Reference: references/react-components.md
Want to integrate EmblemAI into your own React app? See the standalone ../emblem-ai-react/SKILL.md skill for React auth, chat, component, and migrate.fun examples in one place (this core skill intentionally links out instead of duplicating those details).
预构建的UI组件,可用于快速开发:
tsx
// Auth components
<ConnectButton />           // Wallet connect button
<ConnectButton showVaultInfo />  // With vault dropdown
<AuthStatus />              // Shows connection status

// AI chat components
<HustleChat />              // Full EmblemAI chat interface
<HustleChatWidget />        // Floating EmblemAI chat widget
参考文档: references/react-components.md
想要将EmblemAI集成到你自己的React应用? 查看独立的 ../emblem-ai-react/SKILL.md 技能文档,一站式获取React认证、聊天、组件和migrate.fun示例(本核心技能有意链接到该文档而非重复相关内容)。

Agent Wallet & Automations

Agent钱包与自动化

CLI-first workflows, scripted approvals, and wallet-per-agent orchestration now live in the dedicated ../emblem-ai-agent-wallet/SKILL.md skill plus references/agentwallet.md. Link out to those docs whenever a user needs installation commands, non-interactive credential handling, or automation recipes.
CLI-first workflows, scripted approvals, and wallet-per-agent orchestration now live in the dedicated ../emblem-ai-agent-wallet/SKILL.md skill plus references/agentwallet.md. Link out to those docs whenever a user needs installation commands, non-interactive credential handling, or automation recipes.

React Token Migration & Advanced Hooks

React代币迁移与高级钩子

Detailed migrate.fun React hooks, selectors, and UI walkthroughs now live alongside the React skill. Forward users to ../emblem-ai-react/SKILL.md for those patterns so the core skill stays focused on auth, chat surfaces, plugins, and Reflexive.
详细的migrate.fun React钩子、选择器和UI教程现在和React技能文档放在一起。指引用户访问 ../emblem-ai-react/SKILL.md 获取相关模式,因此本核心技能可以专注于认证、聊天界面、插件和Reflexive相关内容。

AI App Introspection (Reflexive)

AI应用内省(Reflexive)

Embed Claude inside running applications to monitor, debug, and develop with conversational AI. Works as a CLI, embedded library, or MCP server.
bash
undefined
在运行中的应用内嵌入Claude,通过对话式AI实现监控、调试和开发能力。可作为CLI、嵌入库或者MCP服务器使用。
bash
undefined

Monitor any app (read-only by default)

Monitor any app (read-only by default)

npx reflexive ./server.js
npx reflexive ./server.js

Local development mode with debugging (still no write/shell unless explicitly enabled)

Local development mode with debugging (still no write/shell unless explicitly enabled)

npx reflexive --debug --watch ./server.js
npx reflexive --debug --watch ./server.js

As MCP server for Claude Code (read-only baseline)

As MCP server for Claude Code (read-only baseline)

npx reflexive --mcp --debug ./server.js

```typescript
// Library mode -- embed in your app
import { makeReflexive } from 'reflexive';

const r = makeReflexive({ webUI: true, title: 'My App' });
r.setState('users.active', 42);
const analysis = await r.chat('Any anomalies in recent activity?');
Modes: CLI (local), library (
makeReflexive()
), MCP server, sandbox, hosted (prefer read-only defaults and enable
--write
/
--shell
only for trusted local projects)
Debugging: Node.js, Python, Go, .NET, Rust -- breakpoints with AI prompts
Reference: references/reflexive.md
npx reflexive --mcp --debug ./server.js

```typescript
// Library mode -- embed in your app
import { makeReflexive } from 'reflexive';

const r = makeReflexive({ webUI: true, title: 'My App' });
r.setState('users.active', 42);
const analysis = await r.chat('Any anomalies in recent activity?');
模式: CLI(本地)、库(
makeReflexive()
)、MCP服务器、沙箱、托管(默认优先只读模式,仅对受信任的本地项目启用
--write
/
--shell
调试能力: 支持Node.js、Python、Go、.NET、Rust — 支持AI提示断点
参考文档: references/reflexive.md

Session Management

会话管理

Emblem uses short-lived sessions with automatic refresh. Treat session data as sensitive runtime state: do not print tokens, paste them into prompts, or pass them via CLI flags.
typescript
auth.on('session', () => { /* new session available */ });
auth.on('sessionExpired', () => { /* handle expiry */ });
auth.on('sessionRefreshed', () => { /* refreshed */ });
auth.on('sessionWillRefresh', () => { /* refresh soon */ });
auth.on('authError', () => { /* auth failure */ });
auth.on('cancelled', () => { /* user closed auth */ });

await auth.refreshSession();
auth.logout();
Sessions auto-refresh ~60 seconds before expiry. No manual token handling is needed in typical browser flows.
Emblem使用支持自动刷新的短期会话。请将会话数据视为敏感运行时状态:不要打印令牌、不要将其粘贴到提示词中、不要通过CLI参数传递。
typescript
auth.on('session', () => { /* new session available */ });
auth.on('sessionExpired', () => { /* handle expiry */ });
auth.on('sessionRefreshed', () => { /* refreshed */ });
auth.on('sessionWillRefresh', () => { /* refresh soon */ });
auth.on('authError', () => { /* auth failure */ });
auth.on('cancelled', () => { /* user closed auth */ });

await auth.refreshSession();
auth.logout();
会话会在过期前约60秒自动刷新,典型的浏览器流中无需手动处理令牌。

Custom AI Plugins

自定义AI插件

Extend the AI with your own tools:
typescript
import { usePlugins } from '@emblemvault/hustle-react';

const { registerPlugin } = usePlugins();

await registerPlugin({
  name: 'my-plugin',
  version: '1.0.0',
  tools: [{
    name: 'get_nft_floor',
    description: 'Get NFT collection floor price',
    parameters: {
      type: 'object',
      properties: {
        collection: { type: 'string', description: 'Collection name or address' }
      },
      required: ['collection']
    }
  }],
  executors: {
    get_nft_floor: async ({ collection }) => {
      const data = await fetchFloorPrice(collection);
      return { floor: data.floorPrice, currency: 'ETH' };
    }
  }
});
Reference: references/plugins.md
通过你自己的工具扩展AI能力:
typescript
import { usePlugins } from '@emblemvault/hustle-react';

const { registerPlugin } = usePlugins();

await registerPlugin({
  name: 'my-plugin',
  version: '1.0.0',
  tools: [{
    name: 'get_nft_floor',
    description: 'Get NFT collection floor price',
    parameters: {
      type: 'object',
      properties: {
        collection: { type: 'string', description: 'Collection name or address' }
      },
      required: ['collection']
    }
  }],
  executors: {
    get_nft_floor: async ({ collection }) => {
      const data = await fetchFloorPrice(collection);
      return { floor: data.floorPrice, currency: 'ETH' };
    }
  }
});
参考文档: references/plugins.md

More Examples and References

更多示例和参考文档

Use the dedicated reference docs for the deeper examples that were split out to keep this root skill compact:
  • references/agentwallet.md - CLI usage, auth modes, prompts, and operational troubleshooting
  • references/auth-sdk.md - auth flows, sessions, Node persistence patterns, and TypeScript types
  • references/auth-react.md - provider setup, hooks, browser integrations, and UX patterns
  • references/emblem-ai-react.md - chat UI patterns, streaming, and React composition
  • references/emblem-ai-incognito.md - Node/browser SDK examples and environment configuration
  • ../emblem-ai-react/SKILL.md - React-only view that now owns migrate.fun guidance
  • ../emblem-ai-agent-wallet/SKILL.md - wallet-first CLI skill with prepare/approve workflows
  • ../emblem-ai-prompt-examples/SKILL.md - standalone EmblemAI prompt catalog covering wallet, Ordinals, and workflow-specific examples
  • references/react-components.md - prebuilt component catalog and UI integration examples
  • references/react-skill-proposal.md - proposed future React standalone-skill boundary and example gaps
  • references/plugins.md - custom plugin design, tool schemas, and executor examples
  • references/reflexive.md - AI introspection, debugging, and MCP/server workflows
  • README.md - quick package map for choosing the right Emblem package
If the user specifically wants React integration guidance, point them to ../emblem-ai-react/SKILL.md.

Getting Started: Start with
<ConnectButton />
to add the easiest possible path to website auth and wallet-enabled users, then add
<HustleChat />
for EmblemAI capabilities.
Need Help?: Check the reference docs in the
references/
folder for detailed API documentation.
使用专用的参考文档获取更深入的示例,这些示例被拆分出去以保持本根技能的简洁:
  • references/agentwallet.md - CLI用法、认证模式、提示词和运维故障排查
  • references/auth-sdk.md - 认证流、会话、Node持久化模式和TypeScript类型
  • references/auth-react.md - 提供者设置、钩子、浏览器集成和UX模式
  • references/emblem-ai-react.md - 聊天UI模式、流式响应和React组合
  • references/emblem-ai-incognito.md - Node/浏览器SDK示例和环境配置
  • ../emblem-ai-react/SKILL.md - 仅React的视图,现在包含migrate.fun指引
  • ../emblem-ai-agent-wallet/SKILL.md - 优先钱包的CLI技能,包含准备/审批工作流
  • ../emblem-ai-prompt-examples/SKILL.md - 独立的EmblemAI提示词目录,覆盖钱包、Ordinals和特定工作流示例
  • references/react-components.md - 预构建组件目录和UI集成示例
  • references/react-skill-proposal.md - 未来React独立技能边界的提案和示例缺口
  • references/plugins.md - 自定义插件设计、工具 schema 和执行器示例
  • references/reflexive.md - AI内省、调试和MCP/服务器工作流
  • README.md - 快速包映射,帮助选择合适的Emblem包
如果用户明确需要React集成指引,请指引他们访问 ../emblem-ai-react/SKILL.md

入门指南:从
<ConnectButton />
开始,以最简单的方式添加网站认证和支持钱包功能的用户体系,之后添加
<HustleChat />
即可获得EmblemAI能力。
需要帮助? 查看
references/
文件夹下的参考文档获取详细的API文档。