emblem-ai

EmblemAI developer tools

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.

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.

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

Quick Start

Installation

# Core authentication
npm install @emblemvault/auth-sdk

# React integration (includes auth)
npm install @emblemvault/emblem-auth-react

# EmblemAI chat for React
npm install @emblemvault/hustle-react

# EmblemAI chat SDK (Node.js / vanilla JS)
npm install hustle-incognito

# AI app introspection and debugging
npm install reflexive

Option A: React App (Recommended)

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.

Option B: Vanilla JavaScript / Node.js

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?

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.

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: | Chain | Auth Method | |-------|-------------| | Ethereum/EVM | Signature verification (MetaMask, WalletConnect, Rainbow, etc.) | | Solana | Signature verification (Phantom, Solflare, Backpack) | | Bitcoin | PSBT-based verification | | Hedera | Signature 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

AI Chat Experience & Plugins

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

React Components

Pre-built UI components for rapid development:

// 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).

Agent Wallet & Automations

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

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.

AI App Introspection (Reflexive)

Embed Claude inside running applications to monitor, debug, and develop with conversational AI. Works as a CLI, embedded library, or MCP server.

# Monitor any app (read-only by default)
npx reflexive ./server.js

# Local development mode with debugging (still no write/shell unless explicitly enabled)
npx reflexive --debug --watch ./server.js

# As MCP server for Claude Code (read-only baseline)
npx reflexive --mcp --debug ./server.js

// 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

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.

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.

Custom AI Plugins

Extend the AI with your own tools:

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

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.